[ { "path": ".cargo/config.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[alias]\nxtask = \"run --locked --package xtask --\"\n\n[target.xtensa-esp32s3-none-elf]\nrustflags = [\n \"-C\",\n \"link-arg=-nostartfiles\",\n # Without this flag, we get miscompilation of floating point operations that cause the clipping region to be totally wrong\n \"-C\",\n \"target-feature=-fp\",\n]\n\n[target.xtensa-esp32s2-none-elf]\nrustflags = [\n # Enable the atomic codegen option for Xtensa\n \"-C\",\n \"target-feature=+s32c1i\",\n]\n\n[target.x86_64-pc-windows-msvc]\n# Increase default stack size to avoid running out of stack\n# space in debug builds. The size matches Linux's default.\nrustflags = [\"-C\", \"link-arg=/STACK:8000000\"]\n[target.aarch64-pc-windows-msvc]\n# Increase default stack size to avoid running out of stack\n# space in debug builds. The size matches Linux's default.\nrustflags = [\"-C\", \"link-arg=/STACK:8000000\"]\n" }, { "path": ".clang-format", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n---\n# Webkit style was loosely based on the Qt style\nBasedOnStyle: WebKit\n\nStandard: \"c++20\"\n\n# Column width is limited to 100 in accordance with Qt Coding Style.\n# https://wiki.qt.io/Qt_Coding_Style\n# Note that this may be changed at some point in the future.\nColumnLimit: 100\n# How much weight do extra characters after the line length limit have.\n# PenaltyExcessCharacter: 4\n\n# Disable reflow of qdoc comments: indentation rules are different.\n# Translation comments and SDPX-License-Identifiers either.\nCommentPragmas: \"^(!|:|\\\\s*[S]PDX-License-Identifier: )\"\n\n# We want a space between the type and the star for pointer types.\nPointerBindsToType: false\n\n# We use template< without space.\nSpaceAfterTemplateKeyword: false\n\n# We want to break before the operators, but not before a '='.\nBreakBeforeBinaryOperators: NonAssignment\n\n# Braces are usually attached, but not after functions or class declarations.\nBreakBeforeBraces: Custom\nBraceWrapping:\n AfterClass: true\n AfterControlStatement: Never\n AfterEnum: false\n AfterFunction: true\n AfterNamespace: false\n AfterObjCDeclaration: false\n AfterStruct: true\n AfterUnion: false\n BeforeCatch: false\n BeforeElse: false\n IndentBraces: false\n\n# When constructor initializers do not fit on one line, put them each on a new line.\nConstructorInitializerAllOnOneLineOrOnePerLine: true\n# Indent initializers by 4 spaces\nConstructorInitializerIndentWidth: 4\n\n# Indent width for line continuations.\nContinuationIndentWidth: 8\n\n# No indentation for namespaces.\nNamespaceIndentation: None\n\n# Allow indentation for preprocessing directives (if/ifdef/endif). https://reviews.llvm.org/rL312125\nIndentPPDirectives: AfterHash\n\n# Horizontally align arguments after an open bracket.\n# The coding style does not specify the following, but this is what gives\n# results closest to the existing code.\nAlignAfterOpenBracket: \"Align\"\nAlwaysBreakTemplateDeclarations: \"Yes\"\n\n# Ideally we should also allow less short function in a single line, but\n# clang-format does not handle that.\nAllowShortFunctionsOnASingleLine: Inline\n\n# The coding style specifies some include order categories, but also tells to\n# separate categories with an empty line. It does not specify the order within\n# the categories. Since the SortInclude feature of clang-format does not\n# re-order includes separated by empty lines, the feature is not used.\nSortIncludes: \"Never\"\n\n# macros for which the opening brace stays attached.\nForEachMacros:\n [\n foreach,\n Q_FOREACH,\n BOOST_FOREACH,\n forever,\n Q_FOREVER,\n QBENCHMARK,\n QBENCHMARK_ONCE,\n ]\n\n# Break constructor initializers before the colon and after the commas.\nBreakConstructorInitializers: BeforeColon\n" }, { "path": ".clippy.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\ntype-complexity-threshold = 2500\ntoo-many-arguments-threshold = 10\n" }, { "path": ".dockerignore", "content": "target\n.git\n" }, { "path": ".gitattributes", "content": "*.rs diff=rust\n# These files are automatically checked by the build.rs\n# With linguist-generated we can mark them as generated so they don't show up in the Github diff.\n# https://docs.github.com/en/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github\ntests/driver/rust/tests/*.rs linguist-generated\n" }, { "path": ".github/ISSUE_TEMPLATE/1-bug-report.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: 🐞 Bug Report\ndescription: Report a bug or unexpected behavior in Slint\nlabels: [\"need triaging\"]\ntype: \"Bug\"\nbody:\n- type: markdown\n attributes:\n value: |\n Thank you for reporting a bug! 🐛\n\n Please use this template to provide the information we need to investigate the issue.\n\n Before submitting, please search the [issue tracker](https://github.com/slint-ui/slint/issues) to ensure your bug hasn’t already been reported.\n\n If you have questions or need help with Slint, visit our [\"Discussions\" tab](https://github.com/slint-ui/slint/discussions).\n\n- type: textarea\n attributes:\n label: Bug Description\n description: |\n Clearly describe the issue, including:\n - What is the bug?\n - What behavior did you expect, and what happened instead?\n - Steps to reproduce the issue\n - Any error messages or logs, if available.\n validations:\n required: true\n\n- type: textarea\n attributes:\n label: Reproducible Code (if applicable)\n description: |\n If possible, include a minimal code snippet that reproduces the problem.\n This helps us debug faster!\n placeholder: |\n export component TestCase inherits Window {\n /* Your reproducible Slint code here */\n }\n render: slint\n validations:\n required: false\n\n- type: textarea\n attributes:\n label: Environment Details\n description: |\n Provide information about your setup:\n - Slint version (mention if this is a regression from a previous release).\n - Operating system and its version (e.g., Windows 11, Ubuntu 22.04, Android, etc.).\n If Linux, what Desktop Environment and whether you are using Wayland or X11.\n - Programming language used (e.g., C++, Rust, JavaScript, Python, etc.).\n - Backend/renderer being used (e.g., Qt, Skia, FemtoVG, Software, etc.).\n value: |\n - Slint Version:\n - Platform/OS:\n - Programming Language:\n - Backend/Renderer:\n validations:\n required: true\n\n- type: textarea\n attributes:\n label: Product Impact\n description: |\n Tell us about your project:\n - What are you building with Slint?\n - How critical is this issue for your product (e.g., blocker, inconvenience)?\n This helps us prioritize the issue effectively.\n validations:\n required: false\n" }, { "path": ".github/ISSUE_TEMPLATE/2-feature-request.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: ✨ Feature Request\ndescription: Suggest a new feature or improvement for Slint\nlabels: [\"need triaging\"]\ntype: \"Feature\"\nbody:\n- type: markdown\n attributes:\n value: |\n Thank you for suggesting a feature or improvement! ✨\n\n We value your ideas and feedback. However, before submitting a feature request here, please consider starting a discussion in the [\"Discussions\" tab](https://github.com/slint-ui/slint/discussions) to refine your idea and gather input from the community.\n\n Before submitting, please search the [issue tracker](https://github.com/slint-ui/slint/issues) to ensure your issue hasn’t already been reported.\n\n If you're confident about your suggestion and want to proceed, please fill out the form below.\n\n- type: textarea\n attributes:\n label: Feature Description\n description: |\n Please describe the feature or improvement you would like to see in Slint.\n Be as detailed as possible:\n - What problem does this feature solve, or what use case does it address?\n - How would this feature improve your workflow or product?\n\n Feel free to add code sample. You can format it in markdown within ```` ```slint ```` tags.\n validations:\n required: true\n\n- type: textarea\n attributes:\n label: Product Impact\n description: |\n Tell us about your project:\n - What are you building with Slint?\n - How would you make use of that feature?\n - How critical is this feature for your product (e.g., nice-to-have, must-have)?\n This helps us prioritize the issue effectively.\n validations:\n required: false\n" }, { "path": ".github/ISSUE_TEMPLATE/3-tracking-issue.md", "content": "---\nname: 🎯 Tracking Issue — ⚠️ Internal use only\nabout: Track progress on a long-term goal (Internal use only)\ntitle: '🎯 Tracking: '\nlabels: 'roadmap'\nassignees: ''\n---\n\n\n\n## Goal\n\n[What are we trying to achieve?]\n\n## See also\n\n- Outline: [link] (if applicable)\n\n" }, { "path": ".github/ISSUE_TEMPLATE/4-blank.md", "content": "---\nname: 🚧 Blank issue — ⚠️ Internal use only\nabout: Issue without labels. (Only for Slint developers)\ntitle: ''\nlabels: ''\nassignees: ''\n---\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\nblank_issues_enabled: false\ncontact_links:\n - name: ❓ Ask a Question\n url: https://github.com/slint-ui/slint/discussions\n about: Have a question about Slint? Head over to the Discussions forum to ask questions, share knowledge, and connect with the community!\n" }, { "path": ".github/actions/codesign/action.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n---\nname: Apple Codesign Binary\ndescription: Sign the given binary with the developer certificate\n\ninputs:\n binary:\n description: \"Path to binary\"\n required: true\n default: \"\"\n certificate:\n description: \"certificate secret\"\n required: true\n certificate_password:\n description: \"certificate password\"\n required: true\n keychain_password:\n description: \"keychain password to use\"\n required: true\n developer_id:\n description: \"developer id to use\"\n required: true\n\nruns:\n using: composite\n steps:\n - name: Codesign binary\n shell: bash\n env:\n CERT: ${{ inputs.certificate }}\n CERT_PW: ${{ inputs.certificate_password }}\n KEYCHAIN_PW: ${{ inputs.keychain_password }}\n DEV_ID: ${{ inputs.developer_id }}\n run: |\n echo -n \"$CERT\" | base64 --decode -o certificate.p12\n security create-keychain -p $KEYCHAIN_PW build.keychain\n security default-keychain -s build.keychain\n security unlock-keychain -p $KEYCHAIN_PW build.keychain\n security import certificate.p12 -k build.keychain -P $CERT_PW -T /usr/bin/codesign\n security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k $KEYCHAIN_PW build.keychain\n /usr/bin/codesign --force -s $DEV_ID \"${{ inputs.binary }}\" -v\n" }, { "path": ".github/actions/install-linux-dependencies/action.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# cSpell: ignore libxcb libxkbcommon xfixes\n---\nname: Install Linux dependencies\ndescription: Set up Linux dependencies for Slint\n\ninputs:\n extra-packages:\n description: \"Extra packages to install\"\n required: false\n default: \"\"\n force-gcc-10:\n description: 'Force GCC version 10 (default: \"no\")'\n required: false\n default: \"no\"\n old-ubuntu:\n description: \"This is running on an older version of Ubuntu\"\n required: false\n default: \"no\"\n\nruns:\n using: composite\n steps:\n - name: Install Linux dependencies\n if: runner.os == 'Linux'\n run: |\n sudo apt-get update\n sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev libxkbcommon-x11-dev libudev-dev libinput-dev libfontconfig-dev ${{ inputs.extra-packages }}\n shell: bash\n - name: Install Linux dependencies\n if: ${{ runner.os == 'Linux' && (inputs.old-ubuntu != 'true')}}\n run: |\n sudo apt-get update\n sudo apt-get install libseat-dev libsystemd-dev\n shell: bash\n - name: Install C++ compiler\n if: ${{ (runner.os == 'Linux') && (inputs.force-gcc-10 == 'true') }}\n run: |\n sudo apt-get install gcc-10 g++-10\n echo \"CC=gcc-10\" >> $GITHUB_ENV\n echo \"CXX=g++-10\" >> $GITHUB_ENV\n shell: bash\n" }, { "path": ".github/actions/install-skia-dependencies/action.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n---\nname: Install Skia dependencies\ndescription: Set up dependencies needed to build Skia\n\nruns:\n using: composite\n steps:\n - name: Upgrade LLVM for Skia build on Windows\n if: runner.os == 'Windows'\n run: choco upgrade llvm --version \"19.1.7\" --allow-downgrade\n shell: bash\n # See https://github.com/ilammy/msvc-dev-cmd?tab=readme-ov-file#caveats\n - name: Remove GNU link.exe from GH actions\n if: runner.os == 'Windows'\n run: rm /usr/bin/link\n shell: bash\n" }, { "path": ".github/actions/setup-rust/action.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# cSpell: ignore debuginfo rustflags swatinem\n\n---\nname: Setup Rust support\ndescription: Set up Slint development environment\n\ninputs:\n toolchain:\n description: \"Rust toolchain to use (default: stable)\"\n required: false\n default: stable\n target:\n description: \"Rust target to use\"\n required: false\n default: \"\"\n components:\n description: \"Rust components to install\"\n required: false\n default: \"\"\n key:\n description: \"Extra cache keying information\"\n required: false\n default: \"\"\n cache:\n description: \"Enable Rust caching (default: true)\"\n required: false\n default: \"true\"\n save_if:\n description: \"Condition to save the cache\"\n required: false\n default: ${{ github.ref == 'refs/heads/master' }}\n\nruns:\n using: composite\n steps:\n - name: Disable debug info to avoid running out of disk space on Windows\n if: runner.os == 'Windows'\n run: |\n echo \"RUSTFLAGS=-C debuginfo=0\" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append\n shell: powershell\n # Skia source builds end up with long paths, exceeding the 260 character limit. Enable this git for windows\n # option to use newer Windows API (https://github.com/git-for-windows/git/blob/bc3743def76f487b6dbc18b1b2645ab081c14980/Documentation/config/core.txt#L679)\n - name: Enable long path support for git checkouts\n if: runner.os == 'Windows'\n run: |\n git config --system core.longpaths true\n shell: powershell\n - name: Move cargo home close to the target/$profile directory, so that relative paths from build to cargo source are without drive letter\n if: runner.os == 'Windows'\n run: |\n echo \"CARGO_HOME=${{ runner.workspace }}\\cargo\" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append\n shell: powershell\n - name: Set GETTEXT_DIR environment variable or it will still be compiled from source.\n if: runner.os == 'macOS'\n run: |\n GETTEXT_PATH=$(brew --prefix gettext)\n echo \"GETTEXT_DIR=${GETTEXT_PATH}\" >> $GITHUB_ENV\n echo \"Installed gettext at: ${GETTEXT_PATH}\"\n shell: bash\n - name: Install Rust ${{ inputs.toolchain }}\n uses: dtolnay/rust-toolchain@stable\n with:\n toolchain: ${{ inputs.toolchain }}\n components: ${{ inputs.components }}\n target: ${{ inputs.target }}\n - uses: Swatinem/rust-cache@v2\n if: inputs.cache == 'true'\n with:\n key: ${{ inputs.key }}-1\n save-if: ${{ inputs.save_if }}\n" }, { "path": ".github/ci_path_filters.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nci_config: &ci_config\n - '.github/**'\n - '.mise/**'\n # We count changes to Cargo.lock as a \"CI config\" level change, as we need to ensure that all CI jobs will work correctly with the updated lock file.\n # Otherwise, later job runs may run into issues that have nothing to do with their changes.\n - 'Cargo.lock'\n\nfiles_in_root: &files_in_root\n - '*!(/)' # changes in the root, such as cspell.json or pnpm-lock.yaml\n - '.*'\n\njs_config: &js_config\n - 'package.json'\n - 'package-lock.json'\n - 'pnpm-workspace.yaml'\n - '.npmrc'\n - 'pnpm-lock.yaml'\n\nslint:\n - 'api/**'\n - 'cmake/**'\n - 'demos/**'\n - 'docker/**'\n - 'docs/**'\n - 'editors/**'\n - 'helper_crates/**'\n - 'internal/**'\n - 'logo/**'\n - 'scripts/**'\n - 'tests/**'\n - 'tools/compiler/**'\n - 'tools/docsnapper/**'\n - 'tools/figma_import/**'\n - 'tools/lsp/**'\n - 'tools/slintpad/**'\n - 'tools/tr-extractor/**'\n - 'tools/updater/**'\n - 'tools/viewer/**'\n - 'xtask/**'\n - *files_in_root\n - *ci_config\n\nfigma_inspector:\n - 'tools/figma-inspector/**'\n - *js_config\n - *ci_config\n\nmaterial_components:\n - 'ui-libraries/material/**'\n\ninternal: &internal\n # The API specific tests don't depends on renderer or backend, but they do depend on the Qt widgets and the testing backend\n - 'internal/!({renderers,backends}/**)'\n - 'internal/backends/qt/**'\n - 'internal/backends/testing/**'\n - 'helper_crates/**'\n - 'Cargo.toml' # the root Cargo.toml\n - '.cargo/**'\n - *ci_config\n\napi_cpp:\n - 'api/cpp/**'\n - 'tools/compiler/**'\n - *ci_config\n # The renderers are not part of the `internal` group, but are exposed in the C++ API\n - 'internal/renderers/{skia,software}/**'\n\napi_python:\n - 'api/python/**'\n - *ci_config\n\napi_node:\n - 'api/node/**'\n - *js_config\n - *ci_config\n\napi_rs:\n - 'api/rs/**'\n - 'Cargo.toml'\n - *ci_config\n\ntests:\n - 'tests/**'\n\nexamples:\n # Some examples are tested separately and can be excluded from here\n - 'examples/!({servo,bevy,*mcu*,uefi-demo,}/**)'\n - 'demos/**'\n\nexamples_mcu:\n - 'examples/*mcu*/**'\n - 'internal/renderers/software/**'\n\nvsce:\n - *internal\n - *js_config\n - 'api/rs/**'\n - 'editors/vscode/**'\n - 'tools/lsp/**'\n - 'docs/common/src/utils/slint.tmLanguage.json'\n\nslintpad:\n - *internal\n - 'tools/slintpad/**'\n - 'api/wasm-interpreter/**'\n - 'tools/lsp/**'\n - 'api/rs/**'\n - 'docs/common/src/utils/slint.tmLanguage.json'\n\nupdater_test:\n - *internal\n - 'tests/cases/**'\n - 'tools/updater/**'\n\nservo_example:\n - 'examples/servo/**'\n - *ci_config\n\nbevy_examples:\n - 'examples/bevy/**'\n - *ci_config\n\nrust_files:\n - '**/*.rs'\n - '**/Cargo.toml'\n - 'Cargo.lock'\n - *ci_config\n" }, { "path": ".github/dependabot.yml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# Please see the documentation for all configuration options:\n# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates\n\nversion: 2\nupdates:\n - package-ecosystem: github-actions\n open-pull-requests-limit: 20\n directory: /\n schedule:\n interval: weekly\n time: \"01:00\"\n groups:\n github-actions:\n patterns:\n - \"*\" # Group all Actions updates into a single larger pull request\n ignore:\n - dependency-name: \"lukka/run-cmake\"\n\n\n - package-ecosystem: \"npm\" # See documentation for possible values\n open-pull-requests-limit: 20\n directory: \"/\" # Location of package manifests\n schedule:\n interval: \"weekly\"\n time: \"01:00\"\n ignore:\n - dependency-name: \"@types/node\"\n - dependency-name: \"@types/vscode\"\n - dependency-name: \"@codingame/monaco-vscode-configuration-service-override\"\n - dependency-name: \"@codingame/monaco-vscode-files-service-override\"\n - dependency-name: \"@codingame/monaco-vscode-keybindings-service-override\"\n - dependency-name: \"@codingame/monaco-vscode-languages-service-override\"\n - dependency-name: \"@codingame/monaco-vscode-model-service-override\"\n - dependency-name: \"@codingame/monaco-vscode-storage-service-override\"\n - dependency-name: \"@codingame/monaco-vscode-api\"\n - dependency-name: \"@codingame/monaco-vscode-editor-api\"\n - dependency-name: \"@napi-rs/cli\"\n - dependency-name: \"monaco-editor-wrapper\"\n - dependency-name: \"monaco-languageclient\"\n\n groups:\n npm-major-updates:\n update-types: [\"major\"]\n npm-minor-updates:\n update-types: [\"minor\"]\n npm-patch-updates:\n update-types: [\"patch\"]" }, { "path": ".github/pull_request_template.md", "content": "\n" }, { "path": ".github/workflows/autofix.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: autofix.ci # needed to securely identify the workflow\n\non:\n pull_request:\n branches: [master, \"feature/*\", \"pre-release/*\"]\n push:\n branches: [master, \"feature/*\", \"pre-release/*\"]\n workflow_dispatch:\n merge_group:\n\npermissions:\n contents: read\n\nconcurrency:\n group: ci-${{ github.event.pull_request.number || github.ref }}\n cancel-in-progress: true\n\nenv:\n CARGO_INCREMENTAL: false\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\njobs:\n format_fix:\n runs-on: ubuntu-latest\n timeout-minutes: 5\n steps:\n - uses: actions/checkout@v6\n - uses: jdx/mise-action@v4\n with:\n version: 2025.9.18\n log_level: debug\n - name: Install rust dependencies\n run: rustup toolchain install stable-x86_64-unknown-linux-gnu --profile default\n - name: Run fixes\n run: mise run --force --jobs=1 'ci:autofix:fix'\n - name: Suggest format changes\n uses: autofix-ci/action@7a166d7532b277f34e16238930461bf77f9d7ed8\n\n lint_typecheck:\n runs-on: ubuntu-latest\n timeout-minutes: 5\n steps:\n - uses: actions/checkout@v6\n - uses: jdx/mise-action@v4\n with:\n version: 2025.9.18\n log_level: debug\n - name: Install rust dependencies\n run: rustup toolchain install stable-x86_64-unknown-linux-gnu --profile default\n - name: Run lints\n run: mise run --force --jobs=1 'ci:autofix:lint'\n\n ci:\n needs: [format_fix, lint_typecheck]\n permissions:\n contents: read\n deployments: write\n pull-requests: read\n uses: ./.github/workflows/ci.yaml\n secrets:\n ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}\n ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}\n CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n CLOUDFLARE_API_TOKEN_2: ${{ secrets.CLOUDFLARE_API_TOKEN_2 }}\n CLOUDFLARE_ACCOUNT_ID_2: ${{ secrets.CLOUDFLARE_ACCOUNT_ID_2 }}\n READ_WRITE_PRIVATE_KEY: ${{ secrets.READ_WRITE_PRIVATE_KEY }}\n\n done:\n needs: [ci]\n name: done\n runs-on: ubuntu-latest\n steps:\n - run: echo \"All checks passed.\"\n" }, { "path": ".github/workflows/bevy_examples.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Bevy examples\n\non:\n workflow_dispatch:\n inputs:\n update:\n description: 'Whether to run cargo update before testing'\n required: false\n type: boolean\n default: false\n save_if:\n description: 'Condition to save the cache'\n required: false\n type: boolean\n default: true\n workflow_call:\n inputs:\n update:\n description: 'Whether to run cargo update before testing'\n required: false\n type: boolean\n default: false\n save_if:\n description: 'Condition to save the cache'\n required: false\n type: boolean\n default: true\n\njobs:\n bevy_examples:\n strategy:\n matrix:\n os: [ubuntu-22.04, macos-14, windows-2022]\n runs-on: ${{ matrix.os }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n save_if: ${{ inputs.save_if }}\n - uses: ./.github/actions/install-linux-dependencies\n with:\n extra-packages: libwayland-dev libasound2-dev\n - uses: ./.github/actions/install-skia-dependencies\n - uses: ilammy/msvc-dev-cmd@v1\n - name: Cargo update\n if: ${{ inputs.update }}\n run: cargo update\n working-directory: examples/bevy\n - name: Build Bevy Examples\n run: cargo build --locked\n working-directory: examples/bevy\n" }, { "path": ".github/workflows/build_and_test_reusable.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Build and Test (Reusable)\n\non:\n workflow_call:\n inputs:\n name:\n description: 'Name of the job'\n required: true\n type: string\n os:\n description: 'Operating system to run on'\n required: true\n type: string\n rust_version:\n description: 'Rust version to use'\n required: true\n type: string\n update:\n description: 'Whether to run cargo update before testing'\n required: false\n type: boolean\n default: false\n extra_args:\n description: 'Extra arguments to pass to cargo test'\n required: false\n type: string\n default: \"\"\n cache:\n description: 'Use rust-cache'\n required: false\n type: boolean\n default: true\n save_if:\n description: 'Condition to save the cache'\n required: false\n type: boolean\n default: true\n timeout_minutes:\n description: 'Timeout in minutes'\n required: false\n type: number\n default: 120\n\njobs:\n build_and_test:\n name: ${{ inputs.name }}\n timeout-minutes: ${{ inputs.timeout_minutes }}\n env:\n MACOSX_DEPLOYMENT_TARGET: \"11.0\"\n DYLD_FRAMEWORK_PATH: /Users/runner/work/slint/Qt/6.2.2/macos/lib\n QT_QPA_PLATFORM: offscreen\n RUSTFLAGS: -D warnings\n CARGO_PROFILE_DEV_DEBUG: 0\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: 1\n SLINT_EMIT_DEBUG_INFO: 1\n\n runs-on: ${{ inputs.os }}\n\n steps:\n - name: Maximize build space\n if: runner.os == 'Linux'\n run: |\n df -h\n [ -d /usr/local/lib/android ] && sudo rm -rf /usr/local/lib/android\n [ -d /usr/share/dotnet ] && sudo rm -rf /usr/share/dotnet\n # For now, comment out a few of these deletion commands to speed up the runner startup\n # [ -d /opt/ghc ] && sudo rm -rf /opt/ghc\n # [ -d /opt/hostedtoolcache/CodeQL ] && sudo rm -rf /opt/hostedtoolcache/CodeQL\n # Pruning docker images could free up another 3GB\n # sudo docker image prune --all --force\n df -h\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/install-skia-dependencies\n - uses: ilammy/msvc-dev-cmd@v1\n - uses: actions/setup-python@v6\n with:\n python-version: '3.10'\n - name: Install uv\n uses: astral-sh/setup-uv@v7\n - name: Install Qt\n if: runner.os != 'Windows'\n uses: jurplel/install-qt-action@v4\n with:\n version: \"6.2.2\"\n setup-python: false\n cache: true\n - name: Install ffmpeg and alsa (Linux)\n if: runner.os == 'Linux'\n run: sudo apt-get install clang libavcodec-dev libavformat-dev libavutil-dev libavfilter-dev libavdevice-dev libasound2-dev pkg-config\n - name: Install gstreamer and libunwind (Linux)\n if: runner.os == 'Linux'\n run: sudo apt-get install libunwind-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good\n - name: Setup headless display\n if: runner.os != 'macOS'\n uses: pyvista/setup-headless-display-action@v4\n - uses: ./.github/actions/setup-rust\n with:\n toolchain: ${{ inputs.rust_version }}\n key: x-v3\n save_if: ${{ inputs.save_if }}\n cache: ${{ inputs.cache }}\n - name: Cargo update\n if: inputs.update\n # Ignore rust_version for stable/nightly to test with latest dependencies\n run: cargo update ${{ (inputs.rust_version == 'stable' || inputs.rust_version == 'nightly') && '--ignore-rust-version' || '' }}\n - name: Run tests\n run: cargo test --locked --verbose --all-features --workspace --timings ${{ inputs.extra_args }} --exclude slint-node --exclude pyslint --exclude test-driver-node --exclude slint-node --exclude test-driver-nodejs --exclude test-driver-cpp --exclude test-driver-python --exclude mcu-board-support --exclude mcu-embassy --exclude printerdemo_mcu --exclude uefi-demo --exclude slint-cpp --exclude slint-python -- --skip=_qt::t\n env:\n SLINT_CREATE_SCREENSHOTS: 1\n shell: bash\n - name: Run tests (qt)\n run: cargo test --locked --verbose --all-features --workspace ${{ inputs.extra_args }} --exclude slint-node --exclude pyslint --exclude test-driver-node --exclude slint-node --exclude test-driver-nodejs --exclude test-driver-cpp --exclude test-driver-python --exclude mcu-board-support --exclude mcu-embassy --exclude printerdemo_mcu --exclude uefi-demo --exclude slint-cpp --exclude slint-python _qt -- --test-threads=1\n shell: bash\n - name: live-preview for rust test\n env:\n SLINT_LIVE_PREVIEW: 1\n run: cargo test --locked --verbose --all-features --features slint/live-preview -p test-driver-rust -- --skip=_qt::t\n shell: bash\n - name: Upload build timing report\n if: always()\n uses: actions/upload-artifact@v7\n with:\n name: cargo-timings-${{ inputs.os }}-${{ inputs.rust_version }}\n path: target/cargo-timings/cargo-timing.html\n if-no-files-found: ignore\n - name: Archive screenshots after failed tests\n if: ${{ failure() }}\n uses: actions/upload-artifact@v7\n with:\n name: screenshots-${{ inputs.os }}\n path: |\n tests/screenshots/references\n - name: Print Disk Usage\n if: always()\n run: df -h\n\n" }, { "path": ".github/workflows/build_docs.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# Build various demo binaries, c++ packages and documentation and publish them on the website\n# Job 1 (rust-cpp-docs): Build Rust and C++ documentation\n# Job 2 (astro-docs-tests): Generate screenshots, build Astro docs and run tests\n# Job 3 (node-python-docs): Build Node and Python documentation\n# Job 4 (check-warnings): Validate docs for warnings\n\nname: Build docs\n\non:\n workflow_call:\n secrets:\n READ_WRITE_PRIVATE_KEY:\n required: true\n inputs:\n release:\n type: string\n default: \"false\"\n required: false\n description: \"Release? Enable options for building binaries for a release (i.e. apply a nightly tag, nightly version)\"\n app-id:\n type: string\n required: true\n\njobs:\n # Job 1: Build Rust and C++ documentation\n rust-cpp-docs:\n runs-on: ubuntu-24.04\n env:\n # Allow deprecated warning because we are using nightly and some things might be deprecated in nightly\n # for which the stable alternative is not yet available.\n RUSTFLAGS: -D warnings -W deprecated --cfg slint_nightly_test\n RUSTDOCFLAGS: --html-in-header=/home/runner/work/slint/slint/docs/astro/src/utils/slint-docs-highlight.html -D warnings -W deprecated --cfg docsrs -Zunstable-options --generate-link-to-definition\n SLINT_NO_QT: 1\n CARGO_INCREMENTAL: false\n RELEASE_INPUT: ${{ inputs.release }}\n steps:\n - uses: actions/checkout@v6\n - name: Set up crate rustdoc link\n run: |\n rgb_version=`grep 'rgb = ' internal/core/Cargo.toml | sed 's/^.*\"\\(.*\\)\"/\\1/'`\n echo \"RUSTDOCFLAGS=$RUSTDOCFLAGS --extern-html-root-url rgb=https://docs.rs/rgb/$rgb_version/ --extern-html-root-url android_activity=https://docs.rs/android-activity/0.5/ --extern-html-root-url raw_window_handle=https://docs.rs/raw_window_handle/0.6 --extern-html-root-url winit=https://docs.rs/winit/0.30 --extern-html-root-url wgpu=https://docs.rs/wgpu/26 --extern-html-root-url input=https://docs.rs/input/0.9 --extern-html-root-url fontique=https://docs.rs/fontique/0.7\" >> $GITHUB_ENV\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/setup-rust\n with:\n toolchain: nightly\n target: aarch64-linux-android\n - name: Install apt dependencies\n run: sudo apt-get install doxygen\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Install uv\n uses: astral-sh/setup-uv@v7\n - name: Build Cpp docs\n run: |\n CPPDOCS_EXTRA_FLAGS=\"\"\n if [ \"$RELEASE_INPUT\" != \"true\" ]; then\n CPPDOCS_EXTRA_FLAGS=\"--experimental\"\n fi\n cargo xtask cppdocs --show-warnings $CPPDOCS_EXTRA_FLAGS\n - name: \"Rust docs\"\n run: cargo doc -p slint -p slint-build -p slint-interpreter --no-deps --all-features\n - name: \"Rust android-activity and i-slint-backend-winit\"\n run: |\n cargo doc -p i-slint-backend-android-activity -p i-slint-backend-winit -p i-slint-backend-testing --no-deps --target aarch64-linux-android --features=i-slint-backend-android-activity/native-activity,i-slint-backend-android-activity/aa-06,i-slint-backend-winit/raw-window-handle-06,i-slint-backend-winit/renderer-femtovg\n cp -r target/aarch64-linux-android/doc/i_slint_backend_android_activity/ target/doc/\n cp -r target/aarch64-linux-android/doc/i_slint_backend_winit/ target/doc/\n cp -r target/aarch64-linux-android/doc/i_slint_backend_testing/ target/doc/\n - name: \"Prepare Rust and C++ docs for website directory structure\"\n run: |\n mkdir -p artifact/docs\n mv target/doc artifact/docs/rust\n mv target/cppdocs/html artifact/docs/cpp\n - name: \"Upload Rust/C++ Docs Artifacts\"\n uses: actions/upload-artifact@v7\n with:\n name: docs-rust-cpp\n path: artifact\n - name: \"Check for docs warnings in internal crates\"\n run: cargo doc --workspace --no-deps --all-features --exclude slint-node --exclude pyslint --exclude mcu-board-support --exclude mcu-embassy --exclude printerdemo_mcu --exclude carousel --exclude test-* --exclude plotter --exclude uefi-demo --exclude ffmpeg --exclude gstreamer-player --exclude slint-cpp --exclude slint-python\n\n # Job 2: Build Astro docs and run tests\n astro-docs-tests:\n runs-on: ubuntu-24.04\n env:\n RUSTFLAGS: -D warnings -W deprecated\n RUSTDOCFLAGS: --html-in-header=/home/runner/work/slint/slint/docs/astro/src/utils/slint-docs-highlight.html -D warnings -W deprecated --cfg docsrs -Zunstable-options --generate-link-to-definition\n SLINT_NO_QT: 1\n CARGO_INCREMENTAL: false\n RELEASE_INPUT: ${{ inputs.release }}\n steps:\n - uses: actions/checkout@v6\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n - uses: ./.github/actions/install-linux-dependencies\n - name: Install MS fonts for comic sans needed by one of the screenshots in the docs\n run: |\n echo ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true | sudo debconf-set-selections\n sudo apt-get install ttf-mscorefonts-installer -y\n - uses: ./.github/actions/setup-rust\n with:\n toolchain: stable\n target: aarch64-linux-android\n cache: false\n - name: \"Generate Screenshots for Example Snippets\"\n run: cargo run --release -p slint-docsnapper -- docs/astro/src/content --overwrite\n - name: \"Install Node dependencies\"\n run: pnpm i --frozen-lockfile\n - name: Extract Version from Cargo.toml\n id: version\n run: |\n version=$(awk '/^\\[workspace.package\\]/ {found=1} found && /^version = / {gsub(/version = |\"/, \"\", $0); print $0; exit}' Cargo.toml)\n if [[ -z \"$version\" ]]; then\n echo \"Version not found\"\n exit 1\n fi\n echo \"VERSION=$version\" >> $GITHUB_OUTPUT\n - name: Update URL for sitemap in site-config.ts\n run: |\n version=\"${{ steps.version.outputs.VERSION }}\"\n if [ \"$RELEASE_INPUT\" != \"true\" ]; then\n base_url=\"https://snapshots.slint.dev\"\n base_path=\"/master/docs/slint/\"\n slint_download_version=nightly\n else\n base_url=\"https://releases.slint.dev\"\n base_path=\"/$version/docs/slint/\"\n slint_download_version=v$version\n fi\n sed -i \"s|BASE_URL = \\\".*\\\"|BASE_URL = \\\"$base_url\\\"|\" docs/common/src/utils/site-config.ts\n sed -i \"s|BASE_PATH = \\\".*\\\"|BASE_PATH = \\\"$base_path\\\"|\" docs/common/src/utils/site-config.ts\n sed -i \"s|SLINT_DOWNLOAD_VERSION = \\\".*\\\"| SLINT_DOWNLOAD_VERSION = \\\"$slint_download_version\\\"|\" docs/common/src/utils/site-config.ts\n - name: \"Slint Language Documentation\"\n run: cargo xtask slintdocs\n - name: Spellcheck\n working-directory: docs/astro\n run: pnpm spellcheck\n - name: Install Playwright\n working-directory: docs/astro\n run: pnpm exec playwright install --with-deps\n - name: Run Playwright tests\n working-directory: docs/astro\n run: pnpm exec playwright test\n - name: Publish Test Summary Results\n working-directory: docs/astro\n run: npx github-actions-ctrf playwright-report/ctrf-report.json\n - name: Upload test results\n if: always()\n uses: actions/upload-artifact@v7\n with:\n name: playwright-test-report\n path: docs/astro/playwright-report/\n retention-days: 30\n - name: Debug - Verify dist exists before upload\n run: |\n echo \"=== Checking docs/astro/dist ===\"\n ls -la docs/astro/ || echo \"docs/astro/ does not exist\"\n ls -la docs/astro/dist/ || echo \"docs/astro/dist/ does not exist\"\n echo \"File count in dist: $(find docs/astro/dist -type f 2>/dev/null | wc -l)\"\n echo \"First 10 files:\"\n find docs/astro/dist -type f 2>/dev/null | head -10\n - name: \"Prepare docs for website structure\"\n run: |\n mkdir -p artifact/docs\n mv docs/astro/dist artifact/docs/slint\n - name: \"Upload Astro Docs Artifacts\"\n uses: actions/upload-artifact@v7\n with:\n name: docs-astro\n path: artifact\n\n # Job 3: Build Node and Python documentation\n node-python-docs:\n runs-on: ubuntu-24.04\n env:\n RELEASE_INPUT: ${{ inputs.release }}\n steps:\n - uses: actions/checkout@v6\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/setup-rust\n with:\n toolchain: stable\n target: aarch64-linux-android\n cache: false\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Install uv\n uses: astral-sh/setup-uv@v7\n - name: \"Install Node dependencies\"\n run: pnpm i --frozen-lockfile\n - name: \"Node docs\"\n run: pnpm run docs\n working-directory: api/node\n - name: Setup headless display\n uses: pyvista/setup-headless-display-action@v4\n - name: \"Python docs\"\n run: uv run build_docs.py\n working-directory: api/python/slint\n - name: \"Prepare docs for website structure\"\n run: |\n mkdir -p artifact/docs\n mv api/node/docs artifact/docs/node\n mv api/python/slint/docs artifact/docs/python\n - name: \"Upload Python/Node Docs Artifacts\"\n uses: actions/upload-artifact@v7\n with:\n name: docs-node-python\n path: artifact\n" }, { "path": ".github/workflows/ci.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: CI\n\non:\n workflow_dispatch:\n workflow_call:\n secrets:\n CLOUDFLARE_API_TOKEN:\n required: true\n CLOUDFLARE_ACCOUNT_ID:\n required: true\n CLOUDFLARE_API_TOKEN_2:\n required: true\n CLOUDFLARE_ACCOUNT_ID_2:\n required: true\n ANDROID_KEYSTORE_PASSWORD:\n required: true\n ANDROID_KEYSTORE_BASE64:\n required: true\n READ_WRITE_PRIVATE_KEY:\n required: true\n\nenv:\n MACOSX_DEPLOYMENT_TARGET: \"11.0\"\n SLINT_COMPILER_DENY_WARNINGS: 1\n\njobs:\n files-changed:\n runs-on: ubuntu-latest\n timeout-minutes: 1\n permissions:\n pull-requests: read\n outputs:\n slint: ${{ steps.filter.outputs.slint }}\n figma_inspector : ${{ steps.filter.outputs.figma_inspector }}\n material_components : ${{ steps.filter.outputs.material_components }}\n internal : ${{ steps.filter.outputs.internal }}\n api_cpp : ${{ steps.filter.outputs.api_cpp }}\n api_python : ${{ steps.filter.outputs.api_python }}\n api_node : ${{ steps.filter.outputs.api_node }}\n api_rs : ${{ steps.filter.outputs.api_rs }}\n tests : ${{ steps.filter.outputs.tests }}\n examples : ${{ steps.filter.outputs.examples }}\n examples_mcu : ${{ steps.filter.outputs.examples_mcu }}\n vsce : ${{ steps.filter.outputs.vsce }}\n slintpad : ${{ steps.filter.outputs.slintpad }}\n updater_test : ${{ steps.filter.outputs.updater_test }}\n servo_example : ${{ steps.filter.outputs.servo_example }}\n bevy_examples : ${{ steps.filter.outputs.bevy_examples }}\n rust_files : ${{ steps.filter.outputs.rust_files }}\n steps:\n - uses: actions/checkout@v6\n - uses: dorny/paths-filter@v4\n id: filter\n with:\n token: ${{ github.token }}\n filters: .github/ci_path_filters.yaml\n\n build_and_test:\n needs: files-changed\n if: needs.files-changed.outputs.slint == 'true' || needs.files-changed.outputs.examples == 'true'\n strategy:\n matrix:\n include:\n - os: ubuntu-22.04\n name: \"Ubuntu 22.04 beta\"\n rust_version: \"beta\"\n save_if: ${{ github.ref == 'refs/heads/master' }}\n extra_args: \"--exclude plotter\"\n - os: windows-2022\n name: \"Windows 2022 1.92\"\n rust_version: \"1.92\"\n save_if: ${{ github.ref == 'refs/heads/master' }}\n extra_args: \"--exclude ffmpeg --exclude gstreamer-player\"\n - os: macos-14\n name: \"MacOS 14 stable\"\n rust_version: \"stable\"\n save_if: ${{ github.ref == 'refs/heads/master' }}\n extra_args: \"--exclude ffmpeg --exclude gstreamer-player\"\n uses: ./.github/workflows/build_and_test_reusable.yaml\n with:\n os: ${{ matrix.os }}\n name: build_and_test ${{ matrix.name }}\n rust_version: ${{ matrix.rust_version }}\n extra_args: ${{ matrix.extra_args }} --exclude material-gallery\n save_if: ${{ matrix.save_if }}\n\n # For changes to Slint internals, do a quick test on Linux for Node.js only.\n node_test_linux:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.api_node == 'true' || needs.files-changed.outputs.tests == 'true'\n uses: ./.github/workflows/node_test_reusable.yaml\n with:\n name: \"Node.js Linux\"\n os: \"ubuntu-22.04\"\n\n node_test_macos:\n needs: files-changed\n if: needs.files-changed.outputs.api_node == 'true' || needs.files-changed.outputs.tests == 'true'\n uses: ./.github/workflows/node_test_reusable.yaml\n with:\n name: \"Node.js macOS\"\n os: \"macos-14\"\n\n node_test_windows:\n needs: files-changed\n if: needs.files-changed.outputs.api_node == 'true' || needs.files-changed.outputs.tests == 'true'\n uses: ./.github/workflows/node_test_reusable.yaml\n with:\n name: \"Node.js Windows\"\n os: \"windows-2022\"\n\n # For changes to Slint internals, do a quick test on Linux for Python only.\n python_test_linux:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.api_python == 'true' || needs.files-changed.outputs.tests == 'true'\n uses: ./.github/workflows/python_test_reusable.yaml\n with:\n name: \"Python Linux\"\n os: \"ubuntu-22.04\"\n python_test_macos:\n needs: files-changed\n if: needs.files-changed.outputs.api_python == 'true' || needs.files-changed.outputs.tests == 'true'\n uses: ./.github/workflows/python_test_reusable.yaml\n with:\n name: \"Python macOS\"\n os: \"macos-14\"\n python_test_windows:\n needs: files-changed\n if: needs.files-changed.outputs.api_python == 'true' || needs.files-changed.outputs.tests == 'true'\n uses: ./.github/workflows/python_test_reusable.yaml\n with:\n name: \"Python Windows\"\n os: \"windows-2022\"\n\n cpp_test_driver:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.api_cpp == 'true' || needs.files-changed.outputs.tests == 'true'\n env:\n DYLD_FRAMEWORK_PATH: /Users/runner/work/slint/Qt/5.15.2/clang_64/lib\n QT_QPA_PLATFORM: offscreen\n RUSTFLAGS: -D warnings\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: 1\n CARGO_PROFILE_DEV_DEBUG: 0\n strategy:\n matrix:\n os: [ubuntu-22.04, macos-14, windows-2022]\n runs-on: ${{ matrix.os }}\n\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n force-gcc-10: true\n - name: Install Qt\n if: runner.os == 'Linux'\n uses: jurplel/install-qt-action@v4\n with:\n version: \"5.15.2\"\n cache: true\n - name: Set default style\n if: runner.os != 'Windows'\n run: echo \"SLINT_STYLE=native\" >> $GITHUB_ENV\n - name: Set default style\n if: runner.os == 'Windows'\n run: |\n echo \"SLINT_STYLE=fluent\" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append\n echo \"SLINT_NO_QT=1\" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append\n - uses: ./.github/actions/setup-rust\n - name: Run tests\n run: cargo test --verbose -p test-driver-cpp --features slint-cpp/backend-qt\n\n cpp_cmake:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.api_cpp == 'true' || needs.files-changed.outputs.examples == 'true'\n env:\n DYLD_FRAMEWORK_PATH: /Users/runner/work/slint/Qt/6.5.1/clang_64/lib\n QT_QPA_PLATFORM: offscreen\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: 1\n CARGO_PROFILE_DEV_DEBUG: 0\n SLINT_EMIT_DEBUG_INFO: 1\n strategy:\n matrix:\n include:\n - os: macos-14\n rust_version: \"1.88\"\n - os: windows-2022\n rust_version: \"nightly\"\n - os: ubuntu-22.04\n rust_version: \"stable\"\n runs-on: ${{ matrix.os }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n force-gcc-10: true\n - name: Install Qt\n uses: jurplel/install-qt-action@v4\n with:\n version: 6.5.1\n cache: true\n - uses: ./.github/actions/setup-rust\n - uses: ilammy/msvc-dev-cmd@v1\n - name: Select MSVC (windows)\n if: matrix.os == 'windows-2022'\n run: |\n echo \"CC=cl.exe\" >> $GITHUB_ENV\n echo \"CXX=cl.exe\" >> $GITHUB_ENV\n - name: Enable test coverage for resource embedding in C++ when building examples\n if: matrix.os == 'ubuntu-22.04'\n run: |\n echo \"SLINT_EMBED_RESOURCES=true\" >> $GITHUB_ENV\n - name: C++ Build\n uses: lukka/run-cmake@v3.4\n with:\n cmakeListsOrSettingsJson: CMakeListsTxtAdvanced\n cmakeListsTxtPath: CMakeLists.txt\n cmakeAppendedArgs: \"-DSLINT_BUILD_TESTING=ON -DSLINT_BUILD_EXAMPLES=ON -DCMAKE_BUILD_TYPE=Debug -DSLINT_FEATURE_RENDERER_SKIA=ON -DSLINT_FEATURE_BACKEND_QT=ON -DSLINT_FEATURE_EXPERIMENTAL=ON -DSLINT_FEATURE_TESTING=ON\"\n buildDirectory: ${{ runner.workspace }}/cppbuild\n buildWithCMakeArgs: \"--config Debug\"\n - name: ctest\n working-directory: ${{ runner.workspace }}/cppbuild\n run: ctest --verbose -C Debug\n - name: cpack\n working-directory: ${{ runner.workspace }}/cppbuild\n run: cmake --build . --config Debug --target package\n - name: \"Create C++ packages artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: cpp_bin-${{ matrix.os }}\n path: ${{ runner.workspace }}/cppbuild/Slint-cpp-*\n\n cpp_package_test:\n needs: [cpp_cmake]\n runs-on: ubuntu-22.04\n env:\n QT_QPA_PLATFORM: offscreen\n CARGO_INCREMENTAL: false\n CARGO_PROFILE_DEV_DEBUG: 0\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n force-gcc-10: true\n - name: Install Qt (Ubuntu)\n uses: jurplel/install-qt-action@v4\n with:\n version: 6.5.1\n cache: true\n - uses: actions/download-artifact@v8\n with:\n name: cpp_bin-ubuntu-22.04\n path: cpp-package\n - name: unpack package\n run: |\n mkdir package\n tar xvf cpp-package/Slint-cpp-*.tar.gz -C package --strip-components=1\n echo \"CMAKE_PREFIX_PATH=`pwd`/package\" >> $GITHUB_ENV\n # Build the examples with a config different than the package (which is debug)\n - name: Build examples\n uses: lukka/run-cmake@v3.4\n with:\n cmakeListsOrSettingsJson: CMakeListsTxtAdvanced\n cmakeListsTxtPath: examples/CMakeLists.txt\n cmakeAppendedArgs: \"-DCMAKE_BUILD_TYPE=Release -DSLINT_FEATURE_INTERPRETER=1 -DSLINT_FEATURE_BACKEND_QT=1\"\n buildDirectory: ${{ runner.workspace }}/examples/build\n buildWithCMakeArgs: \"--config Release\"\n\n vsce_build_test:\n needs: files-changed\n if: needs.files-changed.outputs.vsce == 'true'\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - uses: Swatinem/rust-cache@v2\n with:\n key: \"vsce_1\" # increment this to bust the cache if needed\n - uses: ./.github/actions/install-linux-dependencies\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n - name: Install wasm-pack\n run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh\n - name: Fake slint-lsp build\n run: |\n mkdir -p target/debug\n echo 1 > target/debug/slint-lsp\n - name: Run pnpm install\n working-directory: editors/vscode\n run: pnpm install --frozen-lockfile\n - name: vscode prebuild\n working-directory: editors/vscode\n run: pnpm vscode:prepublish\n - name: Build VS Code extension\n working-directory: editors/vscode\n run: pnpm local-package\n - name: Typescript syntax check # has to run after the build as it depends on the wasm\n working-directory: editors/vscode\n run: pnpm type-check\n - name: Check tmGrammar\n working-directory: editors/vscode\n run: pnpm test_grammar\n\n # test to compile the mcu backend for the arm target (no_std)\n mcu:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.examples_mcu == 'true' || needs.files-changed.outputs.api_rs == 'true'\n env:\n SLINT_FONT_SIZES: 8,11,10,12,13,14,15,16,18,20,22,24,32\n RUSTFLAGS: --cfg slint_int_coord -D warnings\n CARGO_PROFILE_DEV_DEBUG: 0\n CARGO_PROFILE_RELEASE_OPT_LEVEL: s\n runs-on: ubuntu-22.04\n strategy:\n matrix:\n include:\n - feature: pico-st7789\n target: thumbv6m-none-eabi\n - feature: pico2-st7789\n target: thumbv8m.main-none-eabihf\n - feature: pico2-touch-lcd-2-8\n target: thumbv8m.main-none-eabihf\n - feature: stm32h735g\n target: thumbv7em-none-eabihf\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: ${{matrix.target}}\n - name: Check\n run: cargo check --target=${{matrix.target}} -p printerdemo_mcu --no-default-features --features=mcu-board-support/${{matrix.feature}} --release\n\n # test to compile the mcu backend for the arm target (no_std) using embassy\n mcu-embassy:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.examples_mcu == 'true' || needs.files-changed.outputs.api_rs == 'true'\n env:\n SLINT_FONT_SIZES: 8,11,10,12,13,14,15,16,18,20,22,24,32\n RUSTFLAGS: --cfg slint_int_coord -D warnings\n CARGO_PROFILE_DEV_DEBUG: 0\n CARGO_PROFILE_RELEASE_OPT_LEVEL: s\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: thumbv8m.main-none-eabihf\n - name: Check\n working-directory: examples/mcu-embassy\n run: cargo check --bin ui_mcu --target=thumbv8m.main-none-eabihf --no-default-features --features=\"mcu-embassy/mcu\" --release\n\n# mcu_esp:\n# env:\n# RUSTFLAGS: -D warnings\n# runs-on: ubuntu-22.04\n# steps:\n# - uses: actions/checkout@v6\n# - uses: dtolnay/rust-toolchain@stable\n# - uses: esp-rs/xtensa-toolchain@v1.6\n# with:\n# default: true\n# buildtargets: esp32\n# ldproxy: false\n# # version pinned until new version of esp-hal with https://github.com/esp-rs/esp-hal/pull/2615/\n# version: 1.82.0\n# - uses: Swatinem/rust-cache@v2\n# - name: S3Box\n# run: cargo +esp check -p printerdemo_mcu --target xtensa-esp32s3-none-elf --no-default-features --features=mcu-board-support/esp32-s3-box --config examples/mcu-board-support/esp32_s3_box/cargo-config.toml --release\n\n ffi_32bit_build:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.api_cpp == 'true'\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: armv7-unknown-linux-gnueabihf\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cross\n - name: Check\n run: cross check --target=armv7-unknown-linux-gnueabihf -p slint-cpp --no-default-features --features=testing,interpreter,std\n\n docs:\n needs: files-changed\n if: needs.files-changed.outputs.slint == 'true'\n uses: ./.github/workflows/build_docs.yaml\n secrets:\n READ_WRITE_PRIVATE_KEY: ${{ secrets.READ_WRITE_PRIVATE_KEY }}\n with:\n release: false\n app-id: ${{ vars.READ_WRITE_APP_ID }}\n\n slintpad:\n needs: files-changed\n if: needs.files-changed.outputs.slintpad == 'true'\n uses: ./.github/workflows/wasm_editor_and_interpreter.yaml\n\n wasm_demo:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.examples == 'true' || needs.files-changed.outputs.api_rs == 'true'\n uses: ./.github/workflows/wasm_demos.yaml\n with:\n build_artifacts: false\n\n tree-sitter:\n needs: files-changed\n if: needs.files-changed.outputs.slint == 'true'\n uses: ./.github/workflows/tree_sitter.yaml\n with:\n latest: false\n tag: \"v0.26.5\"\n\n # Checkout a old version of the tests and example, then run the slint-updater on them\n # and check that it worked with the interpreter test.\n updater_test:\n needs: files-changed\n if: needs.files-changed.outputs.updater_test == 'true'\n env:\n SLINT_NO_QT: 1\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: 1\n CARGO_PROFILE_DEV_DEBUG: 0\n strategy:\n matrix:\n from_version: [\"0.3.0\"]\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n with:\n fetch-depth: 0\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/setup-rust\n - name: Checkout old version\n run: |\n git checkout v${{ matrix.from_version }} --no-overlay -- examples\n git checkout v${{ matrix.from_version }} --no-overlay -- tests/cases\n git checkout v${{ matrix.from_version }} --no-overlay -- tests/helper_components\n # Remove examples and demos from the workspace because they may no longer exist or their Cargo.toml might prevent the build of the updater\n sed -i \"/examples/d\" Cargo.toml\n sed -i \"/demos/d\" Cargo.toml\n - name: \"Commit old checkout\"\n run: |\n git config --global user.email \"${GITHUB_ACTOR}@users.noreply.github.com\"\n git config --global user.name \"${GITHUB_ACTOR}\"\n git commit -a -m \"REVERT TESTS TO v${{ matrix.from_version }}\"\n - name: run the updater\n run: |\n cargo run -p slint-updater -- -i examples/*/*.slint\n cargo run -p slint-updater -- -i examples/*/*/*.slint\n cargo run -p slint-updater -- -i tests/cases/*.slint\n cargo run -p slint-updater -- -i tests/cases/*/*.slint\n - name: Show the diff\n run: git diff\n - name: test\n # Skip a few tests that rely on private renamed properties.\n # Skip the tests which makes two way binding to output property (these are warning in previous version)\n # Skip the test that use impure functions in property bindings (this is also warning in previous version)\n # Skip the example that did not exist or that are broken\n # Skip the path layout related tests as the element has been removed\n # Skip the booker as it use api from the LineEdit that wasn\"t meant to be used\n run: |\n cargo test -p test-driver-interpreter -- \\\n --skip test_interpreter_text_cursor_move \\\n --skip test_interpreter_text_cursor_move_grapheme \\\n --skip test_interpreter_text_cut \\\n --skip test_interpreter_text_select_all \\\n --skip test_interpreter_text_surrogate_cursor \\\n --skip test_interpreter_text_text_change \\\n --skip test_interpreter_crashes_layout_deleted_item \\\n --skip test_interpreter_focus_focus_change_subcompo \\\n --skip test_interpreter_focus_focus_change_through_signal \\\n --skip test_interpreter_globals_alias_to_global \\\n --skip test_interpreter_text_default_color \\\n --skip test_interpreter_crashes_issue1271_set_in_if \\\n --skip test_interpreter_models_assign_equal_model \\\n --skip example_carousel \\\n --skip example_fancy_demo \\\n --skip example_dial \\\n --skip example_fancy_switches \\\n --skip example_sprite_sheet \\\n --skip example_grid_model_rows \\\n --skip example_grid_with_repeated_rows \\\n --skip example_vector_as_grid \\\n --skip example_vlayout \\\n --skip example_flexbox_interactive \\\n --skip test_interpreter_elements_path_fit \\\n --skip test_interpreter_layout_path \\\n --skip test_interpreter_7guis_booker \\\n\n # Test that the formater don't introduce slint compilation error\n fmt_test:\n needs: files-changed\n if: needs.files-changed.outputs.slintpad == 'true' || needs.files-changed.outputs.tests == 'true'\n env:\n SLINT_NO_QT: 1\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: 1\n CARGO_PROFILE_DEV_DEBUG: 0\n RUSTFLAGS: -D warnings\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/setup-rust\n - name: run the formatter\n run: |\n cargo run -p slint-lsp --no-default-features -- format -i tests/cases/**/*.slint\n cargo run -p slint-lsp --no-default-features -- format -i examples/**/*.slint\n - name: Show the diff\n run: git diff\n - name: Run the intepreter test to make sure that the test are passing after format\n run: cargo test -p test-driver-interpreter\n - name: \"Commit changes\"\n run: |\n git config --global user.email \"${GITHUB_ACTOR}@users.noreply.github.com\"\n git config --global user.name \"${GITHUB_ACTOR}\"\n git commit -a -m \"Run slint-lsp format\"\n - name: Do another pass to check that it is idempotent\n run: |\n cargo run -p slint-lsp --no-default-features -- format -i tests/cases/**/*.slint\n cargo run -p slint-lsp --no-default-features -- format -i examples/**/*.slint\n git diff --exit-code\n\n esp-idf-quick:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.api_cpp == 'true' || needs.files-changed.outputs.examples == 'true'\n runs-on: ubuntu-22.04\n container: espressif/idf:release-v5.2\n steps:\n - name: Fix up pydantic regression (https://github.com/espressif/idf-component-manager/issues/97#issuecomment-3380777944)\n run: |\n . ${IDF_PATH}/export.sh\n cd $IDF_PYTHON_ENV_PATH\n bin/pip install pydantic==2.11.10\n - uses: actions/checkout@v6\n - run: apt-get update && apt-get install -y libfontconfig1-dev\n - uses: dtolnay/rust-toolchain@stable\n - uses: esp-rs/xtensa-toolchain@v1.6\n with:\n default: true\n buildtargets: esp32\n ldproxy: false\n - uses: Swatinem/rust-cache@v2\n - name: Build and Test Printer demo\n shell: bash\n working-directory: demos/printerdemo_mcu/esp-idf\n run: |\n . ${IDF_PATH}/export.sh\n idf.py build\n\n android:\n needs: files-changed\n if: needs.files-changed.outputs.internal == 'true' || needs.files-changed.outputs.api_rs == 'true' || needs.files-changed.outputs.examples == 'true'\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - name: Install Android API level 30\n run: ${ANDROID_HOME}/cmdline-tools/latest/bin/sdkmanager --install \"platforms;android-30\"\n - name: Cache cargo-apk\n id: cargo-apk-cache\n uses: actions/cache@v5\n with:\n path: ~/.cargo/bin/cargo-apk\n key: cargo-apk-cache\n # Only build cargo-apk if not cached\n - uses: dtolnay/rust-toolchain@stable\n if: steps.cargo-apk-cache.outputs.cache-hit != 'true'\n - name: Install cargo-apk\n if: steps.cargo-apk-cache.outputs.cache-hit != 'true'\n run: cargo install cargo-apk\n\n - uses: ./.github/actions/setup-rust\n with:\n target: aarch64-linux-android\n\n - name: Build todo demo\n run: cargo apk build -p todo --target aarch64-linux-android --lib\n\n - name: Build energy-monitor example\n run: cargo apk build -p energy-monitor --target aarch64-linux-android --lib\n\n - name: Build printerdemo example\n run: cargo apk build -p printerdemo --target aarch64-linux-android --lib\n\n - name: Build usecases demo\n run: cargo apk build -p usecases --target aarch64-linux-android --lib\n\n test-figma-inspector:\n needs: files-changed\n if: needs.files-changed.outputs.figma_inspector == 'true'\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n id: node-install\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - name: Run pnpm install\n working-directory: tools/figma-inspector\n run: pnpm install --frozen-lockfile\n - name: Run build\n working-directory: tools/figma-inspector\n run: pnpm build\n - name: Run tests\n working-directory: tools/figma-inspector\n run: pnpm test\n - name: Type Check\n working-directory: tools/figma-inspector\n run: pnpm type-check\n - name: Build zip\n working-directory: tools/figma-inspector\n run: pnpm zip\n - name: Archive zip\n uses: actions/upload-artifact@v7\n with:\n name: figma-plugin\n path: tools/figma-inspector/zip\n\n material-components:\n needs: files-changed\n if: needs.files-changed.outputs.material_components == 'true'\n permissions:\n contents: read\n deployments: write\n uses: ./.github/workflows/material.yaml\n secrets:\n CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n CLOUDFLARE_API_TOKEN_2: ${{ secrets.CLOUDFLARE_API_TOKEN_2 }}\n CLOUDFLARE_ACCOUNT_ID_2: ${{ secrets.CLOUDFLARE_ACCOUNT_ID_2 }}\n ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}\n ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}\n\n servo_example:\n needs: files-changed\n if: needs.files-changed.outputs.servo_example == 'true'\n uses: ./.github/workflows/servo_example.yaml\n\n bevy_examples:\n needs: files-changed\n if: needs.files-changed.outputs.bevy_examples == 'true'\n uses: ./.github/workflows/bevy_examples.yaml\n\n clippy:\n needs: files-changed\n if: needs.files-changed.outputs.rust_files == 'true'\n env:\n RUSTFLAGS: -D warnings\n CARGO_INCREMENTAL: false\n CARGO_PROFILE_DEV_DEBUG: 0\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - name: Install ffmpeg and alsa (Linux)\n run: sudo apt-get install clang libavcodec-dev libavformat-dev libavutil-dev libavfilter-dev libavdevice-dev libasound2-dev pkg-config\n - name: Install gstreamer and libunwind (Linux)\n run: sudo apt-get install libunwind-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good\n - uses: ./.github/actions/setup-rust\n - name: Run Clippy\n run: ./scripts/run_clippy.sh\n" }, { "path": ".github/workflows/cpp_package.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Build the C++ binary package\n\non:\n workflow_dispatch:\n workflow_call:\n inputs:\n extra_cmake_flags:\n type: string\n description: Extra CMake flags to pass to the build.\n default: \"\"\n\nenv:\n MACOSX_DEPLOYMENT_TARGET: \"11.0\"\n # Keep in sync with features in nightly_snapshot.yaml, slint_tool_binary.yaml, api/node/Cargo.toml, and api/python/slint/Cargo.toml\n SLINT_BINARY_FEATURES: \"-DSLINT_FEATURE_BACKEND_LINUXKMS_NOSEAT=ON -DSLINT_FEATURE_BACKEND_WINIT=ON -DSLINT_FEATURE_RENDERER_FEMTOVG=ON -DSLINT_FEATURE_RENDERER_SKIA=ON -DSLINT_FEATURE_RENDERER_SOFTWARE=ON -DSLINT_FEATURE_LIVE_PREVIEW=ON\"\n SLINT_MCU_FEATURES: \"-DSLINT_FEATURE_FREESTANDING=ON -DSLINT_FEATURE_RENDERER_SOFTWARE=ON\"\n # env variable used by espup https://github.com/esp-rs/espup?tab=readme-ov-file#github-api\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\njobs:\n cmake_package_desktop:\n env:\n DYLD_FRAMEWORK_PATH: /Users/runner/work/slint/Qt/6.2.2/clang_64/lib\n QT_QPA_PLATFORM: offscreen\n CARGO_INCREMENTAL: false\n strategy:\n matrix:\n os: [ubuntu-22.04, macos-14, windows-2022]\n include:\n - os: ubuntu-22.04\n package_suffix: linux\n - os: macos-14\n package_suffix: macos-aarch64\n - os: windows-2022\n package_suffix: windows-x86_64\n msvc_arch: x64\n - os: windows-11-arm\n package_suffix: windows-aarch64\n msvc_arch: arm64\n\n runs-on: ${{ matrix.os }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n old-ubuntu: true\n - name: Install Qt (Ubuntu)\n uses: jurplel/install-qt-action@v4\n if: matrix.os == 'ubuntu-22.04'\n with:\n version: 6.2.2\n cache: true\n - uses: ./.github/actions/setup-rust\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Prepare licenses\n run: bash -x ../../scripts/prepare_binary_package.sh ${{ runner.workspace }}/cppbuild\n working-directory: api/cpp/\n - uses: ilammy/msvc-dev-cmd@v1\n with:\n arch: ${{ matrix.msvc_arch }}\n if: runner.os == 'Windows'\n - name: Select MSVC (windows)\n run: |\n echo \"CC=cl.exe\" >> $GITHUB_ENV\n echo \"CXX=cl.exe\" >> $GITHUB_ENV\n if: runner.os == 'Windows'\n - name: C++ Build\n uses: lukka/run-cmake@v3.4\n with:\n cmakeListsOrSettingsJson: CMakeListsTxtAdvanced\n cmakeListsTxtPath: CMakeLists.txt\n cmakeAppendedArgs: \"-DCMAKE_BUILD_TYPE=RelWithDebInfo ${{ env.SLINT_BINARY_FEATURES }} ${{ inputs.extra_cmake_flags }} -DSLINT_FEATURE_SDF_FONTS=ON\"\n buildDirectory: ${{ runner.workspace }}/cppbuild\n buildWithCMakeArgs: \"--config Release\"\n - name: cpack\n working-directory: ${{ runner.workspace }}/cppbuild\n run: cmake --build . --config Release --target package\n - name: \"Upload C++ packages\"\n uses: actions/upload-artifact@v7\n with:\n name: cpp_bin-${{ matrix.package_suffix }}\n path: ${{ runner.workspace }}/cppbuild/Slint-cpp-*\n\n cmake_package_mcu_arm:\n env:\n CARGO_INCREMENTAL: false\n strategy:\n matrix:\n target: [thumbv7em-none-eabihf]\n\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n old-ubuntu: true\n - uses: ./.github/actions/setup-rust\n with:\n target: ${{ matrix.target }}\n - name: Install GNU Arm Embedded Toolchain\n run: sudo apt-get update && sudo apt-get install gcc-arm-none-eabi\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Prepare licenses\n run: bash -x ../../scripts/prepare_binary_package.sh ${{ runner.workspace }}/cppbuild\n working-directory: api/cpp/\n - name: C++ Build\n uses: lukka/run-cmake@v3.4\n with:\n cmakeListsOrSettingsJson: CMakeListsTxtAdvanced\n cmakeListsTxtPath: CMakeLists.txt\n cmakeAppendedArgs: \"-GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_SHARED_LIBS=OFF -DRust_CARGO_TARGET=${{ matrix.target }} -DCMAKE_C_COMPILER=arm-none-eabi-gcc -DCMAKE_CXX_COMPILER=arm-none-eabi-g++ -DCMAKE_AR=arm-none-eabi-ar -DCMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY -DSLINT_COMPILER=download ${{ env.SLINT_MCU_FEATURES }} ${{ inputs.extra_cmake_flags }}\"\n buildDirectory: ${{ runner.workspace }}/cppbuild\n buildWithCMakeArgs: \"--config Release\"\n - name: cpack\n working-directory: ${{ runner.workspace }}/cppbuild\n run: cpack -G TGZ\n - name: \"Upload C++ packages\"\n uses: actions/upload-artifact@v7\n with:\n name: cpp_mcu_bin-${{ matrix.target }}\n path: ${{ runner.workspace }}/cppbuild/Slint-cpp-*\n\n cmake_package_mcu_esp:\n env:\n CARGO_INCREMENTAL: false\n strategy:\n matrix:\n idf_target: [esp32, esp32s2, esp32s3, esp32p4]\n include:\n - idf_target: esp32\n rust_target: xtensa-esp32-none-elf\n - idf_target: esp32s2\n rust_target: xtensa-esp32s2-none-elf\n - idf_target: esp32s3\n rust_target: xtensa-esp32s3-none-elf\n - idf_target: esp32p4\n rust_target: riscv32imafc-esp-espidf\n\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n old-ubuntu: true\n - uses: dtolnay/rust-toolchain@stable\n - uses: cargo-bins/cargo-binstall@main\n - name: install espup\n run: |\n cargo binstall espup\n espup install\n rustup default esp\n - name: add esp toolchains to PATH\n if: runner.os != 'Windows'\n run: |\n source \"$HOME/export-esp.sh\"\n echo \"$PATH\" >> \"$GITHUB_PATH\"\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Prepare licenses\n run: bash -x ../../scripts/prepare_binary_package.sh ${{ runner.workspace }}/cppbuild\n working-directory: api/cpp/\n - name: C++ Build\n uses: lukka/run-cmake@v3.4\n with:\n cmakeListsOrSettingsJson: CMakeListsTxtAdvanced\n cmakeListsTxtPath: CMakeLists.txt\n # NOTE: xtensa-esp-elf-gcc as compiler for the RISC-V targets is wrong, but the compiler argument here is only\n # used to ensure that SIZEOF_VOID_P is 4 in the generated cmake config file. Otherwise this build requires no\n # C compiler.\n cmakeAppendedArgs: \"-GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF -DESP_PLATFORM=1 -DIDF_TARGET=${{ matrix.idf_target }} -DRust_CARGO_TARGET=${{ matrix.rust_target }} -DCMAKE_C_COMPILER=xtensa-esp-elf-gcc -DCMAKE_AR=xtensa-esp-elf-ar -DCMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY -DSLINT_LIBRARY_CARGO_FLAGS='-Zbuild-std=core,alloc' -DSLINT_COMPILER=download ${{ env.SLINT_MCU_FEATURES }} ${{ inputs.extra_cmake_flags }}\"\n buildDirectory: ${{ runner.workspace }}/cppbuild\n buildWithCMakeArgs: \"--config Release\"\n - name: cpack\n working-directory: ${{ runner.workspace }}/cppbuild\n run: cpack -G TGZ\n - name: \"Upload C++ packages\"\n uses: actions/upload-artifact@v7\n with:\n name: cpp_mcu_bin-${{ matrix.idf_target }}\n path: ${{ runner.workspace }}/cppbuild/Slint-cpp-*\n\n cmake_package_arm_linux:\n env:\n CARGO_INCREMENTAL: false\n strategy:\n matrix:\n gcc_target: [aarch64-linux-gnu, arm-linux-gnueabihf]\n include:\n - gcc_target: aarch64-linux-gnu\n rust_target: aarch64-unknown-linux-gnu\n cmake_system_processor: arm64\n - gcc_target: arm-linux-gnueabihf\n rust_target: armv7-unknown-linux-gnueabihf\n cmake_system_processor: armhf\n\n runs-on: ubuntu-22.04\n container: ghcr.io/slint-ui/slint/${{ matrix.rust_target }}-cpp\n steps:\n - uses: actions/checkout@v6\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Prepare licenses\n run: bash -x ../../scripts/prepare_binary_package.sh ../../build\n working-directory: api/cpp/\n - name: CMake configure\n run: cmake -B build -S . -GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_SYSTEM_NAME=Linux -DCMAKE_SYSTEM_PROCESSOR=${{ matrix.cmake_system_processor }} -DRust_CARGO_TARGET=${{ matrix.rust_target}} -DCMAKE_C_COMPILER=${{ matrix.gcc_target }}-gcc -DCMAKE_CXX_COMPILER=${{ matrix.gcc_target }}-g++ -DSLINT_COMPILER=download ${{ env.SLINT_BINARY_FEATURES }} ${{ inputs.extra_cmake_flags }}\n - name: CMake build\n run: cmake --build build --parallel\n - name: CMake package\n working-directory: build\n run: cpack -G TGZ\n - name: \"Upload C++ packages\"\n uses: actions/upload-artifact@v7\n with:\n name: cpp_bin-${{ matrix.rust_target }}\n path: build/Slint-cpp-*\n\n cmake_slint_compiler:\n env:\n CARGO_INCREMENTAL: false\n strategy:\n matrix:\n os: [ubuntu-22.04, macos-14, windows-2022]\n include:\n - os: ubuntu-22.04\n package_suffix: Linux-x86_64\n cargo_target: x86_64-unknown-linux-gnu\n - os: ubuntu-22.04-arm\n package_suffix: Linux-aarch64\n cargo_target: aarch64-unknown-linux-gnu\n - os: macos-14\n package_suffix: Darwin-arm64\n cargo_target: aarch64-apple-darwin\n - os: windows-2022\n package_suffix: Windows-AMD64\n msvc_arch: x64\n cargo_target: x86_64-pc-windows-msvc\n - os: windows-11-arm\n package_suffix: Windows-ARM64\n msvc_arch: arm64\n cargo_target: aarch64-pc-windows-msvc\n\n runs-on: ${{ matrix.os }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n old-ubuntu: true\n - uses: ./.github/actions/setup-rust\n - uses: ilammy/msvc-dev-cmd@v1\n with:\n arch: ${{ matrix.msvc_arch }}\n if: runner.os == 'Windows'\n - name: Select MSVC (windows)\n run: |\n echo \"CC=cl.exe\" >> $GITHUB_ENV\n echo \"CXX=cl.exe\" >> $GITHUB_ENV\n if: runner.os == 'Windows'\n # Build Slint-compiler with CMake so that CMakeLists.txt can configure C++ specific features\n - name: Slint Compiler Build\n uses: lukka/run-cmake@v3.4\n with:\n cmakeListsOrSettingsJson: CMakeListsTxtAdvanced\n cmakeListsTxtPath: CMakeLists.txt\n cmakeAppendedArgs: \"-GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DSLINT_BUILD_RUNTIME=OFF ${{ inputs.extra_cmake_flags }} -DSLINT_FEATURE_SDF_FONTS=ON -DRust_CARGO_TARGET=${{ matrix.cargo_target }}\"\n buildDirectory: ${{ runner.workspace }}/cppbuild\n buildWithCMakeArgs: \"--config Release\"\n - name: cpack\n working-directory: ${{ runner.workspace }}/cppbuild\n run: cpack -G TGZ\n - name: Extract Slint Compiler binary\n working-directory: ${{ runner.workspace }}/cppbuild\n shell: bash\n run: cmake -E tar xvf Slint-cpp-*.tar.gz\n - name: Repackage\n working-directory: ${{ runner.workspace }}/cppbuild\n shell: bash\n run: |\n cd Slint-cpp-*/bin\n cmake -E tar czf ../../slint-compiler-${{ matrix.package_suffix }}.tar.gz slint-compiler*\n - name: \"Upload Slint compiler package\"\n uses: actions/upload-artifact@v7\n with:\n name: slint-compiler-bin-${{ matrix.package_suffix }}\n path: ${{ runner.workspace }}/cppbuild/slint-compiler-*.tar.gz\n" }, { "path": ".github/workflows/crater.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# This workflow checks out and build a bunch of crates that uses Slint,\n# with the current branch\n\nname: Crater\n\non:\n workflow_dispatch:\n\njobs:\n crater:\n env:\n SLINT_NO_QT: 1\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: 1\n strategy:\n fail-fast: false\n matrix:\n git_url:\n # from madewithslint\n - \"https://github.com/slint-ui/cargo-ui\"\n - \"https://github.com/GaspardCulis/slint-tetris\"\n #- \"https://github.com/dngulin/gpcl\" # depends on the winit backend\n - \"https://codeberg.org/flovansl/co_sl\"\n - \"https://seed.radicle.garden/z3oxAZSLcyXgpa7fcvgtueF49jHpH.git\" #vivi\n #- \"https://github.com/ElevenJune/mastermind_Rust\" # Not upgraded to Slint 1.0\n #- \"https://github.com/Project-Trains/launcher\" # Not upgraded to Slint 1.0\n - \"https://github.com/bjorn/raccoin\"\n - \"https://gitlab.com/floers/ordinary\" # Has `zip=\"*\"` in its Cargo.toml\n - \"https://github.com/parchlinux/parch-welcome/\"\n #- \"https://github.com/boclair/fractal-explorer\" # RE-ENABLE WHEN https://github.com/arturoc/color-rs/pull/2 is released\n - \"https://github.com/arunpkio/tymoz\"\n - \"https://github.com/Surrealism-All/surrealism-ui-template\"\n - https://github.com/raykavin/market-prices-rust\n - https://github.com/pezfisk/OxideManager\n - https://github.com/m4rz3r0/foruster\n\n # from crates.io\n - \"https://codeberg.org/drendog/frametrix\"\n - \"https://github.com/hzqd/mycalc\"\n - \"https://github.com/zilongyang/rust_slint_todos\"\n - \"https://github.com/gavinshox/chess-oxide\"\n - \"https://github.com/Obscurely/falion\"\n #- \"https://github.com/abhay-n-j/warp-gui-app\" (wrong edition in Cargo.toml)\n - \"https://github.com/dimas-fw/dimas\"\n - \"https://github.com/vova-max-png/slintcalc\"\n - \"https://github.com/moistpyro/land-calc\"\n - \"https://github.com/clay-6/baze64\"\n - \"https://github.com/Siiir/k_means-interactive/\"\n - \"https://codeberg.org/waydeer/layer-shika\"\n - \"https://github.com/limitcool/xm\"\n #- \"https://github.com/vexide/vexide-slint\" # vexide somehow enable the error_in_core feature of snafu\n - \"https://github.com/ChenhuiZhang/envsensor-demo\"\n - \"https://github.com/arunkumar-mourougappane/gjallarhorn-rs\"\n - \"https://github.com/3axap4ehko/litra\"\n - \"https://github.com/rezabani/modern-minesweeper\"\n - \"https://github.com/guimath/phog\"\n - \"https://github.com/mcbridejc/slint-evdev-input\"\n - \"https://github.com/heathcliff26/turbo-clicker\"\n\n\n - \"https://github.com/Decodetalkers/launchre\"\n - \"https://github.com/Decodetalkers/haruhishot\"\n - \"https://github.com/smalltext/trace-slint/\"\n # - \"https://github.com/danrauch/thermocam\" # error: failed to run custom build command for `v4l2-sys-mit v0.2.0`\n - \"https://github.com/saturn77/magnet\"\n\n # - \"https://github.com/zzq0097/mmm_rs\" # could not compile `netease-cloud-music-api` (lib)\n - \"https://github.com/CMahaff/lasim\" # many stars\n #- \"https://github.com/spades9/image-tools\" # compile error\n - \"https://github.com/studylessshape/calculator-by-rs\"\n - \"https://github.com/gleb-skobinsky/system-metrics\"\n - \"https://github.com/AccAutomaton/ECJTU-CAN-Helper\"\n - \"https://github.com/Vadoola/pv-unlocker\"\n #- \"https://github.com/zzoe/liando\" # compile error in zstd-safe https://github.com/gyscos/zstd-rs/issues/270\n - \"https://github.com/Knowit-Objectnet/infoskjerm-trondheim\"\n - \"https://github.com/CaleGlisson/Zelda_pattern_rust\"\n - \"https://codeberg.org/dweiss96/rf2_league_mod_tool\"\n - \"https://github.com/Badless/slint-editor\"\n - \"https://github.com/IvanB101/hamming-huffman\"\n - \"https://github.com/izuku0550/Custom-Note-Builder\"\n - \"https://github.com/mrquantumoff/quadrant_lite\"\n\n - \"https://github.com/jpnurmi/jpos-weather\"\n #- \"https://github.com/osp-project/RizPackageTools\" 404\n - \"https://github.com/xenein/CountMeDown-rs\"\n - \"https://github.com/JeremiasMeister/rust-heightmap-generator\"\n - \"https://github.com/joaofl/any-serve\"\n - \"https://github.com/Heng30/rssbox\"\n - \"https://github.com/Heng30/rssbox-android\"\n - \"https://github.com/Heng30/uibox\"\n #- \"https://github.com/Heng30/bitbox\" #pinned slint-build version\n #- \"https://github.com/Heng30/solana-wallet-sollet\" # error in dependency (pyth-sdk-solana)\n - \"https://github.com/nzhenev/vtbox\"\n #- \"https://github.com/hambooooo/hamboo-rs\" #uses nightly rust\n # - \"https://github.com/hambooooo/hamboo-embassy\" #uses nightly rust\n #- \"https://github.com/Kllngii/Wetterstation\" # can't check submodules\n - \"https://github.com/tredeneo/simple-inventary-management\" #uses sqlx that needs database access\n # - \"https://github.com/xcodes2cn/Xviewer\" #copies slint\n - \"https://github.com/olishmollie/radix\"\n - \"https://github.com/zivit/watchlist\"\n - \"https://github.com/FelgoSDK/RustyWeather\"\n - \"https://github.com/ThilinaTLM/docker_ui\"\n - \"https://github.com/PlanetTeamSpeakk/Thermostat\"\n - \"https://github.com/develcooking/Reelix\"\n - \"https://github.com/Albino-Client/AlbinoLauncher\"\n - \"https://github.com/radev1924/profit-first-income-calculator-desktop\"\n - \"https://github.com/JarrodDoyle/slint-fmeditor\"\n - \"https://github.com/planet0104/slint-noframe-window\"\n #- \"https://github.com/Dusk-Labs/kira\" uses private API\n # - \"https://github.com/TuEmb/can-viewer\" # depends on a deleted repo\n # - \"https://github.com/qhua948/anubis\" # uses nightly rust\n - \"https://github.com/Surrealism-All/slimk\"\n - \"https://github.com/BounceU/car_thang\"\n - \"https://github.com/sloganking/codevis-gui\"\n - \"https://github.com/CzNorbi/tic_tac_toe_ui\"\n - \"https://github.com/remy2019/smtbr_gui\"\n - \"https://github.com/mrandal/PDFer\"\n - \"https://github.com/dhasoft-rs/7Seg-Slint-Widget\"\n # - \"https://github.com/DraKraft/ozon-rs\" # Error: the trait `ToSql` is not implemented for `usize`\n # - \"https://github.com/SUP2Ak/Lur-Slint\" # repo gone?\n # - \"https://github.com/foxboxpdx/melonstt\" # repo gone?\n - \"https://github.com/sanyexieai/me_chat\"\n #- \"https://github.com/oreo3494/rockpaper.git\" # error because of `rand`\n - \"https://github.com/padangpanda/password-generator-desktop\"\n - \"https://github.com/RealAdarsh/slint-guess-game\"\n - \"https://github.com/DASPRiD/vrc-osc-manager\"\n - \"https://github.com/beac0n/ruroco\"\n\n - \"https://github.com/SergioRibera/Simplemoji\"\n - \"https://github.com/Ashintosh/NoPass\"\n # - \"https://github.com/Gremious/stickerbox\" depends on unstable-wgpu-24\n - \"https://github.com/aenriii/rimgv\"\n - \"https://github.com/Brayan-724/amosd\"\n - \"https://github.com/kevinquillen/sysinfo\"\n - \"https://github.com/home-cooked-firmware/hcui\"\n - \"https://github.com/EinsPhoenix/MineSweeper-Rust\"\n - \"https://github.com/themkoi/Cosmic-Wanderer\"\n - \"https://github.com/xcrong/slint_data_processer\"\n - \"https://github.com/Newlifer/peditor\"\n - \"https://github.com/spineda2019/tRust\"\n - \"https://github.com/franckKyete/tools-desktop\"\n - \"https://github.com/zys60233/secret-box\"\n - \"https://github.com/xjy12345654/css_parser\"\n - \"https://github.com/zuyzz/app_flock\"\n #- \"https://github.com/interstellarfrog/OG3-Pack-Updater\" #zip2.6 is yanked\n - \"https://github.com/balicz3k/FileGuard\"\n - \"https://github.com/ravioni-encoder/ravioni\"\n - \"https://github.com/konmenel/tzimpouki\"\n - \"https://github.com/TAlgorhythmic/dystellar-launcher-rs\"\n - \"https://github.com/trappitsch/calculon\"\n - \"https://github.com/Jaysmito101/slint-nav\"\n - \"https://github.com/mq1/TinyWiiBackupManager\"\n - \"https://github.com/jacquetc/qleany\"\n - https://github.com/taichi765/Tsukuyomi\n - https://github.com/Cheikh-Nakamoto/Generateur-d-architecture-\n - https://github.com/Spencer-0003/aletheia\n - https://github.com/engels74/EasyHDR\n - https://github.com/reedrosenbluth/oscen\n - https://github.com/futo-org/fcast\n - https://github.com/BiliRumble/Cloubit\n\n # Missing images\n # - \"https://github.com/rurishigeo/Probe-Downloader\"\n # - \"https://github.com/Tricked-dev/stardew-mod-manager\"\n # - \"https://github.com/Erik7354/slint_minesweeper\"\n # - \"https://github.com/guimath/GeoQuiz\"\n\n\n # Use our private API (eg: backend winit)\n # - \"https://github.com/Davide255/LVIE\"\n # - \"https://github.com/Vadoola/Tomotroid\"\n # - \"https://github.com/Horbin-Magician/rotor-rs\"\n # - \"https://github.com/ilmai/plugin-things\"\n # - \"https://github.com/Hoverth/keyboardthing\"\n\n\n # - \"https://codeberg.org/moire/moire\" # Broken because of other dependencies.\n\n # Needs extra dependencies\n # - \"https://github.com/nununoisy/gb-presenter-rs\"\n # - \"https://github.com/nununoisy/nsf-presenter-rs\"\n # - \"https://github.com/bombless/slint-tree\"\n # \"https://github.com/AaronGulman/Rusty-CryptoMonitor\" (lua54)\n\n #- \"https://github.com/link9c/media_backup\" #(windows only (failed to resolve: use of undeclared crate or module `winres`))\n #- \"https://github.com/Vadoola/ignition_npp_tools\" #windows only\n #- \"https://github.com/zloisupport/vanctrl\" #windows only\n #- \"https://github.com/GRX005/McModManager-rs\"\n #- \"https://github.com/un4ckn0wl3z/title-randomizer-rs\"\n\n\n # Not updated to Slint 1.0\n #- \"https://github.com/jannes/han-cihui\"\n #- \"https://github.com/leofidus/ntfs-explorer\"\n #- \"https://github.com/gsuyemoto/rust-bombfield\"\n #- \"https://github.com/kizeevov/l5\"\n #- \"https://github.com/SergioGasquez/espup-slint\"\n\n sub_path: [\".\"]\n os: [\"ubuntu-24.04\"]\n\n include:\n - git_url: \"https://github.com/jturcotte/chiptrack\"\n sub_path: \".\"\n extra_packages: libasound2-dev libfreetype-dev libfontconfig-dev\n - git_url: \"https://github.com/Futsch1/image-sieve\"\n sub_path: \".\"\n extra_packages: libgtk-3-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev llvm libheif-dev\n - git_url: \"https://github.com/griccardos/rusl\"\n sub_path: \"slint\"\n #- git_url: \"https://github.com/DanielMadmon/tasker\" # needs \"themis dep\"\n # sub_path: \"bin/tasker_gui\"\n # - git_url: \"https://github.com/Kllngii/Wetterstation\" # can't check submodules\n # sub_path: \"wetterstation-ui\"\n - git_url: \"https://github.com/plule/theremotion\"\n sub_path: \"theremotion-ui\"\n - git_url: \"https://github.com/matthiasbeyer/deskodon\"\n sub_path: \"frontend\"\n - git_url: \"https://github.com/malwaredb/malwaredb-rs\"\n extra_args: \"--features=admin,admin-gui\"\n sub_path: \".\"\n #- git_url: \"https://github.com/Martoni/QRNote\" # Pins slint version\n # sub_path: \"qr-note\"\n #- git_url: \"https://github.com/planet0104/satellite_wallpaper\"\n # sub_path: \".\"\n # os: windows-latest\n #- git_url: \"https://github.com/colelawrence/here-now\" # Compile error\n # sub_path: \"hn-desktop-ui\"\n - git_url: \"https://github.com/MunyaradziMagura/Pomodoro\"\n sub_path: \"pomodoro\"\n - git_url: \"https://github.com/flukejones/asusctl\"\n sub_path: \"rog-control-center\"\n #- git_url: \"https://github.com/ellenhp/openlmr\" #doesn't compile\n # sub_path: \"openlmr-core\"\n #- git_url: \"https://github.com/jenkinsmichpa/coconut_crab\"\n # sub_path: \"coconut_crab_client\"\n # os: windows-latest\n - git_url: \"https://github.com/ivabus/lonelyradio\"\n sub_path: \"monoclient-s\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n - git_url: \"https://github.com/ahqsoftwares/tauri-ahq-store\"\n sub_path: \"src-setup\"\n - git_url: \"https://github.com/qarmin/czkawka\"\n sub_path: krokiet\n - git_url: \"https://github.com/Vjze/Rust_demo\" # this is using SurrealismUI\n sub_path: Rust_Slint\n #- git_url: \"https://github.com/LeeeSe/MessAuto\"\n # os: macos-latest\n # sub_path: \".\"\n - git_url: \"https://github.com/planet0104/USB-Screen/\"\n extra_args: \"--no-default-features --features=editor\"\n sub_path: \".\"\n - git_url: \"https://github.com/newfla/daily-strip\"\n sub_path: \".\"\n extra_args: \"--no-default-features --features=slint_frontend\"\n - git_url: \"https://github.com/niqt/matrust/\"\n sub_path: \".\"\n - git_url: \"https://github.com/obhq/obliteration\"\n sub_path: \"gui\"\n - git_url: \"https://github.com/jaymedavis/romboy\"\n sub_path: \"romboy\"\n #- git_url: \"https://github.com/somantics/retrodungeon\" # compile error\n # sub_path: \".\"\n # extra_args: \"--features=femtovg\"\n #- git_url: \"https://github.com/jonfast565/runinator\" # compile error (Used `MainWindow instead of `App` in rust)\n # sub_path: \"command-center\"\n # - git_url: \"https://github.com/stars-labs/mpc-wallet\" # uses properties that don't exist (AI hallucinations?)\n # sub_path: \"apps/native-node\"\n - git_url: \"https://github.com/larus-breeze/sw_frontend_rs\"\n sub_path: \"device/sim\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n # - git_url: \"https://github.com/gramistella/cornerstone\" # depends indirectly on old versions of crates (deno_ast/swc) that do not compile\n # sub_path: \"frontend_slint\"\n - git_url: \"https://github.com/dilo145/password_generator\"\n sub_path: \"password_generator_gui\"\n - git_url: \"https://github.com/DiD92/map-generator\"\n sub_path: \"generator-ui\"\n - git_url: \"https://github.com/Szybet/snake-slint\"\n sub_path: \"snake_bin_std\"\n - git_url: \"https://github.com/Heng30/flymoon\"\n sub_path: \"flymoon\"\n - git_url: \"https://github.com/gopher64/gopher64\"\n sub_path: \".\"\n extra_packages: libpipewire-0.3-dev libwayland-dev libdecor-0-dev liburing-dev cmake ninja-build gnome-desktop-testing libasound2-dev libpulse-dev libaudio-dev libfribidi-dev libsndio-dev libx11-dev libxext-dev libxrandr-dev libxcursor-dev libxfixes-dev libxi-dev libxss-dev libxtst-dev libxkbcommon-dev libdrm-dev libgbm-dev libgl1-mesa-dev libgles2-mesa-dev libegl1-mesa-dev libdbus-1-dev libibus-1.0-dev libudev-dev\n - git_url: \"https://github.com/PonasKovas/salix\"\n sub_path: \"client-gui\"\n - git_url: \"https://github.com/chrishengler/terraingen\"\n sub_path: \"gui-slint\"\n - git_url: \"https://github.com/Vinegret43/dispute\"\n sub_path: \".\"\n extra_packages: libdbus-1-dev alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev\n - git_url: \"https://github.com/Heng30/chatbox\"\n sub_path: \".\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libjack-jackd2-dev\n - git_url: \"https://github.com/Risuleia/Tranquilo\"\n sub_path: \".\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libjack-jackd2-dev\n - git_url: \"https://github.com/R3alCl0ud/Rust4Diva\"\n sub_path: \".\"\n extra_packages: libarchive-dev\n - git_url: \"https://github.com/Enn3Developer/n_music\"\n extra_packages: libasound2-dev libfontconfig-dev libfreetype-dev\n sub_path: \"n_player\"\n - git_url: \"https://github.com/BiliRumble/Cloubit\"\n sub_path: \".\"\n extra_packages: build-essential perl nasm libasound2-dev pkg-config\n - git_url: \"https://github.com/TsaoLun/always-blue\"\n sub_path: \".\"\n extra_packages: libasound2-dev libfreetype-dev libfontconfig-dev\n - git_url: \"https://github.com/jturcotte/beskope\"\n sub_path: \".\"\n extra_packages: libasound2-dev libfreetype-dev libfontconfig-dev libpipewire-0.3-dev\n - git_url: \"https://github.com/sloganking/quick-assistant\"\n sub_path: \".\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n - git_url: \"https://github.com/laycookie/record\"\n sub_path: \".\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n - git_url: \"https://github.com/Danila-Bain/wav-wav\"\n sub_path: \".\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n - git_url: \"https://github.com/mackler/Lodge-Musician\"\n sub_path: \".\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n - git_url: \"https://github.com/game-exchange-token/gxt\"\n sub_path: \"gxt-cli\"\n extra_args: \"--features=ui\"\n - git_url: \"https://github.com/paulusminus/lipl-display\"\n sub_path: \"crates/lipl-display-slint\"\n - git_url: \"https://github.com/vimyoung/spell\"\n sub_path: \"spell-framework\"\n - git_url: \"https://github.com/Farmadupe/vid_dup_finder_lib\"\n sub_path: vid_dup_finder_app\n - git_url: \"https://github.com/simmsb/inkview-rs\"\n sub_path: inkview-slint\n - git_url: \"https://codeberg.org/psylink/psylink\"\n - git_url: \"https://github.com/shuntia/bestest\"\n extra_args: \"--features=gui\"\n - git_url: https://github.com/Konstantin-Dudersky/rsiot\n extra_args: \"--features=cmp_slint\"\n - git_url: https://github.com/Szybet/snake-slint/\n sub_path: \"snake_bin_std\"\n - git_url: https://github.com/maplibre/maplibre-native-slint\n sub_path: rust\n - git_url: https://github.com/AgustinSRG/PersonalMediaVault\n sub_path: launcher-gui\n - git_url: https://github.com/MERCorg/merc\n sub_path: tools/gui\n - git_url: https://github.com/guycorbaz/rbibli\n sub_path: frontend\n - git_url: https://github.com/tadghh/transparent-windows\n extra_args: \"--features=tray-item/ksni\"\n - git_url: \"https://codeberg.org/vivi-ui/lili\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n - git_url: \"https://github.com/bandipapa/rsaber\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n - git_url: \"https://github.com/heng30/wayshot\"\n extra_packages: alsa-utils libasound2-dev libavcodec-dev libavformat-dev libavutil-dev libasound2-dev\n - git_url: https://github.com/heng30/tasklog\n sub_path: tasklog\n extra_args: \"--features=desktop\"\n\n\n\n runs-on: \"ubuntu-latest\"\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n if: runner.os == 'Linux'\n with:\n extra-packages: libpango1.0-dev libgtk-3-dev libatk1.0-dev libjack-jackd2-dev autoconf libxcb-xrm0 libxcb-xrm-dev automake libxcb-keysyms1-dev libxcb-util0-dev libxcb-icccm4-dev libyajl-dev libstartup-notification0-dev libxcb-randr0-dev libev-dev libxcb-cursor-dev libxcb-xinerama0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev libudev-dev clang pkg-config nasm libsoup2.4-dev libfuse3-dev libx11-xcb-dev ${{ matrix.extra_packages }}\n # Don't use the cache because we don't run this job often, and it would cache the .cargo/config.toml with extra keys\n - uses: dtolnay/rust-toolchain@master\n with:\n toolchain: stable\n - name: setup patch\n run: |\n echo \"\" >> ~/.cargo/config.toml\n echo [patch.crates-io] >> ~/.cargo/config.toml\n echo slint = { path = \\\"$GITHUB_WORKSPACE/api/rs/slint\\\" } >> ~/.cargo/config.toml\n echo slint-build = { path = \\\"$GITHUB_WORKSPACE/api/rs/build\\\" } >> ~/.cargo/config.toml\n echo slint-interpreter = { path = \\\"$GITHUB_WORKSPACE/internal/interpreter\\\" } >> ~/.cargo/config.toml\n echo i-slint-backend-winit = { path = \\\"$GITHUB_WORKSPACE/internal/backends/winit\\\" } >> ~/.cargo/config.toml\n echo i-slint-core = { path = \\\"$GITHUB_WORKSPACE/internal/core\\\" } >> ~/.cargo/config.toml\n - name: Checkout the repo\n run: |\n cd $HOME\n git clone ${{ matrix.git_url }} the_repo --depth 1\n cd the_repo\n git submodule update --init --recursive\n - name: build\n run: |\n cd $HOME/the_repo\n rm -r rust-toolchain.toml .cargo/config.toml || true\n cd ./${{ matrix.sub_path }}\n sed -i \"s/{{project-name}}/the-project/\" Cargo.toml\n cargo update\n cargo check ${{ matrix.extra_args }}\n\n\n# Slint only: how can we test them?\n# https://github.com/Surrealism-All/SurrealismUI\n# https://github.com/8yteDance/SlintSubMenu\n\n# C++\n# https://github.com/LeVietXuanKG/TodoApp_Slint\n# https://github.com/NatnaelTaddese/slint_cpp_bilinear_interpolation\n# https://github.com/vudinhkhoa0/DEMO_DOAN_CTDL-GT\n# https://github.com/progzone122/micropad\n" }, { "path": ".github/workflows/embedded_build.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Embedded Build\n\non:\n workflow_dispatch:\n\n schedule:\n - cron: \"0 1 * * *\"\n\njobs:\n build_containers:\n runs-on: ubuntu-22.04\n strategy:\n matrix:\n target:\n - armv7-unknown-linux-gnueabihf\n - aarch64-unknown-linux-gnu\n - riscv64gc-unknown-linux-gnu\n - x86_64-unknown-linux-gnu\n env:\n SLINT_NO_QT: 1\n SLINT_STYLE: fluent\n steps:\n - uses: actions/checkout@v6\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v4\n - name: Login to GitHub Container Registry\n uses: docker/login-action@v4\n with:\n registry: ghcr.io\n username: ${{ github.actor }}\n password: ${{ secrets.CR_PAT }}\n - name: Build and push\n uses: docker/build-push-action@v7\n with:\n context: .\n file: ./docker/Dockerfile.${{ matrix.target }}\n push: true\n tags: ghcr.io/slint-ui/slint/${{matrix.target}}:latest\n - name: Build and push C++ image\n uses: docker/build-push-action@v7\n with:\n context: .\n file: ./docker/Dockerfile.cpp-image\n push: true\n tags: ghcr.io/slint-ui/slint/${{matrix.target}}-cpp:latest\n build-args: |\n arch=${{matrix.target}}\n\n build_demos:\n needs: [build_containers]\n runs-on: ubuntu-22.04\n strategy:\n matrix:\n target:\n - armv7-unknown-linux-gnueabihf\n - aarch64-unknown-linux-gnu\n - x86_64-unknown-linux-gnu\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: ${{ matrix.target }}\n - name: Enable Skia build\n if: matrix.target != 'riscv64gc-unknown-linux-gnu'\n run: |\n echo \"EXTRA_ARGS=--features slint/renderer-skia\" >> $GITHUB_ENV\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cross\n - name: Build\n run: cross build --release --target=${{ matrix.target }} ${{ env.EXTRA_ARGS }} --features slint/backend-linuxkms-noseat,slint/renderer-skia -p energy-monitor -p printerdemo -p todo -p slint-viewer -p gallery -p home-automation\n - name: \"Upload demo artifacts\"\n uses: actions/upload-artifact@v7\n with:\n name: slint-embedded-demos-${{ matrix.target }}\n path: |\n target/${{ matrix.target }}/release/printerdemo\n target/${{ matrix.target }}/release/todo\n target/${{ matrix.target }}/release/gallery\n target/${{ matrix.target }}/release/viewer\n target/${{ matrix.target }}/release/energy-monitor\n target/${{ matrix.target }}/release/home-automation\n" }, { "path": ".github/workflows/issue_triage.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Auto-triage on Comment\n\non:\n issue_comment:\n types: [created]\n\npermissions:\n issues: write\n pull-requests: write\n\njobs:\n update_labels:\n runs-on: ubuntu-latest\n steps:\n - name: Check whether we should update the tags\n id: check\n env:\n GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: |\n has_needs_info=$(echo '${{ toJson(github.event.issue.labels.*.name) }}' | jq 'contains([\"needs info\"])')\n\n is_author=\"${{ github.event.comment.user.login == github.event.issue.user.login }}\"\n\n echo \"has_needs_info=$has_needs_info\" >> $GITHUB_OUTPUT\n echo \"is_author=$is_author\" >> $GITHUB_OUTPUT\n\n - name: Update labels\n if: steps.check.outputs.has_needs_info == 'true' && steps.check.outputs.is_author == 'true'\n env:\n GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: |\n gh api --method DELETE -H \"Accept: application/vnd.github+json\" /repos/${{ github.repository }}/issues/${{ github.event.issue.number }}/labels/needs%20info\n gh api --method POST -H \"Accept: application/vnd.github+json\" /repos/${{ github.repository }}/issues/${{ github.event.issue.number }}/labels -f labels[]='need triaging'\n" }, { "path": ".github/workflows/material.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Material - Build, test and publish\n\non:\n workflow_dispatch:\n inputs:\n deploy_production:\n type: boolean\n description: \"Deploy to material.slint.dev \\n Only tick this box if you want to deploy the current state of the master branch to material.slint.dev.\"\n default: false\n required: false\n workflow_call:\n\n secrets:\n CLOUDFLARE_API_TOKEN:\n required: true\n CLOUDFLARE_API_TOKEN_2:\n required: true\n CLOUDFLARE_ACCOUNT_ID:\n required: true\n CLOUDFLARE_ACCOUNT_ID_2:\n required: true\n ANDROID_KEYSTORE_PASSWORD:\n required: true\n ANDROID_KEYSTORE_BASE64:\n required: true\n\npermissions:\n contents: read\n\nenv:\n MATERIAL_ZIP_VERSION: \"1.0.1\"\n\njobs:\n material_wasm_demo:\n uses: ./.github/workflows/material_wasm_gallery.yaml\n material_apk_demo:\n if: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}\n uses: ./.github/workflows/material_gallery.yaml\n secrets:\n ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}\n ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}\n material_tests:\n env:\n CARGO_PROFILE_RELEASE_OPT_LEVEL: s\n CARGO_INCREMENTAL: false\n runs-on: ubuntu-latest\n defaults:\n run:\n working-directory: ui-libraries/material\n steps:\n - uses: actions/checkout@v6\n - name: Install Linux dependencies\n if: runner.os == 'Linux'\n run: |\n sudo apt-get update\n sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev libxkbcommon-x11-dev libfontconfig-dev\n shell: bash\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n - uses: Swatinem/rust-cache@v2\n with:\n key: tests\n - name: Build & run tests\n run: cargo test -p material-gallery\n\n deploy:\n runs-on: ubuntu-latest\n needs: [material_wasm_demo, material_apk_demo]\n permissions:\n contents: read\n deployments: write\n name: Deploy to Cloudflare Pages\n\n defaults:\n run:\n working-directory: ui-libraries/material/docs\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n - name: Install Linux dependencies\n run: |\n sudo apt-get update\n sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev libxkbcommon-x11-dev libfontconfig-dev\n shell: bash\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n - name: Take screenshots\n run: cargo run -p slint-docsnapper -- -Lmaterial=$PWD/src/material.slint docs\n working-directory: ui-libraries/material\n - name: Install dependencies\n run: pnpm install --frozen-lockfile\n - name: Build\n run: pnpm build\n - uses: actions/download-artifact@v8\n with:\n name: material_wasm_gallery\n path: ui-libraries/material/docs/dist/wasm\n - uses: actions/download-artifact@v8\n if: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}\n with:\n name: material_gallery\n path: ui-libraries/material/docs/dist/apk\n - name: Normalize APK names\n if: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}\n working-directory: ui-libraries/material\n run: |\n if [ -f docs/dist/apk/material-gallery.apk ]; then mv docs/dist/apk/material-gallery.apk docs/dist/apk/slint_material.apk; fi\n if [ -f docs/dist/apk/material-gallery.aab ]; then mv docs/dist/apk/material-gallery.aab docs/dist/apk/slint_material.aab; fi\n - name: Zip material library\n working-directory: ui-libraries/material\n run: |\n cp -a src material-${MATERIAL_ZIP_VERSION}\n mkdir -p docs/dist/zip\n curl -fsSL -o docs/dist/zip/material-1.0.zip https://releases.slint.dev/material-1.0/material-1.0.zip\n zip -r docs/dist/zip/material-${MATERIAL_ZIP_VERSION}.zip material-${MATERIAL_ZIP_VERSION}\n rm -rf material-${MATERIAL_ZIP_VERSION}\n - name: Deploy to materialui (Pages)\n if: github.event_name == 'workflow_dispatch' && github.event.inputs.deploy_production == 'true'\n uses: cloudflare/wrangler-action@v3\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n command: pages deploy dist --project-name=materialui --branch=master\n gitHubToken: ${{ secrets.GITHUB_TOKEN }}\n packageManager: pnpm\n workingDirectory: ui-libraries/material/docs\n\n - name: Deploy to material-staging (Workers production)\n if: (github.event_name != 'workflow_dispatch' || github.event.inputs.deploy_production != 'true') && github.ref == 'refs/heads/master'\n uses: cloudflare/wrangler-action@v3\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN_2 }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID_2 }}\n command: deploy\n gitHubToken: ${{ secrets.GITHUB_TOKEN }}\n packageManager: pnpm\n workingDirectory: ui-libraries/material/docs\n\n - name: Deploy preview to material-staging (Workers)\n id: preview\n if: (github.event_name != 'workflow_dispatch' || github.event.inputs.deploy_production != 'true') && github.ref != 'refs/heads/master'\n run: |\n OUTPUT=$(pnpm dlx wrangler@3 versions upload 2>&1)\n echo \"$OUTPUT\"\n PREVIEW_URL=$(echo \"$OUTPUT\" | grep -oE 'https://[^[:space:]]+\\.workers\\.dev' | head -1)\n echo \"url=$PREVIEW_URL\" >> $GITHUB_OUTPUT\n working-directory: ui-libraries/material/docs\n env:\n CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN_2 }}\n CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID_2 }}\n\n - name: Create GitHub deployment for PR\n if: steps.preview.outputs.url != '' && github.event_name == 'pull_request'\n uses: actions/github-script@v8\n env:\n PREVIEW_URL: ${{ steps.preview.outputs.url }}\n with:\n script: |\n const ref = context.payload.pull_request.head.sha;\n const deployment = await github.rest.repos.createDeployment({\n owner: context.repo.owner,\n repo: context.repo.repo,\n ref,\n environment: 'preview',\n auto_merge: false,\n required_contexts: []\n });\n if (deployment.data.id) {\n await github.rest.repos.createDeploymentStatus({\n owner: context.repo.owner,\n repo: context.repo.repo,\n deployment_id: deployment.data.id,\n state: 'success',\n environment_url: process.env.PREVIEW_URL,\n log_url: `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}`\n });\n }\n" }, { "path": ".github/workflows/material_gallery.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Build an APK and AAB for the gallery example\n\non:\n workflow_dispatch:\n workflow_call:\n secrets:\n ANDROID_KEYSTORE_PASSWORD:\n required: true\n ANDROID_KEYSTORE_BASE64:\n required: true\n\njobs:\n material_gallery_android:\n env:\n CARGO_PROFILE_RELEASE_OPT_LEVEL: s\n CARGO_INCREMENTAL: false\n CARGO_APK_RELEASE_KEYSTORE: /home/runner/.android/release.keystore\n CARGO_APK_RELEASE_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}\n runs-on: ubuntu-latest\n defaults:\n run:\n working-directory: ui-libraries/material\n steps:\n - uses: actions/checkout@v6\n\n # 1. Check Artifact Caches\n - name: Cache apk build\n id: cache-apk\n uses: actions/cache@v5\n with:\n path: |\n target/x/release/android/material-gallery.apk\n key: apk-build-${{ hashFiles('ui-libraries/material/examples/gallery/**', 'ui-libraries/material/ui/**', 'ui-libraries/material/Cargo.toml', 'ui-libraries/material/material.slint') }}\n\n - name: Cache aab build\n id: cache-aab\n uses: actions/cache@v5\n with:\n path: |\n target/x/release/android/material-gallery.aab\n key: aab-build-${{ hashFiles('ui-libraries/material/examples/gallery/**', 'ui-libraries/material/ui/**', 'ui-libraries/material/Cargo.toml', 'ui-libraries/material/material.slint') }}\n\n # 2. Install Dependencies (Run only if artifacts are missing)\n - uses: ./.github/actions/install-linux-dependencies\n if: steps.cache-apk.outputs.cache-hit != 'true' || steps.cache-aab.outputs.cache-hit != 'true'\n\n - name: Install Rust\n if: steps.cache-apk.outputs.cache-hit != 'true' || steps.cache-aab.outputs.cache-hit != 'true'\n uses: dtolnay/rust-toolchain@stable\n with:\n target: aarch64-linux-android\n\n - name: Install Android API level 30\n if: steps.cache-apk.outputs.cache-hit != 'true' || steps.cache-aab.outputs.cache-hit != 'true'\n run: ${ANDROID_HOME}/cmdline-tools/latest/bin/sdkmanager --install \"platforms;android-30\"\n\n # 3. Setup Environment (Run only if artifacts are missing)\n - name: Add NDK LLVM to PATH\n if: steps.cache-apk.outputs.cache-hit != 'true' || steps.cache-aab.outputs.cache-hit != 'true'\n run: echo \"${ANDROID_NDK_HOME}/toolchains/llvm/prebuilt/linux-x86_64/bin\" >> $GITHUB_PATH\n - name: Dump keystore\n if: steps.cache-apk.outputs.cache-hit != 'true' || steps.cache-aab.outputs.cache-hit != 'true'\n run: |\n mkdir -p /home/runner/.android\n echo \"${{ secrets.ANDROID_KEYSTORE_BASE64 }}\" | base64 --decode > $CARGO_APK_RELEASE_KEYSTORE\n\n # 4. Tool Caching & Installation\n - name: Cache xbuild\n if: steps.cache-apk.outputs.cache-hit != 'true' || steps.cache-aab.outputs.cache-hit != 'true'\n id: xbuild-cache\n uses: actions/cache@v5\n with:\n path: |\n ~/.cargo/bin/x\n ~/.cargo/bin/xbuild\n key: xbuild-cache-v2\n\n - uses: Swatinem/rust-cache@v2\n if: steps.cache-apk.outputs.cache-hit != 'true' || steps.cache-aab.outputs.cache-hit != 'true'\n with:\n key: android-build\n\n - name: Install xbuild\n if: (steps.cache-apk.outputs.cache-hit != 'true' || steps.cache-aab.outputs.cache-hit != 'true') && steps.xbuild-cache.outputs.cache-hit != 'true'\n run: cargo install --git https://github.com/burhankhanzada/xbuild --rev 5eb203e9e0718bd992632b803d59bed80ae0bdc0 xbuild\n\n # 5. Build\n - name: Build apk\n if: steps.cache-apk.outputs.cache-hit != 'true'\n working-directory: ui-libraries/material/examples/gallery\n run: x build --platform android --arch arm64 --release --format 'apk'\n\n - name: Build aab\n if: steps.cache-aab.outputs.cache-hit != 'true'\n working-directory: ui-libraries/material/examples/gallery\n run: x build --platform android --arch arm64 --release --format 'aab'\n\n - name: Verify aab\n if: steps.cache-aab.outputs.cache-hit != 'true'\n working-directory: ui-libraries/material/examples/gallery\n run: |\n wget https://github.com/google/bundletool/releases/download/1.18.3/bundletool-all-1.18.3.jar\n java -jar bundletool-all-1.18.3.jar validate --bundle $GITHUB_WORKSPACE/target/x/release/android/material-gallery.aab\n\n # 6. Upload\n - name: \"Upload Artifacts\"\n uses: actions/upload-artifact@v7\n with:\n name: material_gallery\n path: |\n target/x/release/android/material-gallery.apk\n target/x/release/android/material-gallery.aab\n" }, { "path": ".github/workflows/material_wasm_gallery.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Build a WASM version of the gallery example\n\non:\n workflow_dispatch:\n workflow_call:\n\njobs:\n material_wasm_build:\n env:\n CARGO_PROFILE_RELEASE_OPT_LEVEL: s\n CARGO_INCREMENTAL: false\n runs-on: ubuntu-latest\n defaults:\n run:\n working-directory: ui-libraries/material\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - name: Cache WASM build\n id: cache-wasm\n uses: actions/cache@v5\n with:\n path: |\n ui-libraries/material/examples/gallery/pkg\n ui-libraries/material/examples/gallery/index.html\n ui-libraries/material/examples/gallery/frame-tablet.webp\n key: wasm-build-${{ hashFiles('ui-libraries/material/examples/gallery/**', 'ui-libraries/material/ui/**', 'ui-libraries/material/Cargo.toml', 'ui-libraries/material/material.slint') }}\n - name: Install Rust\n if: steps.cache-wasm.outputs.cache-hit != 'true'\n uses: dtolnay/rust-toolchain@stable\n with:\n target: wasm32-unknown-unknown\n - name: Install wasm-pack\n if: steps.cache-wasm.outputs.cache-hit != 'true'\n run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh\n - uses: Swatinem/rust-cache@v2\n if: steps.cache-wasm.outputs.cache-hit != 'true'\n with:\n key: wasm-build\n - name: Build\n if: steps.cache-wasm.outputs.cache-hit != 'true'\n working-directory: ui-libraries/material/examples/gallery\n run: wasm-pack build --target web\n - name: \"Upload Artifacts\"\n uses: actions/upload-artifact@v7\n with:\n name: material_wasm_gallery\n path: |\n ui-libraries/material/examples/gallery/index.html\n ui-libraries/material/examples/gallery/frame-tablet.webp\n ui-libraries/material/examples/gallery/pkg\n" }, { "path": ".github/workflows/nightly_snapshot.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# Build various demo binaries, c++ packages and documentation and publish them on the website\nname: Nightly snapshot\n\non:\n workflow_dispatch:\n inputs:\n private:\n type: boolean\n default: true\n required: false\n description: \"Private build? True means artifacts are only built. False means the artefacts are published (docs, vscode extension) to the web/marketplace\"\n release:\n type: boolean\n default: false\n required: false\n description: \"Release? Enable options for building binaries for a release (i.e. don't have a -nightly suffix for the extension)\"\n\nenv:\n # Keep in sync with features in slint_tool_binary.yaml, cpp_package.yaml, api/node/Cargo.toml, and api/python/slint/Cargo.toml\n SLINT_BINARY_FEATURES: \"backend-linuxkms-noseat,backend-winit,renderer-femtovg,renderer-skia,renderer-software\"\n MACOSX_DEPLOYMENT_TARGET: \"11.0\"\n\njobs:\n slint-viewer-binary:\n uses: ./.github/workflows/slint_tool_binary.yaml\n with:\n program: \"viewer\"\n secrets:\n certificate: ${{ secrets.APPLE_CERTIFICATE_P12 }}\n certificate_password: ${{ secrets.APPLE_CERTIFICATE_P12_PASSWORD }}\n keychain_password: ${{ secrets.APPLE_KEYCHAIN_PASSWORD }}\n developer_id: ${{ secrets.APPLE_DEV_ID }}\n slint-lsp-binary:\n uses: ./.github/workflows/slint_tool_binary.yaml\n with:\n program: \"lsp\"\n secrets:\n certificate: ${{ secrets.APPLE_CERTIFICATE_P12 }}\n certificate_password: ${{ secrets.APPLE_CERTIFICATE_P12_PASSWORD }}\n keychain_password: ${{ secrets.APPLE_KEYCHAIN_PASSWORD }}\n developer_id: ${{ secrets.APPLE_DEV_ID }}\n docs:\n uses: ./.github/workflows/build_docs.yaml\n secrets: inherit\n with:\n release: ${{ github.event.inputs.release }}\n app-id: ${{ vars.READ_WRITE_APP_ID }}\n\n wasm_demo:\n uses: ./.github/workflows/wasm_demos.yaml\n with:\n build_artifacts: true\n wasm:\n uses: ./.github/workflows/wasm_editor_and_interpreter.yaml\n cpp_package:\n uses: ./.github/workflows/cpp_package.yaml\n with:\n extra_cmake_flags: ${{ github.event.inputs.release != 'true' && '-DCPACK_PACKAGE_VERSION=nightly' || '' }}\n\n check-for-secrets:\n runs-on: ubuntu-latest\n outputs:\n has-vscode-marketplace-pat: ${{ steps.one.outputs.has-vscode-marketplace-pat }}\n has-openvsx-pat: ${{ steps.one.outputs.has-openvsx-pat }}\n steps:\n - id: one\n run: |\n [ -n \"${{ secrets.VSCODE_MARKETPLACE_PAT }}\" ] && echo \"has-vscode-marketplace-pat=yes\" >> \"$GITHUB_OUTPUT\"\n [ -n \"${{ secrets.OPENVSX_PAT }}\" ] && echo \"has-openvsx-pat=yes\" >> \"$GITHUB_OUTPUT\"\n\n build_vscode_lsp_linux_windows:\n env:\n SLINT_NO_QT: 1\n strategy:\n matrix:\n include:\n - os: ubuntu-22.04\n toolchain: x86_64-unknown-linux-gnu\n binary_built: slint-lsp\n artifact_name: slint-lsp-x86_64-unknown-linux-gnu\n - os: windows-2022\n toolchain: x86_64-pc-windows-msvc\n binary_built: slint-lsp.exe\n artifact_name: slint-lsp-x86_64-pc-windows-msvc.exe\n - os: windows-11-arm\n toolchain: aarch64-pc-windows-msvc\n binary_built: slint-lsp.exe\n artifact_name: slint-lsp-aarch64-pc-windows-msvc.exe\n runs-on: ${{ matrix.os }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: ${{ matrix.toolchain }}\n - uses: ./.github/actions/install-linux-dependencies\n with:\n old-ubuntu: true\n - name: Build LSP\n run: cargo build --target ${{ matrix.toolchain }} --features ${{ env.SLINT_BINARY_FEATURES }} --release -p slint-lsp\n - name: Create artifact directory\n run: |\n mkdir bin\n cp target/${{ matrix.toolchain }}/release/${{ matrix.binary_built }} bin/${{ matrix.artifact_name }}\n - name: \"Upload LSP Artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: vscode-lsp-binary-${{ matrix.toolchain }}\n path: |\n bin\n\n build_vscode_lsp_macos_x86_64:\n env:\n SLINT_NO_QT: 1\n runs-on: macos-15-intel\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: x86_64-apple-darwin\n - name: Install cargo-bundle\n run: cargo install --version=0.6.0 cargo-bundle\n - name: Build Main LSP Bundle\n working-directory: tools/lsp\n run: cargo bundle --release --features ${{ env.SLINT_BINARY_FEATURES }}\n - name: Create artifact directory\n run: |\n mkdir bin\n cp -a target/release/bundle/osx/Slint\\ Live\\ Preview.app bin\n - name: \"Upload LSP Artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: vscode-lsp-binary-x86_64-apple-darwin\n path: |\n bin\n\n build_vscode_lsp_macos_aarch64:\n env:\n SLINT_NO_QT: 1\n runs-on: macos-26\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: aarch64-apple-darwin\n - name: Build AArch64 LSP\n run: cargo build --target aarch64-apple-darwin --features ${{ env.SLINT_BINARY_FEATURES }} --release -p slint-lsp\n - name: Create artifact directory\n run: |\n mkdir bin\n cp -a target/aarch64-apple-darwin/release/slint-lsp bin/slint-lsp-aarch64-apple-darwin\n - name: \"Upload LSP Artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: vscode-lsp-binary-aarch64-apple-darwin\n path: |\n bin\n\n build_vscode_lsp_macos_bundle:\n needs: [build_vscode_lsp_macos_x86_64, build_vscode_lsp_macos_aarch64]\n runs-on: macos-15\n steps:\n - uses: actions/checkout@v6\n with:\n path: \"src\"\n - uses: actions/download-artifact@v8\n with:\n name: vscode-lsp-binary-x86_64-apple-darwin\n - uses: actions/download-artifact@v8\n with:\n name: vscode-lsp-binary-aarch64-apple-darwin\n path: bin\n - name: Add macOS AArch64 binary to bundle\n run: |\n lipo -create -output tmp Slint\\ Live\\ Preview.app/Contents/MacOS/slint-lsp bin/slint-lsp-aarch64-apple-darwin\n mv tmp Slint\\ Live\\ Preview.app/Contents/MacOS/slint-lsp\n rm -rf bin\n - uses: ./src/.github/actions/codesign\n with:\n binary: \"Slint Live Preview.app\"\n certificate: ${{ secrets.APPLE_CERTIFICATE_P12 }}\n certificate_password: ${{ secrets.APPLE_CERTIFICATE_P12_PASSWORD }}\n keychain_password: ${{ secrets.APPLE_KEYCHAIN_PASSWORD }}\n developer_id: ${{ secrets.APPLE_DEV_ID }}\n - name: \"Remove temporary source checkout\"\n run: rm -rf src\n - name: \"Upload LSP macOS bundle Artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: vscode-lsp-binary-darwin\n path: .\n\n build_vscode_cross_linux_lsp:\n env:\n SLINT_NO_QT: 1\n strategy:\n matrix:\n target:\n - armv7-unknown-linux-gnueabihf\n - aarch64-unknown-linux-gnu\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: ${{ matrix.target }}\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cross\n - name: Build LSP\n run: cross build --target ${{ matrix.target }} --features ${{ env.SLINT_BINARY_FEATURES }} --release -p slint-lsp\n - name: Create artifact directory\n run: |\n mkdir bin\n cp target/${{ matrix.target }}/release/slint-lsp bin/slint-lsp-${{ matrix.target }}\n - name: \"Upload LSP Artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: vscode-lsp-binary-${{ matrix.target }}\n path: |\n bin\n\n build_vscode_extension:\n needs:\n [\n build_vscode_lsp_linux_windows,\n build_vscode_lsp_macos_bundle,\n build_vscode_cross_linux_lsp,\n check-for-secrets,\n ]\n runs-on: macos-14\n if: ${{ needs.check-for-secrets.outputs.has-openvsx-pat == 'yes' && needs.check-for-secrets.outputs.has-vscode-marketplace-pat == 'yes' }}\n steps:\n - uses: actions/checkout@v6\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - name: Install GNU Sed\n run: brew install gnu-sed\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n - uses: actions/download-artifact@v8\n with:\n name: vscode-lsp-binary-x86_64-unknown-linux-gnu\n path: editors/vscode/bin\n - uses: actions/download-artifact@v8\n with:\n name: vscode-lsp-binary-x86_64-pc-windows-msvc\n path: editors/vscode/bin\n - uses: actions/download-artifact@v8\n with:\n name: vscode-lsp-binary-aarch64-pc-windows-msvc\n path: editors/vscode/bin\n - uses: actions/download-artifact@v8\n with:\n name: vscode-lsp-binary-darwin\n path: editors/vscode/bin\n - uses: actions/download-artifact@v8\n with:\n name: vscode-lsp-binary-armv7-unknown-linux-gnueabihf\n path: editors/vscode/bin\n - uses: actions/download-artifact@v8\n with:\n name: vscode-lsp-binary-aarch64-unknown-linux-gnu\n path: editors/vscode/bin\n - name: Fix permissions\n run: chmod 755 editors/vscode/bin/* editors/vscode/bin/*.app/Contents/MacOS/*\n - name: \"Prepare meta-data files for nightly package\"\n env:\n RELEASE_INPUT: ${{ github.event.inputs.release }}\n working-directory: editors/vscode\n run: |\n if grep -q 'lines below this marker are stripped from the release' README.md; then\n gsed -i \"/lines below this marker are stripped from the release/,\\$d\" README.md\n else\n echo \"Missing strip marker in VS Code Extension README. Either add or fix this script.\"\n exit 1\n fi\n if [ \"$RELEASE_INPUT\" != \"true\" ]; then\n ../../scripts/prepare_vscode_nightly.sh\n fi\n shell: bash\n - name: \"pnpm install\"\n working-directory: editors/vscode\n run: pnpm install --frozen-lockfile\n - name: Install wasm-pack\n run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh\n - name: Build package and optionally publish to Visual Studio Marketplace\n id: publishToVSCM\n uses: HaaLeo/publish-vscode-extension@v2\n with:\n pat: ${{ secrets.VSCODE_MARKETPLACE_PAT }}\n registryUrl: https://marketplace.visualstudio.com\n dryRun: ${{ github.event.inputs.private == 'true' || (github.ref != 'refs/heads/master' && github.event.inputs.release != 'true') }}\n packagePath: editors/vscode\n dependencies: false\n - name: Publish to Open VSX Registry\n continue-on-error: true\n if: ${{ github.event.inputs.private != 'true' && (github.ref == 'refs/heads/master' || github.event.inputs.release == 'true') }}\n uses: HaaLeo/publish-vscode-extension@v2\n with:\n pat: ${{ secrets.OPENVSX_PAT }}\n extensionFile: ${{ steps.publishToVSCM.outputs.vsixPath }}\n packagePath: \"\"\n - name: \"Upload extension artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: slint-vscode.zip\n path: |\n ${{ steps.publishToVSCM.outputs.vsixPath }}\n\n build-figma-plugin:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n id: node-install\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - name: Run pnpm install\n working-directory: tools/figma-inspector\n run: pnpm install --frozen-lockfile\n - name: Add build timestamp to readme\n working-directory: tools/figma-inspector/public-zip\n run: echo \"Built on $(date '+%d-%m-%Y %H:%M:%S %Z')\" >> readme.txt\n - name: Build zip\n working-directory: tools/figma-inspector\n run: pnpm zip\n - name: Prepare Figma plugin artifact\n run: mv *.zip figma-plugin.zip\n working-directory: tools/figma-inspector/zip\n - name: Archive zip\n uses: actions/upload-artifact@v7\n with:\n name: figma-plugin\n path: tools/figma-inspector/zip\n\n # publish_tree_sitter:\n # if: github.event.inputs.private != 'true'\n # runs-on: ubuntu-22.04\n # steps:\n # - uses: actions/checkout@v6\n # - name: Upload artifact\n # uses: actions/upload-artifact@v7\n # with:\n # name: tree-sitter-slint\n # path: editors/tree-sitter-slint\n\n publish_artifacts:\n if: ${{ github.event.inputs.private != 'true' }}\n needs: [docs, wasm_demo, wasm, check-for-secrets, android]\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/download-artifact@v8\n with:\n pattern: docs-*\n merge-multiple: true\n path: .\n\n - name: Generate a token\n id: app-token-website\n uses: actions/create-github-app-token@v3\n with:\n app-id: ${{ vars.READ_WRITE_APP_ID }}\n private-key: ${{ secrets.READ_WRITE_PRIVATE_KEY }}\n repositories: website\n - name: Clone website directory\n uses: actions/checkout@v6\n with:\n repository: slint-ui/website\n ref: prod\n path: website\n token: ${{ steps.app-token-website.outputs.token }}\n persist-credentials: false\n - name: Generate release-docs.html and 404.html\n run: |\n mkdir -p website/output\n cd website && go run generator/generator.go -skip-agreements\n - name: Copy release-docs.html and 404.html\n run: |\n cp website/output/release-docs.html docs/index.html\n cp website/output/404.html docs/404.html\n rm -rf website\n\n - uses: actions/download-artifact@v8\n with:\n name: slintpad\n path: slintpad\n - uses: actions/download-artifact@v8\n with:\n name: wasm\n - uses: actions/download-artifact@v8\n with:\n name: wasm_demo\n - uses: actions/download-artifact@v8\n with:\n name: android-demo\n path: android\n\n - uses: actions/checkout@v6\n with:\n path: \"slint-src\"\n sparse-checkout: .\n - name: Extract Version from Cargo.toml\n id: version\n run: |\n version=$(awk '/^\\[workspace.package\\]/ {found=1} found && /^version = / {gsub(/version = |\"/, \"\", $0); print $0; exit}' slint-src/Cargo.toml)\n if [[ -z \"$version\" ]]; then\n echo \"Version not found\"\n exit 1\n fi\n echo \"VERSION=$version\" >> $GITHUB_OUTPUT\n\n - name: Generate a token\n id: app-token\n uses: actions/create-github-app-token@v3\n with:\n app-id: ${{ vars.READ_WRITE_APP_ID }}\n private-key: ${{ secrets.READ_WRITE_PRIVATE_KEY }}\n repositories: www-releases\n\n - name: Clone www-releases/releases and slintpad directory\n uses: actions/checkout@v6\n if: ${{ github.event.inputs.release == 'true' }}\n with:\n repository: slint-ui/www-releases\n path: www-releases\n token: ${{ steps.app-token.outputs.token }}\n sparse-checkout: |\n releases\n slintpad\n\n - name: Clone www-releases/snapshots directory\n uses: actions/checkout@v6\n if: ${{ github.event.inputs.release != 'true' }}\n with:\n repository: slint-ui/www-releases\n path: www-releases\n token: ${{ steps.app-token.outputs.token }}\n sparse-checkout: |\n snapshots\n\n - name: Publish Docs and Demos\n working-directory: ./www-releases\n run: |\n if [[ \"${{ github.event.inputs.release }}\" == \"true\" ]]; then\n output_path=\"releases/${{ steps.version.outputs.VERSION }}\"\n else\n output_path=\"snapshots/${GITHUB_REF##*/}\"\n fi\n\n rm -rf $output_path/demos\n mkdir -p $output_path/demos\n\n for demo_subdir in examples,gallery, demos,printerdemo,rust examples,todo,rust examples,todo-mvc,rust examples,slide_puzzle, examples,speedometer,rust examples,memory, examples,imagefilter,rust examples,plotter, examples,opengl_underlay, examples,carousel,rust demos,energy-monitor, demos,weather-demo, demos,home-automation,rust demos,usecases,rust; do\n IFS=',' read example_or_demo demo subdir <<< \"${demo_subdir}\"\n\n mkdir -p $output_path/demos/$demo\n cp -a ../$example_or_demo/$demo/$subdir/{pkg,index.html} $output_path/demos/$demo/\n done\n\n mkdir -p $output_path/demos/android\n cp -a ../android/* $output_path/demos/android/\n\n rm -rf $output_path/wasm-interpreter\n mkdir -p $output_path/wasm-interpreter\n cp -a ../api/wasm-interpreter/pkg/* ./$output_path/wasm-interpreter/\n\n rm -rf $output_path/editor\n mkdir -p $output_path/editor\n cp -a ../slintpad/* $output_path/editor/\n\n if [[ \"${{ github.event.inputs.release }}\" == \"true\" ]]; then\n version=\"${{ steps.version.outputs.VERSION }}\"\n else\n version=\"development snapshot\"\n fi\n sed -i \"s/VERSION/$version/g\" ../docs/index.html\n\n rm -rf $output_path/docs\n mv ../docs $output_path\n\n # Fix up link to Slint language documentation\n sed -i \"s!https://slint.dev/releases/.*/docs/!../../!\" $output_path/docs/rust/slint/*.html\n\n - name: Adjust redirections\n if: github.event.inputs.release == 'true'\n run: |\n sed -i \"/1.0.2/! s,[0-9]*\\.[0-9]*\\.[0-9]*/\\(.*\\),${{ steps.version.outputs.VERSION }}/\\1,\" www-releases/releases/_redirects\n\n - name: Adjust slintpad default tag\n if: github.event.inputs.release == 'true'\n run: sed -i \"s,XXXX_DEFAULT_TAG_XXXX,v${{ steps.version.outputs.VERSION }},\" www-releases/releases/${{ steps.version.outputs.VERSION }}/editor/assets/*.js\n\n - name: Update versions.txt\n if: github.event.inputs.release == 'true'\n working-directory: www-releases/releases\n run: ls -1d */ | cut -f1 -d'/' | sort --version-sort -r > versions.txt\n\n - name: Print contents before update\n if: github.event.inputs.release == 'true'\n working-directory: www-releases/releases\n run: cat versions.json\n\n - name: Update version in versions.json\n if: github.event.inputs.release == 'true'\n working-directory: www-releases/releases\n run: |\n sed -i '/\"name\": \"development snapshot\"/,/\"preferred\": true,/c\\\n \"name\": \"development snapshot\",\\\n \"url\": \"https://snapshots.slint.dev/master/docs/slint\"\\\n },\\\n {\\\n \"preferred\": true,\\\n \"version\": \"${{ steps.version.outputs.VERSION }}\",\\\n \"url\": \"https://releases.slint.dev/${{ steps.version.outputs.VERSION }}/docs/slint\"\\\n },\\\n {' versions.json\n\n - name: Print contents before update\n if: github.event.inputs.release == 'true'\n working-directory: www-releases/releases\n run: cat versions.json\n\n - name: Update SlintPad\n if: github.event.inputs.release == 'true'\n run: |\n rm -rf www-releases/slintpad\n cp -r www-releases/releases/${{ steps.version.outputs.VERSION }}/editor www-releases/slintpad\n for f in 404.html script.js LICENSE.md package.json; do\n cp www-releases/releases/$f www-releases/slintpad\n done\n echo \"${{ steps.version.outputs.VERSION }}\" > www-releases/slintpad/versions.txt\n\n - name: Get GitHub App User ID\n id: get-user-id\n run: echo \"user-id=$(gh api \"/users/${{ steps.app-token.outputs.app-slug }}[bot]\" --jq .id)\" >> \"$GITHUB_OUTPUT\"\n env:\n GH_TOKEN: ${{ steps.app-token.outputs.token }}\n\n - name: check for diff\n id: www-releases\n working-directory: ./www-releases\n run: |\n git add .\n git add -u .\n git diff-index --cached --quiet HEAD || echo \"has-diff=yes\" >> \"$GITHUB_OUTPUT\"\n\n - name: commit and push\n if: ${{ steps.www-releases.outputs.has-diff == 'yes' }}\n working-directory: ./www-releases\n run: |\n git config user.name '${{ steps.app-token.outputs.app-slug }}[bot]'\n git config user.email '${{ steps.get-user-id.outputs.user-id }}+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com>'\n git commit --message \"Update $NAME from $GITHUB_REPOSITORY\" --message \"Pull web demos and C++/Rust reference docs from commit $GITHUB_SHA ($GITHUB_REF)\"\n git push\n\n prepare_release:\n if: github.event.inputs.private != 'true'\n needs: [cpp_package, slint-viewer-binary, slint-lsp-binary, build-figma-plugin]\n runs-on: ubuntu-22.04\n permissions:\n contents: write\n steps:\n - uses: actions/download-artifact@v8\n with:\n pattern: cpp_bin-*\n merge-multiple: true\n - uses: actions/download-artifact@v8\n with:\n pattern: cpp_mcu_bin-*\n merge-multiple: true\n - uses: actions/download-artifact@v8\n with:\n pattern: slint-compiler-bin-*\n merge-multiple: true\n - uses: actions/download-artifact@v8\n with:\n pattern: slint-viewer-*\n merge-multiple: true\n - uses: actions/download-artifact@v8\n with:\n pattern: slint-lsp-*\n merge-multiple: true\n - uses: actions/download-artifact@v8\n with:\n name: figma-plugin\n - name: Extract files\n run: |\n ls -l\n mkdir artifacts\n mv Slint-cpp-*-win64*.exe artifacts/\n mv Slint-cpp-*.tar.gz artifacts/\n mv slint-viewer-linux.tar.gz artifacts/\n mv slint-viewer-armv7-unknown-linux-gnueabihf.tar.gz artifacts/\n mv slint-viewer-aarch64-unknown-linux-gnu.tar.gz artifacts/\n mv slint-viewer-macos.tar.gz artifacts/\n mv slint-viewer-windows*.zip artifacts/\n mv slint-lsp-linux.tar.gz artifacts/\n mv slint-lsp-armv7-unknown-linux-gnueabihf.tar.gz artifacts/\n mv slint-lsp-aarch64-unknown-linux-gnu.tar.gz artifacts/\n mv slint-lsp-macos.tar.gz artifacts/\n mv slint-lsp-windows*.zip artifacts/\n mv slint-compiler-*.tar.gz artifacts/\n mv figma-plugin.zip artifacts/\n - uses: actions/checkout@v6\n with:\n path: \"slint-src\"\n sparse-checkout: docs\n - name: prepare release notes\n id: version\n env:\n RELEASE_INPUT: ${{ github.event.inputs.release }}\n run: |\n if [ \"$RELEASE_INPUT\" != \"true\" ]; then\n notes_file=slint-src/docs/nightly-release-notes.md\n version=nightly\n download_version=$version\n else\n version=$(echo artifacts/Slint-cpp-*-win64-MSVC-AMD64.exe | sed -nre 's/^.*-([0-9]+\\.[0-9]+\\.[0-9]+).*$/\\1/p')\n if [[ -z \"$version\" ]]; then\n echo \"Version not found\"\n exit 1\n fi\n major_version=`echo $version | sed -e \"s,\\([0-9]*\\)\\.[0-9]*\\.[0-9]*,\\1,\"`\n minor_version=`echo $version | sed -e \"s,[0-9]*\\.\\([0-9]*\\)\\.[0-9]*,\\1,\"`\n notes_file=slint-src/docs/release-notes.md\n download_version=v$version\n fi\n echo \"VERSION=$version\" >> $GITHUB_OUTPUT\n cat $notes_file slint-src/docs/release-artifacts.md > release-notes.md\n branch=\"${GITHUB_REF#refs/heads/}\"\n feature=\"${GITHUB_REF##*/}\"\n sed -i -e \"s,{branch},$branch,g\" release-notes.md\n sed -i -e \"s,{feature},$feature,g\" release-notes.md\n sed -i -e \"s,{version},$version,g\" release-notes.md\n sed -i -e \"s,{download_version},$download_version,g\" release-notes.md\n sed -i -e \"s,{major_version},$major_version,g\" release-notes.md\n sed -i -e \"s,{minor_version},$minor_version,g\" release-notes.md\n cat release-notes.md\n\n - name: generate STM32 template packages\n env:\n RELEASE_INPUT: ${{ github.event.inputs.release }}\n run: |\n git clone https://github.com/slint-ui/slint-cpp-templates-stm32 --depth 1\n cd slint-cpp-templates-stm32\n if [ \"$RELEASE_INPUT\" = \"true\" ]; then\n find . -name \"CMakeLists.txt\" | xargs sed -i \"s/find_package(Slint)/find_package(Slint ${{ steps.version.outputs.VERSION }})/g\"\n fi\n for board in stm32h735g-dk stm32h747i-disco; do\n mv $board slint-cpp-template-$board\n zip -r ../artifacts/slint-cpp-template-$board.zip slint-cpp-template-$board/\n done\n\n - uses: ncipollo/release-action@v1\n if: github.event.inputs.release == 'true'\n with:\n draft: true\n artifacts: \"artifacts/*\"\n bodyFile: release-notes.md\n name: ${{ steps.version.outputs.VERSION }}\n tag: v${{ steps.version.outputs.VERSION }}\n commit: ${{ github.sha }}\n - uses: ncipollo/release-action@v1\n if: github.event.inputs.release != 'true' && github.ref == 'refs/heads/master'\n with:\n allowUpdates: true\n prerelease: true\n removeArtifacts: true\n replacesArtifacts: true\n artifacts: \"artifacts/*\"\n bodyFile: release-notes.md\n name: nightly\n tag: nightly\n commit: ${{ github.sha }}\n - name: trigger stm32 build\n if: github.ref == 'refs/heads/master'\n run: |\n curl -L \\\n -X POST \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"Authorization: Bearer ${{ secrets.STM32_CPP_TRIGGER }}\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n https://api.github.com/repos/slint-ui/slint-cpp-templates-stm32/actions/workflows/ci.yaml/dispatches \\\n -d '{\"ref\":\"main\"}'\n\n nightly-tests:\n if: github.event.inputs.release != 'true'\n needs: [prepare_release]\n uses: ./.github/workflows/nightly_tests.yaml\n\n nightly-build-and-test:\n if: github.event.inputs.release != 'true'\n strategy:\n matrix:\n include:\n - os: ubuntu-22.04\n name: \"Ubuntu 22.04 1.92\"\n rust_version: \"1.92\"\n extra_args: \"--exclude plotter\"\n - os: windows-2022\n name: \"Windows 2022 nightly\"\n rust_version: \"nightly\"\n extra_args: \"--exclude ffmpeg --exclude gstreamer-player\"\n - os: macos-14\n name: \"MacOS 14 nightly\"\n rust_version: \"nightly\"\n extra_args: \"--exclude ffmpeg --exclude gstreamer-player\"\n uses: ./.github/workflows/build_and_test_reusable.yaml\n with:\n os: ${{ matrix.os }}\n name: ${{ matrix.name }}\n rust_version: ${{ matrix.rust_version }}\n extra_args: ${{ matrix.extra_args }}\n # In the nightly CI run, run cargo update to test if any downstream dependency broke our build\n # Do not update the cache though, as that would trash the cache for the next runner, which uses the non-updated\n # lockfile.\n update: true\n save_if: false\n\n android:\n env:\n CARGO_APK_RELEASE_KEYSTORE: /home/runner/.android/release.keystore\n CARGO_APK_RELEASE_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - name: Install Android API level 30\n run: ${ANDROID_HOME}/cmdline-tools/latest/bin/sdkmanager --install \"platforms;android-30\"\n - name: Cache cargo-apk\n id: cargo-apk-cache\n uses: actions/cache@v5\n with:\n path: ~/.cargo/bin/cargo-apk\n key: cargo-apk-cache\n # Only build cargo-apk if not cached\n - uses: dtolnay/rust-toolchain@stable\n if: steps.cargo-apk-cache.outputs.cache-hit != 'true'\n - name: Install cargo-apk\n if: steps.cargo-apk-cache.outputs.cache-hit != 'true'\n run: cargo install cargo-apk\n\n - uses: ./.github/actions/setup-rust\n with:\n target: aarch64-linux-android\n\n - name: dump keystore\n run: |\n mkdir -p /home/runner/.android\n echo \"${{ secrets.ANDROID_KEYSTORE_BASE64 }}\" | base64 --decode > $CARGO_APK_RELEASE_KEYSTORE\n\n - name: Build energy-monitor example\n run: cargo apk build -p energy-monitor --target aarch64-linux-android --lib --release\n - name: Build todo demo\n run: cargo apk build -p todo --target aarch64-linux-android --lib --release\n - name: Build weather-demo example\n run: cargo apk build -p weather-demo --target aarch64-linux-android --lib --release\n - name: Build usecases demo\n run: cargo apk build -p usecases --target aarch64-linux-android --lib --release\n - name: Build home automation demo\n run: cargo apk build -p home-automation --target aarch64-linux-android --lib --release\n - name: \"upload APK artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: android-demo\n path: |\n target/release/apk/energy-monitor.apk\n target/release/apk/todo_lib.apk\n target/release/apk/weather_demo.apk\n target/release/apk/usecases_lib.apk\n target/release/apk/usecases_lib.apk\n target/release/apk/home_automation_lib.apk\n" }, { "path": ".github/workflows/nightly_tests.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# Run a bunch of slower tests once a day (or night)\nname: Nightly tests\n\non:\n workflow_dispatch:\n workflow_call:\n\njobs:\n qa-esp-idf:\n strategy:\n matrix:\n esp-idf-target:\n - release-v5.5\n runs-on: ubuntu-22.04\n container: espressif/idf:${{ matrix.esp-idf-target }}\n steps:\n - name: Fix up pydantic regression (https://github.com/espressif/idf-component-manager/issues/97#issuecomment-3380777944)\n run: |\n . ${IDF_PATH}/export.sh\n cd $IDF_PYTHON_ENV_PATH\n bin/pip install pydantic==2.11.10\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@stable\n - uses: esp-rs/xtensa-toolchain@v1.6\n with:\n default: true\n buildtargets: esp32\n ldproxy: false\n - uses: Swatinem/rust-cache@v2\n - name: Build and Test Printer demo\n shell: bash\n working-directory: demos/printerdemo_mcu/esp-idf\n run: |\n . ${IDF_PATH}/export.sh\n idf.py -D SLINT_ESP_LOCAL_EXAMPLE=OFF build\n - name: Build and Test Carousel example s3 box\n shell: bash\n working-directory: examples/carousel/esp-idf/s3-box\n run: |\n . ${IDF_PATH}/export.sh\n idf.py -D SLINT_ESP_LOCAL_EXAMPLE=OFF build\n\n qa-tree-sitter-latest:\n uses: ./.github/workflows/tree_sitter.yaml\n with:\n latest: true\n\n qa-yocto-build:\n strategy:\n matrix:\n include:\n - sdk_url: https://nextcloud.slint.dev/s/SCXYDmEmr45pkak/download/poky-glibc-x86_64-core-image-weston-cortexa57-qemuarm64-toolchain-4.0.9.sh\n env_setup: environment-setup-cortexa57-poky-linux\n target: aarch64-unknown-linux-gnu\n - sdk_url: https://nextcloud.slint.dev/s/BTL5NtLACjgS7Pf/download/poky-glibc-x86_64-core-image-weston-cortexa15t2hf-neon-qemuarm-toolchain-4.0.9.sh\n env_setup: environment-setup-cortexa15t2hf-neon-poky-linux-gnueabi\n target: armv7-unknown-linux-gnueabihf\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - name: Downgrade cc and ring crate to work around https://github.com/slint-ui/slint/issues/6875\n run: |\n cargo update -p ring --precise 0.17.9\n - name: Fetch Yocto SDK\n run: |\n # Fetch pre-built SDK built via populate_sdk for core-image-weston with setup from https://github.com/slint-ui/meta-slint/blob/main/.github/workflows/ci.yml\n wget -O sdk.sh ${{ matrix.sdk_url }}\n chmod +x sdk.sh\n ./sdk.sh -d ${{ runner.workspace }}/yocto-sdk -y\n rm -f sdk.sh\n - name: Install Rust\n uses: dtolnay/rust-toolchain@stable\n with:\n toolchain: stable\n target: ${{ matrix.target }}\n - name: C++ Build\n run: |\n . ${{ runner.workspace }}/yocto-sdk/${{ matrix.env_setup }}\n # Only needed for 32-bit arm builds where soft-fp/hard-fp affects header file lookup, hence the need to drag in these flags. See also commit\n # f5c3908b7ec5131b7b19ff642b5975660c7484f8\n export BINDGEN_EXTRA_CLANG_ARGS=$OECORE_TUNE_CCARGS\n mkdir ${{ runner.workspace }}/cppbuild\n cmake -GNinja -B ${{ runner.workspace }}/cppbuild -S . -DRust_CARGO_TARGET=${{ matrix.target }} -DSLINT_BUILD_TESTING=ON -DSLINT_BUILD_EXAMPLES=ON -DCMAKE_BUILD_TYPE=Debug -DSLINT_FEATURE_RENDERER_SKIA=ON -DSLINT_FEATURE_BACKEND_QT=OFF -DSLINT_FEATURE_BACKEND_LINUXKMS=ON -DSLINT_FEATURE_INTERPRETER=ON\n cmake --build ${{ runner.workspace }}/cppbuild\n\n mcu_zephyr:\n strategy:\n matrix:\n include:\n - board: native_sim/native/64\n toolchain: nightly\n target: x86_64-unknown-linux-gnu\n extra-cmake-args: ''\n - board: mimxrt1170_evk@B/mimxrt1176/cm7\n toolchain: stable\n target: thumbv7em-none-eabihf\n extra-cmake-args: -DSHIELD=rk055hdmipi4ma0\n fail-fast: false\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n with:\n path: slint\n - name: Install linux dependencies, including Zephyr dependencies\n uses: ./slint/.github/actions/install-linux-dependencies\n with:\n extra-packages: |\n git cmake ninja-build gperf ccache dfu-util device-tree-compiler wget python3-dev python3-pip python3-setuptools python3-tk python3-wheel xz-utils file make gcc gcc-multilib g++-multilib libsdl2-dev libmagic1\n - uses: ./slint/.github/actions/setup-rust\n with:\n toolchain: ${{matrix.toolchain}}\n components: rust-src\n target: ${{matrix.target}}\n - name: Setup Zephyr project\n uses: zephyrproject-rtos/action-zephyr-setup@v1.0.12\n with:\n app-path: slint\n manifest-file-name: demos/zephyr-common/west.yaml\n sdk-version: 0.16.8\n - name: Export the Zephyr CMake package\n run: west zephyr-export\n - name: Build for ${{matrix.board}}\n run: |\n west build -b ${{matrix.board}} -p always slint/demos/printerdemo/zephyr -- -DCMAKE_BUILD_TYPE=Release ${{matrix.extra-cmake-args}}\n\n uefi-demo:\n env:\n CARGO_PROFILE_DEV_DEBUG: 0\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n toolchain: stable\n target: x86_64-unknown-uefi\n - name: Check\n run: cargo check --target=x86_64-unknown-uefi -p uefi-demo\n\n ios:\n strategy:\n matrix:\n demo:\n - demos/home-automation/rust\n - demos/energy-monitor\n include:\n - demo: demos/home-automation/rust\n scheme: \"Home Automation\"\n bundle_id: dev.slint.demos.HomeAutomation\n device: iPad Pro 13-inch (M5)\n - demo: demos/energy-monitor\n scheme: \"Energy Monitor\"\n bundle_id: dev.slint.demos.EnergyMonitor\n device: iPhone 17\n runs-on: macos-26\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: aarch64-apple-ios-sim\n - run: brew install xcodegen\n - run: xcodegen -s ios-project.yml\n working-directory: ${{ matrix.demo }}\n - name: \"Find Simulator UDID from iOS 26.0 runtime\"\n run: |\n echo \"=== Finding device from iOS 26.0 runtime (default Xcode) ===\"\n # Find the device UDID from iOS 26.0 runtime to avoid ambiguity\n # Multiple runtimes have devices with the same name, so we need the specific one\n # Output format: \" Device Name (UDID) (Shutdown)\"\n DEVICE_LINE=$(xcrun simctl list devices available | grep -A 50 \"iOS 26.0\" | grep \"${{ matrix.device }}\" | head -n 1)\n\n if [ -z \"$DEVICE_LINE\" ]; then\n echo \"ERROR: Could not find ${{ matrix.device }} in iOS 26.0 runtime\"\n echo \"Available iOS 26.0 devices:\"\n xcrun simctl list devices available | grep -A 30 \"iOS 26.0\"\n exit 1\n fi\n\n # Extract UDID from the line (format: \" Device Name (UDID) (Shutdown)\")\n DEVICE_UDID=$(echo \"$DEVICE_LINE\" | sed -n 's/.*(\\([A-F0-9-]\\{36\\}\\)).*/\\1/p')\n\n if [ -z \"$DEVICE_UDID\" ]; then\n echo \"ERROR: Could not extract UDID from line: $DEVICE_LINE\"\n exit 1\n fi\n\n echo \"Device: ${{ matrix.device }}\"\n echo \"UDID: $DEVICE_UDID\"\n\n # Export UDID for use in xcodebuild and boot steps\n echo \"SIMULATOR_UDID=$DEVICE_UDID\" >> $GITHUB_ENV\n - run: xcodebuild -scheme \"${{ matrix.scheme }}\" -destination \"platform=iOS Simulator,id=${{ env.SIMULATOR_UDID }}\" build\n working-directory: ${{ matrix.demo }}\n# This isn't working reliably. Sometimes the simulator doesn't boot, somethings launching fails, and sometimes screenshotting fails.\n# - name: \"Boot Simulator\"\n# timeout-minutes: 5\n# run: |\n# echo \"=== Booting simulator by UDID ===\"\n# echo \"Device: ${{ matrix.device }}\"\n# echo \"UDID: ${{ env.SIMULATOR_UDID }}\"\n# echo \"Start time: $(date '+%Y-%m-%d %H:%M:%S')\"\n#\n# set -x # Enable command echoing\n# xcrun simctl boot \"${{ env.SIMULATOR_UDID }}\"\n# BOOT_RESULT=$?\n# set +x # Disable command echoing\n#\n# echo \"Boot command completed with exit code: $BOOT_RESULT\"\n# echo \"\"\n#\n# echo \"=== Simulator state after boot command ===\"\n# SIMULATOR_STATUS=$(xcrun simctl list devices | grep \"${{ env.SIMULATOR_UDID }}\")\n# echo \"$SIMULATOR_STATUS\"\n#\n# if echo \"$SIMULATOR_STATUS\" | grep -q \"(Booted)\"; then\n# echo \"Simulator is booted successfully at: $(date '+%Y-%m-%d %H:%M:%S')\"\n# else\n# echo \"ERROR: Simulator failed to boot properly\"\n# echo \"Current status: $SIMULATOR_STATUS\"\n# exit 1\n# fi\n# - name: \"Install\"\n# run: |\n# APP_PATH=$(find ~/Library/Developer/Xcode/DerivedData -name \"${{ matrix.scheme }}.app\" | head -n 1)\n# echo \"Found app bundle at $APP_PATH\"\n# xcrun simctl install booted \"$APP_PATH\"\n# echo \"Verifying installation...\"\n# xcrun simctl listapps booted | grep -q \"${{ matrix.bundle_id }}\" && echo \"App installed successfully\" || echo \"WARNING: App may not be installed\"\n# - name: \"Launch\"\n# timeout-minutes: 5\n# run: |\n# echo \"Attempting to launch ${{ matrix.bundle_id }}...\"\n# # Retry loop to wait for FrontBoard to register the app\n# MAX_ATTEMPTS=10\n# ATTEMPT=1\n# while [ $ATTEMPT -le $MAX_ATTEMPTS ]; do\n# echo \"Launch attempt $ATTEMPT of $MAX_ATTEMPTS...\"\n# if xcrun simctl launch booted \"${{ matrix.bundle_id }}\" 2>&1 | tee launch_output.txt; then\n# echo \"App launched successfully on attempt $ATTEMPT\"\n# sleep 5\n# exit 0\n# fi\n#\n# if grep -q \"unknown to FrontBoard\" launch_output.txt; then\n# echo \"FrontBoard hasn't registered app yet, waiting 2 seconds...\"\n# sleep 2\n# ATTEMPT=$((ATTEMPT + 1))\n# else\n# echo \"Launch failed with a different error:\"\n# cat launch_output.txt\n# echo \"Checking simulator logs...\"\n# xcrun simctl spawn booted log show --last 30s --predicate 'processImagePath contains \"${{ matrix.scheme }}\"' || true\n# exit 1\n# fi\n# done\n#\n# echo \"Failed to launch after $MAX_ATTEMPTS attempts\"\n# exit 1\n# - name: \"Screenshot\"\n# run: xcrun simctl io booted screenshot \"${{ matrix.scheme }}.png\"\n# - name: Upload Screenshot Artifact\n# uses: actions/upload-artifact@v7\n# with:\n# name: ${{matrix.scheme}}-screenshot\n# path: ${{ matrix.scheme }}.png\n# - name: \"Cleanup - Shutdown Simulator\"\n# if: always()\n# run: |\n# echo \"Shutting down simulator to avoid orphan processes...\"\n# xcrun simctl shutdown \"${{ env.SIMULATOR_UDID }}\" || echo \"Simulator already shutdown\"\n\n\n bevy_examples:\n uses: ./.github/workflows/bevy_examples.yaml\n with:\n # In the nightly CI run, run cargo update to test if any downstream dependency broke our build\n # Do not update the cache though, as that would trash the cache for the next runner, which uses the non-updated\n # lockfile.\n update: true\n save_if: false\n\n android_wgpu:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - name: Install Android API level 30\n run: ${ANDROID_HOME}/cmdline-tools/latest/bin/sdkmanager --install \"platforms;android-30\"\n - uses: dtolnay/rust-toolchain@stable\n - name: Install cargo-apk\n run: cargo install cargo-apk\n - uses: ./.github/actions/setup-rust\n with:\n target: aarch64-linux-android\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/install-skia-dependencies\n - name: Build wgpu_texture demo\n run: cargo apk build -p wgpu_texture --target aarch64-linux-android --lib\n\n python:\n strategy:\n matrix:\n os: [ubuntu-22.04, macos-14, windows-2022]\n uses: ./.github/workflows/python_test_reusable.yaml\n with:\n name: \"Python ${{ matrix.os }}\"\n os: ${{ matrix.os }}\n\n node:\n strategy:\n matrix:\n os: [ubuntu-22.04, macos-14, windows-2022]\n uses: ./.github/workflows/node_test_reusable.yaml\n with:\n name: \"Node.js ${{ matrix.os }}\"\n os: ${{ matrix.os }}\n\n miri:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n toolchain: nightly\n key: miri\n components: miri\n - name: Run Miri\n run: cargo miri test -p vtable -p const-field-offset -p i-slint-common\n" }, { "path": ".github/workflows/node_test_reusable.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Node.js Test (Reusable)\n\non:\n workflow_call:\n inputs:\n name:\n description: 'Name of the job'\n required: true\n type: string\n os:\n description: 'Operating system to run on'\n required: true\n type: string\n\nenv:\n RUSTFLAGS: -D warnings\n CARGO_PROFILE_DEV_DEBUG: 0\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: 1\n\n\njobs:\n node_test:\n name: ${{ inputs.name }}\n runs-on: ${{ inputs.os }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/install-skia-dependencies\n - name: Setup headless display\n if: runner.os != 'macOS'\n uses: pyvista/setup-headless-display-action@v4\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n id: node-install\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - uses: ./.github/actions/setup-rust\n with:\n key: x-napi-v2-${{ steps.node-install.outputs.node-version }} # the cache key consists of a manually bumpable version and the node version, as the cached rustc artifacts contain linking information where to find node.lib, which is in a versioned directory.\n - name: Run pnpm install\n working-directory: api/node\n run: pnpm install --frozen-lockfile\n - name: Build node plugin in debug\n run: pnpm build:testing\n working-directory: api/node\n - name: Run node tests\n working-directory: api/node\n run: pnpm test\n - name: Run test-driver-nodejs\n # Release is only applied to the harness that drives the node.js invocations, but needed\n # to avoid crashing on Windows with what looks like an out of stack exception.\n run: cargo test --verbose --release --all-features -p test-driver-nodejs\n - name: Check image-filter example\n working-directory: examples/imagefilter/node\n run: pnpm check\n" }, { "path": ".github/workflows/publish_npm_package.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Publish npm package to npm registry\n\non:\n workflow_dispatch:\n inputs:\n private:\n type: boolean\n default: true\n required: false\n description: \"Private build? True means artifacts are only built. False means the package will be published to the NPM registry\"\n release:\n type: boolean\n default: false\n required: false\n description: \"Release? Enable options for building binaries for a release (i.e. apply a nightly tag, nightly version)\"\n\n schedule:\n - cron: \"0 5 * * *\"\n\npermissions:\n id-token: write # Required for OIDC\n contents: read\n\njobs:\n determine_version:\n runs-on: ubuntu-latest\n outputs:\n PKG_VERSION: ${{ steps.mkversion.outputs.PKG_VERSION }}\n steps:\n - uses: actions/checkout@v6\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - uses: actions/setup-node@v6\n with:\n package-manager-cache: false\n - name: Determine version\n id: mkversion\n env:\n RELEASE_INPUT: ${{ github.event.inputs.release }}\n working-directory: api/node\n run: |\n version=`pnpm pkg get version | jq -r`\n if [ \"$RELEASE_INPUT\" != \"true\" ]; then\n nightly_version_suffix=`git log -1 --format=%cd --date=\"format:%Y%m%d%H\"`\n version=\"$version-nightly.$nightly_version_suffix\"\n fi\n echo $version\n echo \"PKG_VERSION=$version\" >> $GITHUB_OUTPUT\n\n build_binaries:\n env:\n PKG_VERSION: ${{ needs.determine_version.outputs.PKG_VERSION }}\n RELEASE_INPUT: ${{ github.event.inputs.release }}\n MACOSX_DEPLOYMENT_TARGET: \"11.0\"\n strategy:\n matrix:\n include:\n - os: ubuntu-22.04\n rust-target: x86_64-unknown-linux-gnu\n napi-rs-target: linux-x64-gnu\n - os: ubuntu-22.04-arm\n rust-target: aarch64-unknown-linux-gnu\n napi-rs-target: linux-arm64-gnu\n - os: macos-14\n rust-target: aarch64-apple-darwin\n napi-rs-target: darwin-arm64\n - os: windows-2022\n rust-target: x86_64-pc-windows-msvc\n napi-rs-target: win32-x64-msvc\n msvc-arch: x64\n - os: windows-11-arm\n rust-target: aarch64-pc-windows-msvc\n napi-rs-target: win32-arm64-msvc\n msvc-arch: arm64\n needs: determine_version\n runs-on: ${{ matrix.os }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n old-ubuntu: true\n - uses: ./.github/actions/install-skia-dependencies\n - uses: ilammy/msvc-dev-cmd@v1\n if: runner.os == 'Windows'\n with:\n arch: ${{ matrix.msvc-arch }}\n - uses: ./.github/actions/setup-rust\n with:\n target: ${{ matrix.rust-target }}\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n # Setup .npmrc file to publish to npm\n - uses: actions/setup-node@v6\n with:\n node-version: \"24\"\n registry-url: \"https://registry.npmjs.org\"\n package-manager-cache: false\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - name: Set version\n working-directory: api/node\n shell: bash\n run: |\n if [ \"$RELEASE_INPUT\" != \"true\" ]; then\n pnpm version $PKG_VERSION\n fi\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: taplo-cli\n - name: Prepare feature config for binaries\n working-directory: api/node\n shell: bash\n run: |\n cat Cargo.toml | taplo format --option column_width=100000 --stdin-filepath=Cargo.toml - | \\\n perl -p -e 's,^\\s*default\\s*=.*,,' | \\\n perl -p -e 's,# binaries:\\s?,,' > Cargo.toml.new\n cat Cargo.toml.new | taplo format --stdin-filepath=Cargo.toml - > Cargo.toml\n rm Cargo.toml.new\n taplo get -f Cargo.toml features.default\n - name: Build binary\n shell: bash\n working-directory: api/node\n run: |\n pnpm install --ignore-scripts\n pnpm run build --target ${{ matrix.rust-target }}\n - name: Create package\n shell: bash\n working-directory: api/node\n run: |\n npx napi create-npm-dirs --npm-dir . -c ./binaries.json\n mv slint-ui.${{ matrix.napi-rs-target }}.node ${{ matrix.napi-rs-target }}/\n cd ${{ matrix.napi-rs-target }}/\n pnpm pkg set repository.type=git\n pnpm pkg set repository.url=https://github.com/slint-ui/slint\n pnpm pack\n - name: Upload artifact\n uses: actions/upload-artifact@v7\n with:\n name: binaries-${{ matrix.rust-target }}\n path: \"api/node/${{ matrix.napi-rs-target }}/*.tgz\"\n\n build_and_publish_npm_package:\n runs-on: ubuntu-22.04\n needs: [determine_version, build_binaries]\n env:\n PKG_VERSION: ${{ needs.determine_version.outputs.PKG_VERSION }}\n RELEASE_INPUT: ${{ github.event.inputs.release }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/setup-rust\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n # Setup .npmrc file to publish to npm\n - uses: actions/setup-node@v6\n with:\n node-version: \"24\"\n registry-url: \"https://registry.npmjs.org\"\n package-manager-cache: false\n - name: Update npm as Node 20.x might not have an new enough npm for trusted publishing\n run: npm install -g npm@latest\n - name: Set version\n working-directory: api/node\n run: |\n if [ \"$RELEASE_INPUT\" != \"true\" ]; then\n pnpm version $PKG_VERSION\n fi\n - name: Select git revision\n if: github.event.inputs.release != 'true'\n run: |\n echo \"PKG_EXTRA_ARGS=--sha1=$GITHUB_SHA\" >> $GITHUB_ENV\n echo \"PUBLISH_TAG=--tag nightly\" >> $GITHUB_ENV\n - name: Compile index.js and index.d.ts\n working-directory: api/node\n run: |\n pnpm install\n pnpm run build\n pnpm run compile\n - name: Prepare binary packages\n working-directory: api/node\n run: |\n npx napi create-npm-dirs --npm-dir . -c ./binaries.json\n - name: Download artifacts\n uses: actions/download-artifact@v8\n with:\n name: binaries-x86_64-unknown-linux-gnu\n path: api/node/\n - name: Download artifacts\n uses: actions/download-artifact@v8\n with:\n name: binaries-aarch64-unknown-linux-gnu\n path: api/node/\n - name: Download artifacts\n uses: actions/download-artifact@v8\n with:\n name: binaries-aarch64-apple-darwin\n path: api/node/\n - name: Download artifacts\n uses: actions/download-artifact@v8\n with:\n name: binaries-x86_64-pc-windows-msvc\n path: api/node/\n - name: Download artifacts\n uses: actions/download-artifact@v8\n with:\n name: binaries-aarch64-pc-windows-msvc\n path: api/node/\n - name: Add binary dependencies\n working-directory: api/node\n run: |\n for package in @slint-ui/slint-ui-binary-linux-x64-gnu @slint-ui/slint-ui-binary-linux-arm64-gnu @slint-ui/slint-ui-binary-darwin-arm64 @slint-ui/slint-ui-binary-win32-x64-msvc @slint-ui/slint-ui-binary-win32-arm64-msvc; do\n jq --arg pkg \"$package\" --arg version \"$PKG_VERSION\" '.optionalDependencies[$pkg]=$version' package.json > new.json\n mv new.json package.json\n done\n - name: Build package\n run: |\n cargo xtask node_package $PKG_EXTRA_ARGS\n - name: \"Upload npm package Artifact\"\n uses: actions/upload-artifact@v7\n with:\n name: slint-ui-node-package\n path: |\n api/node/slint-ui-${{ env.PKG_VERSION }}.tgz\n - name: Smoke test package to see if it builds at least\n run: |\n mkdir /tmp/nodetest\n cd /tmp/nodetest\n echo \"neverBuiltDependencies: []\" > pnpm-workspace.yaml\n pnpm init\n pnpm install --dangerously-allow-all-builds --verbose $GITHUB_WORKSPACE/api/node/slint-ui-$PKG_VERSION.tgz\n - name: Build and publish packages\n if: ${{ github.event.inputs.private != 'true' && (github.ref == 'refs/heads/master' || github.event.inputs.release == 'true') }}\n run: |\n pnpm publish --no-git-checks --access public $PUBLISH_TAG api/node/slint-ui-slint-ui-binary-linux-x64-gnu-$PKG_VERSION.tgz\n pnpm publish --no-git-checks --access public $PUBLISH_TAG api/node/slint-ui-slint-ui-binary-linux-arm64-gnu-$PKG_VERSION.tgz\n pnpm publish --no-git-checks --access public $PUBLISH_TAG api/node/slint-ui-slint-ui-binary-darwin-arm64-$PKG_VERSION.tgz\n pnpm publish --no-git-checks --access public $PUBLISH_TAG api/node/slint-ui-slint-ui-binary-win32-x64-msvc-$PKG_VERSION.tgz\n pnpm publish --no-git-checks --access public $PUBLISH_TAG api/node/slint-ui-slint-ui-binary-win32-arm64-msvc-$PKG_VERSION.tgz\n pnpm publish --no-git-checks $PUBLISH_TAG api/node/slint-ui-$PKG_VERSION.tgz\n" }, { "path": ".github/workflows/python_test_reusable.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Python Test (Reusable)\n\non:\n workflow_call:\n inputs:\n name:\n description: 'Name of the job'\n required: true\n type: string\n os:\n description: 'Operating system to run on'\n required: true\n type: string\n\nenv:\n DYLD_FRAMEWORK_PATH: /Users/runner/work/slint/Qt/5.15.2/clang_64/lib\n QT_QPA_PLATFORM: offscreen\n RUSTFLAGS: -D warnings\n CARGO_PROFILE_DEV_DEBUG: 0\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: full\n SLINT_BACKEND: testing\n MATURIN_PEP517_ARGS: --features backend-testing\n\njobs:\n python_test:\n name: ${{ inputs.name }}\n runs-on: ${{ inputs.os }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/setup-rust\n with:\n key: x-python-v0-${{ steps.node-install.outputs.node-version }} # the cache key consists of a manually bumpable version and the node version, as the cached rustc artifacts contain linking information where to find node.lib, which is in a versioned directory.\n - uses: actions/setup-python@v6\n with:\n python-version: \"3.12\"\n - name: Install uv\n uses: astral-sh/setup-uv@v7\n - name: Build and sync environment\n working-directory: api/python/slint\n run: uv sync\n - name: Run ty\n working-directory: api/python/slint\n run: uvx ty check\n - name: Run ruff linter\n working-directory: api/python/slint\n run: uv tool run ruff check\n - name: Run ruff linter\n working-directory: api/python/briefcase\n run: uv tool run ruff check\n - name: Run python tests\n working-directory: api/python/slint\n run: uv run pytest -s -v\n - name: Run python test driver\n run: cargo test -p test-driver-python\n" }, { "path": ".github/workflows/schedule_nightly_snapshot.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# We have a different workflow to schedule the nightly snapshot because we want to be able to run\n# it from a different branch\nname: Schedule Nightly snapshot\n\non:\n schedule:\n - cron: \"18 2 * * *\"\n\njobs:\n trigger:\n runs-on: ubuntu-latest\n strategy:\n matrix:\n branch:\n - pre-release/1.15\n - master\n\n steps:\n - uses: actions/checkout@v6\n with:\n fetch-depth: 0\n ref: ${{ matrix.branch }}\n\n - name: Check for recent commits\n id: recent\n run: |\n if git log origin/${{ matrix.branch }} --since=\"24 hours ago\" --oneline | grep .; then\n echo \"has_commits=true\" >> \"$GITHUB_OUTPUT\"\n else\n echo \"has_commits=false\" >> \"$GITHUB_OUTPUT\"\n fi\n\n - name: Trigger nightly workflow\n if: steps.recent.outputs.has_commits == 'true'\n env:\n GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: gh workflow run \"Nightly snapshot\" --ref ${{ matrix.branch }} --repo ${{ github.repository }} -f private=false\n" }, { "path": ".github/workflows/servo_example.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Servo example\n\non:\n workflow_dispatch:\n workflow_call:\n\njobs:\n matrix_build:\n strategy:\n fail-fast: false\n matrix:\n os: [ubuntu-latest, macos-latest, windows-latest]\n runs-on: ${{ matrix.os }}\n name: servo ${{ matrix.os }}\n steps:\n - uses: actions/checkout@v6\n # required for servo\n - name: Install uv\n uses: astral-sh/setup-uv@v7\n - name: Install rust\n uses: ./.github/actions/setup-rust\n - name: Install dependencies\n uses: ./.github/actions/install-linux-dependencies\n - name: Install skia dependencies\n uses: ./.github/actions/install-skia-dependencies\n - name: Build\n working-directory: examples/servo\n run: cargo build --release\n\n android_build:\n name: servo android\n runs-on: ubuntu-latest\n env:\n CARGO_INCREMENTAL: false\n CARGO_PROFILE_DEV_DEBUG: 0\n steps:\n - uses: actions/checkout@v6\n # required for servo\n - name: Install uv\n uses: astral-sh/setup-uv@v7\n - name: Install rust\n uses: ./.github/actions/setup-rust\n with:\n target: aarch64-linux-android\n - name: Install dependencies\n uses: ./.github/actions/install-linux-dependencies\n - name: Install skia dependencies\n uses: ./.github/actions/install-skia-dependencies\n # required for android\n - name: Install API level\n run: ${ANDROID_HOME}/cmdline-tools/latest/bin/sdkmanager --install \"platforms;android-30\"\n - name: Install cargo-apk\n run: cargo install cargo-apk\n - name: Build\n working-directory: examples/servo\n run: |\n export BINDGEN_EXTRA_CLANG_ARGS=\"--target=aarch64-linux-android30 --sysroot=$ANDROID_NDK_ROOT/toolchains/llvm/prebuilt/linux-x86_64/sysroot\"\n cargo apk build --target aarch64-linux-android --lib\n" }, { "path": ".github/workflows/slint_tool_binary.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Build slint-viewer or -lsp binary\n\non:\n workflow_dispatch:\n inputs:\n program:\n type: choice\n description: binary to build\n options:\n - viewer\n - lsp\n features:\n type: string\n description: features to enable for build\n # Keep in sync with features in nightly_snapshot.yaml, cpp_package.yaml,api/node/Cargo.toml, and api/python/slint/Cargo.toml\n default: \"backend-linuxkms-noseat,backend-winit,renderer-femtovg,renderer-skia,renderer-software\"\n codesign:\n type: boolean\n description: Sign binaries on macOS (false for manual builds)\n default: false\n\n workflow_call:\n inputs:\n program:\n type: string\n description: binary to build\n features:\n type: string\n description: features to enable for build\n # Keep in sync with features in nightly_snapshot.yaml, cpp_package.yaml,api/node/Cargo.toml, and api/python/slint/Cargo.toml\n default: \"backend-linuxkms-noseat,backend-winit,renderer-femtovg,renderer-skia,renderer-software\"\n codesign:\n type: boolean\n description: Sign binaries on macOS\n default: true\n secrets:\n certificate:\n description: \"certificate secret\"\n required: false\n certificate_password:\n description: \"certificate password\"\n required: false\n keychain_password:\n description: \"keychain password to use\"\n required: false\n developer_id:\n description: \"developer id to use\"\n required: false\n\nenv:\n MACOSX_DEPLOYMENT_TARGET: \"11.0\"\n\njobs:\n build_windows:\n strategy:\n matrix:\n arch: [x86_64-pc-windows-msvc, aarch64-pc-windows-msvc]\n include:\n - arch: x86_64-pc-windows-msvc\n runner: windows-2022\n package_suffix: x86_64\n - arch: aarch64-pc-windows-msvc\n runner: windows-11-arm\n package_suffix: arm64\n\n runs-on: ${{ matrix.runner}}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: ${{ matrix.arch }}\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Build\n run: cargo build --verbose --no-default-features --features ${{ github.event.inputs.features || inputs.features }} --release -p slint-${{ github.event.inputs.program || inputs.program }}\n - name: Create artifact directory\n run: |\n mkdir pkg\n cd pkg\n mkdir slint-${{ github.event.inputs.program || inputs.program }}\n cd slint-${{ github.event.inputs.program || inputs.program }}\n cp ..\\..\\target/release/slint-${{ github.event.inputs.program || inputs.program }}.exe ./\n cd ..\n cd ..\n cd tools\\${{ github.event.inputs.program || inputs.program }}\n bash -x ../../scripts/prepare_binary_package.sh ..\\..\\pkg\\slint-${{ github.event.inputs.program || inputs.program }}\n - name: Create archive\n shell: powershell\n run: |\n cd pkg\n Compress-Archive -Path slint-${{ github.event.inputs.program || inputs.program }}\\* -Destination ..\\slint-${{ github.event.inputs.program || inputs.program }}-windows-${{ matrix.package_suffix }}.zip\n - name: Upload artifact\n uses: actions/upload-artifact@v7\n with:\n name: slint-${{ github.event.inputs.program || inputs.program }}-windows-${{ matrix.package_suffix }}\n path: |\n slint-${{ github.event.inputs.program || inputs.program }}-windows-${{ matrix.package_suffix }}.zip\n\n build_linux:\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n with:\n old-ubuntu: true\n - uses: ./.github/actions/setup-rust\n with:\n target: x86_64-unknown-linux-gnu\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Build\n run: cargo build --verbose --no-default-features --features ${{ github.event.inputs.features || inputs.features }} --release -p slint-${{ github.event.inputs.program || inputs.program }}\n - name: Create artifact directory\n run: |\n mkdir -p slint-${{ github.event.inputs.program || inputs.program }}\n cp target/release/slint-${{ github.event.inputs.program || inputs.program }} slint-${{ github.event.inputs.program || inputs.program }}/\n cd tools/${{ github.event.inputs.program || inputs.program }}\n ../../scripts/prepare_binary_package.sh ../../slint-${{ github.event.inputs.program || inputs.program }}\n - name: Tar artifacts to preserve permissions\n run: tar czvf slint-${{ github.event.inputs.program || inputs.program }}-linux.tar.gz slint-${{ github.event.inputs.program || inputs.program }}\n - name: Upload artifact\n uses: actions/upload-artifact@v7\n with:\n name: slint-${{ github.event.inputs.program || inputs.program }}-linux\n path: slint-${{ github.event.inputs.program || inputs.program }}-linux.tar.gz\n\n build_linux_arm:\n runs-on: ubuntu-22.04\n strategy:\n matrix:\n target:\n - armv7-unknown-linux-gnueabihf\n - aarch64-unknown-linux-gnu\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: x86_64-unknown-linux-gnu\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cross\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Build\n run: cross build --target=${{ matrix.target }} --no-default-features --features ${{ github.event.inputs.features || inputs.features }} --release -p slint-${{ github.event.inputs.program || inputs.program }}\n - name: Create artifact directory\n run: |\n mkdir -p slint-${{ github.event.inputs.program || inputs.program }}-${{ matrix.target }}\n cp target//${{ matrix.target }}/release/slint-${{ github.event.inputs.program || inputs.program }} slint-${{ github.event.inputs.program || inputs.program }}-${{ matrix.target }}/\n cd tools/${{ github.event.inputs.program || inputs.program }}\n ../../scripts/prepare_binary_package.sh ../../slint-${{ github.event.inputs.program || inputs.program }}-${{ matrix.target }}\n - name: Tar artifacts to preserve permissions\n run: tar czvf slint-${{ github.event.inputs.program || inputs.program }}-${{ matrix.target }}.tar.gz slint-${{ github.event.inputs.program || inputs.program }}-${{ matrix.target }}\n - name: Upload artifact\n uses: actions/upload-artifact@v7\n with:\n name: slint-${{ github.event.inputs.program || inputs.program }}-${{ matrix.target }}\n path: slint-${{ github.event.inputs.program || inputs.program }}-${{ matrix.target }}.tar.gz\n\n build_macos:\n runs-on: macos-26\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: x86_64-apple-darwin\n - uses: ./.github/actions/setup-rust\n with:\n target: aarch64-apple-darwin\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: cargo-about\n version: \"=0.6.6\"\n - name: Build x86-64\n run: cargo build --verbose --target x86_64-apple-darwin --no-default-features --features ${{ github.event.inputs.features || inputs.features }} --release -p slint-${{ github.event.inputs.program || inputs.program }}\n - name: Build aarch64\n run: cargo build --verbose --target aarch64-apple-darwin --no-default-features --features ${{ github.event.inputs.features || inputs.features }} --release -p slint-${{ github.event.inputs.program || inputs.program }}\n - name: Create artifact directory\n run: |\n mkdir -p slint-${{ github.event.inputs.program || inputs.program }}\n cd slint-${{ github.event.inputs.program || inputs.program }}\n lipo -create -output ./slint-${{ github.event.inputs.program || inputs.program }} ../target/aarch64-apple-darwin/release/slint-${{ github.event.inputs.program || inputs.program }} ../target/x86_64-apple-darwin/release/slint-${{ github.event.inputs.program || inputs.program }}\n install_name_tool -add_rpath @executable_path/. ./slint-${{ github.event.inputs.program || inputs.program }}\n cd ..\n cd tools/${{ github.event.inputs.program || inputs.program }}\n ../../scripts/prepare_binary_package.sh ../../slint-${{ github.event.inputs.program || inputs.program }}\n - uses: ./.github/actions/codesign\n if: ${{ github.event.inputs.codesign == 'true' }}\n with:\n binary: slint-${{ github.event.inputs.program || inputs.program }}/slint-${{ github.event.inputs.program || inputs.program }}\n certificate: ${{ github.event.inputs.certificate }}\n certificate_password: ${{ github.event.inputs.certificate_password }}\n keychain_password: ${{ github.event.inputs.keychain_password }}\n developer_id: ${{ github.event.inputs.developer_id }}\n - name: Tar artifacts to preserve permissions\n run: tar czvf slint-${{ github.event.inputs.program || inputs.program }}-macos.tar.gz slint-${{ github.event.inputs.program || inputs.program }}\n - name: Upload artifact\n uses: actions/upload-artifact@v7\n with:\n name: slint-${{ github.event.inputs.program || inputs.program }}-macos\n path: slint-${{ github.event.inputs.program || inputs.program }}-macos.tar.gz\n" }, { "path": ".github/workflows/spellcheck.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: \"Check spelling\"\non:\n # push:\n # pull_request:\n workflow_dispatch:\n\njobs:\n spellcheck:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: streetsidesoftware/cspell-action@v8\n with:\n config: \"./cspell.json\"\n strict: false\n" }, { "path": ".github/workflows/torizon_demos.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Rust Demos built for Torizon\n\non:\n workflow_dispatch:\n inputs:\n push:\n type: boolean\n description: \"Push the built images\"\n workflow_call:\n inputs:\n push:\n type: boolean\n description: \"Push the built images\"\n\njobs:\n build_containers:\n runs-on: ubuntu-22.04\n strategy:\n matrix:\n include:\n # Default software rendering (GPU-less)\n - target: arm64\n image_arch: linux/arm64\n rust_toolchain_arch: aarch64-unknown-linux-gnu\n base_image_suffix: \"\"\n build_home_automation_sw_renderer: true\n # GPU-specific variants\n # https://developer.toradex.com/torizon/application-development/provided-containers/debian-containers-for-torizon\n - target: arm64\n image_arch: linux/arm64\n rust_toolchain_arch: aarch64-unknown-linux-gnu\n base_image_suffix: \"-imx8\"\n build_home_automation_sw_renderer: false\n - target: arm64\n image_arch: linux/arm64\n rust_toolchain_arch: aarch64-unknown-linux-gnu\n base_image_suffix: \"-am62\"\n build_home_automation_sw_renderer: false\n - target: arm64\n image_arch: linux/arm64\n rust_toolchain_arch: aarch64-unknown-linux-gnu\n base_image_suffix: \"-imx95\"\n build_home_automation_sw_renderer: false\n\n steps:\n - uses: actions/checkout@v6\n - name: Set up QEMU\n uses: docker/setup-qemu-action@v4\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v4\n - name: Login to GitHub Container Registry\n uses: docker/login-action@v4\n with:\n registry: ghcr.io\n username: ${{ github.actor }}\n password: ${{ secrets.CR_PAT }}\n - name: Build and push\n uses: docker/build-push-action@v7\n with:\n context: .\n file: ./docker/Dockerfile.torizon-demos\n push: ${{ github.event.inputs.push || inputs.push }}\n tags: ghcr.io/slint-ui/slint/torizon-demos-${{matrix.target}}${{matrix.base_image_suffix}}:latest\n platforms: ${{matrix.image_arch}}\n build-args: |\n TOOLCHAIN_ARCH=${{matrix.target}}\n IMAGE_ARCH=${{matrix.image_arch}}\n RUST_TOOLCHAIN_ARCH=${{matrix.rust_toolchain_arch}}\n BASE_NAME=wayland-base${{matrix.base_image_suffix}}\n WEATHER_API_KEY=${{secrets.WEATHER_API_KEY}}\n BUILD_HOME_AUTOMATION_SW_RENDERER=${{matrix.build_home_automation_sw_renderer}}\n" }, { "path": ".github/workflows/translations.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# Run slint-tr-extractor and msgfmt\nname: Update Translations\n\non:\n workflow_dispatch:\n\n# schedule:\n# - cron: \"0 3 * * *\"\n\njobs:\n update-translations:\n runs-on: ubuntu-latest\n env:\n CARGO_PROFILE_DEV_DEBUG: 0\n CARGO_INCREMENTAL: false\n RUST_BACKTRACE: 1\n steps:\n - name: \"install gettext tools\"\n run: sudo apt install gettext\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n\n - name: \"gallery: Run slint-tr-extractor\"\n run: find -name \\*.slint | xargs cargo run -p slint-tr-extractor -- -d gallery -o gallery.pot\n working-directory: examples/gallery\n - name: \"gallery: msgmerge and msgfmt\"\n working-directory: examples/gallery\n run: |\n for po in lang/*/LC_MESSAGES\n do msgmerge $po/gallery.po gallery.pot -o $po/gallery.po\n msgfmt $po/gallery.po -o $po/gallery.mo\n done\n\n - name: \"printerdemo: Run slint-tr-extractor\"\n run: find -name \\*.slint | xargs cargo run -p slint-tr-extractor -- -d printerdemo -o printerdemo.pot\n working-directory: demos/printerdemo\n - name: \"printerdemo: msgmerge and msgfmt\"\n working-directory: demos/printerdemo\n run: |\n for po in lang/*/LC_MESSAGES\n do msgmerge $po/printerdemo.po printerdemo.pot -o $po/printerdemo.po\n msgfmt $po/printerdemo.po -o $po/printerdemo.mo\n done\n\n - name: \"Fix license headers\"\n run: cargo xtask check_license_headers --fix-it\n\n - name: Check for interesting changes\n id: git_diff\n run: git diff --ignore-matching-lines=\"POT-Creation-Date:.*\" --exit-code --quiet HEAD\n continue-on-error: true\n\n - name: commit\n # Only run this if there was a diff!\n if: steps.git_diff.outcome == 'failure'\n run: |\n git config --global user.email \"noreply@slint.dev\"\n git config --global user.name \"Update Translations Bot\"\n git add examples\n git commit -a -m 'Update Translations: extract strings'\n - name: Result\n # Only run this if there was a diff!\n run: if [ '${{ steps.git_diff.outcome }}' = 'failure' ]; then echo \"I committed this change to git:\"; git show ; else echo \"This change was ignored:\" ; git diff HEAD ; fi\n - name: Push changes\n uses: ad-m/github-push-action@master\n with:\n branch: ${{ github.ref }}\n" }, { "path": ".github/workflows/tree_sitter.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: \"Tree Sitter Test\"\non:\n # push:\n # pull_request:\n workflow_call:\n inputs:\n tag:\n type: string\n description: tree sitter release tag to use\n latest:\n type: boolean\n description: Use the latest tree-sitter release\n default: true\n\njobs:\n tree-sitter-tests:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n with:\n fetch-depth: 0\n - uses: robinraju/release-downloader@v1.12\n with:\n repository: \"tree-sitter/tree-sitter\"\n tag: ${{ inputs.tag }}\n latest: ${{ inputs.latest }}\n fileName: \"tree-sitter-linux-x64.gz\"\n out-file-path: ${{ runner.workspace }}\n - name: Extract tree-sitter-cli\n run: |\n gunzip tree-sitter-linux-x64.gz\n chmod 755 tree-sitter-linux-x64\n mv tree-sitter-linux-x64 tree-sitter\n working-directory: ${{ runner.workspace }}\n - name: Generate tree-sitter corpus\n run: find ../../tests/cases -type d -exec ./test-to-corpus.py --tests-directory {} \\;\n working-directory: editors/tree-sitter-slint\n - name: Generate tree-sitter parser\n run: ${{ runner.workspace }}/tree-sitter generate\n working-directory: editors/tree-sitter-slint\n - name: Run tree-sitter tests\n run: ${{ runner.workspace }}/tree-sitter test -u\n working-directory: editors/tree-sitter-slint\n - name: Check for parse ERRORs from tree-sitter\n run: sh -c \"! grep -q ERROR corpus/*.txt\"\n working-directory: editors/tree-sitter-slint\n" }, { "path": ".github/workflows/upgrade_version.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Upgrade Version Number\n\non:\n workflow_dispatch:\n inputs:\n new_version:\n description: \"The new version number\"\n required: true\n\njobs:\n upgrade_version_number:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - name: Do replacements\n run: |\n # Each Cargo.toml need to have the version updated\n git ls-files | grep Cargo.toml | grep -v helper_crates | xargs sed -i 's/^version = \"[0-9]*\\.[0-9]*\\.[0-9]*\"/version = \"${{ github.event.inputs.new_version }}\"/'\n # Each dependencies in cargo.toml\n git ls-files | grep Cargo.toml | xargs sed -i 's/\\(slint.*version = \\)\"=[0-9]*\\.[0-9]*\\.[0-9]*\"/\\1\"=${{ github.event.inputs.new_version }}\"/'\n\n # Update the version in CmakeLists.txt\n sed -i 's/ VERSION [0-9]*\\.[0-9]*\\.[0-9]*)$/ VERSION ${{ github.event.inputs.new_version }})/' api/cpp/CMakeLists.txt\n\n # The version is also in these files\n sed -i \"s/^version = \\\"[0-9]*\\.[0-9]*\\.[0-9]*\\(.*\\)\\\"/version = \\\"${{ github.event.inputs.new_version }}\\1\\\"/\" api/cpp/docs/conf.py api/python/slint/pyproject.toml api/python/briefcase/pyproject.toml tools/compiler/pyproject.toml editors/zed/extension.toml\n\n # Version in package.json files\n git ls-files | grep package.json | xargs sed -i 's/\"version\": \".*\"/\"version\": \"${{ github.event.inputs.new_version }}\"/'\n # Update version in Node.js binary package config\n sed -i 's/\"version\": \".*\"/\"version\": \"${{ github.event.inputs.new_version }}\"/' api/node/binaries.json\n\n # VersionCheck\n sed -i \"s/VersionCheck_[0-9]*_[0-9]*_[0-9]*;/VersionCheck_`echo ${{ github.event.inputs.new_version }} | sed \"s/\\([0-9]*\\)\\.\\([0-9]*\\).\\([0-9]*\\)/\\1/\"`_`echo ${{ github.event.inputs.new_version }} | sed \"s/\\([0-9]*\\)\\.\\([0-9]*\\).\\([0-9]*\\)/\\2/\"`_`echo ${{ github.event.inputs.new_version }} | sed \"s/\\([0-9]*\\)\\.\\([0-9]*\\).\\([0-9]*\\)/\\3/\"`;/\" api/rs/slint/lib.rs\n\n # Version in the AboutSlint widget\n sed -i \"s/Version [0-9]*\\.[0-9]*\\.[0-9]*\\\\\\\\n/Version ${{ github.event.inputs.new_version }}\\\\\\\\n/\" internal/compiler/widgets/common/about-slint.slint\n\n # Version in the docs (cargo add slint@):\n git ls-files | grep \"\\(^\\|/\\)docs/.*\\.\\(md\\|rst\\)\\$\" | xargs sed -i 's/slint@[0-9]\\+\\.[0-9]\\+\\.[0-9]\\+/slint@${{ github.event.inputs.new_version }}/'\n\n # Version in esp-idf component\n sed -i 's/^version: \"[0-9]*\\.[0-9]*\\.[0-9]*.*\"/version: \"${{ github.event.inputs.new_version }}\"/' api/cpp/esp-idf/slint/idf_component.yml\n sed -i 's/GIT_TAG v[0-9]*\\.[0-9]*\\.[0-9]*/GIT_TAG v${{ github.event.inputs.new_version }}/' api/cpp/esp-idf/slint/CMakeLists.txt\n sed -i 's/find_package(Slint [0-9]*\\.[0-9]*\\.[0-9]*)/find_package(Slint ${{ github.event.inputs.new_version }})/' api/cpp/esp-idf/slint/CMakeLists.txt\n\n # Version in the Android docs\n sed -i 's/^slint = { version = \"[^\"]+\"/slint = { version = \"${{ github.event.inputs.new_version }}\"/' docs/astro/src/content/docs/guide/platforms/mobile/android.mdx\n\n # Some documentation use the ~syntax\n sed -i 's/\\(slint.*version = \\)\"~[0-9]*\\.[0-9]*\"/\\1\"~'\"$(echo ${{ github.event.inputs.new_version }} | sed 's/\\([0-9]*\\.[0-9]*\\)\\.[0-9]*/\\1/')\"'\"/' api/rs/slint/Cargo.toml api/rs/slint/lib.rs\n\n echo \"Note that the version is not updated in the documentation and README yet\"\n\n - name: Commit\n run: |\n git config --global user.email \"${GITHUB_ACTOR}@users.noreply.github.com\"\n git config --global user.name \"${GITHUB_ACTOR}\"\n git commit -a --message \"Bump version number to ${{ github.event.inputs.new_version }}\"\n - name: Result\n run: |\n git diff\n\n - name: Push changes\n uses: ad-m/github-push-action@master\n with:\n branch: wip/version-bump\n\n # update https://releases.slint.dev/versions.json\n update_versions_json:\n runs-on: ubuntu-latest\n if: github.ref == 'refs/heads/master'\n steps:\n - name: Generate a token\n id: app-token\n uses: actions/create-github-app-token@v3\n with:\n app-id: ${{ vars.READ_WRITE_APP_ID }}\n private-key: ${{ secrets.READ_WRITE_PRIVATE_KEY }}\n repositories: www-releases\n - name: Clone www-releases directory\n uses: actions/checkout@v6\n with:\n repository: slint-ui/www-releases\n sparse-checkout: |\n releases/versions.json\n path: www-releases\n token: ${{ steps.app-token.outputs.token }}\n - name: Update version in versions.json\n run: |\n sed -i '0,/\"version\": \"[0-9]\\+\\.[0-9]\\+\\.[0-9]\\+\"/s//\"version\": \"${{ github.event.inputs.new_version }}\"/' www-releases/releases/versions.json\n - name: Adjust redirections\n run: |\n sed -i \"/\\/[0-9]*\\.[0-9]*\\.[0-9]*\\/* https:\\/\\/snapshots\\.slint\\.dev\\/master\\/:splat/ s/[0-9]*\\.[0-9]*\\.[0-9]*/${{ github.event.inputs.new_version }}/\" www-releases/releases/_redirects\n - name: Get GitHub App User ID\n id: get-user-id\n run: echo \"user-id=$(gh api \"/users/${{ steps.app-token.outputs.app-slug }}[bot]\" --jq .id)\" >> \"$GITHUB_OUTPUT\"\n env:\n GH_TOKEN: ${{ steps.app-token.outputs.token }}\n - name: commit and push\n working-directory: ./www-releases\n run: |\n git config user.name '${{ steps.app-token.outputs.app-slug }}[bot]'\n git config user.email '${{ steps.get-user-id.outputs.user-id }}+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com>'\n git add .\n git add -u .\n git commit --message \"Update $NAME from $GITHUB_REPOSITORY\" --message \"Update versions.json\"\n git push\n" }, { "path": ".github/workflows/upload_esp_idf_component.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Upload component to ESP-IDF component registry\n\non:\n workflow_dispatch:\n inputs:\n private:\n type: boolean\n default: true\n required: false\n description: \"Private build? True means artifacts are only built. False means the artefacts are published to components.espressif.com\"\n release:\n type: boolean\n default: false\n required: false\n description: \"Release? Uploads to esp-idf component registry as release if true; otherwise as slint/slint-nightly\"\n\njobs:\n upload_components:\n runs-on: ubuntu-22.04\n container: espressif/idf:latest\n steps:\n - uses: actions/checkout@v6\n - run: apt-get update && apt-get install -y yq\n - name: Make subsequent git calls work\n run: git config --global --add safe.directory '*'\n - name: Extract Version and determine name\n working-directory: api/cpp/esp-idf/slint\n id: version\n env:\n RELEASE_INPUT: ${{ github.event.inputs.release }}\n run: |\n version=$(grep -oP '(?<=GIT_TAG v)[0-9]+\\.[0-9]+\\.[0-9]+' CMakeLists.txt)\n if [[ -z \"$version\" ]]; then\n echo \"Version not found\"\n exit 1\n fi\n if [ \"$RELEASE_INPUT\" != \"true\" ]; then\n echo \"PKG_NAME=slint-nightly\" >> $GITHUB_OUTPUT\n nightly_version_suffix=`git log -1 --format=%cd --date=\"format:%Y%m%d%H\"`\n version=\"$version+nightly.$nightly_version_suffix\"\n git show HEAD:./idf_component.yml | yq -y --arg nightly_version \"${version}\" '.version = $nightly_version' > idf_component.yml\n sed -i 's/GIT_TAG v[0-9]*\\.[0-9]*\\.[0-9]*/GIT_TAG ${{ github.sha }}/' CMakeLists.txt\n sed -i '1iset(SLINT_NIGHTLY true)' CMakeLists.txt\n else\n echo \"PKG_NAME=slint\" >> $GITHUB_OUTPUT\n fi\n echo \"VERSION=$version\" >> $GITHUB_OUTPUT\n - name: Remove use of nightly version\n if: github.event.inputs.release == 'true'\n working-directory: api/cpp/esp-idf/slint\n run: |\n sed -i \"s/find_package(Slint)/find_package(Slint ${{ steps.version.outputs.VERSION }})/g\" CMakeLists.txt\n - name: Upload component\n uses: espressif/upload-components-ci-action@v2\n with:\n namespace: \"slint\"\n api_token: ${{ secrets.ESP_IDF_COMPONENTS_TOKEN }}\n components: ${{ steps.version.outputs.PKG_NAME }}:api/cpp/esp-idf/slint\n dry_run: ${{ github.event.inputs.private == 'true' }}\n - name: Package component\n if: github.event.inputs.release != 'true'\n working-directory: \"api/cpp/esp-idf/slint\"\n run: |\n . ${IDF_PATH}/export.sh\n compote component pack --name ${{ steps.version.outputs.PKG_NAME }}\n - name: Archive component\n if: github.event.inputs.release != 'true'\n uses: actions/upload-artifact@v7\n with:\n path: \"api/cpp/esp-idf/slint/dist/*\"\n\n" }, { "path": ".github/workflows/upload_pypi.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Upload component to Python Package Index\n\non:\n workflow_dispatch:\n inputs:\n release:\n type: boolean\n default: false\n required: false\n description: \"Release? If false, publish to test.pypi.org, if true, publish to pypi.org\"\n\njobs:\n build_binaries:\n env:\n MACOSX_DEPLOYMENT_TARGET: \"11.0\"\n strategy:\n matrix:\n platform:\n - runner: windows-latest\n target: x64\n container: auto\n# Pending https://github.com/actions/partner-runner-images/issues/85\n# - runner: windows-11-arm\n# target: aarch64\n# container: auto\n - runner: macos-14\n target: aarch64\n container: auto\n - runner: ubuntu-22.04\n target: x86_64\n container: auto\n - runner: ubuntu-22.04\n target: aarch64\n container: \"ghcr.io/slint-ui/slint/aarch64-unknown-linux-gnu\"\n - runner: ubuntu-22.04\n target: armv7\n container: \"ghcr.io/slint-ui/slint/armv7-unknown-linux-gnueabihf\"\n runs-on: ${{ matrix.platform.runner }}\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n if: runner.os == 'Linux'\n - uses: actions/setup-python@v6\n with:\n python-version: '3.12'\n - uses: ./.github/actions/setup-rust\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: taplo-cli\n - name: Prepare feature config for binaries\n working-directory: api/python/slint\n shell: bash\n run: |\n cat Cargo.toml | taplo format --option column_width=100000 --stdin-filepath=Cargo.toml - | \\\n perl -p -e 's,^\\s*default\\s*=.*,,' | \\\n perl -p -e 's,# binaries:\\s?,,' > Cargo.toml.new\n cat Cargo.toml.new | taplo format --stdin-filepath=Cargo.toml - > Cargo.toml\n rm Cargo.toml.new\n taplo get -f Cargo.toml features.default\n\n - name: Build a binary wheel\n uses: PyO3/maturin-action@v1\n with:\n working-directory: api/python/slint\n target: ${{ matrix.platform.target }}\n args: --release --out wheelhouse --find-interpreter\n container: ${{ matrix.platform.container }}\n - name: Store the distribution packages\n uses: actions/upload-artifact@v7\n with:\n name: python-package-distributions-${{ matrix.platform.runner }}-${{ strategy.job-index }}\n path: api/python/slint/wheelhouse/*.whl\n\n ios_binaries:\n strategy:\n matrix:\n target:\n - aarch64-apple-ios-sim\n - aarch64-apple-ios\n include:\n - target: aarch64-apple-ios-sim\n sim_suffix: SIM_\n python_sim_suffix: _x86_64-simulator\n arch: arm64\n sdk_name: iphonesimulator\n tag: ios_13_0_arm64_iphonesimulator\n - target: aarch64-apple-ios\n arch: arm64\n sdk_name: iphoneos\n tag: ios_13_0_arm64_iphoneos\n\n runs-on: macos-14\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n with:\n target: aarch64-apple-ios\n - uses: actions/setup-python@v6\n with:\n python-version: '3.13'\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: taplo-cli\n - name: Prepare feature config for binaries\n working-directory: api/python/slint\n shell: bash\n run: |\n cat Cargo.toml | taplo format --option column_width=100000 --stdin-filepath=Cargo.toml - | \\\n perl -p -e 's,^\\s*default\\s*=.*,,' | \\\n perl -p -e 's,# binaries:\\s?,,' > Cargo.toml.new\n cat Cargo.toml.new | taplo format --stdin-filepath=Cargo.toml - > Cargo.toml\n rm Cargo.toml.new\n taplo get -f Cargo.toml features.default\n\n - run: |\n export GIT_LFS_SKIP_SMUDGE=1\n git clone https://github.com/beeware/mobile-forge.git\n cd mobile-forge\n source ./setup-iOS.sh 3.13\n PYTHONDIR=\"$PWD/support/3.13/iOS/Python.xcframework/ios-arm64${{ matrix.python_sim_suffix}}\"\n echo PYTHONDIR=\"$PYTHONDIR\" >> $GITHUB_ENV\n OSX_SDKROOT=$(xcrun --sdk macosx --show-sdk-path)\n echo \"OSX_SDKROOT=$OSX_SDKROOT\" >> $GITHUB_ENV\n IOS_SDKROOT=$(xcrun --sdk ${{ matrix.sdk_name }} --show-sdk-path)\n echo \"IOS_SDKROOT=$IOS_SDKROOT\" >> $GITHUB_ENV\n echo \"PYO3_CROSS_PYTHON_VERSION=3.13\" >> $GITHUB_ENV\n echo \"SDKROOT=$OSX_SDKROOT\" >> $GITHUB_ENV\n echo \"PYO3_CROSS_LIB_DIR=$PYTHONDIR\" >> $GITHUB_ENV\n echo CARGO_TARGET_AARCH64_APPLE_IOS_${{ matrix.sim_suffix }}RUSTFLAGS=\"-C link-arg=-isysroot -C link-arg=$IOS_SDKROOT -C link-arg=-arch -C link-arg=${{ matrix.arch }} -C link-arg=-miphoneos-version-min=14.0 -C link-arg=-F -C link-arg=$PYTHONDIR -C link-arg=-framework\t-C link-arg=Python\" >> $GITHUB_ENV\n\n - name: Build a binary wheel\n uses: PyO3/maturin-action@v1\n env:\n _PYTHON_HOST_PLATFORM: ${{ matrix.tag }}\n with:\n working-directory: api/python/slint\n target: ${{ matrix.target }}\n args: --release --out wheelhouse --interpreter 3.13\n\n - name: Store the distribution packages\n uses: actions/upload-artifact@v7\n with:\n name: python-package-distributions-${{ matrix.target }}\n path: api/python/slint/wheelhouse/*.whl\n\n build_source_package:\n name: Build source package\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: baptiste0928/cargo-install@v3\n with:\n crate: taplo-cli\n - name: Prepare feature config for binaries\n working-directory: api/python/slint\n shell: bash\n run: |\n cat Cargo.toml | taplo format --option column_width=100000 --stdin-filepath=Cargo.toml - | \\\n perl -p -e 's,^\\s*default\\s*=.*,,' | \\\n perl -p -e 's,# binaries:\\s?,,' > Cargo.toml.new\n cat Cargo.toml.new | taplo format --stdin-filepath=Cargo.toml - > Cargo.toml\n rm Cargo.toml.new\n taplo get -f Cargo.toml features.default\n - name: Build source package\n uses: PyO3/maturin-action@v1\n with:\n working-directory: api/python/slint\n command: sdist\n args: --out dist\n - uses: actions/upload-artifact@v7\n with:\n name: python-package-distributions-source\n path: api/python/slint/dist/*.tar.gz\n\n publish-to-test-pypi:\n if: ${{ github.event.inputs.release != 'true' }}\n name: >-\n Publish Python 🐍 distribution 📦 to Test PyPI\n needs: [build_binaries, ios_binaries, build_source_package]\n runs-on: ubuntu-latest\n environment:\n name: testpypi\n url: https://test.pypi.org/p/slint\n permissions:\n id-token: write # IMPORTANT: mandatory for trusted publishing\n steps:\n - uses: actions/download-artifact@v8\n with:\n pattern: python-package-distributions-*\n path: dist\n merge-multiple: true\n - name: Publish distribution 📦 to Test PyPI\n uses: pypa/gh-action-pypi-publish@release/v1\n with:\n repository-url: https://test.pypi.org/legacy/\n\n publish-to-pypi:\n if: ${{ github.event.inputs.release == 'true' }}\n name: >-\n Publish Python 🐍 distribution 📦 to PyPI\n needs: [build_binaries, ios_binaries, build_source_package]\n runs-on: ubuntu-latest\n environment:\n name: pypi\n url: https://test.pypi.org/p/slint\n permissions:\n id-token: write # IMPORTANT: mandatory for trusted publishing\n steps:\n - uses: actions/download-artifact@v8\n with:\n pattern: python-package-distributions-*\n path: dist\n merge-multiple: true\n - name: Publish distribution 📦 to PyPI\n uses: pypa/gh-action-pypi-publish@release/v1\n with:\n verbose: true\n\n" }, { "path": ".github/workflows/upload_pypi_briefcase.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Upload briefcasex-slint to Python Package Index\n\non:\n workflow_dispatch:\n inputs:\n release:\n type: boolean\n default: false\n required: false\n description: \"Release? If false, publish to test.pypi.org, if true, publish to pypi.org\"\n\njobs:\n\n build_source_package:\n name: Build source package\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - name: Install uv\n uses: astral-sh/setup-uv@v7\n - name: Build source package\n working-directory: api/python/briefcase\n run: uv build --sdist\n - uses: actions/upload-artifact@v7\n with:\n name: python-package-distributions-source\n path: api/python/briefcase/dist/*.tar.gz\n\n publish-to-test-pypi:\n if: ${{ github.event.inputs.release != 'true' }}\n name: >-\n Publish Python 🐍 distribution 📦 to Test PyPI\n needs: [build_source_package]\n runs-on: ubuntu-latest\n environment:\n name: testpypi\n url: https://test.pypi.org/p/briefcasex-slint\n permissions:\n id-token: write # IMPORTANT: mandatory for trusted publishing\n steps:\n - uses: actions/download-artifact@v8\n with:\n pattern: python-package-distributions-*\n path: dist\n merge-multiple: true\n - name: Publish distribution 📦 to Test PyPI\n uses: pypa/gh-action-pypi-publish@release/v1\n with:\n repository-url: https://test.pypi.org/legacy/\n\n publish-to-pypi:\n if: ${{ github.event.inputs.release == 'true' }}\n name: >-\n Publish Python 🐍 distribution 📦 to PyPI\n needs: [build_source_package]\n runs-on: ubuntu-latest\n environment:\n name: pypi\n url: https://test.pypi.org/p/briefcasex-slint\n permissions:\n id-token: write # IMPORTANT: mandatory for trusted publishing\n steps:\n - uses: actions/download-artifact@v8\n with:\n pattern: python-package-distributions-*\n path: dist\n merge-multiple: true\n - name: Publish distribution 📦 to PyPI\n uses: pypa/gh-action-pypi-publish@release/v1\n with:\n verbose: true\n\n" }, { "path": ".github/workflows/upload_pypi_slint_compiler.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Upload slint-compiler to Python Package Index\n\non:\n workflow_dispatch:\n inputs:\n release:\n type: boolean\n default: false\n required: false\n description: \"Release? If false, publish to test.pypi.org, if true, publish to pypi.org\"\n\njobs:\n build-wheels:\n name: Build wheels on ${{ matrix.os }}\n runs-on: ${{ matrix.os }}\n strategy:\n fail-fast: false\n matrix:\n os:\n [\n ubuntu-22.04,\n ubuntu-22.04-arm,\n windows-2022,\n windows-11-arm,\n macos-14,\n ]\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/setup-rust\n - name: Build wheels\n uses: PyO3/maturin-action@v1\n with:\n working-directory: tools/compiler\n args: --release --out wheelhouse --find-interpreter\n - uses: actions/upload-artifact@v7\n with:\n name: wheels-${{ matrix.os }}\n path: tools/compiler/wheelhouse/*.whl\n\n build-sdist:\n name: Build source distribution\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: astral-sh/setup-uv@v7\n - name: Build sdist\n run: uv build --sdist -o dist tools/compiler\n - uses: actions/upload-artifact@v7\n with:\n name: sdist\n path: dist/*.tar.gz\n\n publish-to-test-pypi:\n if: ${{ github.event.inputs.release != 'true' }}\n needs: [build-wheels, build-sdist]\n runs-on: ubuntu-latest\n environment:\n name: testpypi\n url: https://test.pypi.org/p/slint-compiler\n permissions:\n id-token: write\n steps:\n - uses: astral-sh/setup-uv@v7\n - uses: actions/download-artifact@v8\n with:\n pattern: wheels-*\n path: dist\n merge-multiple: true\n - uses: actions/download-artifact@v8\n with:\n name: sdist\n path: dist\n - name: Publish to Test PyPI\n env:\n UV_PUBLISH_URL: https://test.pypi.org/legacy/\n run: uv publish dist/*\n\n publish-to-pypi:\n if: ${{ github.event.inputs.release == 'true' }}\n needs: [build-wheels, build-sdist]\n runs-on: ubuntu-latest\n environment:\n name: pypi\n url: https://pypi.org/p/slint-compiler\n permissions:\n id-token: write\n steps:\n - uses: astral-sh/setup-uv@v7\n - uses: actions/download-artifact@v8\n with:\n pattern: wheels-*\n path: dist\n merge-multiple: true\n - uses: actions/download-artifact@v8\n with:\n name: sdist\n path: dist\n - name: Publish to PyPI\n run: uv publish dist/*\n" }, { "path": ".github/workflows/wasm_demos.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nname: Build wasm demos\n\non:\n workflow_dispatch:\n workflow_call:\n inputs:\n build_artifacts:\n type: boolean\n required: true\n description: True if we should build all demos and produce artefacts\n\njobs:\n wasm_demo:\n env:\n CARGO_PROFILE_RELEASE_OPT_LEVEL: s\n CARGO_INCREMENTAL: false\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - uses: ./.github/actions/setup-rust\n with:\n target: wasm32-unknown-unknown\n - name: Install wasm-pack\n run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh\n - name: Printerdemo WASM build\n run: |\n sed -i \"s/#wasm# //\" Cargo.toml\n wasm-pack build --release --target web\n working-directory: demos/printerdemo/rust\n - name: Gallery WASM build\n if: ${{ inputs.build_artifacts }}\n run: |\n sed -i \"s/#wasm# //\" Cargo.toml\n export SLINT_STYLE=fluent && wasm-pack build --release --out-dir pkg/fluent --target web\n export SLINT_STYLE=material && wasm-pack build --release --out-dir pkg/material --target web\n export SLINT_STYLE=cupertino && wasm-pack build --release --out-dir pkg/cupertino --target web\n export SLINT_STYLE=cosmic && wasm-pack build --release --out-dir pkg/cosmic --target web\n working-directory: examples/gallery\n - name: Remaining wasm demos\n if: ${{ inputs.build_artifacts }}\n run: |\n for demo in demos/printerdemo/rust demos/usecases/rust examples/todo/rust examples/todo-mvc/rust examples/carousel/rust examples/slide_puzzle examples/memory examples/imagefilter/rust examples/plotter examples/opengl_underlay demos/home-automation/rust examples/speedometer/rust; do\n pushd $demo\n sed -i \"s/#wasm# //\" Cargo.toml\n wasm-pack build --release --target web\n popd\n done\n - name: Energy Monitor example WASM build\n if: ${{ inputs.build_artifacts }}\n run: |\n sed -i \"s/#wasm# //\" Cargo.toml\n wasm-pack build --release --target web --no-default-features --features slint/default,chrono\n working-directory: demos/energy-monitor\n - name: Weather Demo example WASM build\n run: |\n sed -i \"s/#wasm# //\" Cargo.toml\n wasm-pack build --release --target web --no-default-features --features slint/default,chrono\n working-directory: demos/weather-demo\n - name: \"Upload Demo Artifacts\"\n if: ${{ inputs.build_artifacts }}\n uses: actions/upload-artifact@v7\n with:\n name: wasm_demo\n path: |\n examples/gallery/\n demos/printerdemo/rust/\n examples/todo/\n examples/todo-mvc/rust/\n examples/carousel/rust/\n examples/memory/\n examples/slide_puzzle/\n examples/speedometer/rust/\n examples/imagefilter/rust\n examples/plotter/\n examples/opengl_underlay/\n demos/energy-monitor/\n demos/home-automation/rust\n demos/weather-demo/\n demos/usecases/rust\n !/**/.gitignore\n - name: Clean cache # Otherwise the cache is much too big\n run: |\n du -hs target\n rm -rf target/*/incremental\n rm -rf target/*/*/*slint*\n du -hs target\n" }, { "path": ".github/workflows/wasm_editor_and_interpreter.yaml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n---\nname: Build and test the slintpad and required WASM binaries\n\non:\n workflow_dispatch:\n workflow_call:\n\njobs:\n wasm:\n env:\n CARGO_PROFILE_RELEASE_OPT_LEVEL: s\n CARGO_INCREMENTAL: false\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: ./.github/actions/install-linux-dependencies\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n - uses: ./.github/actions/setup-rust\n with:\n target: wasm32-unknown-unknown\n - name: Install wasm-pack\n run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh\n\n - name: Compile slint-wasm-interpreter\n run: wasm-pack build --release --target web -- --features console_error_panic_hook\n working-directory: api/wasm-interpreter\n\n - name: Build slint-wasm-lsp\n env:\n SLINT_STYLE: fluent-light\n run: pnpm build:wasm_lsp-release\n working-directory: tools/slintpad\n\n - name: \"Upload wasm Artifacts\"\n uses: actions/upload-artifact@v7\n with:\n name: wasm\n path: |\n api/wasm-interpreter/pkg/\n tools/lsp/pkg/\n\n build-slintpad:\n needs: [wasm]\n runs-on: ubuntu-22.04\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n package-manager-cache: false\n - uses: pnpm/action-setup@v4.4.0\n with:\n version: 10.29.3\n - name: Download wasm_lsp Artifacts\n uses: actions/download-artifact@v8\n with:\n name: wasm\n - name: Install NPM dependencies\n run: pnpm install --frozen-lockfile\n working-directory: tools/slintpad\n - name: Install playwright dependencies\n run: pnpm exec playwright install --with-deps\n working-directory: tools/slintpad\n - name: Compile slintpad\n run: pnpm build\n working-directory: tools/slintpad\n - name: Smoke-Test slintpad\n run: pnpm exec playwright test\n working-directory: tools/slintpad\n - name: Publish Test Summary Results\n if: ${{ always() }}\n working-directory: tools/slintpad\n run: npx github-actions-ctrf playwright-report/ctrf-report.json\n - name: \"Upload slintpad Artifacts\"\n uses: actions/upload-artifact@v7\n with:\n name: slintpad\n path: tools/slintpad/dist/\n\n # test-slintpad-ff:\n # needs: [wasm, build-slintpad]\n # runs-on: ubuntu-latest\n # container:\n # image: cypress/browsers:node16.13.0-chrome95-ff94\n # options: --user 1001\n #\n # steps:\n # - uses: actions/checkout@v6\n # - uses: ./.github/actions/test-slintpad\n # with:\n # browser: \"firefox\"\n # wasm-binaries: wasm\n # slintpad-artifact: slintpad\n #\n # test-slintpad-chrome:\n # needs: [wasm, build-slintpad]\n # runs-on: ubuntu-latest\n # container:\n # image: cypress/browsers:node16.13.0-chrome95-ff94\n # options: --user 1001\n #\n # steps:\n # - uses: actions/checkout@v6\n # - uses: ./.github/actions/test-slintpad\n # with:\n # browser: \"chrome\"\n # wasm-binaries: wasm\n # slintpad-artifact: slintpad\n" }, { "path": ".gitignore", "content": "# The servo example requires a lock file as servo only builds with pinned dependencies.\n!examples/servo/Cargo.lock\ntsconfig.tsbuildinfo\n/target\nnode_modules\n/tools/figma_import/target\n/tools/figma_import/figma_output\n*.code-workspace\n/build\n/build-release\n/_deps\n.DS_Store\nPipfile.lock\n/docs/astro/src/content/collections/enums/\n/docs/astro/src/content/collections/structs/\n/playwright-report\nglobal-structs-enums.mdx\n\n# Ignore all package-lock.json files\n**/package-lock.json\n# But keep these specific ones\n!editors/vscode/package-lock.json\n\n# MISE local files:\n/.mise.local.toml\n/.mise/tasks/local/\n\n\n*.node\n*.d.ts\n\n__pycache__\n.cache\nuv.lock\n.python-version\n\nMODULE.bazel.lock\n" }, { "path": ".mailmap", "content": "Aurindam Jana \nFlorian Blasius \nOlivier Goffart \nOlivier Goffart \nOlivier Goffart \nOlivier Goffart \nSimon Hausmann \nSimon Hausmann \nSimon Hausmann \nTobias Hunger \nTobias Hunger \nTobias Hunger \n\n\n\n" }, { "path": ".mise/config.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# cspell:ignore pipx\n[tools]\n\n## C++:\n\"ubi:EmbarkStudios/cargo-about\" = \"0.6.6\"\n\"pipx:cmake\" = \"4.0.0\"\n\"pipx:ninja\" = \"1.11.1.4\"\n\"pipx:pipenv\" = \"2025.0.2\"\n# doxygen = \"1.13.2\" ## This is not available anywhere\n# graphviz = \"12.2.1\" ## This is not available anywhere\n\n\"ubi:sharkdp/fd\" = \"10.2.0\"\n\"rust\" = { version = \"stable\", profile = \"default\" }\nnode = \"24\"\npnpm = \"10.29.3\"\ntaplo = \"0.9.3\"\n\"ubi:drager/wasm-pack\" = \"0.13.1\"\nuv = \"0.10.4\"\n\n[task_config]\nincludes = [\".mise/tasks.toml\", \".mise/tasks\"]\n" }, { "path": ".mise/tasks/fix/text/trailing_spaces", "content": "#!/usr/bin/env bash\n# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#MISE description=\"Run trailing WS fix on all files\"\n\nset -e\n\nif [[ \"$OSTYPE\" == \"darwin\"* ]]; then\n SED_INPLACE=\"sed -i ''\"\nelse\n SED_INPLACE=\"sed -i\"\nfi\n\nif test -f .git/HEAD ; then\n git grep -I -l -O\"$SED_INPLACE \\\"s/[[:space:]]*$//\\\"\" -e '' -- ':!*.patch'\nelse\n while IFS= read -r -d '' -u 9\n do\n if [[ \"$(file -bs --mime-type -- \"$REPLY\")\" = text/* ]]\n then\n $SED_INPLACE \"s/[[:space:]]*$//\" -- \"$REPLY\"\n fi\n done 9< <(fd -0)\nfi\n" }, { "path": ".mise/tasks/lint/legal/reuse", "content": "#!/usr/bin/env bash\n# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#MISE description=\"Run xtask check reuse compliance on all files\"\n#MISE tools={ \"pipx:reuse\" = \"6\" }\n\nset -e\n\nif test -d \"target\" ; then\n if test -n \"$CI\" ; then\n echo \"ERROR: Directory is not clean in CI run, NOT running reuse\"\n exit 1\n else\n echo \"Warning: Directory is not clean, not running reuse\"\n exit 0\n fi\nfi\n\ncargo xtask check_reuse_compliance\n" }, { "path": ".mise/tasks.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# Use https://mise.jdx.dev/schema/mise-task.json for validation.\n\n### fixes\n\n[\"fix:cpp:format\"]\ndescription = \"Run clang format fix on all C++ files\"\nrun = '''fd '.*\\.(h|H|hpp|hxx|h\\+\\+|c|C|cpp|cxx|c\\+\\+)$' -0 | xargs -0 clang-format -i'''\ntools = { \"pipx:clang-format\" = \"20.1.3\" }\n\n[\"fix:rust:lockfile\"]\ndescription = \"Update the lockfile (if absolutely necessary)\"\n# Use cargo build -p xtask to test if the lockfile needs upating.\n# The fix:legal:copyright task needs the xtask anyhow, so this has a double use.\nrun = \"cargo build --locked -p xtask || (echo \\\"### Updating Lockfile! ###\\\" && cargo update)\"\n\n[\"fix:legal:copyright\"]\ndescription = \"Run the check_license_headers --fix xtask\"\nrun = \"cargo xtask check_license_headers --fix-it\"\ndepends = [\"fix:rust:lockfile\"]\n\n[\"fix:python:format\"]\ndescription = \"Run ruff format\"\n# Run via uv as the ruff installation via mise is unreliable in the CI.\n# It keeps failing to find ruff, despite saying that it was installed.\nrun = \"uv tool run ruff@0.11.8 format\"\n\n[\"fix:rust:format\"]\ndescription = \"Run cargo fmt --all\"\nrun = \"cargo fmt --all\"\n\n[\"fix:rust:format:root\"]\ndescription = \"Run cargo fmt --all\"\nrun = \"cargo fmt --all\"\ndir = \".\"\n\n[\"fix:rust:format:bevy\"]\ndescription = \"Run cargo fmt --all\"\nrun = \"cargo fmt --all\"\ndir = \"examples/bevy\"\n\n[\"fix:rust:format:servo\"]\ndescription = \"Run cargo fmt --all\"\nrun = \"cargo fmt --all\"\ndir = \"examples/servo\"\n\n[\"fix:rust:format:safeui\"]\ndescription = \"Run cargo fmt --all\"\nrun = \"cargo fmt --all\"\ndir = \"examples/safe-ui\"\n\n[\"fix:rust:format:all\"]\ndepends = [\"fix:rust:format:root\", \"fix:rust:format:bevy\", \"fix:rust:format:servo\", \"fix:rust:format:safeui\"]\n\n[\"fix:toml:format\"]\ndescription = \"Run taplo format\"\nrun = \"taplo format\"\n\n[\"fix:pnpm:lock\"]\ndescription = \"Update pnpm lock file\"\nrun = \"pnpm i --lockfile-only\"\n\n[\"fix:pnpm:dedupe\"]\ndescription = \"Run pnpm dedupe\"\nrun = \"pnpm dedupe\"\ndepends = [\"prepare:pnpm-install\"]\n\n[\"fix:ts:format\"]\ndescription = \"Run pnpm format:fix\"\nrun = \"pnpm run format:fix\"\ndepends = [\"prepare:pnpm-install\"]\n\n[\"fix:ts:biome\"]\ndescription = \"Run pnpm lint:fix\"\nrun = \"pnpm run lint:fix\"\ndepends = [\"prepare:pnpm-install\"]\n\n### Lints\n\n[\"lint:ts:typecheck\"]\ndescription = \"Run pnpm format:fix\"\nrun = \"pnpm type-check:ci\"\ndepends = [\"prepare:pnpm-install\"]\n\n### Build\n\n[\"build:lsp:wasm\"]\ndescription = \"Build the LSP (WASM)\"\ndir = \"editors/vscode\"\nsources = [\"tools/lsp/Cargo.toml\", \"tools/lsp/**/*.rs\", \"tools/lsp/ui/**/*.slint\"]\noutputs = [\"tools/lsp/pkg/*\"]\nrun = \"pnpm run build:wasm_lsp\"\ntools = { \"ubi:drager/wasm-pack\" = \"0.13.1\" }\ndepends = [\"prepare:pnpm-install\"]\n\n[\"build:interpreter:wasm\"]\ndescription = \"Build the Slint interpreteer (WASM)\"\ndir = \"tools/slintpad\"\nsources = [\"api/wasm-interpreter/Cargo.toml\", \"api/wasm-interpreter/src/**/*.rs\"]\noutputs = [\"api/wasm-interpreter/pkg/*\"]\nrun = \"pnpm run build:wasm_interpreter\"\ntools = { \"ubi:drager/wasm-pack\" = \"0.13.1\" }\ndepends = [\"prepare:pnpm-install\"]\n\n[\"prepare:pnpm-install\"]\nhide = true\nrun = \"pnpm install --frozen-lockfile\"\ndepends = [\"fix:pnpm:lock\"]\n\n\n### CI\n\n[\"ci:autofix:fix\"]\ndescription = \"CI autofix job -- fix steps\"\ndepends = [\n \"fix:cpp:format\",\n \"fix:legal:copyright\",\n \"fix:python:format\",\n \"fix:rust:format:all\",\n \"fix:text:trailing_spaces\",\n \"fix:toml:format\",\n \"fix:pnpm:lock\",\n \"fix:pnpm:dedupe\",\n \"fix:ts:biome\",\n \"fix:ts:format\",\n]\n\n[\"ci:autofix:lint\"]\ndescription = \"CI autofix job -- lint steps\"\ndepends = [\"lint:legal:reuse\", \"lint:ts:typecheck\"]\n" }, { "path": ".npmrc", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\nsave-prefix=\"\"\nnode-linker=hoisted" }, { "path": ".taplo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[formatting]\ncolumn_width = 120\ninline_table_expand = false\n" }, { "path": ".vscode/.gitignore", "content": "launch.json\nsettings.json\n" }, { "path": ".vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"rust-lang.rust-analyzer\",\n \"vadimcn.vscode-lldb\",\n \"ms-vscode.cmake-tools\",\n \"llvm-vs-code-extensions.vscode-clangd\"\n ]\n}\n" }, { "path": "AGENTS.md", "content": "# AGENTS.md\n\nThis file provides guidance to AI coding assistants when working with code in this repository.\n\n## Project Overview\n\nSlint is a declarative GUI toolkit for building native user interfaces across embedded systems, desktops, mobile, and web platforms. UIs are written in `.slint` markup files and connected to business logic in Rust, C++, JavaScript, or Python.\n\n## Build Commands\n\n### Rust (Primary)\n```sh\ncargo build # Build the workspace\ncargo build --release # Release build (use this flag whenever testing performance)\ncargo test # Run tests (requires cargo build first!)\ncargo build --workspace --exclude uefi-demo # Build all examples\n```\n\n### Running Examples\n```sh\ncargo run -p gallery # Run the gallery example\ncargo run --bin slint-viewer -- path/to/file.slint # View a .slint file\n```\n\n### C++ Build\n```sh\ncargo build --lib -p slint-cpp # Build C++ library\nmkdir cppbuild && cd cppbuild\ncmake -GNinja ..\ncmake --build .\n```\n\n### Node.js Build\n```sh\ncd api/node && pnpm install\n```\n\n## Testing\n\n**Important**: Run `cargo build` before `cargo test` - the dynamic library must exist first.\n\n### Test Drivers\n```sh\ncargo test -p test-driver-interpreter # Fast interpreter tests\ncargo test -p test-driver-rust # Rust API tests\ncargo test -p test-driver-cpp # C++ tests (build slint-cpp first)\ncargo test -p test-driver-nodejs # Node.js tests\ncargo test -p doctests # Documentation snippet tests\n```\n\n### Filtered Testing\n```sh\ntests/run_tests.sh rust layout # Filter by name\n```\n\n### Syntax Tests (Compiler Errors)\n```sh\ncargo test -p i-slint-compiler --features display-diagnostics --test syntax_tests\nSLINT_SYNTAX_TEST_UPDATE=1 cargo test -p i-slint-compiler --test syntax_tests # Update expected errors\n```\n\n### Screenshot Tests\n```sh\ncargo test -p test-driver-screenshots # Compare against references\nSLINT_CREATE_SCREENSHOTS=1 cargo test -p test-driver-screenshots # Generate references\n```\n\n## Architecture\n\n### Core Components\n\n- **`internal/compiler/`** - Slint language compiler (lexer, parser, code generators)\n - `parser/` - .slint syntax parsing using Rowan\n - `passes/` - Optimization passes\n - `generator/` - Code generators for C++, Rust, Python, JS\n - `tests/syntax/` - Syntax error test cases\n\n- **`internal/core/`** - Runtime library (properties, layout, animations, accessibility)\n\n- **`internal/core-macros/`** - Procedural macros for i-slint-core\n\n- **`internal/common/`** - Shared code and data structures between compiler and runtime\n\n- **`internal/interpreter/`** - Dynamic compilation for scripting languages\n\n- **`internal/backends/`** - Platform windowing/input:\n - `winit/` - Cross-platform (primary)\n - `qt/` - Qt integration\n - `android-activity/` - Android platform support\n - `linuxkms/` - Linux KMS/DRM direct rendering\n - `selector/` - Runtime backend selection\n - `testing/` - Testing backend for automated tests\n\n- **`internal/renderers/`** - Rendering engines:\n - `femtovg/` - OpenGL ES 2.0\n - `skia/` - Skia graphics\n - `software/` - CPU-only fallback\n\n### Language APIs (`api/`)\n\n- `rs/slint/` - Rust public crate\n- `rs/macros/` - `slint!` procedural macro\n- `rs/build/` - Build script support\n- `cpp/` - C++ API with CMake integration\n- `node/` - Node.js bindings (Neon)\n- `python/` - Python bindings (PyO3)\n- `wasm-interpreter/` - WebAssembly bindings for browser use\n\n### Tools\n\n- `tools/lsp/` - Language Server Protocol for editor integration\n- `tools/compiler/` - CLI compiler\n- `tools/viewer/` - .slint file viewer with hot reload\n- `tools/slintpad/` - Web-based Slint editor/playground\n- `tools/figma_import/` - Import designs from Figma\n- `tools/tr-extractor/` - Translation string extractor for i18n\n- `tools/updater/` - Migration tool for Slint version updates\n\n### Editor Support (`editors/`)\n\n- `vscode/` - Visual Studio Code extension\n- `zed/` - Zed editor integration\n- `kate/` - Kate editor syntax highlighting\n- `sublime/` - Sublime Text support\n- `tree-sitter-slint/` - Tree-sitter grammar for syntax highlighting\n\n### Key Patterns\n\n- Internal crates (`internal/`) are not semver-stable - they use exact version pinning\n- FFI modules are gated with `#[cfg(feature = \"ffi\")]`\n- C++ headers generated via `cargo xtask cbindgen`\n- Extensive Cargo features control renderers (`renderer-femtovg`, `renderer-skia`, `renderer-software`) and backends (`backend-winit`, `backend-qt`)\n\n## Version Control (Git)\n\n- The default git branch is `master`\n\n## Code Style\n\n- Rust: `rustfmt` enforced in CI\n- C++: `clang-format` enforced in CI\n- Linear git history preferred (rebase/squash merges)\n\n## Platform Prerequisites\n\n### Linux\n```sh\n# Debian/Ubuntu\nsudo apt install libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev \\\n libfontconfig-dev libssl-dev clang libavcodec-dev libavformat-dev \\\n libavutil-dev libavfilter-dev libavdevice-dev libasound2-dev pkg-config\n```\n\n### macOS\n```sh\nxcode-select --install\nbrew install pkg-config ffmpeg\n```\n\n### Windows\n- Enable symlinks: `git clone -c core.symlinks=true https://github.com/slint-ui/slint`\n- Install MSVC Build Tools\n- FFMPEG via vcpkg or manual installation\n\n## Deep Dive Documentation\n\nFor tasks requiring deeper architectural understanding, see:\n\n- **`docs/development/compiler-internals.md`** - Compiler pipeline, passes, LLR, code generation. Load when working on `internal/compiler/`.\n- **`docs/development/type-system.md`** - Type definitions, unit types, type conversions, name resolution, type register. Load when working on `langtype.rs`, `lookup.rs`, or type checking.\n- **`docs/development/property-binding-deep-dive.md`** - Reactive property system, dependency tracking, two-way bindings, PropertyTracker, ChangeTracker. Load when working on `internal/core/properties.rs` or debugging binding issues.\n- **`docs/development/custom-renderer.md`** - Renderer traits, drawing API, backend integration, testing. Load when working on `internal/renderers/` or fixing drawing bugs.\n- **`docs/development/animation-internals.md`** - Animation timing, easing curves, performance, debugging. Load when working on `internal/core/animations.rs` or animation-related issues.\n- **`docs/development/layout-system.md`** - Layout solving, constraints, GridLayout/BoxLayout, compile-time lowering. Load when working on `internal/core/layout.rs` or sizing/positioning bugs.\n- **`docs/development/item-tree.md`** - Item tree structure, component instantiation, traversal, focus. Load when working on `internal/core/item_tree.rs`, event handling, or runtime component model.\n- **`docs/development/model-repeater-system.md`** - Model trait, VecModel, adapters (map/filter/sort), Repeater, ListView virtualization. Load when working on `internal/core/model.rs` or data binding in `for` loops.\n- **`docs/development/input-event-system.md`** - Mouse/touch/keyboard events, event routing, focus management, drag-drop, shortcuts. Load when working on `internal/core/input.rs` or event handling.\n- **`docs/development/text-layout.md`** - Text shaping, line breaking, paragraph layout, styled text parsing. Load when working on `internal/core/textlayout/` or text rendering.\n- **`docs/development/window-backend-integration.md`** - WindowAdapter trait, Platform trait, WindowEvent, popup management, backend implementations. Load when working on `internal/core/window.rs` or `internal/backends/`.\n- **`docs/development/lsp-architecture.md`** - LSP server, code completion, hover, semantic tokens, live preview. Load when working on `tools/lsp/` or IDE tooling.\n- **`docs/development/ffi-language-bindings.md`** - C++/Node.js/Python bindings, cbindgen, FFI patterns, adding new cross-language APIs. Load when working on `api/` or internal FFI modules.\n" }, { "path": "CHANGELOG.md", "content": "\n# Changelog\nAll notable changes to this project are documented in this file.\n\n## [1.16.0] - Unreleased\n\n### General\n\n - SoftwareRenderer: avoid doing dirty-region computation when we need to redraw the whole buffer\n\n### Slint\n\n - Fixed empty GridLayout not taking padding into account\n - Added `keys` type and `@keys(...)` macro\n - Added printer charachter in the `Key` namespace\n\n### Widgets\n\n - CheckBox no longer intercepts the scroll event with the Qt style\n\n### Rust\n\n - Added `slint::platform::femtovg_renderer::FemtoVGWGPURenderer`\n - Added variants for printable keys in the `slint::platform::Key` enum\n\n### C++\n\n - Added contant for printable keys in the `slint::platform::key_codes` namespace\n\n## [1.15.1] - 2026-02-12\n\n - Fixed text rendering eliding when not required or not showing text due to rounding differences.\n - `GridLayout`: Honor colspan and rowspan in repeated rows. (#10727)\n - Rust: Fix cross-compilation when the target environment doens't provide a host fontconfig via pkg-config.\n - Interpreter: Fix two way bindings with properties in a parent scope. (#10704)\n - Winit: Fixed the \"redo\" (Ctrl+Shift+Z) shortcut.\n - Qt backend: Fixed blurry svg rendering with a scale factor. (#10726)\n - live-preview: Properly close the preview when the LSP exits instead of killing the process.\n - LSP: Fixed error when the loaded file is deleted on disk.\n\n## [1.15.0] - 2026-02-04\n\n### General\n\n - **breaking change**: Adjust Android implementation of the window safe area to match the iOS implementation.\n - When resizing the window, try to keep the focus item visible if it's in a `Flickable`.\n - When focusing an element that's not fully visible, try to scroll a parent `Flickable` so that it is.\n - winit backend: Do not enable the x11/wayland feature through accessibility feature.\n - Skia: Fixed colorized tile rendering. (#9860)\n - partial renderer: Fixed `BorrowMutError` panic if items gets destroyed during rendering. (#9882)\n - software renderer: Added support for the `Path` element (not supported in `no_std` or freestanding).\n - Fixed rendering of clipped layers. (#10037)\n - slint-compiler: Change diagnostics to use the `annotate-snippets` crate.\n - slint-compiler: Diagnostics now report range instead of just a position.\n - Translations: allow to opt out of default context.\n - Fixed debug performance overlay not working. (#10198)\n - Qt backend: worked around leak in Plasma when setting a window icon.\n - Fixed flicking animation in ListView. (#7043)\n - Align text and image rendering to pixel boundaries.\n\n### Slint Language\n\n - Added support for two way bindings to struct fields.\n - Added four new properties to the Window element for exposing the safe area to Slint.\n - Added the `accessible-id` property.\n - Added `AccessibleRole.radio-button`.\n - Added `stroke-line-join` for Path. (#9912)\n - Added `from ` syntax to `@conic-gradient`.\n - `GridLayout`: `row`, `col`, `colspan`, and `rowspan` properties can now be changed at runtime.\n - `GridLayout`: Support for `if` and `for`.\n - Fixed missing dependency detection on `Image.source-clip`.\n - Accessing properties within `Menu` from the outside is now a compile error instead of a panic. (#9443)\n - Added `Colors.oklch()` and `.to-oklch()` functions.\n - Fixed reactivity of animated bindings. (#348)\n - Add warning about non-top-level `Window` usage.\n\n### Widgets\n\n - `ScrollView`: In fluent style, fixed scroll bars to adjust to each other's visibility.\n - `Slider`: Implemented `increment`, `decrement` and `set-value` accessibility actions on Slider. (#9975)\n - `Slider`: Inverted vertical slider direction.\n - Fixed menu item spacing in fluent style (#10484)\n - Fixed some widgets that could still be edited when disabled or read-only.\n - `SpinBox`: added `read-only` property\n - `TabWidget`: added `orientation` property (#3688)\n - `TextEdit` and `LineEdit`: Added `font-family` and `font-italic` properties\n\n### Rust\n\n - Added `slint::fontique_07` module, guarded with `unstable-fontique-07` feature, to provide access\n to fontique collection types for registering custom fonts at run-time.\n - Added `slint::language::ColorScheme`.\n - In live preview mode, fixed panic when custom models access the component's property. (#10278)\n - Relaxed bounds on associated functions in `slint::SortModel`.\n - Don't generate full code for `slint!` macro when ran under rust-analyzer.\n - Updated to WGPU 28 and drop WGPU 26.\n\n### C++\n\n - Fixed crash when binding is accessing a deleted parent. (#3464)\n - Fixed mingw-llvm builds.\n - Fixed build generation failing when compiling multiple .slint files.\n - Fixed crashes with freestanding builds. (#10077)\n - It's now possible to access platform native window handles, like a HWND on Windows.\n\n### Python\n\n - Fixed support for underscores in async callback decorators. (#10024)\n - slint-compiler: added support for generating Python stubs. (#4136)\n\n### Tools:\n\n - LSP: Fixed column position of non-acii for UTF16-based editor. (#5669)\n - LSP: Fixed `vscode-remote://` url.\n - LSP: Added support for `@conic-gradient` completion. (#10444)\n - LSP: Fixed reloading dependencies when file changes on disk.\n - LSP: add function argument name when auto-complete function call. (#10560)\n - tr-extractor: Make the paths argument required. (#10156)\n - Added gdb pretty printer for `SharedVector` and `Slice`.\n\n## [1.14.1] - 2025-10-23\n\n - Updated xkbcommon and fsdm dependencies\n - Relicensed Zed editor extension to fullfill Zed's new license requirements\n - Rust: Fixed incorrect conversion to and from premultiplied ARGB in `Image::to_rgba8` and `Image::to_rgba8_premultiplied` (#9810)\n - winit: Fixed panic when accessing `Palette.color-scheme` during muda menubar build (#9792)\n - Fixed docs.rs build by adjusting features metadata\n\n## [1.14.0] - 2025-10-21\n\n### General\n\n - Fixed panic when clicking outside of a menu for a ContextMenuArea that is in a condition\n - Close active sibling popups before creating a new one (#9178)\n - Skia/WGPU/DX12: Fixed crash when resizing window (#9320)\n - Skia: Upgrade to skia-safe 0.88\n - Android: Hide Android selection handles when scrolled out of view\n - Wasm: fix mac-specific shortcut when detecting macOs via browser User-Agent\n - macOs: Implement Cmd+Backspace to delete to the start of a line in a TextInput\n - muda: On Windows, force the menu bar to be redrawn after menus are rebuilt (#9435)\n - use `fontique` and `parley` crate for text layout\n - Fixed maximum size of empty layout with alignment\n - partial renderer: Don't mark region dirty if the geometry is dirty but hasn't changed\n - Close PopupWindow when their parent is destroyed\n - Fixed scrolling of ListView with varying item heights (#9208)\n - Display the dirty region when running the software renderer with `SLINT_DEBUG_PERFORMANCE`.\n\n### Slint Language\n\n - Added support for rotation and scaling of all elements and their children\n - GridLayout: allow access to row/col/rowspan/colspan properties from other bindings\n - Added `Math.sign()` (#9444)\n - The slint compiler now emits a warning if a statement is without effect (#9474)\n - Addded `LayoutAlignment.space-evenly` (#9545)\n\n### Widgets\n\n - TextInput: don't allow undo/redo when read-only (#9609)\n - Added Button::icon-size (#9279)\n - Fixed TimePickerPopup placement logic (#9262)\n - LineEdit: implemented show-password icon for the Qt style\n - Slider: Fixed track geometry to account for handle size (#9449)\n - Menu: fixed menu separator appearence (#8339)\n - LineEdit: call `edited` callback when the \"x\" button is pressed\n - ScrollView: Fixed scrolled callback with Qt style (#9574)\n - TextEdit: made `has-focus` an `out` property\n\n### Rust\n\n - Minimum Supported Rust Version (MSRV) is 1.88\n - Slint macro: Use new Rust 1.88 API proc_macro API to be able to access file relative to the .rs file\n - Fixed error in generated Rust code when convering some expressions to void\n - Upgraded WGPU dependency to version 27: The `unstable-wgpu-27` Cargo feature exists next to the old `unstable-wgpu-26` feature,\n alongside the `slint::wgpu_27` module.\n - Added support for `unstable-wgpu-*` and `BackendSelector`'s `require_wgpu_*` on Android.\n\n### Python\n\n - Added support for asyncio by making the Slint event loop act as asyncio event loop.\n - Added suport for translations via `slint.init_translations()` accepting a `gettext.GNUTranslation`.\n - Added support for using the `@slint.callback()` decorator with `async` functions, as long as they don't return any value.\n\n### Tools:\n\n - SlintPad: add a way to load libraries with `?lib=...`\n - live-preview: Added a context menu to the library panel to rename or preview components\n - live-preview: Added search in the properties list\n - live-preview: Fixed resizing elements not in layout\n - live-preview: Fixed resetting binding of declared properties\n - live-preview: Added a way to always see the code of properties\n - live-preview: Added support for editing `@conical-gradient` in the color picker\n - formatter: Format `import` statements\n\n## [1.13.1] - 2025-09-11\n\n - Windows: Fixed flickering when updating the menu bar.\n - LinuxKMS: Fixed build with just renderer-femtovg\n - LinuxKMS: Fixed GPU based rendering on systems where the driver reported no DRM planes.\n - Qt: use the cursor flash time from the config\n - Fixed spurious Slint compiler error when using `ContextMenuArea` in component within a `if` or `for`\n - C++: fixed the live preview feature missing the `slint_live_preview.h` header (#9335)\n - FemtoVG: added support for conical gradients (#9334)\n - FemtoVG: Fixed panic when using rendering notifiers in Wasm with WebGL.\n - `SwipeGestureHandler`: improved thresholds and destection of move when embedded in another `SwipeGestureHandler`\n - MCU: fix timer not starting if started before first call to `update_timers_and_animations`\n - wasm: Fix sizing of the window based on the canvas size or the preferred size\n - LSP: fix renaming elements id that have a `-` or `_` mismatch.\n - live-preivew: allow to edit element id\n - live-preview: search line edit for the library\n - Slintpad: compress the snippet in the URL\n\n## [1.13.0] - 2025-09-03\n\n### General\n\n - winit: Fixed the maximize window not being disabled for fixed-size windows.\n - winit: Added support for timer based frame throttling (#8826).\n - winit: Added support for custom event hooks (`with_winit_custom_application_handler`).\n - winit: Fall back to software rendering if there are no GPU-backed WGPU adapters (#9164).\n - LinuxKMS: Added support for overriding the default framebuffer interface selection/\n - LinuxKMS: Added support for a padded legacy linux framebuffers.\n - LinuxKMS: Added support for libinput event hooks (behind `unstable-libinput-09` feature flag)\n - Skia: Fixed `no-wrap` still wrapping text (#7080)\n - Skia: Added support for importing WGPU textures, via `unstable-wgpu-26` when Skia is enabled.\n - Software renderer: Add radial gradient support (#8980)\n - Software renderer: Fix rendering of the Qt style (#9006)\n - Windows: Fixed menu bar in fullscreen mode\n - Windows: Context menus are now using native look and feel.\n - Fixed gradient rendering bugs in Qt and FemtoVG renderers (#9030, #7909)\n\n### Slint Language\n\n - Callback handlers no longer need curly-braces. Extra semi-colon is no longer an error. (#8401)\n - Added support for local variable with `let` (#2752)\n - `MenuItem`: Added `icon`, `checkable`, and `checked` properties.\n - `MenuBar` can now be hidden by placing it in a `if`.\n - Fixed `MenuSeparator` not always being visible.\n - `Flickable`: Forward wheel events in a orthogonal direction to their parent.\n - Added a compiler warning when using `padding` outside of layouts (#6288).\n - `Timer`: Added `stop()`, `start()`, and `restart()` functions (#8821).\n - `FocusScope`: Added `focus-on-click` and `focus-on-tab-navigation` properties.\n - `FocusScope`: Added `capture_key_pressed` and `capture_key_released` callbacks\n - `Dialog` and `Window` that aren't top-level now draw their background.\n - Added support for `@conic-gradient` (#9021)\n - `Path`: Fixed changing `commands` or path sub-elements in a component that inherit from `Path`.\n - `Path`: Fix settings `commands` from states (#4080)\n - Added `Key.Back` for the back key on android.\n - Added an `Easing` namespace to reference easing curve outside of `easing` properties.\n - `focus()` can now be called on invisible items.\n - `Window`: Fixed `default-font-size` not propagating into `PopupWindow`.\n\n### Widgets\n\n - `LineEdit`: Show a clear icon when not empty.\n - `LineEdit`: Users can toggle password visibility via an icon when `input-type` is set to `password`.\n\n### Rust\n\n - Minimum Supported Rust Version (MSRV) is 1.85\n - Upgraded WGPU dependency to version 26: The `unstable-wgpu-26` Cargo feature replaces the old `unstable-wgpu-24` feature,\n and the `slint::wgpu_26` module replaces the `slint::wgpu_24` module. There were no further changes to the API.\n - Fixed compilation of generated code if the slint code declares a type named `core`.\n - Support for live-preview with the `slint/live-preview` feature and `SLINT_LIVE_PREVIEW` env variable\n - winit: Added API to await for the existence of the winit window\n - Added `FromIterator` and `Extend` for `SharedString`\n - Added `SharedVector::reserve()`\n\n### C++\n\n - Added `SharedString::clear()`.\n - Support for live-preview with the `SLINT_FEATURE_LIVE_PREVIEW` feature and `SLINT_LIVE_PREVIEW` env variable\n - `SLINT_FEATURE_RENDERER_FEMTOVG_WGPU` is no longer enabled by default\n - esp-idf: `slint::invoke_from_event_loop` can now be invoked before starting the event loop.\n - Fixed Windows AArch64 support\n\n### Node.js API\n\n - Fixed panic when attempting to convert brushes to colors.\n\n### Python\n\n - Added support for automatically mapping exported Slint enums to property Python `enum.Enum` subclasses.\n - Add support for creating slint.Image objects from arrays (#9014)\n\n### Tooling\n\n - lsp: allow to rename functions and callbacks\n - lsp: show documentation comments in the hoover/tooltip (#9057)\n - live-preview: Move the preview in a separate process\n - live-preview: allow dropping in a `ListView` by adding a `for` loop\n - live-preview: Added an \"Outline\" panel\n - live-preview: Fixed highlighted elements not following items\n - live-preview: Added undo/redo support\n - slint-compiler: Guess default output format from file extension\n - SlintPad: replace the web menu bar with the preview menu bar. Move the preview on the left.\n\n## [1.12.1] - 2025-06-25\n\n### General\n\n - Fixed invalid code gen with return statements. (#8723)\n - Updated `muda` dependency to avoid outdated and insecure `gtk` dependency to appear in the `Cargo.lock` file even if it was not used. (#7800)\n - Fixed memory leaks and crash in change callbacks (#8768, #8741)\n - winit: Fixed window constraints (min, max, pref) not being applied sometimes (#8765)\n - No longer generate unused structs in the generated code to avoid warnings with Rust 1.89\n\n### Slint Language\n\n - Enums without value cause compilation errors (instead of panics)\n - Fixed runtime and compile errors when accessing the `Platform` global from within other globals. (#8777)\n\n### Node.js API\n\n - Added packages for Windows on ARM.\n\n### C++\n\n - Fixed compilation of `PopupWindow::show()` in changed callbacks. (#8710)\n\n### LSP and Tooling\n\n - Added binaries for Windows on ARM (VS Code extension, slint-lsp binaries).\n - Fixed potential crashes due to stack overflows on Windows.\n - live-preview: Lazily compute palette to speedup the UI.\n\n## [1.12.0] - 2025-06-16\n\n### General\n\n - Added `renderer-femtovg-wgpu` (Rust) / `SLINT_FEATURE_RENDERER_FEMTOVG_WGPU` (CMake) as new rendering option,\n based on [WGPU](https://wgpu.rs/).\n - Fixed `Window::default-font` not working in the live preview.\n - Initial iOS support.\n - FemtoVG: Fixed extra space of the `\\n` char in text rendering (#7970).\n - Android: Commit the preedit text when focus change (#8668).\n - Winit: Added support for SVG icons in the window title.\n - Winit: Fixed blinking window icon on Windows (#7994).\n - Updated AccessKit.\n\n### Slint Language\n\n - Fixed detection of binding loops that apply to the `Window` itself.\n - Added `Math.exp` and `Math.ln`.\n - Added `Platform.style-name` and `Platform.os` properties to permit style and OS dependent code.\n - Fixed changed callback on private global properties (#8269).\n - Added `ContextMenuArea::enabled`.\n - Fixed Slint compilation error for comparison of types that can't be compared with less or greater operator.\n - `Flickable` now keeps in bounds when geometry changes (#2227, #7487).\n - Added `in-out` transition in states.\n - Added `focus-gained` and `focus-lost` callback to `FocusScope`.\n - Added a `FocusReason` argument to the `FocusScope` callbacks.\n - Fixed `TextInput` to selects its content when focused with the keyboard on Windows and Linux.\n - Fixed `TextInput` to no longer be focusable if disabled.\n\n### Widgets\n\n - Fixed `ScrollView` scrollbar actions not triggering `scrolled` callback (#8170).\n - `GroupBox`: Added `content-padding` property (#8314).\n - `TextEdit`/`LineEdit`: Disable context menu action when the widget is disabled or read-only.\n - `ScrollView`: Added `mouse-drag-pan-enabled` property (#8512).\n\n### Rust\n\n - Added `unstable-winit-030` feature along with `slint::winit_030` module in the API to provide access\n to winit APIs.\n - Added `unstable-wgpu-24` feature along with `slint::wgpu_24` module to enable Slint <> WGPU interoperatiblity.\n - Made `Debug` impl of `PlatformError` show the display string.\n - slint-build: Implement `Clone` for `CompilerConfiguration`.\n - slint-interpreter: Fixed `From for slint_interpreter::Value` to return a model that supports `set_row_data`.\n\n### C++\n\n - Made generated code more robust when in namespaces regarding forward declaration.\n - Added a few asserts to ensure the code is run in the right thread.\n - Don't crash when `Model::row_data` returns `nullopt`.\n - Rust 1.85 is now required to compile from source.\n\n### Python\n\n - Upgraded to Pyo3 0.25.\n - Added iOS Simulator and Device wheels.\n\n### LSP and Tooling\n\n - live preview: Do not apply live data changes after \"Reload\".\n - live preview: Added telemetry events.\n - live preview: support Palette names in color picker.\n - live-preview: Added a console panel with complation error and `debug(...)` messages.\n - figma-inspector: Enables the export of design tokens (variables for colors, numbers, strings, and booleans).\n direct from your Figma files.\n - figma-inspector: Inspected components now can include design token variable reference for convenient pasting into slint files..\n\n## [1.11.0] - 2025-04-23\n\n### General\n\n - Fixed compilation failure with mingw by disabling jemalloc.\n - Fixed non-square radial gradients. (#7899)\n - Fixed timer starting before property initialization is complete in the interpreter. (#7848)\n - Fixed ctrl/cmd swap in wasm in macOS browsers. (#7477)\n - Fixed panic in accesskit when opening popups. (#7854)\n - Software renderer: fixed drawing background of rotated screen.\n - Software renderer: Fixed overflow for font bigger than 256px. (#7936)\n - Skia renderer: Changed default on Windows to use the software renderer, instead of Direct3D.\n - Skia renderer: Fixed artifacts when using the partial renderer. (#8066)\n\n### Slint Language\n\n - Added `float.to-fixed()` and `float.to-precision()`.\n - Added `string.to-lowercase()` and `string.to-uppercase()`.\n - Fixed change handler on an aliased property. (#7784, #7747)\n - Fixed compiler panic when one branch of the `if` statement is not a void expression. (#7864)\n - Fixed `@children` as sibling to `Timer` or `PopupWindow`. (#7887)\n - Deprecated alias to global callbacks and make it an error when setting it, instead of a panic. (#7806)\n - Conditional element no longer re-instantiates if the condition gets dirty without changing. (#3953)\n - Fixed crash if a component get destroyed when a function or callback of it is running. (#7880)\n - `Color.hsv()`: The hue value now wraps instead of clamping between 0 and 360. e.g. a hue of `480` would wrap as expected to `120`.\n Previously any value equal or greater than 360 would cause the function to output pure black. In the unlikely case an app relied\n on this keep an eye out as a color will now show up instead of black.\n - Fixed reading from `MenuItem::title` properties. (#8080, #8090)\n - Fixed inconsistencies when accessing arrays at negative indices. (#8222)\n - Allow trailing commas in import statements. (#4922)\n\n### Widgets\n\n - Fixed horizontal tab stretch with material style.\n - `ScrollView`: Fixed scroll thumb size on small sizes. (#7809)\n - `MenuBar` reacts to hover event when the menu is open. (#7822)\n - Added `MenuSeparator` sub-element in `Menu`. (#7790)\n - Added `MenuItem::enabled`.\n - Added `StandardButton::primary`.\n\n### C++\n\n - Allow vendored corrosion by using find_package to search for it. (#7797)\n - Optimize memory usage avoiding creating dependencies for constant properties.\n - Fixed overflow when subtracting unsigned in the Slint language.\n - esp-idf: select `slint::Rgb8Pixel` by default when `CONFIG_BSP_LCD_COLOR_FORMAT_RGB888` is set.\n - Added support for overriding the translation domain via a CMake target property.\n - Fixed `Math.mod` with negative numbers.\n - Fixed segfault when calling `Model::row_changed` right after `Model::reset`. (#8021)\n - Added `notify_` prefix to the `Model` protected function, and deprecated old names. (#3888)\n\n### LSP and Tooling\n\n - live-preview: Show why no live data is present. (#7783)\n - live-preview: New brush/color input widgets.\n - live-preview: Focus the right widget when the preview is reloaded. (#4055)\n - live-preview: Persist the live data when the preview is reloaded.\n - live-preview: Improve std-widget use detection. (#8086)\n - live-preview: Added a table to edit model in the data tab.\n - live-preview: Fixed preview of menu bar on platforms with native menu bar.\n - viewer: Support gradients in json data. (#7913)\n\n## [1.10.0] - 2025-02-28\n\n### General\n\n - Minimum Supported Rust Version (MSRV) is 1.82.\n - Android: Fixed build with newer JDK.\n - Winit backend: Fixed panic when `PopupWindow` is opened while AccessKit is active.\n - Skia renderer: Added support for partial rendering when using software rendering.\n - Qt backend: Fixed crash at exit with Qt 5.8. (#7570)\n - Qt backend: Fixed the Escape key not closing `PopupWindow`. (#7332)\n - Software renderer: Fixed support for changing the `Window` background.\n - Software renderer: Added support for pre-rendering glyphs with signed distance fields.\n\n### Slint Language\n\n - Elements of a `for` loop now only get re-created if the model is changed, not if it is only dirty. (#7245)\n - Binding loops involving the condition of a `if` in a layout are now detected. (#7126)\n - Added `.is-empty` and `.character-count` accessor to the string type.\n - Added `ContextMenu` and `MenuBar`.\n - Fixed panic change callbacks used with unused properties. (#7316)\n - Added `Path::stroke-line-cap` property. (#4676)\n - Special sub elements such as `Row`, `Tab` or `MenuItem` are now accepted in `@children`.\n - Accessibility: Added `accessible-expandable`, `accessible-expanded`, and `accessible-readonly` properties and `accessible-action-expand` callback.\n - Accessibility: Added `AccessibleRole.image` role.\n - Made `forward-focus` in a `PopupWindow` to focus a widget when a popup is open. (#7529)\n - Added `TextInput::page-height` to support PageUp and PageDown shortcuts.\n - Fixed panic when using gradient backgrounds with `Window`.\n\n### Widgets\n\n - Fixed `StandardListView` not always getting the focus.\n - Fixed panic when accessing \"negative\" items if there are hidden elements in the `ListView`.\n - Fixed positions of elements in a `ListView` with millions of items. (3700)\n - `ListView`: adapt the viewport's width based on the minimum-width of delegate.\n - `Slider`: React to Home and End keys.\n - `ComboBox`: Improved accessibility.\n - `ComboBox`: Don't change selected item on mouse wheel, unless it has focus. (#5929)\n - `StandardTableView`: Added missing properties from `ListView`. (#7543)\n - `LineEdit`/`TextEdit`: Added a context menu with copy/paste/select all.\n\n### Rust\n\n - Upgraded image crate to 0.25, added a new `image-default-formats` cargo feature to enable all image formats.\n - Ignore pedantic and nursery clippy warnings in generated code.\n - Fixed edition 2024 warnings in generated code.\n - Fixed `Sync` and `Send` bounds on `SharedVector`, `SharedString`, and `Weak`.\n - Removed the requirement that for `VecModel::default()` `T` has to implement `Default`.\n - Implement `Default` for `BackendSelector`.\n\n### C++\n\n - esp-idf: Added support for RGB8 rendering.\n - esp-idf: Rename `SlintPlatformConfiguration`'s `color_swap_16` to `byte_swap`.\n - esp-idf: Deprecated old version of `slint_esp_init` and restored 1.6 behavior with regards to color swapping.\n - Fixed bundled translation without custom backend.\n\n### LSP and Tooling\n\n - live-preview: Fix loading the library path config\n - live-preview (macOS): Add a Window menu with keep the window on top\n - live-preview: selection popup no longer contains invisible or clipped items\n - live-preview: fix editing of translated string.\n - LSP: no longer suggest private properties in auto-completion\n - LSP: add ability to rename properties and globals\n - Simple Figma inspector plugin\n - Use jemalloc as default allocator for our binaries\n - VSCode extension: Removed the status bar item for the preview\n\n## [1.9.2] - 2025-01-13\n\n### General\n\n - Improved support for building Slint with Bazel.\n - Expose `PopupWindow` in the accessibility tree.\n - Fixed support for older android versions (Android 6).\n - Fixed `Flickable` not scrolling when starting slow (#7152).\n - LinuxKMS backend: Fix support for triple-buffering with DRM outputs.\n - Fixed panic with FemtoVG and Skia renderers for certain drop shadows.\n - Fixed closing `PopupWindow` when the click opens another `PopupWindow` (#7322).\n - Fixed `popup.close()` not working in the interpreter (#7318).\n\n### Slint Language\n\n - Added `AccessibleRole::tab-panel` and fixed accessibility on `TabWidget` (#7270)\n - Added `AccessibleRole::groupbox` and fixed accessibility on `GroupBox`\n - Better error recovery when element name is missing.\n - Added warning when a type name overwrites another.\n - Added `Path::anti-alias` property.\n - Fixed compiler panic with `Row{ @children }`.\n - Skip UTF-8 Byte order mark (BOM) at the beginning of a file (#7291).\n\n### Widgets\n\n - Fixed `StandardButton` not being focusable (#7230).\n\n### C++\n\n - Updated corrosion dependency, fixing build with Rustup 1.28.\n - Added armhf/arm64 Linux binary packages to release.\n\n### Rust\n\n - Added `Window::try_dispatch_event` which is a non-panicking version of `dispatch_event`.\n\n### Tools\n\n - Binary packages: Disabled Qt backend.\n - LSP: Fix ranges in textDocument/documentSymbol.\n - LSP: Fixed panic in autocompletion of file patch with unicode.\n - LSP: Added ability to rename struct and enums.\n - LSP: Fixed error reporting when opening the live-preview fails (#7255).\n - Viewer: struct are now supported in callback argument (passed as JSON) (#7206).\n\n## [1.9.1] - 2024-12-21\n\n### General\n\n - Skia: Fix Metal and D3D defaults on macOS / Windows.\n - Winit backend: Fix build with only software renderer enabled.\n - Fixed build on https://docs.rs/slint\n - Live-preview: Improvements of the filter in selection popup\n\n## [1.9.0] - 2024-12-18\n\n### General\n\n - Minimum Supported Rust Version (MSRV) is 1.77.\n - Added functions to set the XDG app ID on Wayland/X11. (#1332)\n - Added ability to bundle translations in the binary.\n - Fixed panics in timer handling. (#6187, #6505)\n - Fixed support for older Android versions (9.0).\n - Android: handle the Destroy event properly. (#6626)\n - winit: automatically disabled maximize button when window resizing is disabled.\n - winit: react to dark/light color scheme changes on Linux (other platforms were already working before). (#4392)\n\n### Slint Language\n\n - Callback arguments can now be named.\n - Animations: Added `direction` property. (#6260)\n - `TextInput`: Fixed selection colors not begin picked up from the selected style. (#6326)\n - `TextInput`: Added `key-pressed` and `key-released` callbacks to intercept key events.\n - Fixed `TextInput` mouse cursor after left click. (#6444)\n - Improved deselection behavior when pressing left/right in `TextInput`. (#6511)\n - Fixed `changed` callback on unused properties causing compiler panic. (#6331)\n - Fixed geometry constraints when they are partially inferred from the content and partially inferred from the explicit constraints. (#6285)\n - Deprecated two-way binding between `in` and `in-out` properties. (#6400)\n - `TouchArea`: When `enabled` is set to false while pressed, send cancel event and update `pressed` and `has-hover` properties. (#6422)\n - `Text`/`TextInput`: Added `font-metrics` property. (#6047)\n - Added `accessible-item-selectable`, `accessible-item-selected`, `accessible-enabled`, `accessible-item-index`, and `accessible-delegate-focus` properties.\n - Emit a warning when the case of the import file differs from the case of the file that was imported. (#4265)\n - Support property changed callbacks in globals. (#6599)\n - `Window`: Added `full-screen` (#6665) property.\n - `Window::icon` is now used as the big taskbar icon on Windows.\n - Fixed `min(..)` and `max(..)` functions with `rem` units.\n - Emit a warning when a `@linear-gradient` or `@radial-gradient` is assigned directly to a color property. (#6819)\n - Fixed `min`/`max`/`clamp` functions with percentage arguments. (#7118)\n - Adjusted thresholds and behavior of the `SwipeGestureHandler`. (#6344, #6542, #6543)\n - `PopupWindow`: Improved positioning to avoid clipping by the window.\n - `PopupWindow`: Supported multiple popup windows at the same time. (#4356)\n - `PopupWindow`: Added `close-policy` property, deprecated `close-on-click`. (#6614)\n - `PopupWindow`: Close when the escape key is pressed.\n - Fixed focus handling in `PopupWindow`.\n - Fixed bugs with global cross-references. (#6984)\n\n### Widgets\n\n - `CheckBox`: Fixed text color in Fluent style. (#6239)\n - `CheckBox`: Removed margin in Fluent and Cupertino styles. (#6639)\n - `LineEdit`: Fixed cursor drawing out of bounds. (#6243)\n - `TabWidget`: Fixed tabs overflow behavior. (#6517)\n - `SpinBox`: added `horizontal-alignment` property.\n - Undeprecated `StyleMetrics` layout properties (`layout-spacing` / `layout-padding`).\n - `Slider`: Added `step` property.\n - `StandardListView`: Improved keyboard navigation. (#6955)\n - Fixed `init` and `changed` callbacks not always being called in `ListView`. (#6836)\n\n### Rust API\n\n - Added `slint_build::compile_with_output_path`.\n - Fixed `init=>` callback on PopupWindow running twice in Rust-generated code.\n - Derived serde traits for `PhysicalPosition`, `LogicalPosition`, `PhysicalSize`, and `LogicalSize`. (#6534)\n - Use `approx_eq` to compare floats in the generated code.\n - Added `BackendSelector` to select backend, renderer, and renderer specific features.\n - Added `ToSharedString` trait. (#6845)\n - Implement `AsRef` and `AsRef` for `SharedString`.\n\n### C++ API\n\n - Added `Image::to_rgb8/to_rgba8/to_rgba8_premultiplied` pixel buffer accessors. (#6399)\n - Added `SharedString::size()`. (#6417)\n - CMake: Support generator expressions for `SLINT_EMBED_RESOURCES` and `SLINT_SCALE_FACTOR`.\n - Add `_` to the end of generated identifiers that would otherwise be keywords. (#5613)\n - Improved float comparisons in the generated code.\n - esp-idf: Fixed vsync locking.\n - Added `to_lowercase` and `to_uppercase` to `slint::SharedString`. (#6869)\n - Added `slint::Window::take_snapshot()`.\n\n### Node.js API\n\n - Added support for enums.\n - Added `initTranslations` function. (#6504)\n\n### LSP and Tooling\n\n - LSP: Auto-completion of changed callbacks.\n - LSP: Preserve `_` when auto-completing element identifiers. (#6479)\n - LSP: Added image preview in tooltip for `@image-url`.\n - LSP: Fixed reloading files that import a changed file.\n - LSP: Implemented signature help.\n - LSP: Added a code lense to populate empty documents with a hello world.\n - live-preview: Added new selection popup.\n - live-preview: Bring the window to the front and focused it when clicking \"Show preview\" in the editor. (#196)\n - live-preview: On macOS, renamed \"Quit\" to \"Close\" and used cmd+w to close the window.\n - live-preview: Fixed panic if `run_event_loop` returns an error, showing an error in the editor instead.\n - live-preview: Fixed panic when dragging elements onto layouts.\n - live-preview: In the property editor, filter layout properties not applicable to the selected element.\n - live-preview: In the property editor, visualize negative numbers.\n - live-preview: Delay updating the preview.\n - live-preview: Reload when image resources changed on disk.\n - live-preview: macOS: Added support for reloading via cmd+r.\n - SlintPad: Updated Monaco editor and other dependencies.\n\n### Renderer\n\n - FemtoVG: Fixed artifacts of texture sampling with accidental wrap-around on texture boundaries.\n - FemtoVG: Fixed rendering of fonts that rely on non-zero winding rule (such as Inter).\n - Software renderer: Fixed `char-wrap` not breaking between lines.\n - Software renderer: Fixed artifacts with partial drawing and rotation.\n - Software renderer: Fixed panic with fractional scale factor. (#6932)\n - Skia: Fixed opacity not being applied to box shadows correctly. (#6359)\n\n\n## [1.8.0] - 2024-09-23\n\n### Slint language\n\n - Postfix function on numbers for math function.\n - `changed ` callbacks. (#112)\n - `Timer` built-in pseudo-element. (#5724)\n - `SwipeGestureHandler` element.\n - Fixed panic when accessing function within a PopupWindow. (#5852)\n - Fixed `@children` order in the root of a component. (#5865)\n - Fix conversion from float to string adding extra decimal precision by limiting to f32\n - `debug` will now print space between the arguments instead of a comma. (#5991)\n - Added math function `Math.atan2`.\n - width and height expressed in `%` unit for an element in a Flickable now refer\n to the size of the Flickable instead of that of the viewport (#4163)\n - Path: Fix compiler panic when accessing path.commands in expressions (#5564)\n - The `mod` function was changed to always return a positive value (#6178)\n - Added `AccessibleRole.list-item` and used it where relevant\n - Added `PointerEventButton.back` and `PointerEventButton.forward` (#6043)\n\n### Widgets\n\n - Fixed `TextEdit` not invoking `edited` callbacks (#5848).\n - Added `scrolled` callback to `ListView` and `ScrollView`.\n - Do not trigger `current-item-changed` on `StandardListView` if `current-item` is set on the same value.\n - Fixed `TimePickerPopup` does not open minute view by click on selected hour.\n - Visually clamp the slider even if the value is out of bounds (#5770)\n - Fixed button of Cupertino `ComboBox` not centered when height is bigger than default.\n - Fixed text in `SpinBox` not being selected on double click (#6104)\n\n### Rust\n\n - Added `clear` and `swap` to `VecModel`\n - `spawn_local` can now be called before initializing the backend. (It will initialize it) (#5871)\n - Fixed error in generated code when calling as an expression a callback that don't return a value. (#5883)\n - Fixed error in generated code with struct containing `percent` value (#5887)\n - Added `JoinHandle::is_finished()` (#6034)\n - Implemented `FromIterator` for `VecModel`\n - Fixed Timer::set_interval() doesn't work in timer callback (#6141)\n\n### C++\n\n - Split the generated code into a header and an implementation file\n - Added STM32 platform integration\n - cmake: Add ability to download the Slint compiler binary for the host when cross-compiling using binary packages for the target.\n - Added Pre-build binary packages for cross compilation to arm and xtensa target, and host package for MacOs\n - Use the \"fluent\" style by default on freestanding build instead of the platform default\n\n### LSP and tooling\n\n - Fixed vscode web extension\n - Fixed race condition in preview diagnostic causing previous diagnostic to remain displayed.\n - live-preview: Use preferred size when requesting preview.\n - Don't auto-complete `out` property of built-in elements at element scope.\n - Don't insert a semicolon after auto-complete of a property name at element scope.\n - Added support for tooltip on hover of symbols\n - formatter: don't change whitespaces or newlines before comments\n - live-preview: Fixed auto-refresh after closing and reopening the preview.\n - live-preview: Custom system menu bar so cmd+q don't quit the LSP.\n - live-preview: Polished UI\n - vscode extension: the wasm preview load code in another tab.\n - vscode extension: Added telemetry to report panics of the LSP server.\n - vscode extension: Added \"Create New Project\" command to start from one of our templates\n - vscode extension: Rename the output tab to from \"Slint LSP\" to \"Slint\", and make sure it is always there\n - slint-viewer: `--save-data`/`--load-data`: support for images with paths. (#6169)\n - SlintPad: Added \"about\" entry in the menu.\n\n### Misc\n\n - Added ability to configure scale factor at compile time (useful for no_std).\n - Improved property inlining in the compiler.\n - Fixed colorized tiled images\n - Fixed generated getter and setter of alias properties in globals (#5855)\n - Use `raw-window-metal` to do layer creation in skia\n - Updated Skia library. (NOTE: requires updated MSVC toolchain)\n - Skia renderer: Improve rendering quality of layers\n - GridLayout: Fixed panic when rowspan or colspan is 0 (#6181)\n\n## [1.7.2] - 2024-08-14\n\n### General\n\n - Added linux arm binary in the release.\n - Skia renderer: Fixed opacity not working on Image. (#5706)\n - Skia renderer: Fixed `SLINT_DEBUG_PERFORMANCE=\"overlay\"`. (#5764)\n - Android: workaround `PollEvent::Wake` not being received (#5699)\n - LinuxKMS backend: Fixed EGL initialization with Mali drivers found on i.MX 95.\n - Winit backend: don't forward synthetic key pressed events to the application.\n - Fixed panic when pressing tab in a PopupWindow. (#5826)\n\n### Slint Language\n\n - `debug()` is now consistently routed through Platform's `debug_log`, meaning it uses stderr by default instead of stdout previously with C++ and Rust code generator. (#5718)\n - Comparison between float is now using less precision so to float compare equal if they are approximately the same.\n - Conversion from float to a `int` property now always truncates (instead of rounding with the interpreter, or being inconsistent with the code generators)\n\n### Widgets\n\n - TimePickerPopup: Fixed text input on 24hour time picker. (#5723)\n\n### C++\n\n - Added `assert_main_thread` in a few more functions.\n\n### Rust\n\n - Fixed case when the rust generated code panics trying to access a destroyed parent. (part of #3464)\n\n### LSP and tooling\n\n - LSP: report error opening the preview back to the editor instead of panicking. (#204)\n - LSP: don't suggest private properties or functions as bindings.\n - LSP: implement goto-definition on re-export\n - LSP: Fix goto-definition on properties with underscores\n - Design mode: fix dragging component on the last component of a file without trailing newline (#5695)\n - VSCode extension: add a language icon for .slint file.\n\n## [1.7.1] - 2024-07-25\n\n### General\n\n - Winit backend: When running under WSL, always connect to X11 to avoid triggering compositor crashes.\n - Winit backend: Fix showing a previously hidden Window on macOS.\n - Android: Fix build with older Java versions.\n\n### Widgets\n\n - `ComboBox`: Fix size of popup when there are less than six items.\n\n### Rust\n\n - Fix warning in generated code for unused enums.\n\n### Node API\n\n - Improve error reporting by including the diagnostic in the exception's message.\n\n### LSP and Tooling\n\n - Various fixes to Live-preview's edit mode:\n - Recognize `GridLayout` for dropping widgets into.\n - Remove `PopupWindow`, `Window`, and `Dialog` from the component library.\n - Add support for component libraries.\n - Fix panic when moving around widgets. (#5642)\n - Don't show unrelated accessibility properties.\n\n## [1.7.0] - 2024-07-18\n\n### General\n\n - Several compiler bugfixes. (#5260, #5246, #5220, #5259, #5249, #5430)\n - Android: fix cursor handle being visible despite input loses focus. (#5233)\n - Android: fix keyboard popping up when application moved to foreground without input focus. (#5235)\n - Gettext translation: clear internal gettext cache when changing translations at runtime.\n - Winit backend: Fixed setting the size with set_size before showing the window. (#6489)\n - Winit backend: upgraded to winit 0.30, accesskit 0.16, glutin.\n - Winit backend: Fixed Window::hide on Wayland.\n - Qt backend: fix PopupWindow exiting the application with recent Qt6.\n - LinuxKMS backend: Added support for software rendering and legacy framebuffers.\n - Software renderer: Added `set_rendering_rotation()` to rotate the rendering by a multiple of 90 degrees.\n - Software renderer: Fixed dirty region returned by `render()` to not have any overlaps.\n - Skia renderer: Fix quality of control rendering when using `cache-rendering-hint: true;`.\n - Skia renderer: Fix dithering of gradients (PR #5482)\n\n### Slint Language\n\n - `Window`: Added `resize-border-width` property.\n - Support several exported component that inherits Window pr Dialog from the main .slint file\n - Mark exported component that doesn't inherit from Window or Dialog as deprecated\n - Deprecated generating the last import if there is no component in a file\n - Added `export { ... } from \"...\";` syntax\n - Add the `accessible-placeholder-text` property (PR #5464)\n - Added `char-wrap` variant to the `TextWrap` enum (PR #5381)\n - `Text` can be rotated\n - In `PopupWindow` permit access to own properties in bindings to `x`/`y`.\n\n### Widgets\n\n - `TextEdit`: Added `placeholder-text` property.\n - `ComboBox`: Fixed `current-value` not updating when updating the model.\n - `ComboBox`: Fixed `current-value` not resetting when setting `current-index` to -1.\n - `ComboBox`: Added scrolling support.\n - `SpinBox`: Fixed issue where the text is not updated after value is changed from outside.\n - `SpinBox`: Added `step-size` property.\n - Added `TimePickerPopup` and `DatePickerPopup`.\n - Fixed accessible value and actions on `ProgressIndicator`, `Spinner`, `Spinbox`, `CheckBox`, `Switch`.\n\n### C++ API\n\n - Added `LIBRARY_PATHS` multi-value argument to `slint_target_sources` that takes a list of\n `name=path` items, to allow for the use of component libraries.\n - Fixed compilation with Rust 1.81, caused by extra spaces in `stringify!`.\n - ESP-IDF: Added support for making RGB565 byte swap configurable.\n - Fix build with Rust 1.79.\n\n### Rust API\n\n - Added missing implementation of the `Error` for some of the errors.\n - Allow all clippy warnings in generated code.\n - Added `slint::Image::to_rgb8()/to_rgba8()/to_rgba8_premultiplied()` to obtain pixels for a `slint::Image` if available.\n - Fix panic in `slint::Timer` when a new timer is started while stopping another.\n - Added `slint::Window::take_snapshot()`.\n\n### Interpreter\n\n - Track model length changes when accessing a model out of bounds.\n - Added API to obtain list of functions.\n - Deprecated `slint_interpreter::ComponentCompiler` in favor of `slint_interpreter::Compiler` which\n supports compiling multiple components.\n\n### Node API\n\n - Functions declared in Slint can now be invoked from JavaScript.\n\n### LSP and Tooling\n\n - Added suggestion for imported globals in expression auto-completion.\n - Added ability to rename components.\n - Design mode: only allow to move element within the same component.\n - Design mode: Added the property editor pane.\n - viewer: added the `--component` command line arg to preview a specific component.\n\n\n## [1.6.0] - 2024-05-13\n\n### General\n\n - The minimum Rust version is now 1.73.\n - When the Skia renderer is enabled at compile time, it is picked as the default at run-time.\n - FemtoVG renderer: Fixed selection of italic font styles. (#5056)\n - Fixed color animation involving transparency. (#5063)\n - Android: Fixed support for Android 10 to 12 and Java 1.8.\n - Android: Fixed build if the locale is not UTF-8.\n - Android: Added cursor handle on TextInput and selection handle with cut/copy/paste menu.\n - Android: added `backend-android-activity-06` feature.\n - Software renderer: Dirty regions can now be composed of multiple rectangles.\n - Added a function to mark all translations as dirty.\n\n### Slint Language\n\n - Text: Added `stroke`, `stroke-width`, and `stroke-style` properties.\n - Added `Colors.hsv()` method to create colors in the HSV color space.\n - Added `to-hsv()` function to color.\n - Throw an error when `rgb()` or `argb()` have too many arguments.\n - Added support for `accessible-action-*`.\n - Fixed insertion point of `@children` when it is not the last child. (#4935)\n - Deprecated usage of internal `StyleMetrics` in the public API.\n - Fixed compiler panic with state property change involving a state in a parent component. (#5038)\n - Fixed interpreter overwriting property named `index`. (#4961)\n - Fixed compiler panic when a callback aliases itself. (#4938)\n - Fixed compiler panic when an init from a repeater is inlined into the parent component (#5146)\n - Added `clear-focus()` function to focusable elements, to allow for programmatic focus clearing.\n\n### Widgets\n\n - Palette: Added `color-scheme` in-out property for accessing the style's color scheme.\n - Accessibility: Annotated more widgets with accessible properties and actions.\n - Qt style: Fixed rendering of focused or hovered ComboBox and CheckBox.\n - Qt style: Fixed widget that would react to every mouse button instead of only the left button.\n - SpinBox: Fixed scroll direction.\n - Allow scrolling through tabs.\n - Updated TabWidget in Cosmic style.\n - Added a `released` callback to `Slider`.\n - Fixed text and selection color of TextEdit and LineEdit.\n - Spinbox and Slider: The value now defaults to the minimum.\n\n### Rust API\n\n - Added conversion of Color to and from HSV.\n - Added getter to the `raw-window-handle` of a window using the `raw-window-handle-06` feature.\n\n### C++ API\n\n - Workaround breaking change in the build with Rust 1.79 (see https://github.com/corrosion-rs/corrosion/issues/501)\n - Added conversion of Color to and from HSV.\n - Fixed code generation of functions that don't return.\n - Fixed the `MapModel::reset` function. (#4968)\n - Fixed compilation of the generated code when an animated brush property is set in a sling callback.\n - Added include guard to the generated header.\n\n### LSP and tooling\n\n - Design mode of the live preview can now drag into and from layout. With a drop marker when dragging an element.\n - Fixed formatting of function declarations.\n - Added `-L` command line args to `slint-lsp` to specify path of external libraries (#5144)\n - VSCode extension highlights Slint code blocks in markdown files.\n - `slint-viewer` will properly reload files saved with neovim, which renames and replaces files (#3641)\n\n## [1.5.1] - 2024-03-20\n\n - Fix clipping with a border-radius. (#4854)\n - Fix panic in the preview when showing a PopupWindow whose parent is optimized out. (#4884)\n - Fix compiler panic when the `focus` function is called with arguments. (#4883)\n - Fix panic when loading unsupported images.\n - LSP: Fixed formatting of states, transitions, and functions.\n - LSP preview: Avoid double scroll bar in the preview when showing errors.\n - LSP preview: Don't handle delete shortcut when showing errors.\n - LSP preview: Improved appearance of the element selection in the design mode.\n - LSP preview: Never set the with or height to NaN. (#4848)\n\n## [1.5.0] - 2024-03-14\n\n## General\n\n - Added support for Android via the `backend-android-activity-05` feature.\n - Added API for maximized/minimized window.\n - TextInput: Added undo/redo support.\n - ListView: Fixed redraw when model changes. (#4538)\n - Disabled Qt backend by default on Windows and Mac even when Qt is found.\n - Qt: Explicitly hide PopupWindow instead of relying on destructor.\n\n### Slint Language\n\n - Rectangle: Added `border-{top,bottom}-{left,right}-radius`\n - Image: Added `ImageFit.preserve`\n - Image: Added `horizontal-` and `vertical-alignment`\n - Image: Added support for 9 slice scaling\n - Image: Added `horizontal-` and `vertical-tiling`\n - Flickable: Added `flicked` callback\n - Slint: Expose `.red`, `.green`, `.blue`, and `.alpha` properties on `color`\n\n### Widgets\n\n - Fixed edited callback of SpinBox for Cupertino and Material style.\n - Cupertino TabWidget: Tweaked visual appearance\n\n### Rust\n\n - Fixed ReverseModel and FilterModel model not always forwarding notification correctly.\n - Re-export more type in the slint-interpreter crate.\n - Added `SharedVector::pop`.\n - Use const generics for construction of SharedVector from array.\n\n### C++\n\n - Fixed binary package that used to require Qt.\n - Added `Window::set_fullscreen`.\n - Fixed error in generated code when struct or enum has an underscore. (#4659)\n - Added `slint::interpreter::ComponentCompiler::set_translation_domain`.\n - Added `NAMESPACE` modifier in the `slint_target_sources` cmake macro to generate in a namespace.\n\n### JavaScript\n\n - Fixed MapModel rowData() calling map function even if the source model returned undefined.\n - Better error reporting when the backend cannot be created.\n - Reading model properties now always returns a `Model`, regardless of whether an array was previously assigned.\n - `Model` now implements `Iterable`.\n\n### LSP\n\n - Added support for code formatting.\n - Sort properties first in auto-completion.\n - Fixed completion in two way bindings\n - Preview: Design mode with drag and drop\n - Fixed wasm embedded preview on Windows\n\n## [1.4.1] - 2024-02-02\n\n - Skia: Update skia binding dependency.\n - SlintPad: Fixed initial rendering of the live-preview.\n - Qt backend: fix crash when closing popup on Wayland. (#4500)\n - Fixed rendering of linear gradient of 90deg. (#4495)\n - C++: Permit passing a value to VectorModel::set_vector by value (#4491)\n - slint-viewer: re-render after reloading when using software renderer.\n - Fixed panic in the software renderer when using the Qt style.\n - Rust: fix slint-build's formatter when source contains `\\\"` in a string. (#4520)\n\n## [1.4.0] - 2024-01-31\n\n### General\n\n - Winit backend: Fixed `key-released` in `FocusScope` not being invoked when releasing the space bar key.\n - Fix `PopupWindow` close behavior: Close on release when the mouse is on the popup, and close on press when\n it's outside - to match standard behavior.\n - Fixed focus behavior on click in a TextInput\n - Fixed ListView not updating when model changes (#3125).\n - Fixed TextInput on Plasma/Wayland receiving many empty events causing selection to be cleared (#4148)\n - Added API to programmatically show a window in fullscreen mode (C++/Rust: `Window::set_fullscreen(bool)`, Node.js: `window.fullscreen`).\n - Added API to keep the event loop alive when the last window is closed (#1499). (Rust: `slint::run_event_loop_until_quit()`; C++: argument to `slint::run_event_loop()`; Node: argument to `runEventLoop`).\n - Fixed linear gradient rendering in non square rectangles (#3730).\n - LinuxKMS backend: Added support rendering output rotation via the `SLINT_KMS_ROTATION` environment variable.\n - LinuxKMS backend: Added support for `backend-linuxkms-noseat` feature to compile without libseat.\n - LinuxKMS backend: Added support for software rendering with Skia.\n - LinuxKMS backend: Added frame throttling.\n\n### Slint Language\n\n - `if` statements no longer require parentheses.\n - Added a `double-clicked` callback in `TouchArea`, which is triggered when a `TouchArea`\n is clicked twice in rapid succession.\n - The `pointer-event` callback in `TouchArea` is now triggered on mouse move\n as well.\n - Errors are thrown when trying to modify properties that must be known at compile time.\n - Fixed property wrongly considered as const if it is modified through an alias (#4241).\n - Fixed missing invocation of init callbacks due to inlining (#4317).\n - Added `Key.Space`` to `Key` namespace.\n\n### Widgets\n\n - Fixed SpinBox not being enabled by default.\n - Fixed wrong text input in cupertino SpinBox.\n - Added focus state to `StandardListView`.\n - Added `colorize-icon` property to `Button`.\n - Added `set-selection-offsets(int, int)` to `TextInput`, `LineEdit`, and `TextEdit`.\n - Added `Palette` global singleton.\n - Added `Cosmic` style.\n - Improved `Slider` drag and click behaviour.\n\n### C++\n\n - Added `ComponentInstance::definition()` getter to retrieve the `ComponentDefinition` for an instance.\n - Added `slint::VectorModel::clear()` and `slint::VectorModel::set_vector()` to conveniently clear or replace the underlying data.\n\n### Rust\n\n - Compile-time improvements.\n - Fixed compilation when component has the same name as internal name (#4419).\n\n### JavaScript\n\n - Pre-built binaries in the npm package.\n\n### LSP\n\n - Added selection mode to select elements in the preview.\n - Implement code action to add missing import.\n - Fix error when going to the definition of built-in items (#4126).\n - Preserve underscores in property auto-completion.\n\n## [1.3.2] - 2023-12-01\n\n### General\n\n - Fixed `accepted` and `edited` callbacks in `LineEdit` not being invoked\n with Fluent, Cupertino, and Material styles.\n - Fixed coordinate of events within PopupWindow. (#4036)\n - Fixed ComboBox not selecting entries. (#4033)\n - Fixed singleshot timers started via `start(...)` to not stay in running state.\n - Fluent style: Fixed color of disabled `LineEdit`.\n\n### Slint Language\n\n - Added `KeyEvent.repeat` to detect repeated key press events.\n\n### LSP\n\n - Added support for resizing the UI under preview without resizing the window,\n by providing resize handles and scrollbars.\n - Close previous PopupWindow before refreshing the preview. (#4035)\n\n### C++\n\n - Fixed compilation on Windows when cross-compiling (for example when using esp-idf).\n\n## [1.3.1] - 2023-11-28\n\n### General\n\n - Bump various dependencies.\n - Fixed `has-hover` and `mouse-cursor` when opening a `PopupWindow`. (#3934)\n - Fluent style: fixed scrollbar size. (#3939 / #3932)\n - Skia Vulkan renderer: Fixed crash when resizing windows on X11.\n - Fixed cursor of LineEdit with right alignment (#4016)\n\n### Slint Language\n\n - Added `clamp` function that takes a `value`, `minimum` and `maximum` and will return\n `maximum` if `value > maximum`, `minimum` if `value < minimum` or `value` otherwise.\n - Throw Slint error when returning no value when one is expected instead of generating invalid code. (#3962)\n - Fixed compiler panic when a component is called `Window`. (#3916)\n\n### Rust API\n\n - Implement `std::error::Error` for `LoadImageError`.\n\n### JavaScript API\n\n - Added `loadSource` function (#3971)\n - Added `requestRedraw` to Window (#3940)\n\n### C++ API\n\n - Fixed undefined behavior in `SharedString::end()`\n\n### LSP\n\n - Fix \"recursion detected\" panic in the preview with `forward-focus`. (#3950)\n - Don't expose empty name in the outline, this caused error in vscode. (#3979)\n - Fix enum ranges in the outline.\n - Added `--fullscreen` command line option.\n\n## [1.3.0] - 2023-11-10\n\n### General\n\n - The minimum Rust version is now 1.70.\n - The `SLINT_DEBUG_PERFORMANCE` environment variable is now also compatible with the software renderer.\n - Fixed issues with text rendering and cursor positioning in elided or aligned multi-line text.\n - The default style has been changed to `fluent` on Windows and `cupertino` on macOS.\n - LinuxKMS backend: Added support for absolute motion pointer events, fixed support for touch input on scaled screens, and improved encoder/CRTC handling for EGL rendering.\n - Skia renderer / winit backend: Fall back to Skia software rendering when GPU acceleration is not available.\n - Fixed a bug where accessing model data in a callback after changing it within the same callback did not reflect the update. (#3740)\n\n### Slint Language\n\n - Added `Number`, `Decimal` variants to the `InputType` enum.\n - Added `spacing-horizontal` and `spacing-vertical` to `GridLayout`.\n - Fixed conversion in an array of an array of structs (#3574).\n - Added `scroll-event` callback to `TouchArea`.\n - Added support for `protected` functions.\n - `ComboBox` selection can now be changed by a scroll event.\n - `SpinBox` value can now be incremented and decremented by a scroll event.\n - Added `focus-changed-event` callback to `FocusScope`.\n - Added many new easing curves.\n - Added `Spinner`.\n - Added `Palette` global.\n\n### JavaScript\n\n - The system has been ported to napi-rs.\n - The API has been refreshed.\n\n### Rust\n\n - Improved support for the `slint!` macro for rust-analyzer.\n - Added `source_model()` to `MapModel`, `FilterModel`, `SortModel`, `ReverseModel` to access the inner model.\n\n### C++\n\n - Removed the need for C++ exceptions in generated code.\n - Added the ability to only build the Slint compiler or use an external compiler.\n - ESP-IDF: Wait for vsync before swapping frame buffers.\n - Fixed a crash when accessing an empty model from Slint.\n\n### LSP\n\n - Added \"Wrap in element\", \"Remove element\", \"Repeat element\", and \"Make conditional\" code actions.\n - Added a toolbar with a style picker in the preview.\n\n## [1.2.2] - 2023-10-02\n\n### General\n\n - Skia renderer: Fixed the `source` property of `Image` elements sometimes not changing when setting dynamically loaded images. (#3510)\n - Fix compiler panic with `popup.close()` from outside of the popup. (#3513)\n - Fixed native style (Qt) not finishing its animations with Breeze. (#3482)\n - Fixed native style not clipping correctly GroupBox. (#3541)\n - Fixed native style ComboBox not always being shown. (#3527)\n - Winit backend: Fixed window resizing on macOS Sonoma. (#3559)\n - Skia / FemtoVG renderers: Default to vsync swap interval when rendering with OpenGL to avoid excessive CPU usage. (#3516)\n\n### C++\n\n - Fixed cross-compilation with CMake (against Yocto SDKs)\n\n## [1.2.1] - 2023-09-19\n\n### General\n\n - Fixed generated C++ and Rust code in conversion from unnamed to named struct in complex expressions. (#2765)\n - Improved wasm preview in the documentation, especially on mobile. (#3389)\n - Improved `StandardTableView` to use `ListView` optimization for all styles. (#3425)\n - Fixed in WSL against a distro that uses X11 instead of Wayland. (#3406)\n - Added documentation about different renderers and their relation to backends.\n - Added support for partial rendering to the software renderer when used with the winit backend. (#3457)\n - Fixed builds of the Skia renderer on Windows when built from source within `vcvars.bat` environments.\n - Updated to Skia milestone 117.\n - Fixed panic when using `SLINT_FULLSCREEN=1` in combination with the Skia OpenGL renderer. (#3472)\n - Native style: Fixed scroll bar handle size for `ScrollView`. (#3489)\n - FemtoVG renderer: Fixed empty lines and vertical alignment when eliding text. (#3481)\n - Skia renderer: Fixed eliding of multi-line text. (#3481)\n - `StandardTableView`: Fixed scrollbar only responding to the second click.\n - Polished the experimental Cupertino style further.\n\n### Rust API\n\n - Derive serde traits for `slint::Color`, when the feature is active. (#3411)\n\n### C++\n\n - Fixed crash when code in a `clicked` handler in a sub-component would cause a conditional\n or repeated element to disappear. (#3465)\n - Fixed Skia renderer builds finding clang correctly.\n\n### VS Code Extension\n\n - Fixed \"Show Preview\" command when invoked from the command palette. (#3412)\n\n### Language Server\n\n - Fixed automatic indentation within named elements. (#3409)\n - Fixed panic when editing path in import statements. (#3468)\n\n\n## [1.2.0] - 2023-09-04\n\n### General\n\n - Fixed accessibility tree on Linux when UI has no repeaters.\n - Fixed native style animations.\n - Fixed setting rotation-angle and opacity from a callback.\n - Fixed touch in the `Flickable` not resulting in a click.\n - Added support for a new experimental backend that renders fullscreen on Linux using KMS (`backend-linuxkms`).\n - Calling `show()` on a component (or its window) now keeps the component alive for as long as the window\n is visible.\n\n### Slint Language\n\n - Improve reporting of diagnostics when there are errors, by attempting to run more passes.\n - Fixed compiler panic when an unresolved alias has a binding.\n - Added `edited` callback to `SpinBox`.\n - Added `row-pointer-event` callback to `StandardTableView`.\n - Fixed enabled property with `ComboBox` in Fluent Design style.\n - Fixed duplicated import when importing file relative to the project instead of the current path. Deprecated importing files relative to the project path.\n - Added `current-item-changed` to `StandardListView`.\n - Added `current-row-changed` to `StandardTableView`.\n - Added `item-pointer-event` to `StandardListView`.\n - Added `orientation` property to `Slider`.\n - Added experimental `cupertino` style.\n\n### Rust API\n\n - Implemented `Default` for `slint::Weak`.\n - Added `ReverseModel` and `ModelExt::reverse`.\n - Added `fn set_visible(&self, _visible: bool)` to the `slint::platform::WindowAdapter` trait.\n - Added ways to create a `SoftwareRenderer` without a `MinimalSoftwareWindow`.\n - The features `renderer-winit-*` were renamed to `renderer-*`.\n - Added `BorrowedOpenGLTextureBuilder` to configure more aspects of borrowed OpenGL textures.\n\n### C++\n\n - Added Platform API to write your own platform that drives its own event loop.\n - Added `SLINT_LIBRARY_CARGO_FLAGS` cmake variable.\n - Added `ReverseModel`.\n - Added functions in Window to dispatch pointer events.\n - The `slint_interpreter.h` file was renamed `slint-interpreter.h`, a deprecated header was added.\n - The features `SLINT_FEATURE_RENDERER_WINIT_*` were renamed to `SLINT_FEATURE_RENDERER_*`.\n - Extended `slint::Image::create_from_borrowed_gl_2d_rgba_texture` with an option to configure more aspects\n of texture rendering.\n - Fixed cmake dependencies of the generated header so it is generated if and only if the .slint files have changed\n\n### LSP\n\n - Fixed termination of the lsp process.\n\n## [1.1.1] - 2023-07-10\n\n### General\n\n - Fixed panic in accesskit at startup on Linux. (#3055)\n - Fixed compiler panics when some complex expressions are used for the model expression in `for` (#2977)\n - Native style: Fixed support for floating point ranges in Slider.\n - Fixed panics in the software renderer related to text rendering.\n\n### Slint Language\n\n- Added `clear-selection()` to `TextInput`, `LineEdit`, and `TextEdit`.\n- The `PointerEvent` struct now has the `modifiers: KeyboardModifiers` field.\n\n### C++\n\n - Added `slint::Window::scale_factor()` as getter to read the system device pixel ratio.\n\n### LSP\n\n - Correctly use the CARGO_MANIFEST_DIR as the base for import and image in `slint!` macro\n\n\n## [1.1.0] - 2023-06-26\n\n### General\n\n - Fixed missing items compilation error in the generated code related to public functions (#2655).\n - Added support for Window transparency on supported platforms.\n - Fixed TabWidget not filling the parent in non-native style.\n - Skia: Add support for rendering with Vulkan.\n - Wasm: Added copy and paste support.\n - Fixed TouchArea::has-hover not being reset in some cases involving multiple `TouchArea` or `Flickable` elements.\n - Fixed ListView panic when model reset in some cases. (#2780)\n - Fixed read-only `TextInput` reporting input method access. (#2812)\n - Fixed `LineEdit`'s placeholder text not being rendered with the same font attributes as regular `LineEdit` text.\n - Fixed rendering of SVGs with text. (#2646)\n - Software renderer: Show the cursor in TextInput\n\n### Slint Language\n\n - Added support for declaring enumerations.\n - Added support negative numbers in `cubic-bezier(...)` function.\n - Added `ProgressIndicator` widget.\n - Added `Switch` widget.\n - Added boolean `font-italic` property to `Text` and `TextInput`.\n - Added `select-all()`, `cut()`, `copy()`, and `paste()` to `TextInput`, `LineEdit`, and `TextEdit`.\n - Added functions on color: `transparentize`, `mix`, and `with-alpha`.\n - Added a `close()` function and a `close-on-click` boolean property to `PopupWindow`.\n - Added basic translation infrastructure with `@tr(\"...\")`.\n - Added `absolute-position` property to every element, for computing window-absolute positions.\n - Added `primary` boolean property to `Button` to configure its visual appearance.\n - Added `current-row` to `StandardTableView`.\n\n### Rust\n\n - Added `slint::Image::load_from_svg_data(buffer: &[u8])` to load SVGs from memory.\n - Added `slint::platform::WindowEvent::ScaleFactorChanged` to allow backends to report the current window scale factor.\n - Added `slint::Image::from_borrowed_gl_2d_rgba_texture` to create images from borrowed OpenGL textures.\n - In the Slint language, struct can be annotated with `@rust-attr(...)` that is forwarded as a Rust attribute (`#[...]`) for the generated struct.\n - Added a `serde` feature to enable serialization of some Slint data structures.\n - Added convenience `From` conversions for `ModelRc` from slices and arrays.\n - `slint-viewer` gained the ability to preview .rs files with a `slint!` macro.\n - Added a `spawn_local` function to run async code in the Slint event loop.\n\n### C++\n\n - Added `slint::Image::create_from_borrowed_gl_2d_rgba_texture` to create images from borrowed OpenGL textures.\n - Added `[[nodiscard]]` in a function signatures.\n - Experimental: the `slint::platform::WindowAdapter` no longer takes a template parameter and has a different constructor signature.\n\n### LSP\n\n - Fixed auto-completion of local properties or arguments in callbacks or functions.\n - Fixed panic when the editor tries to open non-local urls.\n\n### VSCode extension\n\n - Make a visible error message when the `slint-lsp` panics.\n\n## [1.0.2] - 2023-04-26\n\n### General\n\n - Fixed the compiler embedding images unnecessarily multiple times when referenced via different relative paths. (#2608)\n - Winit backend: Adjust the window size automatically when an update minimum or maximum size would constrain the existing size.\n - Winit backend: Added internal API in the `i-slint-backend-winit` crate to access the winit window\n - Fix focusing element whose base is focusable (#2622)\n - Fix infinite loop in the compiler when there is a loop in `forward-focus`\n - Skia renderer: Add support for password input fields.\n\n### C++\n\n - Fix build against macOS deployment target 10.10\n\n### VSCode extension\n\n - Fixed preview not working (#2609)\n - Added design mode commands\n - Browser extension: fix preview not previewing specific component\n\n### SlintPad\n\n - Fix editing in non-main files was getting ignored (#2630)\n\n\n## [1.0.1] - 2023-04-20\n\n### General\n\n - Fixed compiler panic when binding `Path`'s `commands` property to the field of a model entry.\n - Qt renderer: Fixed support for horizontal alignment in `TextInput`.\n - Winit backend: Fix detect of dark color scheme in some circumstances.\n - ListView: fix resizing a ListView to empty height would make all items invisible even if resized back (#2545)\n - Fixed compiler panic when accessing unset layout properties such as `spacing` or `alignment` (#2483)\n - Fixed compiler panic when accessing property from parent context in a `init =>` callback\n - Load fontconfig with dlopen instead of dynamic linking.\n - Software renderer: renders the text in TextInput\n - Fixed `TouchArea::has-hover` not becoming false when items become invisible\n\n### Slint Language\n\n - Fixed parent `FocusScope` objects stealing the focus from inner `FocusScope`s when clicked.\n - Added `TextInputInterface.text-input-focused` to detect when a virtual keyboard should open\n - Added `always-on-top` property of a `Window` to show the window above others\n - The error message when referring to an id reports a suggestion if there is a enum value or a property with the same name.\n\n### C++\n\n - macOS: Fixed `install_name` for `libslint_cpp.dylib` use `@rpath` instead of absolute paths to the build directory.\n - Fixed memory corruption when embedding images in generated C++ code.\n - Add support for dispatching key press and key release events to `slint::Window` via `dispatch_key_*_event`. This replaces\n the experimental `slint::experimental::platform::WindowAdapter::dispatch_key_event`.\n - MSVC: /bigobj is enabled by default as compile option when linking against the Slint CMake target, removing the need\n for users who run into linking issues to add that to their build.\n\n### LSP\n\n - Don't throw a protocol error when using the rename function on a symbol that can't be renamed\n - Always auto-complete widgets from the style even if no widgets is imported\n - Don't auto-complete reserved properties or sub components for globals\n - Auto-completion in the document root (component, import, global)\n\n### VSCode extension\n\n - Added an option to show the preview with wasm in a vscode tab (just like in the online version)\n - Make code lenses work better on Windows\n\n### SlintPad\n\n - Warn when ServiceWorker could not get set up (e.g. in private browsing mode on Firefox)\n - Add design mode\n\n\n## [1.0.0] - 2023-04-03\n\n### General\n\n - `TextEdit` performs better with the FemtoVG renderer when showing many lines.\n - Software renderer: Added support for linear-gradients.\n - Software renderer: Fixed artifacts when components are deleted or elements become invisible.\n - Fixed Infinite loop in the accessibility backend on Windows (#2195).\n - Skia renderer: Enable anti-aliasing for rectangles with border radius.\n - Fluent style: Adjust disabled scrollbar background color.\n - Fixed several panics in the compiler (#2312, #2274, #2319).\n - Winit backend: Fix rendering when moving windows between monitors with a different scale factor (#2282).\n\n### Slint Language\n\n - The old syntax that declares component with `:=` is now deprecated\n - `Flickable`: don't forward events if the flickable is dragged in a direction that can be dragged, even if at the bounds.\n - The `TextEdit` and `LineEdit` elements now correctly handle double click and triple click to select words or lines,\n as well as support for the \"primary\" clipboard on X11 and wayland (select to copy, and middle click to paste).\n\n### Rust\n\n - Minimum Rust version is now 1.66.\n - **Breaking:** Deprecated functions and enums were removed from the API.\n - **Breaking:** `PointerEventButton::None` was renamed `PointerEventButton::Other`\n - **Breaking:** More functions now return `Result`, and the return value needs to be `unwrap()`'ed.\n - **Breaking:** A lifetime parameter was added to `slint::ModelPeer`.\n - **Breaking:** `StandardListViewItem` and `TableColumn` are now marked as `#[non_exhaustive]`.\n - **Breaking:** Removed the `stride()` function from `slint::Image` - use `width()` instead.\n - **Breaking:** In `slint::platform::WindowEvent::KeyPressed` and `KeyReleased`, the `text` field is now\n a `slint::SharedString`.\n - **Breaking:** `slint::platform::WindowEvent` does not derive from `Copy` anymore. You must `clone()` it\n explicitly if you want to create a copy.\n - **Breaking:** The `MAX_BUFFER_AGE` const parameter of `slint::platform::software_renderer::MinimalSoftwareWindow`\n has been removed and replaced by an argument to the `new()` function.\n - **Breaking:** The `compat-0-3-0` mandatory cargo feature flag was renamed to `compat-1-0`.\n - Added a `software-renderer-systemfonts` feature to the Rust crate, to enable the use of fonts from the operating system\n for text rendering with the software renderer.\n - Fixed some clippy warnings in the generated Rust code.\n\n### C++\n\n - Functions that take a functor as an argument are now using C++ 20 concepts.\n - **Breaking:** In the C++ API, the type for row indexes in models was changed from `int` to `size_t`.\n This includes arguments of virtual functions in `slint::Model` that needs to be adjusted in\n derived classes.\n - **Breaking:** The order of C++ generated struct members is now preserved from the .slint source file.\n - Add constructors to `slint::Image` to create images from raw pixel data.\n - In C++ builds, support all image formats the Rust image-rs crate supports, not just png and jpeg.\n - Added the `SLINT_FEATURE_RENDERER_WINIT_SOFTWARE` option to enable the software renderer.\n\n### Tooling\n\n - LSP: don't add spaces when auto-completing elements or callbacks, leads to better formatting.\n - The online editor was renamed to SlintPad.\n\n## [0.3.5] - 2023-02-21\n\n### Fixed\n\n - FemtoVG: Fix cursor placement at end of lines\n - Windows: Fix panic when minimizing windows\n - Fixed some panics in the software renderer when using text\n - Fixed panic when parsing invalid linear gradient syntax\n - Qt: Fixed mapping of the control key\n - Linux: Fix panic when using GLX\n - Fixed const detection when using two-way bindings\n - Fix run-time panic when combining forward-focus with text rendering in no_std environments\n - Rust: Fix compile issues when generated code clashes with user types\n - C++: Fix compilation with structs that have a field with the same name as the struct\n - Fix visible property on the root of a component\n - Fix compiler panic when an component's base is not inlined\n - C++: fix including the generated file in several translation units\n - C++: Fix \"make install\" on Windows\n\n### Added\n\n - The StandardListView provides now a set-current-item function to set the selected item and bring it into view.\n\n## [0.3.4] - 2023-01-25\n\n### Changed\n\n - A new syntax is available that declares the components with `component Xxx { ... }` instead of `Xxx := ...`.\n The old syntax continues to work in this release.\n - A warning is shown when calling non-pure function or callback from pure context (eg: a property binding).\n Callbacks and functions can be annotated with `pure`.\n - On an `Image`, the default value of `source-clip-width` and `source-clip-height` is now set to\n the size of the image minus the `source-clip-{x,y}`. The source clip size is now used to compute\n the default aspect ratio of the image.\n - Deprecated `invoke_callback` functions in the slint interpreter in favor of `invoke`, which can also\n invoke functions in addition to callbacks.\n - Warn if the last component or singleton in a file is implicitly marked for exporting.\n\n### Added\n\n - `StandardTableView` widget.\n - LSP: support of Slint features (auto-complete, preview, ...) in `slint!{}` macro in Rust files.\n - The software renderer can now load fonts at run-time, without the need to pre-render glyphs\n at compile time.\n - The preview in the online editor, VS Code extension, and the VS Code web extension highlight\n components while the cursor is on the component type name.\n\n### Fixed\n\n - Compiler panic for files containing no component (#2005).\n - Calling public functions from native code.\n - Fixed crash when using repeaters in C++ on 32-bit architectures.\n - Conversion of array literal containing struct with array literal (#2023).\n - Structs exported by the main file are always generated in native code (#594).\n\n## [0.3.3] - 2022-12-16\n\n### Changed\n\n - Minimum rust version is now 1.64.\n\n### Added\n\n - Added support for declaring functions in the language.\n - Added support for re-exporting types from other files using `export * from \"./other_file.slint\";`.\n - LSP: highlight and renaming of element id.\n - online editor: Add zoom to the preview.\n - VSCode and online editor: Added UI to edit and remove property bindings.\n\n### Fixed\n\n - Fixed privacy rules in global properties. #1951\n - Fixed drawing of images with the software renderer.\n - Fixed `visible` property on element with drop shadow. #1460\n - Warn on bad use of ListView. #860\n - Fixed two way bindings between globals.\n - Fixed scrolling of preview area in online editor.\n - Fixed the CMake build to respect `CMAKE_*_OUTPUT_DIRECTORY` variables. #1979\n - Fixed build when using `renderer-winit-skia-opengl` on macOS or Windows.\n\n\n## [0.3.2] - 2022-11-28\n\n### Changed\n\n - When using a two way binding `foo <=> bar`, the default value will always be the one of `bar`.\n There was a warning about this change in previous versions (#1394).\n - Disallow overrides or duplicated declarations of callbacks. Previously they were silently overwritten,\n now an error is produced.\n - The name `init` is now a reserved name in callbacks and properties.\n - In the interpreter, calling `set_property` or `get_property` on properties of the base returns an error.\n - Deprecated `slint::WindowEvent` and `slint::PointerEventButton` and moved them to the `slint::platform` module.\n - Renamed the `Keys` namespace for use in `key-pressed`/`key-released` callbacks to `Key`. The\n old name continues to work.\n - The style or the backend now always set a value for the `Window`'s `default-font-size` property.\n - In the Rust API, the `GraphicsAPI`'s `NativeOpenGL` variant uses a function signature for `get_proc_address` that\n takes a `&std::ffi::CStr` instead of a `&str` to match the native APIs and avoid unnecessary conversions.\n\n### Added\n\n - Added new `material` style based on Material Design, with `material-light` and `material-dark` as variants.\n - Added `Window::is_visible` in Rust and C++.\n - Added `From` for `SharedString` in Rust.\n - Added `KeyPressed` and `KeyReleased` variants to `slint::WindowEvent` in Rust, along\n with `slint::platform::Key`, for use by custom platform backends.\n - Added support for the implicitly declared `init` callback that can be used to run code when\n an element or component is instantiated.\n - Properties can be annotated with `in`, `out`, `in-out`, or `private`.\n - Transitions can now be declared directly within the state.\n - Online editor: The property view can now edit properties.\n - LSP preview: When the cursor is on the name of an element, the element's location is highlighted in the preview.\n - LSP: Added a setting to change the style and the include paths.\n - VSCode extension: added the property view.\n - Added `rem` as unit that represents a relative font size and is multiplied with the `Window.default-font-size` when used.\n - Added `relative-font-size` as type that holds values of `rem`.\n\n### Fixed\n\n - Fluent style: SpinBox gets focus when buttons are clicked.\n - Software renderer: Fix drawing the background color.\n - Fix Rust code generation when comparing percentages (#1837).\n - Fix `visible` property in `for` and `if` (#1846).\n\n## [0.3.1] - 2022-10-28\n\n### Changed\n\n - The property `Window::background` is now a brush instead of a color (allowing gradients).\n - Switch to yeslogic-fontconfig-sys from servo-fontconfig dependency. This allows for fontconfig\n to be a run-time dependency via dlopen.\n - Skia renderer: Improvements to text input.\n\n### Added\n\n - Added `slint::FilterModel`, `slint::MapModel` to the C++ API.\n - Added `slint::SortModel` to Rust and C++ API.\n - Added `VecModel::extend` and `VecModel::extend_from_slice`.\n - Online editor: Added \"Properties\" and \"Outline\" tabs.\n - Added initial support for input methods with pre-edit text.\n - Added a dark theme for the Fluent style, which is automatically selected if the system\n color scheme is dark.\n - Added `fluent-light` and `fluent-dark` as explicit styles to select a light/dark variant,\n regardless of the system color scheme setting.\n\n### Fixed\n\n - TextInput now shows the text mouse cursor.\n - In Flickable, added a small delay before passing the Press pointer event to the children.\n - Online editor: Fixed \"go to definition\" across files.\n - Fixed a panic in the slint compiler when visiting layout properties for loop analysis (#1659).\n - Fixed compilation error in the generated code (#1733, #1735).\n\n## [0.3.0] - 2022-09-14\n\n### Breaking Changes\n\n - `mod` now works on any numeric type, not only integers.\n - Minimum rust version is now 1.60.\n - The \"backend-gl-*\" Rust crate features for configuring the GL renderer have been\n changed and split by renderer.\n - `VecModel::remove` now returns the removed element.\n - `slint::invoke_from_event_loop` and `slint::quit_event_loop` now return a Result.\n\n### Added\n\n - Added the `platform` module providing API to use slint on bare metal with a software renderer.\n - Added an experimental Skia renderer.\n - `Button`: Add a `checkable` property that turns the button into a toggle\n button. Use the new `checked` property to query whether the toggle button\n is pressed down or not.\n - Added support for `slint::Window::set_position` and `slint::Window::position` to set and get the\n placement of the window on the screen.\n - Added `slint::Window::scale_factor()` as getter to read the system device pixel ratio.\n - Added support for `slint::Window::set_size` and `slint::Window::size` to set and get the\n size of the window on the screen.\n - Added `slint::Window::dispatch_event` and `slint::WindowEvent` to be able to manually\n send a mouse or touch event to a window.\n - Added `animation-tick()`.\n - `SharedString` implements `std::fmt::Write` and added `slint::format!`.\n - `Image` can now be rotated with the `rotation-*` properties.\n - Use docking widgets and integration of slint-lsp into the [Online Code Editor](https://slint.dev/editor).\n\n\n### Fixed\n - Fixed Ctrl+Backspace/Ctrl+Del not deleting words in text input elements.\n - Resizing of live-preview window in the IDE integrations.\n - Preferred size of the TabWidget in the fluent style take in account the size of the tabs (#1363).\n - Fixed cursor behavior when typing the Enter key at the end of a TextEdit (#1318).\n - Fixed a memory leak of images when using the GL backend.\n - Fixed starting and stopping `slint::Timer` from within their callback (#1532).\n\n## [0.2.5] - 2022-07-06\n\n### Changed\n\n - Interpreter: Implement `TryFrom` instead of `TryInto for Value` (#1258)\n\n### Added\n\n - Added the Model Adapters `FilterModel` and `MapModel`.\n - Added `@radial-gradient(circle, ...)`\n - Added `read-only` property to `TextInput`, `TextEdit` and `LineEdit`.\n - VSCode extension can be installed as a web extension. (eg, from https://vscode.dev)\n - LSP: completion of `@` macros\n - LSP: completion of element that require an import\n - Basic accessibility support using the `accessible-` properties\n\n### Fixed\n\n - GL backend: Fixed animation sometimes not starting from input event (#1255)\n - C++ fix compilation when writing to the model data\n - Fix mouse exit events not triggered by scrolling a Flickable (#1107)\n\n## [0.2.4] - 2022-05-09\n\n - Fixed crash when opening a native (Qt) ComboBox\n\n## [0.2.3] - 2022-05-09\n\n### Fixed\n\n - Fixed crashes with the Qt backend in release mode. (#1230)\n - Fixed panic when drop-shadow is used in a ListView (#1233)\n - Fixed combining a brush and a color to always convert to brush, to avoid losing gradient information (#1235)\n - Fixed properties not having the right default value when set by some states (#1237)\n - Fixed properties with multiples aliases, and default values.\n - Enable fontdb's fontconfig feature to fix finding some fonts (#1240)\n\n## [0.2.2] - 2022-05-04\n\n### Changed\n - On wasm, the input event are handled via a hidden `` element, allowing the keyboard\n to show on mobile platform\n - The size of the window is kept when reloading a window in the preview (instead of being reset to the preferred size)\n - Minimum rust version is now 1.59\n\n### Added\n\n - Support for keyboard focus with the tab key\n - Support more keyboard shortcut in the editing element\n - Added `From<&str>` and `From` to `StandardListViewItem` to make creation and modification of `StandardListView`'s models easier.\n - Added `on_close_requested` function to `Window` to register callbacks that are emitted when the user tries to close a window.\n - Added `VecModel::set_vec` to replace the entire contents with new data.\n - Added a `cache-rendering-hint` boolean property that can be applied to any element, to hint to the renderer that it should cache the element and its children\n into a cached layer. This may speed up rendering of complex sub-trees if they rarely change.\n - The `brighter` and `lighter` functions also work on values of type brush.\n - Added a `reset` function to C++'s `Model`, Rust's `ModelNotify` and JS's `ModelPeer`\n - Added a `row_data_tracked` function to `ModelExt` (an extension to the Model trait)\n\n### Fixed\n\n - Fixed application of the `opacity` property evenly to child elements (#725).\n - Windows: Fixed font lookup of strings including several scripts (eg, containing asian characters)\n - Fixed PopupWindow in a repeater (#1113, #1132)\n - LSP: do not always resize the preview window to its preferred each time the code is modified\n\n## [0.2.1] - 2022-03-10\n\n### Added\n\n - C++ interpreter API: added a `Value::Value(int)` constructor\n - Global singletons in `.slint` files may now refer to other global singletons\n - Added `input-type` property to `TextInput` and `LineEdit` that allows for characters to be replaced in password fields\n - The `SpinBox` widget now handles up and down key events\n\n### Fixed\n\n - `TouchArea::has-hover` is now properly set to false when the mouse leaves the window\n - Fixed some cases of panics with 'Constant property being changed'\n - Fixed `Flickable` animation\n - Better compilation error when selecting unknown styles\n - Fixed duplicated key event for some keys (such as tab) with the GL backend\n - Improved property optimizations by inlining some bindings and remove more unused properties\n\n## [0.2.0] - 2022-02-10\n\nThis version changes some APIs in incompatible ways. For details how to migrate your application code, see the [C++ migration guide](api/cpp/docs/cpp_migration.md)\nas well as the [Rust migration guide for the `sixtyfps` crate](api/rs/slint/migration.md) and for the\n[`slint-interpreter` crate](internal/interpreter/migration.rs).\n\n### Changed\n\n - Minimum rust version is now 1.56\n - C++ compiler requires C++20\n - In the C++ interpreter API `std::span` is used for callbacks arguments, instead of `sixtyfps::Slice`\n - `Model::row_data` will now return a `Option` / `std::optional` instead of a plain `T`.\n - `Model::model_tracker` no longer has a default implementation.\n - The deprecated methods `Model::attach_peer` and `ModelNotify::attach` were removed.\n - The interpreter does not differentiate anymore between `Value::Array` and `Value::Model`\n everything is a `Value::Model`, which now contains a `ModelRc`\n - In Rust, `slint::SharedPixelBuffer` and `slint::SharedImageBuffer` now use a `u32` instead of `usize` for `width`, `height` and `stride`.\n - In Rust and C++, `slint::Image::size()` now returns an integer size type.\n - `sixtyfps::interpreter::CallCallbackError` was renamed to `slint::interpreter::InvokeCallbackError`\n - Some deprecation warning in .60 became hard errors\n - Replace `ModelHandle` with `ModelRc`\n - `slint::interpreter::ComponentInstance` in Rust now implements `slint::ComponentHandle`. This removes `sixtyfps_interpreter::WeakComponentInstance` in favor\n of `slint_interpreter::Weak`.\n - For the Rust API crate, the Rust Interpreter API crate, the `backend-gl`, `x11`, and `wayland` features were renamed to `backend-gl-all`, `backend-gl-x11`, and `backend-gl-wayland`.\n - For the C++ CMake interface, the `SIXTYFPS_BACKEND_GL`, `SIXTYFPS_FEATURE_X11`, and `SIXTYFPS_FEATURE_WAYLAND` options were renamed to `SLINT_BACKEND_GL_ALL`, `SLINT_FEATURE_BACKEND_GL_X11`, and `SLINT_FEATURE_BACKEND_GL_WAYLAND`.\n - The animation `loop-count` property was replaced by `iteration-count` (which is the same as `loop-count` plus one)\n\n### Added\n\n - `TextEdit::font-size` and `LineEdit::font-size` have been added to control the size of these widgets.\n - Added `slint::Window::set_rendering_notifier` to get a callback before and after a new frame is being rendered.\n - Added `slint::Window::request_redraw()` to schedule redrawing of the window contents.\n\n### Fixed\n\n - Models initialized from arrays are now also mutable when run in the interpreter.\n - Fixed compilation error when accessing object members of array through the array index syntax\n\n## [0.1.6] - 2022-01-21\n\n### Changed\n\n - **Breaking:** The internal key code for the keys left, right, home and end\n has changed. This was undocumented, but if you were handling this in the\n `FocusScope` event, these keys will now be ignored. Use the `Keys.LeftArrow`\n and other code exposed in the `Keys` namespace instead.\n - For `sixtyfps::Timer` (C++ and Rust), it's now possible to call `restart()` after\n a timer has been stopped previously by calling `stop()`.\n - Property access in `.60` was optimized by doing more constant propagation.\n\n### Added\n\n - Color names can now be accessed through the `Colors` namespace (in `.60`).\n - Math function are now available through the `Math` namespace (in `.60`).\n - `TouchArea` gained a `mouse-cursor` property to change the mouse cursor.\n - C++: Added `SIXTYFPS_VERSION_MAJOR`/`SIXTYFPS_VERSION_MINOR`/`SIXTYFPS_VERSION_PATCH` version macros.\n - More special keyboard key codes are provided in the `FocusScope`, and\n special keys are handled\n - `start()`, `stop()`, `running()` and a default constructor for C++ `sixtyfps::Timer`\n - Added math functions `log`, and `pow`.\n - Property animations now have a `delay` property, which will delay the start\n of the animation. Use this to create sequential animations.\n - Rust: Added `sixtyfps::VecModel::insert(&self, index, value)`.\n - C++: Added `sixtyfps::VecModel::insert(index, value)`.\n - Added ability to access elements of a model with the `[index]` syntax.\n\n### Fixed\n\n - Memory leak in C++.\n - Native style: Colors are updated automatically when the Windowing system switches to and from dark mode (#687)\n - Ctrl/Command+X in text fields copies the selected text to the clipboard and deletes it (cut).\n - Improved native ComboBox look.\n - Fixed panics or compilation error when using two way bindings on global properties.\n\n## [0.1.5] - 2021-11-24\n\n### Changed\n\n - The sixtyfps compiler no longer \"inline\" all the elements, resulting in faster compilation\n time and smaller binaries.\n - Implemented basic constant propagation in the sixtyfps compiler\n\n### Fixed\n\n - The Slider's changed callback was not being called with the fluent style (#621).\n - Fixed compilation error in C++'s `sixtyfps::blocking_invoke_from_main_loop` when the callable returns `void` (#623).\n - Improve rendering quality on High-DPI screens on Windows when using Qt.\n - Fixed linking errors when selecting the native style on Windows with C++.\n - Fixed the maximization button in the window decoration when a window has a fixed size.\n\n## [0.1.4] - 2021-10-22\n\n### Changed\n\n - The TouchArea now grabs the mouse for every button instead of just the left button.\n - The ScrollView's default viewport size is no longer hardcoded to 1000px but depends on the contents.\n - In Rust, the `sixtyfps::Model` trait deprecates the `attach_peer` function in favor of `model_tracker`, where all\n you need to do is return a reference to your `sixtyfps::ModelNotify` field.\n\n### Added\n\n - Enable support for compressed SVG (.svgz).\n - Viewer: added possibility to set shell callback handler with `--on `.\n - It is now possible to query the length of a model with `.length`.\n\n### Fixed\n\n - Fixed the `PointerEvent.kind` always being down.\n - `LineEdit.has-hocus` with the native style\n\n## [0.1.3] - 2021-10-06\n\n### Changed\n\n - Due to changes in the build system, the C++ build now requires CMake >= 3.19.\n - Fluent style: The Slider and ScrollBar now updates as the mouse moves.\n - Parentheses around callable expression is now deprecated.\n - Naming a callback without calling it is now a hard error instead of producing error in the generated code.\n\n### Added\n\n - New `no-frame` property of a `Window` which changes it to borderless/frameless\n - sixtyfps-compiler and slint-viewer can read the .60 file content from stdin by passing `-`\n - slint-viewer gained ability to read or save the property values to a json file with `--save-data` and `--load-data`\n - New `StandardButton` widget\n - New `Dialog` element\n - `sixtyfps::Image` has now a `path()` accessor function in Rust and C++ to access the optional path\n of the file on disk that's backing the image.\n - New `moved` and `pointer-event` callback in `TouchArea`\n - New `AboutSixtyFPS` widget\n\n### Fixed\n\n - Fixed panic when using `TabWidget` with `Text` elements and the native style.\n - Fixed panic when calling `hide()` on a `sixtyfps::Window` from within a callback triggered by keyboard/mouse input\n when using the GL backend.\n - Rust: The implementation of ModelModel::set_row_data now forward the call to the inner model\n\n## [0.1.2] - 2021-09-09\n\n### Changed\n\n - Apply the default text color from the style for the `color` of `Text` and `TextInput` elements, to contrast\n correctly with the application of `Window`'s `background` property.\n - LineEdit scrolls to keep the cursor visible\n - The `clicked` callbacks are now only emitted if the release event is within the TouchArea's geometry\n - parentheses around the condition are no longer needed in `if` elements: `if condition : Foo { ... }`\n\n### Added\n\n - One can now set an alias from the root to a global callback\n - It is now possible to access properties and callback of exported global objects from the native code (#96)\n - C++ API: `blocking_invoke_from_event_loop`: a blocking version of `invoke_from_event_loop`\n - TextInput can support multiple line by setting single-line to false\n - The CMake integration now allows enabling/disabling SixtyFPS library features, such as Wayland support\n or the dynamic run-time interpreter.\n - Added `image-rendering` property to Image to control how the image is scaled\n - `TextEdit` widget\n - Support for semantic tokens in LSP\n\n### Fixed\n - The interpreter API correctly return an error instead of panicking when setting properties or calling callbacks\n that don't exist\n - The `has-hover` property is correctly reset the false when releasing the mouse outside the touch area\n\n## [0.1.1] - 2021-08-19\n\n### Changed\n - Fixed lookup scope when resolving model expression in `for` or `if` constructs:\n the `self` element now refers to the correct element instead of the root.\n - Rust: default to the native style if Qt is available\n - Rust: deprecated `SharedVector::as_slice_mut()`. Use `SharedVector::make_mut_slice()` instead.\n - The default non-native widget style is now the new \"fluent\" style.\n - The internal normalization of identifiers is using `-` instead of `_`, this is an internal\n change, but it can be seen in error messages. When listing properties the identifiers are\n preserved. For fields in structures they are normalized.\n- Show a compilation error when there are duplicated element ids.\n - The `clip` property can now be any expression.\n\n### Added\n\n - `ComboBox` now has a `selected` callback.\n - `Window` now has an `icon` property.\n - Added `sixtyfps::Weak::upgrade_in_event_loop` in the Rust API.\n - Added `sixtyfps::Model::as_any()` in the Rust API.\n - Added conversion between `sixtyfps::Image` and `sixtyfps::interpreter::Value` in the C++ API.\n - Properties of type `angle` and `duration` are allowed in the public API.\n - Every element now has a `visible` property.\n - `Slider` now has a `changed` callback.\n - Added `TabWidget` widget.\n - Rust: `sixtyfps::Image` can now be constructed from image data provided by `sixtyfps::SharedPixelBuffer`.\n This enables integrating with other low-level software rendering or the popular Rust image crate.\n - VSCode extension: added an option to specify command line arguments for the LSP.\n\n### Fixed\n\n - GridLayout cells with colspan and rowspan respect properly their constraints.\n - Don't panic when replacing programmatically text in a `TextInput` and then editing it.\n - The default height of elements in a ListView no longer defaults to 100%.\n - Fixed support for `*=` and `/=` on types with unit such as length.\n - Don't panic when using a self assignment operator on an invalid type - this produces a compiler error\n instead.\n - Fixed angle conversion for values specified in radians, gradians and turns.\n - Fixed SharedVector sometimes not allocating big enough storage.\n\n## [0.1.0] - 2021-06-30\n\n### Changed\n\n - Layouts are now conceptually their own elements, meaning that the `x` and `y` properties of items\n within layouts are relative to the layout and no longer to the parent element of layouts.\n - The default spacing and padding of layouts is now 0 instead of being specific to the style.\n There are now `HorizontalBox`, `VerticalBox`, `GridBox` widgets which have default spacing and padding.\n - Setting the window `height` and `width` properties results in a fixed size. The `preferred-width`\n and `preferred-height` property can be used to set the initial size and the window remains resizable\n by the user, if the window manager permits.\n - Binding loops are now detected at compile-time instead of panic at runtime.\n - The `viewer` binary was renamed to `slint-viewer` and is now available via `cargo install` from crates.io.\n - The layout properties `minimum-width`, `maximum-height`, etc. were renamed to a shorter version `min-width`,\n `max-height`. The old names are still supported as a deprecated alias.\n\n### Added\n\n - Warnings are now shown in the online code editor.\n - `sixtyfps::invoke_from_event_loop` was added to the C++ and Rust APIs, to run a function in the UI thread from any thread.\n - `sixtyfps::run_event_loop()` and `sixtyfps::quit_event_loop()` were added to the Rust and C++ APIs to start and quit the main event loop.\n - `z` property on items.\n - The type in two-way bindings can now be omitted.\n - It's possible to declare aliases for callbacks (`callback clicked <=> other.clicked;`)\n - `abs()` function to get the absolute value\n - The root element of an `if` or `for` can be given a name (`if (condition) name := Rectangle {}`)\n - `sixtyfps::Image` is a new type in the public Rust and C++ API to load images from a path.\n - The width and height of images is now accessible via the `width`or `height` of an `image` type property in .60 files (`some-image.source.width`)\n\n### Fixed\n\n - Fixed Mouse wheel to work on the `Flickable` element and derivatives.\n - Fixed generated C++ code on Windows.\n - Calling `debug(...)` no longer breaks the LSP.\n - `ComponentDefinition::properties` only exposes public properties as documented.\n - Many more bugfixes\n\n## [0.0.6] - 2021-04-27\n\n### Changed\n - `Rectangle::color` was deprecated and replaced by `Rectangle::background`, same for `Window::color`\n - `Path::fill-color` was renamed to `fill`, and `Path::stroke-color` was renamed to `stroke`, which are now brushes instead of color\n - Many other color property became brush in order to support gradients\n - the `resource` type was renamed to `image`\n - Calling a callback is done from C++/Rust with `invoke_` instead of `call_`\n\n### Added\n - `@linear-gradient` can be used to have gradients on rectangle and paths\n - `Image::colorize` allows to apply a color filter on image\n - `0` can be converted to anything with units\n - Support power of unit in intermediate expression. (eg: `3px * width / height` is now supported but used to be an error)\n - Support for `else if`\n - The path fill rule can now be specified using `Path::fill-rule`.\n - Support for `letter-spacing` in `Text`/`TextInput` elements.\n - `rgb()` / `rgba()`\n - Layout in Flickable\n - LSP server with Live Preview and basic auto completion\n - The viewer tool gained the `--auto-reload` argument\n - `Window.default-font-weight`\n - Added `opacity` property that can be applied to elements\n - Added `clip` property in Rectangle, including clipping for rounded rectangle\n - API to load dynamically .60 files from C++ and Rust, including a way to embed sixtyfps widgets in Qt applications\n - Preferred size in Layouts\n - Math functions such as `sin`, `cos`, `sqrt`, ...\n - New printer demo design\n - Ability to load custom fonts using `import` statements\n\n### Fixed\n - `Image::image-fit`'s `cover` and `contains` variant are fixed to match the CSS spec\n - Flickable without scrollbar\n - Multiplying and dividing different units.\n - Many more bugfixes\n\n## [0.0.5] - 2021-01-29\n\n### Changed\n - Renamed \"signal\" to \"callback\"\n - And calling a callback is done from C++/Rust with `call_` instead of `emit_`\n - Renamed \"SharedArray\" to \"SharedVector\" in the C++/Rust API\n - Renamed Slider min and max property to minimum and maximum\n - The graphics rendering backend was changed to use femtovg or Qt\n - Renamed `initial-focus` to `forward-focus` as focus related property on elements\n - The \"align-\" prefix was removed from `TextHorizontalAlignment` and `TextVerticalAlignment`. Either\n change `align-left` to `left` or qualify with `TextHorizontalAlignment.left`.\n - `img!\"...\"` is replaced by `@image-url(\"...\")`\n - `$children` is replaced by `@children`\n\n### Added\n - `title` property to the Window element\n - `color` property to the Window element\n - `maximum`/`minimum` properties to the `SpinBox`\n - strings can contain escape codes\n - `FocusScope` to handle key events\n - `return` statements\n - `Text` word wrap and elide\n - `drop-shadow-*` properties (limited to `Rectangle` at the moment)\n - `Color.brighter` / `Color.darker`\n - `Window.default-font-family` and `Window.default-font-size`\n\n\n## [0.0.4] - 2020-12-14\n\n### Changed\n - Changed Rust `build.rs` API to use an opaque compiler configuration type\n - With Rust, image resources are embedded in the binary by default.\n - Updated winit version\n - Updated Neon Version\n\n### Fixed\n - Fixed animations sometimes stopping mid-way.\n - Fixed rendering of C++ components\n - Fixed disabled widgets\n\n## [0.0.3] - 2020-12-09\n\n### Changed\n - In C++, the generated component is now wrapped by a `ComponentHandle` smart pointer that acts like `std::shared_ptr`. New instances\n are created using `T::create()`.\n - In Rust, the generated component implements `Clone` and acts like an `Rc`. `sixtyfps::Weak` can be used to hold weak references.\n - `ARGBColor` was renamed `RgbaColor`\n - `width and `height` of some built-in elements now default to 100% of the parent element.\n\n### Added\n - Allow dashes in identifiers (#52)\n - VerticalLayout / HorizontalLayout\n - Placeholder text in `LineEdit`\n - global components (#96)\n - `Clip` element\n - `ComboBox` element\n - `PopupWindow` element\n - `Image` element: New source-clip-{x, y, width, height} properties\n - `sixtyfps::Timer` in Rust API\n - Transitions are now implemented\n - `round`/`ceil`/`floor`/`mod`/`max`/`min`/`cubic-bezier` functions\n - Signals can have return a value\n - `has_hover` property in `TouchArea`\n - `font-weight` property on Text\n - `viewbox-x/y/width/height` and `clip` properties for `Path`\n\n\n## [0.0.2] - 2020-10-22\n\n### Changed\n - Default to the native style in the `viewer`, if available.\n - Changed the name of the common logical pixel unit from `lx` to `px`. The less\n often used physical pixel has now the `phx` suffix.\n\n### Added\n - Add support for more keyboard shortcuts to `TextInput`.\n - Added a `current_item` to `StandardListView`.\n - API cleanup in sixtyfps-node\n\n### Fixed\n - Fix occasional hang when navigating in `TextInput` fields with the cursor keys.\n - Fix access to aliased properties from within `for` and `if` expressions.\n - Fix `ScrollView` being scrollable when it shouldn't.\n - Fix appearance of natively styled scrollbars.\n - Allow converting an object type to another even if it is missing some properties.\n - Add missing frame drawing around `ScrollView`.\n - Fix Clipping in scroll views in WASM builds.\n - Fix resizing of `ListView`.\n - Many more bugfixes\n\n## [0.0.1] - 2020-10-13\n - Initial release.\n\n[0.0.1]: https://github.com/slint-ui/slint/releases/tag/v0.0.1\n[0.0.2]: https://github.com/slint-ui/slint/releases/tag/v0.0.2\n[0.0.3]: https://github.com/slint-ui/slint/releases/tag/v0.0.3\n[0.0.4]: https://github.com/slint-ui/slint/releases/tag/v0.0.4\n[0.0.5]: https://github.com/slint-ui/slint/releases/tag/v0.0.5\n[0.0.6]: https://github.com/slint-ui/slint/releases/tag/v0.0.6\n[0.1.0]: https://github.com/slint-ui/slint/releases/tag/v0.1.0\n[0.1.1]: https://github.com/slint-ui/slint/releases/tag/v0.1.1\n[0.1.2]: https://github.com/slint-ui/slint/releases/tag/v0.1.2\n[0.1.3]: https://github.com/slint-ui/slint/releases/tag/v0.1.3\n[0.1.4]: https://github.com/slint-ui/slint/releases/tag/v0.1.4\n[0.1.5]: https://github.com/slint-ui/slint/releases/tag/v0.1.5\n[0.1.6]: https://github.com/slint-ui/slint/releases/tag/v0.1.6\n[0.2.0]: https://github.com/slint-ui/slint/releases/tag/v0.2.0\n[0.2.1]: https://github.com/slint-ui/slint/releases/tag/v0.2.1\n[0.2.2]: https://github.com/slint-ui/slint/releases/tag/v0.2.2\n[0.2.3]: https://github.com/slint-ui/slint/releases/tag/v0.2.3\n[0.2.4]: https://github.com/slint-ui/slint/releases/tag/v0.2.4\n[0.2.5]: https://github.com/slint-ui/slint/releases/tag/v0.2.5\n[0.3.0]: https://github.com/slint-ui/slint/releases/tag/v0.3.0\n[0.3.1]: https://github.com/slint-ui/slint/releases/tag/v0.3.1\n[0.3.2]: https://github.com/slint-ui/slint/releases/tag/v0.3.2\n[0.3.3]: https://github.com/slint-ui/slint/releases/tag/v0.3.3\n[0.3.4]: https://github.com/slint-ui/slint/releases/tag/v0.3.4\n[0.3.5]: https://github.com/slint-ui/slint/releases/tag/v0.3.5\n[1.0.0]: https://github.com/slint-ui/slint/releases/tag/v1.0.0\n[1.0.1]: https://github.com/slint-ui/slint/releases/tag/v1.0.1\n[1.0.2]: https://github.com/slint-ui/slint/releases/tag/v1.0.2\n[1.1.0]: https://github.com/slint-ui/slint/releases/tag/v1.1.0\n[1.1.1]: https://github.com/slint-ui/slint/releases/tag/v1.1.1\n[1.2.0]: https://github.com/slint-ui/slint/releases/tag/v1.2.0\n[1.2.1]: https://github.com/slint-ui/slint/releases/tag/v1.2.1\n[1.2.2]: https://github.com/slint-ui/slint/releases/tag/v1.2.2\n[1.3.0]: https://github.com/slint-ui/slint/releases/tag/v1.3.0\n[1.3.1]: https://github.com/slint-ui/slint/releases/tag/v1.3.1\n[1.3.2]: https://github.com/slint-ui/slint/releases/tag/v1.3.2\n[1.4.0]: https://github.com/slint-ui/slint/releases/tag/v1.4.0\n[1.4.1]: https://github.com/slint-ui/slint/releases/tag/v1.4.1\n[1.5.0]: https://github.com/slint-ui/slint/releases/tag/v1.5.0\n[1.5.1]: https://github.com/slint-ui/slint/releases/tag/v1.5.1\n[1.6.0]: https://github.com/slint-ui/slint/releases/tag/v1.6.0\n[1.7.0]: https://github.com/slint-ui/slint/releases/tag/v1.7.0\n[1.7.1]: https://github.com/slint-ui/slint/releases/tag/v1.7.1\n[1.7.2]: https://github.com/slint-ui/slint/releases/tag/v1.7.2\n[1.8.0]: https://github.com/slint-ui/slint/releases/tag/v1.8.0\n[1.9.0]: https://github.com/slint-ui/slint/releases/tag/v1.9.0\n[1.9.1]: https://github.com/slint-ui/slint/releases/tag/v1.9.1\n[1.9.2]: https://github.com/slint-ui/slint/releases/tag/v1.9.2\n[1.10.0]: https://github.com/slint-ui/slint/releases/tag/v1.10.0\n[1.11.0]: https://github.com/slint-ui/slint/releases/tag/v1.11.0\n[1.12.0]: https://github.com/slint-ui/slint/releases/tag/v1.12.0\n[1.12.1]: https://github.com/slint-ui/slint/releases/tag/v1.12.1\n[1.13.0]: https://github.com/slint-ui/slint/releases/tag/v1.13.0\n[1.13.1]: https://github.com/slint-ui/slint/releases/tag/v1.13.1\n[1.14.0]: https://github.com/slint-ui/slint/releases/tag/v1.14.0\n[1.14.1]: https://github.com/slint-ui/slint/releases/tag/v1.14.1\n[1.15.0]: https://github.com/slint-ui/slint/releases/tag/v1.15.0\n" }, { "path": "CMakeLists.txt", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\ncmake_minimum_required(VERSION 3.21)\n\nproject(Slint LANGUAGES CXX)\n\nset(CMAKE_CXX_STANDARD 20)\nset(CMAKE_CXX_STANDARD_REQUIRED ON)\n\ninclude(FeatureSummary)\n\noption(SLINT_BUILD_TESTING \"Build tests\" OFF)\nadd_feature_info(SLINT_BUILD_TESTING SLINT_BUILD_TESTING \"configure whether to build the test suite\")\ninclude(CTest)\n\nset(SLINT_IS_TOPLEVEL_BUILD TRUE)\n\n# Place all compiled examples into the same bin directory\n# on Windows, where we'll also put the dll\nif (WIN32)\n set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)\n set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)\n set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR}/bin/debug)\n set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR}/bin/release)\nelseif(APPLE)\n # On macOS, the slint_cpp.dylib's install_name uses @rpath. CMake doesn't set BUILD_RPATH for\n # imported targets though, so include the directory here by hand in the rpath used to build binaries\n # in the build tree (such as our examples or tests).\n set(CMAKE_BUILD_RPATH ${CMAKE_BINARY_DIR}/api/cpp)\nendif()\n\nadd_subdirectory(api/cpp/)\n\noption(SLINT_BUILD_EXAMPLES \"Build Slint Examples\" OFF)\nadd_feature_info(SLINT_BUILD_EXAMPLES SLINT_BUILD_EXAMPLES \"configure whether to build the examples and demos\")\n\nif(SLINT_BUILD_EXAMPLES)\n add_subdirectory(examples)\n add_subdirectory(demos)\nendif()\nif(SLINT_BUILD_TESTING AND (SLINT_FEATURE_COMPILER OR SLINT_COMPILER))\n add_subdirectory(docs/astro/src/content/code/)\nendif()\n\nfeature_summary(WHAT ENABLED_FEATURES DESCRIPTION \"Enabled features:\")\nfeature_summary(WHAT DISABLED_FEATURES DESCRIPTION \"Disabled features:\")\n" }, { "path": "CMakePresets.json", "content": "{\n \"version\": 8,\n \"$schema\": \"https://cmake.org/cmake/help/latest/_downloads/3e2d73bff478d88a7de0de736ba5e361/schema.json\",\n \"configurePresets\": [\n {\n \"name\": \"base\",\n \"displayName\": \"base preset\",\n \"generator\": \"Ninja\",\n \"binaryDir\": \"${sourceDir}/build-${presetName}\",\n \"hidden\": true\n },\n {\n \"name\": \"base-debug\",\n \"displayName\": \"base debug preset\",\n \"generator\": \"Ninja\",\n \"binaryDir\": \"${sourceDir}/build-${presetName}\",\n \"hidden\": true,\n \"cacheVariables\": {\n \"CMAKE_EXPORT_COMPILE_COMMANDS\": \"ON\",\n \"CMAKE_BUILD_TYPE\": \"Debug\",\n \"SLINT_BUILD_EXAMPLES\": \"ON\",\n \"SLINT_BUILD_TESTING\": \"ON\"\n }\n },\n {\n \"name\": \"debug-mold\",\n \"displayName\": \"Build as debug + using mold linker\",\n \"cacheVariables\": {\n \"CMAKE_SHARED_LINKER_FLAGS\": \"-fuse-ld=mold\"\n },\n \"inherits\": [\n \"base-debug\"\n ]\n },\n {\n \"name\": \"debug\",\n \"displayName\": \"Build against\",\n \"binaryDir\": \"${sourceDir}/build\",\n \"inherits\": [\n \"base-debug\"\n ]\n },\n {\n \"name\": \"release\",\n \"displayName\": \"Build as release mode.\",\n \"cacheVariables\": {\n \"CMAKE_BUILD_TYPE\": \"RelWithDebInfo\"\n },\n \"inherits\": [\n \"base\"\n ]\n }\n ],\n \"buildPresets\": [\n {\n \"name\": \"debug-mold\",\n \"configurePreset\": \"debug-mold\"\n },\n {\n \"name\": \"debug\",\n \"configurePreset\": \"debug\"\n },\n {\n \"name\": \"release\",\n \"configurePreset\": \"release\"\n }\n ]\n}\n" }, { "path": "CONTRIBUTING.md", "content": "\n# Contributing\n\nWe warmly welcome contributions to the project. Let's discuss ideas or questions\nin [Github discussions](https://github.com/slint-ui/slint/discussions) or on our [public chat](https://chat.slint.dev).\nPlease feel welcome to open GitHub issues or pull requests.\nUse 👍 reaction on issue that you consider important.\n\nIssues which we think are suitable for new contributors are tagged with\nhttps://github.com/slint-ui/slint/labels/good%20first%20issue.\n\n## Internal documentation\n\n - [Development guide](docs/development.md)\n - [Building Slint from sources in this repository](docs/building.md)\n - [Testing](docs/testing.md)\n - [GitHub issues triage and labels](docs/internal/triage.md)\n\n## License\n\nBy contributing to this project, you agree to license your contributions under\nthe [MIT No Attribution License (MIT-0)](https://opensource.org/license/mit-0).\n\nTo confirm this, you'll be asked to sign a simple [Contributor License Agreement (CLA)](https://cla-assistant.io/slint-ui/slint)\nwhen you open a pull request.\nThe CLA does not assign copyright or transfer ownership, it simply confirms that\nyou wrote the code yourself and are licensing it under MIT-0.\n\n## Coding Style\n\nFor the Rust portion of the code base, the CI enforces the coding style via rustfmt.\nFor the C++ portion of the code base, the CI enforces the coding style via `clang-format`.\n\n" }, { "path": "Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[workspace]\nmembers = [\n 'api/cpp',\n 'api/node',\n 'api/rs/build',\n 'api/rs/macros',\n 'api/rs/slint',\n 'api/python/slint',\n 'api/wasm-interpreter',\n 'editors/zed',\n 'examples/7guis',\n 'examples/gallery',\n 'examples/imagefilter/rust',\n 'examples/maps',\n 'examples/memory',\n 'examples/native-gestures',\n 'examples/opengl_underlay',\n 'examples/opengl_texture',\n 'examples/wgpu_texture',\n 'examples/ffmpeg',\n 'examples/gstreamer-player',\n 'examples/plotter',\n 'demos/printerdemo/rust',\n 'demos/printerdemo_mcu',\n 'examples/slide_puzzle',\n 'examples/speedometer/rust',\n 'examples/todo/rust',\n 'examples/todo-mvc/rust',\n 'examples/virtual_keyboard/rust',\n 'examples/carousel/rust',\n 'demos/energy-monitor',\n 'demos/home-automation/rust',\n 'examples/mcu-board-support',\n 'examples/mcu-embassy',\n 'examples/uefi-demo',\n 'examples/async-io',\n 'demos/weather-demo',\n 'demos/usecases/rust',\n 'helper_crates/const-field-offset',\n 'helper_crates/vtable',\n 'helper_crates/vtable/macro',\n 'internal/backends/winit',\n 'internal/backends/android-activity',\n 'internal/backends/qt',\n 'internal/backends/selector',\n 'internal/backends/testing',\n 'internal/backends/linuxkms',\n 'internal/renderers/software',\n 'internal/renderers/skia',\n 'internal/renderers/femtovg',\n 'internal/common',\n 'internal/compiler',\n 'internal/compiler/parser-test-macro',\n 'internal/core',\n 'internal/core-macros',\n 'internal/interpreter',\n 'tests/doctests',\n 'tests/driver/cpp',\n 'tests/driver/driverlib',\n 'tests/driver/interpreter',\n 'tests/driver/nodejs',\n 'tests/driver/python',\n 'tests/driver/rust',\n 'tests/screenshots',\n 'tests/manual/windowattributes',\n 'tests/manual/module-builds/blogica',\n 'tests/manual/module-builds/blogicb',\n 'tests/manual/module-builds/app',\n 'tools/compiler',\n 'tools/docsnapper',\n 'tools/figma_import',\n 'tools/lsp',\n 'tools/updater',\n 'tools/viewer',\n 'tools/tr-extractor',\n \"ui-libraries/material/examples/gallery\",\n 'xtask',\n]\n\ndefault-members = [\n 'api/rs/build',\n 'api/rs/slint',\n 'examples/gallery',\n 'examples/memory',\n 'demos/printerdemo/rust',\n 'examples/slide_puzzle',\n 'examples/speedometer/rust',\n 'examples/todo/rust',\n 'examples/virtual_keyboard/rust',\n 'examples/carousel/rust',\n 'demos/energy-monitor',\n 'internal/backends/winit',\n 'internal/backends/qt',\n 'internal/backends/selector',\n 'internal/compiler',\n 'internal/core',\n 'internal/interpreter',\n 'tests/doctests',\n 'tests/driver/interpreter',\n 'tests/driver/rust',\n 'tests/screenshots',\n 'tools/compiler',\n 'tools/figma_import',\n 'tools/lsp',\n 'tools/viewer',\n]\n\nresolver = \"3\"\n\n[workspace.package]\ndescription = \"GUI toolkit to efficiently develop fluid graphical user interfaces for embedded devices and desktop applications\"\nauthors = [\"Slint Developers \"]\ndocumentation = \"https://slint.dev/docs\"\nedition = \"2024\"\nhomepage = \"https://slint.dev\"\nkeywords = [\"gui\", \"toolkit\", \"graphics\", \"design\", \"ui\"]\nlicense = \"GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\"\nrepository = \"https://github.com/slint-ui/slint\"\nrust-version = \"1.88\"\nversion = \"1.16.0\"\n\n[workspace.dependencies]\ni-slint-backend-android-activity = { version = \"=1.16.0\", path = \"internal/backends/android-activity\", default-features = false }\ni-slint-backend-linuxkms = { version = \"=1.16.0\", path = \"internal/backends/linuxkms\", default-features = false }\ni-slint-backend-qt = { version = \"=1.16.0\", path = \"internal/backends/qt\", default-features = false }\ni-slint-backend-selector = { version = \"=1.16.0\", path = \"internal/backends/selector\", default-features = false }\ni-slint-backend-testing = { version = \"=1.16.0\", path = \"internal/backends/testing\", default-features = false }\ni-slint-backend-winit = { version = \"=1.16.0\", path = \"internal/backends/winit\", default-features = false }\ni-slint-common = { version = \"=1.16.0\", path = \"internal/common\", default-features = false }\ni-slint-compiler = { version = \"=1.16.0\", path = \"internal/compiler\", default-features = false }\ni-slint-core = { version = \"=1.16.0\", path = \"internal/core\", default-features = false }\ni-slint-core-macros = { version = \"=1.16.0\", path = \"internal/core-macros\", default-features = false }\ni-slint-renderer-femtovg = { version = \"=1.16.0\", path = \"internal/renderers/femtovg\", default-features = false }\ni-slint-renderer-skia = { version = \"=1.16.0\", path = \"internal/renderers/skia\", default-features = false }\ni-slint-renderer-software = { version = \"=1.16.0\", path = \"internal/renderers/software\", default-features = false }\nslint = { version = \"=1.16.0\", path = \"api/rs/slint\", default-features = false }\nslint-build = { version = \"=1.16.0\", path = \"api/rs/build\", default-features = false }\nslint-cpp = { version = \"=1.16.0\", path = \"api/cpp\", default-features = false }\nslint-interpreter = { version = \"=1.16.0\", path = \"internal/interpreter\", default-features = false }\nslint-macros = { version = \"=1.16.0\", path = \"api/rs/macros\", default-features = false }\n\nvtable = { version = \"0.3\", path = \"helper_crates/vtable\" }\n\nby_address = { version = \"1.0.4\" }\nbytemuck = { version = \"1.13.1\" }\ncbindgen = { version = \"0.29\", default-features = false }\ncfg_aliases = { version = \"0.2.0\" }\nclap = { version = \"4.0\", features = [\"derive\", \"wrap_help\"] }\nclru = { version = \"0.6.0\" }\ncss-color-parser2 = { version = \"1.0.1\" }\nderive_more = { version = \"2.0.0\", default-features = false, features = [\"deref\", \"deref_mut\", \"into\", \"from\", \"add\", \"add_assign\", \"mul\", \"not\", \"display\"] }\neuclid = { version = \"0.22.1\", default-features = false }\nswash = { version = \"0.2.6\", default-features = false }\nglutin = { version = \"0.32.0\", default-features = false }\nimage = { version = \"0.25\", default-features = false, features = [\"png\", \"jpeg\"] }\nitertools = { version = \"0.14\" }\nlog = { version = \"0.4.17\" }\ntracing = { version = \"0.1\" }\ntracing-subscriber = { version = \"0.3\" }\nresvg = { version = \"0.46.0\", default-features = false, features = [\"text\", \"raster-images\"] }\nrowan = { version = \"0.16.1\" }\nrustybuzz = { version = \"0.20.0\" }\nsend_wrapper = { version = \"0.6.0\" }\nserde = { version = \"1.0.163\", default-features = false, features = [\"derive\"] }\nserde_json = { version = \"1.0.96\" }\nsoftbuffer = { version = \"0.4.4\", default-features = false }\nspin_on = { version = \"0.1\" }\nstrum = { version = \"0.27.1\", default-features = false, features = [\"derive\"] }\ntoml_edit = { version = \"0.24.0\" }\nttf-parser = { version = \"0.25\" }\ntyped-index-collections = \"3.2\"\nweb-sys = { version = \"0.3.72\", default-features = false }\nsmol_str = { version = \"0.3.1\" }\nrayon = { version = \"1.10.0\", default-features = false }\nraw-window-handle-06 = { package = \"raw-window-handle\", version = \"0.6\", features = [\"alloc\"] }\n\n# Note: We're migrating our unicode handling over to the icu family of crates.\n# Prefer using icu crates over adding more unicode-* dependencies\n# parley uses the icu crates internally as well, so we'll share the dependency there.\nunicode-segmentation = { version = \"1.12.0\" }\nicu_normalizer = { version = \"2\", default-features = false, features = [\"compiled_data\"] }\n\nglow = { version = \"0.16\" }\ntikv-jemallocator = { version = \"0.6\" }\nwgpu-27 = { package = \"wgpu\", version = \"27\", default-features = false }\nwgpu-28 = { package = \"wgpu\", version = \"28\", default-features = false }\ninput = { version = \"0.9.0\", default-features = false }\ntr = { version = \"0.1\", default-features = false }\nfontique = { version = \"0.7.0\" }\nread-fonts = { version = \"0.35\" }\nskrifa = { version = \"0.37\" }\nwindows = { version = \"0.62\" }\nwindows-core = { version = \"0.62.0\" }\nlyon_path = { version = \"1.0\", default-features = false }\n\n[profile.release]\nlto = true\npanic = \"abort\"\n\n[profile.dev]\npanic = \"abort\"\n" }, { "path": "Cross.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[target.aarch64-unknown-linux-gnu]\nimage = \"ghcr.io/slint-ui/slint/aarch64-unknown-linux-gnu\"\n[target.armv7-unknown-linux-gnueabihf]\nimage = \"ghcr.io/slint-ui/slint/armv7-unknown-linux-gnueabihf\"\n[target.riscv64gc-unknown-linux-gnu]\nimage = \"ghcr.io/slint-ui/slint/riscv64gc-unknown-linux-gnu\"\n[target.x86_64-unknown-linux-gnu]\nimage = \"ghcr.io/slint-ui/slint/x86_64-unknown-linux-gnu\"\n\n[build.env]\npassthrough = [\"SLINT_NO_QT\", \"SLINT_STYLE\", \"SLINT_TEST_FILTER\", \"SLINT_INTERPRETER_ERROR_WHITELIST\"]\n" }, { "path": "FAQ.md", "content": "\n# Frequently Asked Questions: \n\n- [General](#general)\n - [Why does Slint use a domain specific language?](#why-does-slint-use-a-domain-specific-language)\n - [Will there be API bindings to integrate with my favorite programming language?](#will-there-be-api-bindings-to-integrate-with-my-favorite-programming-language)\n- [Licensing](#licensing)\n - [Royalty-free license](#royalty-free-license)\n - [Who can use the Royalty-free license?](#who-can-use-the-royalty-free-license)\n - [What obligations do I need to fulfil to use the Royalty-free license?](#what-obligations-do-i-need-to-fulfil-to-use-the-royalty-free-license)\n - [Are there any limitations with the Royalty-free license?](#are-there-any-limitations-with-the-royalty-free-license)\n - [Scenario: What happens if my application is open-source (e.g. under MIT), forked by a different person and then redistributed?](#scenario-what-happens-if-my-application-is-open-source-eg-under-mit-forked-by-a-different-person-and-then-redistributed)\n - [How are modifications to Slint itself covered under this license?](#how-are-modifications-to-slint-itself-covered-under-this-license)\n - [If Slint were to be taken over by a larger company or the current owners were to have a change of heart, can they revoke existing licenses?](#if-slint-were-to-be-taken-over-by-a-larger-company-or-the-current-owners-were-to-have-a-change-of-heart-can-they-revoke-existing-licenses)\n - [GPLv3](#gplv3)\n - [If I link my program with Slint GPLv3, does it mean that I have to license my program under the GPLv3, too?](#if-i-link-my-program-with-slint-gplv3-does-it-mean-that-i-have-to-license-my-program-under-the-gplv3-too)\n - [My MIT-licensed program links to Slint GPLv3. Can someone fork my program to build and distribute a proprietary program?](#my-mit-licensed-program-links-to-slint-gplv3-can-someone-fork-my-program-to-build-and-distribute-a-proprietary-program)\n - [My MIT-licensed program links to Slint GPLv3. How can I convey to someone that they can distribute my program as part of a proprietary licensed program?](#my-mit-licensed-program-links-to-slint-gplv3-how-can-i-convey-to-someone-that-they-can-distribute-my-program-as-part-of-a-proprietary-licensed-program)\n - [My MIT-licensed program links to Slint GPLv3. Under what license can I release the binary of my program?](#my-mit-licensed-program-links-to-slint-gplv3-under-what-license-can-i-release-the-binary-of-my-program)\n - [Scenario: Alice is a software developer, she wants her code to be licensed under MIT. She is developing an application \"AliceApp\" that links to Slint GPLv3. Alice also wants to allow that Bob, a user of AliceApp, can fork AliceApp into a proprietary application called BobApp](#scenario-alice-is-a-software-developer-she-wants-her-code-to-be-licensed-under-mit-she-is-developing-an-application-aliceapp-that-links-to-slint-gplv3-alice-also-wants-to-allow-that-bob-a-user-of-aliceapp-can-fork-aliceapp-into-a-proprietary-application-called-bobapp)\n - [Can Alice use the MIT license header to the source code of AliceApp application?](#can-alice-use-the-mit-license-header-to-the-source-code-of-aliceapp-application)\n - [Under what license should she distribute the AliceApp binary?](#under-what-license-should-she-distribute-the-aliceapp-binary)\n - [How can Alice make it clear to Bob that he can distribute BobApp under a proprietary license?](#how-can-alice-make-it-clear-to-bob-that-he-can-distribute-bobapp-under-a-proprietary-license)\n- [Miscellaneous](#miscellaneous)\n - [Do you provide Support?](#do-you-provide-support)\n\n## General\n\n### Why does Slint use a domain specific language?\n\nFrom our long experience of building UI toolkits, we have learnt that a domain\nspecific, declarative language is best suited to describe UIs. The Slint language\nis easy and intuitive to use while being strict enough for our tools to analyze\nand optimize to provide high graphics performance. Strictly typed binding\nexpressions offer a powerful and robust way for humans to declare relationships\nbetween properties, even in complex user interfaces.\n\n### Will there be API bindings to integrate with my favorite programming language?\n\nWe want to make it possible to use Slint with any programming language. We do\nnot favor one programming language over another. We have chosen to start with\nthree languages:\n\n- Rust, our implementation language.\n- C++, another systems programming language we have a lot of experience with.\n- JavaScript, a popular dynamically typed language.\n\nThis choice builds the foundation that allows us to create bindings for most\ntypes of programming languages.\n\n## Licensing\n\nYou can use Slint under ***any*** of the following licenses, at your choice:\n\n1. [Royalty-free license](LICENSES/LicenseRef-Slint-Royalty-free-2.0.md),\n2. [GNU GPLv3](LICENSES/GPL-3.0-only.txt),\n3. [Paid license](LICENSES/LicenseRef-Slint-Software-3.0.md).\n\n### Royalty-free license\n\n#### Who can use the Royalty-free license?\n\nThis license is suitable for those who develop desktop, mobile, or web applications and do not want to use open-source components under copyleft licenses.\n\n#### What obligations do I need to fulfil to use the Royalty-free license?\n\nYou need to do one of the following:\n\n1. Display the [`AboutSlint`](https://slint.dev/snapshots/master/docs/slint/src/language/widgets/aboutslint.html) widget in an \"About\" screen or dialog that is accessible from the top level menu of the Application. In the absence of such a screen or dialog, display the widget in the \"Splash Screen\" of the Application.\n\n2. Display the [Slint attribution badge](https://github.com/slint-ui/slint/tree/master/logo/MadeWithSlint-logo-whitebg.png) on a public webpage, preferably where the binaries of your Application can be downloaded from, in such a way that it can be easily found by any visitor to that page.\n\n#### Are there any limitations with the Royalty-free license?\n\n1. You are not permitted to distribute or make Slint publicly available alone and without integration into an application. For this purpose you may use the Software under the GNU General Public License, version 3.\n\n2. You are not permitted to use Slint within Embedded Systems. An Embedded System is a computer system designed to perform a specific task within a larger mechanical or electrical system.\n\n3. You are not permitted to distribute an Application that exposes the APIs, in part or in total, of Slint.\n\n4. You are not permitted to remove or alter any license notices (including copyright notices, disclaimers of warranty, or limitations of liability) contained within the source code form of Slint.\n\n#### Scenario: What happens if my application is open-source (e.g. under MIT), forked by a different person and then redistributed?\n\nThe license does not restrict users on how they license their application. In the above scenario, the user may choose to use MIT-license for their application, which can be forked by a different person and then redistributed. If the forked application also uses Slint, then the person forking the application can choose to use Slint under any one of the licenses - Royalty-free, GPLv3, or paid license.\n\n#### How are modifications to Slint itself covered under this license?\n\nThe license does not restrict 'if' and 'how' the modifications to Slint should be distributed. Say for example, Alice uses Slint under this new license to develop application A and modifies Slint in some way. She may choose to release the modifications to Slint under any license of her choice including any of the open source licenses. Alternatively she may decide not to release the modifications.\n\n#### If Slint were to be taken over by a larger company or the current owners were to have a change of heart, can they revoke existing licenses?\n\nWe have a commitment to the larger Slint community to provide Slint under a Royalty-free license. This commitment is included in the [Contributors License Agreement (CLA)](http://cla-assistant.io/slint-ui/slint).\n\n### GPLv3\n\n#### If I link my program with Slint GPLv3, does it mean that I have to license my program under the GPLv3, too?\n\nNo. You can license your program under any license compatible with the GPLv3 such as [https://www.gnu.org/licenses/license-list.en.html#GPLCompatibleLicenses](https://www.gnu.org/licenses/license-list.en.html#GPLCompatibleLicenses).\n\nRefer to GPL FAQ [https://www.gnu.org/licenses/gpl-faq.en.html#LinkingWithGPL](https://www.gnu.org/licenses/gpl-faq.en.html#LinkingWithGPL).\n\n#### My MIT-licensed program links to Slint GPLv3. Can someone fork my program to build and distribute a proprietary program?\n\nYes, provided the person distributing the proprietary program acquired a Slint proprietary license, such as the Slint Royalty-free license or a paid license, instead of using Slint under GPLv3. The other option would be to remove the dependency to Slint altogether.\n\n#### My MIT-licensed program links to Slint GPLv3. How can I convey to someone that they can distribute my program as part of a proprietary licensed program?\n\nYou can add a note as part of your license that to distribute a proprietary licensed program, one can acquire a Slint proprietary license or the dependency to Slint should be removed.\n\n#### My MIT-licensed program links to Slint GPLv3. Under what license can I release the entire work i.e my Program combined with Slint?\n\nWhile your software modules can remain under the MIT-license, the work as a whole must be licensed under the GPL.\n\n#### Scenario: Alice is a software developer, she wants her code to be licensed under MIT. She is developing an application \"AliceApp\" that links to Slint GPLv3. Alice also wants to allow that Bob, a user of AliceApp, can fork AliceApp into a proprietary application called BobApp\n\n- Can Alice use the MIT license header to the source code of AliceApp application?\n\nYes. Alice can license her copyrighted source code under any license compatible with GPLv3. Refer FAQ [If I link my program with Slint GPLv3, does it mean that I have to license my program under the GPLv3, too?](#if-i-link-my-program-with-slint-gplv3-does-it-mean-that-i-have-to-license-my-program-under-the-gplv3-too)\n\n- Under what license should she distribute the AliceApp binary?\n\nUnder GPLv3. While the different software modules can remain under any license compatible with GPLv3, the work as a whole must be licensed under the GPL. Refer FAQ [My MIT-licensed program links to Slint GPLv3. Under what license can I release the binary of my program?](#my-mit-licensed-program-links-to-slint-gplv3-under-what-license-can-i-release-the-binary-of-my-program)\n\n- How can Alice make it clear to Bob that he can distribute BobApp under a proprietary license?\n\nAlice can add a note that Bob can distribute BobApp under a proprietary license if he either acquires a Slint proprietary license or removes the dependency to Slint.\n\n### Paid License\n\n#### What are the paid license options?\n\nCheck out the pricing plans on our website .\n\n## Miscellaneous\n\n### Do you provide Support?\n\nYes, check out our support options on our website .\n" }, { "path": "LICENSE.md", "content": "\n# Slint License\n\nYou can use Slint under ***any*** of the following licenses, at your choice:\n\n1. [Royalty-free License](LICENSES/LicenseRef-Slint-Royalty-free-2.0.md) - Permits use in **proprietary** desktop, mobile, and web applications **at no cost**. Use in embedded systems is excluded.\n2. [GNU GPLv3](LICENSES/GPL-3.0-only.txt) - Permits use in **open source software** under GPL-compatible terms, **at no cost**, for desktop, mobile, and web applications, as well as for embedded systems.\n3. [Commercial license](LICENSES/LicenseRef-Slint-Software-3.0.md) - Permits use in **proprietary** applications, including desktop, mobile, web, and embedded systems.\n\nThird party licenses listed in the `LICENSES` folder also apply to parts of the product.\n\n## Definitions\n\nA ***Desktop Application*** is a computer program that is designed to run on a general-purpose computer (PC or notebook), typically installed and executed locally on the computer's operating system.\n\nA ***Mobile Application*** is a computer program that is designed to run on a general-purpose mobile computer (mobile phone or tablet), typically installed and executed locally on the computer's operating system.\n\nA ***Web Application*** is a computer program that is designed to run in the sandbox environment provided by a web browser.\n\nAn ***Embedded System*** is a computer system designed to perform a specific task within a larger mechanical or electrical system.\n\n## Additional Info\n\nSee the [Slint licensing options on the website](https://slint.dev/pricing.html) and the [Licensing FAQ](FAQ.md#licensing).\nContact us at [info@slint.dev](mailto:info@slint.dev) if you have any questions regarding licensing.\n" }, { "path": "LICENSES/Apache-2.0.txt", "content": "Apache License\nVersion 2.0, January 2004\nhttp://www.apache.org/licenses/\n\nTERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n1. Definitions.\n\n\"License\" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.\n\n\"Licensor\" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.\n\n\"Legal Entity\" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, \"control\" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.\n\n\"You\" (or \"Your\") shall mean an individual or Legal Entity exercising permissions granted by this License.\n\n\"Source\" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.\n\n\"Object\" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.\n\n\"Work\" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).\n\n\"Derivative Works\" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.\n\n\"Contribution\" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, \"submitted\" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as \"Not a Contribution.\"\n\n\"Contributor\" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.\n\n2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.\n\n3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.\n\n4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:\n\n (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.\n\n You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.\n\n5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.\n\n6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.\n\n7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.\n\n8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.\n\n9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.\n\nEND OF TERMS AND CONDITIONS\n\nAPPENDIX: How to apply the Apache License to your work.\n\nTo apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets \"[]\" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same \"printed page\" as the copyright notice for easier identification within third-party archives.\n\nCopyright [yyyy] [name of copyright owner]\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n" }, { "path": "LICENSES/CC-BY-2.0.txt", "content": "Creative Commons Attribution 2.0\n\n CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE LEGAL SERVICES. DISTRIBUTION OF THIS LICENSE DOES NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION ON AN \"AS-IS\" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE INFORMATION PROVIDED, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM ITS USE.\n\nLicense\n\nTHE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE (\"CCPL\" OR \"LICENSE\"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.\n\nBY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.\n\n1. Definitions\n\n a. \"Collective Work\" means a work, such as a periodical issue, anthology or encyclopedia, in which the Work in its entirety in unmodified form, along with a number of other contributions, constituting separate and independent works in themselves, are assembled into a collective whole. A work that constitutes a Collective Work will not be considered a Derivative Work (as defined below) for the purposes of this License.\n\n b. \"Derivative Work\" means a work based upon the Work or upon the Work and other pre-existing works, such as a translation, musical arrangement, dramatization, fictionalization, motion picture version, sound recording, art reproduction, abridgment, condensation, or any other form in which the Work may be recast, transformed, or adapted, except that a work that constitutes a Collective Work will not be considered a Derivative Work for the purpose of this License. For the avoidance of doubt, where the Work is a musical composition or sound recording, the synchronization of the Work in timed-relation with a moving image (\"synching\") will be considered a Derivative Work for the purpose of this License.\n\n c. \"Licensor\" means the individual or entity that offers the Work under the terms of this License.\n\n d. \"Original Author\" means the individual or entity who created the Work.\n\n e. \"Work\" means the copyrightable work of authorship offered under the terms of this License.\n\n f. \"You\" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.\n\n2. Fair Use Rights. Nothing in this license is intended to reduce, limit, or restrict any rights arising from fair use, first sale or other limitations on the exclusive rights of the copyright owner under copyright law or other applicable laws.\n\n3. License Grant. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:\n\n a. to reproduce the Work, to incorporate the Work into one or more Collective Works, and to reproduce the Work as incorporated in the Collective Works;\n\n b. to create and reproduce Derivative Works;\n\n c. to distribute copies or phonorecords of, display publicly, perform publicly, and perform publicly by means of a digital audio transmission the Work including as incorporated in Collective Works;\n\n d. to distribute copies or phonorecords of, display publicly, perform publicly, and perform publicly by means of a digital audio transmission Derivative Works.\n\n e. For the avoidance of doubt, where the work is a musical composition:\n\n i. Performance Royalties Under Blanket Licenses. Licensor waives the exclusive right to collect, whether individually or via a performance rights society (e.g. ASCAP, BMI, SESAC), royalties for the public performance or public digital performance (e.g. webcast) of the Work.\n\n ii. Mechanical Rights and Statutory Royalties. Licensor waives the exclusive right to collect, whether individually or via a music rights agency or designated agent (e.g. Harry Fox Agency), royalties for any phonorecord You create from the Work (\"cover version\") and distribute, subject to the compulsory license created by 17 USC Section 115 of the US Copyright Act (or the equivalent in other jurisdictions).\n\n f. Webcasting Rights and Statutory Royalties. For the avoidance of doubt, where the Work is a sound recording, Licensor waives the exclusive right to collect, whether individually or via a performance-rights society (e.g. SoundExchange), royalties for the public digital performance (e.g. webcast) of the Work, subject to the compulsory license created by 17 USC Section 114 of the US Copyright Act (or the equivalent in other jurisdictions).\n\nThe above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. All rights not expressly granted by Licensor are hereby reserved.\n\n4. Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:\n\n a. You may distribute, publicly display, publicly perform, or publicly digitally perform the Work only under the terms of this License, and You must include a copy of, or the Uniform Resource Identifier for, this License with every copy or phonorecord of the Work You distribute, publicly display, publicly perform, or publicly digitally perform. You may not offer or impose any terms on the Work that alter or restrict the terms of this License or the recipients' exercise of the rights granted hereunder. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties. You may not distribute, publicly display, publicly perform, or publicly digitally perform the Work with any technological measures that control access or use of the Work in a manner inconsistent with the terms of this License Agreement. The above applies to the Work as incorporated in a Collective Work, but this does not require the Collective Work apart from the Work itself to be made subject to the terms of this License. If You create a Collective Work, upon notice from any Licensor You must, to the extent practicable, remove from the Collective Work any reference to such Licensor or the Original Author, as requested. If You create a Derivative Work, upon notice from any Licensor You must, to the extent practicable, remove from the Derivative Work any reference to such Licensor or the Original Author, as requested.\n\n b. If you distribute, publicly display, publicly perform, or publicly digitally perform the Work or any Derivative Works or Collective Works, You must keep intact all copyright notices for the Work and give the Original Author credit reasonable to the medium or means You are utilizing by conveying the name (or pseudonym if applicable) of the Original Author if supplied; the title of the Work if supplied; to the extent reasonably practicable, the Uniform Resource Identifier, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and in the case of a Derivative Work, a credit identifying the use of the Work in the Derivative Work (e.g., \"French translation of the Work by Original Author,\" or \"Screenplay based on original Work by Original Author\"). Such credit may be implemented in any reasonable manner; provided, however, that in the case of a Derivative Work or Collective Work, at a minimum such credit will appear where any other comparable authorship credit appears and in a manner at least as prominent as such other comparable authorship credit.\n\n5. Representations, Warranties and Disclaimer\n\nUNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.\n\n6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.\n\n7. Termination\n\n a. This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Derivative Works or Collective Works from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.\n\n b. Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.\n\n8. Miscellaneous\n\n a. Each time You distribute or publicly digitally perform the Work or a Collective Work, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.\n\n b. Each time You distribute or publicly digitally perform a Derivative Work, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.\n\n c. If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.\n\n d. No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.\n\n e. This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Licensor and You.\n\nCreative Commons is not a party to this License, and makes no warranty whatsoever in connection with the Work. Creative Commons will not be liable to You or any party on any legal theory for any damages whatsoever, including without limitation any general, special, incidental or consequential damages arising in connection to this license. Notwithstanding the foregoing two (2) sentences, if Creative Commons has expressly identified itself as the Licensor hereunder, it shall have all rights and obligations of Licensor.\n\nExcept for the limited purpose of indicating to the public that the Work is licensed under the CCPL, neither party will use the trademark \"Creative Commons\" or any related trademark or logo of Creative Commons without the prior written consent of Creative Commons. Any permitted use will be in compliance with Creative Commons' then-current trademark usage guidelines, as may be published on its website or otherwise made available upon request from time to time.\n\nCreative Commons may be contacted at http://creativecommons.org/.\n" }, { "path": "LICENSES/CC-BY-4.0.txt", "content": "Creative Commons Attribution 4.0 International\n\n Creative Commons Corporation (“Creative Commons”) is not a law firm and does not provide legal services or legal advice. Distribution of Creative Commons public licenses does not create a lawyer-client or other relationship. Creative Commons makes its licenses and related information available on an “as-is” basis. Creative Commons gives no warranties regarding its licenses, any material licensed under their terms and conditions, or any related information. Creative Commons disclaims all liability for damages resulting from their use to the fullest extent possible.\n\nUsing Creative Commons Public Licenses\n\nCreative Commons public licenses provide a standard set of terms and conditions that creators and other rights holders may use to share original works of authorship and other material subject to copyright and certain other rights specified in the public license below. The following considerations are for informational purposes only, are not exhaustive, and do not form part of our licenses.\n\nConsiderations for licensors: Our public licenses are intended for use by those authorized to give the public permission to use material in ways otherwise restricted by copyright and certain other rights. Our licenses are irrevocable. Licensors should read and understand the terms and conditions of the license they choose before applying it. Licensors should also secure all rights necessary before applying our licenses so that the public can reuse the material as expected. Licensors should clearly mark any material not subject to the license. This includes other CC-licensed material, or material used under an exception or limitation to copyright. More considerations for licensors.\n\nConsiderations for the public: By using one of our public licenses, a licensor grants the public permission to use the licensed material under specified terms and conditions. If the licensor’s permission is not necessary for any reason–for example, because of any applicable exception or limitation to copyright–then that use is not regulated by the license. Our licenses grant only permissions under copyright and certain other rights that a licensor has authority to grant. Use of the licensed material may still be restricted for other reasons, including because others have copyright or other rights in the material. A licensor may make special requests, such as asking that all changes be marked or described. Although not required by our licenses, you are encouraged to respect those requests where reasonable. More considerations for the public.\n\nCreative Commons Attribution 4.0 International Public License\n\nBy exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution 4.0 International Public License (\"Public License\"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.\n\nSection 1 – Definitions.\n\n a.\tAdapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.\n\n b.\tAdapter's License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.\n\n c.\tCopyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.\n\n d.\tEffective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.\n\n e.\tExceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.\n\n f.\tLicensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.\n\n g.\tLicensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.\n\n h.\tLicensor means the individual(s) or entity(ies) granting rights under this Public License.\n\n i.\tShare means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.\n\n j.\tSui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.\n\n k.\tYou means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.\n\nSection 2 – Scope.\n\n a.\tLicense grant.\n\n 1. Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:\n\n A. reproduce and Share the Licensed Material, in whole or in part; and\n\n B. produce, reproduce, and Share Adapted Material.\n\n 2. Exceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.\n\n 3. Term. The term of this Public License is specified in Section 6(a).\n\n 4. Media and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.\n\n 5. Downstream recipients.\n\n A. Offer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.\n\n B. No downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.\n\n 6. No endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).\n\nb. Other rights.\n\n 1. Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.\n\n 2. Patent and trademark rights are not licensed under this Public License.\n\n 3. To the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties.\n\nSection 3 – License Conditions.\n\nYour exercise of the Licensed Rights is expressly made subject to the following conditions.\n\n a.\tAttribution.\n\n 1. If You Share the Licensed Material (including in modified form), You must:\n\n A. retain the following if it is supplied by the Licensor with the Licensed Material:\n\n i. identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);\n\n ii. a copyright notice;\n\n iii. a notice that refers to this Public License;\n\n iv.\ta notice that refers to the disclaimer of warranties;\n\n v. a URI or hyperlink to the Licensed Material to the extent reasonably practicable;\n\n B. indicate if You modified the Licensed Material and retain an indication of any previous modifications; and\n\n C. indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.\n\n 2. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.\n\n 3. If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.\n\n 4. If You Share Adapted Material You produce, the Adapter's License You apply must not prevent recipients of the Adapted Material from complying with this Public License.\n\nSection 4 – Sui Generis Database Rights.\n\nWhere the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:\n\n a.\tfor the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database;\n\n b.\tif You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material; and\n\n c.\tYou must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.\nFor the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.\n\nSection 5 – Disclaimer of Warranties and Limitation of Liability.\n\n a.\tUnless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.\n\n b.\tTo the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.\n\n c.\tThe disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.\n\nSection 6 – Term and Termination.\n\n a.\tThis Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.\n\n b.\tWhere Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:\n\n 1. automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or\n\n 2. upon express reinstatement by the Licensor.\n\n c.\tFor the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.\n\n d.\tFor the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.\n\n e.\tSections 1, 5, 6, 7, and 8 survive termination of this Public License.\n\nSection 7 – Other Terms and Conditions.\n\n a.\tThe Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.\n\n b.\tAny arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.\n\nSection 8 – Interpretation.\n\n a.\tFor the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.\n\n b.\tTo the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.\n\n c.\tNo term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.\n\n d.\tNothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.\n\nCreative Commons is not a party to its public licenses. Notwithstanding, Creative Commons may elect to apply one of its public licenses to material it publishes and in those instances will be considered the “Licensor.” Except for the limited purpose of indicating that material is shared under a Creative Commons public license or as otherwise permitted by the Creative Commons policies published at creativecommons.org/policies, Creative Commons does not authorize the use of the trademark “Creative Commons” or any other trademark or logo of Creative Commons without its prior written consent including, without limitation, in connection with any unauthorized modifications to any of its public licenses or any other arrangements, understandings, or agreements concerning use of licensed material. For the avoidance of doubt, this paragraph does not form part of the public licenses.\n\nCreative Commons may be contacted at creativecommons.org.\n" }, { "path": "LICENSES/CC-BY-ND-4.0.txt", "content": "Creative Commons Attribution-NoDerivatives 4.0 International\n\n Creative Commons Corporation (“Creative Commons”) is not a law firm and does not provide legal services or legal advice. Distribution of Creative Commons public licenses does not create a lawyer-client or other relationship. Creative Commons makes its licenses and related information available on an “as-is” basis. Creative Commons gives no warranties regarding its licenses, any material licensed under their terms and conditions, or any related information. Creative Commons disclaims all liability for damages resulting from their use to the fullest extent possible.\n\nUsing Creative Commons Public Licenses\n\nCreative Commons public licenses provide a standard set of terms and conditions that creators and other rights holders may use to share original works of authorship and other material subject to copyright and certain other rights specified in the public license below. The following considerations are for informational purposes only, are not exhaustive, and do not form part of our licenses.\n\nConsiderations for licensors: Our public licenses are intended for use by those authorized to give the public permission to use material in ways otherwise restricted by copyright and certain other rights. Our licenses are irrevocable. Licensors should read and understand the terms and conditions of the license they choose before applying it. Licensors should also secure all rights necessary before applying our licenses so that the public can reuse the material as expected. Licensors should clearly mark any material not subject to the license. This includes other CC-licensed material, or material used under an exception or limitation to copyright. More considerations for licensors.\n\nConsiderations for the public: By using one of our public licenses, a licensor grants the public permission to use the licensed material under specified terms and conditions. If the licensor’s permission is not necessary for any reason–for example, because of any applicable exception or limitation to copyright–then that use is not regulated by the license. Our licenses grant only permissions under copyright and certain other rights that a licensor has authority to grant. Use of the licensed material may still be restricted for other reasons, including because others have copyright or other rights in the material. A licensor may make special requests, such as asking that all changes be marked or described. Although not required by our licenses, you are encouraged to respect those requests where reasonable. More considerations for the public.\n\nCreative Commons Attribution-NoDerivatives 4.0 International Public License\n\nBy exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-NoDerivatives 4.0 International Public License (\"Public License\"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.\n\nSection 1 – Definitions.\n\n a.\tAdapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.\n\n b.\tCopyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.\n\n c.\tEffective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.\n\n d.\tExceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.\n\n e.\tLicensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.\n\n f.\tLicensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.\n\n g.\tLicensor means the individual(s) or entity(ies) granting rights under this Public License.\n\n h.\tShare means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.\n\n i.\tSui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.\n\n j.\tYou means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.\n\nSection 2 – Scope.\n\n a.\tLicense grant.\n\n 1. Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:\n\n A. reproduce and Share the Licensed Material, in whole or in part; and\n\n B. produce and reproduce, but not Share, Adapted Material.\n\n 2. Exceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.\n\n 3. Term. The term of this Public License is specified in Section 6(a).\n\n 4. Media and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.\n\n 5. Downstream recipients.\n\n A. Offer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.\n\n B. No downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.\n\n 6. No endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).\n\n b.\tOther rights.\n\n 1. Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.\n\n 2. Patent and trademark rights are not licensed under this Public License.\n\n 3. To the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties.\n\nSection 3 – License Conditions.\n\nYour exercise of the Licensed Rights is expressly made subject to the following conditions.\n\n a.\tAttribution.\n\n 1. If You Share the Licensed Material, You must:\n\n A. retain the following if it is supplied by the Licensor with the Licensed Material:\n\n i. identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);\n\n ii.\ta copyright notice;\n\n iii. a notice that refers to this Public License;\n\n iv.\ta notice that refers to the disclaimer of warranties;\n\n v.\ta URI or hyperlink to the Licensed Material to the extent reasonably practicable;\n\n B. indicate if You modified the Licensed Material and retain an indication of any previous modifications; and\n\n C. indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.\n\n 2. For the avoidance of doubt, You do not have permission under this Public License to Share Adapted Material.\n\n 3. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.\n\n 4. If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.\n\nSection 4 – Sui Generis Database Rights.\n\nWhere the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:\n\n a.\tfor the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database, provided You do not Share Adapted Material;\n\n b.\tif You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material; and\n\n c.\tYou must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.\nFor the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.\n\nSection 5 – Disclaimer of Warranties and Limitation of Liability.\n\n a.\tUnless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.\n\n b.\tTo the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.\n\n c.\tThe disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.\n\nSection 6 – Term and Termination.\n\n a.\tThis Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.\n\n b.\tWhere Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:\n\n 1. automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or\n\n 2. upon express reinstatement by the Licensor.\n\n c.\tFor the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.\n\n d.\tFor the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.\n\n e.\tSections 1, 5, 6, 7, and 8 survive termination of this Public License.\n\nSection 7 – Other Terms and Conditions.\n\n a.\tThe Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.\n\n b.\tAny arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.\n\nSection 8 – Interpretation.\n\n a.\tFor the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.\n\n b.\tTo the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.\n\n c.\tNo term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.\n\n d.\tNothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.\n\nCreative Commons is not a party to its public licenses. Notwithstanding, Creative Commons may elect to apply one of its public licenses to material it publishes and in those instances will be considered the “Licensor.” Except for the limited purpose of indicating that material is shared under a Creative Commons public license or as otherwise permitted by the Creative Commons policies published at creativecommons.org/policies, Creative Commons does not authorize the use of the trademark “Creative Commons” or any other trademark or logo of Creative Commons without its prior written consent including, without limitation, in connection with any unauthorized modifications to any of its public licenses or any other arrangements, understandings, or agreements concerning use of licensed material. For the avoidance of doubt, this paragraph does not form part of the public licenses.\n\nCreative Commons may be contacted at creativecommons.org.\n" }, { "path": "LICENSES/CC-BY-SA-3.0.txt", "content": "Creative Commons Attribution-ShareAlike 3.0 Unported\n\n CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE LEGAL SERVICES. DISTRIBUTION OF THIS LICENSE DOES NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION ON AN \"AS-IS\" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE INFORMATION PROVIDED, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM ITS USE.\n\nLicense\n\nTHE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE (\"CCPL\" OR \"LICENSE\"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.\n\nBY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.\n\n1. Definitions\n\n a. \"Adaptation\" means a work based upon the Work, or upon the Work and other pre-existing works, such as a translation, adaptation, derivative work, arrangement of music or other alterations of a literary or artistic work, or phonogram or performance and includes cinematographic adaptations or any other form in which the Work may be recast, transformed, or adapted including in any form recognizably derived from the original, except that a work that constitutes a Collection will not be considered an Adaptation for the purpose of this License. For the avoidance of doubt, where the Work is a musical work, performance or phonogram, the synchronization of the Work in timed-relation with a moving image (\"synching\") will be considered an Adaptation for the purpose of this License.\n\n b. \"Collection\" means a collection of literary or artistic works, such as encyclopedias and anthologies, or performances, phonograms or broadcasts, or other works or subject matter other than works listed in Section 1(f) below, which, by reason of the selection and arrangement of their contents, constitute intellectual creations, in which the Work is included in its entirety in unmodified form along with one or more other contributions, each constituting separate and independent works in themselves, which together are assembled into a collective whole. A work that constitutes a Collection will not be considered an Adaptation (as defined below) for the purposes of this License.\n\n c. \"Creative Commons Compatible License\" means a license that is listed at http://creativecommons.org/compatiblelicenses that has been approved by Creative Commons as being essentially equivalent to this License, including, at a minimum, because that license: (i) contains terms that have the same purpose, meaning and effect as the License Elements of this License; and, (ii) explicitly permits the relicensing of adaptations of works made available under that license under this License or a Creative Commons jurisdiction license with the same License Elements as this License.\n\n d. \"Distribute\" means to make available to the public the original and copies of the Work or Adaptation, as appropriate, through sale or other transfer of ownership.\n\n e. \"License Elements\" means the following high-level license attributes as selected by Licensor and indicated in the title of this License: Attribution, ShareAlike.\n\n f. \"Licensor\" means the individual, individuals, entity or entities that offer(s) the Work under the terms of this License.\n\n g. \"Original Author\" means, in the case of a literary or artistic work, the individual, individuals, entity or entities who created the Work or if no individual or entity can be identified, the publisher; and in addition (i) in the case of a performance the actors, singers, musicians, dancers, and other persons who act, sing, deliver, declaim, play in, interpret or otherwise perform literary or artistic works or expressions of folklore; (ii) in the case of a phonogram the producer being the person or legal entity who first fixes the sounds of a performance or other sounds; and, (iii) in the case of broadcasts, the organization that transmits the broadcast.\n\n h. \"Work\" means the literary and/or artistic work offered under the terms of this License including without limitation any production in the literary, scientific and artistic domain, whatever may be the mode or form of its expression including digital form, such as a book, pamphlet and other writing; a lecture, address, sermon or other work of the same nature; a dramatic or dramatico-musical work; a choreographic work or entertainment in dumb show; a musical composition with or without words; a cinematographic work to which are assimilated works expressed by a process analogous to cinematography; a work of drawing, painting, architecture, sculpture, engraving or lithography; a photographic work to which are assimilated works expressed by a process analogous to photography; a work of applied art; an illustration, map, plan, sketch or three-dimensional work relative to geography, topography, architecture or science; a performance; a broadcast; a phonogram; a compilation of data to the extent it is protected as a copyrightable work; or a work performed by a variety or circus performer to the extent it is not otherwise considered a literary or artistic work.\n\n i. \"You\" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.\n\n j. \"Publicly Perform\" means to perform public recitations of the Work and to communicate to the public those public recitations, by any means or process, including by wire or wireless means or public digital performances; to make available to the public Works in such a way that members of the public may access these Works from a place and at a place individually chosen by them; to perform the Work to the public by any means or process and the communication to the public of the performances of the Work, including by public digital performance; to broadcast and rebroadcast the Work by any means including signs, sounds or images.\n\n k. \"Reproduce\" means to make copies of the Work by any means including without limitation by sound or visual recordings and the right of fixation and reproducing fixations of the Work, including storage of a protected performance or phonogram in digital form or other electronic medium.\n\n2. Fair Dealing Rights. Nothing in this License is intended to reduce, limit, or restrict any uses free from copyright or rights arising from limitations or exceptions that are provided for in connection with the copyright protection under copyright law or other applicable laws.\n\n3. License Grant. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:\n\n a. to Reproduce the Work, to incorporate the Work into one or more Collections, and to Reproduce the Work as incorporated in the Collections;\n\n b. to create and Reproduce Adaptations provided that any such Adaptation, including any translation in any medium, takes reasonable steps to clearly label, demarcate or otherwise identify that changes were made to the original Work. For example, a translation could be marked \"The original work was translated from English to Spanish,\" or a modification could indicate \"The original work has been modified.\";\n\n c. to Distribute and Publicly Perform the Work including as incorporated in Collections; and,\n\n d. to Distribute and Publicly Perform Adaptations.\n\n e. For the avoidance of doubt:\n\n i. Non-waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme cannot be waived, the Licensor reserves the exclusive right to collect such royalties for any exercise by You of the rights granted under this License;\n\n ii. Waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme can be waived, the Licensor waives the exclusive right to collect such royalties for any exercise by You of the rights granted under this License; and,\n\n iii. Voluntary License Schemes. The Licensor waives the right to collect royalties, whether individually or, in the event that the Licensor is a member of a collecting society that administers voluntary licensing schemes, via that society, from any exercise by You of the rights granted under this License.\n\nThe above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. Subject to Section 8(f), all rights not expressly granted by Licensor are hereby reserved.\n\n4. Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:\n\n a. You may Distribute or Publicly Perform the Work only under the terms of this License. You must include a copy of, or the Uniform Resource Identifier (URI) for, this License with every copy of the Work You Distribute or Publicly Perform. You may not offer or impose any terms on the Work that restrict the terms of this License or the ability of the recipient of the Work to exercise the rights granted to that recipient under the terms of the License. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties with every copy of the Work You Distribute or Publicly Perform. When You Distribute or Publicly Perform the Work, You may not impose any effective technological measures on the Work that restrict the ability of a recipient of the Work from You to exercise the rights granted to that recipient under the terms of the License. This Section 4(a) applies to the Work as incorporated in a Collection, but this does not require the Collection apart from the Work itself to be made subject to the terms of this License. If You create a Collection, upon notice from any Licensor You must, to the extent practicable, remove from the Collection any credit as required by Section 4(c), as requested. If You create an Adaptation, upon notice from any Licensor You must, to the extent practicable, remove from the Adaptation any credit as required by Section 4(c), as requested.\n\n b. You may Distribute or Publicly Perform an Adaptation only under the terms of: (i) this License; (ii) a later version of this License with the same License Elements as this License; (iii) a Creative Commons jurisdiction license (either this or a later license version) that contains the same License Elements as this License (e.g., Attribution-ShareAlike 3.0 US)); (iv) a Creative Commons Compatible License. If you license the Adaptation under one of the licenses mentioned in (iv), you must comply with the terms of that license. If you license the Adaptation under the terms of any of the licenses mentioned in (i), (ii) or (iii) (the \"Applicable License\"), you must comply with the terms of the Applicable License generally and the following provisions: (I) You must include a copy of, or the URI for, the Applicable License with every copy of each Adaptation You Distribute or Publicly Perform; (II) You may not offer or impose any terms on the Adaptation that restrict the terms of the Applicable License or the ability of the recipient of the Adaptation to exercise the rights granted to that recipient under the terms of the Applicable License; (III) You must keep intact all notices that refer to the Applicable License and to the disclaimer of warranties with every copy of the Work as included in the Adaptation You Distribute or Publicly Perform; (IV) when You Distribute or Publicly Perform the Adaptation, You may not impose any effective technological measures on the Adaptation that restrict the ability of a recipient of the Adaptation from You to exercise the rights granted to that recipient under the terms of the Applicable License. This Section 4(b) applies to the Adaptation as incorporated in a Collection, but this does not require the Collection apart from the Adaptation itself to be made subject to the terms of the Applicable License.\n\n c. If You Distribute, or Publicly Perform the Work or any Adaptations or Collections, You must, unless a request has been made pursuant to Section 4(a), keep intact all copyright notices for the Work and provide, reasonable to the medium or means You are utilizing: (i) the name of the Original Author (or pseudonym, if applicable) if supplied, and/or if the Original Author and/or Licensor designate another party or parties (e.g., a sponsor institute, publishing entity, journal) for attribution (\"Attribution Parties\") in Licensor's copyright notice, terms of service or by other reasonable means, the name of such party or parties; (ii) the title of the Work if supplied; (iii) to the extent reasonably practicable, the URI, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and (iv) , consistent with Ssection 3(b), in the case of an Adaptation, a credit identifying the use of the Work in the Adaptation (e.g., \"French translation of the Work by Original Author,\" or \"Screenplay based on original Work by Original Author\"). The credit required by this Section 4(c) may be implemented in any reasonable manner; provided, however, that in the case of a Adaptation or Collection, at a minimum such credit will appear, if a credit for all contributing authors of the Adaptation or Collection appears, then as part of these credits and in a manner at least as prominent as the credits for the other contributing authors. For the avoidance of doubt, You may only use the credit required by this Section for the purpose of attribution in the manner set out above and, by exercising Your rights under this License, You may not implicitly or explicitly assert or imply any connection with, sponsorship or endorsement by the Original Author, Licensor and/or Attribution Parties, as appropriate, of You or Your use of the Work, without the separate, express prior written permission of the Original Author, Licensor and/or Attribution Parties.\n\n d. Except as otherwise agreed in writing by the Licensor or as may be otherwise permitted by applicable law, if You Reproduce, Distribute or Publicly Perform the Work either by itself or as part of any Adaptations or Collections, You must not distort, mutilate, modify or take other derogatory action in relation to the Work which would be prejudicial to the Original Author's honor or reputation. Licensor agrees that in those jurisdictions (e.g. Japan), in which any exercise of the right granted in Section 3(b) of this License (the right to make Adaptations) would be deemed to be a distortion, mutilation, modification or other derogatory action prejudicial to the Original Author's honor and reputation, the Licensor will waive or not assert, as appropriate, this Section, to the fullest extent permitted by the applicable national law, to enable You to reasonably exercise Your right under Section 3(b) of this License (right to make Adaptations) but not otherwise.\n\n5. Representations, Warranties and Disclaimer\n\nUNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.\n\n6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.\n\n7. Termination\n\n a. This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Adaptations or Collections from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.\n\n b. Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.\n\n8. Miscellaneous\n\n a. Each time You Distribute or Publicly Perform the Work or a Collection, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.\n\n b. Each time You Distribute or Publicly Perform an Adaptation, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.\n\n c. If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.\n\n d. No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.\n\n e. This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Licensor and You.\n\n f. The rights granted under, and the subject matter referenced, in this License were drafted utilizing the terminology of the Berne Convention for the Protection of Literary and Artistic Works (as amended on September 28, 1979), the Rome Convention of 1961, the WIPO Copyright Treaty of 1996, the WIPO Performances and Phonograms Treaty of 1996 and the Universal Copyright Convention (as revised on July 24, 1971). These rights and subject matter take effect in the relevant jurisdiction in which the License terms are sought to be enforced according to the corresponding provisions of the implementation of those treaty provisions in the applicable national law. If the standard suite of rights granted under applicable copyright law includes additional rights not granted under this License, such additional rights are deemed to be included in the License; this License is not intended to restrict the license of any rights under applicable law.\n\nCreative Commons Notice\n\nCreative Commons is not a party to this License, and makes no warranty whatsoever in connection with the Work. Creative Commons will not be liable to You or any party on any legal theory for any damages whatsoever, including without limitation any general, special, incidental or consequential damages arising in connection to this license. Notwithstanding the foregoing two (2) sentences, if Creative Commons has expressly identified itself as the Licensor hereunder, it shall have all rights and obligations of Licensor.\n\nExcept for the limited purpose of indicating to the public that the Work is licensed under the CCPL, Creative Commons does not authorize the use by either party of the trademark \"Creative Commons\" or any related trademark or logo of Creative Commons without the prior written consent of Creative Commons. Any permitted use will be in compliance with Creative Commons' then-current trademark usage guidelines, as may be published on its website or otherwise made available upon request from time to time. For the avoidance of doubt, this trademark restriction does not form part of the License.\n\nCreative Commons may be contacted at http://creativecommons.org/.\n" }, { "path": "LICENSES/CC-BY-SA-4.0.txt", "content": "Attribution-ShareAlike 4.0 International\n\n=======================================================================\n\nCreative Commons Corporation (\"Creative Commons\") is not a law firm and\ndoes not provide legal services or legal advice. Distribution of\nCreative Commons public licenses does not create a lawyer-client or\nother relationship. Creative Commons makes its licenses and related\ninformation available on an \"as-is\" basis. Creative Commons gives no\nwarranties regarding its licenses, any material licensed under their\nterms and conditions, or any related information. Creative Commons\ndisclaims all liability for damages resulting from their use to the\nfullest extent possible.\n\nUsing Creative Commons Public Licenses\n\nCreative Commons public licenses provide a standard set of terms and\nconditions that creators and other rights holders may use to share\noriginal works of authorship and other material subject to copyright\nand certain other rights specified in the public license below. The\nfollowing considerations are for informational purposes only, are not\nexhaustive, and do not form part of our licenses.\n\n Considerations for licensors: Our public licenses are\n intended for use by those authorized to give the public\n permission to use material in ways otherwise restricted by\n copyright and certain other rights. Our licenses are\n irrevocable. Licensors should read and understand the terms\n and conditions of the license they choose before applying it.\n Licensors should also secure all rights necessary before\n applying our licenses so that the public can reuse the\n material as expected. Licensors should clearly mark any\n material not subject to the license. This includes other CC-\n licensed material, or material used under an exception or\n limitation to copyright. More considerations for licensors:\n\twiki.creativecommons.org/Considerations_for_licensors\n\n Considerations for the public: By using one of our public\n licenses, a licensor grants the public permission to use the\n licensed material under specified terms and conditions. If\n the licensor's permission is not necessary for any reason--for\n example, because of any applicable exception or limitation to\n copyright--then that use is not regulated by the license. Our\n licenses grant only permissions under copyright and certain\n other rights that a licensor has authority to grant. Use of\n the licensed material may still be restricted for other\n reasons, including because others have copyright or other\n rights in the material. A licensor may make special requests,\n such as asking that all changes be marked or described.\n Although not required by our licenses, you are encouraged to\n respect those requests where reasonable. More_considerations\n for the public:\n\twiki.creativecommons.org/Considerations_for_licensees\n\n=======================================================================\n\nCreative Commons Attribution-ShareAlike 4.0 International Public\nLicense\n\nBy exercising the Licensed Rights (defined below), You accept and agree\nto be bound by the terms and conditions of this Creative Commons\nAttribution-ShareAlike 4.0 International Public License (\"Public\nLicense\"). To the extent this Public License may be interpreted as a\ncontract, You are granted the Licensed Rights in consideration of Your\nacceptance of these terms and conditions, and the Licensor grants You\nsuch rights in consideration of benefits the Licensor receives from\nmaking the Licensed Material available under these terms and\nconditions.\n\n\nSection 1 -- Definitions.\n\n a. Adapted Material means material subject to Copyright and Similar\n Rights that is derived from or based upon the Licensed Material\n and in which the Licensed Material is translated, altered,\n arranged, transformed, or otherwise modified in a manner requiring\n permission under the Copyright and Similar Rights held by the\n Licensor. For purposes of this Public License, where the Licensed\n Material is a musical work, performance, or sound recording,\n Adapted Material is always produced where the Licensed Material is\n synched in timed relation with a moving image.\n\n b. Adapter's License means the license You apply to Your Copyright\n and Similar Rights in Your contributions to Adapted Material in\n accordance with the terms and conditions of this Public License.\n\n c. BY-SA Compatible License means a license listed at\n creativecommons.org/compatiblelicenses, approved by Creative\n Commons as essentially the equivalent of this Public License.\n\n d. Copyright and Similar Rights means copyright and/or similar rights\n closely related to copyright including, without limitation,\n performance, broadcast, sound recording, and Sui Generis Database\n Rights, without regard to how the rights are labeled or\n categorized. For purposes of this Public License, the rights\n specified in Section 2(b)(1)-(2) are not Copyright and Similar\n Rights.\n\n e. Effective Technological Measures means those measures that, in the\n absence of proper authority, may not be circumvented under laws\n fulfilling obligations under Article 11 of the WIPO Copyright\n Treaty adopted on December 20, 1996, and/or similar international\n agreements.\n\n f. Exceptions and Limitations means fair use, fair dealing, and/or\n any other exception or limitation to Copyright and Similar Rights\n that applies to Your use of the Licensed Material.\n\n g. License Elements means the license attributes listed in the name\n of a Creative Commons Public License. The License Elements of this\n Public License are Attribution and ShareAlike.\n\n h. Licensed Material means the artistic or literary work, database,\n or other material to which the Licensor applied this Public\n License.\n\n i. Licensed Rights means the rights granted to You subject to the\n terms and conditions of this Public License, which are limited to\n all Copyright and Similar Rights that apply to Your use of the\n Licensed Material and that the Licensor has authority to license.\n\n j. Licensor means the individual(s) or entity(ies) granting rights\n under this Public License.\n\n k. Share means to provide material to the public by any means or\n process that requires permission under the Licensed Rights, such\n as reproduction, public display, public performance, distribution,\n dissemination, communication, or importation, and to make material\n available to the public including in ways that members of the\n public may access the material from a place and at a time\n individually chosen by them.\n\n l. Sui Generis Database Rights means rights other than copyright\n resulting from Directive 96/9/EC of the European Parliament and of\n the Council of 11 March 1996 on the legal protection of databases,\n as amended and/or succeeded, as well as other essentially\n equivalent rights anywhere in the world.\n\n m. You means the individual or entity exercising the Licensed Rights\n under this Public License. Your has a corresponding meaning.\n\n\nSection 2 -- Scope.\n\n a. License grant.\n\n 1. Subject to the terms and conditions of this Public License,\n the Licensor hereby grants You a worldwide, royalty-free,\n non-sublicensable, non-exclusive, irrevocable license to\n exercise the Licensed Rights in the Licensed Material to:\n\n a. reproduce and Share the Licensed Material, in whole or\n in part; and\n\n b. produce, reproduce, and Share Adapted Material.\n\n 2. Exceptions and Limitations. For the avoidance of doubt, where\n Exceptions and Limitations apply to Your use, this Public\n License does not apply, and You do not need to comply with\n its terms and conditions.\n\n 3. Term. The term of this Public License is specified in Section\n 6(a).\n\n 4. Media and formats; technical modifications allowed. The\n Licensor authorizes You to exercise the Licensed Rights in\n all media and formats whether now known or hereafter created,\n and to make technical modifications necessary to do so. The\n Licensor waives and/or agrees not to assert any right or\n authority to forbid You from making technical modifications\n necessary to exercise the Licensed Rights, including\n technical modifications necessary to circumvent Effective\n Technological Measures. For purposes of this Public License,\n simply making modifications authorized by this Section 2(a)\n (4) never produces Adapted Material.\n\n 5. Downstream recipients.\n\n a. Offer from the Licensor -- Licensed Material. Every\n recipient of the Licensed Material automatically\n receives an offer from the Licensor to exercise the\n Licensed Rights under the terms and conditions of this\n Public License.\n\n b. Additional offer from the Licensor -- Adapted Material.\n Every recipient of Adapted Material from You\n automatically receives an offer from the Licensor to\n exercise the Licensed Rights in the Adapted Material\n under the conditions of the Adapter's License You apply.\n\n c. No downstream restrictions. You may not offer or impose\n any additional or different terms or conditions on, or\n apply any Effective Technological Measures to, the\n Licensed Material if doing so restricts exercise of the\n Licensed Rights by any recipient of the Licensed\n Material.\n\n 6. No endorsement. Nothing in this Public License constitutes or\n may be construed as permission to assert or imply that You\n are, or that Your use of the Licensed Material is, connected\n with, or sponsored, endorsed, or granted official status by,\n the Licensor or others designated to receive attribution as\n provided in Section 3(a)(1)(A)(i).\n\n b. Other rights.\n\n 1. Moral rights, such as the right of integrity, are not\n licensed under this Public License, nor are publicity,\n privacy, and/or other similar personality rights; however, to\n the extent possible, the Licensor waives and/or agrees not to\n assert any such rights held by the Licensor to the limited\n extent necessary to allow You to exercise the Licensed\n Rights, but not otherwise.\n\n 2. Patent and trademark rights are not licensed under this\n Public License.\n\n 3. To the extent possible, the Licensor waives any right to\n collect royalties from You for the exercise of the Licensed\n Rights, whether directly or through a collecting society\n under any voluntary or waivable statutory or compulsory\n licensing scheme. In all other cases the Licensor expressly\n reserves any right to collect such royalties.\n\n\nSection 3 -- License Conditions.\n\nYour exercise of the Licensed Rights is expressly made subject to the\nfollowing conditions.\n\n a. Attribution.\n\n 1. If You Share the Licensed Material (including in modified\n form), You must:\n\n a. retain the following if it is supplied by the Licensor\n with the Licensed Material:\n\n i. identification of the creator(s) of the Licensed\n Material and any others designated to receive\n attribution, in any reasonable manner requested by\n the Licensor (including by pseudonym if\n designated);\n\n ii. a copyright notice;\n\n iii. a notice that refers to this Public License;\n\n iv. a notice that refers to the disclaimer of\n warranties;\n\n v. a URI or hyperlink to the Licensed Material to the\n extent reasonably practicable;\n\n b. indicate if You modified the Licensed Material and\n retain an indication of any previous modifications; and\n\n c. indicate the Licensed Material is licensed under this\n Public License, and include the text of, or the URI or\n hyperlink to, this Public License.\n\n 2. You may satisfy the conditions in Section 3(a)(1) in any\n reasonable manner based on the medium, means, and context in\n which You Share the Licensed Material. For example, it may be\n reasonable to satisfy the conditions by providing a URI or\n hyperlink to a resource that includes the required\n information.\n\n 3. If requested by the Licensor, You must remove any of the\n information required by Section 3(a)(1)(A) to the extent\n reasonably practicable.\n\n b. ShareAlike.\n\n In addition to the conditions in Section 3(a), if You Share\n Adapted Material You produce, the following conditions also apply.\n\n 1. The Adapter's License You apply must be a Creative Commons\n license with the same License Elements, this version or\n later, or a BY-SA Compatible License.\n\n 2. You must include the text of, or the URI or hyperlink to, the\n Adapter's License You apply. You may satisfy this condition\n in any reasonable manner based on the medium, means, and\n context in which You Share Adapted Material.\n\n 3. You may not offer or impose any additional or different terms\n or conditions on, or apply any Effective Technological\n Measures to, Adapted Material that restrict exercise of the\n rights granted under the Adapter's License You apply.\n\n\nSection 4 -- Sui Generis Database Rights.\n\nWhere the Licensed Rights include Sui Generis Database Rights that\napply to Your use of the Licensed Material:\n\n a. for the avoidance of doubt, Section 2(a)(1) grants You the right\n to extract, reuse, reproduce, and Share all or a substantial\n portion of the contents of the database;\n\n b. if You include all or a substantial portion of the database\n contents in a database in which You have Sui Generis Database\n Rights, then the database in which You have Sui Generis Database\n Rights (but not its individual contents) is Adapted Material,\n\n including for purposes of Section 3(b); and\n c. You must comply with the conditions in Section 3(a) if You Share\n all or a substantial portion of the contents of the database.\n\nFor the avoidance of doubt, this Section 4 supplements and does not\nreplace Your obligations under this Public License where the Licensed\nRights include other Copyright and Similar Rights.\n\n\nSection 5 -- Disclaimer of Warranties and Limitation of Liability.\n\n a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE\n EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS\n AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF\n ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,\n IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,\n WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR\n PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,\n ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT\n KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT\n ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.\n\n b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE\n TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,\n NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,\n INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,\n COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR\n USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN\n ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR\n DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR\n IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.\n\n c. The disclaimer of warranties and limitation of liability provided\n above shall be interpreted in a manner that, to the extent\n possible, most closely approximates an absolute disclaimer and\n waiver of all liability.\n\n\nSection 6 -- Term and Termination.\n\n a. This Public License applies for the term of the Copyright and\n Similar Rights licensed here. However, if You fail to comply with\n this Public License, then Your rights under this Public License\n terminate automatically.\n\n b. Where Your right to use the Licensed Material has terminated under\n Section 6(a), it reinstates:\n\n 1. automatically as of the date the violation is cured, provided\n it is cured within 30 days of Your discovery of the\n violation; or\n\n 2. upon express reinstatement by the Licensor.\n\n For the avoidance of doubt, this Section 6(b) does not affect any\n right the Licensor may have to seek remedies for Your violations\n of this Public License.\n\n c. For the avoidance of doubt, the Licensor may also offer the\n Licensed Material under separate terms or conditions or stop\n distributing the Licensed Material at any time; however, doing so\n will not terminate this Public License.\n\n d. Sections 1, 5, 6, 7, and 8 survive termination of this Public\n License.\n\n\nSection 7 -- Other Terms and Conditions.\n\n a. The Licensor shall not be bound by any additional or different\n terms or conditions communicated by You unless expressly agreed.\n\n b. Any arrangements, understandings, or agreements regarding the\n Licensed Material not stated herein are separate from and\n independent of the terms and conditions of this Public License.\n\n\nSection 8 -- Interpretation.\n\n a. For the avoidance of doubt, this Public License does not, and\n shall not be interpreted to, reduce, limit, restrict, or impose\n conditions on any use of the Licensed Material that could lawfully\n be made without permission under this Public License.\n\n b. To the extent possible, if any provision of this Public License is\n deemed unenforceable, it shall be automatically reformed to the\n minimum extent necessary to make it enforceable. If the provision\n cannot be reformed, it shall be severed from this Public License\n without affecting the enforceability of the remaining terms and\n conditions.\n\n c. No term or condition of this Public License will be waived and no\n failure to comply consented to unless expressly agreed to by the\n Licensor.\n\n d. Nothing in this Public License constitutes or may be interpreted\n as a limitation upon, or waiver of, any privileges and immunities\n that apply to the Licensor or You, including from the legal\n processes of any jurisdiction or authority.\n\n\n=======================================================================\n\nCreative Commons is not a party to its public licenses.\nNotwithstanding, Creative Commons may elect to apply one of its public\nlicenses to material it publishes and in those instances will be\nconsidered the \"Licensor.\" Except for the limited purpose of indicating\nthat material is shared under a Creative Commons public license or as\notherwise permitted by the Creative Commons policies published at\ncreativecommons.org/policies, Creative Commons does not authorize the\nuse of the trademark \"Creative Commons\" or any other trademark or logo\nof Creative Commons without its prior written consent including,\nwithout limitation, in connection with any unauthorized modifications\nto any of its public licenses or any other arrangements,\nunderstandings, or agreements concerning use of licensed material. For\nthe avoidance of doubt, this paragraph does not form part of the public\nlicenses.\n\nCreative Commons may be contacted at creativecommons.org." }, { "path": "LICENSES/CC-PDDC.txt", "content": "\nThe person or persons who have associated work with this document (the \"Dedicator\" or \"Certifier\") hereby either (a) certifies that, to the best of his knowledge, the work of authorship identified is in the public domain of the country from which the work is published, or (b) hereby dedicates whatever copyright the dedicators holds in the work of authorship identified below (the \"Work\") to the public domain. A certifier, moreover, dedicates any copyright interest he may have in the associated work, and for these purposes, is described as a \"dedicator\" below.\n\nA certifier has taken reasonable steps to verify the copyright status of this work. Certifier recognizes that his good faith efforts may not shield him from liability if in fact the work certified is not in the public domain.\n\nDedicator makes this dedication for the benefit of the public at large and to the detriment of the Dedicator's heirs and successors. Dedicator intends this dedication to be an overt act of relinquishment in perpetuity of all present and future rights under copyright law, whether vested or contingent, in the Work. Dedicator understands that such relinquishment of all rights includes the relinquishment of all rights to enforce (by lawsuit or otherwise) those copyrights in the Work.\n\nDedicator recognizes that, once placed in the public domain, the Work may be freely reproduced, distributed, transmitted, used, modified, built upon, or otherwise exploited by anyone for any purpose, commercial or non-commercial, and in any way, including by methods that have not yet been invented or conceived.\n" }, { "path": "LICENSES/GPL-3.0-only.txt", "content": "GNU GENERAL PUBLIC LICENSE\nVersion 3, 29 June 2007\n\nCopyright © 2007 Free Software Foundation, Inc. \n\nEveryone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.\n\nPreamble\n\nThe GNU General Public License is a free, copyleft license for software and other kinds of works.\n\nThe licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too.\n\nWhen we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.\n\nTo protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.\n\nFor example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.\n\nDevelopers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.\n\nFor the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions.\n\nSome devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.\n\nFinally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.\n\nThe precise terms and conditions for copying, distribution and modification follow.\n\nTERMS AND CONDITIONS\n\n0. Definitions.\n\n“This License” refers to version 3 of the GNU General Public License.\n\n“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.\n\n“The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations.\n\nTo “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work.\n\nA “covered work” means either the unmodified Program or a work based on the Program.\n\nTo “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.\n\nTo “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.\n\nAn interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.\n\n1. Source Code.\nThe “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work.\n\nA “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.\n\nThe “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.\n\nThe “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.\n\nThe Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.\n\nThe Corresponding Source for a work in source code form is that same work.\n\n2. Basic Permissions.\nAll rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.\n\nYou may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.\n\nConveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.\n\n3. Protecting Users' Legal Rights From Anti-Circumvention Law.\nNo covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.\n\nWhen you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.\n\n4. Conveying Verbatim Copies.\nYou may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.\n\nYou may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.\n\n5. Conveying Modified Source Versions.\nYou may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:\n\n a) The work must carry prominent notices stating that you modified it, and giving a relevant date.\n\n b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”.\n\n c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.\n\n d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.\n\nA compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.\n\n6. Conveying Non-Source Forms.\nYou may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:\n\n a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.\n\n b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.\n\n c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.\n\n d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.\n\n e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.\n\nA separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.\n\nA “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.\n\n“Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.\n\nIf you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).\n\nThe requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.\n\nCorresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.\n\n7. Additional Terms.\n“Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.\n\nWhen you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.\n\nNotwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:\n\n a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or\n\n b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or\n\n c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or\n\n d) Limiting the use for publicity purposes of names of licensors or authors of the material; or\n\n e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or\n\n f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.\n\nAll other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.\n\nIf you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.\n\nAdditional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.\n\n8. Termination.\nYou may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).\n\nHowever, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.\n\nMoreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.\n\nTermination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.\n\n9. Acceptance Not Required for Having Copies.\nYou are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.\n\n10. Automatic Licensing of Downstream Recipients.\nEach time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.\n\nAn “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.\n\nYou may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.\n\n11. Patents.\nA “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”.\n\nA contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.\n\nEach contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.\n\nIn the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.\n\nIf you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.\n\nIf, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.\n\nA patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.\n\nNothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.\n\n12. No Surrender of Others' Freedom.\nIf conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.\n\n13. Use with the GNU Affero General Public License.\nNotwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such.\n\n14. Revised Versions of this License.\nThe Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.\n\nEach version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.\n\nIf the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.\n\nLater license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.\n\n15. Disclaimer of Warranty.\nTHERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.\n\n16. Limitation of Liability.\nIN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.\n\n17. Interpretation of Sections 15 and 16.\nIf the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.\n\nEND OF TERMS AND CONDITIONS\n\nHow to Apply These Terms to Your New Programs\n\nIf you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.\n\nTo do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\n\n This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License along with this program. If not, see .\n\nAlso add information on how to contact you by electronic and paper mail.\n\nIf the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode:\n\n Copyright (C) \n This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.\n This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details.\n\nThe hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an “about box”.\n\nYou should also get your employer (if you work as a programmer) or school, if any, to sign a “copyright disclaimer” for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see .\n\nThe GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read .\n" }, { "path": "LICENSES/LicenseRef-DejaVu-Font.txt", "content": "Fonts are (c) Bitstream (see below). DejaVu changes are in public domain.\nGlyphs imported from Arev fonts are (c) Tavmjong Bah (see below)\n\n\nBitstream Vera Fonts Copyright\n------------------------------\n\nCopyright (c) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream Vera is\na trademark of Bitstream, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof the fonts accompanying this license (\"Fonts\") and associated\ndocumentation files (the \"Font Software\"), to reproduce and distribute the\nFont Software, including without limitation the rights to use, copy, merge,\npublish, distribute, and/or sell copies of the Font Software, and to permit\npersons to whom the Font Software is furnished to do so, subject to the\nfollowing conditions:\n\nThe above copyright and trademark notices and this permission notice shall\nbe included in all copies of one or more of the Font Software typefaces.\n\nThe Font Software may be modified, altered, or added to, and in particular\nthe designs of glyphs or characters in the Fonts may be modified and\nadditional glyphs or characters may be added to the Fonts, only if the fonts\nare renamed to names not containing either the words \"Bitstream\" or the word\n\"Vera\".\n\nThis License becomes null and void to the extent applicable to Fonts or Font\nSoftware that has been modified and is distributed under the \"Bitstream\nVera\" names.\n\nThe Font Software may be sold as part of a larger software package but no\ncopy of one or more of the Font Software typefaces may be sold by itself.\n\nTHE FONT SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS\nOR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,\nTRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME\nFOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING\nANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,\nWHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF\nTHE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE\nFONT SOFTWARE.\n\nExcept as contained in this notice, the names of Gnome, the Gnome\nFoundation, and Bitstream Inc., shall not be used in advertising or\notherwise to promote the sale, use or other dealings in this Font Software\nwithout prior written authorization from the Gnome Foundation or Bitstream\nInc., respectively. For further information, contact: fonts at gnome dot\norg.\n\nArev Fonts Copyright\n------------------------------\n\nCopyright (c) 2006 by Tavmjong Bah. All Rights Reserved.\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of the fonts accompanying this license (\"Fonts\") and\nassociated documentation files (the \"Font Software\"), to reproduce\nand distribute the modifications to the Bitstream Vera Font Software,\nincluding without limitation the rights to use, copy, merge, publish,\ndistribute, and/or sell copies of the Font Software, and to permit\npersons to whom the Font Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright and trademark notices and this permission notice\nshall be included in all copies of one or more of the Font Software\ntypefaces.\n\nThe Font Software may be modified, altered, or added to, and in\nparticular the designs of glyphs or characters in the Fonts may be\nmodified and additional glyphs or characters may be added to the\nFonts, only if the fonts are renamed to names not containing either\nthe words \"Tavmjong Bah\" or the word \"Arev\".\n\nThis License becomes null and void to the extent applicable to Fonts\nor Font Software that has been modified and is distributed under the\n\"Tavmjong Bah Arev\" names.\n\nThe Font Software may be sold as part of a larger software package but\nno copy of one or more of the Font Software typefaces may be sold by\nitself.\n\nTHE FONT SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT\nOF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL\nTAVMJONG BAH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\nINCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL\nDAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\nFROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM\nOTHER DEALINGS IN THE FONT SOFTWARE.\n\nExcept as contained in this notice, the name of Tavmjong Bah shall not\nbe used in advertising or otherwise to promote the sale, use or other\ndealings in this Font Software without prior written authorization\nfrom Tavmjong Bah. For further information, contact: tavmjong @ free\n. fr.\n\nTeX Gyre DJV Math\n-----------------\nFonts are (c) Bitstream (see below). DejaVu changes are in public domain.\n\nMath extensions done by B. Jackowski, P. Strzelczyk and P. Pianowski\n(on behalf of TeX users groups) are in public domain.\n\nLetters imported from Euler Fraktur from AMSfonts are (c) American\nMathematical Society (see below).\nBitstream Vera Fonts Copyright\nCopyright (c) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream Vera\nis a trademark of Bitstream, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof the fonts accompanying this license (“Fonts”) and associated\ndocumentation\nfiles (the “Font Software”), to reproduce and distribute the Font Software,\nincluding without limitation the rights to use, copy, merge, publish,\ndistribute,\nand/or sell copies of the Font Software, and to permit persons to whom\nthe Font Software is furnished to do so, subject to the following\nconditions:\n\nThe above copyright and trademark notices and this permission notice\nshall be\nincluded in all copies of one or more of the Font Software typefaces.\n\nThe Font Software may be modified, altered, or added to, and in particular\nthe designs of glyphs or characters in the Fonts may be modified and\nadditional\nglyphs or characters may be added to the Fonts, only if the fonts are\nrenamed\nto names not containing either the words “Bitstream” or the word “Vera”.\n\nThis License becomes null and void to the extent applicable to Fonts or\nFont Software\nthat has been modified and is distributed under the “Bitstream Vera”\nnames.\n\nThe Font Software may be sold as part of a larger software package but\nno copy\nof one or more of the Font Software typefaces may be sold by itself.\n\nTHE FONT SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS\nOR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,\nTRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME\nFOUNDATION\nBE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL,\nSPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER IN AN\nACTION\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OR\nINABILITY TO USE\nTHE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.\nExcept as contained in this notice, the names of GNOME, the GNOME\nFoundation,\nand Bitstream Inc., shall not be used in advertising or otherwise to promote\nthe sale, use or other dealings in this Font Software without prior written\nauthorization from the GNOME Foundation or Bitstream Inc., respectively.\nFor further information, contact: fonts at gnome dot org.\n\nAMSFonts (v. 2.2) copyright\n\nThe PostScript Type 1 implementation of the AMSFonts produced by and\npreviously distributed by Blue Sky Research and Y&Y, Inc. are now freely\navailable for general use. This has been accomplished through the\ncooperation\nof a consortium of scientific publishers with Blue Sky Research and Y&Y.\nMembers of this consortium include:\n\nElsevier Science IBM Corporation Society for Industrial and Applied\nMathematics (SIAM) Springer-Verlag American Mathematical Society (AMS)\n\nIn order to assure the authenticity of these fonts, copyright will be\nheld by\nthe American Mathematical Society. This is not meant to restrict in any way\nthe legitimate use of the fonts, such as (but not limited to) electronic\ndistribution of documents containing these fonts, inclusion of these fonts\ninto other public domain or commercial font collections or computer\napplications, use of the outline data to create derivative fonts and/or\nfaces, etc. However, the AMS does require that the AMS copyright notice be\nremoved from any derivative versions of the fonts which have been altered in\nany way. In addition, to ensure the fidelity of TeX documents using Computer\nModern fonts, Professor Donald Knuth, creator of the Computer Modern faces,\nhas requested that any alterations which yield different font metrics be\ngiven a different name.\n\n$Id$\n" }, { "path": "LICENSES/LicenseRef-Slint-Royalty-free-2.0.md", "content": "# Slint Royalty-free Desktop, Mobile, and Web Applications License\n\nVersion 2.0\n\n## Preamble\n\nSlint is a toolkit that can be used to build user interfaces for applications. Slint (hereafter referred to as **Software**) is made available under different licenses by SixtyFPS GmbH incorporated at Oranienburger Str. 44, 16540 Hohen Neuendorf, Germany (**SixtyFPS**). The **Slint Royalty-free Desktop, Mobile, and Web Applications License** is suitable for those who develop desktop, mobile, or web applications and do not want to use open source components under copyleft licenses.\n\n## 1. Grant of Rights\n\nSixtyFPS hereby grants You a world-wide, royalty-free, non-exclusive license to use, reproduce, make available, modify, display, perform, distribute the Software as part of a Desktop, Mobile, or Web Application.\n\nA **Desktop Application** is a computer program that is designed to run on a general-purpose computer (PC or notebook), typically installed and executed locally on the computer's operating system.\n\nA **Mobile Application** is a computer program that is designed to run on a general-purpose mobile computer (mobile phone or tablet), typically installed and executed locally on the computer's operating system.\n\nA **Web Application** is a computer program that is designed to run in the sandbox environment provided by a web browser.\n\nDesktop Application, Mobile Application, and Web Application are hereafter referred to as **Application**.\n\n## 2. License Conditions - Attribution\n\nYou may distribute the Software as part of an Application, modified or unmodified, provided that You do either of the following:\n\n(a) Display the [`AboutSlint`](https://docs.slint.dev/latest/docs/slint/reference/std-widgets/misc/aboutslint/) widget in an \"About\" screen or dialog that is accessible from the top level menu of the Application. In the absence of such a screen or dialog, display the widget in the \"Splash Screen\" of the Application.\n\n(b) Display the [Slint attribution badge](https://github.com/slint-ui/slint/tree/master/logo/MadeWithSlint-logo-whitebg.png) on a public webpage, preferably where the binaries of your Application can be downloaded from, in such a way that it can be easily found by any visitor to that page.\n\n## 3. Limitations\n\nThe License does not permit to distribute or make the Software publicly available alone and without integration into an Application. For this purpose you may use the Software under the GNU General Public License, version 3.\n\nThe License does not permit the use of the Software within Embedded Systems. An **Embedded System** is a computer system designed to perform a specific task within a larger mechanical or electrical system.\n\nThe License does not permit the distribution of Application that exposes the APIs, in part or in total, of the Software.\n\nYou may not remove or alter any license notices (including copyright notices, disclaimers of warranty, or limitations of liability) contained within the source code form of the Software.\n\n## 4. Warranty and Liability\n\nSixtyFPS is only liable for conflicting rights of third parties if SixtyFPS was aware of these rights without informing you. Unless required by applicable law or agreed to in writing, SixtyFPS provides the Software on an \"as is\" basis, without warranties or conditions of any kind, either express or implied, including, without limitation, any warranties or conditions of merchantability, or fitness for a particular purpose.\n\nUnless required by law, SixtyFPS won't be liable for any direct, indirect, incidental, or consequential damages arising in any way out of the use of the Software.\n" }, { "path": "LICENSES/LicenseRef-Slint-Software-3.0.md", "content": "# Slint Software License\n\nVersion 3.0.5\n\n## Preamble\n\nSlint is a toolkit that can be used to build user interfaces for applications. Slint (hereafter referred to as **Software**) is made available under different licenses by SixtyFPS GmbH incorporated at Oranienburger Str. 44, 16540 Hohen Neuendorf, Germany (**SixtyFPS**). The **Slint Software License** is suitable for those who do not want to use open source components under copyleft licenses.\n\n## 1. Grant of Rights\n\nSixtyFPS hereby grants You a world-wide, non-exclusive license to use, reproduce, make available, modify, display, perform, distribute the Software as part of a Desktop, Mobile, or Web Application or as part of an Embedded System (each of which is defined below).\n\nA **Desktop Application** is a computer program that is designed to run on a general-purpose computer (PC or notebook), typically installed and executed locally on the computer's operating system.\n\nA **Mobile Application** is a computer program that is designed to run on a general-purpose mobile computer (mobile phone or tablet), typically installed and executed locally on the computer's operating system.\n\nA **Web Application** is a computer program that is designed to run in the sandbox environment provided by a web browser.\n\nAn **Embedded System** is a computer system designed to perform a specific task within a larger mechanical or electrical system.\n\nDesktop Application, Mobile Application, and Web Application are hereafter referred to as **Application**.\n\n## 2. License Conditions\n\nThe grant of rights in section 1 are conditional, provided that You do all of the following:\n\n(a) You have purchased an appropriate **Paid License Plan** ([see Annex 1](#annex-1-paid-license-plans)) and the required amount of seats to cover all individual users of the Software associated with the designing, developing, or testing your Application or Embedded System. For clarity, each individual user is counted as one seat.\n\n(b) In the case that You are distributing the Software as part of an Embedded System, You have purchased an appropriate quantity of **Royalties**, one Royalty for each Embedded System. Royalties become due and payable upon manufacture of the Embedded System, regardless of whether such is subsequently sold, shipped, returned, replaced under warranty, or recalled. Payment of royalties is non-refundable under any circumstances. Royalties are not necessary for non-commercial projects, personal projects, and open source projects.\n\n## 3. Limitations\n\nThe License does not permit to distribute or make the Software publicly available alone and without integration into an Application or into an Embedded System. For this purpose you may use the Software under the GNU General Public License, version 3.\n\nThe License is limited to only the versions of Software that were made available to you under the Paid License Plan. For all other versions, you may use the Software under either the GNU General Public License, version 3 or the Slint Royalty-free Desktop, Mobile, and Web Applications License.\n\nThe License does not permit the distribution of Application that exposes the APIs, in part or in total, of the Software.\n\nYou may not remove or alter any license notices (including copyright notices, disclaimers of warranty, or limitations of liability) contained within the source code form of the Software.\n\n## 4. Audit Rights\n\nSixtyFPS or an independent certified auditor on SixtyFPS's behalf, may, upon its reasonable request, with 30 (thirty) days written notice, and at its sole expense, examine your books and records solely with respect to your use of the Software. Any such audit shall be conducted during regular business hours at your facilities and shall not unreasonably interfere with your business activities. The auditor shall not remove, copy, or redistribute any electronic material during an audit. If an audit reveals that you are using the Software in a way that is in material violation of the terms of this License, then you shall pay SixtyFPS reasonable costs of conducting the audit. The auditor shall only be allowed to report violations of the terms of this License, with a copy to you. You shall be provided the right to provide comments to the report before it is finalized.\n\n## 5. Termination\n\n(a) SixtyFPS may terminate this License if You materially breach any obligation hereunder, provided You have been provided notice of such breach and an opportunity to cure such breach during a period of not less than sixty (60) days following such notice.\n\n(b) You may terminate this License with or without cause upon no less than thirty (30) days advance written notice to SixtyFPS.\n\n(c) Upon termination of this License, You will immediately cease using, reproducing, making available, modifying, displaying, performing, distributing the Software and pay immediately any unpaid Fees and contractual penalties.\n\n(d) Sections 3 through 8 of this License will survive any termination of the License to the extent necessary to implement their objectives.\n\n## 6. Assignment\n\nYou may assign this License, in whole or in part (whether by operation of law or otherwise), with prior consent from SixtyFPS, which shall not be unreasonably withheld or delayed. SixtyFPS may assign any of its rights or delegate any of its obligations hereunder with prior notice to You, provided that the successor maintains at least the same level of security, confidentiality, and data protection measures as in place at the time of assignment or delegation. Any attempt to assign this License other than in accordance with this Section 6 shall be null and void.\n\n## 7. Severability\n\nIn the event that any provision of this License will, for any reason, be determined by any court of competent jurisdiction to be invalid, illegal or unenforceable in any respect, such invalidity, illegality or unenforceability will be interpreted as closely as possible so as not affect any other provision of this License, and such provision will further be modified by said court to permit its enforcement to the maximum extent permitted by law.\n\n## 8. Governing Law\n\nThis Agreement shall be construed, interpreted, and governed by the laws of the Federal Republic of Germany.\n\n## Annex 1: Paid License Plans\n\n### Enterprise Plan\n\nThe following is included as part of the plan\n\n(a) No restriction on the number of applications that are developed with Slint.\n\n(b) Live Preview.\n\n(c) Standard Support that includes addressing technical queries, troubleshooting, and rectifying bugs or errors (faults) present in the latest official stable release.\n\n(d) Perpetual Fallback License that allows continued use of a specific Slint version, including all bugfix updates (i.e., all Z releases within the X.Y.Z version), without an active subscription. This license applies only to those versions of Slint for which at least 12 consecutive months of subscription have been paid.\n\n(e) GUI Test Framework.\n\n### Small Enterprise Plan\n\nThis plan is limited to individual companies with a staff headcount between 10 and 50 and either a turnover or balance sheet total of 10 million EUR or less. If You are a Small Enterprise, You are required to submit the self-assessment report generated from the EU SME Self-Assessment Tool (https://ec.europa.eu/info/funding-tenders/opportunities/portal/sme/public/organisation-name).\n\nThe following is included as part of the plan\n\n(a) No restriction on the number of applications that are developed with Slint.\n\n(b) Live Preview.\n\n(c) Standard Support that includes addressing technical queries, troubleshooting, and rectifying bugs or errors (faults) present in the latest official stable release.\n\nThe following can be purchased as an Add-On\n\n(a) Perpetual Fallback License that allows continued use of a specific Slint version, including all bugfix updates (i.e., all Z releases within the X.Y.Z version), without an active subscription. This license applies only to those versions of Slint for which at least 12 consecutive months of subscription have been paid.\n\n(b) GUI Test Framework.\n\n### Startup & Individual Plan\n\nThis plan is limited to individuals and individual companies with a staff headcount of less than 10 and either a turnover or balance sheet total of 2 million EUR or less. If You are a Startup, you are required to submit the self-assessment report generated from the EU SME Self-Assessment Tool (https://ec.europa.eu/info/funding-tenders/opportunities/portal/sme/public/organisation-name).\n\nThe following is included as part of the plan\n\n(a) No restriction on the number of applications that are developed with Slint.\n\n(b) Live Preview.\n\nThe following can be purchased as an Add-On\n\n(a) Standard Support that includes addressing technical queries, troubleshooting, and rectifying bugs or errors (faults) present in the latest official stable release.\n\n(b) Perpetual Fallback License that allows continued use of a specific Slint version, including all bugfix updates (i.e., all Z releases within the X.Y.Z version), without an active subscription. This license applies only to those versions of Slint for which at least 12 consecutive months of subscription have been paid.\n\n(c) GUI Test Framework.\n" }, { "path": "LICENSES/LicenseRef-qskinny.txt", "content": " QSkinny License\n Version 1.0, November 1, 2016\n\nQSkinny is Copyright (C) 2016 Uwe Rathmann\n\nYou may use, distribute and copy QSkinny under the terms of\nGNU Lesser General Public License version 2.1, which is displayed below\nwith the following exceptions:\n\n 1. The object code form of a \"work that uses the Library\" may incorporate\n material from a header file that is part of the Library. You may\n distribute such object code under terms of your choice, provided that:\n\n (i) the header files of the Library have not been modified; and\n (ii) the incorporated material is limited to numerical parameters, data\n structure layouts, accessors, macros, inline functions and\n templates; and\n (iii) you comply with the terms of Section 6 of the GNU Lesser General\n Public License version 2.1.\n\n-------------------------------------------------------------------------\n\n GNU LESSER GENERAL PUBLIC LICENSE\n Version 2.1, February 1999\n\n Copyright (C) 1991, 1999 Free Software Foundation, Inc.\n 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n[This is the first released version of the Lesser GPL. It also counts\n as the successor of the GNU Library Public License, version 2, hence\n the version number 2.1.]\n\n Preamble\n\n The licenses for most software are designed to take away your\nfreedom to share and change it. By contrast, the GNU General Public\nLicenses are intended to guarantee your freedom to share and change\nfree software--to make sure the software is free for all its users.\n\n This license, the Lesser General Public License, applies to some\nspecially designated software packages--typically libraries--of the\nFree Software Foundation and other authors who decide to use it. You\ncan use it too, but we suggest you first think carefully about whether\nthis license or the ordinary General Public License is the better\nstrategy to use in any particular case, based on the explanations below.\n\n When we speak of free software, we are referring to freedom of use,\nnot price. Our General Public Licenses are designed to make sure that\nyou have the freedom to distribute copies of free software (and charge\nfor this service if you wish); that you receive source code or can get\nit if you want it; that you can change the software and use pieces of\nit in new free programs; and that you are informed that you can do\nthese things.\n\n To protect your rights, we need to make restrictions that forbid\ndistributors to deny you these rights or to ask you to surrender these\nrights. These restrictions translate to certain responsibilities for\nyou if you distribute copies of the library or if you modify it.\n\n For example, if you distribute copies of the library, whether gratis\nor for a fee, you must give the recipients all the rights that we gave\nyou. You must make sure that they, too, receive or can get the source\ncode. If you link other code with the library, you must provide\ncomplete object files to the recipients, so that they can relink them\nwith the library after making changes to the library and recompiling\nit. And you must show them these terms so they know their rights.\n\n We protect your rights with a two-step method: (1) we copyright the\nlibrary, and (2) we offer you this license, which gives you legal\npermission to copy, distribute and/or modify the library.\n\n To protect each distributor, we want to make it very clear that\nthere is no warranty for the free library. Also, if the library is\nmodified by someone else and passed on, the recipients should know\nthat what they have is not the original version, so that the original\nauthor's reputation will not be affected by problems that might be\nintroduced by others.\n\n Finally, software patents pose a constant threat to the existence of\nany free program. We wish to make sure that a company cannot\neffectively restrict the users of a free program by obtaining a\nrestrictive license from a patent holder. Therefore, we insist that\nany patent license obtained for a version of the library must be\nconsistent with the full freedom of use specified in this license.\n\n Most GNU software, including some libraries, is covered by the\nordinary GNU General Public License. This license, the GNU Lesser\nGeneral Public License, applies to certain designated libraries, and\nis quite different from the ordinary General Public License. We use\nthis license for certain libraries in order to permit linking those\nlibraries into non-free programs.\n\n When a program is linked with a library, whether statically or using\na shared library, the combination of the two is legally speaking a\ncombined work, a derivative of the original library. The ordinary\nGeneral Public License therefore permits such linking only if the\nentire combination fits its criteria of freedom. The Lesser General\nPublic License permits more lax criteria for linking other code with\nthe library.\n\n We call this license the \"Lesser\" General Public License because it\ndoes Less to protect the user's freedom than the ordinary General\nPublic License. It also provides other free software developers Less\nof an advantage over competing non-free programs. These disadvantages\nare the reason we use the ordinary General Public License for many\nlibraries. However, the Lesser license provides advantages in certain\nspecial circumstances.\n\n For example, on rare occasions, there may be a special need to\nencourage the widest possible use of a certain library, so that it becomes\na de-facto standard. To achieve this, non-free programs must be\nallowed to use the library. A more frequent case is that a free\nlibrary does the same job as widely used non-free libraries. In this\ncase, there is little to gain by limiting the free library to free\nsoftware only, so we use the Lesser General Public License.\n\n In other cases, permission to use a particular library in non-free\nprograms enables a greater number of people to use a large body of\nfree software. For example, permission to use the GNU C Library in\nnon-free programs enables many more people to use the whole GNU\noperating system, as well as its variant, the GNU/Linux operating\nsystem.\n\n Although the Lesser General Public License is Less protective of the\nusers' freedom, it does ensure that the user of a program that is\nlinked with the Library has the freedom and the wherewithal to run\nthat program using a modified version of the Library.\n\n The precise terms and conditions for copying, distribution and\nmodification follow. Pay close attention to the difference between a\n\"work based on the library\" and a \"work that uses the library\". The\nformer contains code derived from the library, whereas the latter must\nbe combined with the library in order to run.\n\n GNU LESSER GENERAL PUBLIC LICENSE\n TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION\n\n 0. This License Agreement applies to any software library or other\nprogram which contains a notice placed by the copyright holder or\nother authorized party saying it may be distributed under the terms of\nthis Lesser General Public License (also called \"this License\").\nEach licensee is addressed as \"you\".\n\n A \"library\" means a collection of software functions and/or data\nprepared so as to be conveniently linked with application programs\n(which use some of those functions and data) to form executables.\n\n The \"Library\", below, refers to any such software library or work\nwhich has been distributed under these terms. A \"work based on the\nLibrary\" means either the Library or any derivative work under\ncopyright law: that is to say, a work containing the Library or a\nportion of it, either verbatim or with modifications and/or translated\nstraightforwardly into another language. (Hereinafter, translation is\nincluded without limitation in the term \"modification\".)\n\n \"Source code\" for a work means the preferred form of the work for\nmaking modifications to it. For a library, complete source code means\nall the source code for all modules it contains, plus any associated\ninterface definition files, plus the scripts used to control compilation\nand installation of the library.\n\n Activities other than copying, distribution and modification are not\ncovered by this License; they are outside its scope. The act of\nrunning a program using the Library is not restricted, and output from\nsuch a program is covered only if its contents constitute a work based\non the Library (independent of the use of the Library in a tool for\nwriting it). Whether that is true depends on what the Library does\nand what the program that uses the Library does.\n\n 1. You may copy and distribute verbatim copies of the Library's\ncomplete source code as you receive it, in any medium, provided that\nyou conspicuously and appropriately publish on each copy an\nappropriate copyright notice and disclaimer of warranty; keep intact\nall the notices that refer to this License and to the absence of any\nwarranty; and distribute a copy of this License along with the\nLibrary.\n\n You may charge a fee for the physical act of transferring a copy,\nand you may at your option offer warranty protection in exchange for a\nfee.\n\n 2. You may modify your copy or copies of the Library or any portion\nof it, thus forming a work based on the Library, and copy and\ndistribute such modifications or work under the terms of Section 1\nabove, provided that you also meet all of these conditions:\n\n a) The modified work must itself be a software library.\n\n b) You must cause the files modified to carry prominent notices\n stating that you changed the files and the date of any change.\n\n c) You must cause the whole of the work to be licensed at no\n charge to all third parties under the terms of this License.\n\n d) If a facility in the modified Library refers to a function or a\n table of data to be supplied by an application program that uses\n the facility, other than as an argument passed when the facility\n is invoked, then you must make a good faith effort to ensure that,\n in the event an application does not supply such function or\n table, the facility still operates, and performs whatever part of\n its purpose remains meaningful.\n\n (For example, a function in a library to compute square roots has\n a purpose that is entirely well-defined independent of the\n application. Therefore, Subsection 2d requires that any\n application-supplied function or table used by this function must\n be optional: if the application does not supply it, the square\n root function must still compute square roots.)\n\nThese requirements apply to the modified work as a whole. If\nidentifiable sections of that work are not derived from the Library,\nand can be reasonably considered independent and separate works in\nthemselves, then this License, and its terms, do not apply to those\nsections when you distribute them as separate works. But when you\ndistribute the same sections as part of a whole which is a work based\non the Library, the distribution of the whole must be on the terms of\nthis License, whose permissions for other licensees extend to the\nentire whole, and thus to each and every part regardless of who wrote\nit.\n\nThus, it is not the intent of this section to claim rights or contest\nyour rights to work written entirely by you; rather, the intent is to\nexercise the right to control the distribution of derivative or\ncollective works based on the Library.\n\nIn addition, mere aggregation of another work not based on the Library\nwith the Library (or with a work based on the Library) on a volume of\na storage or distribution medium does not bring the other work under\nthe scope of this License.\n\n 3. You may opt to apply the terms of the ordinary GNU General Public\nLicense instead of this License to a given copy of the Library. To do\nthis, you must alter all the notices that refer to this License, so\nthat they refer to the ordinary GNU General Public License, version 2,\ninstead of to this License. (If a newer version than version 2 of the\nordinary GNU General Public License has appeared, then you can specify\nthat version instead if you wish.) Do not make any other change in\nthese notices.\n\n Once this change is made in a given copy, it is irreversible for\nthat copy, so the ordinary GNU General Public License applies to all\nsubsequent copies and derivative works made from that copy.\n\n This option is useful when you wish to copy part of the code of\nthe Library into a program that is not a library.\n\n 4. You may copy and distribute the Library (or a portion or\nderivative of it, under Section 2) in object code or executable form\nunder the terms of Sections 1 and 2 above provided that you accompany\nit with the complete corresponding machine-readable source code, which\nmust be distributed under the terms of Sections 1 and 2 above on a\nmedium customarily used for software interchange.\n\n If distribution of object code is made by offering access to copy\nfrom a designated place, then offering equivalent access to copy the\nsource code from the same place satisfies the requirement to\ndistribute the source code, even though third parties are not\ncompelled to copy the source along with the object code.\n\n 5. A program that contains no derivative of any portion of the\nLibrary, but is designed to work with the Library by being compiled or\nlinked with it, is called a \"work that uses the Library\". Such a\nwork, in isolation, is not a derivative work of the Library, and\ntherefore falls outside the scope of this License.\n\n However, linking a \"work that uses the Library\" with the Library\ncreates an executable that is a derivative of the Library (because it\ncontains portions of the Library), rather than a \"work that uses the\nlibrary\". The executable is therefore covered by this License.\nSection 6 states terms for distribution of such executables.\n\n When a \"work that uses the Library\" uses material from a header file\nthat is part of the Library, the object code for the work may be a\nderivative work of the Library even though the source code is not.\nWhether this is true is especially significant if the work can be\nlinked without the Library, or if the work is itself a library. The\nthreshold for this to be true is not precisely defined by law.\n\n If such an object file uses only numerical parameters, data\nstructure layouts and accessors, and small macros and small inline\nfunctions (ten lines or less in length), then the use of the object\nfile is unrestricted, regardless of whether it is legally a derivative\nwork. (Executables containing this object code plus portions of the\nLibrary will still fall under Section 6.)\n\n Otherwise, if the work is a derivative of the Library, you may\ndistribute the object code for the work under the terms of Section 6.\nAny executables containing that work also fall under Section 6,\nwhether or not they are linked directly with the Library itself.\n\n 6. As an exception to the Sections above, you may also combine or\nlink a \"work that uses the Library\" with the Library to produce a\nwork containing portions of the Library, and distribute that work\nunder terms of your choice, provided that the terms permit\nmodification of the work for the customer's own use and reverse\nengineering for debugging such modifications.\n\n You must give prominent notice with each copy of the work that the\nLibrary is used in it and that the Library and its use are covered by\nthis License. You must supply a copy of this License. If the work\nduring execution displays copyright notices, you must include the\ncopyright notice for the Library among them, as well as a reference\ndirecting the user to the copy of this License. Also, you must do one\nof these things:\n\n a) Accompany the work with the complete corresponding\n machine-readable source code for the Library including whatever\n changes were used in the work (which must be distributed under\n Sections 1 and 2 above); and, if the work is an executable linked\n with the Library, with the complete machine-readable \"work that\n uses the Library\", as object code and/or source code, so that the\n user can modify the Library and then relink to produce a modified\n executable containing the modified Library. (It is understood\n that the user who changes the contents of definitions files in the\n Library will not necessarily be able to recompile the application\n to use the modified definitions.)\n\n b) Use a suitable shared library mechanism for linking with the\n Library. A suitable mechanism is one that (1) uses at run time a\n copy of the library already present on the user's computer system,\n rather than copying library functions into the executable, and (2)\n will operate properly with a modified version of the library, if\n the user installs one, as long as the modified version is\n interface-compatible with the version that the work was made with.\n\n c) Accompany the work with a written offer, valid for at\n least three years, to give the same user the materials\n specified in Subsection 6a, above, for a charge no more\n than the cost of performing this distribution.\n\n d) If distribution of the work is made by offering access to copy\n from a designated place, offer equivalent access to copy the above\n specified materials from the same place.\n\n e) Verify that the user has already received a copy of these\n materials or that you have already sent this user a copy.\n\n For an executable, the required form of the \"work that uses the\nLibrary\" must include any data and utility programs needed for\nreproducing the executable from it. However, as a special exception,\nthe materials to be distributed need not include anything that is\nnormally distributed (in either source or binary form) with the major\ncomponents (compiler, kernel, and so on) of the operating system on\nwhich the executable runs, unless that component itself accompanies\nthe executable.\n\n It may happen that this requirement contradicts the license\nrestrictions of other proprietary libraries that do not normally\naccompany the operating system. Such a contradiction means you cannot\nuse both them and the Library together in an executable that you\ndistribute.\n\n 7. You may place library facilities that are a work based on the\nLibrary side-by-side in a single library together with other library\nfacilities not covered by this License, and distribute such a combined\nlibrary, provided that the separate distribution of the work based on\nthe Library and of the other library facilities is otherwise\npermitted, and provided that you do these two things:\n\n a) Accompany the combined library with a copy of the same work\n based on the Library, uncombined with any other library\n facilities. This must be distributed under the terms of the\n Sections above.\n\n b) Give prominent notice with the combined library of the fact\n that part of it is a work based on the Library, and explaining\n where to find the accompanying uncombined form of the same work.\n\n 8. You may not copy, modify, sublicense, link with, or distribute\nthe Library except as expressly provided under this License. Any\nattempt otherwise to copy, modify, sublicense, link with, or\ndistribute the Library is void, and will automatically terminate your\nrights under this License. However, parties who have received copies,\nor rights, from you under this License will not have their licenses\nterminated so long as such parties remain in full compliance.\n\n 9. You are not required to accept this License, since you have not\nsigned it. However, nothing else grants you permission to modify or\ndistribute the Library or its derivative works. These actions are\nprohibited by law if you do not accept this License. Therefore, by\nmodifying or distributing the Library (or any work based on the\nLibrary), you indicate your acceptance of this License to do so, and\nall its terms and conditions for copying, distributing or modifying\nthe Library or works based on it.\n\n 10. Each time you redistribute the Library (or any work based on the\nLibrary), the recipient automatically receives a license from the\noriginal licensor to copy, distribute, link with or modify the Library\nsubject to these terms and conditions. You may not impose any further\nrestrictions on the recipients' exercise of the rights granted herein.\nYou are not responsible for enforcing compliance by third parties with\nthis License.\n\n 11. If, as a consequence of a court judgment or allegation of patent\ninfringement or for any other reason (not limited to patent issues),\nconditions are imposed on you (whether by court order, agreement or\notherwise) that contradict the conditions of this License, they do not\nexcuse you from the conditions of this License. If you cannot\ndistribute so as to satisfy simultaneously your obligations under this\nLicense and any other pertinent obligations, then as a consequence you\nmay not distribute the Library at all. For example, if a patent\nlicense would not permit royalty-free redistribution of the Library by\nall those who receive copies directly or indirectly through you, then\nthe only way you could satisfy both it and this License would be to\nrefrain entirely from distribution of the Library.\n\nIf any portion of this section is held invalid or unenforceable under any\nparticular circumstance, the balance of the section is intended to apply,\nand the section as a whole is intended to apply in other circumstances.\n\nIt is not the purpose of this section to induce you to infringe any\npatents or other property right claims or to contest validity of any\nsuch claims; this section has the sole purpose of protecting the\nintegrity of the free software distribution system which is\nimplemented by public license practices. Many people have made\ngenerous contributions to the wide range of software distributed\nthrough that system in reliance on consistent application of that\nsystem; it is up to the author/donor to decide if he or she is willing\nto distribute software through any other system and a licensee cannot\nimpose that choice.\n\nThis section is intended to make thoroughly clear what is believed to\nbe a consequence of the rest of this License.\n\n 12. If the distribution and/or use of the Library is restricted in\ncertain countries either by patents or by copyrighted interfaces, the\noriginal copyright holder who places the Library under this License may add\nan explicit geographical distribution limitation excluding those countries,\nso that distribution is permitted only in or among countries not thus\nexcluded. In such case, this License incorporates the limitation as if\nwritten in the body of this License.\n\n 13. The Free Software Foundation may publish revised and/or new\nversions of the Lesser General Public License from time to time.\nSuch new versions will be similar in spirit to the present version,\nbut may differ in detail to address new problems or concerns.\n\nEach version is given a distinguishing version number. If the Library\nspecifies a version number of this License which applies to it and\n\"any later version\", you have the option of following the terms and\nconditions either of that version or of any later version published by\nthe Free Software Foundation. If the Library does not specify a\nlicense version number, you may choose any version ever published by\nthe Free Software Foundation.\n\n 14. If you wish to incorporate parts of the Library into other free\nprograms whose distribution conditions are incompatible with these,\nwrite to the author to ask for permission. For software which is\ncopyrighted by the Free Software Foundation, write to the Free\nSoftware Foundation; we sometimes make exceptions for this. Our\ndecision will be guided by the two goals of preserving the free status\nof all derivatives of our free software and of promoting the sharing\nand reuse of software generally.\n\n NO WARRANTY\n\n 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO\nWARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.\nEXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR\nOTHER PARTIES PROVIDE THE LIBRARY \"AS IS\" WITHOUT WARRANTY OF ANY\nKIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE\nLIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME\nTHE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.\n\n 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN\nWRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY\nAND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU\nFOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR\nCONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE\nLIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING\nRENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A\nFAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF\nSUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH\nDAMAGES.\n\n END OF TERMS AND CONDITIONS\n\n How to Apply These Terms to Your New Libraries\n\n If you develop a new library, and you want it to be of the greatest\npossible use to the public, we recommend making it free software that\neveryone can redistribute and change. You can do so by permitting\nredistribution under these terms (or, alternatively, under the terms of the\nordinary General Public License).\n\n To apply these terms, attach the following notices to the library. It is\nsafest to attach them to the start of each source file to most effectively\nconvey the exclusion of warranty; and each file should have at least the\n\"copyright\" line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This library is free software; you can redistribute it and/or\n modify it under the terms of the GNU Lesser General Public\n License as published by the Free Software Foundation; either\n version 2.1 of the License, or (at your option) any later version.\n\n This library is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n Lesser General Public License for more details.\n\n You should have received a copy of the GNU Lesser General Public\n License along with this library; if not, write to the Free Software\n Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n\nAlso add information on how to contact you by electronic and paper mail.\n\nYou should also get your employer (if you work as a programmer) or your\nschool, if any, to sign a \"copyright disclaimer\" for the library, if\nnecessary. Here is a sample; alter the names:\n\n Yoyodyne, Inc., hereby disclaims all copyright interest in the\n library `Frob' (a library for tweaking knobs) written by James Random Hacker.\n\n , 1 April 1990\n Ty Coon, President of Vice\n\nThat's all there is to it!\n" }, { "path": "LICENSES/MIT.txt", "content": "MIT License\n\nCopyright (c) \n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" }, { "path": "LICENSES/OFL-1.1-RFN.txt", "content": "SIL OPEN FONT LICENSE\n\nVersion 1.1 - 26 February 2007\n\nPREAMBLE\n\nThe goals of the Open Font License (OFL) are to stimulate worldwide development of collaborative font projects, to support the font creation efforts of academic and linguistic communities, and to provide a free and open framework in which fonts may be shared and improved in partnership with others.\n\nThe OFL allows the licensed fonts to be used, studied, modified and redistributed freely as long as they are not sold by themselves. The fonts, including any derivative works, can be bundled, embedded, redistributed and/or sold with any software provided that any reserved names are not used by derivative works. The fonts and derivatives, however, cannot be released under any other type of license. The requirement for fonts to remain under this license does not apply to any document created using the fonts or their derivatives.\n\nDEFINITIONS\n\n\"Font Software\" refers to the set of files released by the Copyright Holder(s) under this license and clearly marked as such. This may include source files, build scripts and documentation.\n\n\"Reserved Font Name\" refers to any names specified as such after the copyright statement(s).\n\n\"Original Version\" refers to the collection of Font Software components as distributed by the Copyright Holder(s).\n\n\"Modified Version\" refers to any derivative made by adding to, deleting, or substituting — in part or in whole — any of the components of the Original Version, by changing formats or by porting the Font Software to a new environment.\n\n\"Author\" refers to any designer, engineer, programmer, technical writer or other person who contributed to the Font Software.\n\nPERMISSION & CONDITIONS\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of the Font Software, to use, study, copy, merge, embed, modify, redistribute, and sell modified and unmodified copies of the Font Software, subject to the following conditions:\n\n1) Neither the Font Software nor any of its individual components, in Original or Modified Versions, may be sold by itself.\n\n2) Original or Modified Versions of the Font Software may be bundled, redistributed and/or sold with any software, provided that each copy contains the above copyright notice and this license. These can be included either as stand-alone text files, human-readable headers or in the appropriate machine-readable metadata fields within text or binary files as long as those fields can be easily viewed by the user.\n\n3) No Modified Version of the Font Software may use the Reserved Font Name(s) unless explicit written permission is granted by the corresponding Copyright Holder. This restriction only applies to the primary font name as presented to the users.\n\n4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font Software shall not be used to promote, endorse or advertise any Modified Version, except to acknowledge the contribution(s) of the Copyright Holder(s) and the Author(s) or with their explicit written permission.\n\n5) The Font Software, modified or unmodified, in part or in whole, must be distributed entirely under this license, and must not be distributed under any other license. The requirement for fonts to remain under this license does not apply to any document created using the Font Software.\n\nTERMINATION\n\nThis license becomes null and void if any of the above conditions are not met.\n\nDISCLAIMER\n\nTHE FONT SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.\n" }, { "path": "LICENSES/OFL-1.1.txt", "content": "SIL OPEN FONT LICENSE\n\nVersion 1.1 - 26 February 2007\n\nPREAMBLE\n\nThe goals of the Open Font License (OFL) are to stimulate worldwide development of collaborative font projects, to support the font creation efforts of academic and linguistic communities, and to provide a free and open framework in which fonts may be shared and improved in partnership with others.\n\nThe OFL allows the licensed fonts to be used, studied, modified and redistributed freely as long as they are not sold by themselves. The fonts, including any derivative works, can be bundled, embedded, redistributed and/or sold with any software provided that any reserved names are not used by derivative works. The fonts and derivatives, however, cannot be released under any other type of license. The requirement for fonts to remain under this license does not apply to any document created using the fonts or their derivatives.\n\nDEFINITIONS\n\n\"Font Software\" refers to the set of files released by the Copyright Holder(s) under this license and clearly marked as such. This may include source files, build scripts and documentation.\n\n\"Reserved Font Name\" refers to any names specified as such after the copyright statement(s).\n\n\"Original Version\" refers to the collection of Font Software components as distributed by the Copyright Holder(s).\n\n\"Modified Version\" refers to any derivative made by adding to, deleting, or substituting — in part or in whole — any of the components of the Original Version, by changing formats or by porting the Font Software to a new environment.\n\n\"Author\" refers to any designer, engineer, programmer, technical writer or other person who contributed to the Font Software.\n\nPERMISSION & CONDITIONS\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of the Font Software, to use, study, copy, merge, embed, modify, redistribute, and sell modified and unmodified copies of the Font Software, subject to the following conditions:\n\n1) Neither the Font Software nor any of its individual components, in Original or Modified Versions, may be sold by itself.\n\n2) Original or Modified Versions of the Font Software may be bundled, redistributed and/or sold with any software, provided that each copy contains the above copyright notice and this license. These can be included either as stand-alone text files, human-readable headers or in the appropriate machine-readable metadata fields within text or binary files as long as those fields can be easily viewed by the user.\n\n3) No Modified Version of the Font Software may use the Reserved Font Name(s) unless explicit written permission is granted by the corresponding Copyright Holder. This restriction only applies to the primary font name as presented to the users.\n\n4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font Software shall not be used to promote, endorse or advertise any Modified Version, except to acknowledge the contribution(s) of the Copyright Holder(s) and the Author(s) or with their explicit written permission.\n\n5) The Font Software, modified or unmodified, in part or in whole, must be distributed entirely under this license, and must not be distributed under any other license. The requirement for fonts to remain under this license does not apply to any document created using the Font Software.\n\nTERMINATION\n\nThis license becomes null and void if any of the above conditions are not met.\n\nDISCLAIMER\n\nTHE FONT SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.\n" }, { "path": "LICENSES/Unlicense.txt", "content": "This is free and unencumbered software released into the public domain.\n\nAnyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.\n\nIn jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and\nsuccessors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\nFor more information, please refer to \n" }, { "path": "README.md", "content": "\n![Slint](./logo/slint-logo-full-light.svg#gh-light-mode-only) ![Slint](./logo/slint-logo-full-dark.svg#gh-dark-mode-only)\n\n[![Build Status](https://github.com/slint-ui/slint/workflows/CI/badge.svg)](https://github.com/slint-ui/slint/actions)\n[![REUSE status](https://api.reuse.software/badge/github.com/slint-ui/slint)](https://api.reuse.software/info/github.com/slint-ui/slint)\n[![Discussions](https://img.shields.io/github/discussions/slint-ui/slint)](https://github.com/slint-ui/slint/discussions)\n\n**Slint** is an open-source declarative GUI toolkit for building native user interfaces for embedded systems, desktops, and mobile platforms.\n\nWrite your UI once in `.slint`, a simple markup language. Connect it to business logic written in Rust, C++, JavaScript, or Python.\n\n## Why Slint?\n\nThe name *Slint* is derived from our design goals:\n\n- **Scalable**: Slint should support responsive UI design, allow cross-platform\n usage across operating systems and processor architectures and support\n multiple programming languages.\n- **Lightweight**: Slint should require minimal resources, in terms of memory\n and processing power, and yet deliver a smooth, smartphone-like user\n experience on any device.\n- **Intuitive**: Designers and developers should feel productive while enjoying\n the GUI design and development process. The design creation tools should be\n intuitive to use for the designers. Similarly for the developers, the APIs\n should be consistent and easy to use, no matter which programming language\n they choose.\n- **Native**: GUI built with Slint should match the end users' expectations of a\n native application irrespective of the platform - desktop, mobile, web or\n embedded system. The UI design should be compiled to machine code and provide\n flexibility that only a native application can offer: Access full operating\n system APIs, utilize all CPU and GPU cores, connect to any peripheral.\n\nBeyond the design goals, here’s what makes Slint stand out:\n\n- **Independent UI Design**: Use a declarative language similar to separate your UI from business logic. Designers can work in parallel with developers.\n- **Tooling**: Iterate quickly with our Live Preview & editor integrations. Integrate from Figma with the [Figma to Slint plugin](https://www.figma.com/community/plugin/1474418299182276871/figma-to-slint).\n- **Stable APIs**: Slint follows a stable 1.x API. We evolve carefully without breaking your code.\n\nSee what others have built: [#MadeWithSlint](https://madewithslint.com)\n\n## Examples\n\n### Embedded\n\n| RaspberryPi | STM32 | RP2040 |\n| ------------------------------------ | ----------------------------- | ------------------------------ |\n| [Video of Slint on Raspberry Pi][#1] | [Video of Slint on STM32][#2] | [Video of Slint on RP2040][#3] |\n\n### Desktop\n\n| Windows | macOS | Linux |\n| ------------------------------------------- | ----------------------------------------- | ----------------------------------------- |\n| ![Screenshot of the Gallery on Windows][#4] | ![Screenshot of the Gallery on macOS][#5] | ![Screenshot of the Gallery on Linux][#6] |\n\n### Web using WebAssembly\n\n| Printer Demo | Slide Puzzle | Energy Monitor | Widget Gallery | Weather demo |\n| ------------------------------------------- | -------------------------------------------- | ---------------------------------------------------- | --------------------------------------------- | --------------------------------------------- |\n| [![Screenshot of the Printer Demo][#7]][#8] | [![Screenshot of the Slide Puzzle][#9]][#10] | [![Screenshot of the Energy Monitor Demo][#11]][#12] | [![Screenshot of the Gallery Demo][#13]][#14] | [![Screenshot of the weather Demo][#29]][#30] |\n\nMore examples and demos in the [examples folder](examples#examples)\n\n## Get Started\n\n### Hello World\n\nThe UI is defined in a Domain Specific Language that is declarative, easy to use,\nintuitive, and provides a powerful way to describe graphical elements, their\nplacement, their hierarchy, property bindings, and the flow of data through the\ndifferent states.\n\nHere's the obligatory \"Hello World\":\n\n```slint\nexport component HelloWorld inherits Window {\n width: 400px;\n height: 400px;\n\n Text {\n y: parent.width / 2;\n x: parent.x + 200px;\n text: \"Hello, world\";\n color: blue;\n }\n}\n```\n\n### Documentation\n\nFor more details, check out the [Slint Language Documentation](https://slint.dev/docs/slint).\n\nThe [examples](examples) folder contains examples and demos, showing how to\nuse the Slint markup language and how to interact with a Slint user interface\nfrom supported programming languages.\n\nThe `docs` folder contains a lot more information, including\n[build instructions](docs/building.md), and\n[internal developer docs](docs/development.md).\n\nRefer to the README of each language directory in the `api` folder:\n\n- [C++](api/cpp) ([Documentation][#15] | [Getting Started Template][#17])\n- [Rust](api/rs/slint) [![Crates.io][#18]][#19] ([Documentation][#20] | [Tutorial Video][#22] | [Getting Started Template][#23])\n- [JavaScript/NodeJS (Beta)](api/node) [![npm][#24]][#25] ([Documentation][#26] | [Getting Started Template][#28])\n- [Python (Beta)](api/python/slint) [![pypi][#31]][#32] ([Documentation][#33] | [Getting Started Template][#34])\n\n## Architecture\n\nAn application is composed of the business logic written in Rust, C++, or\nJavaScript and the `.slint` user interface design markup, which is compiled to\nnative code.\n\n![Architecture Overview](https://slint.dev/resources/architecture.drawio.svg)\n\n### Compiler\n\nThe `.slint` files are compiled ahead of time. The expressions in the `.slint`\nare pure functions that the compiler can optimize. For example, the compiler\ncould choose to \"inline\" properties and remove those that are constant or\nunchanged.\n\nThe compiler uses the typical compiler phases of lexing, parsing, optimization,\nand finally code generation. It provides different back-ends for code generation\nin the target language. The C++ code generator produces a C++ header file, the\nRust generator produces Rust code, and so on. An interpreter for dynamic\nlanguages is also included.\n\n### Runtime\n\nThe runtime library consists of an engine that supports properties declared in\nthe `.slint` language. Components with their elements, items, and properties are\nlaid out in a single memory region, to reduce memory allocations.\n\nRendering backends and styles are configurable at compile time:\n\n- The `femtovg` renderer uses OpenGL ES 2.0 for rendering.\n- The `skia` renderer uses [Skia](https://skia.org) for rendering.\n- The `software` renderer uses the CPU with no additional dependencies.\n\nNOTE: When Qt is installed on the system, the `qt` style becomes available,\nusing Qt's QStyle to achieve native looking widgets.\n\n### Tooling\n\nWe have a few tools to help with the development of .slint files:\n\n- A [**LSP Server**](./tools/lsp) that adds features like auto-complete and live\n preview of the .slint files to many editors.\n- It is bundled in a [**Visual Studio Code Extension**](./editors/vscode)\n available from the market place.\n- A [**slint-viewer**](./tools/viewer) tool which displays the .slint files. The\n `--auto-reload` argument makes it easy to preview your UI while you are\n working on it (when using the LSP preview is not possible).\n- [**SlintPad**](https://slintpad.com/), an online editor to try out .slint syntax\n without installing anything ([sources](./tools/slintpad)).\n- A [**Figma to Slint**](https://www.figma.com/community/plugin/1474418299182276871/figma-to-slint) plugin.\n\nPlease check our [Editors README](./editors/README.md) for tips on how to\nconfigure your favorite editor to work well with Slint.\n\n## License\n\nYou can use Slint under ***any*** of the following licenses, at your choice:\n\n1. Build proprietary desktop, mobile, or web applications for free with the [Royalty-free License](LICENSES/LicenseRef-Slint-Royalty-free-2.0.md),\n2. Build open source embedded, desktop, mobile, or web applications for free with the [GNU GPLv3](LICENSES/GPL-3.0-only.txt),\n3. Build proprietary embedded, desktop, mobile, or web applications with the [Paid license](LICENSES/LicenseRef-Slint-Software-3.0.md).\n\nSee the [Slint licensing options on the website](https://slint.dev/pricing.html) and the [Licensing FAQ](FAQ.md#licensing).\n\n## Contributions\n\nWe welcome your contributions: in the form of code, bug reports or feedback.\nFor contribution guidelines see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Frequently Asked Questions\n\nPlease see our separate [FAQ](FAQ.md).\n\n## About us (SixtyFPS GmbH)\n\nWe are passionate about software - API design, cross-platform software\ndevelopment and user interface components. Our aim is to make developing user\ninterfaces fun for everyone: from Python, JavaScript, C++, or Rust developers all the\nway to UI/UX designers. We believe that software grows organically and keeping\nit open source is the best way to sustain that growth. Our team members are\nlocated remotely in Germany, Finland, and US.\n\n### Stay up to date\n\n- Follow [@slint_ui](https://twitter.com/slint_ui) on X/Twitter.\n- Follow [@slint@fosstodon.org](https://mastodon.social/@slint@fosstodon.org) on Mastodon.\n- Follow [@slint-ui](https://www.linkedin.com/company/slint-ui/) on LinkedIn.\n- Follow [@slint.dev](https://bsky.app/profile/slint.dev) on Bluesky\n- Subscribe to our [YouTube channel](https://www.youtube.com/@Slint-UI)\n\n### Contact us\n\nFeel free to join [Github discussions](https://github.com/slint-ui/slint/discussions)\nfor general chat or questions. Use [Github issues](https://github.com/slint-ui/slint/issues)\nto report public suggestions or bugs.\n\nWe chat in [our Mattermost instance](https://chat.slint.dev) where you are\nwelcome to listen in or ask your questions.\n\nYou can of course also contact us privately via email to [info@slint.dev](mailto://info@slint.dev).\n\n[#1]: https://www.youtube.com/watch?v=_BDbNHrjK7g\n[#2]: https://www.youtube.com/watch?v=NNNOJJsOAis\n[#3]: https://www.youtube.com/watch?v=dkBwNocItGs\n[#4]: https://slint.dev/resources/gallery_win_screenshot.png \"Gallery\"\n[#5]: https://slint.dev/resources/gallery_mac_screenshot.png \"Gallery\"\n[#6]: https://slint.dev/resources/gallery_linux_screenshot.png \"Gallery\"\n[#7]: https://slint.dev/resources/printerdemo_screenshot.png \"Printer Demo\"\n[#8]: https://slint.dev/demos/printerdemo/\n[#9]: https://slint.dev/resources/puzzle_screenshot.png \"Slide Puzzle\"\n[#10]: https://slint.dev/demos/slide_puzzle/\n[#11]: https://slint.dev/resources/energy-monitor-screenshot.png \"Energy Monitor Demo\"\n[#12]: https://slint.dev/demos/energy-monitor/\n[#13]: https://slint.dev/resources/gallery_screenshot.png \"Gallery Demo\"\n[#14]: https://slint.dev/demos/gallery/\n[#15]: https://slint.dev/latest/docs/cpp\n[#17]: https://github.com/slint-ui/slint-cpp-template\n[#18]: https://img.shields.io/crates/v/slint\n[#19]: https://crates.io/crates/slint\n[#20]: https://slint.dev/latest/docs/rust/slint/\n[#22]: https://youtu.be/WBcv4V-whHk\n[#23]: https://github.com/slint-ui/slint-rust-template\n[#24]: https://img.shields.io/npm/v/slint-ui\n[#25]: https://www.npmjs.com/package/slint-ui\n[#26]: https://slint.dev/latest/docs/node\n[#28]: https://github.com/slint-ui/slint-nodejs-template\n[#29]: ./demos/weather-demo/docs/img/desktop-preview.png \"Weather Demo\"\n[#30]: https://slint.dev/demos/weather-demo/\n[#31]: https://img.shields.io/pypi/v/slint\n[#32]: https://pypi.org/project/slint/\n[#33]: http://snapshots.slint.dev/master/docs/python/\n[#34]: https://github.com/slint-ui/slint-python-template\n" }, { "path": "REUSE.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nversion = 1\nSPDX-PackageName = \"slint\"\nSPDX-PackageSupplier = \"Slint Developers \"\nSPDX-PackageDownloadLocation = \"https://slint.dev/\"\n\n[[annotations]]\npath = [\n \"**/MadeWithSlint-**.pdf\",\n \"**/MadeWithSlint-**.png\",\n \"**/MadeWithSlint-**.svg\",\n \"**/slint-icon-**.pdf\",\n \"**/slint-icon-**.png\",\n \"**/slint-icon-**.svg\",\n \"**/slint-logo-**.pdf\",\n \"**/slint-logo-**.png\",\n \"**/slint-logo-**.svg\",\n \"docs/astro/src/content/docs/reference/elements/slint-logo.png\",\n \"logo/slint-logo.icns\",\n \"logo/README.md\",\n \"**/public/favicon.svg\",\n \"**/public/slint-logo-small-light.svg\",\n \"**/public/slint-logo.woff\",\n \"**/public/apple-touch-icon.png\",\n \"**/public/favicon.ico\",\n \"**/public/favicon-32x32.png\",\n \"**/public/favicon-16x16.png\",\n \"**/public/tablet-material.webp\",\n \"ui-libraries/material/examples/gallery/frame-tablet.webp\",\n]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © SixtyFPS GmbH \"\nSPDX-License-Identifier = \"CC-BY-ND-4.0\"\n\n[[annotations]]\npath = [\n \"**/.eslintrc.yml\",\n \"**/.gitignore\",\n \"**/.npmignore\",\n \"**/.vscodeignore\",\n \".dockerignore\",\n \".gitattributes\",\n \".gitignore\",\n \".mailmap\",\n \".vscode/**\",\n \"editors/vscode/tests/grammar/*.slint\",\n \"Cargo.lock\",\n \"flake.nix\",\n \"flake.lock\",\n \"examples/bevy/Cargo.lock\",\n \"examples/servo/Cargo.lock\",\n \"REUSE.toml\",\n \"biome.json\",\n \"knip.json\",\n \"cspell.json\",\n \"docs/search/scraper-config.json\",\n \"internal/core-macros/link-data.json\",\n \"internal/**.md\",\n \"package.json\",\n \"pnpm-lock.yaml\",\n \"rustfmt.toml\",\n \"*.md\",\n]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © SixtyFPS GmbH \"\nSPDX-License-Identifier = \"GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\"\n\n[[annotations]]\npath = [\n \".github/ISSUE_TEMPLATE/4-blank.md\",\n \".github/ISSUE_TEMPLATE/3-tracking-issue.md\",\n \".github/pull_request_template.md\",\n\n \"api/cpp/docs/**/**.css\",\n \"api/cpp/docs/**/**.md\",\n \"api/cpp/docs/**/**.html\",\n \"api/cpp/tests/redpixel.png\",\n\n \"demos/**.md\",\n \"demos/**.json\",\n \"demos/**/LC_MESSAGES/**.mo\",\n \"demos/**/README\",\n \"demos/**/esp-idf/partitions.csv\",\n \"demos/**/sdkconfig**\",\n \"demos/energy-monitor/ui/assets/arrow-left.svg\",\n \"demos/energy-monitor/ui/assets/arrow-right.svg\",\n \"demos/energy-monitor/ui/assets/check.svg\",\n \"demos/energy-monitor/ui/assets/cloud.svg\",\n \"demos/energy-monitor/ui/assets/cloudy.svg\",\n \"demos/energy-monitor/ui/assets/dashboard.svg\",\n \"demos/energy-monitor/ui/assets/information.svg\",\n \"demos/energy-monitor/ui/assets/settings.svg\",\n \"demos/energy-monitor/ui/assets/sunny.svg\",\n \"demos/home-automation/ui/images/**.jpg\",\n \"demos/home-automation/ui/images/**.png\",\n \"demos/home-automation/ui/images/**.svg\",\n \"demos/**/zephyr/VERSION\",\n \"demos/weather-demo/docs/**.png\",\n \"demos/weather-demo/index.html\",\n\n \"docs/**.json\",\n \"docs/**.mjs\",\n \"docs/**.md\",\n \"docs/**.mdx\",\n \"docs/**/**.css\",\n \"docs/**/**.html\",\n \"docs/**/book.toml\",\n \"docs/**/package.json\",\n \"docs/public/**.svg\",\n \"docs/astro/src/assets/**.svg\",\n \"docs/astro/src/assets/**.webp\",\n \"docs/astro/src/assets/getting-started/**.webp\",\n \"docs/astro/src/assets/guide/tooling/**.webp\",\n \"docs/astro/src/content/docs/reference/elements/mini-banner.png\",\n \"docs/astro/src/misc/**.json\",\n \"docs/astro/src/misc/**.jsonc\",\n\n \"examples/**.json\",\n \"examples/**.md\",\n \"examples/**/LC_MESSAGES/**.mo\",\n \"examples/**/README\",\n \"examples/**/README.txt\",\n \"examples/**/esp-idf/**/partitions.csv\",\n \"examples/**/esp-idf/partitions.csv\",\n \"examples/**/sdkconfig**\",\n \"examples/cpp/qt_viewer/interface.ui\",\n \"examples/dial/images/**.png\",\n \"examples/fancy-switches/images/**.png\",\n \"examples/fancy-switches/images/**.svg\",\n \"examples/orbit-animation/images/**.png\",\n \"examples/orbit-animation/images/**.svg\",\n \"examples/sprite-sheet/images/**.png\",\n \"examples/speedometer/needle.png\",\n\n \"demos/printerdemo/ui/images/action-button-frame.png\",\n \"demos/printerdemo/ui/images/mcu/combo-active-background.png\",\n \"demos/printerdemo/ui/images/mcu/copy-button.jpg\",\n \"demos/printerdemo/ui/images/mcu/place-document.jpg\",\n \"demos/printerdemo/ui/images/mcu/popup.jpg\",\n \"demos/printerdemo/ui/images/mcu/scan-button.jpg\",\n \"demos/printerdemo/ui/images/mcu/sub-action-button.jpg\",\n \"demos/printerdemo/ui/images/mcu/switch-active.png\",\n\n \"helper_crates/**.md\",\n\n \"ui-libraries/material/**.md\",\n \"ui-libraries/material/**.mdx\",\n \"ui-libraries/material/docs/**.json\",\n \"ui-libraries/material/docs/src/assets/styles/**.css\",\n \"ui-libraries/material/docs/src/assets/**.svg\",\n \"ui-libraries/material/docs/src/content/docs/components/icons/**.svg\",\n \"ui-libraries/material/docs/src/assets/**.webp\",\n \"ui-libraries/material/.gitignore\",\n \"ui-libraries/material/docs/src/assets/images/Components.png\",\n \"ui-libraries/material/docs/src/assets/images/phone-dark.webp\",\n \"ui-libraries/material/docs/src/assets/images/material-tablet.webp\",\n \"ui-libraries/material/docs/src/assets/images/material-award.jpg\",\n \"ui-libraries/material/docs/src/assets/images/material-design.jpg\",\n \"ui-libraries/material/docs/src/config.yaml\",\n \"ui-libraries/material/examples/gallery/ui/themes/**.json\",\n]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © SixtyFPS GmbH \"\nSPDX-License-Identifier = \"MIT\"\n\n[[annotations]]\npath = [\n \"api/**.md\",\n \"api/**.hbs\",\n \"api/**/**.json\",\n \"api/node/__test__/resources/**.png\",\n \"CMakePresets.json\",\n\n \"editors/**.md\",\n \"editors/sublime/LSP.sublime-settings\",\n \"editors/tree-sitter-slint/corpus/**.txt\",\n \"editors/tree-sitter-slint/tree-sitter.json\",\n \"editors/vscode/**.json\",\n \"editors/vscode/css/**.css\",\n \"editors/vscode/tests/grammar/**.slint\",\n\n \"tests/screenshots/**/**.png\",\n\n \"tools/**.md\",\n \"tools/slintpad/**.html\",\n \"tools/slintpad/**.json\",\n \"tools/slintpad/styles/**.css\",\n \"tools/figma-inspector/**.json\",\n \"tools/figma-inspector/**.html\",\n \"tools/figma-inspector/**.css\",\n]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © SixtyFPS GmbH \"\nSPDX-License-Identifier = \"GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\"\n\n[[annotations]]\npath = [\"demos/weather-demo/ui/assets/icons/**.svg\", \"examples/memory/icons/**.png\", \"examples/memory/icons/**.svg\"]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Fontawesome project \"\nSPDX-License-Identifier = \"CC-BY-4.0\"\n\n[[annotations]]\npath = \"demos/printerdemo/ui/images/**.svg\"\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"CoreyGinnivan \"\nSPDX-License-Identifier = \"Unlicense\"\n\n[[annotations]]\npath = [\"examples/iot-dashboard/images/**.svg\", \"examples/iot-dashboard/images/**.png\"]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Uwe Rathmann \"\nSPDX-License-Identifier = \"LicenseRef-qskinny\"\n\n[[annotations]]\npath = [\n \"tools/lsp/ui/assets/chevron-down.svg\",\n \"tools/lsp/ui/assets/filter.svg\",\n \"tools/lsp/ui/assets/inspect.svg\",\n \"tools/lsp/ui/assets/layout-sidebar**.svg\",\n \"tools/lsp/ui/assets/search.svg\",\n \"tools/lsp/ui/assets/sync.svg\",\n \"tools/lsp/ui/assets/black-square.png\",\n \"tools/lsp/ui/assets/close.svg\",\n \"tools/lsp/ui/assets/plus.svg\",\n \"tools/lsp/ui/assets/info.svg\",\n \"tools/lsp/ui/assets/clear.svg\",\n \"tools/lsp/ui/assets/beaker.svg\",\n \"tools/lsp/ui/assets/library.svg\",\n \"tools/lsp/ui/assets/list-tree.svg\",\n \"tools/lsp/ui/assets/settings.svg\",\n]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Codicon Icons \"\nSPDX-License-Identifier = \"CC-BY-4.0\"\n\n[[annotations]]\npath = \"examples/carousel/fonts/**.ttf\"\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Roboto \"\nSPDX-License-Identifier = \"Apache-2.0\"\n\n[[annotations]]\npath = \"internal/compiler/widgets/fluent/_**.svg\"\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © Microsoft Corporation \"\nSPDX-License-Identifier = \"MIT\"\n\n[[annotations]]\npath = [\n \"internal/compiler/widgets/material/_**.svg\",\n \"component-sets/material/src/ui/icons/**.svg\",\n \"component-sets/material/examples/gallery/ui/icons/**.svg\",\n \"examples/carousel/icons/**.svg\",\n \"internal/compiler/widgets/cupertino/_**.svg\",\n \"internal/compiler/widgets/qt/_**.svg\",\n \"examples/todo-mvc/assets/**.svg\",\n \"demos/usecases/ui/assets/**.svg\",\n]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Material Icons \"\nSPDX-License-Identifier = \"Apache-2.0\"\n\n[[annotations]]\npath = \"internal/compiler/widgets/cosmic/_**.svg\"\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"\\\"Cosmic Icons\\\" by System76 \"\nSPDX-License-Identifier = \"CC-BY-SA-4.0\"\n\n[[annotations]]\npath = [\n \"internal/backends/linuxkms/mouse-pointer.svg\",\n \"examples/virtual_keyboard/ui/assets/**.svg\",\n \"examples/ffmpeg/pause.svg\",\n \"examples/ffmpeg/play.svg\",\n \"examples/gstreamer-player/**.svg\",\n \"examples/uefi-demo/resource/cursor.png\",\n]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © 2018 Dave Gandy & Fork Awesome\"\nSPDX-License-Identifier = \"MIT\"\n\n[[annotations]]\npath = \"demos/energy-monitor/ui/assets/spyrosoft-logo.svg\"\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © Spyrosoft Solutions GmbH \"\nSPDX-License-Identifier = \"CC-BY-4.0\"\n\n[[annotations]]\npath = \"demos/weather-demo/ui/assets/weathericons-font.ttf\"\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Weather Icons \"\nSPDX-License-Identifier = \"OFL-1.1\"\n\n[[annotations]]\npath = [\"demos/weather-demo/android-res/**/ic_launcher.png\", \"demos/weather-demo/ui/assets/felgo-logo.svg\"]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © Felgo GmbH \"\nSPDX-License-Identifier = \"CC-BY-ND-4.0\"\n\n[[annotations]]\npath = [\"ui-libraries/material/docs/src/assets/images/icons/**.svg\"]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright (c) 2020-2024 Paweł Kuna \"\nSPDX-License-Identifier = \"MIT\"\n\n[[annotations]]\npath = [\"ui-libraries/material/src/ui/icons/**.svg\", \"ui-libraries/material/examples/gallery/ui/icons/**.svg\"]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Material Icons \"\nSPDX-License-Identifier = \"Apache-2.0\"\n\n[[annotations]]\npath = [\"docs/astro/src/assets/android/**.png\"]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright © SixtyFPS GmbH \"\nSPDX-License-Identifier = \"CC-BY-4.0\"\n\n[[annotations]]\npath = [\"examples/bevy/bevy-hosts-slint/**.gltf\"]\nprecedence = \"aggregate\"\nSPDX-FileCopyrightText = \"Copyright (c) 2024 e-verse\"\nSPDX-License-Identifier = \"MIT\"\n" }, { "path": "SECURITY.md", "content": "\n# Security Policy\n\n## Supported Versions\n\nWe commit to publishing security updates for the last release of Slint:\n\n| Name | Description | URL |\n| ---- | ----------- | --- |\n| `slint` Rust crate | Rust crate for Slint API | https://crates.io/crates/slint |\n| `slint-interpreter` Rust crate | Rust crate for Slint interpreter API | https://crates.io/crates/slint-interpreter |\n| Slint for C++ | CMake package for Slint | https://github.com/slint-ui/slint/releases/latest |\n| `slint-ui` NPM package | Node.js API for Slint | https://www.npmjs.com/package/slint-ui |\n| `slint` Python Package | Python API for Slint | https://pypi.org/project/slint/ |\n| Slint Visual Studio Code Extension | IDE Integration into VS Code | https://marketplace.visualstudio.com/items?itemName=Slint.slint |\n| `slint-viewer` | Convenience tool to view `.slint` files from the command line | https://crates.io/crates/slint-viewer \\| https://github.com/slint-ui/slint/releases/latest |\n| `slint-lsp` | Language Server Protocol implementation for `.slint` files | https://crates.io/crates/slint-lsp \\| https://github.com/slint-ui/slint/releases/latest |\n\nPaid license holders may be eligible for support on additional versions, depending on their specific terms of\nagreement.\n\n## Reporting a Vulnerability\n\nPlease report any vulnerabilities via the GitHub Private Vulnerability Disclosure functionality.\n\nCheck out the [GitHub Instructions](https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing-information-about-vulnerabilities/privately-reporting-a-security-vulnerability#privately-reporting-a-security-vulnerability) on how to submit a report.\n\n" }, { "path": "about.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\naccepted = [\n \"MIT\",\n \"Apache-2.0\",\n \"Apache-2.0 WITH LLVM-exception\",\n \"MPL-2.0\",\n \"Zlib\",\n \"BSD-2-Clause\",\n \"BSD-3-Clause\",\n \"CC0-1.0\",\n \"BSL-1.0\",\n \"ISC\",\n \"Unicode-DFS-2016\",\n \"Unicode-3.0\",\n \"OpenSSL\",\n \"WTFPL\",\n \"LicenseRef-Slint-Software-3.0\",\n]\ntargets = [\"x86_64-unknown-linux-gnu\", \"x86_64-pc-windows-msvc\", \"x86_64-apple-darwin\"]\nignore-dev-dependencies = true\nfilter-noassertion = true\n\n# See https://embarkstudios.github.io/cargo-about/cli/generate/workarounds.html\nworkarounds = [\"ring\"]\n\n[femtovg.clarify]\n# See https://github.com/femtovg/femtovg/commit/53bf79e720767354486affced9e2c7ad204f0f85\nlicense = \"MIT OR Apache-2.0\"\n[[femtovg.clarify.files]]\npath = \"LICENSE-MIT\"\nlicense = \"MIT\"\nchecksum = \"cd4eb10b20da1d85916624e0e15a8e76b0a66406996a4f9aa5afee909fecfb7e\"\n" }, { "path": "api/cpp/CMakeLists.txt", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\ncmake_minimum_required(VERSION 3.21)\n# Select C++ and C as languages, as Corrosion needs ${CMAKE_C_COMPILER}\n# for linking\nproject(Slint HOMEPAGE_URL \"https://slint.dev/\" LANGUAGES C CXX VERSION 1.16.0)\n\ninclude(FeatureSummary)\ninclude(CMakeDependentOption)\n\nfind_package(Corrosion QUIET 0.6)\nif (NOT Corrosion_FOUND)\n include(FetchContent)\n FetchContent_Declare(\n Corrosion\n GIT_REPOSITORY https://github.com/corrosion-rs/corrosion.git\n GIT_TAG v0.6.1\n )\n\n FetchContent_MakeAvailable(Corrosion)\nendif ()\n\nlist(PREPEND CMAKE_MODULE_PATH ${Corrosion_SOURCE_DIR}/cmake)\nfind_package(Rust 1.88 REQUIRED MODULE)\n\noption(BUILD_SHARED_LIBS \"Build Slint as shared library\" ON)\noption(SLINT_FEATURE_COMPILER \"Enable support for compiling .slint files to C++ ahead of time\" ON)\nadd_feature_info(SLINT_FEATURE_COMPILER SLINT_FEATURE_COMPILER \"Enable support for compiling .slint files to C++ ahead of time\")\noption(SLINT_BUILD_RUNTIME \"Actually build the Slint runtime libraries (Disable that to only build the compiler)\" ON)\nadd_feature_info(SLINT_BUILD_RUNTIME SLINT_BUILD_RUNTIME \"Actually build the Slint runtime libraries (Disable that to only build the compiler)\")\noption(SLINT_FEATURE_SDF_FONTS \"Enable support for pre-rendering fonts as Signed Distance Fields (for the software renderer)\" OFF)\nadd_feature_info(SLINT_FEATURE_SDF_FONTS SLINT_FEATURE_SDF_FONTS \"Enable support for pre-rendering fonts as Signed Distance Fields (for the software renderer)\")\n\nset(SLINT_COMPILER \"\" CACHE STRING \"Path to the slint-compiler executable. When unset, it the compiler will be build as part of the build process. When set to 'download', the compiler will be downloaded from GitHub.\")\nset(SLINT_LIBRARY_CARGO_FLAGS \"\" CACHE STRING\n \"Flags to pass to cargo when building the Slint runtime library\")\n\nfunction(define_cargo_feature cargo_feature description default)\n # turn foo-bar into SLINT_FEATURE_FOO_BAR\n string(TOUPPER \"${cargo_feature}\" cmake_option)\n string(REPLACE \"-\" \"_\" cmake_option \"${cmake_option}\")\n list(APPEND public_cmake_features ${cmake_option})\n set(cmake_option \"SLINT_FEATURE_${cmake_option}\")\n option(\"${cmake_option}\" \"${description}\" ${default})\n\n if(${cmake_option})\n list(APPEND features ${cargo_feature})\n endif()\n\n set(features \"${features}\" PARENT_SCOPE)\n set(public_cmake_features \"${public_cmake_features}\" PARENT_SCOPE)\n add_feature_info(${cmake_option} ${cmake_option} ${description})\nendfunction()\n\nfunction(define_cargo_dependent_feature cargo_feature description default depends_condition)\n # turn foo-bar into SLINT_FEATURE_FOO_BAR\n string(TOUPPER \"${cargo_feature}\" cmake_option)\n string(REPLACE \"-\" \"_\" cmake_option \"${cmake_option}\")\n list(APPEND public_cmake_features ${cmake_option})\n set(cmake_option \"SLINT_FEATURE_${cmake_option}\")\n cmake_dependent_option(\"${cmake_option}\" \"${description}\" ${default} ${depends_condition} OFF)\n\n if(${cmake_option})\n list(APPEND features ${cargo_feature})\n endif()\n\n set(features \"${features}\" PARENT_SCOPE)\n set(public_cmake_features \"${public_cmake_features}\" PARENT_SCOPE)\n add_feature_info(${cmake_option} ${cmake_option} ${description})\nendfunction()\n\n# Features that are mapped to features in the Rust crate. These and their\n# defaults need to be kept in sync with the Rust bit (cpp/Cargo.toml and cbindgen.rs)\n\ndefine_cargo_feature(freestanding \"Enable use of freestanding environment. This is only for bare-metal systems. Most other features are incompatible with this one\" OFF)\ndefine_cargo_feature(libm \"This feature enables floating point arithmetic emulation using the libm crate. Use this in MCU environments where the processor does not support floating point arithmetic.\" OFF)\n\n# Compat options (must be declared after the STD feature, but before the other renderer features)\nfunction(define_renderer_winit_compat_option renderer)\n string(TOUPPER \"${renderer}\" cmake_option)\n string(REPLACE \"-\" \"_\" cmake_option \"${cmake_option}\")\n cmake_dependent_option(\"SLINT_FEATURE_RENDERER_WINIT_${cmake_option}\" \"Compat option equivalent to SLINT_FEATURE_RENDERER_${cmake_option}\" OFF \"NOT SLINT_FEATURE_FREESTANDING\" OFF)\n if(SLINT_FEATURE_RENDERER_WINIT_${cmake_option})\n set(\"SLINT_FEATURE_RENDERER_${cmake_option}\" ON PARENT_SCOPE)\n message(\"SLINT_FEATURE_RENDERER_WINIT_${cmake_option} is deprecated, use SLINT_FEATURE_RENDERER_${cmake_option} instead\")\n endif()\nendfunction()\ndefine_renderer_winit_compat_option(femtovg)\ndefine_renderer_winit_compat_option(skia)\ndefine_renderer_winit_compat_option(skia-opengl)\ndefine_renderer_winit_compat_option(skia-vulkan)\ndefine_renderer_winit_compat_option(software)\n\ndefine_cargo_dependent_feature(interpreter \"Enable support for the Slint interpreter to load .slint files at run-time\" ON \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(live-preview \"Enable support for the Slint live-preview to re-load changed .slint files at run-time\" OFF \"SLINT_FEATURE_INTERPRETER\")\n\ndefine_cargo_dependent_feature(backend-winit \"Enable support for the winit crate to interaction with all windowing systems.\" ON \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(backend-winit-x11 \"Enable support for the winit create to interact only with the X11 windowing system on Unix. Enable this option and turn off SLINT_FEATURE_BACKEND_WINIT for a smaller build with just X11 support on Unix.\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(backend-winit-wayland \"Enable support for the winit create to interact only with the wayland windowing system on Unix. Enable this option and turn off SLINT_FEATURE_BACKEND_WINIT for a smaller build with just wayland support.\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\n\ndefine_cargo_dependent_feature(renderer-femtovg \"Enable support for the OpenGL ES 2.0 based FemtoVG rendering engine.\" ON \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(renderer-femtovg-wgpu \"Enable support for the WGPU based FemtoVG rendering engine.\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(renderer-skia \"Enable support for the Skia based rendering engine.\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(renderer-skia-opengl \"Enable support for the Skia based rendering engine with its OpenGL backend.\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(renderer-skia-vulkan \"Enable support for the Skia based rendering engine with its Vulkan backend.\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_feature(renderer-software \"Enable support for the software renderer\" ON)\ndefine_cargo_feature(software-renderer-path \"Enable support for Path element rendering with the software renderer. This is implicitly enabled when SLINT_FEATURE_FREESTANDING is OFF. Enable this in bare-metal environments if you need support for Path elements\" OFF)\n\nset(SLINT_BACKEND_QT_DEFAULT OFF)\nif(${CMAKE_SYSTEM_NAME} MATCHES \"Linux\")\n set(SLINT_BACKEND_QT_DEFAULT ON)\nendif()\ndefine_cargo_dependent_feature(backend-qt \"Enable Qt based rendering backend\" ${SLINT_BACKEND_QT_DEFAULT} \"NOT SLINT_FEATURE_FREESTANDING\")\n\ndefine_cargo_dependent_feature(backend-linuxkms \"Enable support for the backend that renders a single window fullscreen on Linux. Requires libseat. If you don't have libseat, select `backend-linuxkms-noseat` instead.\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(backend-linuxkms-noseat \"Enable support for the backend that renders a single window fullscreen on Linux\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\n\ndefine_cargo_dependent_feature(gettext \"Enable support of translations using gettext\" OFF \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(accessibility \"Enable integration with operating system provided accessibility APIs\" ON \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_dependent_feature(testing \"Enable support for testing API (experimental)\" ON \"NOT SLINT_FEATURE_FREESTANDING\")\ndefine_cargo_feature(experimental \"Enable experimental features. (No backward compatibility guarantees)\" OFF)\ndefine_cargo_dependent_feature(system-testing \"Enable system testing support (experimental)\" OFF \"SLINT_FEATURE_EXPERIMENTAL AND NOT SLINT_FEATURE_FREESTANDING\")\n\nif (SLINT_BUILD_RUNTIME)\n if(SLINT_FEATURE_COMPILER AND NOT SLINT_COMPILER)\n set(slint_compiler_crate \"slint-compiler\")\n endif()\n\n if(BUILD_SHARED_LIBS)\n set(rustc_lib_type \"cdylib\")\n set(slint_cpp_impl \"slint_cpp-shared\")\n set(cmake_lib_type \"SHARED\")\n else()\n set(rustc_lib_type \"staticlib\")\n set(slint_cpp_impl \"slint_cpp-static\")\n set(cmake_lib_type \"STATIC\")\n endif()\n\n corrosion_import_crate(MANIFEST_PATH \"${CMAKE_CURRENT_SOURCE_DIR}/../../Cargo.toml\"\n CRATES slint-cpp ${slint_compiler_crate} CRATE_TYPES bin ${rustc_lib_type})\nelseif(SLINT_FEATURE_COMPILER AND NOT SLINT_COMPILER)\n corrosion_import_crate(MANIFEST_PATH \"${CMAKE_CURRENT_SOURCE_DIR}/../../Cargo.toml\"\n CRATES slint-compiler CRATE_TYPES bin)\nendif()\n\nif(SLINT_FEATURE_COMPILER AND NOT SLINT_COMPILER)\n corrosion_set_hostbuild(slint-compiler)\n set_property(\n TARGET slint-compiler\n PROPERTY CORROSION_NO_DEFAULT_FEATURES\n ON\n )\n list(APPEND slint_compiler_features \"software-renderer\")\n\n # Switch to dlopening fontconfig in the slint-compiler to avoid the issue that\n # for example in Yocto environments, PKG_CONFIG_PATH will be set to the target only\n # and pkg-config in PATH doesn't permit lookups in the hots.\n if(CMAKE_CROSSCOMPILING)\n list(APPEND slint_compiler_features \"fontconfig-dlopen\")\n endif()\n\n if (SLINT_FEATURE_SDF_FONTS)\n list(APPEND slint_compiler_features \"sdf-fonts\")\n endif()\n # Enable jemalloc, except when cross-compiling. (#7463)\n if(NOT CMAKE_CROSSCOMPILING)\n list(APPEND slint_compiler_features \"jemalloc\")\n endif()\n set_property(\n TARGET slint-compiler\n PROPERTY CORROSION_FEATURES\n ${slint_compiler_features}\n )\nendif()\n\nif (SLINT_BUILD_RUNTIME)\n\n # When doing \"make install\" package builds, set install_name to rpath, so that the installed\n # binaries don't have a load-command pointing back to their build directory.\n # Don't do this when Slint is used via FetchContent. While we could set CMAKE_BUILD_RPATH to\n # include the binary dir and thus our examples would have the correct rpath set, binaries\n # outside (i.e. applications using Slint via FetchContent) would not and the BUILD_RPATH\n # target property doesn't propagate :(\n if (APPLE AND SLINT_IS_TOPLEVEL_BUILD AND BUILD_SHARED_LIBS)\n # corrosion could provide the Cargo.toml package version as a CMake target property.\n corrosion_add_target_local_rustflags(slint_cpp -Clink-arg=-Wl,-install_name,@rpath/libslint_cpp.dylib,-current_version,${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR},-compatibility_version,${PROJECT_VERSION_MAJOR}.0)\n # Set this one to false again explicitly because Corrosion will starting setting this property to true by default.\n set_target_properties(slint_cpp-shared PROPERTIES IMPORTED_NO_SONAME 0)\n set_target_properties(slint_cpp-shared PROPERTIES IMPORTED_SONAME libslint_cpp.dylib)\n endif()\n\n add_library(Slint INTERFACE)\n add_library(Slint::Slint ALIAS Slint)\n target_link_libraries(Slint INTERFACE slint_cpp)\n target_compile_features(Slint INTERFACE cxx_std_20)\n if (WIN32)\n target_compile_options(Slint INTERFACE\n $<$:/bigobj>\n $<$:-Wa,-mbig-obj>\n $<$:-Wa,-mbig-obj>\n )\n endif()\n\n foreach(feature ${public_cmake_features})\n set(cmake_option \"SLINT_FEATURE_${feature}\")\n if(${cmake_option})\n list(APPEND enabled_features ${feature})\n else()\n list(APPEND disabled_features ${feature})\n endif()\n endforeach()\n set_property(TARGET Slint APPEND PROPERTY SLINT_ENABLED_FEATURES \"${enabled_features}\")\n set_property(TARGET Slint APPEND PROPERTY SLINT_DISABLED_FEATURES \"${disabled_features}\")\n set_property(TARGET Slint APPEND PROPERTY EXPORT_PROPERTIES \"SLINT_ENABLED_FEATURES\")\n set_property(TARGET Slint APPEND PROPERTY EXPORT_PROPERTIES \"SLINT_DISABLED_FEATURES\")\n\n if (SLINT_FEATURE_FREESTANDING)\n if (ESP_PLATFORM AND NOT IDF_TARGET STREQUAL \"esp32p4\")\n list(APPEND features \"esp-backtrace/${IDF_TARGET}\")\n list(APPEND features \"esp-println/${IDF_TARGET}\")\n endif()\n else (SLINT_FEATURE_FREESTANDING)\n list(APPEND features std)\n endif()\n\n\n set_property(\n TARGET slint_cpp\n APPEND\n PROPERTY CORROSION_ENVIRONMENT_VARIABLES\n \"SLINT_GENERATED_INCLUDE_DIR=${CMAKE_CURRENT_BINARY_DIR}/generated_include/\"\n )\n\n set_property(\n TARGET slint_cpp\n PROPERTY CORROSION_FEATURES\n ${features}\n )\n set_property(\n TARGET slint_cpp\n PROPERTY CORROSION_NO_DEFAULT_FEATURES\n ON\n )\n\n if(SLINT_LIBRARY_CARGO_FLAGS)\n corrosion_set_cargo_flags(slint_cpp ${SLINT_LIBRARY_CARGO_FLAGS})\n endif()\n\n if(SLINT_FEATURE_BACKEND_QT)\n # For the CMake build don't rely on qmake being in PATH but use CMake to locate Qt. This\n # means usually CMAKE_PREFIX_PATH is set.\n find_package(Qt6 6.2 QUIET COMPONENTS Core Widgets)\n\n if(NOT TARGET Qt::qmake)\n find_package(Qt5 5.15 QUIET COMPONENTS Core Widgets)\n endif()\n endif(SLINT_FEATURE_BACKEND_QT)\n\n if(SLINT_FEATURE_BACKEND_QT AND TARGET Qt::qmake)\n set_property(\n TARGET slint_cpp\n APPEND\n PROPERTY CORROSION_ENVIRONMENT_VARIABLES\n QMAKE=$\n )\n else()\n set_property(\n TARGET slint_cpp\n APPEND\n PROPERTY CORROSION_ENVIRONMENT_VARIABLES\n SLINT_NO_QT=1\n )\n endif()\n\n if(SLINT_FEATURE_FREESTANDING)\n set(SLINT_STYLE_DEFAULT \"fluent\")\n elseif(ANDROID)\n set(SLINT_STYLE_DEFAULT \"material\")\n elseif(WIN32)\n set(SLINT_STYLE_DEFAULT \"fluent\")\n elseif(APPLE)\n set(SLINT_STYLE_DEFAULT \"cupertino\")\n elseif (SLINT_FEATURE_BACKEND_QT AND TARGET Qt::qmake)\n set(SLINT_STYLE_DEFAULT \"qt\")\n else ()\n set(SLINT_STYLE_DEFAULT \"fluent\")\n endif()\n\n set(SLINT_STYLE \"\" CACHE STRING \"The Slint Widget Style\")\n\n if(SLINT_STYLE AND NOT SLINT_STYLE STREQUAL \"native\")\n set_property(GLOBAL PROPERTY SLINT_STYLE ${SLINT_STYLE})\n else()\n set_property(GLOBAL PROPERTY SLINT_STYLE ${SLINT_STYLE_DEFAULT})\n endif()\n\n # Build environments such as buildroot set PKG_CONFIG_SYSROOT_DIR in their toolchain file\n # and thus it's only available at cmake configure time. Our build dependencies that use pkg-config\n # however invoke pkg-config in build.rs, which means we need to defer/propagate the environment variable\n # to build time.\n if(DEFINED ENV{PKG_CONFIG_SYSROOT_DIR})\n set_property(\n TARGET slint_cpp\n APPEND\n PROPERTY CORROSION_ENVIRONMENT_VARIABLES\n \"PKG_CONFIG_SYSROOT_DIR=$ENV{PKG_CONFIG_SYSROOT_DIR}\"\n )\n endif()\n\n if(SLINT_FEATURE_RENDERER_SKIA OR SLINT_FEATURE_RENDERER_SKIA_OPENGL OR SLINT_FEATURE_RENDERER_SKIA_VULKAN)\n find_program(CLANGCC clang)\n find_program(CLANGCXX clang++)\n if(CLANGCC AND NOT DEFINED ENV{CLANGCC})\n set_property(\n TARGET slint_cpp\n APPEND\n PROPERTY CORROSION_ENVIRONMENT_VARIABLES\n CLANGCC=${CLANGCC}\n )\n endif()\n if(CLANGCXX AND NOT DEFINED ENV{CLANGCXX})\n set_property(\n TARGET slint_cpp\n APPEND\n PROPERTY CORROSION_ENVIRONMENT_VARIABLES\n CLANGCXX=${CLANGCXX}\n )\n endif()\n\n # The Skia cross-build requires a host C compiler (due to some build dependencies of rust-skia),\n # so cc.rs will first look for CC_ and then HOST_CC.\n # When cross-compiling, CMake doesn't really know what the host compiler is. Corrosion will set\n # HOST_CC to $CC, which is a good bet. Unfortunately in Yocto environments, CC will be set to\n # the cross-compiler. The same applies to CFLAGS, which may contain target specific options.\n # So the hack to solve this is two-fold:\n # * We look for clang or gcc in PATH - unprefixed those are usually host compilers.\n # * Through corrosion we know the correct host value of CC_.\n # Finally, we set CC_ to clang or gcc and empty CFLAGS_\n if(CMAKE_CROSSCOMPILING AND Rust_CARGO_HOST_TARGET)\n if(CLANGCC)\n set(host_cc \"${CLANGCC}\")\n else()\n find_program(GCC gcc)\n if (GCC)\n set(host_cc \"${GCC}\")\n endif()\n endif()\n if(host_cc)\n string(REPLACE \"-\" \"_\" cargo_host_target_underscore \"${Rust_CARGO_HOST_TARGET}\")\n set_property(\n TARGET slint_cpp\n APPEND\n PROPERTY CORROSION_ENVIRONMENT_VARIABLES\n CC_${cargo_host_target_underscore}=${host_cc}\n )\n set_property(\n TARGET slint_cpp\n APPEND\n PROPERTY CORROSION_ENVIRONMENT_VARIABLES\n CFLAGS_${cargo_host_target_underscore}=\n )\n endif()\n endif()\n endif()\n\n file(GLOB api_headers RELATIVE \"${CMAKE_CURRENT_SOURCE_DIR}/include/\"\n \"${CMAKE_CURRENT_SOURCE_DIR}/include/*.h\")\n\n foreach(header IN LISTS api_headers)\n set_property(TARGET Slint APPEND PROPERTY PUBLIC_HEADER include/${header})\n endforeach()\n\n set(generated_headers\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_brush_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_builtin_structs.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_builtin_structs_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_color_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_enums.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_enums_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_generated_public.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_image_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_pathdata_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_platform_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_properties_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_qt_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_sharedvector_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_string_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_timer_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_events_internal.h\n )\n\n if(SLINT_FEATURE_INTERPRETER)\n list(APPEND generated_headers\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_interpreter_internal.h\n ${CMAKE_CURRENT_BINARY_DIR}/generated_include/slint_interpreter_generated_public.h\n )\n endif()\n\n\n foreach(header IN LISTS generated_headers)\n set_property(TARGET Slint APPEND PROPERTY PUBLIC_HEADER ${header})\n endforeach()\n\n target_include_directories(Slint INTERFACE\n $\n $\n $\n )\n\n\n if(SLINT_FEATURE_COMPILER AND NOT SLINT_COMPILER)\n add_executable(Slint::slint-compiler ALIAS slint-compiler)\n include(${CMAKE_CURRENT_LIST_DIR}/cmake/SlintMacro.cmake)\n endif()\n\n export(TARGETS Slint slint_cpp\n NAMESPACE Slint:: FILE \"${CMAKE_BINARY_DIR}/lib/cmake/Slint/SlintTargets.cmake\")\n install(EXPORT SlintTargets NAMESPACE Slint:: DESTINATION lib/cmake/Slint)\n install(TARGETS Slint slint_cpp\n EXPORT SlintTargets LIBRARY DESTINATION lib PUBLIC_HEADER DESTINATION include/slint)\n\n install(FILES $ TYPE LIB)\n\n if(WIN32)\n install(FILES $ TYPE LIB)\n endif()\n\nendif(SLINT_BUILD_RUNTIME)\n\ninclude(CMakePackageConfigHelpers)\ninclude(GNUInstallDirs)\n\n\nif(SLINT_FEATURE_COMPILER AND NOT SLINT_COMPILER)\n install(PROGRAMS $ TYPE BIN)\nendif()\n\nif(SLINT_BUILD_RUNTIME)\n\n # Corrosion sets the `IMPORTED` locations late to allow us to set OUTPUT_DIRECTORY\n # target properties. This function must be deferred until after Corrosion set the\n # locations. Since we are writing to a config file Generator expressions are not\n # an option.\n function(_slint_write_configure_file)\n foreach(prop\n IMPORTED_LOCATION IMPORTED_LOCATION_DEBUG IMPORTED_LOCATION_RELEASE\n IMPORTED_LOCATION_RELWITHDEBINFO IMPORTED_LOCATION_MINSIZEREL\n IMPORTED_IMPLIB IMPORTED_IMPLIB_DEBUG IMPORTED_IMPLIB_RELEASE\n IMPORTED_IMPLIB_RELWITHDEBINFO IMPORTED_IMPLIB_MINSIZEREL)\n get_target_property(value ${slint_cpp_impl} ${prop})\n\n if(value)\n get_filename_component(value ${value} NAME)\n list(APPEND SLINT_LIB_PROPERTIES ${prop} \"\\${_IMPORT_PREFIX}/${CMAKE_INSTALL_LIBDIR}/${value}\")\n endif()\n endforeach()\n\n # Corrosion sets IMPORTED_NO_SONAME and for macOS we reset that\n # and set IMPORTED_SONAME. Make sure to propagate these locally\n # set properties also to the installed cmake target.\n foreach(prop IMPORTED_NO_SONAME IMPORTED_SONAME)\n get_target_property(value ${slint_cpp_impl} ${prop})\n if(value)\n list(APPEND SLINT_LIB_PROPERTIES ${prop} ${value})\n endif()\n endforeach()\n\n get_property(_SLINT_STYLE GLOBAL PROPERTY SLINT_STYLE)\n if (TARGET slint-compiler)\n get_target_property(_slint_compiler_location slint-compiler IMPORTED_LOCATION)\n cmake_path(GET _slint_compiler_location FILENAME SLINT_COMPILER_FILE_NAME)\n endif()\n\n configure_package_config_file(\"cmake/SlintConfig.cmake.in\" \"${CMAKE_CURRENT_BINARY_DIR}/lib/cmake/Slint/SlintConfig.cmake\" INSTALL_DESTINATION lib/cmake/Slint)\n endfunction()\n\n cmake_language(DEFER CALL _slint_write_configure_file)\n\n write_basic_package_version_file(\n ${CMAKE_CURRENT_BINARY_DIR}/lib/cmake/Slint/SlintConfigVersion.cmake\n VERSION ${PROJECT_VERSION}\n COMPATIBILITY SameMajorVersion\n )\n\n install(FILES\n \"${CMAKE_CURRENT_BINARY_DIR}/lib/cmake/Slint/SlintConfig.cmake\"\n \"${CMAKE_CURRENT_BINARY_DIR}/lib/cmake/Slint/SlintConfigVersion.cmake\"\n \"${CMAKE_CURRENT_LIST_DIR}/cmake/SlintMacro.cmake\"\n DESTINATION lib/cmake/Slint\n )\n\nendif(SLINT_BUILD_RUNTIME)\n\nset(CPACK_PACKAGE_NAME \"Slint-cpp\")\nset(CPACK_PACKAGE_VENDOR \"Slint\")\nset(CPACK_VERBATIM_VARIABLES true)\nset(CPACK_PACKAGE_VERSION_MAJOR ${PROJECT_VERSION_MAJOR})\nset(CPACK_PACKAGE_VERSION_MINOR ${PROJECT_VERSION_MINOR})\nset(CPACK_PACKAGE_VERSION_PATCH ${PROJECT_VERSION_PATCH})\nset(CPACK_PACKAGE_HOMEPAGE_URL \"https://slint.dev\")\nset(CPACK_RESOURCE_FILE_LICENSE \"${CMAKE_CURRENT_LIST_DIR}/../../LICENSE.md\")\nset(CPACK_RESOURCE_FILE_README \"${CMAKE_CURRENT_LIST_DIR}/README.md\")\nset(CPACK_STRIP_FILES ON)\nset(CPACK_NSIS_DEFINES \"ManifestDPIAware true\")\n\n# Include a third-party license attribution folder, if generated by the CI.\nif(EXISTS \"${CMAKE_BINARY_DIR}/licenses\")\n list(APPEND CPACK_INSTALLED_DIRECTORIES \"${CMAKE_BINARY_DIR}/licenses\" licenses)\nendif()\n\nif(WIN32)\n if(MSVC)\n set(compiler_suffix \"-MSVC\")\n elseif(MINGW)\n set(compiler_suffix \"-MinGW\")\n endif()\n if(CMAKE_SIZEOF_VOID_P EQUAL 8)\n set(CPACK_SYSTEM_NAME win64)\n else()\n set(CPACK_SYSTEM_NAME win32)\n endif()\n set(CPACK_SYSTEM_NAME \"${CPACK_SYSTEM_NAME}${compiler_suffix}-${CMAKE_SYSTEM_PROCESSOR}\")\nelse()\n set(CPACK_GENERATOR \"TGZ\")\n set(CPACK_SYSTEM_NAME \"${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}\")\nendif()\n\nif (NOT Rust_CARGO_TARGET STREQUAL Rust_CARGO_HOST_TARGET)\n # If the package contains host dependent content (the slint-compiler), append the target suffix.\n # For cross-builds that target bare-metal, strip the host suffix\n if (TARGET Slint::slint-compiler)\n string(APPEND CPACK_SYSTEM_NAME \"-${Rust_CARGO_TARGET}\")\n elseif(SLINT_FEATURE_FREESTANDING)\n set(CPACK_SYSTEM_NAME \"${Rust_CARGO_TARGET}\")\n endif()\nendif()\n\ninclude(CPack)\n\nif(SLINT_BUILD_TESTING)\n add_subdirectory(tests)\nendif()\n" }, { "path": "api/cpp/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[package]\nname = \"slint-cpp\"\ndescription = \"Slint C++ integration\"\nauthors.workspace = true\ndocumentation.workspace = true\nedition = \"2024\"\nhomepage.workspace = true\nlicense.workspace = true\nrepository.workspace = true\nrust-version.workspace = true\nversion.workspace = true\nbuild = \"build.rs\"\npublish = false\n# prefix used to convey path to generated includes to the C++ test driver\nlinks = \"slint_cpp\"\n\n[lib]\npath = \"lib.rs\"\ncrate-type = [\"lib\", \"cdylib\", \"staticlib\"]\nname = \"slint_cpp\"\n\n# Note, these features need to be kept in sync (along with their defaults) in\n# the C++ crate's CMakeLists.txt as well as cbindgen.rs\n[features]\ninterpreter = [\"slint-interpreter\", \"std\"]\nlive-preview = [\"interpreter\", \"slint-interpreter/internal-live-preview\"]\n# Enable some function used by the integration tests\ntesting = [\"dep:i-slint-backend-testing\"]\n\nbackend-qt = [\"i-slint-backend-selector/backend-qt\", \"std\"]\nbackend-winit = [\"i-slint-backend-selector/backend-winit\", \"std\"]\nbackend-winit-x11 = [\"i-slint-backend-selector/backend-winit-x11\", \"std\"]\nbackend-winit-wayland = [\"i-slint-backend-selector/backend-winit-wayland\", \"std\"]\nbackend-linuxkms = [\"i-slint-backend-selector/backend-linuxkms\", \"std\"]\nbackend-linuxkms-noseat = [\"i-slint-backend-selector/backend-linuxkms-noseat\", \"std\"]\nrenderer-femtovg = [\"i-slint-backend-selector/renderer-femtovg\"]\nrenderer-femtovg-wgpu = [\"i-slint-backend-selector/renderer-femtovg-wgpu\"]\nrenderer-skia = [\"i-slint-backend-selector/renderer-skia\", \"i-slint-renderer-skia\", \"raw-window-handle\"]\nrenderer-skia-opengl = [\"i-slint-backend-selector/renderer-skia-opengl\", \"renderer-skia\"]\nrenderer-skia-vulkan = [\"i-slint-backend-selector/renderer-skia-vulkan\", \"renderer-skia\"]\nrenderer-software = [\"i-slint-backend-selector/renderer-software\", \"dep:i-slint-renderer-software\"]\nsoftware-renderer-path = [\"i-slint-renderer-software/path\"]\ngettext = [\"i-slint-core/gettext-rs\"]\naccessibility = [\"i-slint-backend-selector/accessibility\"]\nsystem-testing = [\"i-slint-backend-selector/system-testing\"]\nlibm = [\"i-slint-core/libm\", \"i-slint-renderer-software?/libm\"]\n\nstd = [\n \"i-slint-core/default\",\n \"i-slint-core/image-default-formats\",\n \"i-slint-backend-selector\",\n \"i-slint-renderer-software?/std\",\n \"i-slint-core/raw-window-handle-06\",\n \"i-slint-backend-selector/raw-window-handle-06\",\n \"i-slint-core/tr\",\n]\nfreestanding = [\"i-slint-core/libm\", \"i-slint-core/unsafe-single-threaded\"]\nexperimental = [\"i-slint-renderer-software?/experimental\"]\n\ndefault = [\"std\", \"backend-winit\", \"renderer-femtovg\", \"backend-qt\"]\n\n[dependencies]\ni-slint-backend-selector = { workspace = true, optional = true }\ni-slint-backend-testing = { workspace = true, optional = true, features = [\"ffi\", \"internal\"] }\ni-slint-renderer-skia = { workspace = true, features = [\"default\", \"x11\", \"wayland\"], optional = true }\ni-slint-renderer-software = { workspace = true, optional = true }\ni-slint-core = { workspace = true, features = [\"ffi\"] }\nslint-interpreter = { workspace = true, features = [\"ffi\", \"compat-1-2\"], optional = true }\nraw-window-handle = { version = \"0.6\", optional = true }\n\nesp-backtrace = { version = \"0.17.0\", features = [\"panic-handler\", \"println\"], optional = true }\nesp-println = { version = \"0.15.0\", default-features = false, features = [\"auto\", \"log-04\"], optional = true }\nunicode-segmentation = { workspace = true }\n\n[build-dependencies]\nanyhow = \"1.0\"\ncbindgen = { workspace = true }\ni-slint-common = { workspace = true, features = [\"default\"] }\nproc-macro2 = \"1.0.11\"\n" }, { "path": "api/cpp/README.md", "content": "\n# Slint-cpp\n\n## A C++ UI toolkit\n\n[Slint](https://slint.dev/) is a UI toolkit that supports different programming languages.\nSlint.cpp is the C++ API to interact with a Slint UI from C++.\n\nThe complete C++ documentation can be viewed online at https://slint.dev/docs/cpp/.\n\n## Installing or Building Slint\n\nSlint comes with a CMake integration that automates the compilation step of the `.slint` markup language files and\noffers a CMake target for convenient linkage.\n\n*Note*: We recommend using the Ninja generator of CMake for the most efficient build and `.slint` dependency tracking.\nInstall [Ninja](https://ninja-build.org) and select the CMake Ninja backend by passing `-GNinja` or setting the `CMAKE_GENERATOR` environment variable to `Ninja`.\n\n### Building from Sources\n\nThe recommended and most flexible way to use the C++ API is to build Slint from sources.\n\nFirst you need to install the prerequisites:\n\n* Install Rust by following the [Rust Getting Started Guide](https://www.rust-lang.org/learn/get-started). Once this is done,\n you should have the ```rustc``` compiler and the ```cargo``` build system installed in your path.\n* **[cmake](https://cmake.org/download/)** (3.21 or newer)\n* A C++ compiler that supports C++20 (e.g., **MSVC 2019 16.6** on Windows)\n\nYou can include Slint in your CMake project using CMake's `FetchContent` feature. Insert the following snippet into your\n`CMakeLists.txt` to make CMake download the latest release, compile it and make the CMake integration available:\n\n```cmake\ninclude(FetchContent)\nFetchContent_Declare(\n Slint\n GIT_REPOSITORY https://github.com/slint-ui/slint.git\n # `release/1` will auto-upgrade to the latest Slint >= 1.0.0 and < 2.0.0\n # `release/1.0` will auto-upgrade to the latest Slint >= 1.0.0 and < 1.1.0\n GIT_TAG release/1\n SOURCE_SUBDIR api/cpp\n)\nFetchContent_MakeAvailable(Slint)\n```\n\nIf you prefer to treat Slint as an external CMake package, then you can also build Slint from source like a regular\nCMake project, install it into a prefix directory of your choice and use `find_package(Slint)` in your `CMakeLists.txt`.\n\n#### Cross-compiling\n\nIt is possible to cross-compile Slint to a different target architecture when building with CMake. In order to complete\nthat, you need to make sure that your CMake setup is ready for cross-compilation. You can find more information about\nhow to set this up in the [upstream CMake documentation](https://cmake.org/cmake/help/latest/manual/cmake-toolchains.7.html#cross-compiling).\nIf you are building against a Yocto SDK, it is sufficient to source the SDK's environment setup file.\n\nSince Slint is implemented using the Rust programming language, you need to determine which Rust target\nmatches the target architecture that you're compiling to. Please consult the [upstream Rust documentation](https://doc.rust-lang.org/nightly/rustc/platform-support.html) to find the correct target name. Now you need to install the Rust toolchain:\n\n```sh\nrustup target add \n```\n\nThen you're ready to invoke CMake and you need to add `-DRust_CARGO_TARGET=` to the CMake command line.\nThis ensures that the Slint library is built for the correct architecture.\n\nFor example if you are building against an embedded Linux Yocto SDK targeting an ARM64 board, the following commands\nshow how to compile:\n\nInstall the Rust targe toolchain once:\n\n```sh\nrustup target add aarch64-unknown-linux-gnu\n```\n\nSet up the environment and build:\n\n```sh\n. /path/to/yocto/sdk/environment-setup-cortexa53-crypto-poky-linux\ncd slint\nmkdir build\ncd build\ncmake -DRust_CARGO_TARGET=aarch64-unknown-linux-gnu -DCMAKE_INSTALL_PREFIX=/slint/install/path ..\ncmake --build .\ncmake --install .\n```\n\n### Binary Packages\n\nWe also provide binary packages of Slint for use with C++, which eliminates the need to have Rust installed in your development environment.\n\nYou can download one of our pre-built binaries for Linux or Windows on x86-64 architectures:\n\n1. Open \n2. Click on the latest release\n3. From \"Assets\" download either `slint-cpp-XXX-Linux-x86_64.tar.gz` for a Linux x86-64 archive\n or `slint-cpp-XXX-win64.exe` for a Windows x86-64 installer. (\"XXX\" refers to the version of the latest release)\n4. Uncompress the downloaded archive or run the installer.\n\n\nAfter extracting the artifact or running the installer, you can place the installation directory into your\n`CMAKE_PREFIX_PATH` and `find_package(Slint)` should succeed in locating the package.\n\n\n## Usage via CMake\n\nA typical example looks like this:\n\n```cmake\ncmake_minimum_required(VERSION 3.21)\nproject(my_application LANGUAGES CXX)\n\n# Note: Use find_package(Slint) instead of the following three commands, if you prefer the package\n# approach.\ninclude(FetchContent)\nFetchContent_Declare(\n Slint\n GIT_REPOSITORY https://github.com/slint-ui/slint.git\n # `release/1` will auto-upgrade to the latest Slint >= 1.0.0 and < 2.0.0\n # `release/1.0` will auto-upgrade to the latest Slint >= 1.0.0 and < 1.1.0\n GIT_TAG release/1\n SOURCE_SUBDIR api/cpp\n)\nFetchContent_MakeAvailable(Slint)\n\nadd_executable(my_application main.cpp)\ntarget_link_libraries(my_application PRIVATE Slint::Slint)\nslint_target_sources(my_application my_application_ui.slint)\n# On Windows, copy the Slint DLL next to the application binary so that it's found.\nif (WIN32)\n add_custom_command(TARGET my_application POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy $ $ COMMAND_EXPAND_LISTS)\nendif()\n```\n\nThe `slint_target_sources` cmake command allows you to add .slint files to your build. Finally it is\nnecessary to link your executable or library against the `Slint::Slint` target.\n\n## Tutorial\n\nLet's make a UI for a todo list application using the Slint UI description language.\nHopefully this should be self explanatory. Check out the documentation of the language for help\n\n```slint\n// file: my_application_ui.slint\nimport { CheckBox, Button, ListView, LineEdit } from \"std-widgets.slint\";\n\nexport struct TodoItem {\n title: string,\n checked: bool,\n}\n\nexport component MainWindow {\n callback todo_added(string);\n property <[TodoItem]> todo_model;\n\n GridLayout {\n Row {\n text_edit := LineEdit {\n accepted(text) => { todo_added(text); }\n }\n Button {\n text: \"Add Todo\";\n clicked => {\n todo_added(text_edit.text);\n }\n }\n }\n list_view := ListView {\n rowspan: 2;\n row: 2;\n for todo in todo_model: Rectangle {\n height: 20px;\n GridLayout {\n CheckBox {\n text: todo.title;\n checked: todo.checked;\n toggled => {\n todo.checked = self.checked;\n }\n }\n }\n }\n }\n }\n}\n```\n\nWe can compile this code using the `slint-compiler` binary:\n\n```sh\nslint-compiler my_application_ui.slint > my_application_ui.h\n```\n\nNote: You would usually not type this command yourself, this is done automatically by the build system.\n(that's what the `slint_target_sources` cmake function does)\n\nThis will generate a `my_application_ui.h` header file. It basically contains the following code\n(edited for brevity)\n\n```C++\n#include \n\nstruct TodoItem {\n slint::SharedString title;\n bool checked;\n};\n\nstruct MainWindow {\n public:\n inline auto create () -> slint::ComponentHandle;\n\n inline auto get_todo_model () const -> std::shared_ptr>;\n inline void set_todo_model (const std::shared_ptr> &value) const;\n\n inline void invoke_todo_added (slint::SharedString arg_0) const;\n template inline void on_todo_added (Functor && callback_handler) const;\n\n //...\n}\n```\n\nWe can then use this from out .cpp file\n\n```C++\n// include the generated file\n#include \"my_application_ui.h\"\n\nint main() {\n // Let's instantiate our window\n auto todo_app = MainWindow::create();\n\n // let's create a model:\n auto todo_model = std::make_shared>(std::vector {\n TodoItem { false, \"Write documentation\" },\n });\n // set the model as the model of our view\n todo_app->set_todo_model(todo_model);\n\n // let's connect our \"add\" button to add an item in the model\n todo_app->on_todo_added([todo_model](const slint::SharedString &s) {\n todo_model->push_back(TodoItem { false, s} );\n });\n\n // Show the window and run the event loop\n todo_app->run();\n}\n```\n\nThat's it.\n\nFor more details, check the [Online documentation](https://slint.dev/docs/cpp).\nWe also have a [Getting Started Template](https://github.com/slint-ui/slint-cpp-template) repository with\nthe code of a minimal C++ application using Slint that can be used as a starting point to your program.\n" }, { "path": "api/cpp/build.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse crate::cbindgen::EnabledFeatures;\nuse std::path::Path;\nmod cbindgen;\n\nfn main() -> Result<(), anyhow::Error> {\n let manifest_dir = std::env::var_os(\"CARGO_MANIFEST_DIR\").unwrap();\n\n // Go from $root/api/cpp down to $root\n let root_dir = Path::new(&manifest_dir).ancestors().nth(2).unwrap_or_else(|| {\n panic!(\"Failed to locate root directory, relative to {}\", manifest_dir.to_string_lossy())\n });\n\n println!(\"cargo:rerun-if-env-changed=SLINT_GENERATED_INCLUDE_DIR\");\n let output_dir = std::env::var_os(\"SLINT_GENERATED_INCLUDE_DIR\").unwrap_or_else(|| {\n Path::new(&std::env::var_os(\"OUT_DIR\").unwrap()).join(\"generated_include\").into()\n });\n let output_dir = Path::new(&output_dir);\n\n println!(\"cargo:GENERATED_INCLUDE_DIR={}\", output_dir.display());\n\n let enabled_features = EnabledFeatures::from_env();\n\n let dependencies = cbindgen::gen_all(root_dir, output_dir, enabled_features)?;\n for path in dependencies {\n println!(\"cargo:rerun-if-changed={}\", path.display());\n }\n Ok(())\n}\n" }, { "path": "api/cpp/cbindgen.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse anyhow::Context;\nuse std::io::{BufWriter, Write};\nuse std::path::{Path, PathBuf};\n\n// cSpell: ignore compat constexpr corelib deps sharedvector pathdata\n\nfn enums(path: &Path) -> anyhow::Result<()> {\n let mut enums_priv = BufWriter::new(\n std::fs::File::create(path.join(\"slint_enums_internal.h\"))\n .context(\"Error creating slint_enums_internal.h file\")?,\n );\n writeln!(enums_priv, \"#pragma once\")?;\n writeln!(enums_priv, \"// This file is auto-generated from {}\", file!())?;\n writeln!(enums_priv, \"#include \\\"slint_enums.h\\\"\")?;\n writeln!(enums_priv, \"namespace slint::cbindgen_private {{\")?;\n let mut enums_pub = BufWriter::new(\n std::fs::File::create(path.join(\"slint_enums.h\"))\n .context(\"Error creating slint_enums.h file\")?,\n );\n writeln!(enums_pub, \"#pragma once\")?;\n writeln!(enums_pub, \"// This file is auto-generated from {}\", file!())?;\n writeln!(enums_pub, \"namespace slint {{\")?;\n macro_rules! enum_file {\n (PointerEventButton) => {{\n writeln!(enums_priv, \"using slint::PointerEventButton;\")?;\n &mut enums_pub\n }};\n (AccessibleRole) => {{\n writeln!(enums_priv, \"using slint::testing::AccessibleRole;\")?;\n &mut enums_pub\n }};\n ($_:ident) => {\n &mut enums_priv\n };\n }\n macro_rules! enum_sub_namespace {\n (AccessibleRole) => {{ Some(\"testing\") }};\n ($_:ident) => {\n None\n };\n }\n macro_rules! print_enums {\n ($( $(#[doc = $enum_doc:literal])* $(#[non_exhaustive])? enum $Name:ident { $( $(#[doc = $value_doc:literal])* $Value:ident,)* })*) => {\n $(\n let file = enum_file!($Name);\n let namespace: Option<&'static str> = enum_sub_namespace!($Name);\n if let Some(ns) = namespace {\n writeln!(file, \"namespace {} {{\", ns)?;\n }\n $(writeln!(file, \"///{}\", $enum_doc)?;)*\n writeln!(file, \"enum class {} {{\", stringify!($Name))?;\n $(\n $(writeln!(file, \" ///{}\", $value_doc)?;)*\n writeln!(file, \" {},\", stringify!($Value).trim_start_matches(\"r#\"))?;\n )*\n writeln!(file, \"}};\")?;\n if namespace.is_some() {\n writeln!(file, \"}}\")?;\n }\n )*\n }\n }\n i_slint_common::for_each_enums!(print_enums);\n\n writeln!(enums_pub, \"}}\")?;\n writeln!(enums_priv, \"}}\")?;\n\n // Print the key codes constants\n // This is not an enum, but fits well in that file\n writeln!(\n enums_pub,\n r#\"\n/// This namespace contains constants for each special non-printable key.\n///\n/// Each constant can be converted to SharedString.\n/// The constants are meant to be used with the slint::Window::dispatch_key_press_event() and\n/// slint::Window::dispatch_key_release_event() functions.\n///\n/// Example:\n/// ```\n/// window.dispatch_key_press_event(slint::platform::key_codes::Tab);\n/// ```\nnamespace slint::platform::key_codes {{\n\"#\n )?;\n macro_rules! print_key_codes {\n ($($char:literal # $name:ident # $($shifted:expr)? $(=> $($qt:ident)|* # $($winit:ident $(($_pos:ident))?)|* # $($_xkb:ident)|*)? ;)*) => {\n $(\n writeln!(enums_pub, \"/// A constant that represents the key code to be used in slint::Window::dispatch_key_press_event()\")?;\n writeln!(enums_pub, r#\"constexpr std::u8string_view {} = u8\"\\u{:04x}\";\"#, stringify!($name), $char as u32)?;\n )*\n };\n }\n i_slint_common::for_each_keys!(print_key_codes);\n writeln!(enums_pub, \"}}\")?;\n\n enums_priv.flush()?;\n enums_pub.flush()?;\n Ok(())\n}\n\nfn builtin_structs(path: &Path) -> anyhow::Result<()> {\n let mut structs_pub = BufWriter::new(\n std::fs::File::create(path.join(\"slint_builtin_structs.h\"))\n .context(\"Error creating slint_builtin_structs.h file\")?,\n );\n writeln!(structs_pub, \"#pragma once\")?;\n writeln!(structs_pub, \"// This file is auto-generated from {}\", file!())?;\n writeln!(structs_pub, \"namespace slint::language {{\")?;\n\n let mut structs_priv = BufWriter::new(\n std::fs::File::create(path.join(\"slint_builtin_structs_internal.h\"))\n .context(\"Error creating slint_builtin_structs_internal.h file\")?,\n );\n writeln!(structs_priv, \"#pragma once\")?;\n writeln!(structs_priv, \"// This file is auto-generated from {}\", file!())?;\n writeln!(structs_priv, \"#include \\\"slint_builtin_structs.h\\\"\")?;\n writeln!(structs_priv, \"#include \\\"slint_enums_internal.h\\\"\")?;\n writeln!(structs_priv, \"#include \\\"slint_point.h\\\"\")?;\n writeln!(structs_priv, \"#include \\\"slint_image.h\\\"\")?;\n writeln!(structs_priv, \"namespace slint::cbindgen_private {{\")?;\n writeln!(structs_priv, \"enum class KeyEventType : uint8_t;\")?;\n macro_rules! struct_file {\n (BuiltinPublicStruct, $Name:ident) => {{\n writeln!(structs_priv, \"using slint::language::{};\", stringify!($Name))?;\n &mut structs_pub\n }};\n (BuiltinPrivateStruct, $_:ident) => {\n &mut structs_priv\n };\n }\n macro_rules! print_structs {\n ($(\n $(#[doc = $struct_doc:literal])*\n $(#[non_exhaustive])?\n $(#[derive(Copy, Eq)])?\n struct $Name:ident {\n @name = $NameTy:ident :: $NameVariant:ident,\n export {\n $( $(#[doc = $pub_doc:literal])* $pub_field:ident : $pub_type:ty, )*\n }\n private {\n $( $(#[doc = $pri_doc:literal])* $pri_field:ident : $pri_type:ty, )*\n }\n }\n )*) => {\n $(\n let file = struct_file!($NameTy, $Name);\n $(writeln!(file, \"///{}\", $struct_doc)?;)*\n writeln!(file, \"struct {} {{\", stringify!($Name))?;\n $(\n $(writeln!(file, \" ///{}\", $pub_doc)?;)*\n let pub_type = match stringify!($pub_type) {\n \"i32\" => \"int32_t\",\n \"f32\" | \"Coord\" => \"float\",\n other => other,\n };\n writeln!(file, \" {} {};\", pub_type, stringify!($pub_field))?;\n )*\n $(\n $(writeln!(file, \" ///{}\", $pri_doc)?;)*\n let pri_type = stringify!($pri_type).replace(' ', \"\");\n let pri_type = match pri_type.as_str() {\n \"usize\" => \"uintptr_t\",\n \"crate::animations::Instant\" => \"uint64_t\",\n // This shouldn't be accessed by the C++ anyway, just need to have the same ABI in a struct\n \"Option\" => \"std::pair\",\n \"Option>\" => \"std::tuple\",\n other => other,\n };\n writeln!(file, \" {} {};\", pri_type, stringify!($pri_field))?;\n )*\n writeln!(file, \" /// \\\\private\")?;\n writeln!(file, \" {}\", format!(\"friend bool operator==(const {name}&, const {name}&) = default;\", name = stringify!($Name)))?;\n writeln!(file, \" /// \\\\private\")?;\n writeln!(file, \" {}\", format!(\"friend bool operator!=(const {name}&, const {name}&) = default;\", name = stringify!($Name)))?;\n writeln!(file, \"}};\")?;\n )*\n };\n }\n i_slint_common::for_each_builtin_structs!(print_structs);\n writeln!(structs_priv, \"}}\")?;\n writeln!(structs_pub, \"}}\")?;\n // Backward-compatible alias: StandardListViewItem was previously exposed directly under slint::\n writeln!(structs_pub, \"namespace slint {{ using slint::language::StandardListViewItem; }}\")?;\n structs_priv.flush()?;\n structs_pub.flush()?;\n Ok(())\n}\n\nfn ensure_cargo_rerun_for_crate(\n crate_dir: &Path,\n dependencies: &mut Vec,\n) -> anyhow::Result<()> {\n dependencies.push(crate_dir.to_path_buf());\n for entry in std::fs::read_dir(crate_dir)? {\n let entry = entry?;\n if entry.path().extension().is_some_and(|e| e == \"rs\") {\n dependencies.push(entry.path());\n }\n }\n Ok(())\n}\n\nfn default_config() -> cbindgen::Config {\n let mut config = cbindgen::Config::default();\n config.macro_expansion.bitflags = true;\n config.pragma_once = true;\n config.include_version = true;\n config.namespaces = Some(vec![\"slint\".into(), \"cbindgen_private\".into()]);\n config.line_length = 100;\n config.tab_width = 4;\n // Note: we might need to switch to C if we need to generate bindings for language that needs C headers\n config.language = cbindgen::Language::Cxx;\n config.cpp_compat = true;\n config.documentation = true;\n config.export = cbindgen::ExportConfig {\n rename: [\n (\"Callback\".into(), \"private_api::CallbackHelper\".into()),\n (\"VoidArg\".into(), \"void\".into()),\n (\"FocusReasonArg\".into(), \"FocusReason\".into()),\n (\"StringArg\".into(), \"slint::SharedString\".into()),\n (\"KeyEventArg\".into(), \"KeyEvent\".into()),\n (\"PointerEventArg\".into(), \"PointerEvent\".into()),\n (\"DropEventArg\".into(), \"DropEvent\".into()),\n (\"PointerScrollEventArg\".into(), \"PointerScrollEvent\".into()),\n (\"PointArg\".into(), \"slint::LogicalPosition\".into()),\n (\"FloatArg\".into(), \"float\".into()),\n (\"IntArg\".into(), \"int\".into()),\n (\"MenuEntryArg\".into(), \"MenuEntry\".into()),\n // Note: these types are not the same, but they are only used in callback return types that are only used in C++ (set and called)\n // therefore it is ok to reinterpret_cast\n (\"MenuEntryModel\".into(), \"std::shared_ptr>\".into()),\n (\"Coord\".into(), \"float\".into()),\n (\"Channel\".into(), \"uint8_t\".into()),\n ]\n .iter()\n .cloned()\n .collect(),\n ..Default::default()\n };\n config.defines = [\n (\"target_pointer_width = 64\".into(), \"SLINT_TARGET_64\".into()),\n (\"target_pointer_width = 32\".into(), \"SLINT_TARGET_32\".into()),\n // Disable any wasm guarded code in C++, too - so that there are no gaps in enums.\n (\"target_arch = wasm32\".into(), \"SLINT_TARGET_WASM\".into()),\n (\"target_os = android\".into(), \"__ANDROID__\".into()),\n // Disable Rust WGPU specific API feature\n (\"feature = unstable-wgpu-27\".into(), \"SLINT_DISABLED_CODE\".into()),\n (\"feature = unstable-wgpu-28\".into(), \"SLINT_DISABLED_CODE\".into()),\n ]\n .iter()\n .cloned()\n .collect();\n config.structure.associated_constants_in_body = true;\n config.constant.allow_constexpr = true;\n config\n}\n\nfn gen_item_declarations(items: &[&str]) -> String {\n format!(\n r#\"\nnamespace slint::private_api {{\n#define SLINT_DECL_ITEM(ItemName) \\\n extern const cbindgen_private::ItemVTable ItemName##VTable; \\\n extern SLINT_DLL_IMPORT const cbindgen_private::ItemVTable* slint_get_##ItemName##VTable();\n\nextern \"C\" {{\n{}\n}}\n\n#undef SLINT_DECL_ITEM\n}}\n\"#,\n items\n .iter()\n .map(|item_name| format!(\"SLINT_DECL_ITEM({item_name});\"))\n .collect::>()\n .join(\"\\n\")\n )\n}\n\nfn gen_corelib(\n root_dir: &Path,\n include_dir: &Path,\n dependencies: &mut Vec,\n enabled_features: EnabledFeatures,\n) -> anyhow::Result<()> {\n let mut config = default_config();\n\n let items = [\n \"Empty\",\n \"Rectangle\",\n \"BasicBorderRectangle\",\n \"BorderRectangle\",\n \"DragArea\",\n \"DropArea\",\n \"ImageItem\",\n \"ClippedImage\",\n \"TouchArea\",\n \"FocusScope\",\n \"KeyBinding\",\n \"SwipeGestureHandler\",\n \"PinchGestureHandler\",\n \"Flickable\",\n \"SimpleText\",\n \"StyledTextItem\",\n \"ComplexText\",\n \"Path\",\n \"WindowItem\",\n \"TextInput\",\n \"Clip\",\n \"BoxShadow\",\n \"Transform\",\n \"Opacity\",\n \"Layer\",\n \"ContextMenu\",\n \"MenuItem\",\n ];\n\n config.export.include = [\n \"Clipboard\",\n \"ItemTreeVTable\",\n \"Slice\",\n \"WindowAdapterRcOpaque\",\n \"PropertyAnimation\",\n \"AnimationDirection\",\n \"EasingCurve\",\n \"TextHorizontalAlignment\",\n \"TextVerticalAlignment\",\n \"TextOverflow\",\n \"TextWrap\",\n \"ImageFit\",\n \"FillRule\",\n \"MouseCursor\",\n \"InputType\",\n \"StandardButtonKind\",\n \"DialogButtonRole\",\n \"FocusReason\",\n \"PointerEventKind\",\n \"PointerEventButton\",\n \"PointerEvent\",\n \"PointerScrollEvent\",\n \"Rect\",\n \"SortOrder\",\n \"BitmapFont\",\n ]\n .iter()\n .chain(items.iter())\n .map(|x| x.to_string())\n .collect();\n\n let mut private_exported_types: std::collections::HashSet =\n config.export.include.iter().cloned().collect();\n\n // included in generated_public.h\n let public_exported_types = [\n \"RenderingState\",\n \"SetRenderingNotifierError\",\n \"GraphicsAPI\",\n \"CloseRequestResponse\",\n \"StandardListViewItem\",\n \"Rgb8Pixel\",\n \"Rgba8Pixel\",\n ];\n\n config.export.exclude = [\n \"SharedString\",\n \"StyledText\",\n \"SharedVector\",\n \"ImageInner\",\n \"ImageCacheKey\",\n \"Image\",\n \"Color\",\n \"PathData\",\n \"PathElement\",\n \"Brush\",\n \"slint_new_path_elements\",\n \"slint_new_path_events\",\n \"Property\",\n \"Slice\",\n \"Timer\",\n \"PropertyHandleOpaque\",\n \"Callback\",\n \"slint_property_listener_scope_evaluate\",\n \"slint_property_listener_scope_is_dirty\",\n \"PropertyTrackerOpaque\",\n \"CallbackOpaque\",\n \"WindowAdapterRc\",\n \"VoidArg\",\n \"StringArg\",\n \"DropEventArg\",\n \"FocusReasonArg\",\n \"KeyEventArg\",\n \"PointerEventArg\",\n \"PointerScrollEventArg\",\n \"PointArg\",\n \"Point\",\n \"MenuEntryModel\",\n \"MenuEntryArg\",\n \"Coord\",\n \"Channel\",\n \"LogicalRect\",\n \"LogicalPoint\",\n \"LogicalPosition\",\n \"LogicalLength\",\n ]\n .iter()\n .chain(public_exported_types.iter())\n .map(|x| x.to_string())\n .collect();\n\n let mut crate_dir = root_dir.to_owned();\n crate_dir.extend([\"internal\", \"core\"].iter());\n\n ensure_cargo_rerun_for_crate(&crate_dir, dependencies)?;\n\n let mut string_config = config.clone();\n string_config.export.exclude = vec![\"SharedString\".into(), \"StyledText\".into()];\n string_config.export.body.insert(\n \"Slice\".to_owned(),\n \" const T &operator[](int i) const { return ptr[i]; }\".to_owned(),\n );\n cbindgen::Builder::new()\n .with_config(string_config)\n .with_src(crate_dir.join(\"string.rs\"))\n .with_src(crate_dir.join(\"styled_text.rs\"))\n .with_src(crate_dir.join(\"slice.rs\"))\n .with_after_include(\"namespace slint { struct SharedString; namespace private_api { struct StyledText; } namespace cbindgen_private { using private_api::StyledText; }}\")\n .generate()\n .context(\"Unable to generate bindings for slint_string_internal.h\")?\n .write_to_file(include_dir.join(\"slint_string_internal.h\"));\n\n cbindgen::Builder::new()\n .with_config(config.clone())\n .with_src(crate_dir.join(\"sharedvector.rs\"))\n .with_after_include(\"namespace slint { template struct SharedVector; }\")\n .generate()\n .context(\"Unable to generate bindings for slint_sharedvector_internal.h\")?\n .write_to_file(include_dir.join(\"slint_sharedvector_internal.h\"));\n\n let mut properties_config = config.clone();\n properties_config.export.exclude.clear();\n properties_config.structure.derive_eq = true;\n properties_config.structure.derive_neq = true;\n private_exported_types.extend(properties_config.export.include.iter().cloned());\n cbindgen::Builder::new()\n .with_config(properties_config)\n .with_src(crate_dir.join(\"properties.rs\"))\n .with_src(crate_dir.join(\"properties/ffi.rs\"))\n .with_src(crate_dir.join(\"callbacks.rs\"))\n .with_after_include(\"namespace slint { class Color; class Brush; }\")\n .generate()\n .context(\"Unable to generate bindings for slint_properties_internal.h\")?\n .write_to_file(include_dir.join(\"slint_properties_internal.h\"));\n\n // slint_timer_internal.h:\n let timer_config = {\n let mut tmp = config.clone();\n tmp.export.include = [\n \"TimerMode\",\n \"slint_timer_start\",\n \"slint_timer_singleshot\",\n \"slint_timer_destroy\",\n \"slint_timer_stop\",\n \"slint_timer_restart\",\n \"slint_timer_running\",\n ]\n .iter()\n .map(|s| s.to_string())\n .collect();\n tmp\n };\n config.export.exclude.extend(timer_config.export.include.iter().cloned());\n cbindgen::Builder::new()\n .with_config(timer_config)\n .with_src(crate_dir.join(\"timers.rs\"))\n .generate()\n .context(\"Unable to generate bindings for slint_timer_internal.h\")?\n .write_to_file(include_dir.join(\"slint_timer_internal.h\"));\n\n for (rust_types, internal_header, prelude) in [\n (\n vec![\n \"ImageInner\",\n \"Image\",\n \"ImageCacheKey\",\n \"Size\",\n \"slint_image_size\",\n \"slint_image_path\",\n \"slint_image_load_from_path\",\n \"slint_image_load_from_embedded_data\",\n \"slint_image_from_embedded_textures\",\n \"slint_image_compare_equal\",\n \"slint_image_set_nine_slice_edges\",\n \"slint_image_to_rgb8\",\n \"slint_image_to_rgba8\",\n \"slint_image_to_rgba8_premultiplied\",\n \"SharedPixelBuffer\",\n \"SharedImageBuffer\",\n \"StaticTextures\",\n \"BorrowedOpenGLTextureOrigin\",\n \"PhysicalRegion\",\n \"PHYSICAL_REGION_MAX_SIZE\",\n ],\n \"slint_image_internal.h\",\n \"#include \\\"slint_color.h\\\"\\nnamespace slint::cbindgen_private { struct ParsedSVG{}; struct HTMLImage{}; struct PhysicalPx; using namespace vtable; namespace types{ struct NineSliceImage{}; } }\",\n ),\n (\n vec![\"Color\", \"slint_color_brighter\", \"slint_color_darker\",\n \"slint_color_transparentize\",\n \"slint_color_mix\",\n \"slint_color_with_alpha\",\n \"slint_color_to_hsva\",\n \"slint_color_from_hsva\",\n \"slint_color_from_oklch\",\n \"slint_color_to_oklch\",],\n \"slint_color_internal.h\",\n \"\",\n ),\n (\n vec![\"PathData\", \"PathElement\", \"slint_new_path_elements\", \"slint_new_path_events\", \"Point\"],\n \"slint_pathdata_internal.h\",\n \"#include \\\"slint_sharedvector.h\\\"\\n#include \\\"slint_point.h\\\"\",\n ),\n (\n vec![\"Brush\", \"LinearGradient\", \"GradientStop\", \"RadialGradient\", \"ConicGradientBrush\",\n \"slint_conic_gradient_normalize_stops\", \"slint_conic_gradient_apply_rotation\"],\n \"slint_brush_internal.h\",\n \"\",\n ),\n (\n vec![\"MouseEvent\", \"TouchPhase\", \"Keys\"],\n \"slint_events_internal.h\",\n \"#include \\\"slint_point.h\\\"\n namespace slint::cbindgen_private {\n struct KeyEvent; struct PointerEvent;\n struct Rect;\n using LogicalRect = Rect;\n using LogicalPoint = Point2D;\n using LogicalLength = float;\n }\",\n )\n ]\n .iter()\n {\n let mut special_config = config.clone();\n special_config.export.include = rust_types.iter().map(|s| s.to_string()).collect();\n special_config.export.exclude = [\n \"slint_keys_debug_string\",\n \"slint_keys_to_string\",\n \"slint_keys\",\n \"slint_visit_item_tree\",\n \"slint_windowrc_drop\",\n \"slint_windowrc_clone\",\n \"slint_windowrc_show\",\n \"slint_windowrc_hide\",\n \"slint_windowrc_is_visible\",\n \"slint_windowrc_get_scale_factor\",\n \"slint_windowrc_set_const_scale_factor\",\n \"slint_windowrc_get_text_input_focused\",\n \"slint_windowrc_set_text_input_focused\",\n \"slint_windowrc_set_focus_item\",\n \"slint_windowrc_set_component\",\n \"slint_windowrc_show_popup\",\n \"slint_windowrc_close_popup\",\n \"slint_windowrc_set_rendering_notifier\",\n \"slint_windowrc_request_redraw\",\n \"slint_windowrc_on_close_requested\",\n \"slint_windowrc_position\",\n \"slint_windowrc_set_logical_position\",\n \"slint_windowrc_set_physical_position\",\n \"slint_windowrc_size\",\n \"slint_windowrc_set_logical_size\",\n \"slint_windowrc_set_physical_size\",\n \"slint_windowrc_color_scheme\",\n \"slint_windowrc_supports_native_menu_bar\",\n \"slint_windowrc_setup_native_menu_bar\",\n \"slint_windowrc_show_native_popup_menu\",\n \"slint_windowrc_resolved_default_font_size\",\n \"slint_windowrc_dispatch_pointer_event\",\n \"slint_windowrc_dispatch_key_event\",\n \"slint_windowrc_dispatch_event\",\n \"slint_windowrc_set_fullscreen\",\n \"slint_windowrc_set_minimized\",\n \"slint_windowrc_set_maximized\",\n \"slint_windowrc_is_fullscreen\",\n \"slint_windowrc_is_minimized\",\n \"slint_windowrc_is_maximized\",\n \"slint_windowrc_take_snapshot\",\n \"slint_windowrc_hwnd_win32\",\n \"slint_windowrc_hinstance_win32\",\n \"slint_windowrc_wlsurface_wayland\",\n \"slint_windowrc_wldisplay_wayland\",\n \"slint_windowrc_nsview_appkit\",\n \"GradientStop\",\n \"ConicGradientBrush\",\n \"slint_conic_gradient_normalize_stops\",\n \"slint_conic_gradient_apply_rotation\",\n \"PHYSICAL_REGION_MAX_SIZE\",\n ]\n .into_iter()\n .chain(config.export.exclude.iter().map(|s| s.as_str()))\n .filter(|exclusion| !rust_types.iter().any(|inclusion| inclusion == exclusion))\n .map(|s| s.to_string())\n .collect();\n\n config.export.exclude.extend(rust_types.iter().map(|s| s.to_string()));\n\n special_config.enumeration = cbindgen::EnumConfig {\n derive_tagged_enum_copy_assignment: true,\n derive_tagged_enum_copy_constructor: true,\n derive_tagged_enum_destructor: true,\n derive_helper_methods: true,\n private_default_tagged_enum_constructor: true,\n ..Default::default()\n };\n special_config.structure.derive_eq = true;\n special_config.structure.derive_neq = true;\n // Put the rust type in a deeper \"types\" namespace, so the use of same type in for example generated\n // Property<> fields uses the public `slint::Blah` type\n special_config.namespaces =\n Some(vec![\"slint\".into(), \"cbindgen_private\".into(), \"types\".into()]);\n\n private_exported_types.extend(special_config.export.include.iter().cloned());\n\n special_config.after_includes = (!prelude.is_empty()).then(|| prelude.to_string());\n\n cbindgen::Builder::new()\n .with_config(special_config)\n .with_src(crate_dir.join(\"graphics.rs\"))\n .with_src(crate_dir.join(\"graphics/color.rs\"))\n .with_src(crate_dir.join(\"graphics/path.rs\"))\n .with_src(crate_dir.join(\"graphics/brush.rs\"))\n .with_src(crate_dir.join(\"graphics/image.rs\"))\n .with_src(crate_dir.join(\"graphics/image/cache.rs\"))\n .with_src(crate_dir.join(\"animations.rs\"))\n .with_src(crate_dir.join(\"input.rs\"))\n .with_src(crate_dir.join(\"item_rendering.rs\"))\n .with_src(crate_dir.join(\"window.rs\"))\n .with_src(crate_dir.join(\"../renderers/software/lib.rs\"))\n .with_include(\"slint_enums_internal.h\")\n .generate()\n .with_context(|| format!(\"Unable to generate bindings for {internal_header}\"))?\n .write_to_file(include_dir.join(internal_header));\n }\n\n // Generate a header file with some public API (enums, etc.)\n let mut public_config = config.clone();\n public_config.namespaces = Some(vec![\"slint\".into()]);\n public_config.export.item_types = vec![cbindgen::ItemType::Enums, cbindgen::ItemType::Structs];\n // Previously included types are now excluded (to avoid duplicates)\n public_config.export.exclude = private_exported_types.into_iter().collect();\n public_config.export.exclude.push(\"LogicalPosition\".into());\n public_config.export.exclude.push(\"MenuVTable\".into());\n public_config.export.include = public_exported_types.into_iter().map(str::to_string).collect();\n public_config.export.body.insert(\n \"Rgb8Pixel\".to_owned(),\n \"/// \\\\private\\nfriend bool operator==(const Rgb8Pixel&, const Rgb8Pixel&) = default;\"\n .into(),\n );\n public_config.export.body.insert(\n \"Rgba8Pixel\".to_owned(),\n \"/// \\\\private\\nfriend bool operator==(const Rgba8Pixel&, const Rgba8Pixel&) = default;\"\n .into(),\n );\n\n cbindgen::Builder::new()\n .with_config(public_config)\n .with_src(crate_dir.join(\"graphics.rs\"))\n .with_src(crate_dir.join(\"window.rs\"))\n .with_src(crate_dir.join(\"api.rs\"))\n .with_src(crate_dir.join(\"model.rs\"))\n .with_src(crate_dir.join(\"graphics/image.rs\"))\n .with_src(crate_dir.join(\"lengths.rs\"))\n .with_include(\"slint_string.h\")\n .with_after_include(format!(\n r#\"\n/// This macro expands to the to the numeric value of the major version of Slint you're\n/// developing against. For example if you're using version 1.5.2, this macro will expand to 1.\n#define SLINT_VERSION_MAJOR {x}\n/// This macro expands to the to the numeric value of the minor version of Slint you're\n/// developing against. For example if you're using version 1.5.2, this macro will expand to 5.\n#define SLINT_VERSION_MINOR {y}\n/// This macro expands to the to the numeric value of the patch version of Slint you're\n/// developing against. For example if you're using version 1.5.2, this macro will expand to 2.\n#define SLINT_VERSION_PATCH {z}\n/// This macro expands to the string representation of the version of Slint you're developing against.\n/// For example if you're using version 1.5.2, this macro will expand to \"1.5.2\".\n#define SLINT_VERSION_STRING \"{x}.{y}.{z}\"\n\n{features}\n\"#,\n x = env!(\"CARGO_PKG_VERSION_MAJOR\"),\n y = env!(\"CARGO_PKG_VERSION_MINOR\"),\n z = env!(\"CARGO_PKG_VERSION_PATCH\"),\n features = enabled_features.defines()\n ))\n .generate()\n .context(\"Unable to generate bindings for slint_generated_public.h\")?\n .write_to_file(include_dir.join(\"slint_generated_public.h\"));\n\n config.export.body.insert(\n \"ItemTreeNode\".to_owned(),\n \" constexpr ItemTreeNode(Item_Body x) : item {x} {}\n constexpr ItemTreeNode(DynamicTree_Body x) : dynamic_tree{x} {}\"\n .to_owned(),\n );\n config.export.body.insert(\n \"CachedRenderingData\".to_owned(),\n \" constexpr CachedRenderingData() : cache_index{}, cache_generation{} {}\".to_owned(),\n );\n config.export.body.insert(\n \"EasingCurve\".to_owned(),\n \" constexpr EasingCurve(EasingCurve::Tag tag = Tag::Linear, float a = 0, float b = 0, float c = 1, float d = 1) : tag(tag), cubic_bezier{{a,b,c,d}} {}\".into()\n );\n config.export.body.insert(\n \"LayoutInfo\".to_owned(),\n \" inline LayoutInfo merge(const LayoutInfo &other) const;\n friend inline LayoutInfo operator+(const LayoutInfo &a, const LayoutInfo &b) { return a.merge(b); }\n friend bool operator==(const LayoutInfo&, const LayoutInfo&) = default;\".into(),\n );\n config.export.body.insert(\n \"WindowEvent\".to_owned(),\n \"/* Some members of the WindowEvent enum have destructors (with SharedString), but thankfully we don't use these so we can have an empty constructor */\n ~WindowEvent() {}\"\n .into(),\n );\n config\n .export\n .body\n .insert(\"FocusScope\".to_owned(), \" inline FocusScope(); inline ~FocusScope();\".into());\n config\n .export\n .pre_body\n .insert(\"MaybeKeyBindingList\".to_owned(), \"struct KeyBindingList;\".into());\n config\n .export\n .body\n .insert(\"Flickable\".to_owned(), \" inline Flickable(); inline ~Flickable();\".into());\n config.export.pre_body.insert(\"FlickableDataBox\".to_owned(), \"struct FlickableData;\".into());\n\n cbindgen::Builder::new()\n .with_config(config)\n .with_src(crate_dir.join(\"lib.rs\"))\n .with_include(\"slint_config.h\")\n .with_include(\"vtable.h\")\n .with_include(\"slint_string.h\")\n .with_include(\"slint_sharedvector.h\")\n .with_include(\"slint_properties.h\")\n .with_include(\"slint_callbacks.h\")\n .with_include(\"slint_color.h\")\n .with_include(\"slint_image.h\")\n .with_include(\"slint_pathdata.h\")\n .with_include(\"slint_brush.h\")\n .with_include(\"slint_generated_public.h\")\n .with_include(\"slint_enums_internal.h\")\n .with_include(\"slint_point.h\")\n .with_include(\"slint_timer.h\")\n .with_include(\"slint_builtin_structs_internal.h\")\n .with_include(\"slint_events_internal.h\")\n .with_after_include(\n r\"\nnamespace slint {\n namespace private_api { class WindowAdapterRc; }\n namespace cbindgen_private {\n using slint::private_api::WindowAdapterRc;\n using namespace vtable;\n using private_api::Property;\n using private_api::PathData;\n using private_api::Point;\n struct ItemTreeVTable;\n struct ItemVTable;\n using types::IntRect;\n using types::Size;\n using types::MouseEvent;\n using types::Keys;\n }\n template class Model;\n}\",\n )\n .with_trailer(gen_item_declarations(&items))\n .generate()\n .expect(\"Unable to generate bindings\")\n .write_to_file(include_dir.join(\"slint_internal.h\"));\n\n Ok(())\n}\n\nfn gen_backend_qt(\n root_dir: &Path,\n include_dir: &Path,\n dependencies: &mut Vec,\n) -> anyhow::Result<()> {\n let mut config = default_config();\n\n let items = [\n \"NativeButton\",\n \"NativeSpinBox\",\n \"NativeCheckBox\",\n \"NativeSlider\",\n \"NativeProgressIndicator\",\n \"NativeGroupBox\",\n \"NativeLineEdit\",\n \"NativeScrollView\",\n \"NativeStandardListViewItem\",\n \"NativeTableHeaderSection\",\n \"NativeComboBox\",\n \"NativeComboBoxPopup\",\n \"NativeTabWidget\",\n \"NativeTab\",\n \"NativeStyleMetrics\",\n \"NativePalette\",\n ];\n\n config.export.include = items.iter().map(|x| x.to_string()).collect();\n config.export.exclude = vec![\"FloatArg\".into(), \"IntArg\".into()];\n\n config.export.body.insert(\n \"NativeStyleMetrics\".to_owned(),\n \" inline explicit NativeStyleMetrics(void* = nullptr); inline ~NativeStyleMetrics();\"\n .to_owned(),\n );\n\n config.export.body.insert(\n \"NativePalette\".to_owned(),\n \" inline explicit NativePalette(void* = nullptr); inline ~NativePalette();\".to_owned(),\n );\n\n let mut crate_dir = root_dir.to_owned();\n crate_dir.extend([\"internal\", \"backends\", \"qt\"].iter());\n\n ensure_cargo_rerun_for_crate(&crate_dir, dependencies)?;\n\n cbindgen::Builder::new()\n .with_config(config)\n .with_crate(crate_dir)\n .with_include(\"slint_internal.h\")\n .with_after_include(\n r\"\n namespace slint::cbindgen_private {\n // HACK ALERT: This struct declaration is duplicated in internal/backend/qt/qt_widgets.rs - keep in sync.\n struct SlintTypeErasedWidget\n {\n virtual ~SlintTypeErasedWidget() = 0;\n SlintTypeErasedWidget(const SlintTypeErasedWidget&) = delete;\n SlintTypeErasedWidget& operator=(const SlintTypeErasedWidget&) = delete;\n\n virtual void *qwidget() const = 0;\n };\n using SlintTypeErasedWidgetPtr = std::unique_ptr;\n }\n \",\n )\n .with_trailer(gen_item_declarations(&items))\n .generate()\n .context(\"Unable to generate bindings for slint_qt_internal.h\")?\n .write_to_file(include_dir.join(\"slint_qt_internal.h\"));\n\n Ok(())\n}\n\nfn gen_testing(\n root_dir: &Path,\n include_dir: &Path,\n dependencies: &mut Vec,\n) -> anyhow::Result<()> {\n let config = default_config();\n\n let mut crate_dir = root_dir.to_owned();\n crate_dir.extend([\"internal\", \"backends\", \"testing\"].iter());\n\n ensure_cargo_rerun_for_crate(&crate_dir, dependencies)?;\n\n cbindgen::Builder::new()\n .with_config(config)\n .with_crate(crate_dir)\n .with_include(\"slint_testing_internal.h\")\n .generate()\n .context(\"Unable to generate bindings for slint_testing_internal.h\")?\n .write_to_file(include_dir.join(\"slint_testing_internal.h\"));\n\n Ok(())\n}\n\nfn gen_platform(\n root_dir: &Path,\n include_dir: &Path,\n dependencies: &mut Vec,\n) -> anyhow::Result<()> {\n let config = default_config();\n let mut crate_dir = root_dir.to_owned();\n crate_dir.extend([\"api\", \"cpp\"].iter());\n\n ensure_cargo_rerun_for_crate(&crate_dir, dependencies)?;\n\n cbindgen::Builder::new()\n .with_config(config)\n .with_crate(crate_dir)\n .with_include(\"slint_image_internal.h\")\n .with_include(\"slint_internal.h\")\n .with_after_include(\n r\"\nnamespace slint::platform { struct Rgb565Pixel; }\nnamespace slint::cbindgen_private {\n struct WindowProperties; using slint::platform::Rgb565Pixel;\n using slint::cbindgen_private::types::TexturePixelFormat;\n struct DrawTextureArgs;\n struct DrawRectangleArgs;\n using types::PhysicalRegion;\n}\n\",\n )\n .generate()\n .context(\"Unable to generate bindings for slint_platform_internal.h\")?\n .write_to_file(include_dir.join(\"slint_platform_internal.h\"));\n\n Ok(())\n}\n\nfn gen_interpreter(\n root_dir: &Path,\n include_dir: &Path,\n dependencies: &mut Vec,\n) -> anyhow::Result<()> {\n let mut config = default_config();\n config.export.exclude = IntoIterator::into_iter([\n \"Value\",\n \"ValueType\",\n \"PropertyDescriptor\",\n \"Diagnostic\",\n \"PropertyDescriptor\",\n \"Box\",\n \"LiveReloadingComponentInner\",\n ])\n .map(String::from)\n .collect();\n let mut crate_dir = root_dir.to_owned();\n\n crate_dir.extend([\"internal\", \"interpreter\"].iter());\n ensure_cargo_rerun_for_crate(&crate_dir, dependencies)?;\n\n // Generate a header file with some public API (enums, etc.)\n let mut public_config = config.clone();\n public_config.namespaces = Some(vec![\"slint\".into(), \"interpreter\".into()]);\n public_config.export.item_types = vec![cbindgen::ItemType::Enums, cbindgen::ItemType::Structs];\n\n public_config.export.exclude = IntoIterator::into_iter([\n \"ComponentCompilerOpaque\",\n \"ComponentDefinitionOpaque\",\n \"ModelAdaptorVTable\",\n \"StructIteratorOpaque\",\n \"ComponentInstance\",\n \"StructIteratorResult\",\n \"Value\",\n \"StructOpaque\",\n \"ModelNotifyOpaque\",\n ])\n .map(String::from)\n .collect();\n\n cbindgen::Builder::new()\n .with_config(public_config)\n .with_crate(crate_dir.clone())\n .generate()\n .context(\"Unable to generate bindings for slint_interpreter_generated_public.h\")?\n .write_to_file(include_dir.join(\"slint_interpreter_generated_public.h\"));\n\n cbindgen::Builder::new()\n .with_config(config)\n .with_crate(crate_dir)\n .with_include(\"slint_internal.h\")\n .with_include(\"slint_interpreter_generated_public.h\")\n .with_after_include(\n r\"\n namespace slint::cbindgen_private {\n struct Value;\n using slint::interpreter::ValueType;\n using slint::interpreter::PropertyDescriptor;\n using slint::interpreter::Diagnostic;\n struct LiveReloadingComponentInner;\n template using Box = T*;\n }\",\n )\n .generate()\n .context(\"Unable to generate bindings for slint_interpreter_internal.h\")?\n .write_to_file(include_dir.join(\"slint_interpreter_internal.h\"));\n\n Ok(())\n}\n\nmacro_rules! declare_features {\n ($($f:ident)+) => {\n #[derive(Clone, Copy)]\n pub struct EnabledFeatures {\n $(pub $f: bool,)*\n }\n impl EnabledFeatures {\n /// Generate the `#define`\n pub fn defines(self) -> String {\n let mut defines = String::new();\n $(\n if self.$f {\n defines = format!(\"{defines}///This macro is defined when Slint was configured with the SLINT_FEATURE_{0} flag enabled\\n#define SLINT_FEATURE_{0}\\n\", stringify!($f).to_ascii_uppercase());\n };\n )*\n defines\n }\n\n /// Get the feature from the environment variable set by cargo when building running the slint-cpp's build script\n #[allow(unused)]\n pub fn from_env() -> Self {\n Self {\n $(\n $f: std::env::var(format!(\"CARGO_FEATURE_{}\", stringify!($f).to_ascii_uppercase())).is_ok(),\n )*\n }\n }\n }\n };\n}\n\ndeclare_features! {\n interpreter\n live_preview\n testing\n backend_qt\n backend_winit\n backend_winit_x11\n backend_winit_wayland\n backend_linuxkms\n backend_linuxkms_noseat\n renderer_femtovg\n renderer_skia\n renderer_skia_opengl\n renderer_skia_vulkan\n renderer_software\n gettext\n accessibility\n system_testing\n freestanding\n experimental\n}\n\n/// Generate the headers.\n/// `root_dir` is the root directory of the slint git repo\n/// `include_dir` is the output directory\n/// Returns the list of all paths that contain dependencies to the generated output. If you call this\n/// function from build.rs, feed each entry to stdout prefixed with `cargo:rerun-if-changed=`.\npub fn gen_all(\n root_dir: &Path,\n include_dir: &Path,\n enabled_features: EnabledFeatures,\n) -> anyhow::Result> {\n proc_macro2::fallback::force(); // avoid a abort if panic=abort is set\n std::fs::create_dir_all(include_dir).context(\"Could not create the include directory\")?;\n let mut deps = Vec::new();\n enums(include_dir)?;\n builtin_structs(include_dir)?;\n gen_corelib(root_dir, include_dir, &mut deps, enabled_features)?;\n gen_backend_qt(root_dir, include_dir, &mut deps)?;\n gen_platform(root_dir, include_dir, &mut deps)?;\n if enabled_features.testing {\n gen_testing(root_dir, include_dir, &mut deps)?;\n }\n if enabled_features.interpreter {\n gen_interpreter(root_dir, include_dir, &mut deps)?;\n }\n Ok(deps)\n}\n" }, { "path": "api/cpp/cmake/SlintConfig.cmake.in", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n@PACKAGE_INIT@\n\nget_filename_component(_IMPORT_PREFIX \"${CMAKE_CURRENT_LIST_FILE}\" PATH)\nget_filename_component(_IMPORT_PREFIX \"${_IMPORT_PREFIX}\" PATH)\nget_filename_component(_IMPORT_PREFIX \"${_IMPORT_PREFIX}\" PATH)\nget_filename_component(_IMPORT_PREFIX \"${_IMPORT_PREFIX}\" PATH)\nif(_IMPORT_PREFIX STREQUAL \"/\")\n set(_IMPORT_PREFIX \"\")\nendif()\n\nadd_library(@slint_cpp_impl@ @cmake_lib_type@ IMPORTED)\nset_target_properties(@slint_cpp_impl@ PROPERTIES @SLINT_LIB_PROPERTIES@)\n\nfunction(_slint_download_compiler_and_cache)\n set(SLINT_GITHUB_RELEASE \"v@PROJECT_VERSION@\" CACHE STRING \"GitHub Release to use for Slint Binary Artifact Downloads\")\n\n if (CMAKE_HOST_WIN32)\n set(compiler_exe_suffix \".exe\")\n set(platform_suffix \"windows-${CMAKE_HOST_SYSTEM_PROCESSOR}\")\n else()\n set(platform_suffix \"${CMAKE_HOST_SYSTEM_NAME}-${CMAKE_HOST_SYSTEM_PROCESSOR}\")\n endif()\n\n set(prebuilt_archive_filename \"slint-compiler-${platform_suffix}.tar.gz\")\n set(download_url \"https://github.com/slint-ui/slint/releases/download/${SLINT_GITHUB_RELEASE}/${prebuilt_archive_filename}\")\n set(download_directory \"${CMAKE_BINARY_DIR}/slint-prebuilt\")\n message(STATUS \"Downloading pre-built Slint compiler binary from ${download_url}\")\n file(DOWNLOAD \"${download_url}\" \"${download_directory}/${prebuilt_archive_filename}\" STATUS download_status)\n list(GET download_status 0 download_code)\n if (NOT download_code EQUAL 0)\n list(GET download_status 1 download_message)\n message(FATAL_ERROR \"Download of Slint compiler binary package failed: ${download_message}\")\n else()\n file(ARCHIVE_EXTRACT INPUT \"${download_directory}/${prebuilt_archive_filename}\" DESTINATION \"${download_directory}\")\n file(REMOVE \"${download_directory}/${prebuilt_archive_filename}\")\n\n set(SLINT_COMPILER \"${download_directory}/slint-compiler${compiler_exe_suffix}\")\n set(SLINT_COMPILER \"${SLINT_COMPILER}\" CACHE STRING \"Path to the slint-compiler executable\" FORCE)\n set(SLINT_COMPILER \"${SLINT_COMPILER}\" PARENT_SCOPE)\n endif()\nendfunction()\n\nset(SLINT_COMPILER @SLINT_COMPILER@ CACHE STRING \"Path to the slint-compiler executable\")\nif (SLINT_COMPILER)\n if (SLINT_COMPILER STREQUAL \"download\")\n _slint_download_compiler_and_cache(_)\n endif()\n\n add_executable(Slint::slint-compiler IMPORTED GLOBAL)\n set_target_properties(Slint::slint-compiler PROPERTIES IMPORTED_LOCATION ${SLINT_COMPILER})\n include(\"${CMAKE_CURRENT_LIST_DIR}/SlintMacro.cmake\")\nelseif (@SLINT_FEATURE_COMPILER@)\n add_executable(Slint::slint-compiler IMPORTED GLOBAL)\n set_target_properties(Slint::slint-compiler PROPERTIES IMPORTED_LOCATION \"${_IMPORT_PREFIX}/@CMAKE_INSTALL_BINDIR@/@SLINT_COMPILER_FILE_NAME@\")\n include(\"${CMAKE_CURRENT_LIST_DIR}/SlintMacro.cmake\")\nendif()\n\nset(_IMPORT_PREFIX)\n\ninclude(\"${CMAKE_CURRENT_LIST_DIR}/SlintTargets.cmake\")\n\nset(SLINT_STYLE @_SLINT_STYLE@ CACHE STRING \"The Slint widget style\")\nset_property(GLOBAL PROPERTY SLINT_STYLE ${SLINT_STYLE})\n" }, { "path": "api/cpp/cmake/SlintMacro.cmake", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# Set up machinery to handle SLINT_EMBED_RESOURCES target property\nset(DEFAULT_SLINT_EMBED_RESOURCES as-absolute-path CACHE STRING\n \"The default resource embedding option to pass to the Slint compiler\")\nset_property(CACHE DEFAULT_SLINT_EMBED_RESOURCES PROPERTY STRINGS\n \"as-absolute-path\" \"embed-files\" \"embed-for-software-renderer\" \"embed-for-software-renderer-with-sdf\")\n## This requires CMake 3.23 and does not work in 3.26 AFAICT.\n# define_property(TARGET PROPERTY SLINT_EMBED_RESOURCES\n# INITIALIZE_FROM_VARIABLE DEFAULT_SLINT_EMBED_RESOURCES)\n\nfunction(SLINT_TARGET_SOURCES target)\n # Parse the NAMESPACE argument\n cmake_parse_arguments(SLINT_TARGET_SOURCES \"\" \"NAMESPACE;COMPILATION_UNITS\" \"LIBRARY_PATHS\" ${ARGN})\n\n get_target_property(enabled_features Slint::Slint SLINT_ENABLED_FEATURES)\n if (\"EXPERIMENTAL\" IN_LIST enabled_features)\n set(SLINT_COMPILER_ENV ${CMAKE_COMMAND} -E env)\n set(SLINT_COMPILER_ENV ${SLINT_COMPILER_ENV} SLINT_ENABLE_EXPERIMENTAL_FEATURES=1)\n if (\"SYSTEM_TESTING\" IN_LIST enabled_features)\n set(SLINT_COMPILER_ENV ${SLINT_COMPILER_ENV} SLINT_EMIT_DEBUG_INFO=1)\n endif()\n endif()\n\n if (DEFINED SLINT_TARGET_SOURCES_NAMESPACE)\n # Remove the NAMESPACE argument from the list\n list(FIND ARGN \"NAMESPACE\" _index)\n list(REMOVE_AT ARGN ${_index})\n list(FIND ARGN \"${SLINT_TARGET_SOURCES_NAMESPACE}\" _index)\n list(REMOVE_AT ARGN ${_index})\n # If the namespace is not empty, add the --cpp-namespace argument\n set(_SLINT_CPP_NAMESPACE_ARG \"--cpp-namespace=${SLINT_TARGET_SOURCES_NAMESPACE}\")\n endif()\n\n if (DEFINED SLINT_TARGET_SOURCES_COMPILATION_UNITS)\n if (NOT SLINT_TARGET_SOURCES_COMPILATION_UNITS MATCHES \"^[0-9]+$\")\n message(FATAL_ERROR \"Expected number, got '${SLINT_TARGET_SOURCES_COMPILATION_UNITS}' for COMPILATION_UNITS argument\")\n endif()\n set(compilation_units ${SLINT_TARGET_SOURCES_COMPILATION_UNITS})\n else()\n set(compilation_units 1)\n endif()\n\n while (SLINT_TARGET_SOURCES_LIBRARY_PATHS)\n list(POP_FRONT SLINT_TARGET_SOURCES_LIBRARY_PATHS name_and_path)\n list(APPEND _SLINT_CPP_LIBRARY_PATHS_ARG \"-L\")\n list(APPEND _SLINT_CPP_LIBRARY_PATHS_ARG \"${name_and_path}\")\n endwhile()\n\n foreach (it IN ITEMS ${SLINT_TARGET_SOURCES_UNPARSED_ARGUMENTS})\n get_filename_component(_SLINT_BASE_NAME ${it} NAME_WE)\n get_filename_component(_SLINT_ABSOLUTE ${it} REALPATH BASE_DIR ${CMAKE_CURRENT_SOURCE_DIR})\n get_property(_SLINT_STYLE GLOBAL PROPERTY SLINT_STYLE)\n\n set(t_prop \"$>\")\n set(global_fallback \"${DEFAULT_SLINT_EMBED_RESOURCES}\")\n set(embed \"$,${global_fallback},${t_prop}>\")\n\n set(scale_factor_target_prop \"$>\")\n set(scale_factor_arg \"$,,--scale-factor=${scale_factor_target_prop}>\")\n\n set(bundle_translations_prop \"$>\")\n set(bundle_translations_arg \"$,,--bundle-translations=${bundle_translations_prop}>\")\n\n set(translation_domain_prop \"$>\")\n set(translation_domain_arg \"$,${target},${translation_domain_prop}>\")\n\n set(no_default_translation_context_bool \"$>\")\n set(no_default_translation_context_arg \"$\")\n\n if (compilation_units GREATER 0)\n # We need to set this to empty, as this variable is reused in every foreach iteration.\n set(cpp_files \"\")\n foreach(cpp_num RANGE 1 ${compilation_units})\n list(APPEND cpp_files \"${CMAKE_CURRENT_BINARY_DIR}/slint_generated_${_SLINT_BASE_NAME}_${cpp_num}.cpp\")\n endforeach()\n list(TRANSFORM cpp_files PREPEND \"--cpp-file=\" OUTPUT_VARIABLE cpp_files_arg)\n endif()\n\n add_custom_command(\n OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/${_SLINT_BASE_NAME}.h ${cpp_files}\n COMMAND ${SLINT_COMPILER_ENV} $ ${_SLINT_ABSOLUTE}\n -f cpp\n -o ${CMAKE_CURRENT_BINARY_DIR}/${_SLINT_BASE_NAME}.h\n --depfile ${CMAKE_CURRENT_BINARY_DIR}/${_SLINT_BASE_NAME}.d\n --style ${_SLINT_STYLE}\n --embed-resources=${embed}\n --translation-domain=${translation_domain_arg}\n ${no_default_translation_context_arg}\n ${_SLINT_CPP_NAMESPACE_ARG}\n ${_SLINT_CPP_LIBRARY_PATHS_ARG}\n ${scale_factor_arg}\n ${bundle_translations_arg}\n ${cpp_files_arg}\n DEPENDS Slint::slint-compiler ${_SLINT_ABSOLUTE}\n COMMENT \"Generating ${_SLINT_BASE_NAME}.h\"\n DEPFILE ${CMAKE_CURRENT_BINARY_DIR}/${_SLINT_BASE_NAME}.d\n WORKING_DIRECTORY ${CMAKE_BINARY_DIR}\n )\n\n target_sources(${target} PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/${_SLINT_BASE_NAME}.h ${cpp_files})\n endforeach()\n target_include_directories(${target} PUBLIC \"$\")\nendfunction()\n" }, { "path": "api/cpp/docs/_static/theme_tweak.css", "content": ".wy-table-responsive table td, .wy-table-responsive table th {\n white-space: normal;\n}\n\n.wy-table-responsive {\n margin-bottom: 24px;\n max-width: 100%;\n overflow: visible;\n}\n\nimg.logo {\n max-height: 70px;\n border-radius: 12% !important;\n}\n" }, { "path": "api/cpp/docs/_templates/base.html", "content": "{% extends \"!base.html\" %}\n{% block scripts %}\n{{ super() }}\n{% include \"../../../../docs/astro/src/utils/slint-docs-preview.html\" %}\n{% include \"../../../../docs/astro/src/utils/slint-docs-highlight.html\" %}\n{% endblock %}\n" }, { "path": "api/cpp/docs/cmake.md", "content": "\n\n# Set Up Development Environment\n\n## Prerequisites\n\n* A C++ compiler that supports C++20 (e.g., **MSVC 2019 16.6** on Windows)\n\n* **[cmake](https://cmake.org/download/)** (3.21 or newer)\n\n * Slint comes with a CMake integration that automates the compilation step of the `.slint` markup language files and offers a CMake target for convenient linkage.\n\n * *Note*: We recommend using the Ninja generator of CMake for the most efficient build and `.slint` dependency tracking. Install [Ninja](https://ninja-build.org) and select the CMake Ninja backend by passing `-GNinja` or set the `CMAKE_GENERATOR` environment variable to `Ninja`.\n\n## Install Slint\n\nTo install Slint, either download the [binary packages](#install-binary-packages) or [build from sources](#build-from-sources).\n\n*Note*: Binary packages are available for only Linux and Windows on x86-64 architecture. The recommended and most flexible way to use the C++ API is to build Slint from sources.\n\n### Install Binary Packages\n\nThe Slint binary packages work without any Rust development environment.\n\nSteps:\n\n1. Open \n\n2. Click on the latest release\n\n3. From \"Assets\" (\"XXX\" refers to the version of the latest release),\n\n * for Linux x86-64 architecture - download `slint-cpp-XXX-Linux-x86_64.tar.gz`\n * for Windows x86-64 architecture - download `slint-cpp-XXX-win64-MSVC.exe`\n\n4. Unpack the downloaded archive (Linux) or run the installer executable (Windows).\n\n5. Set environment variables\n\n * set `CMAKE_PREFIX_PATH` to the installation directory of Slint. Alternatively you can pass `-DCMAKE_PREFIX_PATH=/path/to/installed/slint` argument when invoking cmake. This helps `find_package(Slint)` to find Slint from within a `CMakeLists.txt` file.\n\n * add the `lib` sub-directory in the installation directory of Slint to `LD_LIBRARY_PATH` (Linux) or to the `PATH` environment variable (Windows). This is necessary to find the Slint libraries when running a Slint program.\n\nIn the next section you will learn how to use the installed library in your application and how to work with `.slint` UI files.\n\n### Build From Sources\n\nFirst you need to install the prerequisites:\n\n* Install Rust by following the [Rust Getting Started Guide](https://www.rust-lang.org/learn/get-started). If you already\n have Rust installed, make sure that it's at least version 1.88 or newer. You can check which version you have installed\n by running `rustc --version`. Once this is done, you should have the `rustc` compiler and the `cargo` build system installed in your path.\n\nYou can either choose to compile Slint from source along with your application or include Slint as an external CMake package.\n\n* To compile Slint along with your application, include Slint into your CMake project using CMake's [`FetchContent`](https://cmake.org/cmake/help/latest/module/FetchContent.html) feature. Insert the following snippet into your `CMakeLists.txt` to make CMake download the latest released 1.x version, compile it, and make the CMake\nintegration available:\n\n```cmake\ninclude(FetchContent)\nFetchContent_Declare(\n Slint\n GIT_REPOSITORY https://github.com/slint-ui/slint.git\n # `release/1` will auto-upgrade to the latest Slint >= 1.0.0 and < 2.0.0\n # `release/1.0` will auto-upgrade to the latest Slint >= 1.0.0 and < 1.1.0\n GIT_TAG release/1\n SOURCE_SUBDIR api/cpp\n)\nFetchContent_MakeAvailable(Slint)\n```\n\n* To include Slint as an external CMake package, build Slint from source like a regular CMake project, install it into a prefix directory of your choice and use `find_package(Slint)` in your `CMakeLists.txt`.\n\n\n### Features\n\nThe Slint library supports a set of features, not all of them enabled by default.\nYou might want to adapt the set of enabled features to optimize your binary\nsize. For example you might want to support only the wayland stack on Linux.\nEnable the `backend-winit-wayland` feature while turning off the\n`backend-winit-x11` feature to do so.\n\nSlint's CMake configuration uses CMake options prefixed with `SLINT_FEATURE_` to\nexpose Slint's feature flags at compile time. To have a wayland-only stack with\nthe CMake setup you would for example use:\n\n `cmake -DSLINT_FEATURE_BACKEND_WINIT=OFF -DSLINT_FEATURE_BACKEND_WINIT_WAYLAND=ON ...`\n\nAlternatively, you can use `cmake-gui` or `ccmake` for a more interactive way\nto discover and toggle features.\n\nThis works when compiling Slint as a package, using `cmake --build` and\n`cmake --install`, or when including Slint using `FetchContent`.\n\nIf you need to check in your application's `CMakeLists.txt` whether a feature is enabled\nor disabled, read the `SLINT_ENABLED_FEATURES` and `SLINT_DISABLED_FEATURES` target\nproperties from the `Slint::Slint` cmake target:\n\n```cmake\nget_target_property(slint_enabled_features Slint::Slint SLINT_ENABLED_FEATURES)\nif (\"BACKEND_WINIT\" IN_LIST slint_enabled_features)\n ...\nendif()\n```\n\nSimilarly, if you need to check for features at compile-time, check for the existence\nof `SLINT_FEATURE_` pre-processor macros:\n\n```\n#include \n\n#if defined(SLINT_FEATURE_BACKEND_WINIT)\n// ...\n#endif\n```\n\n### Rust Flags\n\nSlint uses [Corrosion](https://github.com/corrosion-rs/corrosion) to build Slint, which is developed in Rust. You can utilize [Corrosion's global CMake variables](https://corrosion-rs.github.io/corrosion/usage.html#global-corrosion-options) to control certain aspects of the Rust build process.\n\nFurthermore, you can set the `SLINT_LIBRARY_CARGO_FLAGS` cache variable to specify additional flags for the Slint runtime during the build.\n\n### Platform Backends\n\nIn Slint, a backend is the module that encapsulates the interaction with the operating system,\nin particular the windowing sub-system. Multiple backends can be compiled into Slint and one\nbackend is selected for use at run-time on application start-up. You can configure Slint without\nany built-in backends, and instead develop your own backend by implementing Slint's platform\nabstraction and window adapter interfaces.\n\nFor more information about the available backends, their system requirements, and configuration\noptions, see the {{ '[Backend & Renderers Documentation]({})'.format(slint_href_backends_and_renderers) }}.\n\nBy default Slint will include both the Qt and\n[winit](https://crates.io/crates/winit) back-ends -- if both are detected at\ncompile time. You can enable or disable back-ends using the\n`SLINT_FEATURE_BACKEND_` features. For example, to exclude the winit back-end,\nyou would disable the `SLINT_FEATURE_BACKEND_WINIT` option in your CMake\nproject configuration.\n\n### Cross-compiling\n\nIt's possible to cross-compile Slint to a different target architecture when\nbuilding with CMake. You need to make sure your CMake setup is ready for\ncross-compilation, as documented in the [upstream CMake documentation](https://cmake.org/cmake/help/latest/manual/cmake-toolchains.7.html#cross-compiling).\n\nIf you are building against a Yocto SDK, it is sufficient to source the SDK's environment setup file.\n\nSince Slint is implemented using the Rust programming language, you need to\ndetermine which Rust target matches the target architecture that you're\ncompiling for. Please consult the [upstream Rust documentation](https://doc.rust-lang.org/nightly/rustc/platform-support.html) to find the correct target name. Now you need to install the Rust toolchain:\n\n```sh\nrustup target add \n```\n\nThen you're ready to iconfigure your CMake project you need to add\n`-DRust_CARGO_TARGET=` to the CMake command line.\nThis ensures that the Slint library is built for the correct architecture.\n\nFor example if you are building against an embedded Linux Yocto SDK targeting\nan ARM64 board, the following commands show how to compile:\n\nInstall the Rust target toolchain once:\n\n\n```sh\nrustup target add aarch64-unknown-linux-gnu\n```\n\n\nSet up the environment and build:\n\n\n```sh\n. /path/to/yocto/sdk/environment-setup-cortexa53-crypto-poky-linux\ncd \nmkdir build\ncd build\ncmake -DRust_CARGO_TARGET=aarch64-unknown-linux-gnu -DCMAKE_INSTALL_PREFIX=/slint/install/path ..\ncmake --build .\ncmake --install .\n```\n" }, { "path": "api/cpp/docs/cmake_reference.md", "content": "# CMake Reference\n\n## `slint_target_sources`\n\n```\nslint_target_sources( .... [NAMESPACE namespace] [LIBRARY_PATHS name1=lib1 name2=lib2 ...] [COMPILATION_UNITS num])\n```\n\nUse this function to tell CMake about the .slint files of your application, similar to the builtin cmake [target_sources](https://cmake.org/cmake/help/latest/command/target_sources.html) function.\nThe function takes care of running the slint-compiler to convert `.slint` files to `.h` files in the build directory,\nand extend the include directories of your target so that the generated file is found when including it in your application.\n\nThe optional `NAMESPACE` argument will put the generated components in the given C++ namespace.\n\nUse the `LIBRARY_PATHS` argument to specify the name and paths to {{ '[component libraries]({})'.format(slint_href_ComponentLibraries) }},\nseparated by an equals sign (`=`).\n\nGiven a file called `the_window.slint`, the following example will create a file called `the_window.h` that can\nbe included from your .cpp file. Assuming the `the_window.slint` contains a component `TheWindow`, the output\nC++ class will be put in the namespace `ui`, resulting to `ui::TheWindow`. Any import from `@mycomponentlib/` will\nbe redirected to the specified path.\n\n```cmake\nadd_executable(my_application main.cpp)\ntarget_link_libraries(my_application PRIVATE Slint::Slint)\nslint_target_sources(my_application the_window.slint\n NAMESPACE ui\n LIBRARY_PATHS mycomponentlib=/path/to/customcomponents\n)\n```\n\nBy default, a `.slint` file is compiled to a `.h` file for inclusion in your application's business logic code, and a `.cpp` file with code generated by\nthe slint-compiler. If you want to speed up compilation of the generated `.cpp` file, then you can pass the `COMPILATION_UNITS` argument with a value greater\nthan 1 to create multiple `.cpp` files. These can be compiled in parallel, which might speed up overall build times. However, splitting the generated code\nacross multiple `.cpp` files decreases the compiler's visibility and thus ability to perform optimizations. You can also pass `COMPILATION_UNITS 0` to generate\nonly one single `.h` file.\n\n```{caution}\nCompiling multiple .slint files with the same namespace may create conflicting symbols. Avoid this by putting each .slint file in its own namespace.\n```\n\n## Resource Embedding\n\nBy default, images from {{ '[`@image-url()`]({})'.format(slint_href_ImageType) }} or fonts that your Slint files reference are loaded from disk at run-time. This minimises build times, but requires that the directory structure with the files remains stable. If you want to build a program that runs anywhere, then you can configure the Slint compiler to embed such sources into the binary.\n\nSet the `SLINT_EMBED_RESOURCES` target property on your CMake target to one of the following values:\n\n* `embed-files`: The raw files are embedded in the application binary.\n* `embed-for-software-renderer`: The files will be loaded by the Slint compiler, optimized for use with the software renderer and embedded in the application binary.\n* `embed-for-software-renderer-with-sdf`: Same as `embed-for-software-renderer`, but use [Signed Distance Fields (SDF)](https://en.wikipedia.org/wiki/Signed_distance_function) to render fonts.\n This produces smaller binaries, but may result in slightly inferior visual output and slower rendering.\n (Requires the `SLINT_FEATURE_SDF_FONTS` feature to be enabled.)\n* `as-absolute-path`: The paths of files are made absolute and will be used at run-time to load the resources from the file system. This is the default.\n\nThis target property is initialised from the global `DEFAULT_SLINT_EMBED_RESOURCES` cache variable. Set it to configure the default for all CMake targets.\n\n```cmake\n# Example: when building my_application, specify that the compiler should embed the resources in the binary\nset_property(TARGET my_application PROPERTY SLINT_EMBED_RESOURCES embed-files)\n```\n\n## Scale Factor for Microcontrollers\n\nWhen targeting a Microcontroller, there exists no windowing system that provides a device pixel ratio to\nmap logical lengths in Slint (`px`) to physical pixels (`phx`). If desired, you can provide this ratio at\ncompile time by setting the `SLINT_SCALE_FACTOR` target property on your CMake target.\n\n```cmake\n# Example: when building my_application, specify that the scale factor shall be 2\nset_property(TARGET my_application PROPERTY SLINT_SCALE_FACTOR 2.0)\n```\n\nA scale factor specified this way will also be used to pre-scale images and glyphs when used in combination\nwith [Resource Embedding](#resource-embedding).\n\n## Bundle Translations\n\nTranslations can either be done using `gettext` at runtime, or by bundling all the translated strings\ndirectly into the binary, by embedding them in the generated C++ code.\nIf you want to bundle translations, you need to set the `SLINT_BUNDLE_TRANSLATIONS` target property\nto point to a directory containing translations. The translations must be in the gettext `.po` format.\n\nIn the following example, the translation files will be bundled from `lang//LC_MESSAGES/my_application.po`\n\n```cmake\nset_property(TARGET my_application PROPERTY SLINT_BUNDLE_TRANSLATIONS \"${CMAKE_CURRENT_SOURCE_DIR}/lang\")\n```\n\n## Translation Domain\n\nBy default, the domain used for translations is the name of the CMake target the `.slint` files are targeted with.\nUse the `SLINT_TRANSLATION_DOMAIN` target property to override this and use the specified value as domain, instead.\nThis is useful in build environments where the target name is given and not suitable, such as esp-idf.\n\n## Disable Default Translation Context\n\nUnless explicitly specified with the `@tr(\"context\" => ...)`, the default translation context is the component name.\nSet the `SLINT_NO_DEFAULT_TRANSLATION_CONTEXT` target property to disable the default translation context.\nWhen doing that, the `--no-default-translation-context` flag must be passed to `slint-tr-extractor`.\n" }, { "path": "api/cpp/docs/conf.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Software-3.0\n\n# Configuration file for the Sphinx documentation builder.\n#\n# This file only contains a selection of the most common options. For a full\n# list see the documentation:\n# https://www.sphinx-doc.org/en/master/usage/configuration.html\n\n# -- Path setup --------------------------------------------------------------\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\n# import sys\n# sys.path.insert(0, os.path.abspath('.'))\nimport textwrap\nimport os\nimport json\n\n\n# -- Project information -----------------------------------------------------\n\n# The full version, including alpha/beta/rc tags\nversion = \"1.16.0\"\n\nproject = f\"Slint {version} C++ API\"\ncopyright = \"SixtyFPS GmbH\"\nauthor = \"Slint Developers \"\n\ncpp_index_common_prefix = [\"slint::\", \"slint::interpreter::\"]\n\n# -- General configuration ---------------------------------------------------\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = [\n \"breathe\",\n \"myst_parser\",\n \"exhale\",\n \"sphinx_markdown_tables\",\n \"sphinxcontrib.jquery\",\n]\n\nbreathe_projects = {\"Slint\": \"./docs/xml\"}\nbreathe_default_project = \"Slint\"\n\nexhale_args = {\n \"containmentFolder\": \"./api\",\n \"rootFileName\": \"library_root.rst\",\n \"rootFileTitle\": \"C++ API Reference\",\n \"afterTitleDescription\": textwrap.dedent(\n \"\"\"\n The following sections present the C++ API Reference. All types are\n within the :ref:`slint` namespace and are accessible by including\n the :code:`slint.h` header file.\n\n If you choose to load :code:`.slint` files dynamically at run-time, then\n you can use the classes in :ref:`slint::interpreter`, starting at\n :cpp:class:`slint::interpreter::ComponentCompiler`. You need to include\n the :code:`slint-interpreter.h` header file.\n \"\"\"\n ),\n \"doxygenStripFromPath\": \"..\",\n \"createTreeView\": True,\n \"kindsWithContentsDirectives\": [],\n \"exhaleExecutesDoxygen\": True,\n \"exhaleDoxygenStdin\": \"\"\"INPUT = ../../api/cpp/include generated_include\nEXCLUDE_SYMBOLS = slint::cbindgen_private* slint::private_api* vtable* SLINT_DECL_ITEM\nEXCLUDE = ../../api/cpp/include/vtable.h ../../api/cpp/include/slint_tests_helper.h ../../api/cpp/include/slint-stm32.h\nENABLE_PREPROCESSING = YES\nPREDEFINED += DOXYGEN\nINCLUDE_PATH = generated_include\nWARN_AS_ERROR = YES\"\"\",\n}\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This pattern also affects html_static_path and html_extra_path.\nexclude_patterns = [\n \"_build\",\n \"html/_static/collapsible-lists/LICENSE.md\",\n \"Thumbs.db\",\n \".DS_Store\",\n \"markdown/tutorial\",\n \"markdown/building.md\",\n \"markdown/development.md\",\n \"markdown/install_qt.md\",\n \"markdown/README.md\",\n \"README.md\",\n]\n\n\n# -- Options for HTML output -------------------------------------------------\n\n# The theme to use for HTML and HTML Help pages. See the documentation for\n# a list of builtin themes.\n#\nhtml_theme = \"furo\"\n\nhtml_theme_options = {\"collapse_navigation\": False}\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = [\"_static\"]\n\nhtml_show_sourcelink = False\n\nhtml_logo = \"https://slint.dev/logo/slint-logo-small-light.svg\"\n\nmyst_enable_extensions = [\"html_image\", \"colon_fence\", \"substitution\"]\n\n# Annotate h1/h2 elements with anchors\nmyst_heading_anchors = 2\n\nmyst_url_schemes = {\n \"slint-reference\": f\"https://slint.dev/releases/{version}/docs/slint/{{{{path}}}}\",\n \"http\": None,\n \"https\": None,\n \"mailto\": None,\n}\n\nrst_epilog = \"\"\n\nmyst_substitutions = {}\n\nwith open(\n os.path.join(\n os.path.dirname(__file__),\n \"..\",\n \"..\",\n \"internal\",\n \"core-macros\",\n \"link-data.json\",\n )\n) as link_data:\n links = json.load(link_data)\n\nfor key in links.keys():\n href = links[key][\"href\"]\n url = f\"https://slint.dev/releases/{version}/docs/slint/{href}\"\n myst_substitutions[f\"slint_href_{key}\"] = url\n rst_epilog += f\".. |{key}| replace:: :code:`{key}`\\n\"\n rst_epilog += f\".. _{key}: {url}\\n\"\n\n\ndef setup(app):\n app.add_css_file(\"theme_tweak.css\")\n" }, { "path": "api/cpp/docs/generated_code.md", "content": "# Generated Code\n\nThe Slint compiler [called by the build system](cmake_reference.md#slint_target_sources)\nwill generate a header file for the root `.slint` file.\n\nThis header file will contain a `class` for every exported component from the main file that inherits from `Window` or `Dialog`.\n\nThese classes have the same name as the component will have the following public member functions:\n\n* A `create` constructor function and a destructor.\n* A `show` function, which will show the component on the screen.\n You still need to spin the event loop by {cpp:func}`slint::run_event_loop()`\n or using the convenience `run` function in this class to render and react to\n user input!\n* A `hide` function, which de-registers the component from the windowing system.\n* A `window` function that provides access to the {cpp:class}`slint::Window`,\n to allow for further customization towards the windowing system.\n* A `run` convenience function, which will show the component and starts the\n event loop.\n* For each property:\n * A getter `get_` returning the property type.\n * A setter `set_` taking the new value of the property by\n const reference\n* For each callback:\n * `invoke_` function which takes the callback argument as parameter and call the callback.\n * `on_` function which takes a functor as an argument and sets the callback handler\n for this callback. the functor must accept the type parameter of the callback\n* For each public function declared in the root component, an `invoke_` function to call the function.\n* A `global` function to access exported global singletons.\n\nThe `create` function creates a new instance of the component, which is wrapped\nin {cpp:class}`slint::ComponentHandle`. This is a smart pointer that owns the\nactual instance and keeps it alive as long as at least one\n{cpp:class}`slint::ComponentHandle` is in scope, similar to `std::shared_ptr`.\n\nFor more complex user interfaces it's common to supply data in the form of an\nabstract data model, that's used with {{ '[`for` - `in`]({})'.format(slint_href_Models) }}\nrepetitions or {{ '[ListView]({})'.format(slint_href_ListView) }} elements in the\n`.slint` language. All models in C++ are sub-classes of the\n{cpp:class}`slint::Model` and you can sub-class it yourself. For convenience,\nthe {cpp:class}`slint::VectorModel` provides an implementation that's backed\nby a `std::vector`.\n\n## Example\n\nLet's assume we've this code in our `.slint` file:\n\n```slint,no-preview\nexport component SampleComponent inherits Window {\n in-out property counter;\n // note that dashes will be replaced by underscores in the generated code\n in-out property user_name;\n callback hello;\n public function do-something(x: int) -> bool { return x > 0; }\n // ... maybe more elements here\n}\n\n```\n\nThis generates a header with the following contents (edited for documentation purpose)\n\n```cpp\n#include \n#include \n#include \n\n\nclass SampleComponent {\npublic:\n /// Constructor function\n inline auto create () -> slint::ComponentHandle;\n /// Destructor\n inline ~SampleComponent ();\n\n /// Show this component, and runs the event loop\n inline void run () const;\n\n /// Show the window that renders this component. Call `slint::run_event_loop()`\n /// to continuously render the contents and react to user input.\n inline void show () const;\n\n /// Hide the window that renders this component.\n inline void hide () const;\n\n /// Getter for the `counter` property\n inline int get_counter () const;\n /// Setter for the `counter` property\n inline void set_counter (const int &value) const;\n\n /// Getter for the `user_name` property\n inline slint::SharedString get_user_name () const;\n /// Setter for the `user_name` property\n inline void set_user_name (const slint::SharedString &value) const;\n\n /// Call this function to call the `hello` callback\n inline void invoke_hello () const;\n /// Sets the callback handler for the `hello` callback.\n template inline void on_hello (Functor && callback_handler) const;\n\n /// Call this function to call the `do-something` function.\n inline bool invoke_do_something (int x) const;\n\n /// Returns a reference to a global singleton that's exported.\n ///\n /// **Note:** Only globals that are exported or re-exported from the main .slint file will\n /// be exposed in the API\n inline template\n const T &global() const;\n\nprivate:\n /// private fields omitted\n};\n```\n\n## Global Singletons\n\nYou can declare globally available singletons in your\n`.slint` files. If exported, these singletons are available via the\n`global()` getter function on the generated C++ class. Each global singleton\nmaps to a class with getter/setter functions for properties and callbacks,\nsimilar to API that's created for your `.slint` component.\n\nFor example the following `.slint` markup defines a global `Logic` singleton that's also exported:\n\n```slint,ignore\nexport global Logic {\n callback to_uppercase(string) -> string;\n}\n```\n\nAssuming this global is used together with the `SampleComponent` from the\nprevious section, you can access `Logic` like this:\n\n```cpp\n auto app = SampleComponent::create();\n // ...\n app->global().on_to_uppercase([](SharedString str) -> SharedString {\n std::string arg(str);\n std::transform(arg.begin(), arg.end(), arg.begin(), toupper);\n return SharedString(arg);\n });\n```\n\n:::{note}\nGlobal singletons are instantiated once per component. When declaring multiple components for `export` to C++,\neach instance will have their own instance of associated globals singletons.\n:::\n" }, { "path": "api/cpp/docs/genindex.rst", "content": ".. Copyright © SixtyFPS GmbH \n.. SPDX-License-Identifier: MIT\n\n===========\nIndex (C++)\n===========\n" }, { "path": "api/cpp/docs/getting_started.md", "content": "# Getting Started\n\nOnce Slint is built, you can use it in your CMake application or library\ntarget in two steps:\n\n1. Associate the `.slint` files that you'd like to use by calling the\n `slint_target_sources` CMake command. The first parameter is\n your application (or library) build target, and the parameters following are\n the names of the `.slint` files you want to include. This will compile\n the `.slint` files to C++ source code and included that into your\n built target.\n2. The generated C++ source code needs the Slint run-time library. Use\n `target_link_libraries` to link your build target to `Slint::Slint`.\n\nA minimal CMake `CMakeLists.txt` file looks like this:\n\n```cmake\ncmake_minimum_required(VERSION 3.21)\nproject(my_application LANGUAGES CXX)\n\n# Note: Use find_package(Slint) instead of the following three commands,\n# if you prefer the package approach.\ninclude(FetchContent)\nFetchContent_Declare(\n Slint\n GIT_REPOSITORY https://github.com/slint-ui/slint.git\n # `release/1` will auto-upgrade to the latest Slint >= 1.0.0 and < 2.0.0\n # `release/1.0` will auto-upgrade to the latest Slint >= 1.0.0 and < 1.1.0\n GIT_TAG release/1\n SOURCE_SUBDIR api/cpp\n)\nFetchContent_MakeAvailable(Slint)\n\nadd_executable(my_application main.cpp)\nslint_target_sources(my_application my_application_ui.slint)\ntarget_link_libraries(my_application PRIVATE Slint::Slint)\n# On Windows, copy the Slint DLL next to the application binary so that it's found.\nif (WIN32)\n add_custom_command(TARGET my_application POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy $ $ COMMAND_EXPAND_LISTS)\nendif()\n```\n\nSuppose `my_application_ui.slint` was a \"Hello World\" like this:\n\n```slint,no-preview\nexport component HelloWorld inherits Window {\n width: 400px;\n height: 400px;\n\n // Declare an alias that exposes the label's text property to C++\n in property my_label <=> label.text;\n\n label := Text {\n y: parent.width / 2;\n x: parent.x + 200px;\n text: \"Hello, world\";\n color: blue;\n }\n}\n```\n\nthen you can use the following code in your `main` function to show the [`Window`](../slint/src/language/builtins/elements#window)\nand change the text:\n\n```cpp\n#include \"my_application_ui.h\"\n\nint main(int argc, char **argv)\n{\n auto hello_world = HelloWorld::create();\n hello_world->set_my_label(\"Hello from C++\");\n // Show the window and spin the event loop until the window is closed.\n hello_world->run();\n return 0;\n}\n```\n\nThis works because the Slint compiler translated `my_application_ui.slint` to C++ code, in the `my_application_ui.h`\nheader file. That generated code contains a C++ class that corresponds to the `HelloWorld` element and has API to create\nthe UI, read or write properties, and set callbacks. You can learn more about how this API looks like in general in the\n[](generated_code.md) section.\n\n## Tutorial\n\nFor an in-depth walk-through, read our Slint Memory Game Tutorial.\nIt will guide you through the `.slint` mark-up language and the C++ API by building a simple memory\ngame.\n\n## Template\n\nYou can check out the [Slint C++ Template](https://github.com/slint-ui/slint-cpp-template) with\nthe code of a minimal C++ application using Slint. It provides a convenient starting point to a new program.\n\nOf course you can also read on: We will cover some recipes to handle common\nuse-cases next.\n" }, { "path": "api/cpp/docs/index.rst", "content": ".. Copyright © SixtyFPS GmbH \n.. SPDX-License-Identifier: MIT\n\n.. Slint C++ documentation master file\n\nSlint C++ documentation\n========================================\n\n.. toctree::\n :maxdepth: 2\n :hidden:\n :caption: Getting Started On Desktop\n\n cmake.md\n\n First Steps \n\n live_preview.md\n\n.. toctree::\n :maxdepth: 2\n :hidden:\n :caption: Getting Started on MCU\n\n mcu/intro.md\n mcu/esp_idf.md\n mcu/stm32.md\n mcu/generic.md\n\n.. toctree::\n :maxdepth: 2\n :hidden:\n :caption: C++ / .slint Integration\n\n Overview \n\n Type Mapping to C++ \n\n Example Generated Code \n\n.. toctree::\n :maxdepth: 2\n :hidden:\n :caption: Reference\n\n api/library_root\n\n cmake_reference.md\n\n genindex\n\n.. toctree::\n :maxdepth: 0\n :hidden:\n :caption: Third-Party Licenses\n\n thirdparty.md\n\n.. image:: https://github.com/slint-ui/slint/workflows/CI/badge.svg\n :target: https://github.com/slint-ui/slint/actions\n :alt: GitHub CI Build Status\n\n.. image:: https://img.shields.io/github/discussions/slint-ui/slint\n :target: https://github.com/slint-ui/slint/discussions\n :alt: GitHub Discussions\n\n`Slint `_ is a toolkit to efficiently develop fluid graphical user interfaces for any display: embedded devices and desktop applications.\nSlint C++ is the C++ API to interact with a Slint UI from C++.\n\nThe .slint Markup Language\n=======================\n\nSlint comes with a markup language that is specifically designed for user interfaces. This language provides a\npowerful way to describe graphical elements, their placement, and the flow of data through the different states. It is a familiar syntax to describe the hierarchy\nof elements and property bindings. Here's the obligatory \"Hello World\":\n\n.. code-block:: slint,ignore\n\n export component HelloWorld inherits Window {\n width: 400px;\n height: 400px;\n\n Text {\n y: parent.width / 2;\n x: parent.x + 200px;\n text: \"Hello, world\";\n color: blue;\n }\n }\n\nCheck out the `Slint Language Documentation <../slint>`_ for more details.\n\nArchitecture\n============\n\nAn application is composed of the business logic written in C++ and the `.slint` user interface design markup, which\nis compiled to native code.\n\n.. image:: https://slint.dev/resources/architecture.drawio.svg\n :alt: Architecture Overview\n\nDeveloping\n==========\n\nYou can create and edit `.slint` files using our `Slint Visual Studio Code Extension `_,\nwhich features syntax highlighting and live design preview.\n\nFor a quick edit and preview cycle, you can also use the :code:`slint-viewer` command line tool, which can be installed using :code:`cargo install slint-viewer`,\nif you have `Cargo `_ installed.\n\nIn the next section you will learn how to install the Slint C++ library and the CMake build system integration.\n" }, { "path": "api/cpp/docs/live_preview.md", "content": "\n\n# Live-Preview\n\n`.slint` files are compiled to C++ code when using the [`slint_target_sources()`](cmake_reference.md#slint_target_sources) function.\nThis is the default and recommended for release builds.\n\nDuring debugging and development, changes to `.slint` files requires re-compiling and re-starting the application. To speed up\nmodifications to the UI while connected to the applications' business logic, you can opt into enabling Live-Preview for C++:\n\n1. Compile Slint [from sources](cmake.md#build-from-sources). At the configure step, enable the `SLINT_FEATURE_LIVE_PREVIEW` cmake option.\n2. When compiling your application, set the `SLINT_LIVE_PREVIEW=1` environment variable.\n3. Start you application. The Slint run-time library will load and reload `.slint` files after you've modified them on disk.\n" }, { "path": "api/cpp/docs/mcu/esp-idf/troubleshoot.md", "content": "\n# Troubleshooting\n\nYou may run into compile or run-time issues due to Slint's requirements. The following sections\ntrack issues we're aware of and how to solve them.\n\n## Rust Compilation Error During Slint Build\n\nYou see the following error:\n\n```\nerror: the `-Z` flag is only accepted on the nightly channel of Cargo, but this is the `stable` channel\n```\n\nSolution: You need to configure your Rust toolchain to use the esp channel. Either set the `RUSTUP_TOOLCHAIN` environment variable to the value `esp` or create a file called `rust-toolchain.toml` in your project directory with the following contents:\n```toml\n[toolchain]\nchannel = \"esp\"\n```\n\n\n## The device crashes at boot or enter a boot loop\n\nOne reason could be that you don't have enough ram for the heap or the stack.\nMake sure that the stack is big enough (~8KiB), and that all the RAM was made available for the heap allocator.\n\n## Wrong colors shown\n\nIf colors look inverted on your display, it may be an incompatibility between how RGB565 colors are ordered in little-endian\nand your display expecting a different byte order. Typically, esp32 devices are little ending and display controllers often\nexpect big-endian or `esp_lcd` configures them accordingly. Therefore, by default Slint converts pixels to big-endian.\nIf your display controller expects little endian, set the `byte_swap` field in `SlintPlatformConfiguration` to `false`.\n\n## Errors about multiple symbol definitions when linking\n\nYou see errors at application link time such as these:\n\n```\ncompiler_builtins.4c2482f45199cb1e-cgu.05:(.text.__udivdi3+0x0): multiple definition of `__udivdi3'; .../libgcc.a(_udivdi3.o): first defined here\n```\n\nSolution: Add `-Wl,--allow-multiple-definition` to your linker flags by using the following cmake command:\n\n```cmake\ntarget_link_options(${COMPONENT_LIB} PUBLIC -Wl,--allow-multiple-definition)\n```\n" }, { "path": "api/cpp/docs/mcu/esp_idf.md", "content": "\n# Espressif's IoT Development Framework\n\nSlint provides a [component](https://components.espressif.com/components/slint/slint) for the [Espressif IoT Development Framework](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/index.html).\n\nIt has been tested on ESP32-S3 devices.\n\n## Prerequisites\n\n* Install the [Espressif IoT Development Framework](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/index.html) and open a terminal or command prompt with the environment set up.\nOn Windows, follow the [Using the Command Prompt](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/windows-setup.html#using-the-command-prompt) instructions, on macOS and Linux, follow the\n[Set up the Environment Variables](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/linux-macos-setup.html#step-4-set-up-the-environment-variables) instructions.\n\nBy default, Slint will use pre-compiled binaries. If for some reason there are no binaries available, the build will fall back to compiling Slint from source and you need to have [Rust installed](https://esp-rs.github.io/book/installation/rust.html installed) as well as the [Rust toolchains for Espressif SoCs with Xtensa and RISC-V targets](https://esp-rs.github.io/book/installation/riscv-and-xtensa.html).\n\n## First Steps\n\nThe following steps will guide from the a bare-bones esp-idf \"hello_world\" to a GUI with Slint.\n\n1. Start by creating a new project:\n```bash\nidf.py create-project slint-hello-world\ncd slint-hello-world\n```\n2. Select your chipset with `idf.py set-target`, for example if you're using an `ESP32S3` chipset, run\n```bash\nidf.py set-target esp32s3\n```\n3. Add a [Board Support Package](https://github.com/espressif/esp-bsp#esp-bsp-espressifs-board-support-packages) that matches your device as a dependency. For example, if you're using an ESP-BOX, run\n```bash\nidf.py add-dependency esp-box\n```\n4. Add Slint as a dependency:\n```bash\nidf.py add-dependency slint/slint\n```\n5. Remove `main/slint-hello-world.c`.\n6. Create a new file `main/slint-hello-world.cpp` with the following contents:\n```cpp\n#include \n#include \n#include \n#include \n#include \n#include \n\n#if defined(BSP_LCD_DRAW_BUFF_SIZE)\n# define DRAW_BUF_SIZE BSP_LCD_DRAW_BUFF_SIZE\n#else\n# define DRAW_BUF_SIZE (BSP_LCD_H_RES * CONFIG_BSP_LCD_DRAW_BUF_HEIGHT)\n#endif\n\n#include \"app-window.h\"\n\nextern \"C\" void app_main(void)\n{\n /* Initialize display */\n esp_lcd_panel_io_handle_t io_handle = NULL;\n esp_lcd_panel_handle_t panel_handle = NULL;\n const bsp_display_config_t bsp_disp_cfg = {\n .max_transfer_sz = DRAW_BUF_SIZE * sizeof(uint16_t),\n };\n bsp_display_new(&bsp_disp_cfg, &panel_handle, &io_handle);\n\n /* Set display brightness to 100% */\n bsp_display_backlight_on();\n\n /* Initialize touch */\n esp_lcd_touch_handle_t touch_handle = NULL;\n const bsp_touch_config_t bsp_touch_cfg = {};\n bsp_touch_new(&bsp_touch_cfg, &touch_handle);\n\n /* Allocate a drawing buffer */\n static std::vector buffer(BSP_LCD_H_RES * BSP_LCD_V_RES);\n\n /* Initialize Slint's ESP platform support*/\n slint_esp_init(SlintPlatformConfiguration {\n .size = slint::PhysicalSize({ BSP_LCD_H_RES, BSP_LCD_V_RES }),\n .panel_handle = panel_handle,\n .touch_handle = touch_handle,\n .buffer1 = buffer,\n .byte_swap = true });\n\n /* Instantiate the UI */\n auto ui = AppWindow::create();\n /* Show it on the screen and run the event loop */\n ui->run();\n}\n```\n7. Create `main/app-window.slint` with the following contents:\n```\nimport { VerticalBox, AboutSlint } from \"std-widgets.slint\";\nexport component AppWindow inherits Window {\n VerticalBox {\n AboutSlint {}\n Text {\n text: \"Hello World\";\n font-size: 18px;\n horizontal-alignment: center;\n }\n }\n}\n```\n8. Edit `main/CMakeLists.txt` to adjust for the new `slint-hello-world.cpp`, add `slint` as required component,\n and instruction the build system to compile `app-window.slint` to `app-window.h`. The file should look like this:\n```cmake\nidf_component_register(SRCS \"slint-hello-world.cpp\" INCLUDE_DIRS \".\" REQUIRES slint)\nslint_target_sources(${COMPONENT_LIB} app-window.slint)\n```\n9. Open the configuration editor with `idf.py menuconfig`:\n * Change the stack size under `Component config --> ESP System Settings --> Main task stack size` to at least `8192`. You may need to tweak this value in the future if you run into stack overflows.\n * You may need additional device-specific settings. For example if your device has external SPI RAM,\n you may need to enable that. For details for ESP32-S3 based devices see how to [Configure the PSRAM](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/api-guides/flash_psram_config.html#configure-the-psram).\n * Quit the editor with `Q` and save the configuration.\n\n Alternatively, check in a default sdkconfig tweaked from your board that adds the right amount of ram, flash, and use `CONFIG_MAIN_TASK_STACK_SIZE=8192`\n\n10. Build the project with `idf.py build`.\n11. Connect your device, then flash and run it with `idf.py flash monitor`.\n12. Observe Slint rendering \"Hello World\" on the screen 🎉.\n\nCongratulations, you're all set up to develop with Slint.\n\n## Next Steps\n\n - For more details about the Slint language, check out the [Slint Language Documentation](slint-reference:).\n - Learn about the [](../types.md) between Slint and C++.\n - Study the [](../api/library_root).\n\n```{toctree}\n:maxdepth: 2\n:hidden:\n:caption: Espressif's IoT Development Framework\n\nesp-idf/troubleshoot.md\n```\n" }, { "path": "api/cpp/docs/mcu/generic.md", "content": "\n# Generic MCU Environment Setup\n\nWe aim to support many different MCUs and their respective software development environments.\nFor those environments where we can't provide an out-of-the-box integration, we provide the\nfollowing generic instructions on what's needed to compile and use Slint.\n\n## Prerequisites\n\n* Install Rust by following the [Rust Getting Started Guide](https://www.rust-lang.org/learn/get-started). If you already\n have Rust installed, make sure that it's at least version 1.88 or newer. You can check which version you have installed\n by running `rustc --version`. Once this is done, you should have the `rustc` compiler and the `cargo` build system installed in your path.\n\n* A C++ cross-compiler compiler that supports C++20.\n\n* **[cmake](https://cmake.org/download/)** (3.21 or newer)\n\n * Slint comes with a CMake integration that automates the compilation step of the `.slint` markup language files and offers a CMake target for convenient linkage.\n\n * *Note*: We recommend using the Ninja generator of CMake for the most efficient build and `.slint` dependency tracking. Install [Ninja](https://ninja-build.org) and select the CMake Ninja backend by passing `-GNinja` or set the `CMAKE_GENERATOR` environment variable to `Ninja`.\n\n * A build environment for [cross-compilation with CMake](https://cmake.org/cmake/help/latest/manual/cmake-toolchains.7.html#cross-compiling), such as a toolchain file.\n\n## Compiling Slint\n\nTo target an MCU environment, all of the following additional CMake configuration options must be set when compiling Slint:\n\n| Option | Description |\n|---------------------------------------------------------------|----------------------------------------------------------------------|\n| `-DSLINT_FEATURE_FREESTANDING=ON` | Enables building for environments without a standard library. |\n| `-DBUILD_SHARED_LIBS=OFF` | Disables shared library support and instead builds Slint statically. |\n| `-DSLINT_FEATURE_RENDERER_SOFTWARE=ON` | Enable support for the software renderer. |\n| `-DDEFAULT_SLINT_EMBED_RESOURCES=embed-for-software-renderer` | Default to pre-compiling images and fonts. |\n\n\nFor example, if you're targeting an MCU with a ARM Cortex-M processor, the complete command line for CMake could look like this:\n\n```sh\ncmake -DRust_CARGO_TARGET=thumbv7em-none-eabihf -DSLINT_FEATURE_FREESTANDING=ON\n -DBUILD_SHARED_LIBS=OFF -DSLINT_FEATURE_RENDERER_SOFTWARE=ON\n -DDEFAULT_SLINT_EMBED_RESOURCES=embed-for-software-renderer\n ..\n```\n\n## Next Steps\n\n - Check out the [](../getting_started.md) instructions for a generic \"Hello World\" with C++.\n - Study the [](../api/library_root), in particular the `slint::platform` namespace for\n writing a Slint platform integration to handle touch input and render pixel, which you\n need to forward to your MCU's display driver.\n - For more details about the Slint language, check out the [Slint Language Documentation](slint-reference:).\n - Learn about the [](../types.md) between Slint and C++.\n" }, { "path": "api/cpp/docs/mcu/intro.md", "content": "\n# Introduction\n\nMicrocontrollers (MCUs) are highly customizable and each vendor typically provides their own development\nenvironment and toolchain. Slint aims to support any MCU provided the SDK supports a C++ 20 cross-compiler\nas well as CMake as build system.\n\nThis documentation is divided into three sub-sections:\n\n - [ESP-IDF section](esp_idf.md), when targeting MCUs with Espressif's IoT Development Framework\n - [STM32 section](stm32.md), when targeting MCUs in STMicroelectronics' STM32Cube Ecosystem.\n - [Generic section](generic.md), providing an overview how to use Slint with other MCUs.\n" }, { "path": "api/cpp/docs/mcu/stm32/generic.md", "content": "\n# Generic Instructions for Slint on STM32 MCUs\n\nThe following instructions outline a rough, general path how to get started on an STM32 MCU\nwith STM32 Cube tooling and Slint. Successful completion requires experience with STM32CubeMX\nas well as the peripherals of our board.\n\n1. Make sure to install all the .\n2. Start a new project with STM32CubeMX:\n - Select your base board.\n - Enable all peripherals needed. This includes LTDC and typically the FMC to be able\n to place the framebuffers in RAM.\n - Select CMake in the code generator options.\n3. Generate the CMake project and skeleton code.\n4. In the STM32 VS Code Extension, choose the command to import a CMake project.\n5. In STM32CubeMX select the STM32Cube BSP that matches your board and install it.\n6. Copy the BSP drivers into your project's source tree and modify `CMakeLists.txt` to\n add them to the build.\n7. Add C++ support to the generated CMake project by adding `CXX` to the `LANGUAGES` option\n of the `project` command.\n8. Open a web browser, navigate to , and download\n and extract `Slint-cpp-VERSION-thumbv7em-none-eabihf.tar.gz`, replace `VERSION` with the version you see.\n10. Set `CMAKE_PREFIX_PATH` to the extracted directory.\n11. Add a C++ source file to your project, for example `appmain.cpp`, with an `appmain` function and call it\n from the generated `main.c`.\n12. Create `app-window.slint` with the following contents:\n ```slint,no-preview\n import { VerticalBox, AboutSlint } from \"std-widgets.slint\";\n export component AppWindow inherits Window {\n VerticalBox {\n AboutSlint {}\n Text {\n text: \"Hello World\";\n font-size: 18px;\n horizontal-alignment: center;\n }\n }\n }\n ```\n13. Adjust your `CMakeLists.txt` for use of Slint. Copy the follow snippets and adjust the target names as needed:\n ```cmake\n # Locate Slint\n find_package(Slint)\n\n # Compile app-window.slint to app-window.h and app-window.cpp\n slint_target_sources(your-target app-window.slint)\n\n # Embed images and fonts in the binary\n set_target_properties(your-target PROPERTIES SLINT_EMBED_RESOURCES embed-for-software-renderer)\n\n # Replace $BSP_NAME with the name of your concrete BSP,\n # for example stm32h735g_discovery.\n target_compile_definitions(your-target PRIVATE\n SLINT_STM32_BSP_NAME=$BSP_NAME\n )\n\n # Link Slint run-time library\n target_link_libraries(your-target PRIVATE\n Slint::Slint\n )\n ```\n14. In your `appmain` function, initialize the screen via `BSP_LCD_InitEx` as well as the touch screen via `BSP_TS_Init`,\n include `#include ` and call `slint_stm32_init(SlintPlatformConfiguration());` to initialize the\n Slint platform integration for STM32. Finally, include the header file for your `.slint` file, instantiate the generated class, and invoke the event loop by calling `->run()` on the instance. Use the following example as reference:\n ```cpp\n #include \n #include \n #include \n #include \n #include \n\n #include \"app-window.h\"\n\n // Called from main()\n extern \"C\" void appmain() {\n if (BSP_LCD_InitEx(0, LCD_ORIENTATION_LANDSCAPE, LCD_PIXEL_FORMAT_RGB565,\n LCD_DEFAULT_WIDTH, LCD_DEFAULT_HEIGHT) != 0) {\n Error_Handler();\n }\n\n BSP_LCD_DisplayOn(0);\n BSP_LCD_SetActiveLayer(0, 0);\n\n TS_Init_t hTS;\n hTS.Width = LCD_DEFAULT_WIDTH;\n hTS.Height = LCD_DEFAULT_HEIGHT;\n hTS.Orientation = TS_SWAP_XY;\n hTS.Accuracy = 0;\n /* Touchscreen initialization */\n if (BSP_TS_Init(0, &hTS) != 0) {\n Error_Handler();\n }\n\n slint_stm32_init(SlintPlatformConfiguration());\n\n auto app_window = AppWindow::create();\n\n app_window->run();\n\n return 0;\n }\n ```\n\n\n" }, { "path": "api/cpp/docs/mcu/stm32.md", "content": "\n# STMicroelectronics' STM32Cube Ecosystem\n\nSlint provides a platform integration with into STMicroelectronics' (STM) STM32Cube software platform.\nIt uses the `BSP_TS` APIs to retrieve touch input and uses the `BSP_LCD` and `HAL_LTDC` APIs to render\nto the screen with double-buffering.\n\n## Prerequisites\n\nTo build a C++ application with Slint for STM32 MCUs, install the following tools:\n\n * **[cmake](https://cmake.org/download/)** (3.21 or newer)\n * **[STM32CubeCLT](https://www.st.com/en/development-tools/stm32cubeclt.html)**\n * **[Visual Studio Code](https://code.visualstudio.com)**\n * **[Slint extension](https://marketplace.visualstudio.com/items?itemName=Slint.slint)**\n * **[STM32 VS Code Extension](https://marketplace.visualstudio.com/items?itemName=stmicroelectronics.stm32-vscode-extension)**\n * **[CMake Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools)**\n\n## First Steps\n\nWe provide templates for different STM32 Discovery Kits that provide:\n\n - A pre-configured build system.\n - Application skeleton source code with sample Slint UI.\n - Example usage of callbacks, properties, and basic widgets.\n\nTo get started, select a download from the following table. If your board is not included in the table below, see our [](stm32/generic.md) instructions.\n\n| STM32 Board | Download |\n|----------------------------------|----------|\n| [STM32H747I-DISCO](https://www.st.com/en/evaluation-tools/stm32h747i-disco.html): Dual-core Arm M7/M4 MCU with 4” touch LCD display module | [slint-cpp-template-stm32h747i-disco.zip](https://github.com/slint-ui/slint/releases/latest/download/slint-cpp-template-stm32h747i-disco.zip) |\n| [STM32H735G-DK](https://www.st.com/en/evaluation-tools/stm32h735g-dk.html): Arm M7 MCU with 4” touch LCD display module | [slint-cpp-template-stm32h735g-dk.zip](https://github.com/slint-ui/slint/releases/latest/download/slint-cpp-template-stm32h735g-dk.zip) |\n\n\n1. Download and extract the archive that matches our STM32 Discovery Kit.\n2. Open the extracted folder with VS Code.\n3. Configure the project either via \"CMake: Select Configure Preset\" from the command palette or the CMake extension panel.\n4. Build, Flash to Device, and debug by hitting `F5` or running the `CMake: Debug` command from the command palette.\n\n## Next Steps\n\n - For more details about the Slint language, check out the [Slint Language Documentation](slint-reference:).\n - Learn about the [](../types.md) between Slint and C++.\n - Study the [](../api/library_root).\n\n```{toctree}\n:maxdepth: 2\n:hidden:\n:caption: STMicroelectronics' STM32Cube Ecosystem\n\nstm32/generic.md\n```\n" }, { "path": "api/cpp/docs/overview.md", "content": "# Overview\n\nThe following sections explain how to integrate your `.slint` designs into your\nC++ application. The entry point is the `.slint` file containing the primary\ncomponent you need to instantiate from C++.\n\nSlint is a very flexible system and allows for different integration options.\n\nFirst you can compile your Slint designs ahead of time into C++ code. This\ncode is then built into your application. This allows for the smallest\npossible memory footprint and the best possible performance.\n\nThe second approach is to load your Slint designs at run-time, interpreting\nthem as needed. This enables even more dynamic user interfaces that can be\nchanged at run-time, but comes at the price of having less opportunity to apply\noptimizations.\n\nEither way, once your user interface is shown, you interact with it from C++,\nfor example by setting properties, populating data models or setting up and\nhandling callbacks to react to events triggered by the user.\n\n## Compiled `.slint` Designs\n\nThe provided CMake integration makes it easy to compile your Slint sources:\nThe [`slint_target_sources` CMake command](cmake_reference.md#slint_target_sources) makes the translation automatic. The\n[generated code](generated_code.md) has an API to set and get property values,\netc. This API uses types from the {ref}`slint ` namespace, for\nexample {cpp:class}`slint::SharedString` or {cpp:class}`slint::Color`.\n\n## Run-Time Interpreted `.slint` Designs\n\nInstead of compiling `.slint` designs to C++, you can dynamically load `.slint`\nfiles at run-time. This is slower than compiling them ahead of time and requires\nmore memory, however it provides more flexibility in your application design.\n\nThe entry point to loading a `.slint` file is the\n{cpp:class}`slint::interpreter::ComponentCompiler` class in the\n{ref}`slint::interpreter ` namespace.\n\nWith the help of {cpp:class}`slint::interpreter::ComponentCompiler` you create\na {cpp:class}`slint::interpreter::ComponentDefinition`, which provides\ninformation on properties and callbacks common to all instances. The\n{cpp:func}`slint::interpreter::ComponentDefinition::create()` function creates\nnew instances, wrapped in a {cpp:class}`slint::ComponentHandle`. This is a smart\npointer that owns the actual instance and keeps it alive as long as at least one\n{cpp:class}`slint::ComponentHandle` is in scope, similar to\n`std::shared_ptr`.\n\nAll property values in `.slint` are mapped to\n{cpp:class}`slint::interpreter::Value` in C++. This is a polymorphic data type\nthat can hold different kinds of values, such as numbers, strings or even data\nmodels.\n\nMore complex user interfaces commonly consume data in the form of an abstract\ndata model, that is used with `for` - `in`\nrepetitions or `ListView` elements in the\n`.slint` language. All models in C++ with the interpreter API are sub-classes\nof the {cpp:class}`slint::Model` where the template parameter is\n{cpp:class}`slint::interpreter::Value`. To provide your own data model, you can\nsubclass `slint::Model`.\n\nIt's possible to declare [singletons that are globally available](../slint/src/globals.html)\nin `.slint` files. You can access them from to your C++ code by exporting them\nand using the getter and setter functions on\n{cpp:class}`slint::interpreter::ComponentInstance` to change properties and\ncallbacks:\n\n1. {cpp:func}`slint::interpreter::ComponentInstance::set_global_property()`\n1. {cpp:func}`slint::interpreter::ComponentInstance::get_global_property()`\n1. {cpp:func}`slint::interpreter::ComponentInstance::set_global_callback()`\n1. {cpp:func}`slint::interpreter::ComponentInstance::invoke_global_callback()`\n" }, { "path": "api/cpp/docs/pyproject.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: MIT\n\n[project]\nname = \"slint-cppdocs\"\nversion = \"0.1\"\ndescription = \"Python env for running sphinx, breathe, etc.\"\nrequires-python = \">=3.10\"\ndependencies = [\n \"breathe>=4.33.1\",\n \"exhale>=0.2.4\",\n \"furo>=2022.12.7\",\n \"myst-parser>=0.17.2\",\n \"sphinx==7.1.2\",\n \"sphinx-markdown-tables>=0.0.15\",\n \"sphinxcontrib-jquery>=4.1\",\n]\n" }, { "path": "api/cpp/docs/thirdparty.hbs", "content": "\n\n\n# Third Party Licenses\n\nThis page lists the licenses of the dependencies used by Slint.\n\n## Overview of licenses\n\n{{#each overview}}\n- [{{name}}](#{{id}}) ({{count}})\n{{/each}}\n\n## All License Text\n\n{{#each licenses}}\n### {{name}}\n\n#### Used by:\n\n{{#each used_by}}\n- [{{crate.name}} {{crate.version}}]({{#if crate.repository}} {{crate.repository}} {{else}}\nhttps://crates.io/crates/{{crate.name}} {{/if}})\n{{/each}}\n\n#### License Text\n\n```\n{{text}}\n```\n\n{{/each}}\n" }, { "path": "api/cpp/docs/types.md", "content": "# Type Mappings\n\nThe types used for properties in `.slint` design markup each translate to specific types in C++.\nThe follow table summarizes the entire mapping:\n\n```{eval-rst}\n=========================== =================================== =======================================================================================================================================\n :code:`.slint` Type C++ Type Note\n=========================== =================================== =======================================================================================================================================\n :code:`int` :code:`int`\n :code:`float` :code:`float`\n :code:`bool` :code:`bool`\n :code:`string` :cpp:class:`slint::SharedString` A reference-counted string type that uses UTF-8 encoding and can be easily converted to a std::string_view or a :code:`const char *`.\n :code:`color` :cpp:class:`slint::Color`\n :code:`brush` :cpp:class:`slint::Brush`\n :code:`image` :cpp:class:`slint::Image`\n :code:`physical_length` :code:`float` The unit are physical pixels.\n :code:`length` :code:`float` At run-time, logical lengths are automatically translated to physical pixels using the device pixel ratio.\n :code:`duration` :code:`std::int64_t` At run-time, durations are always represented as signed 64-bit integers with millisecond precision.\n :code:`angle` :code:`float` The angle in degrees.\n :code:`relative-font-size` :code:`float` Relative font size factor that is multiplied with the :code:`Window.default-font-size` and can be converted to a :code:`length`.\n structure A :code:`class` of the same name The order of the data member are in the same as in the slint declaration\n anonymous object A :code:`std::tuple` The fields are in alphabetical order.\n enum An :code:`enum class` The values are always converted to CamelCase. The order of the values is the same as in the declaration.\n :code:`Point` :cpp:class:`slint::LogicalPosition` A struct with :code:`x` and :code:`y` fields, representing logical coordinates.\n=========================== =================================== =======================================================================================================================================\n```\n## Structures\n\nThe Slint compiler generates a `class` with all data members in\nthe same order for any user-defined, exported `struct` in the `.slint`\ncode.\n\nFor example, this `struct` in a `.slint` file\n\n```slint,ignore\nexport struct MyStruct {\n foo: int,\n bar: string,\n}\n```\n\nwill generate the following type in C++:\n\n```cpp\nclass MyStruct {\npublic:\n int foo;\n slint::SharedString bar;\n};\n```\n\n## Enums\n\nThe Slint compiler generates an `enum class` with all values in the same order and converted to camel case\nfor any user-defined, exported `enum` in the `.slint` code.\n\nFor example, this `enum` in a `.slint` file\n\n```slint,ignore\nexport enum MyEnum { alpha, beta-gamma, omicron }\n```\n\nwill generate the following type in C++:\n\n```cpp\nenum class MyEnum { Alpha, BetaGamma, Omicron };\n```\n" }, { "path": "api/cpp/esp-idf/slint/CMakeLists.txt", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nidf_component_register(\n SRCS \"src/slint-esp.cpp\"\n INCLUDE_DIRS \"include\"\n REQUIRES \"esp_lcd\" \"esp_lcd_touch\")\n\nlist(PREPEND CMAKE_MODULE_PATH \"${CMAKE_SOURCE_DIR}/cmake\")\n\nif (CONFIG_IDF_TARGET_ARCH_XTENSA)\n set(rust_target \"xtensa-${IDF_TARGET}-none-elf\")\nelseif(CONFIG_IDF_TARGET_ARCH_RISCV)\n if (CONFIG_IDF_TARGET_ESP32C6 OR CONFIG_IDF_TARGET_ESP32C5 OR CONFIG_IDF_TARGET_ESP32H2)\n set(rust_target \"riscv32imac-esp-espidf\")\n elseif (CONFIG_IDF_TARGET_ESP32P4)\n set(rust_target \"riscv32imafc-esp-espidf\")\n else ()\n set(rust_target \"riscv32imc-esp-espidf\")\n endif()\nelse()\n message(FATAL_ERROR \"Architecture currently not supported\")\nendif()\n\nset(SLINT_FEATURE_FREESTANDING ON)\nset(SLINT_FEATURE_RENDERER_SOFTWARE ON)\nset(SLINT_LIBRARY_CARGO_FLAGS \"-Zbuild-std=core,alloc\")\nset(DEFAULT_SLINT_EMBED_RESOURCES \"embed-for-software-renderer\" CACHE STRING \"\")\nset(CMAKE_BUILD_TYPE Release)\nset(BUILD_SHARED_LIBS OFF)\nset(Rust_CARGO_TARGET ${rust_target})\n\nif (SLINT_ESP_LOCAL_EXAMPLE)\n add_subdirectory(../.. slint_build)\nelse()\n list(PREPEND CMAKE_MODULE_PATH \"${CMAKE_CURRENT_LIST_DIR}/cmake\")\n # This variable is set when generating nightly snapshot's CMakeLists.txt\n if (NOT SLINT_NIGHTLY)\n find_package(Slint)\n endif()\n\n if (TARGET Slint::Slint)\n # Imported targets are only visible in directory scope by default, but\n # for use by the application, we need to make the target global.\n set_target_properties(Slint::Slint PROPERTIES IMPORTED_GLOBAL TRUE)\n else()\n include(FetchContent)\n FetchContent_Declare(\n Slint\n GIT_REPOSITORY https://github.com/slint-ui/slint\n GIT_TAG v1.16.0\n SOURCE_SUBDIR api/cpp\n )\n FetchContent_MakeAvailable(Slint)\n endif()\nendif()\n\ntarget_link_libraries(${COMPONENT_LIB} PUBLIC Slint::Slint)\ntarget_linker_script(${COMPONENT_LIB} INTERFACE \"esp-println.x\")\n" }, { "path": "api/cpp/esp-idf/slint/README.md", "content": "\n# Slint\n\n[![Component Registry](https://components.espressif.com/components/slint/slint/badge.svg)](https://components.espressif.com/components/slint/slint)\n\nSlint is a declarative GUI toolkit to build native user interfaces for desktop and embedded applications written in Rust, C++, or JavaScript.\n\nThis component provides the C++ version of [Slint](https://slint.dev/) for the [Espressif IoT Development Framework](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/index.html).\n\nIt has been tested on ESP32-S3 devices.\n\n![Screenshot](https://user-images.githubusercontent.com/959326/260754861-e2130cce-9d2b-4925-9536-88293818ac3e.jpeg)\n\n## Documentation\n\nCheck out our [Getting Started Guide for C++ on ESP-IDF](https://slint.dev/docs/cpp/mcu/esp_idf.html).\n\n## Feedback\n\nIf you have feedback or questions, feel free to reach out to the Slint community:\n\n- [Chat with us](https://chat.slint.dev/) on Mattermost.\n- [Ask questions](https://github.com/slint-ui/slint/discussions) on GitHub\n- Contact us on [Twitter](https://twitter.com/slint_ui) or [Mastodon](https://fosstodon.org/@slint)\n- [Report a bug](https://github.com/slint-ui/slint/issues) on Github\n\n## License\n\nYou can use Slint under ***any*** of the following licenses, at your choice:\n\n1. [Royalty-free license](https://github.com/slint-ui/slint/blob/master/LICENSES/LicenseRef-Slint-Royalty-free-2.0.md),\n2. [GNU GPLv3](https://github.com/slint-ui/slint/blob/master/LICENSES/GPL-3.0-only.txt),\n3. [Paid license](https://github.com/slint-ui/slint/blob/master/LICENSES/LicenseRef-Slint-Software-3.0.md).\n\nSee also the [Licensing FAQ](https://github.com/slint-ui/slint/blob/master/FAQ.md#licensing).\n\n## Links\n\n[Website](https://slint.dev) · [GitHub](https://github.com/slint-ui/slint) · [Docs](https://slint.dev/docs/cpp)\n" }, { "path": "api/cpp/esp-idf/slint/cmake/FindSlint.cmake", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n#\n# FindSlint\n# ---------\n#\n# This modules attempts to locate an installation of Slint, as follows:\n#\n# 1. First `find_package(Slint ... CONFIG ...)` is called, to locate any packages in the `CMAKE_PREFIX_PATH`.\n# 2. If that failed and if `find_package` was called with a `VERSION`, then this module will attempt to download\n# a pre-compiled binary package for the specified Slint release, extract it into `${CMAKE_BINARY_DIR}/slint-prebuilt`,\n# and make it available. If version is unset, download the nightly release.\n#\n# The following variables may be set to affect the behaviour:\n#\n# `SLINT_TARGET_ARCHITECTURE`: Set this to the desired target architecture. The format of this string is matched against\n# the `Slint-cpp-*-$SLINT_TARGET_ARCHITECTURE.tar.gz` pre-built assets on the GitHub releases. For example, if you're targeting\n# STM32 ARM architectures, you'd set this to `thumbv7em-none-eabihf`. If not set, this module will attempt to detect if compilation\n# is happening in an ESP-IDF cross-compilation environment and detect the architecture accordingly, otherwise\n# `${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}` is used.\n\nfind_package(Slint ${Slint_FIND_VERSION} QUIET CONFIG)\nif (TARGET Slint::Slint)\n return()\nendif()\n\nif (NOT SLINT_TARGET_ARCHITECTURE)\n if(WIN32)\n if(MSVC)\n set(compiler_suffix \"-MSVC\")\n elseif(MINGW)\n set(compiler_suffix \"-MinGW\")\n endif()\n if(CMAKE_SIZEOF_VOID_P EQUAL 8)\n set(CPACK_SYSTEM_NAME win64)\n else()\n set(CPACK_SYSTEM_NAME win32)\n endif()\n set(SLINT_TARGET_ARCHITECTURE \"${CPACK_SYSTEM_NAME}${compiler_suffix}-${CMAKE_SYSTEM_PROCESSOR}\")\n elseif (CONFIG_IDF_TARGET_ARCH_XTENSA)\n set(SLINT_TARGET_ARCHITECTURE \"xtensa-${IDF_TARGET}-none-elf\")\n elseif(CONFIG_IDF_TARGET_ARCH_RISCV)\n if (CONFIG_IDF_TARGET_ESP32C6 OR CONFIG_IDF_TARGET_ESP32C5 OR CONFIG_IDF_TARGET_ESP32H2)\n set(SLINT_TARGET_ARCHITECTURE \"riscv32imac-esp-espidf\")\n elseif (CONFIG_IDF_TARGET_ESP32P4)\n set(SLINT_TARGET_ARCHITECTURE \"riscv32imafc-esp-espidf\")\n else ()\n set(SLINT_TARGET_ARCHITECTURE \"riscv32imc-esp-espidf\")\n endif()\n else()\n set(SLINT_TARGET_ARCHITECTURE \"${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}\")\n endif()\nendif()\n\nif (NOT DEFINED Slint_FIND_VERSION)\n # Set this to instruct the slint-compiler download to use the same release\n set(SLINT_GITHUB_RELEASE \"nightly\" CACHE STRING \"\")\n set(github_release \"nightly\")\n set(github_filename_infix \"nightly\")\nelse()\n set(github_release \"v${Slint_FIND_VERSION}\")\n set(github_filename_infix \"${Slint_FIND_VERSION}\")\nendif()\n\nset(prebuilt_archive_filename \"Slint-cpp-${github_filename_infix}-${SLINT_TARGET_ARCHITECTURE}.tar.gz\")\nset(download_target_path \"${CMAKE_BINARY_DIR}/slint-prebuilt/\")\nset(download_url \"https://github.com/slint-ui/slint/releases/download/${github_release}/${prebuilt_archive_filename}\")\n\nfile(MAKE_DIRECTORY \"${download_target_path}\")\nmessage(STATUS \"Downloading pre-built Slint binary ${download_url}\")\nfile(DOWNLOAD \"${download_url}\" \"${download_target_path}/${prebuilt_archive_filename}\" STATUS download_status)\nlist(GET download_status 0 download_code)\nif (NOT download_code EQUAL 0)\n list(GET download_status 1 download_message)\n message(STATUS \"Download of Slint binary package failed: ${download_message}\")\n return()\nendif()\n\nfile(ARCHIVE_EXTRACT INPUT \"${download_target_path}/${prebuilt_archive_filename}\" DESTINATION \"${download_target_path}\")\nlist(PREPEND CMAKE_PREFIX_PATH \"${download_target_path}\")\nfind_package(Slint CONFIG)\n" }, { "path": "api/cpp/esp-idf/slint/esp-println.x", "content": "/* Copyright © SixtyFPS GmbH \n SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0 */\n\n/*\nLinker script needed to ensure that the meta-data from esp-println is included in the final binary. We use esp-println\nand esp-backtrace in the C++ build, where this linker section isn't automatically included. For more details, see\nhttps://github.com/esp-rs/rust/issues/266#issuecomment-3361411040\n*/\n\nSECTIONS {\n .espressif.metadata 0 (INFO) :\n {\n KEEP(*(.espressif.metadata));\n }\n}\n" }, { "path": "api/cpp/esp-idf/slint/idf_component.yml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\ndescription: \"Slint — declarative GUI toolkit\"\nurl: \"https://slint.dev\"\nlicense: \"GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\"\nversion: \"1.16.0\"\ndiscussion: \"https://github.com/slint-ui/slint/discussions\"\ndocumentation: \"https://slint.dev/docs\"\nrepository: \"https://github.com/slint-ui/slint\"\ndependencies:\n idf: \">=5.1\"\n esp_lcd_touch:\n version: \">=1.0.4\"\n public: true\n" }, { "path": "api/cpp/esp-idf/slint/include/slint-esp.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint-platform.h\"\n#include \"esp_lcd_touch.h\"\n#include \"esp_lcd_types.h\"\n\n/**\n * This data structure configures the Slint platform for use with ESP-IDF, in particular\n * the esp_lcd component (\n * https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/peripherals/lcd.html )\n * for touch input and on-screen rendering.\n *\n * Slint supports three different ways of rendering:\n *\n * * Single-buffering: Allocate one frame-buffer at a location of your choosing in RAM, and\n * set the `buffer1` field.\n * * Double-buffering: Call `esp_lcd_rgb_panel_get_frame_buffer` to obtain two frame buffers\n * allocated by the `esp_lcd` driver and set `buffer1` and `buffer2`.\n * * Line-by-line rendering: Set neither `buffer1` nor `buffer2` to instruct Slint to allocate\n * a buffer (with MALLOC_CAP_INTERNAL) big enough to hold one line,\n * render into it, and send it to the display.\n *\n * Use single-buffering if you can allocate a buffer in a memory region that allows the esp_lcd\n * driver to efficiently transfer to the display. Use double-buffering if your driver supports\n * calling `esp_lcd_rgb_panel_get_frame_buffer` and the buffers can be accessed directly by the\n * display controller. Use line-by-line rendering if you don't have sufficient memory or rendering\n * to internal memory (MALLOC_CAP_INTERNAL) and flushing to the display is faster than rendering\n * into memory buffers that may be slower to access for the CPU.\n *\n * The data structure is a template where the pixel type is configurable.\n * The default depends on the sdkconfig, but you can use either `slint::Rgb8Pixel` or\n * `slint::platform::Rgb565Pixel`, depending on how the display is configured.\n */\ntemplate\n\nstruct SlintPlatformConfiguration\n{\n /// The size of the screen in pixels.\n slint::PhysicalSize size;\n /// The handle to the display as previously initialized by `bsp_display_new` or\n /// `esp_lcd_panel_init`. Must be set to a valid, non-null esp_lcd_panel_handle_t.\n esp_lcd_panel_handle_t panel_handle = nullptr;\n /// The touch screen handle, if the device is equipped with a touch screen. Set to nullptr\n /// otherwise;\n esp_lcd_touch_handle_t touch_handle = nullptr;\n /// The buffer Slint will render into. It must have have the size of at least one frame. Slint\n /// calls esp_lcd_panel_draw_bitmap to flush the buffer to the screen.\n std::optional> buffer1 = {};\n /// If specified, this is a second buffer that will be used for double-buffering. Use this if\n /// your LCD panel supports double buffering: Call `esp_lcd_rgb_panel_get_frame_buffer` to\n /// obtain two buffers and set `buffer` and `buffer2` in this data structure.\n std::optional> buffer2 = {};\n slint::platform::SoftwareRenderer::RenderingRotation rotation =\n slint::platform::SoftwareRenderer::RenderingRotation::NoRotation;\n /// Swap the 2 bytes of RGB 565 pixels before sending to the display, or turn 24-bit RGB into\n /// BGR. Use this if your CPU is little endian but the display expects big-endian.\n union {\n [[deprecated(\"Renamed to byte_swap\")]] bool color_swap_16;\n bool byte_swap = false;\n };\n};\n\ntemplate\nSlintPlatformConfiguration(Args...) -> SlintPlatformConfiguration<>;\n\n/**\n * Initialize the Slint platform for ESP-IDF\n *\n * This must be called before any other call to the Slint library.\n *\n * - `size` is the size of the screen\n * - `panel` is a handle to the display.\n * - `touch` is a handle to the touch screen, if the device has a touch screen\n * - `buffer1`, is a buffer of at least the size of the frame in which the slint scene\n * will be drawn. Slint will take care to flush it to the screen\n * - `buffer2`, if specified, is a second buffer to be used with double buffering,\n * both buffer1 and buffer2 should then be obtained with `esp_lcd_rgb_panel_get_frame_buffer`\n *\n * Note: For compatibility, this function overload selects RGB16 byte swapping if single-buffering\n * is selected as rendering method.\n *\n * \\deprecated Prefer the overload taking a SlintPlatformConfiguration\n */\n[[deprecated(\"Use the overload taking a SlintPlatformConfiguration\")]]\nvoid slint_esp_init(slint::PhysicalSize size, esp_lcd_panel_handle_t panel,\n std::optional touch,\n std::span buffer1,\n std::optional> buffer2 = {});\n\n/**\n * Initialize the Slint platform for ESP-IDF.\n *\n * This must be called before any other call to the Slint library.\n */\nvoid slint_esp_init(const SlintPlatformConfiguration &config);\nvoid slint_esp_init(const SlintPlatformConfiguration &config);\n" }, { "path": "api/cpp/esp-idf/slint/src/slint-esp.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#include \n#include \n#include \"slint-esp.h\"\n#include \"slint-platform.h\"\n#include \"esp_lcd_panel_ops.h\"\n#if __has_include(\"soc/soc_caps.h\")\n# include \"soc/soc_caps.h\"\n#endif\n#if SOC_LCD_RGB_SUPPORTED && ESP_IDF_VERSION_MAJOR >= 5\n# include \"esp_lcd_panel_rgb.h\"\n#endif\n#include \"esp_log.h\"\n\nstatic const char *TAG = \"slint_platform\";\n\nusing RepaintBufferType = slint::platform::SoftwareRenderer::RepaintBufferType;\n\nclass EspWindowAdapter : public slint::platform::WindowAdapter\n{\npublic:\n slint::platform::SoftwareRenderer m_renderer;\n bool needs_redraw = true;\n const slint::PhysicalSize m_size;\n\n explicit EspWindowAdapter(RepaintBufferType buffer_type, slint::PhysicalSize size)\n : m_renderer(buffer_type), m_size(size)\n {\n }\n\n slint::platform::AbstractRenderer &renderer() override { return m_renderer; }\n\n slint::PhysicalSize size() override { return m_size; }\n\n void request_redraw() override { needs_redraw = true; }\n};\n\ntemplate\nstruct EspPlatform : public slint::platform::Platform\n{\n EspPlatform(const SlintPlatformConfiguration &config)\n : size(config.size),\n panel_handle(config.panel_handle),\n touch_handle(config.touch_handle),\n buffer1(config.buffer1),\n buffer2(config.buffer2),\n byte_swap(config.byte_swap),\n rotation(config.rotation)\n {\n task = xTaskGetCurrentTaskHandle();\n }\n\n std::unique_ptr create_window_adapter() override;\n\n std::chrono::milliseconds duration_since_start() override;\n void run_event_loop() override;\n void quit_event_loop() override;\n void run_in_event_loop(Task) override;\n\nprivate:\n slint::PhysicalSize size;\n esp_lcd_panel_handle_t panel_handle;\n esp_lcd_touch_handle_t touch_handle;\n std::optional> buffer1;\n std::optional> buffer2;\n bool byte_swap;\n slint::platform::SoftwareRenderer::RenderingRotation rotation;\n class EspWindowAdapter *m_window = nullptr;\n\n // Need to be static because we can't pass user data to the touch interrupt callback\n static TaskHandle_t task;\n std::mutex queue_mutex;\n std::deque queue; // protected by queue_mutex\n bool quit = false; // protected by queue_mutex\n};\n\ntemplate\nstd::unique_ptr EspPlatform::create_window_adapter()\n{\n if (m_window != nullptr) {\n ESP_LOGI(TAG, \"FATAL: create_window_adapter called multiple times\");\n return nullptr;\n }\n\n auto buffer_type =\n buffer2 ? RepaintBufferType::SwappedBuffers : RepaintBufferType::ReusedBuffer;\n auto window = std::make_unique(buffer_type, size);\n m_window = window.get();\n m_window->m_renderer.set_rendering_rotation(rotation);\n return window;\n}\n\ntemplate\nstd::chrono::milliseconds EspPlatform::duration_since_start()\n{\n auto ticks = xTaskGetTickCount();\n return std::chrono::milliseconds(pdTICKS_TO_MS(ticks));\n}\n\n#if SOC_LCD_RGB_SUPPORTED && ESP_IDF_VERSION_MAJOR >= 5\nstatic SemaphoreHandle_t sem_vsync_end;\nstatic SemaphoreHandle_t sem_gui_ready;\n\nextern \"C\" bool on_vsync_event(esp_lcd_panel_handle_t panel,\n const esp_lcd_rgb_panel_event_data_t *edata, void *)\n{\n BaseType_t high_task_awoken = pdFALSE;\n if (xSemaphoreTakeFromISR(sem_gui_ready, &high_task_awoken) == pdTRUE) {\n xSemaphoreGiveFromISR(sem_vsync_end, &high_task_awoken);\n }\n return high_task_awoken == pdTRUE;\n}\n#endif\n\nnamespace {\nvoid byte_swap_color(slint::platform::Rgb565Pixel *pixel)\n{\n // Swap endianness to big endian\n auto px = reinterpret_cast(pixel);\n *px = (*px << 8) | (*px >> 8);\n}\nvoid byte_swap_color(slint::Rgb8Pixel *pixel)\n{\n std::swap(pixel->r, pixel->b);\n}\n}\n\ntemplate\nvoid EspPlatform::run_event_loop()\n{\n esp_lcd_panel_disp_on_off(panel_handle, true);\n\n TickType_t max_ticks_to_wait = portMAX_DELAY;\n\n if (touch_handle) {\n if (esp_lcd_touch_register_interrupt_callback(\n touch_handle, [](auto) { vTaskNotifyGiveFromISR(task, nullptr); })\n != ESP_OK) {\n\n // No touch interrupt assigned or supported? Fall back to polling like esp_lvgl_port.\n // LVGL polls in 5ms intervals, but FreeRTOS tick interval is 10ms, so go for that\n max_ticks_to_wait = pdMS_TO_TICKS(10);\n }\n }\n#if SOC_LCD_RGB_SUPPORTED && ESP_IDF_VERSION_MAJOR >= 5\n if (buffer2) {\n sem_vsync_end = xSemaphoreCreateBinary();\n sem_gui_ready = xSemaphoreCreateBinary();\n esp_lcd_rgb_panel_event_callbacks_t cbs = {};\n cbs.on_vsync = on_vsync_event;\n esp_lcd_rgb_panel_register_event_callbacks(panel_handle, &cbs, this);\n }\n#endif\n\n float last_touch_x = 0;\n float last_touch_y = 0;\n bool touch_down = false;\n\n while (true) {\n slint::platform::update_timers_and_animations();\n\n std::optional event;\n {\n std::unique_lock lock(queue_mutex);\n if (queue.empty()) {\n if (quit) {\n quit = false;\n break;\n }\n } else {\n event = std::move(queue.front());\n queue.pop_front();\n }\n }\n if (event) {\n std::move(*event).run();\n event.reset();\n continue;\n }\n\n if (m_window) {\n\n if (touch_handle) {\n uint16_t touchpad_x[1] = { 0 };\n uint16_t touchpad_y[1] = { 0 };\n uint8_t touchpad_cnt = 0;\n\n /* Read touch controller data */\n esp_lcd_touch_read_data(touch_handle);\n\n /* Get coordinates */\n bool touchpad_pressed = esp_lcd_touch_get_coordinates(\n touch_handle, touchpad_x, touchpad_y, NULL, &touchpad_cnt, 1);\n\n if (touchpad_pressed && touchpad_cnt > 0) {\n auto scale_factor = m_window->window().scale_factor();\n // ESP_LOGI(TAG, \"x: %i, y: %i\", touchpad_x[0], touchpad_y[0]);\n last_touch_x = float(touchpad_x[0]) / scale_factor;\n last_touch_y = float(touchpad_y[0]) / scale_factor;\n m_window->window().dispatch_pointer_move_event(\n slint::LogicalPosition({ last_touch_x, last_touch_y }));\n if (!touch_down) {\n m_window->window().dispatch_pointer_press_event(\n slint::LogicalPosition({ last_touch_x, last_touch_y }),\n slint::PointerEventButton::Left);\n }\n touch_down = true;\n } else if (touch_down) {\n m_window->window().dispatch_pointer_release_event(\n slint::LogicalPosition({ last_touch_x, last_touch_y }),\n slint::PointerEventButton::Left);\n m_window->window().dispatch_pointer_exit_event();\n touch_down = false;\n }\n }\n\n if (std::exchange(m_window->needs_redraw, false)) {\n using slint::platform::SoftwareRenderer;\n auto rotated = rotation == SoftwareRenderer::RenderingRotation::Rotate90\n || rotation == SoftwareRenderer::RenderingRotation::Rotate270;\n auto stride = rotated ? size.height : size.width;\n if (buffer1) {\n#if SOC_LCD_RGB_SUPPORTED && ESP_IDF_VERSION_MAJOR >= 5\n if (buffer2) {\n xSemaphoreGive(sem_gui_ready);\n xSemaphoreTake(sem_vsync_end, portMAX_DELAY);\n }\n#endif\n auto region = m_window->m_renderer.render(buffer1.value(), stride);\n\n if (byte_swap) {\n for (auto [o, s] : region.rectangles()) {\n for (int y = o.y; y < o.y + s.height; y++) {\n for (int x = o.x; x < o.x + s.width; x++) {\n byte_swap_color(&buffer1.value()[y * stride + x]);\n }\n }\n }\n }\n\n if (buffer2) {\n auto s = region.bounding_box_size();\n if (s.width > 0 && s.height > 0) {\n // Assuming that using double buffer means that the buffer comes from\n // the driver and we need to pass the exact pointer.\n // https://github.com/espressif/esp-idf/blob/53ff7d43dbff642d831a937b066ea0735a6aca24/components/esp_lcd/src/esp_lcd_panel_rgb.c#L681\n esp_lcd_panel_draw_bitmap(panel_handle, 0, 0, size.width, size.height,\n buffer1->data());\n\n std::swap(buffer1, buffer2);\n }\n } else {\n for (auto [o, s] : region.rectangles()) {\n for (int y = o.y; y < o.y + s.height; y++) {\n esp_lcd_panel_draw_bitmap(panel_handle, o.x, y, o.x + s.width,\n y + 1,\n buffer1->data() + y * stride + o.x);\n }\n }\n }\n } else {\n // esp_lcd_panel_draw_bitmap is \"async\" so we have two buffers, one in which we\n // render, and one which is being transmitted with a DMA transfer in parallel.\n // TODO: add some synchronization code anyway to make sure that we don't\n // call esp_lcd_panel_draw_bitmap when an operation is still in progress\n // or free the buffer too early. (using `on_color_trans_done` callback).\n using Uniq = std::unique_ptr;\n auto alloc = [&] {\n void *ptr = heap_caps_malloc(stride * sizeof(PixelType),\n MALLOC_CAP_INTERNAL | MALLOC_CAP_8BIT);\n if (!ptr) {\n ESP_LOGE(TAG, \"malloc failed to allocate line buffer\");\n abort();\n }\n return Uniq(reinterpret_cast(ptr), heap_caps_free);\n };\n Uniq lb[2] = { alloc(), alloc() };\n int idx = 0;\n m_window->m_renderer.render_by_line(\n [this, &lb, &idx](std::size_t line_y, std::size_t line_start,\n std::size_t line_end, auto &&render_fn) {\n std::span view { lb[idx].get(), line_end - line_start };\n render_fn(view);\n if (byte_swap) {\n // Swap endianness to big endian\n std::for_each(view.begin(), view.end(),\n [](auto &rgbpix) { byte_swap_color(&rgbpix); });\n }\n esp_lcd_panel_draw_bitmap(panel_handle, line_start, line_y,\n line_end, line_y + 1, view.data());\n idx = (idx + 1) % 2;\n });\n }\n }\n\n if (m_window->window().has_active_animations()) {\n continue;\n }\n }\n\n TickType_t ticks_to_wait = max_ticks_to_wait;\n if (auto wait_time = slint::platform::duration_until_next_timer_update()) {\n ticks_to_wait = std::min(ticks_to_wait, pdMS_TO_TICKS(wait_time->count()));\n }\n\n ulTaskNotifyTake(/*reset to zero*/ pdTRUE, ticks_to_wait);\n }\n\n vTaskDelete(NULL);\n}\n\ntemplate\nvoid EspPlatform::quit_event_loop()\n{\n {\n const std::unique_lock lock(queue_mutex);\n quit = true;\n }\n vTaskNotifyGiveFromISR(task, nullptr);\n}\n\ntemplate\nvoid EspPlatform::run_in_event_loop(slint::platform::Platform::Task event)\n{\n {\n const std::unique_lock lock(queue_mutex);\n queue.push_back(std::move(event));\n }\n vTaskNotifyGiveFromISR(task, nullptr);\n}\n\ntemplate\nTaskHandle_t EspPlatform::task = {};\n\nvoid slint_esp_init(slint::PhysicalSize size, esp_lcd_panel_handle_t panel,\n std::optional touch,\n std::span buffer1,\n std::optional> buffer2)\n{\n\n SlintPlatformConfiguration config {\n .size = size,\n .panel_handle = panel,\n .touch_handle = touch ? *touch : nullptr,\n .buffer1 = buffer1,\n .buffer2 = buffer2,\n // For compatibility with earlier versions of Slint, we compute the value of\n // byte_swap the way it was implemented in Slint (slint-esp) <= 1.6.0:\n .byte_swap = !buffer2.has_value()\n };\n slint_esp_init(config);\n}\n\nvoid slint_esp_init(const SlintPlatformConfiguration &config)\n{\n slint::platform::set_platform(\n std::make_unique>(config));\n}\n\nvoid slint_esp_init(const SlintPlatformConfiguration &config)\n{\n slint::platform::set_platform(std::make_unique>(config));\n}\n" }, { "path": "api/cpp/include/slint-interpreter.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint.h\"\n\n#ifndef SLINT_FEATURE_INTERPRETER\n# warning \"slint-interpreter.h API only available when SLINT_FEATURE_INTERPRETER is activated\"\n#else\n\n# include \"slint_interpreter_internal.h\"\n\n# include \n\n# ifdef SLINT_FEATURE_BACKEND_QT\nclass QWidget;\n# endif\n\nnamespace slint::cbindgen_private {\n// This has to stay opaque, but VRc don't compile if it is just forward declared\nstruct ErasedItemTreeBox : vtable::Dyn\n{\n ~ErasedItemTreeBox() = delete;\n ErasedItemTreeBox() = delete;\n ErasedItemTreeBox(ErasedItemTreeBox &) = delete;\n};\n}\nnamespace slint::private_api::live_preview {\nclass LiveReloadingComponent;\nclass LiveReloadModelWrapperBase;\n}\n\n/// The types in this namespace allow you to load a .slint file at runtime and show its UI.\n///\n/// You only need to use them if you do not want to use pre-compiled .slint code, which is\n/// the normal way to use Slint.\n///\n/// The entry point for this namespace is the \\ref ComponentCompiler, which you can\n/// use to create \\ref ComponentDefinition instances with the\n/// \\ref ComponentCompiler::build_from_source() or \\ref ComponentCompiler::build_from_path()\n/// functions.\nnamespace slint::interpreter {\n\nclass Value;\n\n/// This type represents a runtime instance of structure in `.slint`.\n///\n/// This can either be an instance of a name structure introduced\n/// with the `struct` keyword in the .slint file, or an anonymous struct\n/// written with the `{ key: value, }` notation.\n///\n/// It can be constructed with the range constructor or initializer lst,\n/// and converted into or from a Value with the Value constructor and\n/// Value::to_struct().\nstruct Struct\n{\npublic:\n /// Constructs a new empty struct. You can add fields with set_field() and\n /// read them with get_field().\n Struct() { cbindgen_private::slint_interpreter_struct_new(&inner); }\n\n /// Creates a new Struct as a copy from \\a other. All fields are copied as well.\n Struct(const Struct &other)\n {\n cbindgen_private::slint_interpreter_struct_clone(&other.inner, &inner);\n }\n /// Creates a new Struct by moving all fields from \\a other into this struct.\n Struct(Struct &&other)\n {\n inner = other.inner;\n cbindgen_private::slint_interpreter_struct_new(&other.inner);\n }\n /// Assigns all the fields of \\a other to this struct.\n Struct &operator=(const Struct &other)\n {\n if (this == &other)\n return *this;\n cbindgen_private::slint_interpreter_struct_destructor(&inner);\n slint_interpreter_struct_clone(&other.inner, &inner);\n return *this;\n }\n /// Moves all the fields of \\a other to this struct.\n Struct &operator=(Struct &&other)\n {\n if (this == &other)\n return *this;\n cbindgen_private::slint_interpreter_struct_destructor(&inner);\n inner = other.inner;\n cbindgen_private::slint_interpreter_struct_new(&other.inner);\n return *this;\n }\n /// Destroys this struct.\n ~Struct() { cbindgen_private::slint_interpreter_struct_destructor(&inner); }\n\n /// Creates a new struct with the fields of the std::initializer_list given by args.\n inline Struct(std::initializer_list> args);\n\n /// Creates a new struct with the fields produced by the iterator \\a it. \\a it is\n /// advanced until it equals \\a end.\n template(*std::declval())),\n std::string_view>::value\n && std::is_convertible(*std::declval())),\n Value>::value\n\n > * = nullptr\n# endif\n >\n Struct(InputIterator it, InputIterator end) : Struct()\n {\n for (; it != end; ++it) {\n auto [key, value] = *it;\n set_field(key, value);\n }\n }\n\n // FIXME: this probably miss a lot of iterator api\n /// The Struct::iterator class implements the typical C++ iterator protocol and conveniently\n /// provides access to the field names and values of a Struct. It is created by calling either\n /// Struct::begin() or Struct::end().\n ///\n /// Make sure to compare the iterator to the iterator returned by Struct::end() before\n /// de-referencing it. The value returned when de-referencing is a std::pair that holds a\n /// std::string_view of the field name as well as a const reference of the value. Both\n /// references become invalid when the iterator or the Struct is changed, so make sure to make\n /// copies if you want to retain the name or value.\n ///\n /// Note that the order in which the iterator exposes the fields is not defined.\n ///\n /// If you're using C++ 17, you can use the convenience destructuring syntax to extract the name\n /// and value in one go:\n ///\n /// ```\n /// Struct stru = ...;\n /// auto it = stru.begin();\n /// ...\n /// ++it; // advance iterator to the next field\n /// ...\n /// // Check iterator before dereferencing it\n /// if (it != stru.end()) {\n /// // Extract a view of the name and a const reference to the value in one go.\n /// auto [field_name, field_value] = *it;\n /// }\n /// ```\n struct iterator\n {\n /// A typedef for std::pair that's returned\n /// when dereferencing the iterator.\n using value_type = std::pair;\n\n private:\n cbindgen_private::StructIteratorOpaque inner;\n Value *v = nullptr;\n std::string_view k;\n friend Struct;\n explicit iterator(cbindgen_private::StructIteratorOpaque inner) : inner(inner) { next(); }\n // construct a end iterator\n iterator() = default;\n inline void next();\n\n public:\n /// Destroys this field iterator.\n inline ~iterator();\n // FIXME I believe iterators are supposed to be copy constructible\n iterator(const iterator &) = delete;\n iterator &operator=(const iterator &) = delete;\n /// Move-constructs a new iterator from \\a other.\n iterator(iterator &&other) = default;\n /// Move-assigns the iterator \\a other to this and returns a reference to this.\n iterator &operator=(iterator &&other) = default;\n /// The prefix ++ operator advances the iterator to the next entry and returns\n /// a reference to this.\n iterator &operator++()\n {\n if (v)\n next();\n return *this;\n }\n /// Dereferences the iterator to return a pair of the key and value.\n value_type operator*() const { return { k, *v }; }\n /// Returns true if \\a a is pointing to the same entry as \\a b; false otherwise.\n friend bool operator==(const iterator &a, const iterator &b) { return a.v == b.v; }\n /// Returns false if \\a a is pointing to the same entry as \\a b; true otherwise.\n friend bool operator!=(const iterator &a, const iterator &b) { return a.v != b.v; }\n };\n\n /// Returns an iterator over the fields of the struct.\n iterator begin() const\n {\n return iterator(cbindgen_private::slint_interpreter_struct_make_iter(&inner));\n }\n /// Returns an iterator that when compared with an iterator returned by begin() can be\n /// used to detect when all fields have been visited.\n iterator end() const { return iterator(); }\n\n /// Returns the value of the field with the given \\a name; Returns an std::optional without\n /// value if the field does not exist.\n inline std::optional get_field(std::string_view name) const;\n /// Sets the value of the field with the given \\a name to the specified \\a value. If the field\n /// does not exist yet, it is created; otherwise the existing field is updated to hold the new\n /// value.\n inline void set_field(std::string_view name, const Value &value);\n\n /// \\private\n Struct(const slint::cbindgen_private::StructOpaque &other)\n {\n cbindgen_private::slint_interpreter_struct_clone(&other, &inner);\n }\n\nprivate:\n using StructOpaque = slint::cbindgen_private::StructOpaque;\n StructOpaque inner;\n friend class Value;\n};\n\n/// This is a dynamically typed value used in the Slint interpreter.\n/// It can hold a value of different types, and you should use the\n/// different overloaded constructors and the to_xxx() functions to access the\n//// value within.\n///\n/// It is also possible to query the type the value holds by calling the Value::type()\n/// function.\n///\n/// Note that models are only represented in one direction: You can create a slint::Model\n/// in C++, store it in a std::shared_ptr and construct Value from it. Then you can set it on a\n/// property in your .slint code that was declared to be either an array (`property <[sometype]>\n/// foo;`) or an object literal (`property <{foo: string, bar: int}> my_prop;`). Such properties are\n/// dynamic and accept models implemented in C++.\n///\n/// ```\n/// Value v(42.0); // Creates a value that holds a double with the value 42.\n///\n/// Value some_value = ...;\n/// // Check if the value has a string\n/// if (std::optional string_value = some_value.to_string())\n/// do_something(*string_value); // Extract the string by de-referencing\n/// ```\nclass Value\n{\npublic:\n /// Constructs a new value of type Value::Type::Void.\n Value() : inner(cbindgen_private::slint_interpreter_value_new()) { }\n\n /// Constructs a new value by copying \\a other.\n Value(const Value &other) : inner(slint_interpreter_value_clone(other.inner)) { }\n /// Constructs a new value by moving \\a other to this.\n Value(Value &&other)\n {\n inner = other.inner;\n other.inner = cbindgen_private::slint_interpreter_value_new();\n }\n /// Assigns the value \\a other to this.\n Value &operator=(const Value &other)\n {\n if (this == &other)\n return *this;\n cbindgen_private::slint_interpreter_value_destructor(inner);\n inner = slint_interpreter_value_clone(other.inner);\n return *this;\n }\n /// Moves the value \\a other to this.\n Value &operator=(Value &&other)\n {\n if (this == &other)\n return *this;\n cbindgen_private::slint_interpreter_value_destructor(inner);\n inner = other.inner;\n other.inner = cbindgen_private::slint_interpreter_value_new();\n return *this;\n }\n /// Destroys the value.\n ~Value() { cbindgen_private::slint_interpreter_value_destructor(inner); }\n\n /// A convenience alias for the value type enum.\n using Type = ValueType;\n\n // optional to_int() const;\n // optional to_float() const;\n /// Returns a std::optional that contains a double if the type of this Value is\n /// Type::Double, otherwise an empty optional is returned.\n std::optional to_number() const\n {\n if (auto *number = cbindgen_private::slint_interpreter_value_to_number(inner)) {\n return *number;\n } else {\n return {};\n }\n }\n\n /// Returns a std::optional that contains a string if the type of this Value is\n /// Type::String, otherwise an empty optional is returned.\n std::optional to_string() const\n {\n if (auto *str = cbindgen_private::slint_interpreter_value_to_string(inner)) {\n return *str;\n } else {\n return {};\n }\n }\n\n /// Returns a std::optional that contains a bool if the type of this Value is\n /// Type::Bool, otherwise an empty optional is returned.\n std::optional to_bool() const\n {\n if (auto *b = cbindgen_private::slint_interpreter_value_to_bool(inner)) {\n return *b;\n } else {\n return {};\n }\n }\n\n /// Returns a std::optional that contains a vector of values if the type of this Value is\n /// Type::Model, otherwise an empty optional is returned.\n ///\n /// The vector will be constructed by serializing all the elements of the model.\n inline std::optional> to_array() const;\n\n /// Returns a std::optional that contains a brush if the type of this Value is\n /// Type::Brush, otherwise an empty optional is returned.\n std::optional to_brush() const\n {\n if (auto *brush = cbindgen_private::slint_interpreter_value_to_brush(inner)) {\n return *brush;\n } else {\n return {};\n }\n }\n\n /// Returns a std::optional that contains a Struct if the type of this Value is\n /// Type::Struct, otherwise an empty optional is returned.\n std::optional to_struct() const\n {\n if (auto *opaque_struct = cbindgen_private::slint_interpreter_value_to_struct(inner)) {\n return Struct(*opaque_struct);\n } else {\n return {};\n }\n }\n\n /// Returns a std::optional that contains an Image if the type of this Value is\n /// Type::Image, otherwise an empty optional is returned.\n std::optional to_image() const\n {\n if (auto *img = cbindgen_private::slint_interpreter_value_to_image(inner)) {\n return *reinterpret_cast(img);\n } else {\n return {};\n }\n }\n\n // template std::optional get() const;\n\n /// Constructs a new Value that holds the double \\a value.\n Value(double value) : inner(cbindgen_private::slint_interpreter_value_new_double(value)) { }\n /// Constructs a new Value that holds the int \\a value.\n /// Internally this is stored as a double and Value::type() will return Value::Type::Number.\n Value(int value) : Value(static_cast(value)) { }\n /// Constructs a new Value that holds the string \\a str.\n Value(const SharedString &str)\n : inner(cbindgen_private::slint_interpreter_value_new_string(&str))\n {\n }\n /// Constructs a new Value that holds the boolean \\a b.\n Value(bool b) : inner(cbindgen_private::slint_interpreter_value_new_bool(b)) { }\n /// Constructs a new Value that holds the value vector \\a v as a model.\n inline Value(const SharedVector &v);\n /// Constructs a new Value that holds the value model \\a m.\n Value(const std::shared_ptr> &m);\n /// Constructs a new Value that holds the brush \\a b.\n Value(const slint::Brush &brush)\n : inner(cbindgen_private::slint_interpreter_value_new_brush(&brush))\n {\n }\n /// Constructs a new Value that holds the Struct \\a struc.\n Value(const Struct &struc)\n : inner(cbindgen_private::slint_interpreter_value_new_struct(&struc.inner))\n {\n }\n\n /// Constructs a new Value that holds the Image \\a img.\n Value(const Image &img) : inner(cbindgen_private::slint_interpreter_value_new_image(&img)) { }\n\n /// Returns the type the variant holds.\n Type type() const { return cbindgen_private::slint_interpreter_value_type(inner); }\n\n /// Returns true if \\a a and \\a b hold values of the same type and the underlying vales are\n /// equal.\n friend bool operator==(const Value &a, const Value &b)\n {\n return cbindgen_private::slint_interpreter_value_eq(a.inner, b.inner);\n }\n\nprivate:\n inline Value(const void *) = delete; // Avoid that for example Value(\"foo\") turns to Value(bool)\n slint::cbindgen_private::Value *inner;\n friend struct Struct;\n friend class ComponentInstance;\n friend class slint::private_api::live_preview::LiveReloadingComponent;\n friend class slint::private_api::live_preview::LiveReloadModelWrapperBase;\n // Internal constructor that takes ownership of the value\n explicit Value(slint::cbindgen_private::Value *&&inner) : inner(inner) { }\n};\n\ninline Value::Value(const slint::SharedVector &array)\n : inner(cbindgen_private::slint_interpreter_value_new_array_model(\n reinterpret_cast *>(\n &array)))\n{\n}\n\ninline std::optional> Value::to_array() const\n{\n slint::SharedVector array;\n if (cbindgen_private::slint_interpreter_value_to_array(\n &inner,\n reinterpret_cast *>(\n &array))) {\n return array;\n } else {\n return {};\n }\n}\ninline Value::Value(const std::shared_ptr> &model)\n{\n using cbindgen_private::ModelAdaptorVTable;\n using vtable::VRef;\n struct ModelWrapper : private_api::ModelChangeListener\n {\n std::shared_ptr> model;\n cbindgen_private::ModelNotifyOpaque notify;\n // This kind of mean that the rust code has ownership of \"this\" until the drop function is\n // called\n std::shared_ptr self;\n ~ModelWrapper() { cbindgen_private::slint_interpreter_model_notify_destructor(¬ify); }\n\n void row_added(size_t index, size_t count) override\n {\n cbindgen_private::slint_interpreter_model_notify_row_added(¬ify, index, count);\n }\n void row_changed(size_t index) override\n {\n cbindgen_private::slint_interpreter_model_notify_row_changed(¬ify, index);\n }\n void row_removed(size_t index, size_t count) override\n {\n cbindgen_private::slint_interpreter_model_notify_row_removed(¬ify, index, count);\n }\n void reset() override { cbindgen_private::slint_interpreter_model_notify_reset(¬ify); }\n };\n\n auto wrapper = std::make_shared();\n wrapper->model = model;\n wrapper->self = wrapper;\n cbindgen_private::slint_interpreter_model_notify_new(&wrapper->notify);\n model->attach_peer(wrapper);\n\n auto row_count = [](VRef self) -> uintptr_t {\n return reinterpret_cast(self.instance)->model->row_count();\n };\n auto row_data = [](VRef self,\n uintptr_t row) -> slint::cbindgen_private::Value * {\n std::optional v =\n reinterpret_cast(self.instance)->model->row_data(int(row));\n if (v.has_value()) {\n slint::cbindgen_private::Value *rval = v->inner;\n v->inner = cbindgen_private::slint_interpreter_value_new();\n return rval;\n } else {\n return nullptr;\n }\n };\n auto set_row_data = [](VRef self, uintptr_t row,\n slint::cbindgen_private::Value *value) {\n Value v(std::move(value));\n reinterpret_cast(self.instance)->model->set_row_data(int(row), v);\n };\n auto get_notify =\n [](VRef self) -> const cbindgen_private::ModelNotifyOpaque * {\n return &reinterpret_cast(self.instance)->notify;\n };\n auto drop = [](vtable::VRefMut self) {\n reinterpret_cast(self.instance)->self = nullptr;\n };\n\n static const ModelAdaptorVTable vt { row_count, row_data, set_row_data, get_notify, drop };\n inner = cbindgen_private::slint_interpreter_value_new_model(\n reinterpret_cast(wrapper.get()), &vt);\n}\n\ninline Struct::Struct(std::initializer_list> args)\n : Struct(args.begin(), args.end())\n{\n}\n\ninline std::optional Struct::get_field(std::string_view name) const\n{\n using namespace cbindgen_private;\n cbindgen_private::Slice name_view = slint::private_api::string_to_slice(name);\n if (cbindgen_private::Value *field_val =\n cbindgen_private::slint_interpreter_struct_get_field(&inner, name_view)) {\n return Value(std::move(field_val));\n } else {\n return {};\n }\n}\ninline void Struct::set_field(std::string_view name, const Value &value)\n{\n cbindgen_private::Slice name_view = slint::private_api::string_to_slice(name);\n cbindgen_private::slint_interpreter_struct_set_field(&inner, name_view, value.inner);\n}\n\ninline void Struct::iterator::next()\n{\n cbindgen_private::Slice name_slice;\n\n if (cbindgen_private::Value *nextval_inner =\n cbindgen_private::slint_interpreter_struct_iterator_next(&inner, &name_slice)) {\n k = std::string_view(reinterpret_cast(name_slice.ptr), name_slice.len);\n if (!v)\n v = new Value();\n *v = Value(std::move(nextval_inner));\n } else {\n cbindgen_private::slint_interpreter_struct_iterator_destructor(&inner);\n delete v;\n v = nullptr;\n }\n}\n\ninline Struct::iterator::~iterator()\n{\n if (v) {\n cbindgen_private::slint_interpreter_struct_iterator_destructor(&inner);\n delete v;\n }\n}\n\nclass ComponentDefinition;\n\n/// The ComponentInstance represents a running instance of a component.\n///\n/// You can create an instance with the ComponentDefinition::create() function.\n///\n/// Properties and callback can be accessed using the associated functions.\n///\n/// An instance can be put on screen with the ComponentInstance::show() or the\n/// ComponentInstance::run()\nclass ComponentInstance : vtable::Dyn\n{\n ComponentInstance() = delete;\n ComponentInstance(ComponentInstance &) = delete;\n ComponentInstance &operator=(ComponentInstance &) = delete;\n friend class ComponentDefinition;\n\n // ComponentHandle is in fact a VRc\n const cbindgen_private::ErasedItemTreeBox *inner() const\n {\n slint::private_api::assert_main_thread();\n return reinterpret_cast(this);\n }\n\npublic:\n /// Marks the window of this component to be shown on the screen. This registers\n /// the window with the windowing system. In order to react to events from the windowing system,\n /// such as draw requests or mouse/touch input, it is still necessary to spin the event loop,\n /// using slint::run_event_loop().\n void show() const\n {\n cbindgen_private::slint_interpreter_component_instance_show(inner(), true);\n }\n /// Marks the window of this component to be hidden on the screen. This de-registers\n /// the window from the windowing system and it will not receive any further events.\n void hide() const\n {\n cbindgen_private::slint_interpreter_component_instance_show(inner(), false);\n }\n /// Returns the Window associated with this component. The window API can be used\n /// to control different aspects of the integration into the windowing system,\n /// such as the position on the screen.\n const slint::Window &window()\n {\n const cbindgen_private::WindowAdapterRcOpaque *win_ptr = nullptr;\n cbindgen_private::slint_interpreter_component_instance_window(inner(), &win_ptr);\n return *reinterpret_cast(win_ptr);\n }\n /// This is a convenience function that first calls show(), followed by\n /// slint::run_event_loop() and hide().\n void run() const\n {\n show();\n slint::run_event_loop();\n hide();\n }\n# if defined(SLINT_FEATURE_BACKEND_QT) || defined(DOXYGEN)\n /// Return a QWidget for this instance.\n /// This function is only available if the qt graphical backend was compiled in, and\n /// it may return nullptr if the Qt backend is not used at runtime.\n QWidget *qwidget() const\n {\n const cbindgen_private::WindowAdapterRcOpaque *win_ptr = nullptr;\n cbindgen_private::slint_interpreter_component_instance_window(inner(), &win_ptr);\n auto wid = reinterpret_cast(cbindgen_private::slint_qt_get_widget(\n reinterpret_cast(win_ptr)));\n return wid;\n }\n# endif\n\n /// Set the value for a public property of this component\n ///\n /// For example, if the component has a `property hello;`,\n /// we can set this property\n /// ```\n /// instance->set_property(\"hello\", slint::SharedString(\"world\"));\n /// ```\n ///\n /// Returns true if the property was correctly set. Returns false if the property\n /// could not be set because it either do not exist (was not declared in .slint) or if\n /// the value is not of the proper type for the property's type.\n bool set_property(std::string_view name, const Value &value) const\n {\n using namespace cbindgen_private;\n return slint_interpreter_component_instance_set_property(\n inner(), slint::private_api::string_to_slice(name), value.inner);\n }\n /// Returns the value behind a property declared in .slint.\n std::optional get_property(std::string_view name) const\n {\n using namespace cbindgen_private;\n if (cbindgen_private::Value *prop_inner = slint_interpreter_component_instance_get_property(\n inner(), slint::private_api::string_to_slice(name))) {\n return Value(std::move(prop_inner));\n } else {\n return {};\n }\n }\n /// Invoke the specified callback or function declared in .slint with the given arguments\n ///\n /// Example: imagine the .slint file contains the given callback declaration:\n /// ```\n /// callback foo(string, int) -> string;\n /// ```\n /// Then one can call it with this function\n /// ```\n /// slint::Value args[] = { SharedString(\"Hello\"), 42. };\n /// instance->invoke(\"foo\", { args, 2 });\n /// ```\n ///\n /// Returns an null optional if the callback don't exist or if the argument don't match\n /// Otherwise return the returned value from the callback, which may be an empty Value if\n /// the callback did not return a value.\n std::optional invoke(std::string_view name, std::span args) const\n {\n using namespace cbindgen_private;\n Slice> args_view = slint::private_api::make_slice(\n reinterpret_cast *>(args.data()), args.size());\n if (cbindgen_private::Value *rval_inner = slint_interpreter_component_instance_invoke(\n inner(), slint::private_api::string_to_slice(name), args_view)) {\n return Value(std::move(rval_inner));\n } else {\n return {};\n }\n }\n\n /// Set a handler for the callback with the given name.\n ///\n /// A callback with that name must be defined in the document otherwise the function\n /// returns false.\n ///\n /// The \\a callback parameter is a functor which takes as argument a slice of Value\n /// and must return a Value.\n ///\n /// Example: imagine the .slint file contains the given callback declaration:\n /// ```\n /// callback foo(string, int) -> string;\n /// ```\n /// Then one can set the callback handler with this function\n /// ```\n /// instance->set_callback(\"foo\", [](auto args) {\n /// std::cout << \"foo(\" << *args[0].to_string() << \", \" << *args[1].to_number() << \")\\n\";\n /// });\n /// ```\n ///\n /// Note: Since the ComponentInstance holds the handler, the handler itself should not\n /// capture a strong reference to the instance.\n template> F>\n requires(std::is_convertible_v>, Value>)\n auto set_callback(std::string_view name, F callback) const -> bool\n {\n using namespace cbindgen_private;\n auto actual_cb =\n [](void *data,\n cbindgen_private::Slice> arg) {\n std::span args_view { reinterpret_cast(arg.ptr),\n arg.len };\n Value r = (*reinterpret_cast(data))(args_view);\n auto inner = r.inner;\n r.inner = cbindgen_private::slint_interpreter_value_new();\n return inner;\n };\n return cbindgen_private::slint_interpreter_component_instance_set_callback(\n inner(), slint::private_api::string_to_slice(name), actual_cb,\n new F(std::move(callback)), [](void *data) { delete reinterpret_cast(data); });\n }\n\n /// Set the value for a property within an exported global singleton.\n ///\n /// For example, if the main file has an exported global `TheGlobal` with a\n /// `property hello`, we can set this property\n /// ```\n /// instance->set_global_property(\"TheGlobal\", \"hello\", 42);\n /// ```\n ///\n /// Returns true if the property was correctly set. Returns false if the property\n /// could not be set because it either does not exist (was not declared in .slint) or if\n /// the value is not of the correct type for the property's type.\n ///\n /// **Note:** Only globals that are exported or re-exported from the main .slint file will\n /// be accessible\n bool set_global_property(std::string_view global, std::string_view prop_name,\n const Value &value) const\n {\n using namespace cbindgen_private;\n return slint_interpreter_component_instance_set_global_property(\n inner(), slint::private_api::string_to_slice(global),\n slint::private_api::string_to_slice(prop_name), value.inner);\n }\n /// Returns the value behind a property in an exported global singleton.\n std::optional get_global_property(std::string_view global,\n std::string_view prop_name) const\n {\n using namespace cbindgen_private;\n if (cbindgen_private::Value *rval_inner =\n slint_interpreter_component_instance_get_global_property(\n inner(), slint::private_api::string_to_slice(global),\n slint::private_api::string_to_slice(prop_name))) {\n return Value(std::move(rval_inner));\n } else {\n return {};\n }\n }\n\n /// Like `set_callback()` but on a callback in the specified exported global singleton.\n ///\n /// Example: imagine the .slint file contains the given global:\n /// ```slint,no-preview\n /// export global Logic {\n /// pure callback to_uppercase(string) -> string;\n /// }\n /// ```\n /// Then you can set the callback handler\n /// ```cpp\n /// instance->set_global_callback(\"Logic\", \"to_uppercase\", [](auto args) {\n /// std::string arg1(*args[0].to_string());\n /// std::transform(arg1.begin(), arg1.end(), arg1.begin(), toupper);\n /// return SharedString(arg1);\n /// })\n /// ```\n ///\n /// **Note:** Only globals that are exported or re-exported from the main .slint file will\n /// be accessible\n template> F>\n bool set_global_callback(std::string_view global, std::string_view name, F callback) const\n {\n using namespace cbindgen_private;\n auto actual_cb =\n [](void *data,\n cbindgen_private::Slice> arg) {\n std::span args_view { reinterpret_cast(arg.ptr),\n arg.len };\n Value r = (*reinterpret_cast(data))(args_view);\n auto inner = r.inner;\n r.inner = cbindgen_private::slint_interpreter_value_new();\n return inner;\n };\n return cbindgen_private::slint_interpreter_component_instance_set_global_callback(\n inner(), slint::private_api::string_to_slice(global),\n slint::private_api::string_to_slice(name), actual_cb, new F(std::move(callback)),\n [](void *data) { delete reinterpret_cast(data); });\n }\n\n /// Invoke the specified callback or function declared in an exported global singleton\n std::optional invoke_global(std::string_view global, std::string_view callable_name,\n std::span args) const\n {\n using namespace cbindgen_private;\n Slice> args_view =\n slint::private_api::make_slice(\n reinterpret_cast *>(\n args.data()),\n args.size());\n if (cbindgen_private::Value *rval_inner =\n slint_interpreter_component_instance_invoke_global(\n inner(), slint::private_api::string_to_slice(global),\n slint::private_api::string_to_slice(callable_name), args_view)) {\n return Value(std::move(rval_inner));\n } else {\n return {};\n }\n }\n\n /// Return the ComponentDefinition that was used to create this instance.\n inline ComponentDefinition definition() const;\n};\n\n/// ComponentDefinition is a representation of a compiled component from .slint markup.\n///\n/// It can be constructed from a .slint file using the ComponentCompiler::build_from_path() or\n/// ComponentCompiler::build_from_source() functions. And then it can be instantiated with the\n/// create() function.\n///\n/// The ComponentDefinition acts as a factory to create new instances. When you've finished\n/// creating the instances it is safe to destroy the ComponentDefinition.\nclass ComponentDefinition\n{\n friend class ComponentCompiler;\n friend class ComponentInstance;\n\n using ComponentDefinitionOpaque = slint::cbindgen_private::ComponentDefinitionOpaque;\n ComponentDefinitionOpaque inner;\n\n ComponentDefinition() = delete;\n // Internal constructor that takes ownership of the component definition\n explicit ComponentDefinition(ComponentDefinitionOpaque &inner) : inner(inner) { }\n\npublic:\n /// Constructs a new ComponentDefinition as a copy of \\a other.\n ComponentDefinition(const ComponentDefinition &other)\n {\n slint_interpreter_component_definition_clone(&other.inner, &inner);\n }\n /// Assigns \\a other to this ComponentDefinition.\n ComponentDefinition &operator=(const ComponentDefinition &other)\n {\n using namespace slint::cbindgen_private;\n\n if (this == &other)\n return *this;\n\n slint_interpreter_component_definition_destructor(&inner);\n slint_interpreter_component_definition_clone(&other.inner, &inner);\n\n return *this;\n }\n /// Destroys this ComponentDefinition.\n ~ComponentDefinition() { slint_interpreter_component_definition_destructor(&inner); }\n /// Creates a new instance of the component and returns a shared handle to it.\n ComponentHandle create() const\n {\n union CI {\n cbindgen_private::ComponentInstance i;\n ComponentHandle result;\n ~CI() { result.~ComponentHandle(); }\n CI() { }\n } u;\n cbindgen_private::slint_interpreter_component_instance_create(&inner, &u.i);\n return u.result;\n }\n\n /// Returns a vector of PropertyDescriptor instances that describe the list of\n /// public properties that can be read and written using ComponentInstance::set_property and\n /// ComponentInstance::get_property.\n slint::SharedVector properties() const\n {\n slint::SharedVector props;\n cbindgen_private::slint_interpreter_component_definition_properties(&inner, &props);\n return props;\n }\n\n /// Returns a vector of strings that describe the list of public callbacks that can be invoked\n /// using ComponentInstance::invoke and set using ComponentInstance::set_callback.\n slint::SharedVector callbacks() const\n {\n slint::SharedVector callbacks;\n cbindgen_private::slint_interpreter_component_definition_callbacks(&inner, &callbacks);\n return callbacks;\n }\n\n /// Returns a vector of strings that describe the list of public functions that can be invoked\n /// using ComponentInstance::invoke.\n slint::SharedVector functions() const\n {\n slint::SharedVector functions;\n cbindgen_private::slint_interpreter_component_definition_functions(&inner, &functions);\n return functions;\n }\n\n /// Returns the name of this Component as written in the .slint file\n slint::SharedString name() const\n {\n slint::SharedString name;\n cbindgen_private::slint_interpreter_component_definition_name(&inner, &name);\n return name;\n }\n\n /// Returns a vector of strings with the names of all exported global singletons.\n slint::SharedVector globals() const\n {\n slint::SharedVector names;\n cbindgen_private::slint_interpreter_component_definition_globals(&inner, &names);\n return names;\n }\n\n /// Returns a vector of the property descriptors of the properties of the specified\n /// publicly exported global singleton. An empty optional is returned if there exists no\n /// exported global singleton under the specified name.\n std::optional>\n global_properties(std::string_view global_name) const\n {\n slint::SharedVector properties;\n if (cbindgen_private::slint_interpreter_component_definition_global_properties(\n &inner, slint::private_api::string_to_slice(global_name), &properties)) {\n return properties;\n }\n return {};\n }\n\n /// Returns a vector of the names of the callbacks of the specified publicly exported global\n /// singleton. An empty optional is returned if there exists no exported global singleton\n /// under the specified name.\n std::optional>\n global_callbacks(std::string_view global_name) const\n {\n slint::SharedVector names;\n if (cbindgen_private::slint_interpreter_component_definition_global_callbacks(\n &inner, slint::private_api::string_to_slice(global_name), &names)) {\n return names;\n }\n return {};\n }\n\n /// Returns a vector of the names of the functions of the specified publicly exported global\n /// singleton. An empty optional is returned if there exists no exported global singleton\n /// under the specified name.\n std::optional>\n global_functions(std::string_view global_name) const\n {\n slint::SharedVector names;\n if (cbindgen_private::slint_interpreter_component_definition_global_functions(\n &inner, slint::private_api::string_to_slice(global_name), &names)) {\n return names;\n }\n return {};\n }\n};\n\ninline ComponentDefinition ComponentInstance::definition() const\n{\n cbindgen_private::ComponentDefinitionOpaque result;\n cbindgen_private::slint_interpreter_component_instance_component_definition(inner(), &result);\n return ComponentDefinition(result);\n}\n\n/// ComponentCompiler is the entry point to the Slint interpreter that can be used\n/// to load .slint files or compile them on-the-fly from a string\n/// (using build_from_source()) or from a path (using build_from_source())\nclass ComponentCompiler\n{\n cbindgen_private::ComponentCompilerOpaque inner;\n\n ComponentCompiler(ComponentCompiler &) = delete;\n ComponentCompiler &operator=(ComponentCompiler &) = delete;\n\npublic:\n /// Constructs a new ComponentCompiler instance.\n ComponentCompiler() { cbindgen_private::slint_interpreter_component_compiler_new(&inner); }\n\n /// Destroys this ComponentCompiler.\n ~ComponentCompiler()\n {\n cbindgen_private::slint_interpreter_component_compiler_destructor(&inner);\n }\n\n /// Sets the include paths used for looking up `.slint` imports to the specified vector of\n /// paths.\n void set_include_paths(const slint::SharedVector &paths)\n {\n cbindgen_private::slint_interpreter_component_compiler_set_include_paths(&inner, &paths);\n }\n\n /// Sets the style to be used for widgets.\n void set_style(std::string_view style)\n {\n cbindgen_private::slint_interpreter_component_compiler_set_style(\n &inner, slint::private_api::string_to_slice(style));\n }\n\n /// Returns the widget style the compiler is currently using when compiling .slint files.\n slint::SharedString style() const\n {\n slint::SharedString s;\n cbindgen_private::slint_interpreter_component_compiler_get_style(&inner, &s);\n return s;\n }\n\n /// Sets the domain used for translations.\n void set_translation_domain(std::string_view domain)\n {\n cbindgen_private::slint_interpreter_component_compiler_set_translation_domain(\n &inner, slint::private_api::string_to_slice(domain));\n }\n\n /// Returns the include paths the component compiler is currently configured with.\n slint::SharedVector include_paths() const\n {\n slint::SharedVector paths;\n cbindgen_private::slint_interpreter_component_compiler_get_include_paths(&inner, &paths);\n return paths;\n }\n\n /// Returns the diagnostics that were produced in the last call to build_from_path() or\n /// build_from_source().\n slint::SharedVector diagnostics() const\n {\n slint::SharedVector result;\n cbindgen_private::slint_interpreter_component_compiler_get_diagnostics(&inner, &result);\n return result;\n }\n\n /// Compile a .slint file into a ComponentDefinition\n ///\n /// Returns the compiled `ComponentDefinition` if there were no errors.\n ///\n /// Any diagnostics produced during the compilation, such as warnings or errors, are collected\n /// in this ComponentCompiler and can be retrieved after the call using the diagnostics()\n /// function.\n ///\n /// Diagnostics from previous calls are cleared when calling this function.\n std::optional build_from_source(std::string_view source_code,\n std::string_view path)\n {\n cbindgen_private::ComponentDefinitionOpaque result;\n if (cbindgen_private::slint_interpreter_component_compiler_build_from_source(\n &inner, slint::private_api::string_to_slice(source_code),\n slint::private_api::string_to_slice(path), &result)) {\n\n return ComponentDefinition(result);\n } else {\n return {};\n }\n }\n\n /// Compile some .slint code into a ComponentDefinition\n ///\n /// The `path` argument will be used for diagnostics and to compute relative\n /// paths while importing.\n ///\n /// Any diagnostics produced during the compilation, such as warnings or errors, are collected\n /// in this ComponentCompiler and can be retrieved after the call using the\n /// Self::diagnostics() function.\n ///\n /// Diagnostics from previous calls are cleared when calling this function.\n std::optional build_from_path(std::string_view path)\n {\n cbindgen_private::ComponentDefinitionOpaque result;\n if (cbindgen_private::slint_interpreter_component_compiler_build_from_path(\n &inner, slint::private_api::string_to_slice(path), &result)) {\n\n return ComponentDefinition(result);\n } else {\n return {};\n }\n }\n};\n}\n\nnamespace slint::private_api::testing {\n/// Send a key events to the given component instance\ninline void send_keyboard_string_sequence(const slint::interpreter::ComponentInstance *component,\n const slint::SharedString &str)\n{\n const cbindgen_private::WindowAdapterRcOpaque *win_ptr = nullptr;\n cbindgen_private::slint_interpreter_component_instance_window(\n reinterpret_cast(component), &win_ptr);\n cbindgen_private::send_keyboard_string_sequence(\n &str, reinterpret_cast(win_ptr));\n}\n}\n\n#endif\n" }, { "path": "api/cpp/include/slint-platform.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint.h\"\n\n#include \n#include \n#include \n#include \n\nstruct xcb_connection_t;\nstruct wl_surface;\nstruct wl_display;\n\n#if defined(__APPLE__) && !defined(_WIN32) && !defined(_WIN64)\n# ifdef __OBJC__\n@class NSView;\n@class NSWindow;\n# else\ntypedef struct objc_object NSView;\ntypedef struct objc_object NSWindow;\n# endif\n#endif\n\nnamespace slint {\n\n/// Use the types in this namespace when implementing a custom Slint platform.\n///\n/// Slint comes with built-in support for different windowing systems, called backends. A backend\n/// is a module that implements the Platform interface in this namespace, interacts with a\n/// windowing system, and uses one of Slint's renderers to display a scene to the windowing system.\n/// A typical Slint application uses one of the built-in backends. Implement your own Platform if\n/// you're using Slint in an environment without a windowing system, such as with microcontrollers,\n/// or you're embedding a Slint UI as plugin in other applications.\n///\n/// Examples of custom platform implementation can be found in the Slint repository:\n/// - https://github.com/slint-ui/slint/tree/master/examples/cpp/platform_native\n/// - https://github.com/slint-ui/slint/tree/master/examples/cpp/platform_qt\n/// - https://github.com/slint-ui/slint/blob/master/api/cpp/esp-idf/slint/src/slint-esp.cpp\n///\n/// The entry point to re-implement a platform is the Platform class. Derive\n/// from slint::platform::Platform, and call slint::platform::set_platform\n/// to set it as the Slint platform.\n///\n/// Another important class to subclass is the WindowAdapter.\nnamespace platform {\n\n/// Internal interface for a renderer for use with the WindowAdapter.\n///\n/// This class is not intended to be re-implemented. In places where this class is required, use\n/// one of the existing implementations such as SoftwareRenderer or SkiaRenderer.\nclass AbstractRenderer\n{\nprivate:\n virtual ~AbstractRenderer() { }\n AbstractRenderer(const AbstractRenderer &) = delete;\n AbstractRenderer &operator=(const AbstractRenderer &) = delete;\n AbstractRenderer() = default;\n\n /// \\private\n virtual cbindgen_private::RendererPtr renderer_handle() const = 0;\n friend class WindowAdapter;\n friend class SoftwareRenderer;\n friend class SkiaRenderer;\n};\n\n/// Base class for the layer between a slint::Window and the windowing system specific window type,\n/// such as a Win32 `HWND` handle or a `wayland_surface_t`.\n///\n/// Re-implement this class to establish the link between the two, and pass messages in both\n/// directions:\n///\n/// - When receiving messages from the windowing system about state changes, such as the window\n/// being resized, the user requested the window to be closed, input being received, etc. you\n/// need to call the corresponding event functions on the Window, such as\n/// Window::dispatch_resize_event(), Window::dispatch_mouse_press_event(), or\n/// Window::dispatch_close_requested_event().\n///\n/// - Slint sends requests to change visibility, position, size, etc. via virtual functions such as\n/// set_visible(), set_size(), set_position(), or update_window_properties().\n/// Re-implement these functions and delegate the requests to the windowing system.\n///\n/// If the implementation of this bi-directional message passing protocol is incomplete, the user\n/// may experience unexpected behavior, or the intention of the developer calling functions on the\n/// Window API may not be fulfilled.\n///\n/// Your WindowAdapter subclass must hold a renderer (either a SoftwareRenderer or a SkiaRenderer).\n/// In the renderer() method, you must return a reference to it.\n///\n/// # Example\n/// ```cpp\n/// class MyWindowAdapter : public slint::platform::WindowAdapter {\n/// slint::platform::SoftwareRenderer m_renderer;\n/// NativeHandle m_native_window; // a handle to the native window\n/// public:\n/// void request_redraw() override { m_native_window.refresh(); }\n/// slint::PhysicalSize size() const override {\n/// return slint::PhysicalSize({m_native_window.width, m_native_window.height});\n/// }\n/// slint::platform::AbstractRenderer &renderer() override { return m_renderer; }\n/// void set_visible(bool v) override {\n/// if (v) {\n/// m_native_window.show();\n/// } else {\n/// m_native_window.hide();\n/// }\n/// }\n/// // ...\n/// void repaint_callback();\n/// }\n/// ```\n///\n/// Rendering is typically asynchronous, and your windowing system or event loop would invoke\n/// a callback when it is time to render.\n/// ```cpp\n/// void MyWindowAdapter::repaint_callback()\n/// {\n/// slint::platform::update_timers_and_animations();\n/// m_renderer.render(m_native_window.buffer(), m_native_window.width);\n/// // if animations are running, schedule the next frame\n/// if (window().has_active_animations()) m_native_window.refresh();\n/// }\n/// ```\nclass WindowAdapter\n{\n // This is a pointer to the rust window that own us.\n // Note that we do not have ownership (there is no reference increase for this)\n // because it would otherwise be a reference loop\n cbindgen_private::WindowAdapterRcOpaque self {};\n // Whether this WindowAdapter was already given to the slint runtime\n bool was_initialized = false;\n\n cbindgen_private::WindowAdapterRcOpaque initialize()\n {\n cbindgen_private::slint_window_adapter_new(\n this, [](void *wa) { delete reinterpret_cast(wa); },\n [](void *wa) {\n return reinterpret_cast(wa)->renderer().renderer_handle();\n },\n [](void *wa, bool visible) {\n reinterpret_cast(wa)->set_visible(visible);\n },\n [](void *wa) { reinterpret_cast(wa)->request_redraw(); },\n [](void *wa) -> cbindgen_private::IntSize {\n return reinterpret_cast(wa)->size();\n },\n [](void *wa, cbindgen_private::IntSize size) {\n reinterpret_cast(wa)->set_size(\n slint::PhysicalSize({ size.width, size.height }));\n },\n [](void *wa, const cbindgen_private::WindowProperties *p) {\n reinterpret_cast(wa)->update_window_properties(\n *reinterpret_cast(p));\n },\n [](void *wa, cbindgen_private::Point2D *point) -> bool {\n if (auto pos = reinterpret_cast(wa)->position()) {\n *point = *pos;\n return true;\n } else {\n return false;\n }\n },\n [](void *wa, cbindgen_private::Point2D point) {\n reinterpret_cast(wa)->set_position(\n slint::PhysicalPosition({ point.x, point.y }));\n },\n &self);\n was_initialized = true;\n return self;\n }\n\n friend inline void set_platform(std::unique_ptr platform);\n\npublic:\n /// Construct a WindowAdapter\n explicit WindowAdapter() { }\n virtual ~WindowAdapter() = default;\n\n /// This function is called by Slint when the slint window is shown or hidden.\n ///\n /// Re-implement this function to forward the call to show/hide the native window\n ///\n /// When the window becomes visible, this is a good time to call\n /// slint::Window::dispatch_scale_factor_change_event to initialise the scale factor.\n virtual void set_visible(bool) { }\n\n /// This function is called when Slint detects that the window need to be repainted.\n ///\n /// Reimplement this function to forward the call to the window manager.\n ///\n /// You should not render the window in the implementation of this call. Instead you should\n /// do that in the next iteration of the event loop, or in a callback from the window manager.\n virtual void request_redraw() { }\n\n /// Request a new size for the window to the specified size on the screen, in physical or\n /// logical pixels and excluding a window frame (if present).\n ///\n /// This is called from slint::Window::set_size().\n ///\n /// The default implementation does nothing\n ///\n /// This function should send the size to the Windowing system. If the window size actually\n /// changes, you should call slint::Window::dispatch_resize_event to propagate the new size\n /// to the slint view.\n virtual void set_size(slint::PhysicalSize) { }\n\n /// Returns the actual physical size of the window\n virtual slint::PhysicalSize size() = 0;\n\n /// Sets the position of the window on the screen, in physical screen coordinates and including\n /// a window frame (if present).\n ///\n /// The default implementation does nothing\n ///\n /// Called from slint::Window::set_position().\n virtual void set_position(slint::PhysicalPosition) { }\n\n /// Returns the position of the window on the screen, in physical screen coordinates and\n /// including a window frame (if present).\n ///\n /// The default implementation returns std::nullopt.\n ///\n /// Called from slint::Window::position().\n virtual std::optional position() { return std::nullopt; }\n\n /// This struct contains getters that provide access to properties of the Window\n /// element, and is used with WindowAdapter::update_window_properties().\n struct WindowProperties\n {\n /// Returns the title of the window.\n SharedString title() const\n {\n SharedString out;\n cbindgen_private::slint_window_properties_get_title(inner(), &out);\n return out;\n }\n\n /// Returns the background brush of the window.\n Brush background() const\n {\n Brush out;\n cbindgen_private::slint_window_properties_get_background(inner(), &out);\n return out;\n }\n\n /// \\deprecated Use is_fullscreen() instead\n [[deprecated(\"Renamed is_fullscreen()\")]] bool fullscreen() const\n {\n return is_fullscreen();\n }\n\n /// Returns true if the window should be shown fullscreen; false otherwise.\n bool is_fullscreen() const\n {\n return cbindgen_private::slint_window_properties_get_fullscreen(inner());\n }\n\n /// Returns true if the window should be minimized; false otherwise\n bool is_minimized() const\n {\n return cbindgen_private::slint_window_properties_get_minimized(inner());\n }\n\n /// Returns true if the window should be maximized; false otherwise\n bool is_maximized() const\n {\n return cbindgen_private::slint_window_properties_get_maximized(inner());\n }\n\n /// This struct describes the layout constraints of a window.\n ///\n /// It is the return value of WindowProperties::layout_constraints().\n struct LayoutConstraints\n {\n /// This represents the minimum size the window can be. If this is set, the window\n /// should not be able to be resized smaller than this size. If it is left unset, there\n /// is no minimum size.\n std::optional min;\n /// This represents the maximum size the window can be. If this is set, the window\n /// should not be able to be resized larger than this size. If it is left unset, there\n /// is no maximum size.\n std::optional max;\n /// This represents the preferred size of the window. This is the size of the window\n /// should have by default\n LogicalSize preferred;\n };\n\n /// Returns the layout constraints of the window\n LayoutConstraints layout_constraints() const\n {\n auto lc = cbindgen_private::slint_window_properties_get_layout_constraints(inner());\n return LayoutConstraints {\n .min = lc.has_min ? std::optional(LogicalSize(lc.min)) : std::nullopt,\n .max = lc.has_max ? std::optional(LogicalSize(lc.max)) : std::nullopt,\n .preferred = LogicalSize(lc.preferred)\n };\n }\n\n private:\n /// This struct is opaque and cannot be constructed by C++\n WindowProperties() = delete;\n ~WindowProperties() = delete;\n WindowProperties(const WindowProperties &) = delete;\n WindowProperties &operator=(const WindowProperties &) = delete;\n const cbindgen_private::WindowProperties *inner() const\n {\n return reinterpret_cast(this);\n }\n };\n\n /// Re-implement this function to update the properties such as window title or layout\n /// constraints.\n ///\n /// This function is called before `set_visible(true)`, and will be called again when the\n /// properties that were queried on the last call are changed. If you do not query any\n /// properties, it may not be called again.\n virtual void update_window_properties(const WindowProperties &) { }\n\n /// Re-implement this function to provide a reference to the renderer for use with the window\n /// adapter.\n ///\n /// Your re-implementation should contain a renderer such as SoftwareRenderer or SkiaRenderer\n /// and you must return a reference to it.\n virtual AbstractRenderer &renderer() = 0;\n\n /// Return the slint::Window associated with this window.\n ///\n /// Note that this function can only be called if the window was initialized, which is only\n /// the case after it has been returned from a call to Platform::create_window_adapter\n const Window &window() const\n {\n if (!was_initialized)\n std::abort();\n // This works because cbindgen_private::WindowAdapterRcOpaque and Window have the same\n // layout\n return *reinterpret_cast(&self);\n }\n\n /// Overload\n Window &window()\n {\n if (!was_initialized)\n std::abort();\n // This works because cbindgen_private::WindowAdapterRcOpaque and Window have the same\n // layout\n return *reinterpret_cast(&self);\n }\n};\n\n/// The platform acts as a factory to create WindowAdapter instances.\n///\n/// Call slint::platform::set_platform() before creating any other Slint handles. Any subsequently\n/// created Slint windows will use the WindowAdapter provided by the create_window_adapter function.\nclass Platform\n{\npublic:\n virtual ~Platform() = default;\n Platform(const Platform &) = delete;\n Platform &operator=(const Platform &) = delete;\n Platform() = default;\n\n /// Returns a new WindowAdapter\n virtual std::unique_ptr create_window_adapter() = 0;\n\n#if defined(SLINT_FEATURE_FREESTANDING) || defined(DOXYGEN)\n /// Returns the amount of milliseconds since start of the application.\n ///\n /// This function should only be implemented if the runtime is compiled with\n /// SLINT_FEATURE_FREESTANDING\n virtual std::chrono::milliseconds duration_since_start() = 0;\n#endif\n\n /// The type of clipboard used in Platform::clipboard_text and PLatform::set_clipboard_text.\n enum class Clipboard {\n /// This is the default clipboard used for text action for Ctrl+V, Ctrl+C.\n /// Corresponds to the secondary selection on X11.\n DefaultClipboard = static_cast(cbindgen_private::Clipboard::DefaultClipboard),\n /// This is the clipboard that is used when text is selected\n /// Corresponds to the primary selection on X11.\n /// The Platform implementation should do nothing if copy on select is not supported on that\n /// platform.\n SelectionClipboard = static_cast(cbindgen_private::Clipboard::SelectionClipboard),\n };\n\n /// Sends the given text into the system clipboard.\n ///\n /// If the platform doesn't support the specified clipboard, this function should do nothing\n virtual void set_clipboard_text(const SharedString &, Clipboard) { }\n\n /// Returns a copy of text stored in the system clipboard, if any.\n ///\n /// If the platform doesn't support the specified clipboard, the function should return nullopt\n virtual std::optional clipboard_text(Clipboard) { return {}; }\n\n /// Spins an event loop and renders the visible windows.\n virtual void run_event_loop() { }\n\n /// Exits the event loop.\n ///\n /// This is what is called by slint::quit_event_loop() and can be called from a different thread\n /// or re-enter from the event loop\n virtual void quit_event_loop() { }\n\n /// A task that is passed to the Platform::run_in_event_loop function and needs to be\n /// run in the event loop and not in any other thread.\n class Task\n {\n cbindgen_private::PlatformTaskOpaque inner { nullptr, nullptr };\n friend inline void set_platform(std::unique_ptr platform);\n explicit Task(cbindgen_private::PlatformTaskOpaque inner) : inner(inner) { }\n\n public:\n ~Task()\n {\n if (inner._0) {\n cbindgen_private::slint_platform_task_drop(\n std::exchange(inner, { nullptr, nullptr }));\n }\n }\n Task(const Task &) = delete;\n Task &operator=(const Task &) = delete;\n /// Move constructor. A moved from Task can no longer be run.\n Task(Task &&other) : inner(other.inner) { other.inner = { nullptr, nullptr }; }\n /// Move operator.\n Task &operator=(Task &&other)\n {\n std::swap(other.inner, inner);\n return *this;\n }\n\n /// Run the task.\n ///\n /// Can only be invoked once and should only be called from the event loop.\n void run() &&\n {\n private_api::assert_main_thread();\n assert(inner._0 && \"calling invoke form a moved-from Task\");\n if (inner._0) {\n cbindgen_private::slint_platform_task_run(\n std::exchange(inner, { nullptr, nullptr }));\n }\n };\n };\n\n /// Run a task from the event loop.\n ///\n /// This function is called by slint::invoke_from_event_loop().\n /// It can be called from any thread, but the passed function must only be called\n /// from the event loop.\n /// Reimplements this function and moves the event to the event loop before calling\n /// Task::run()\n virtual void run_in_event_loop(Task) { }\n};\n\n/// Registers the platform with Slint. Must be called before Slint windows are created.\n/// Can only be called once in an application.\ninline void set_platform(std::unique_ptr platform)\n{\n cbindgen_private::slint_platform_register(\n platform.release(), [](void *p) { delete reinterpret_cast(p); },\n [](void *p, cbindgen_private::WindowAdapterRcOpaque *out) {\n auto w = reinterpret_cast(p)->create_window_adapter();\n *out = w->initialize();\n (void)w.release();\n },\n []([[maybe_unused]] void *p) -> uint64_t {\n#ifndef SLINT_FEATURE_FREESTANDING\n return 0;\n#else\n return reinterpret_cast(p)->duration_since_start().count();\n#endif\n },\n [](void *p, const SharedString *text, cbindgen_private::Clipboard clipboard) {\n reinterpret_cast(p)->set_clipboard_text(\n *text, static_cast(clipboard));\n },\n [](void *p, SharedString *out_text, cbindgen_private::Clipboard clipboard) -> bool {\n auto maybe_clipboard = reinterpret_cast(p)->clipboard_text(\n static_cast(clipboard));\n\n bool status = maybe_clipboard.has_value();\n if (status)\n *out_text = *maybe_clipboard;\n return status;\n },\n [](void *p) { return reinterpret_cast(p)->run_event_loop(); },\n [](void *p) { return reinterpret_cast(p)->quit_event_loop(); },\n [](void *p, cbindgen_private::PlatformTaskOpaque event) {\n return reinterpret_cast(p)->run_in_event_loop(Platform::Task(event));\n });\n}\n\n#ifdef SLINT_FEATURE_RENDERER_SOFTWARE\n\n/// A 16bit pixel that has 5 red bits, 6 green bits and 5 blue bits\nstruct Rgb565Pixel\n{\n /// The blue component, encoded in 5 bits.\n uint16_t b : 5;\n /// The green component, encoded in 6 bits.\n uint16_t g : 6;\n /// The red component, encoded in 5 bits.\n uint16_t r : 5;\n\n /// Default constructor.\n constexpr Rgb565Pixel() : b(0), g(0), r(0) { }\n\n /// \\brief Constructor that constructs from an Rgb8Pixel.\n explicit constexpr Rgb565Pixel(const Rgb8Pixel &pixel)\n : b(pixel.b >> 3), g(pixel.g >> 2), r(pixel.r >> 3)\n {\n }\n\n /// \\brief Get the red component as an 8-bit value.\n ///\n /// The bits are shifted so that the result is between 0 and 255.\n /// \\return The red component as an 8-bit value.\n constexpr uint8_t red() const { return (r << 3) | (r >> 2); }\n\n /// \\brief Get the green component as an 8-bit value.\n ///\n /// The bits are shifted so that the result is between 0 and 255.\n /// \\return The green component as an 8-bit value.\n constexpr uint8_t green() const { return (g << 2) | (g >> 4); }\n\n /// \\brief Get the blue component as an 8-bit value.\n ///\n /// The bits are shifted so that the result is between 0 and 255.\n /// \\return The blue component as an 8-bit value.\n constexpr uint8_t blue() const { return (b << 3) | (b >> 2); }\n\n /// \\brief Convert to Rgb8Pixel.\n constexpr operator Rgb8Pixel() const { return { red(), green(), blue() }; }\n\n /// Returns true if \\a lhs \\a rhs are pixels with identical colors.\n friend bool operator==(const Rgb565Pixel &lhs, const Rgb565Pixel &rhs) = default;\n};\n\n/// Slint's software renderer.\n///\n/// To be used as a template parameter of the WindowAdapter.\n///\n/// Use the render() function to render in a buffer\nclass SoftwareRenderer : public AbstractRenderer\n{\n mutable cbindgen_private::SoftwareRendererOpaque inner;\n\n /// \\private\n cbindgen_private::RendererPtr renderer_handle() const override\n {\n return cbindgen_private::slint_software_renderer_handle(inner);\n }\n\npublic:\n /// Represents a region on the screen, used for partial rendering.\n ///\n /// The region may be composed of multiple sub-regions.\n struct PhysicalRegion\n {\n /// Returns the size of the bounding box of this region.\n PhysicalSize bounding_box_size() const\n {\n if (inner.count == 0) {\n return PhysicalSize();\n }\n auto origin = bounding_box_origin();\n PhysicalSize size({ .width = uint32_t(inner.rectangles[0].max.x - origin.x),\n .height = uint32_t(inner.rectangles[0].max.y - origin.y) });\n for (size_t i = 1; i < inner.count; ++i) {\n size.width = std::max(size.width, uint32_t(inner.rectangles[i].max.x - origin.x));\n size.height = std::max(size.height, uint32_t(inner.rectangles[i].max.y - origin.y));\n }\n return size;\n }\n /// Returns the origin of the bounding box of this region.\n PhysicalPosition bounding_box_origin() const\n {\n if (inner.count == 0) {\n return PhysicalPosition();\n }\n PhysicalPosition origin(\n { .x = inner.rectangles[0].min.x, .y = inner.rectangles[0].min.y });\n for (size_t i = 1; i < inner.count; ++i) {\n origin.x = std::min(origin.x, inner.rectangles[i].min.x);\n origin.y = std::min(origin.y, inner.rectangles[i].min.y);\n }\n return origin;\n }\n\n /// Returns a view on all the rectangles in this region.\n /// The rectangles do not overlap.\n /// The returned type is a C++ view over PhysicalRegion::Rect structs.\n ///\n /// It can be used like so:\n /// ```cpp\n /// for (auto [origin, size] : region.rectangles()) {\n /// // Do something with the rect\n /// }\n /// ```\n auto rectangles() const\n {\n SharedVector rectangles;\n cbindgen_private::slint_software_renderer_region_to_rects(&inner, &rectangles);\n# if __cpp_lib_ranges >= 202110L // DR20 P2415R2\n using std::ranges::owning_view;\n# else\n struct owning_view : std::ranges::view_interface\n {\n SharedVector rectangles;\n owning_view(SharedVector &&rectangles)\n : rectangles(rectangles)\n {\n }\n auto begin() const { return rectangles.begin(); }\n auto end() const { return rectangles.end(); }\n };\n# endif\n return owning_view(std::move(rectangles)) | std::views::transform([](const auto &r) {\n return Rect { .origin = PhysicalPosition({ .x = r.x, .y = r.y }),\n .size = PhysicalSize({ .width = uint32_t(r.width),\n .height = uint32_t(r.height) }) };\n });\n }\n\n /// A Rectangle defined with an origin and a size.\n /// The PhysicalRegion::rectangles() function returns a view over them\n struct Rect\n {\n /// The origin of the rectangle.\n PhysicalPosition origin;\n /// The size of the rectangle.\n PhysicalSize size;\n };\n\n private:\n cbindgen_private::PhysicalRegion inner;\n friend class SoftwareRenderer;\n PhysicalRegion(cbindgen_private::PhysicalRegion inner) : inner(std::move(inner)) { }\n };\n\n /// This enum describes which parts of the buffer passed to the SoftwareRenderer may be\n /// re-used to speed up painting.\n enum class RepaintBufferType : uint32_t {\n /// The full window is always redrawn. No attempt at partial rendering will be made.\n NewBuffer = 0,\n /// Only redraw the parts that have changed since the previous call to render().\n ///\n /// This variant assumes that the same buffer is passed on every call to render() and\n /// that it still contains the previously rendered frame.\n ReusedBuffer = 1,\n\n /// Redraw the part that have changed since the last two frames were drawn.\n ///\n /// This is used when using double buffering and swapping of the buffers.\n SwappedBuffers = 2,\n };\n\n# ifdef SLINT_FEATURE_EXPERIMENTAL\n /// Representation of a texture to blend in the destination buffer.\n // (FIXME: this is currently opaque, but should be exposed)\n using DrawTextureArgs = cbindgen_private::DrawTextureArgs;\n /// Arguments for draw_rectagle\n using DrawRectangleArgs = cbindgen_private::DrawRectangleArgs;\n\n /// Abstract base class for a target pixel buffer where certain drawing operations can be\n /// delegated. Use this to implement support for hardware accelerators such as DMA2D, PPA, or\n /// PXP on Microcontrollers.\n ///\n /// **Note**: This class is still experimental - its API is subject to changes and not\n /// stabilized yet. To use the class, you must enable the `SLINT_FEATURE_EXPERIMENTAL=ON` CMake\n /// option.\n template\n struct TargetPixelBuffer\n {\n virtual ~TargetPixelBuffer() { }\n\n /// Returns a span of pixels for the specified line number.\n virtual std::span line_slice(std::size_t line_number) = 0;\n /// Returns the number of lines in the buffer. This is the height of the buffer in pixels.\n virtual std::size_t num_lines() = 0;\n\n /// Draw a portion of provided texture to the specified pixel coordinates.\n /// Each pixel of the texture is to be blended with the given colorize color as well as the\n /// alpha value.\n // FIXME: Texture is currently opaque, but should be exposed\n virtual bool draw_texture(const DrawTextureArgs &texture, const PhysicalRegion &clip) = 0;\n\n /// Fill the background of the buffer with the given brush.\n virtual bool fill_background(const Brush &brush, const PhysicalRegion &clip) = 0;\n\n /// Draw a rectangle specified by the DrawRectangleArgs. That rectangle must be clipped to\n /// the given region.\n virtual bool draw_rectangle(const DrawRectangleArgs &args, const PhysicalRegion &clip) = 0;\n\n private:\n friend class SoftwareRenderer;\n cbindgen_private::CppTargetPixelBuffer wrap()\n {\n return cbindgen_private::CppTargetPixelBuffer {\n .user_data = this,\n .line_slice =\n [](void *self, uintptr_t line_number, PixelType **slice_ptr,\n uintptr_t *slice_len) {\n auto *buffer = reinterpret_cast *>(self);\n auto slice = buffer->line_slice(line_number);\n *slice_ptr = slice.data();\n *slice_len = slice.size();\n },\n .num_lines =\n [](void *self) {\n auto *buffer = reinterpret_cast *>(self);\n return buffer->num_lines();\n },\n .fill_background =\n [](void *self, const Brush *brush,\n const cbindgen_private::PhysicalRegion *clip) {\n auto *buffer = reinterpret_cast *>(self);\n auto clip_region = PhysicalRegion { *clip };\n return buffer->fill_background(*brush, clip_region);\n },\n .draw_rectangle =\n [](void *self, const cbindgen_private::DrawRectangleArgs *args,\n const cbindgen_private::PhysicalRegion *clip) {\n auto *buffer = reinterpret_cast *>(self);\n auto clip_region = PhysicalRegion { *clip };\n return buffer->draw_rectangle(*args, clip_region);\n },\n .draw_texture =\n [](void *self, const cbindgen_private::DrawTextureArgs *texture,\n const cbindgen_private::PhysicalRegion *clip) {\n auto *buffer = reinterpret_cast *>(self);\n auto clip_region = PhysicalRegion { *clip };\n return buffer->draw_texture(*texture, clip_region);\n }\n };\n }\n };\n# endif\n\n virtual ~SoftwareRenderer() { cbindgen_private::slint_software_renderer_drop(inner); };\n SoftwareRenderer(const SoftwareRenderer &) = delete;\n SoftwareRenderer &operator=(const SoftwareRenderer &) = delete;\n /// Constructs a new SoftwareRenderer with the \\a buffer_type as strategy for handling the\n /// differences between rendering buffers.\n explicit SoftwareRenderer(RepaintBufferType buffer_type)\n {\n inner = cbindgen_private::slint_software_renderer_new(uint32_t(buffer_type));\n }\n\n /// Render the window scene into a pixel buffer\n ///\n /// The buffer must be at least as large as the associated slint::Window\n ///\n /// The stride is the amount of pixels between two lines in the buffer.\n /// It is must be at least as large as the width of the window.\n PhysicalRegion render(std::span buffer, std::size_t pixel_stride) const\n {\n auto r = cbindgen_private::slint_software_renderer_render_rgb8(inner, buffer.data(),\n buffer.size(), pixel_stride);\n return PhysicalRegion { r };\n }\n\n /// Render the window scene into an RGB 565 encoded pixel buffer\n ///\n /// The buffer must be at least as large as the associated slint::Window\n ///\n /// The stride is the amount of pixels between two lines in the buffer.\n /// It is must be at least as large as the width of the window.\n PhysicalRegion render(std::span buffer, std::size_t pixel_stride) const\n {\n auto r = cbindgen_private::slint_software_renderer_render_rgb565(\n inner, reinterpret_cast(buffer.data()), buffer.size(), pixel_stride);\n return PhysicalRegion { r };\n }\n\n /// Render the window scene, line by line. The provided Callback will be invoked for each line\n /// that needs to rendered.\n ///\n /// The renderer uses a cache internally and will only render the part of the window\n /// which are dirty.\n ///\n /// This function returns the physical region that was rendered considering the rotation.\n ///\n /// The callback must be an invocable with the signature (size_t line, size_t begin, size_t end,\n /// auto render_fn). It is invoked with the line number as first parameter, and the start x and\n /// end x coordinates of the line as second and third parameter. The implementation must provide\n /// a line buffer (as std::span) and invoke the provided fourth parameter (render_fn) with it,\n /// to fill it with pixels. After the line buffer is filled with pixels, your implementation is\n /// free to flush that line to the screen for display.\n ///\n /// The first template parameter (PixelType) must be specified and can be either Rgb565Pixel or\n /// Rgb8Pixel.\n template\n# if !defined(__clang__) || __clang_major__ >= 17\n requires requires(Callback callback) {\n callback(size_t(0), size_t(0), size_t(0), [&callback](std::span) {});\n }\n# endif\n PhysicalRegion render_by_line(Callback process_line_callback) const\n {\n auto process_line_fn = [](void *process_line_callback_ptr, uintptr_t line,\n uintptr_t line_start, uintptr_t line_end,\n void (*render_fn)(const void *, PixelType *, std::size_t),\n const void *render_fn_data) {\n (*reinterpret_cast(process_line_callback_ptr))(\n std::size_t(line), std::size_t(line_start), std::size_t(line_end),\n [render_fn, render_fn_data](std::span line_span) {\n render_fn(render_fn_data, line_span.data(), line_span.size());\n });\n };\n\n if constexpr (std::is_same_v) {\n return PhysicalRegion { cbindgen_private::slint_software_renderer_render_by_line_rgb565(\n inner, process_line_fn, &process_line_callback) };\n } else if constexpr (std::is_same_v) {\n return PhysicalRegion { cbindgen_private::slint_software_renderer_render_by_line_rgb8(\n inner, process_line_fn, &process_line_callback) };\n } else {\n static_assert(std::is_same_v\n || std::is_same_v,\n \"Unsupported PixelType. It must be either Rgba8Pixel or Rgb565Pixel\");\n }\n }\n\n# ifdef SLINT_FEATURE_EXPERIMENTAL\n /// Renders into the given TargetPixelBuffer.\n ///\n /// **Note**: This class is still experimental - its API is subject to changes and not\n /// stabilized yet. To use the class, you must enable the `SLINT_FEATURE_EXPERIMENTAL=ON` CMake\n /// option.\n PhysicalRegion render(TargetPixelBuffer *buffer) const\n {\n auto wrapper = buffer->wrap();\n auto r = cbindgen_private::slint_software_renderer_render_accel_rgb8(inner, &wrapper);\n return PhysicalRegion { r };\n }\n\n /// Renders into the given TargetPixelBuffer.\n ///\n /// **Note**: This class is still experimental - its API is subject to changes and not\n /// stabilized yet. To use the class, you must enable the `SLINT_FEATURE_EXPERIMENTAL=ON` CMake\n /// option.\n PhysicalRegion render(TargetPixelBuffer *buffer) const\n {\n auto wrapper = buffer->wrap();\n auto r = cbindgen_private::slint_software_renderer_render_accel_rgb565(inner, &wrapper);\n return PhysicalRegion { r };\n }\n# endif\n\n /// This enum describes the rotation that is applied to the buffer when rendering.\n /// To be used in set_rendering_rotation()\n enum class RenderingRotation {\n /// No rotation\n NoRotation = 0,\n /// Rotate 90° to the left\n Rotate90 = 90,\n /// 180° rotation (upside-down)\n Rotate180 = 180,\n /// Rotate 90° to the right\n Rotate270 = 270,\n };\n\n /// Set how the window needs to be rotated in the buffer.\n ///\n /// This is typically used to implement screen rotation in software\n void set_rendering_rotation(RenderingRotation rotation)\n {\n cbindgen_private::slint_software_renderer_set_rendering_rotation(\n inner, static_cast(rotation));\n }\n};\n#endif\n\n#ifdef SLINT_FEATURE_RENDERER_SKIA\n/// An opaque, low-level window handle that internalizes everything necessary to exchange messages\n/// with the windowing system. This includes the connection to the display server, if necessary.\n///\n/// Note that this class does not provide any kind of ownership. The caller is responsible for\n/// ensuring that the pointers supplied to the constructor are valid throughout the lifetime of the\n/// NativeWindowHandle.\nclass NativeWindowHandle\n{\n cbindgen_private::CppRawHandleOpaque inner;\n friend class SkiaRenderer;\n\n NativeWindowHandle(cbindgen_private::CppRawHandleOpaque inner) : inner(inner) { }\n\npublic:\n NativeWindowHandle() = delete;\n NativeWindowHandle(const NativeWindowHandle &) = delete;\n NativeWindowHandle &operator=(const NativeWindowHandle &) = delete;\n /// Creates a new NativeWindowHandle by moving the handle data from \\a other into this\n /// NativeWindowHandle.\n NativeWindowHandle(NativeWindowHandle &&other) { inner = std::exchange(other.inner, nullptr); }\n /// Creates a new NativeWindowHandle by moving the handle data from \\a other into this\n /// NativeWindowHandle.\n NativeWindowHandle &operator=(NativeWindowHandle &&other)\n {\n if (this == &other) {\n return *this;\n }\n if (inner) {\n cbindgen_private::slint_raw_window_handle_drop(inner);\n }\n inner = std::exchange(other.inner, nullptr);\n return *this;\n }\n\n# if (!defined(__APPLE__) && !defined(_WIN32) && !defined(_WIN64)) || defined(DOXYGEN)\n /// Creates a new NativeWindowHandle from the given xcb_window_t \\a window,\n /// xcb_visualid_t \\a visual_id, XCB \\a connection, and \\a screen number.\n static NativeWindowHandle from_x11_xcb(uint32_t /*xcb_window_t*/ window,\n uint32_t /*xcb_visualid_t*/ visual_id,\n xcb_connection_t *connection, int screen)\n {\n\n return { cbindgen_private::slint_new_raw_window_handle_x11_xcb(window, visual_id,\n connection, screen) };\n }\n\n /// Creates a new NativeWindowHandle from the given XLib \\a window,\n /// VisualID \\a visual_id, Display \\a display, and \\a screen number.\n static NativeWindowHandle from_x11_xlib(uint32_t /*Window*/ window,\n unsigned long /*VisualID*/ visual_id,\n void /*Display*/ *display, int screen)\n {\n\n return { cbindgen_private::slint_new_raw_window_handle_x11_xlib(window, visual_id, display,\n screen) };\n }\n\n /// Creates a new NativeWindowHandle from the given wayland \\a surface,\n /// and \\a display.\n static NativeWindowHandle from_wayland(wl_surface *surface, wl_display *display)\n {\n\n return { cbindgen_private::slint_new_raw_window_handle_wayland(surface, display) };\n }\n\n# endif\n# if (defined(__APPLE__) && !defined(_WIN32) && !defined(_WIN64)) || defined(DOXYGEN)\n\n /// Creates a new NativeWindowHandle from the given \\a nsview, and \\a nswindow.\n static NativeWindowHandle from_appkit(NSView *nsview, NSWindow *nswindow)\n {\n\n return { cbindgen_private::slint_new_raw_window_handle_appkit(nsview, nswindow) };\n }\n\n# endif\n# if (!defined(__APPLE__) && (defined(_WIN32) || defined(_WIN64))) || defined(DOXYGEN)\n\n /// Creates a new NativeWindowHandle from the given HWND \\a hwnd, and HINSTANCE \\a hinstance.\n static NativeWindowHandle from_win32(void *hwnd, void *hinstance)\n {\n return { cbindgen_private::slint_new_raw_window_handle_win32(hwnd, hinstance) };\n }\n# endif\n /// Destroys the NativeWindowHandle.\n ~NativeWindowHandle()\n {\n if (inner) {\n cbindgen_private::slint_raw_window_handle_drop(inner);\n }\n }\n};\n\n/// Slint's Skia renderer.\n///\n/// Create the renderer when you have created a native window with a non-zero size.\n/// Call the render() function to render the scene into the window.\nclass SkiaRenderer : public AbstractRenderer\n{\n mutable cbindgen_private::SkiaRendererOpaque inner;\n\n /// \\private\n cbindgen_private::RendererPtr renderer_handle() const override\n {\n return cbindgen_private::slint_skia_renderer_handle(inner);\n }\n\npublic:\n virtual ~SkiaRenderer() { cbindgen_private::slint_skia_renderer_drop(inner); }\n SkiaRenderer(const SkiaRenderer &) = delete;\n SkiaRenderer &operator=(const SkiaRenderer &) = delete;\n /// Constructs a new Skia renderer for the given window - referenced by the provided\n /// WindowHandle - and the specified initial size.\n explicit SkiaRenderer(const NativeWindowHandle &window_handle, PhysicalSize initial_size)\n {\n inner = cbindgen_private::slint_skia_renderer_new(window_handle.inner, initial_size);\n }\n\n /// Renders the scene into the window provided to the SkiaRenderer's constructor.\n void render() const { cbindgen_private::slint_skia_renderer_render(inner); }\n};\n#endif\n\n/// Call this function at each iteration of the event loop to call the timer handler and advance\n/// the animations. This should be called before the rendering or processing input events\ninline void update_timers_and_animations()\n{\n cbindgen_private::slint_platform_update_timers_and_animations();\n}\n\n/// Returns the duration until the next timer if there are pending timers\ninline std::optional duration_until_next_timer_update()\n{\n uint64_t val = cbindgen_private::slint_platform_duration_until_next_timer_update();\n if (val == std::numeric_limits::max()) {\n return std::nullopt;\n } else if (val >= uint64_t(std::chrono::milliseconds::max().count())) {\n return std::chrono::milliseconds::max();\n } else {\n return std::chrono::milliseconds(val);\n }\n}\n}\n}\n" }, { "path": "api/cpp/include/slint-stm32.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \n#include \n#include \n#include \n\n#if !defined(SLINT_STM32_BSP_NAME)\n# error \"Please define the SLINT_STM32_BSP_NAME pre-processor macro to the base name of the BSP, without quotes, such as SLINT_STM32_BSP_NAME=stm32h747i_disco\"\n#endif\n\n#define SLINT_STRINGIFY(X) SLINT_STRINGIFY2(X)\n#define SLINT_STRINGIFY2(X) #X\n#define SLINT_CAT(X, Y) SLINT_CAT2(X, Y)\n#define SLINT_CAT2(X, Y) X##Y\n\n#include SLINT_STRINGIFY(SLINT_STM32_BSP_NAME.h)\n#include SLINT_STRINGIFY(SLINT_CAT(SLINT_STM32_BSP_NAME, _lcd.h))\n#include SLINT_STRINGIFY(SLINT_CAT(SLINT_STM32_BSP_NAME, _ts.h))\n\n#undef SLINT_STRINGIFY\n#undef SLINT_STRINGIFY2\n#undef SLINT_CAT\n#undef SLINT_CAT2\n\nstruct SlintPlatformConfiguration\n{\n /// The size of the screen in pixels.\n slint::PhysicalSize size\n#if defined(LCD_DEFAULT_WIDTH) && defined(LCD_DEFAULT_HEIGHT)\n = slint::PhysicalSize({ LCD_DEFAULT_WIDTH, LCD_DEFAULT_HEIGHT })\n#endif\n ;\n unsigned int lcd_layer_0_address =\n#if defined(LCD_LAYER_0_ADDRESS)\n LCD_LAYER_0_ADDRESS\n#else\n 0\n#endif\n ;\n unsigned int lcd_layer_1_address =\n#if defined(LCD_LAYER_0_ADDRESS)\n LCD_LAYER_1_ADDRESS\n#else\n 0\n#endif\n ;\n slint::platform::SoftwareRenderer::RenderingRotation rotation =\n slint::platform::SoftwareRenderer::RenderingRotation::NoRotation;\n};\n\nnamespace slint::private_api {\n\nstruct StmWindowAdapter : public slint::platform::WindowAdapter\n{\n slint::platform::SoftwareRenderer m_renderer {\n slint::platform::SoftwareRenderer::RepaintBufferType::SwappedBuffers\n };\n bool needs_redraw = true;\n const slint::PhysicalSize m_size;\n\n explicit StmWindowAdapter(slint::PhysicalSize size) : m_size(size) { }\n\n slint::platform::AbstractRenderer &renderer() override { return m_renderer; }\n\n slint::PhysicalSize size() override { return m_size; }\n\n void request_redraw() override { needs_redraw = true; }\n};\n\nstruct StmSlintPlatform : public slint::platform::Platform\n{\n using Pixel = slint::platform::Rgb565Pixel;\n\n static __IO bool screen_ready;\n\n StmWindowAdapter *m_window = nullptr;\n const slint::PhysicalSize size;\n slint::platform::SoftwareRenderer::RenderingRotation rotation;\n std::span buffer1;\n std::span buffer2;\n\n StmSlintPlatform(slint::PhysicalSize size,\n slint::platform::SoftwareRenderer::RenderingRotation rotation,\n std::span buffer1, std::span buffer2)\n : size(size), rotation(rotation), buffer1(buffer1), buffer2(buffer2)\n {\n BSP_LCD_LayerConfig_t config;\n config.X0 = 0;\n config.X1 = LCD_DEFAULT_WIDTH;\n config.Y0 = 0;\n config.Y1 = LCD_DEFAULT_HEIGHT;\n config.PixelFormat = LCD_PIXEL_FORMAT_RGB565;\n config.Address = uintptr_t(buffer1.data());\n BSP_LCD_ConfigLayer(0, 0, &config);\n HAL_LTDC_RegisterCallback(&hlcd_ltdc, HAL_LTDC_RELOAD_EVENT_CB_ID,\n [](auto *) { screen_ready = true; });\n }\n\n std::unique_ptr create_window_adapter() override\n {\n auto w = std::make_unique(size);\n w->m_renderer.set_rendering_rotation(rotation);\n m_window = w.get();\n return w;\n }\n\n std::chrono::milliseconds duration_since_start() override\n {\n return std::chrono::milliseconds(HAL_GetTick());\n }\n\n void run_event_loop() override\n {\n\n float last_touch_x = 0;\n float last_touch_y = 0;\n bool touch_down = false;\n\n while (true) {\n slint::platform::update_timers_and_animations();\n\n if (m_window) {\n TS_State_t TS_State {};\n BSP_TS_GetState(0, &TS_State);\n if (TS_State.TouchDetected) {\n auto scale_factor = m_window->window().scale_factor();\n last_touch_x = float(TS_State.TouchX) / scale_factor;\n last_touch_y = float(TS_State.TouchY) / scale_factor;\n\n m_window->window().dispatch_pointer_move_event(\n slint::LogicalPosition({ last_touch_x, last_touch_y }));\n if (!touch_down) {\n m_window->window().dispatch_pointer_press_event(\n slint::LogicalPosition({ last_touch_x, last_touch_y }),\n slint::PointerEventButton::Left);\n }\n touch_down = true;\n } else if (touch_down) {\n m_window->window().dispatch_pointer_release_event(\n slint::LogicalPosition({ last_touch_x, last_touch_y }),\n slint::PointerEventButton::Left);\n m_window->window().dispatch_pointer_exit_event();\n touch_down = false;\n }\n\n if (std::exchange(m_window->needs_redraw, false)) {\n while (!screen_ready) { }\n\n auto rotated = rotation\n == slint::platform::SoftwareRenderer::RenderingRotation::\n Rotate90\n || rotation\n == slint::platform::SoftwareRenderer::RenderingRotation::\n Rotate270;\n\n m_window->m_renderer.render(\n buffer1, rotated ? m_window->m_size.height : m_window->m_size.width);\n\n SCB_CleanDCache_by_Addr((uint32_t *)buffer1.data(), buffer1.size());\n\n BSP_LCD_Relaod(0, BSP_LCD_RELOAD_NONE);\n BSP_LCD_SetLayerAddress(0, 0, uintptr_t(buffer1.data()));\n screen_ready = false;\n BSP_LCD_Relaod(0, BSP_LCD_RELOAD_VERTICAL_BLANKING);\n\n std::swap(buffer1, buffer2);\n }\n }\n }\n }\n};\n\ninline __IO bool StmSlintPlatform::screen_ready = true;\n\n} // namespace slint::private_api\n\ninline void slint_stm32_init(const SlintPlatformConfiguration &config)\n{\n auto a = config.size.width * config.size.height;\n std::span buffer1(\n reinterpret_cast(\n config.lcd_layer_0_address),\n a);\n std::span buffer2(\n reinterpret_cast(\n config.lcd_layer_1_address),\n a);\n\n slint::platform::set_platform(std::make_unique(\n config.size, config.rotation, buffer1, buffer2));\n}\n" }, { "path": "api/cpp/include/slint-testing.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#include \"slint.h\"\n#include \"slint_testing_internal.h\"\n#include \n#include \n#include \n#include \n\n#ifdef SLINT_FEATURE_TESTING\n# ifdef SLINT_FEATURE_EXPERIMENTAL\n\n/// Use the functions and classes in this namespace for in-process UI testing.\n///\n/// This module is still experimental - its API is subject to changes and not stabilized yet. To\n/// use the module, you must enable the `SLINT_FEATURE_EXPERIMENTAL=ON` and `SLINT_FEATURE_TESTING`\n/// CMake options.\nnamespace slint::testing {\n\nusing slint::cbindgen_private::AccessibleRole;\nusing slint::cbindgen_private::LayoutKind;\n\n/// Init the testing backend.\n/// Should be called before any other Slint function that can access the platform.\n/// Then future windows will not appear on the screen anymore\ninline void init()\n{\n cbindgen_private::slint_testing_init_backend();\n}\n\n/// Replace the font collection with embedded NotoSans fonts for deterministic test results.\ninline void configure_test_fonts()\n{\n cbindgen_private::slint_testing_configure_test_fonts();\n}\n\n/// A handle to an element for querying accessible properties, intended for testing purposes.\nclass ElementHandle\n{\n cbindgen_private::ElementHandle inner;\n\n explicit ElementHandle(const cbindgen_private::ElementHandle *inner) : inner(*inner) { }\n\npublic:\n /// Visits visible elements within a component and calls the visitor for each of them.\n ///\n /// The visitor must be a callable object that accepts an `ElementHandle` and returns either\n /// `void`, or a type that can be converted to `bool`.\n /// - If the visitor returns `void`, the visitation continues until all elements have been\n /// visited.\n /// - If the visitor returns a type that can be converted to `bool`, the visitation continues as\n /// long as the conversion result is false; otherwise, it stops, returning that value.\n /// If the visitor never returns something that converts to true, then the function returns a\n /// default constructed value;\n ///\n /// ```cpp\n /// auto element = ElementHandle::visit_elements(component, [&](const ElementHandle& eh)\n /// -> std::optional {\n /// return eh.id() == \"Foo::bar\" ? std::make_optional(eh) : std::nullopt;\n /// });\n /// ```\n template Visitor,\n typename R = std::invoke_result_t>\n requires((std::is_constructible_v && std::is_default_constructible_v)\n || std::is_void_v)\n static auto visit_elements(const ComponentHandle &component, Visitor visitor)\n -> std::invoke_result_t\n {\n // using R = std::invoke_result_t;\n auto vrc = component.into_dyn();\n if constexpr (std::is_void_v) {\n cbindgen_private::slint_testing_element_visit_elements(\n &vrc, &visitor,\n [](void *visitor, const cbindgen_private::ElementHandle *element) {\n (*reinterpret_cast(visitor))(ElementHandle(element));\n return false;\n });\n return;\n } else {\n struct VisitorAndResult\n {\n Visitor &visitor;\n R result;\n } visitor_and_result { visitor, R {} };\n cbindgen_private::slint_testing_element_visit_elements(\n &vrc, &visitor_and_result,\n [](void *user_data, const cbindgen_private::ElementHandle *element) {\n auto visitor_and_result = reinterpret_cast(user_data);\n if (auto r = visitor_and_result->visitor(ElementHandle(element))) {\n visitor_and_result->result = std::move(r);\n return true;\n };\n return false;\n });\n return visitor_and_result.result;\n }\n }\n\n /// Find all elements matching the given accessible label.\n template\n static SharedVector find_by_accessible_label(const ComponentHandle &component,\n std::string_view label)\n {\n cbindgen_private::Slice label_view = private_api::string_to_slice(label);\n auto vrc = component.into_dyn();\n SharedVector result;\n cbindgen_private::slint_testing_element_find_by_accessible_label(\n &vrc, &label_view,\n reinterpret_cast *>(&result));\n return result;\n }\n\n /// Find all elements matching the given element_id.\n template\n static SharedVector find_by_element_id(const ComponentHandle &component,\n std::string_view element_id)\n {\n cbindgen_private::Slice element_id_view = private_api::string_to_slice(element_id);\n auto vrc = component.into_dyn();\n SharedVector result;\n cbindgen_private::slint_testing_element_find_by_element_id(\n &vrc, &element_id_view,\n reinterpret_cast *>(&result));\n return result;\n }\n\n /// Find all elements matching the given type name.\n template\n static SharedVector\n find_by_element_type_name(const ComponentHandle &component, std::string_view type_name)\n {\n cbindgen_private::Slice element_type_name_view =\n private_api::string_to_slice(type_name);\n auto vrc = component.into_dyn();\n SharedVector result;\n cbindgen_private::slint_testing_element_find_by_element_type_name(\n &vrc, &element_type_name_view,\n reinterpret_cast *>(&result));\n return result;\n }\n\n /// Returns true if the underlying element still exists; false otherwise.\n bool is_valid() const { return private_api::upgrade_item_weak(inner.item).has_value(); }\n\n /// Returns the element's qualified id. Returns None if the element is not valid anymore or the\n /// element does not have an id.\n /// A qualified id consists of the name of the surrounding component as well as the provided\n /// local name, separate by a double colon.\n ///\n /// ```slint,no-preview\n /// component PushButton {\n /// /* .. */\n /// }\n ///\n /// export component App {\n /// mybutton := PushButton { } // known as `App::mybutton`\n /// PushButton { } // no id\n /// }\n /// ```\n std::optional id() const\n {\n SharedString id;\n if (cbindgen_private::slint_testing_element_id(&inner, &id)) {\n return id;\n } else {\n return std::nullopt;\n }\n }\n\n /// Returns the element's type name; std::nullopt if the element is not valid anymore.\n /// ```slint,no-preview\n /// component PushButton {\n /// /* .. */\n /// }\n ///\n /// export component App {\n /// mybutton := PushButton { } // type_name is \"PushButton\"\n /// }\n /// ```\n std::optional type_name() const\n {\n SharedString type_name;\n if (cbindgen_private::slint_testing_element_type_name(&inner, &type_name)) {\n return type_name;\n } else {\n return std::nullopt;\n }\n }\n\n /// Returns the element's base types as an iterator; None if the element is not valid anymore.\n ///\n /// ```slint,no-preview\n /// component ButtonBase {\n /// /* .. */\n /// }\n ///\n /// component PushButton inherits ButtonBase {\n /// /* .. */\n /// }\n ///\n /// export component App {\n /// mybutton := PushButton { } // bases will be [\"ButtonBase\"]\n /// }\n /// ```\n std::optional> bases() const\n {\n SharedVector bases;\n if (cbindgen_private::slint_testing_element_bases(&inner, &bases)) {\n return bases;\n } else {\n return std::nullopt;\n }\n }\n\n /// Returns the layout kind if this element is a layout container;\n /// std::nullopt if the element is not a layout or is not valid anymore.\n std::optional layout_kind() const\n {\n LayoutKind kind {};\n if (cbindgen_private::slint_testing_element_layout_kind(&inner, &kind)) {\n return kind;\n } else {\n return std::nullopt;\n }\n }\n\n /// Returns the value of the element's `accessible-role` property, if present. Use this property\n /// to locate elements by their type/role, i.e. buttons, checkboxes, etc.\n std::optional accessible_role() const\n {\n if (inner.element_index != 0)\n return std::nullopt;\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n return item->item_tree.vtable()->accessible_role(item->item_tree.borrow(), item->index);\n }\n return std::nullopt;\n }\n\n /// Returns the accessible-label of that element, if any.\n std::optional accessible_label() const\n {\n return get_accessible_string_property(cbindgen_private::AccessibleStringProperty::Label);\n }\n\n /// Returns the accessible-enabled of that element, if any.\n std::optional accessible_enabled() const\n {\n return get_accessible_bool_property(cbindgen_private::AccessibleStringProperty::Enabled);\n }\n\n /// Returns the accessible-value of that element, if any.\n std::optional accessible_value() const\n {\n return get_accessible_string_property(cbindgen_private::AccessibleStringProperty::Value);\n }\n\n /// Returns the accessible-placeholder-text of that element, if any.\n std::optional accessible_placeholder_text() const\n {\n return get_accessible_string_property(\n cbindgen_private::AccessibleStringProperty::PlaceholderText);\n }\n\n /// Returns the accessible-description of that element, if any.\n std::optional accessible_description() const\n {\n return get_accessible_string_property(\n cbindgen_private::AccessibleStringProperty::Description);\n }\n\n /// Returns the accessible-id of that element, if any.\n std::optional accessible_id() const\n {\n return get_accessible_string_property(cbindgen_private::AccessibleStringProperty::Id);\n }\n\n /// Returns the accessible-value-maximum of that element, if any.\n std::optional accessible_value_maximum() const\n {\n if (auto result = get_accessible_string_property(\n cbindgen_private::AccessibleStringProperty::ValueMaximum)) {\n float value = 0.0;\n if (cbindgen_private::slint_string_to_float(&*result, &value)) {\n return value;\n }\n }\n return std::nullopt;\n }\n\n /// Returns the accessible-value-minimum of that element, if any.\n std::optional accessible_value_minimum() const\n {\n if (auto result = get_accessible_string_property(\n cbindgen_private::AccessibleStringProperty::ValueMinimum)) {\n float value = 0.0;\n if (cbindgen_private::slint_string_to_float(&*result, &value)) {\n return value;\n }\n }\n return std::nullopt;\n }\n\n /// Returns the accessible-value-step of that element, if any.\n std::optional accessible_value_step() const\n {\n if (auto result = get_accessible_string_property(\n cbindgen_private::AccessibleStringProperty::ValueStep)) {\n float value = 0.0;\n if (cbindgen_private::slint_string_to_float(&*result, &value)) {\n return value;\n }\n }\n return std::nullopt;\n }\n\n /// Returns the accessible-checked of that element, if any.\n std::optional accessible_checked() const\n {\n return get_accessible_bool_property(cbindgen_private::AccessibleStringProperty::Checked);\n }\n\n /// Returns the accessible-checkable of that element, if any.\n std::optional accessible_checkable() const\n {\n return get_accessible_bool_property(cbindgen_private::AccessibleStringProperty::Checkable);\n }\n\n /// Returns the accessible-item-selected of that element, if any.\n std::optional accessible_item_selected() const\n {\n return get_accessible_bool_property(\n cbindgen_private::AccessibleStringProperty::ItemSelected);\n }\n\n /// Returns the accessible-item-selectable of that element, if any.\n std::optional accessible_item_selectable() const\n {\n return get_accessible_bool_property(\n cbindgen_private::AccessibleStringProperty::ItemSelectable);\n }\n\n /// Returns the accessible-item-index of that element, if any.\n std::optional accessible_item_index() const\n {\n if (auto result = get_accessible_string_property(\n cbindgen_private::AccessibleStringProperty::ItemIndex)) {\n uintptr_t value = 0;\n if (cbindgen_private::slint_string_to_usize(&*result, &value)) {\n return value;\n }\n }\n return std::nullopt;\n }\n\n /// Returns the accessible-item-count of that element, if any.\n std::optional accessible_item_count() const\n {\n if (auto result = get_accessible_string_property(\n cbindgen_private::AccessibleStringProperty::ItemCount)) {\n uintptr_t value = 0;\n if (cbindgen_private::slint_string_to_usize(&*result, &value)) {\n return value;\n }\n }\n return std::nullopt;\n }\n\n /// Returns the accessible-expanded of that element, if any.\n std::optional accessible_expanded() const\n {\n return get_accessible_bool_property(cbindgen_private::AccessibleStringProperty::Expanded);\n }\n\n /// Returns the accessible-expandable of that element, if any.\n std::optional accessible_expandable() const\n {\n return get_accessible_bool_property(cbindgen_private::AccessibleStringProperty::Expandable);\n }\n\n /// Returns the accessible-read-only of that element, if any.\n std::optional accessible_read_only() const\n {\n return get_accessible_bool_property(cbindgen_private::AccessibleStringProperty::ReadOnly);\n }\n\n /// Invokes the expand accessibility action of that element\n /// (`accessible-action-expand`).\n void invoke_accessible_expand_action() const\n {\n if (inner.element_index != 0)\n return;\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n union ExpandActionHelper {\n cbindgen_private::AccessibilityAction action;\n ExpandActionHelper()\n {\n action.tag = cbindgen_private::AccessibilityAction::Tag::Expand;\n }\n ~ExpandActionHelper() { }\n\n } action;\n item->item_tree.vtable()->accessibility_action(item->item_tree.borrow(), item->index,\n &action.action);\n }\n }\n\n /// Sets the accessible-value of that element.\n ///\n /// Setting the value will invoke the `accessible-action-set-value` callback.\n void set_accessible_value(SharedString value) const\n {\n if (inner.element_index != 0)\n return;\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n union SetValueHelper {\n cbindgen_private::AccessibilityAction action;\n SetValueHelper(SharedString value)\n {\n new (&action.set_value) cbindgen_private::AccessibilityAction::SetValue_Body {\n cbindgen_private::AccessibilityAction::Tag::SetValue, std::move(value)\n };\n }\n ~SetValueHelper() { action.set_value.~SetValue_Body(); }\n\n } action(std::move(value));\n item->item_tree.vtable()->accessibility_action(item->item_tree.borrow(), item->index,\n &action.action);\n }\n }\n\n /// Invokes the increase accessibility action of that element\n /// (`accessible-action-increment`).\n void invoke_accessible_increment_action() const\n {\n if (inner.element_index != 0)\n return;\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n union IncreaseActionHelper {\n cbindgen_private::AccessibilityAction action;\n IncreaseActionHelper()\n {\n action.tag = cbindgen_private::AccessibilityAction::Tag::Increment;\n }\n ~IncreaseActionHelper() { }\n\n } action;\n item->item_tree.vtable()->accessibility_action(item->item_tree.borrow(), item->index,\n &action.action);\n }\n }\n\n /// Invokes the decrease accessibility action of that element\n /// (`accessible-action-decrement`).\n void invoke_accessible_decrement_action() const\n {\n if (inner.element_index != 0)\n return;\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n union DecreaseActionHelper {\n cbindgen_private::AccessibilityAction action;\n DecreaseActionHelper()\n {\n action.tag = cbindgen_private::AccessibilityAction::Tag::Decrement;\n }\n ~DecreaseActionHelper() { }\n\n } action;\n item->item_tree.vtable()->accessibility_action(item->item_tree.borrow(), item->index,\n &action.action);\n }\n }\n\n /// Invokes the default accessibility action of that element\n /// (`accessible-action-default`).\n void invoke_accessible_default_action() const\n {\n if (inner.element_index != 0)\n return;\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n union DefaultActionHelper {\n cbindgen_private::AccessibilityAction action;\n DefaultActionHelper()\n {\n action.tag = cbindgen_private::AccessibilityAction::Tag::Default;\n }\n ~DefaultActionHelper() { }\n\n } action;\n item->item_tree.vtable()->accessibility_action(item->item_tree.borrow(), item->index,\n &action.action);\n }\n }\n\n /// Returns the size of this element\n LogicalSize size() const\n {\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n auto rect =\n item->item_tree.vtable()->item_geometry(item->item_tree.borrow(), item->index);\n return LogicalSize({ rect.width, rect.height });\n }\n return LogicalSize({ 0, 0 });\n }\n\n /// Returns the absolute position of this element\n LogicalPosition absolute_position() const\n {\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n cbindgen_private::LogicalRect rect =\n item->item_tree.vtable()->item_geometry(item->item_tree.borrow(), item->index);\n cbindgen_private::LogicalPoint abs =\n slint::cbindgen_private::slint_item_absolute_position(&item->item_tree,\n item->index);\n return LogicalPosition({ abs.x + rect.x, abs.y + rect.y });\n }\n return LogicalPosition({ 0, 0 });\n }\n\nprivate:\n std::optional\n get_accessible_string_property(cbindgen_private::AccessibleStringProperty what) const\n {\n if (inner.element_index != 0)\n return std::nullopt;\n if (auto item = private_api::upgrade_item_weak(inner.item)) {\n SharedString result;\n if (item->item_tree.vtable()->accessible_string_property(item->item_tree.borrow(),\n item->index, what, &result)) {\n return result;\n }\n }\n return std::nullopt;\n }\n\n std::optional\n get_accessible_bool_property(cbindgen_private::AccessibleStringProperty what) const\n {\n if (auto result = get_accessible_string_property(what)) {\n if (*result == \"true\")\n return true;\n else if (*result == \"false\")\n return false;\n }\n return std::nullopt;\n }\n};\n}\n\n# endif // SLINT_FEATURE_EXPERIMENTAL\n#endif // SLINT_FEATURE_TESTING\n" }, { "path": "api/cpp/include/slint.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint_internal.h\"\n#include \"slint_platform_internal.h\"\n#include \"slint_qt_internal.h\"\n#include \"slint_window.h\"\n#include \"slint_models.h\"\n#include \"slint_item_tree.h\"\n\n#include \n#include \n#include \n#include \n\n#ifndef SLINT_FEATURE_FREESTANDING\n# include \n# include \n# include \n# include \n#endif\n\n/// \\rst\n/// The :code:`slint` namespace is the primary entry point into the Slint C++ API.\n/// All available types are in this namespace.\n///\n/// See the :doc:`Overview <../overview>` documentation for the C++ integration how\n/// to load :code:`.slint` designs.\n/// \\endrst\nnamespace slint {\n\nnamespace private_api {\n\n/// Convert a slint `{height: length, width: length, x: length, y: length}` to a Rect\ninline cbindgen_private::Rect convert_anonymous_rect(std::tuple tuple)\n{\n // alphabetical order\n auto [h, w, x, y] = tuple;\n return cbindgen_private::Rect { .x = x, .y = y, .width = w, .height = h };\n}\n\ninline void dealloc(const ItemTreeVTable *vtable, uint8_t *ptr,\n [[maybe_unused]] vtable::Layout layout)\n{\n vtable::dealloc(vtable, ptr, layout);\n}\n\ntemplate\ninline vtable::Layout drop_in_place(ItemTreeRef item_tree)\n{\n return vtable::drop_in_place(item_tree);\n}\n\n#if !defined(DOXYGEN)\n# if defined(_WIN32) || defined(_WIN64)\n// On Windows cross-dll data relocations are not supported:\n// https://docs.microsoft.com/en-us/cpp/c-language/rules-and-limitations-for-dllimport-dllexport?view=msvc-160\n// so we have a relocation to a function that returns the address we seek. That\n// relocation will be resolved to the locally linked stub library, the implementation of\n// which will be patched.\n# define SLINT_GET_ITEM_VTABLE(VTableName) slint::private_api::slint_get_##VTableName()\n# else\n# define SLINT_GET_ITEM_VTABLE(VTableName) (&slint::private_api::VTableName)\n# endif\n#endif // !defined(DOXYGEN)\n\ninline std::optional\nupgrade_item_weak(const cbindgen_private::ItemWeak &item_weak)\n{\n if (auto item_tree_strong = item_weak.item_tree.lock()) {\n return { { *item_tree_strong, item_weak.index } };\n } else {\n return std::nullopt;\n }\n}\n\ninline void debug(const SharedString &str)\n{\n cbindgen_private::slint_debug(&str);\n}\n\n} // namespace private_api\n\nnamespace cbindgen_private {\ninline LayoutInfo LayoutInfo::merge(const LayoutInfo &other) const\n{\n // Note: This \"logic\" is duplicated from LayoutInfo::merge in layout.rs.\n return LayoutInfo { std::min(max, other.max),\n std::min(max_percent, other.max_percent),\n std::max(min, other.min),\n std::max(min_percent, other.min_percent),\n std::max(preferred, other.preferred),\n std::min(stretch, other.stretch) };\n}\ninline bool operator==(const EasingCurve &a, const EasingCurve &b)\n{\n if (a.tag != b.tag) {\n return false;\n } else if (a.tag == EasingCurve::Tag::CubicBezier) {\n return std::equal(a.cubic_bezier._0, a.cubic_bezier._0 + 4, b.cubic_bezier._0);\n }\n return true;\n}\n}\n\nnamespace private_api {\n\ninline static void register_item_tree(const vtable::VRc *c,\n const std::optional &maybe_window)\n{\n const cbindgen_private::WindowAdapterRcOpaque *window_ptr =\n maybe_window.has_value() ? &maybe_window->window_handle().handle() : nullptr;\n cbindgen_private::slint_register_item_tree(c, window_ptr);\n}\n\ninline SharedVector solve_box_layout(const cbindgen_private::BoxLayoutData &data,\n cbindgen_private::Slice repeater_indices)\n{\n SharedVector result;\n cbindgen_private::Slice ri =\n make_slice(reinterpret_cast(repeater_indices.ptr), repeater_indices.len);\n cbindgen_private::slint_solve_box_layout(&data, ri, &result);\n return result;\n}\n\ninline SharedVector\norganize_grid_layout(cbindgen_private::Slice input_data,\n cbindgen_private::Slice repeater_indices,\n cbindgen_private::Slice repeater_steps)\n{\n SharedVector result;\n cbindgen_private::Slice ri =\n make_slice(reinterpret_cast(repeater_indices.ptr), repeater_indices.len);\n cbindgen_private::Slice rs =\n make_slice(reinterpret_cast(repeater_steps.ptr), repeater_steps.len);\n cbindgen_private::slint_organize_grid_layout(input_data, ri, rs, &result);\n return result;\n}\n\ninline SharedVector organize_dialog_button_layout(\n cbindgen_private::Slice input_data,\n cbindgen_private::Slice dialog_button_roles)\n{\n SharedVector result;\n cbindgen_private::slint_organize_dialog_button_layout(input_data, dialog_button_roles, &result);\n return result;\n}\n\ninline SharedVector\nsolve_grid_layout(const cbindgen_private::GridLayoutData &data,\n cbindgen_private::Slice constraints,\n cbindgen_private::Orientation orientation,\n cbindgen_private::Slice repeater_indices,\n cbindgen_private::Slice repeater_steps)\n{\n SharedVector result;\n cbindgen_private::Slice ri =\n make_slice(reinterpret_cast(repeater_indices.ptr), repeater_indices.len);\n cbindgen_private::Slice rs =\n make_slice(reinterpret_cast(repeater_steps.ptr), repeater_steps.len);\n cbindgen_private::slint_solve_grid_layout(&data, constraints, orientation, ri, rs, &result);\n return result;\n}\n\ninline cbindgen_private::LayoutInfo\ngrid_layout_info(const cbindgen_private::GridLayoutOrganizedData &organized_data,\n cbindgen_private::Slice constraints,\n cbindgen_private::Slice repeater_indices,\n cbindgen_private::Slice repeater_steps, float spacing,\n const cbindgen_private::Padding &padding,\n cbindgen_private::Orientation orientation)\n{\n cbindgen_private::Slice ri =\n make_slice(reinterpret_cast(repeater_indices.ptr), repeater_indices.len);\n cbindgen_private::Slice rs =\n make_slice(reinterpret_cast(repeater_steps.ptr), repeater_steps.len);\n return cbindgen_private::slint_grid_layout_info(&organized_data, constraints, ri, rs, spacing,\n &padding, orientation);\n}\n\ninline cbindgen_private::LayoutInfo\nbox_layout_info(cbindgen_private::Slice cells, float spacing,\n const cbindgen_private::Padding &padding,\n cbindgen_private::LayoutAlignment alignment)\n{\n return cbindgen_private::slint_box_layout_info(cells, spacing, &padding, alignment);\n}\n\ninline cbindgen_private::LayoutInfo\nbox_layout_info_ortho(cbindgen_private::Slice cells,\n const cbindgen_private::Padding &padding)\n{\n return cbindgen_private::slint_box_layout_info_ortho(cells, &padding);\n}\n\ninline SharedVector solve_flexbox_layout(const cbindgen_private::FlexBoxLayoutData &data,\n cbindgen_private::Slice repeater_indices)\n{\n SharedVector result;\n cbindgen_private::Slice ri =\n make_slice(reinterpret_cast(repeater_indices.ptr), repeater_indices.len);\n cbindgen_private::slint_solve_flexbox_layout(&data, ri, &result);\n return result;\n}\n\ninline cbindgen_private::LayoutInfo\nflexbox_layout_info(cbindgen_private::Slice cells_h,\n cbindgen_private::Slice cells_v,\n float spacing_h, float spacing_v, const cbindgen_private::Padding &padding_h,\n const cbindgen_private::Padding &padding_v,\n cbindgen_private::Orientation orientation,\n cbindgen_private::FlexDirection direction, float constraint_size,\n cbindgen_private::FlexWrap flex_wrap)\n{\n return cbindgen_private::slint_flexbox_layout_info(cells_h, cells_v, spacing_h, spacing_v,\n &padding_h, &padding_v, orientation,\n direction, constraint_size, flex_wrap);\n}\n\n/// Access the layout cache of an item within a repeater (standard cache)\ntemplate\ninline T layout_cache_access(const SharedVector &cache, int offset, int repeater_index,\n int entries_per_item)\n{\n size_t idx = size_t(cache[offset]) + repeater_index * entries_per_item;\n return idx < cache.size() ? cache[idx] : 0;\n}\n\n/// Access the layout cache of an item within a grid repeater (two-level indirection cache)\n/// Formula: cache[cache[jump_index] + repeater_index * stride + child_offset]\ntemplate\ninline T layout_cache_grid_repeater_access(const SharedVector &cache, size_t jump_index,\n size_t repeater_index, size_t stride,\n size_t child_offset)\n{\n size_t base = jump_index < cache.size() ? size_t(cache[jump_index]) : 0;\n size_t data_idx = base + repeater_index * stride + child_offset;\n return data_idx < cache.size() ? cache[data_idx] : 0;\n}\n\ntemplate\ninline cbindgen_private::LayoutInfo\nitem_layout_info(VT *itemvtable, ItemType *item_ptr, cbindgen_private::Orientation orientation,\n WindowAdapterRc *window_adapter, const ItemTreeRc &component_rc,\n uint32_t item_index)\n{\n cbindgen_private::ItemRc item_rc { component_rc, item_index };\n return itemvtable->layout_info({ itemvtable, item_ptr }, orientation, window_adapter, &item_rc);\n}\n} // namespace private_api\n\nnamespace private_api {\n\ntemplate\nunion MaybeUninitialized {\n T value;\n ~MaybeUninitialized() { }\n MaybeUninitialized() { }\n T take()\n {\n T result = std::move(value);\n value.~T();\n return result;\n }\n};\n\ninline vtable::VRc\ncreate_menu_wrapper(const ItemTreeRc &menu_item_tree,\n bool (*condition)(const ItemTreeRc *menu_tree) = nullptr)\n{\n MaybeUninitialized> maybe;\n cbindgen_private::slint_menus_create_wrapper(&menu_item_tree, &maybe.value, condition);\n return maybe.take();\n}\n\ninline void setup_popup_menu_from_menu_item_tree(\n const vtable::VRc &shared,\n Property>> &entries,\n Callback>(cbindgen_private::MenuEntry)>\n &sub_menu,\n Callback &activated)\n{\n using cbindgen_private::MenuEntry;\n entries.set_binding([shared] {\n SharedVector entries_sv;\n shared.vtable()->sub_menu(shared.borrow(), nullptr, &entries_sv);\n std::vector entries_vec(entries_sv.begin(), entries_sv.end());\n return std::make_shared>(std::move(entries_vec));\n });\n sub_menu.set_handler([shared](const auto &entry) {\n SharedVector entries_sv;\n shared.vtable()->sub_menu(shared.borrow(), &entry, &entries_sv);\n std::vector entries_vec(entries_sv.begin(), entries_sv.end());\n return std::make_shared>(std::move(entries_vec));\n });\n activated.set_handler(\n [shared](const auto &entry) { shared.vtable()->activate(shared.borrow(), &entry); });\n}\n\ninline SharedString translate(const SharedString &original, const SharedString &context,\n const SharedString &domain,\n cbindgen_private::Slice arguments, int n,\n const SharedString &plural)\n{\n SharedString result = original;\n cbindgen_private::slint_translate(&result, &context, &domain, arguments, n, &plural);\n return result;\n}\n\ninline StyledText parse_markdown(const SharedString &format_string,\n cbindgen_private::Slice args)\n{\n StyledText result;\n cbindgen_private::slint_parse_markdown(&format_string, args, &result);\n return result;\n}\n\ninline StyledText string_to_styled_text(SharedString text)\n{\n StyledText result;\n cbindgen_private::slint_string_to_styled_text(text, &result);\n return result;\n}\n\ninline SharedString translate_from_bundle(std::span strs,\n cbindgen_private::Slice arguments)\n{\n SharedString result;\n cbindgen_private::slint_translate_from_bundle(\n make_slice((reinterpret_cast(strs.data())), strs.size()),\n arguments, &result);\n return result;\n}\ninline SharedString\ntranslate_from_bundle_with_plural(std::span strs,\n std::span indices,\n std::span plural_rules,\n cbindgen_private::Slice arguments, int n)\n{\n SharedString result;\n cbindgen_private::Slice strs_slice =\n make_slice(reinterpret_cast(strs.data()), strs.size());\n cbindgen_private::Slice indices_slice =\n make_slice(reinterpret_cast(indices.data()), indices.size());\n cbindgen_private::Slice plural_rules_slice =\n make_slice(reinterpret_cast(plural_rules.data()),\n plural_rules.size());\n cbindgen_private::slint_translate_from_bundle_with_plural(\n strs_slice, indices_slice, plural_rules_slice, arguments, n, &result);\n return result;\n}\n\ninline SharedString keys_to_string(const cbindgen_private::Keys &keys)\n{\n SharedString result;\n cbindgen_private::slint_keys_to_string(&keys, &result);\n return result;\n}\n\ntemplate\ninline float get_resolved_default_font_size(const Component &component)\n{\n ItemTreeRc item_tree_rc = (*component.self_weak.lock()).into_dyn();\n return slint::cbindgen_private::slint_windowrc_resolved_default_font_size(&item_tree_rc);\n}\n\n} // namespace private_api\n\n// Translator API is currently considered experimental due to discussions\n// about the returned string type (SharedString vs. Cow etc.). Also it\n// is not available with no_std due to the tr crate.\n// See dicussion in https://github.com/slint-ui/slint/pull/10979.\n#if defined(SLINT_FEATURE_EXPERIMENTAL) && !defined(SLINT_FEATURE_FREESTANDING)\n/// Interface for an external translator.\nstruct Translator\n{\n /// Destroys the translator.\n virtual ~Translator() { }\n /// Translate a singular string. Arguments are passed as UTF-8 strings.\n /// Slint will call this method from the thread which runs the event loop.\n virtual SharedString translate(std::string_view string, std::string_view context) const = 0;\n /// Translate a plural string. Arguments are passed as UTF-8 strings.\n /// Slint will call this method from the thread which runs the event loop.\n virtual SharedString ntranslate(uint64_t n, std::string_view singular, std::string_view plural,\n std::string_view context) const = 0;\n};\n\nnamespace private_api {\n\n/// Helper to dispatch calls from the Rust translator to the C++ translator.\nstruct TranslatorDispatcher\n{\n static void drop(const void *obj) { delete cast(obj); }\n\n static void translate(const void *obj, private_api::Slice string,\n private_api::Slice context, slint::SharedString *out)\n {\n *out = cast(obj)->translate(private_api::slice_to_string_view(string),\n private_api::slice_to_string_view(context));\n }\n\n static void ntranslate(const void *obj, uint64_t n, private_api::Slice singular,\n private_api::Slice plural, private_api::Slice context,\n slint::SharedString *out)\n {\n *out = cast(obj)->ntranslate(n, private_api::slice_to_string_view(singular),\n private_api::slice_to_string_view(plural),\n private_api::slice_to_string_view(context));\n }\n\nprivate:\n static const Translator *cast(const void *obj) { return static_cast(obj); }\n};\n\n} // namespace private_api\n\n/// Register a custom translator.\n///\n/// Allows using a custom translation framework by implementing the\n/// `slint::Translator` interface. Passing `nullptr` will unregister any\n/// previously registered translator.\n///\n/// Returns `true` on success, `false` if no platform is available.\n///\n/// Safety & Ownership:\n/// * The ownership of the translator object is passed to Slint. It will be\n/// destroyed automatically when the program quits or when\n/// `set_external_translator()` is called the next time.\n/// * The methods on the translator object will be called from the thread\n/// which the Slint event loop is running.\n///\n/// The function is only available when Slint is compiled with\n/// `SLINT_FEATURE_EXPERIMENTAL` and without `SLINT_FEATURE_FREESTANDING`.\n///\n/// Note that this function has no effect if the `.slint` file was compiled\n/// with bundled translations.\n///\n/// Example:\n/// \\code\n/// struct MyTranslator : public slint::Translator {\n/// slint::SharedString translate(std::string_view string,\n/// std::string_view context) const override {\n/// return slint::SharedString(\"Singular String\");\n/// }\n///\n/// slint::SharedString ntranslate(uint64_t n,\n/// std::string_view singular,\n/// std::string_view plural,\n/// std::string_view context) const override {\n/// return slint::SharedString(\"Plural String\");\n/// }\n/// };\n///\n/// slint::set_external_translator(std::make_unique());\n/// \\endcode\ninline bool set_translator(std::unique_ptr obj)\n{\n const bool success = cbindgen_private::slint_translate_set_translator(\n obj.get(), &private_api::TranslatorDispatcher::drop,\n &private_api::TranslatorDispatcher::translate,\n &private_api::TranslatorDispatcher::ntranslate);\n if (success) {\n obj.release(); // Ownership is moved to Rust.\n }\n return success;\n}\n#endif\n\n/// Forces all the strings that are translated with `@tr(...)` to be re-evaluated.\n/// Call this function after changing the language at run-time and when translating\n/// with either gettext or a custom translator. For bundled translations, there is no need\n/// to call this function.\n///\n/// Example (assuming usage of gettext):\n/// ```cpp\n/// my_ui->global().on_french_selected([] {\n/// setenv(\"LANGUAGE\", langs[l], true);\n/// slint::update_all_translations();\n/// });\n/// ```\ninline void update_all_translations()\n{\n cbindgen_private::slint_translations_mark_dirty();\n}\n\n/// Select the current translation language when using bundled translations.\n/// This function requires that the application's `.slint` file was compiled with bundled\n/// translations. It must be called after creating the first component.\n///\n/// The language string is the locale, which matches the name of the folder that contains the\n/// `LC_MESSAGES` folder. An empty string or `\"en\"` will select the default language.\n///\n/// Returns true if the language was selected; false if the language was not found in the list of\n/// bundled translations.\ninline bool select_bundled_translation(std::string_view language)\n{\n return cbindgen_private::slint_translate_select_bundled_translation(\n slint::private_api::string_to_slice(language));\n}\n\n#if !defined(DOXYGEN)\ncbindgen_private::Flickable::Flickable()\n{\n slint_flickable_data_init(&data);\n}\ncbindgen_private::Flickable::~Flickable()\n{\n slint_flickable_data_free(&data);\n}\n\ncbindgen_private::FocusScope::FocusScope()\n{\n slint_maybe_shortcut_list_init(&shortcuts);\n}\ncbindgen_private::FocusScope::~FocusScope()\n{\n slint_maybe_shortcut_list_free(&shortcuts);\n}\n\ncbindgen_private::NativeStyleMetrics::NativeStyleMetrics(void *)\n{\n slint_native_style_metrics_init(this);\n}\n\ncbindgen_private::NativeStyleMetrics::~NativeStyleMetrics()\n{\n slint_native_style_metrics_deinit(this);\n}\n\ncbindgen_private::NativePalette::NativePalette(void *)\n{\n slint_native_palette_init(this);\n}\n\ncbindgen_private::NativePalette::~NativePalette()\n{\n slint_native_palette_deinit(this);\n}\n#endif // !defined(DOXYGEN)\n\nnamespace private_api {\n// Was used in Slint <= 1.1.0 to have an error message in case of mismatch\ntemplate\nstruct [[deprecated]] VersionCheckHelper\n{\n};\n}\n\n/// Enum for the event loop mode parameter of the slint::run_event_loop() function.\n/// It is used to determine when the event loop quits.\nenum class EventLoopMode {\n /// The event loop will quit when the last window is closed\n /// or when slint::quit_event_loop() is called.\n QuitOnLastWindowClosed,\n\n /// The event loop will keep running until slint::quit_event_loop() is called,\n /// even when all windows are closed.\n RunUntilQuit\n};\n\n/// Enters the main event loop. This is necessary in order to receive\n/// events from the windowing system in order to render to the screen\n/// and react to user input.\n///\n/// The mode parameter determines the behavior of the event loop when all windows are closed.\n/// By default, it is set to QuitOnLastWindowClose, which means the event loop will\n/// quit when the last window is closed.\ninline void run_event_loop(EventLoopMode mode = EventLoopMode::QuitOnLastWindowClosed)\n{\n private_api::assert_main_thread();\n cbindgen_private::slint_run_event_loop(mode == EventLoopMode::QuitOnLastWindowClosed);\n}\n\n/// Schedules the main event loop for termination. This function is meant\n/// to be called from callbacks triggered by the UI. After calling the function,\n/// it will return immediately and once control is passed back to the event loop,\n/// the initial call to slint::run_event_loop() will return.\ninline void quit_event_loop()\n{\n cbindgen_private::slint_quit_event_loop();\n}\n\n/// Adds the specified functor to an internal queue, notifies the event loop to wake up.\n/// Once woken up, any queued up functors will be invoked.\n/// This function is thread-safe and can be called from any thread, including the one\n/// running the event loop. The provided functors will only be invoked from the thread\n/// that started the event loop.\n///\n/// You can use this to set properties or use any other Slint APIs from other threads,\n/// by collecting the code in a functor and queuing it up for invocation within the event loop.\n///\n/// The following example assumes that a status message received from a network thread is\n/// shown in the UI:\n///\n/// ```\n/// #include \"my_application_ui.h\"\n/// #include \n///\n/// int main(int argc, char **argv)\n/// {\n/// auto ui = NetworkStatusUI::create();\n/// ui->set_status_label(\"Pending\");\n///\n/// slint::ComponentWeakHandle weak_ui_handle(ui);\n/// std::thread network_thread([=]{\n/// std::string message = read_message_blocking_from_network();\n/// slint::invoke_from_event_loop([&]() {\n/// if (auto ui = weak_ui_handle.lock()) {\n/// ui->set_status_label(message);\n/// }\n/// });\n/// });\n/// ...\n/// ui->run();\n/// ...\n/// }\n/// ```\n///\n/// See also blocking_invoke_from_event_loop() for a blocking version of this function\ntemplate\nvoid invoke_from_event_loop(Functor f)\n{\n cbindgen_private::slint_post_event(\n [](void *data) { (*reinterpret_cast(data))(); }, new Functor(std::move(f)),\n [](void *data) { delete reinterpret_cast(data); });\n}\n\n#if !defined(SLINT_FEATURE_FREESTANDING) || defined(DOXYGEN)\n\n/// Blocking version of invoke_from_event_loop()\n///\n/// Just like invoke_from_event_loop(), this will run the specified functor from the thread running\n/// the slint event loop. But it will block until the execution of the functor is finished,\n/// and return that value.\n///\n/// This function must be called from a different thread than the thread that runs the event loop\n/// otherwise it will result in a deadlock. Calling this function if the event loop is not running\n/// will also block forever or until the event loop is started in another thread.\n///\n/// The following example is reading the message property from a thread\n///\n/// ```\n/// #include \"my_application_ui.h\"\n/// #include \n///\n/// int main(int argc, char **argv)\n/// {\n/// auto ui = MyApplicationUI::create();\n/// ui->set_status_label(\"Pending\");\n///\n/// std::thread worker_thread([ui]{\n/// while (...) {\n/// auto message = slint::blocking_invoke_from_event_loop([ui]() {\n/// return ui->get_message();\n/// }\n/// do_something(message);\n/// ...\n/// });\n/// });\n/// ...\n/// ui->run();\n/// ...\n/// }\n/// ```\ntemplate\nauto blocking_invoke_from_event_loop(Functor f) -> std::invoke_result_t\n{\n std::optional> result;\n std::mutex mtx;\n std::condition_variable cv;\n invoke_from_event_loop([&] {\n auto r = f();\n std::unique_lock lock(mtx);\n result = std::move(r);\n cv.notify_one();\n });\n std::unique_lock lock(mtx);\n cv.wait(lock, [&] { return result.has_value(); });\n return std::move(*result);\n}\n\n# if !defined(DOXYGEN) // Doxygen doesn't see this as an overload of the previous one\n// clang-format off\ntemplate\n requires(std::is_void_v>)\nvoid blocking_invoke_from_event_loop(Functor f)\n// clang-format on\n{\n std::mutex mtx;\n std::condition_variable cv;\n bool ok = false;\n invoke_from_event_loop([&] {\n f();\n std::unique_lock lock(mtx);\n ok = true;\n cv.notify_one();\n });\n std::unique_lock lock(mtx);\n cv.wait(lock, [&] { return ok; });\n}\n# endif\n#endif\n\n/// Sets the application id for use on Wayland or X11 with\n/// [xdg](https://specifications.freedesktop.org/desktop-entry-spec/latest/) compliant window\n/// managers. This must be set before the window is shown.\ninline void set_xdg_app_id(std::string_view xdg_app_id)\n{\n private_api::assert_main_thread();\n SharedString s = xdg_app_id;\n cbindgen_private::slint_set_xdg_app_id(&s);\n}\n\n} // namespace slint\n" }, { "path": "api/cpp/include/slint_brush.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n#include \n#include \"slint_color.h\"\n#include \"slint_brush_internal.h\"\n#include \"slint_string.h\"\n\nnamespace slint {\n\nnamespace private_api {\n\nusing cbindgen_private::types::GradientStop;\n\n/// \\private\n/// LinearGradientBrush represents a gradient for a brush that is a linear sequence of color stops,\n/// that are aligned at a specific angle.\nclass LinearGradientBrush\n{\npublic:\n /// Constructs an empty linear gradient with no color stops.\n LinearGradientBrush() = default;\n /// Constructs a new linear gradient with the specified \\a angle. The color stops will be\n /// constructed from the stops array pointed to be \\a firstStop, with the length \\a stopCount.\n LinearGradientBrush(float angle, const GradientStop *firstStop, int stopCount)\n : inner(make_linear_gradient(angle, firstStop, stopCount))\n {\n }\n\n /// Returns the linear gradient's angle in degrees.\n float angle() const\n {\n // The gradient's first stop is a fake stop to store the angle\n return inner[0].position;\n }\n\n /// Returns the number of gradient stops.\n int stopCount() const { return int(inner.size()) - 1; }\n\n /// Returns a pointer to the first gradient stop; undefined if the gradient has not stops.\n const GradientStop *stopsBegin() const { return inner.begin() + 1; }\n /// Returns a pointer past the last gradient stop. The returned pointer cannot be dereferenced,\n /// it can only be used for comparison.\n const GradientStop *stopsEnd() const { return inner.end(); }\n\nprivate:\n cbindgen_private::types::LinearGradientBrush inner;\n\n friend class slint::Brush;\n\n static SharedVector\n make_linear_gradient(float angle, const GradientStop *firstStop, int stopCount)\n {\n SharedVector gradient;\n gradient.push_back({ Color::from_argb_encoded(0).inner, angle });\n for (int i = 0; i < stopCount; ++i, ++firstStop)\n gradient.push_back(*firstStop);\n return gradient;\n }\n};\n\n/// \\private\n/// RadialGradientBrush represents a circular gradient centered in the middle\nclass RadialGradientBrush\n{\npublic:\n /// Constructs an empty linear gradient with no color stops.\n RadialGradientBrush() = default;\n /// Constructs a new circular radial gradient . The color stops will be\n /// constructed from the stops array pointed to be \\a firstStop, with the length \\a stopCount.\n RadialGradientBrush(const GradientStop *firstStop, int stopCount)\n : inner(make_circle_gradient(firstStop, stopCount))\n {\n }\n\n /// Returns the number of gradient stops.\n int stopCount() const { return int(inner.size()); }\n\n /// Returns a pointer to the first gradient stop; undefined if the gradient has not stops.\n const GradientStop *stopsBegin() const { return inner.begin(); }\n /// Returns a pointer past the last gradient stop. The returned pointer cannot be dereferenced,\n /// it can only be used for comparison.\n const GradientStop *stopsEnd() const { return inner.end(); }\n\nprivate:\n cbindgen_private::types::RadialGradientBrush inner;\n\n friend class slint::Brush;\n\n static SharedVector\n make_circle_gradient(const GradientStop *firstStop, int stopCount)\n {\n SharedVector gradient;\n for (int i = 0; i < stopCount; ++i, ++firstStop)\n gradient.push_back(*firstStop);\n return gradient;\n }\n};\n\n/// \\private\n/// ConicGradientBrush represents a conic gradient that rotates around a center point\nclass ConicGradientBrush\n{\npublic:\n /// Constructs an empty conic gradient with no color stops.\n ConicGradientBrush() = default;\n /// Constructs a new conic gradient with the specified starting \\a angle. The color stops will\n /// be constructed from the stops array pointed to be \\a firstStop, with the length \\a\n /// stopCount.\n ConicGradientBrush(float angle, const GradientStop *firstStop, int stopCount)\n : inner(make_conic_gradient(angle, firstStop, stopCount))\n {\n }\n\n /// Returns the conic gradient's starting angle (rotation) in degrees.\n float angle() const { return inner[0].position; }\n\n /// Returns the number of gradient stops.\n int stopCount() const { return int(inner.size()) - 1; }\n\n /// Returns a pointer to the first gradient stop; undefined if the gradient has not stops.\n const GradientStop *stopsBegin() const { return inner.begin() + 1; }\n /// Returns a pointer past the last gradient stop. The returned pointer cannot be dereferenced,\n /// it can only be used for comparison.\n const GradientStop *stopsEnd() const { return inner.end(); }\n\nprivate:\n cbindgen_private::types::ConicGradientBrush inner;\n\n friend class slint::Brush;\n\n static SharedVector\n make_conic_gradient(float angle, const GradientStop *firstStop, int stopCount)\n {\n SharedVector gradient;\n // The gradient's first stop is a fake stop to store the angle (same pattern as\n // LinearGradient)\n gradient.push_back({ Color::from_argb_encoded(0).inner, angle });\n for (int i = 0; i < stopCount; ++i, ++firstStop)\n gradient.push_back(*firstStop);\n\n // Normalize stops to [0, 1] range with proper boundary stops\n cbindgen_private::types::slint_conic_gradient_normalize_stops(&gradient);\n\n // Apply rotation if angle is non-zero\n if (angle != 0.0f) {\n cbindgen_private::types::slint_conic_gradient_apply_rotation(&gradient, angle);\n }\n return gradient;\n }\n};\n\n}\n\n/// Brush is used to declare how to fill or outline shapes, such as rectangles, paths or text. A\n/// brush is either a solid color or a linear gradient.\nclass Brush\n{\npublic:\n /// Constructs a new brush that is a transparent color.\n Brush() : Brush(Color {}) { }\n /// Constructs a new brush that is of color \\a color.\n Brush(const Color &color) : data(Inner::SolidColor(color.inner)) { }\n /// \\private\n /// Constructs a new brush that is the gradient \\a gradient.\n Brush(const private_api::LinearGradientBrush &gradient)\n : data(Inner::LinearGradient(gradient.inner))\n {\n }\n\n /// \\private\n /// Constructs a new brush that is the gradient \\a gradient.\n Brush(const private_api::RadialGradientBrush &gradient)\n : data(Inner::RadialGradient(gradient.inner))\n {\n }\n\n /// \\private\n /// Constructs a new brush that is the gradient \\a gradient.\n Brush(const private_api::ConicGradientBrush &gradient)\n : data(Inner::ConicGradient(gradient.inner))\n {\n }\n\n /// Returns the color of the brush. If the brush is a gradient, this function returns the color\n /// of the first stop.\n inline Color color() const;\n\n /// Returns a new version of this brush that has the brightness increased\n /// by the specified factor. This is done by calling Color::brighter on\n /// all the colors of this brush.\n [[nodiscard]] inline Brush brighter(float factor) const;\n /// Returns a new version of this color that has the brightness decreased\n /// by the specified factor. This is done by calling Color::darker on\n /// all the colors of this brush.\n [[nodiscard]] inline Brush darker(float factor) const;\n\n /// Returns a new version of this brush with the opacity decreased by \\a factor.\n ///\n /// This is done by calling Color::transparentize on all the colors of this brush.\n [[nodiscard]] inline Brush transparentize(float factor) const;\n\n /// Returns a new version of this brush with the related color's opacities\n /// set to \\a alpha.\n [[nodiscard]] inline Brush with_alpha(float alpha) const;\n\n /// Returns true if \\a a is equal to \\a b. If \\a a holds a color, then \\a b must also hold a\n /// color that is identical to \\a a's color. If it holds a gradient, then the gradients must be\n /// identical. Returns false if the brushes differ in what they hold or their respective color\n /// or gradient are not equal.\n friend bool operator==(const Brush &a, const Brush &b) { return a.data == b.data; }\n /// Returns false if \\a is not equal to \\a b; true otherwise.\n friend bool operator!=(const Brush &a, const Brush &b) { return a.data != b.data; }\n\nprivate:\n using Tag = cbindgen_private::types::Brush::Tag;\n using Inner = cbindgen_private::types::Brush;\n Inner data;\n friend struct private_api::Property;\n};\n\nColor Brush::color() const\n{\n Color result;\n switch (data.tag) {\n case Tag::SolidColor:\n result.inner = data.solid_color._0;\n break;\n case Tag::LinearGradient:\n if (data.linear_gradient._0.size() > 1) {\n result.inner = data.linear_gradient._0[1].color;\n }\n break;\n case Tag::RadialGradient:\n if (data.radial_gradient._0.size() > 0) {\n result.inner = data.radial_gradient._0[0].color;\n }\n break;\n case Tag::ConicGradient:\n if (data.conic_gradient._0.size() > 1) {\n result.inner = data.conic_gradient._0[1].color;\n }\n break;\n }\n return result;\n}\n\ninline Brush Brush::brighter(float factor) const\n{\n Brush result = *this;\n switch (data.tag) {\n case Tag::SolidColor:\n cbindgen_private::types::slint_color_brighter(&data.solid_color._0, factor,\n &result.data.solid_color._0);\n break;\n case Tag::LinearGradient:\n for (std::size_t i = 1; i < data.linear_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_brighter(&data.linear_gradient._0[i].color, factor,\n &result.data.linear_gradient._0[i].color);\n }\n break;\n case Tag::RadialGradient:\n for (std::size_t i = 0; i < data.radial_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_brighter(&data.radial_gradient._0[i].color, factor,\n &result.data.radial_gradient._0[i].color);\n }\n break;\n case Tag::ConicGradient:\n for (std::size_t i = 1; i < data.conic_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_brighter(&data.conic_gradient._0[i].color, factor,\n &result.data.conic_gradient._0[i].color);\n }\n break;\n }\n return result;\n}\n\ninline Brush Brush::darker(float factor) const\n{\n Brush result = *this;\n switch (data.tag) {\n case Tag::SolidColor:\n cbindgen_private::types::slint_color_darker(&data.solid_color._0, factor,\n &result.data.solid_color._0);\n break;\n case Tag::LinearGradient:\n for (std::size_t i = 1; i < data.linear_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_darker(&data.linear_gradient._0[i].color, factor,\n &result.data.linear_gradient._0[i].color);\n }\n break;\n case Tag::RadialGradient:\n for (std::size_t i = 0; i < data.radial_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_darker(&data.radial_gradient._0[i].color, factor,\n &result.data.radial_gradient._0[i].color);\n }\n break;\n case Tag::ConicGradient:\n for (std::size_t i = 1; i < data.conic_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_darker(&data.conic_gradient._0[i].color, factor,\n &result.data.conic_gradient._0[i].color);\n }\n break;\n }\n return result;\n}\n\ninline Brush Brush::transparentize(float factor) const\n{\n Brush result = *this;\n switch (data.tag) {\n case Tag::SolidColor:\n cbindgen_private::types::slint_color_transparentize(&data.solid_color._0, factor,\n &result.data.solid_color._0);\n break;\n case Tag::LinearGradient:\n for (std::size_t i = 1; i < data.linear_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_transparentize(\n &data.linear_gradient._0[i].color, factor,\n &result.data.linear_gradient._0[i].color);\n }\n break;\n case Tag::RadialGradient:\n for (std::size_t i = 0; i < data.radial_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_transparentize(\n &data.radial_gradient._0[i].color, factor,\n &result.data.radial_gradient._0[i].color);\n }\n break;\n case Tag::ConicGradient:\n for (std::size_t i = 1; i < data.conic_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_transparentize(\n &data.conic_gradient._0[i].color, factor,\n &result.data.conic_gradient._0[i].color);\n }\n break;\n }\n return result;\n}\n\ninline Brush Brush::with_alpha(float alpha) const\n{\n Brush result = *this;\n switch (data.tag) {\n case Tag::SolidColor:\n cbindgen_private::types::slint_color_with_alpha(&data.solid_color._0, alpha,\n &result.data.solid_color._0);\n break;\n case Tag::LinearGradient:\n for (std::size_t i = 1; i < data.linear_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_with_alpha(\n &data.linear_gradient._0[i].color, alpha,\n &result.data.linear_gradient._0[i].color);\n }\n break;\n case Tag::RadialGradient:\n for (std::size_t i = 0; i < data.radial_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_with_alpha(\n &data.radial_gradient._0[i].color, alpha,\n &result.data.radial_gradient._0[i].color);\n }\n break;\n case Tag::ConicGradient:\n for (std::size_t i = 1; i < data.conic_gradient._0.size(); ++i) {\n cbindgen_private::types::slint_color_with_alpha(\n &data.conic_gradient._0[i].color, alpha,\n &result.data.conic_gradient._0[i].color);\n }\n break;\n }\n return result;\n}\n\nnamespace private_api {\n\ntemplate<>\ninline void Property::set_animated_value(\n const slint::Brush &new_value,\n const cbindgen_private::PropertyAnimation &animation_data) const\n{\n cbindgen_private::slint_property_set_animated_value_brush(&inner, &value, &new_value,\n &animation_data);\n}\n\n} // namespace private_api\n\n} // namespace slint\n" }, { "path": "api/cpp/include/slint_callbacks.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n#include \n#include \"slint_properties_internal.h\"\n\nnamespace slint::private_api {\n\n/// A Callback stores a function pointer with no parameters and no return value.\n/// It's possible to set that pointer via set_handler() and it can be invoked via call(). This is\n/// used to implement callbacks in the `.slint` language.\ntemplate\nstruct Callback;\n/// A Callback stores a function pointer with \\a Arg parameters and a return value of type \\a Ret.\n/// It's possible to set that pointer via set_handler() and it can be invoked via call(). This is\n/// used to implement callbacks in the `.slint` language.\ntemplate\nstruct Callback\n{\n /// Constructs an empty callback that contains no handler.\n Callback() { cbindgen_private::slint_callback_init(&inner); }\n /// Destructs the callback.\n ~Callback() { cbindgen_private::slint_callback_drop(&inner); }\n Callback(const Callback &) = delete;\n Callback(Callback &&) = delete;\n Callback &operator=(const Callback &) = delete;\n\n /// Sets a new handler \\a binding for this callback, that will be invoked when call() is called.\n template\n void set_handler(F binding) const\n {\n cbindgen_private::slint_callback_set_handler(\n &inner,\n [](void *user_data, const void *arg, void *ret) {\n *reinterpret_cast(ret) =\n std::apply(*reinterpret_cast(user_data),\n *reinterpret_cast(arg));\n },\n new F(std::move(binding)),\n [](void *user_data) { delete reinterpret_cast(user_data); });\n }\n\n /// Invokes a previously set handler with the parameters \\a arg and returns the return value of\n /// the handler.\n Ret call(const Arg &...arg) const\n {\n Ret r {};\n Tuple tuple { arg... };\n cbindgen_private::slint_callback_call(&inner, &tuple, &r);\n return r;\n }\n\nprivate:\n using Tuple = std::tuple;\n cbindgen_private::CallbackOpaque inner;\n};\n\n/// A Callback stores a function pointer with \\a Arg parameters and no return value.\n/// It's possible to set that pointer via set_handler() and it can be invoked via call(). This is\n/// used to implement callbacks in the `.slint` language.\ntemplate\nstruct Callback\n{\n /// Constructs an empty callback that contains no handler.\n Callback() { cbindgen_private::slint_callback_init(&inner); }\n /// Destructs the callback.\n ~Callback() { cbindgen_private::slint_callback_drop(&inner); }\n Callback(const Callback &) = delete;\n Callback(Callback &&) = delete;\n Callback &operator=(const Callback &) = delete;\n\n /// Sets a new handler \\a binding for this callback, that will be invoked when call() is called.\n template\n void set_handler(F binding) const\n {\n cbindgen_private::slint_callback_set_handler(\n &inner,\n [](void *user_data, const void *arg, void *) {\n std::apply(*reinterpret_cast(user_data),\n *reinterpret_cast(arg));\n },\n new F(std::move(binding)),\n [](void *user_data) { delete reinterpret_cast(user_data); });\n }\n\n /// Invokes a previously set handler with the parameters \\a arg.\n void call(const Arg &...arg) const\n {\n Tuple tuple { arg... };\n cbindgen_private::slint_callback_call(&inner, &tuple, reinterpret_cast(0x1));\n }\n\nprivate:\n using Tuple = std::tuple;\n cbindgen_private::CallbackOpaque inner;\n};\n\ntemplate\nstruct CallbackSignatureHelper\n{\n using Result = R(A);\n};\ntemplate\nstruct CallbackSignatureHelper\n{\n using Result = R();\n};\ntemplate\nusing CallbackHelper = Callback::Result>;\n\n} // namespace slint\n" }, { "path": "api/cpp/include/slint_color.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint_color_internal.h\"\n\nnamespace slint {\n\nnamespace private_api {\nclass LinearGradientBrush;\nclass ConicGradientBrush;\n}\n\nclass Color;\n\n/// RgbaColor stores the red, green, blue and alpha components of a color\n/// with the precision of the template parameter T. For example if T is float,\n/// the values are normalized between 0 and 1. If T is uint8_t, they values range\n/// is 0 to 255.\ntemplate\nstruct RgbaColor\n{\n /// The alpha component.\n T alpha;\n /// The red component.\n T red;\n /// The green component.\n T green;\n /// The blue component.\n T blue;\n\n /// Creates a new RgbaColor instance from a given color. This template function is\n /// specialized and thus implemented for T == uint8_t and T == float.\n RgbaColor(const Color &col);\n};\n\n/// HsvaColor stores the hue, saturation, value, and alpha components of a color in the HSV color\n/// space.\nstruct HsvaColor\n{\n /// The hue component in degrees between 0 and 360.\n float hue;\n /// The saturation component, between 0 and 1.\n float saturation;\n /// The value component, between 0 and 1.\n float value;\n /// The alpha component, between 0 and 1.\n float alpha;\n};\n\n/// OklchColor stores the lightness, chroma, hue, and alpha components of a color in the Oklch\n/// color space (a perceptually uniform color space).\nstruct OklchColor\n{\n /// The lightness component, between 0 (black) and 1 (white).\n float lightness;\n /// The chroma component (saturation), typically between 0 (grayscale) and ~0.4 (vivid).\n float chroma;\n /// The hue component in degrees between 0 and 360.\n float hue;\n /// The alpha component, between 0 and 1.\n float alpha;\n};\n\n/// Color represents a color in the Slint run-time, represented using 8-bit channels for\n/// red, green, blue and the alpha (opacity).\nclass Color\n{\npublic:\n /// Default constructs a new color that is entirely transparent.\n Color() { inner.red = inner.green = inner.blue = inner.alpha = 0; }\n /// Constructs a new color from the given RgbaColor \\a col.\n Color(const RgbaColor &col)\n {\n inner.red = col.red;\n inner.green = col.green;\n inner.blue = col.blue;\n inner.alpha = col.alpha;\n }\n /// Constructs a new color from the given RgbaColor \\a col.\n Color(const RgbaColor &col)\n {\n inner.red = uint8_t(col.red * 255);\n inner.green = uint8_t(col.green * 255);\n inner.blue = uint8_t(col.blue * 255);\n inner.alpha = uint8_t(col.alpha * 255);\n }\n\n /// Construct a color from an integer encoded as `0xAARRGGBB`\n [[nodiscard]] static Color from_argb_encoded(uint32_t argb_encoded)\n {\n Color col;\n col.inner.red = (argb_encoded >> 16) & 0xff;\n col.inner.green = (argb_encoded >> 8) & 0xff;\n col.inner.blue = argb_encoded & 0xff;\n col.inner.alpha = (argb_encoded >> 24) & 0xff;\n return col;\n }\n\n /// Returns `(alpha, red, green, blue)` encoded as uint32_t.\n uint32_t as_argb_encoded() const\n {\n return (uint32_t(inner.red) << 16) | (uint32_t(inner.green) << 8) | uint32_t(inner.blue)\n | (uint32_t(inner.alpha) << 24);\n }\n\n /// Construct a color from the alpha, red, green and blue color channel parameters.\n [[nodiscard]] static Color from_argb_uint8(uint8_t alpha, uint8_t red, uint8_t green,\n uint8_t blue)\n {\n Color col;\n col.inner.alpha = alpha;\n col.inner.red = red;\n col.inner.green = green;\n col.inner.blue = blue;\n return col;\n }\n\n /// Construct a color from the red, green and blue color channel parameters. The alpha\n /// channel will have the value 255.\n [[nodiscard]] static Color from_rgb_uint8(uint8_t red, uint8_t green, uint8_t blue)\n {\n return from_argb_uint8(255, red, green, blue);\n }\n\n /// Construct a color from the alpha, red, green and blue color channel parameters.\n [[nodiscard]] static Color from_argb_float(float alpha, float red, float green, float blue)\n {\n Color col;\n col.inner.alpha = uint8_t(alpha * 255);\n col.inner.red = uint8_t(red * 255);\n col.inner.green = uint8_t(green * 255);\n col.inner.blue = uint8_t(blue * 255);\n return col;\n }\n\n /// Construct a color from the red, green and blue color channel parameters. The alpha\n /// channel will have the value 255.\n [[nodiscard]] static Color from_rgb_float(float red, float green, float blue)\n {\n return Color::from_argb_float(1.0, red, green, blue);\n }\n\n /// Converts this color to an RgbaColor struct for easy destructuring.\n [[nodiscard]] inline RgbaColor to_argb_uint() const;\n\n /// Converts this color to an RgbaColor struct for easy destructuring.\n [[nodiscard]] inline RgbaColor to_argb_float() const;\n\n /// Construct a color from the HSV color space components.\n /// The hue is expected to be in the range between 0 and 360, and the other parameters between 0\n /// and 1.\n [[nodiscard]] static Color from_hsva(float h, float s, float v, float a)\n {\n Color ret;\n ret.inner = cbindgen_private::types::slint_color_from_hsva(h, s, v, a);\n return ret;\n }\n\n /// Convert this color to the HSV color space.\n /// @returns a new HsvaColor.\n [[nodiscard]] HsvaColor to_hsva() const\n {\n HsvaColor hsv {};\n cbindgen_private::types::slint_color_to_hsva(&inner, &hsv.hue, &hsv.saturation, &hsv.value,\n &hsv.alpha);\n return hsv;\n }\n\n /// Construct a color from the Oklch color space components.\n /// Oklch is a perceptually uniform color space.\n /// The lightness is expected to be in the range between 0 and 1,\n /// chroma typically between 0 and 0.4, hue between 0 and 360,\n /// and alpha between 0 and 1.\n [[nodiscard]] static Color from_oklch(float l, float c, float h, float a)\n {\n Color ret;\n ret.inner = cbindgen_private::types::slint_color_from_oklch(l, c, h, a);\n return ret;\n }\n\n /// Convert this color to the Oklch color space.\n /// @returns a new OklchColor.\n [[nodiscard]] OklchColor to_oklch() const\n {\n OklchColor oklch {};\n cbindgen_private::types::slint_color_to_oklch(&inner, &oklch.lightness, &oklch.chroma,\n &oklch.hue, &oklch.alpha);\n return oklch;\n }\n\n /// Returns the red channel of the color as u8 in the range 0..255.\n [[nodiscard]] uint8_t red() const { return inner.red; }\n\n /// Returns the green channel of the color as u8 in the range 0..255.\n [[nodiscard]] uint8_t green() const { return inner.green; }\n\n /// Returns the blue channel of the color as u8 in the range 0..255.\n [[nodiscard]] uint8_t blue() const { return inner.blue; }\n\n /// Returns the alpha channel of the color as u8 in the range 0..255.\n [[nodiscard]] uint8_t alpha() const { return inner.alpha; }\n\n /// Returns a new version of this color that has the brightness increased\n /// by the specified factor. This is done by converting the color to the HSV\n /// color space and multiplying the brightness (value) with (1 + factor).\n /// The result is converted back to RGB and the alpha channel is unchanged.\n /// So for example `brighter(0.2)` will increase the brightness by 20%, and\n /// calling `brighter(-0.5)` will return a color that's 50% darker.\n [[nodiscard]] inline Color brighter(float factor) const;\n /// Returns a new version of this color that has the brightness decreased\n /// by the specified factor. This is done by converting the color to the HSV\n /// color space and dividing the brightness (value) by (1 + factor). The\n /// result is converted back to RGB and the alpha channel is unchanged.\n /// So for example `darker(0.3)` will decrease the brightness by 30%.\n [[nodiscard]] inline Color darker(float factor) const;\n\n /// Returns a new version of this color with the opacity decreased by \\a factor.\n ///\n /// The transparency is obtained by multiplying the alpha channel by `(1 - factor)`.\n [[nodiscard]] inline Color transparentize(float factor) const;\n\n /// Returns a new color that is a mix of \\a this color and \\a other. The specified \\a factor is\n /// clamped to be between `0.0` and `1.0` and then applied to \\a this color, while `1.0 -\n /// factor` is applied to \\a other.\n [[nodiscard]] inline Color mix(const Color &other, float factor) const;\n\n /// Returns a new version of this color with the opacity set to \\a alpha.\n [[nodiscard]] inline Color with_alpha(float alpha) const;\n\n /// Returns true if \\a lhs has the same values for the individual color channels as \\a rhs;\n /// false otherwise.\n friend bool operator==(const Color &lhs, const Color &rhs) = default;\n\n /// Writes the \\a color to the specified \\a stream and returns a reference to the\n /// stream.\n friend std::ostream &operator<<(std::ostream &stream, const Color &color)\n {\n // Cast to uint32_t to avoid the components being interpreted as char.\n return stream << \"argb(\" << uint32_t(color.inner.alpha) << \", \" << uint32_t(color.inner.red)\n << \", \" << uint32_t(color.inner.green) << \", \" << uint32_t(color.inner.blue)\n << \")\";\n }\n\n#if !defined(DOXYGEN)\n // FIXME: we need this to create GradientStop\n operator const cbindgen_private::types::Color &() const { return inner; }\n#endif\n\nprivate:\n cbindgen_private::types::Color inner;\n friend class private_api::LinearGradientBrush;\n friend class private_api::ConicGradientBrush;\n friend class Brush;\n};\n\ninline Color Color::brighter(float factor) const\n{\n Color result;\n cbindgen_private::types::slint_color_brighter(&inner, factor, &result.inner);\n return result;\n}\n\ninline Color Color::darker(float factor) const\n{\n Color result;\n cbindgen_private::types::slint_color_darker(&inner, factor, &result.inner);\n return result;\n}\n\ninline Color Color::transparentize(float factor) const\n{\n Color result;\n cbindgen_private::types::slint_color_transparentize(&inner, factor, &result.inner);\n return result;\n}\n\ninline Color Color::mix(const Color &other, float factor) const\n{\n Color result;\n cbindgen_private::types::slint_color_mix(&inner, &other.inner, factor, &result.inner);\n return result;\n}\n\ninline Color Color::with_alpha(float alpha) const\n{\n Color result;\n cbindgen_private::types::slint_color_with_alpha(&inner, alpha, &result.inner);\n return result;\n}\n\n/// Constructs a new RgbaColor from the color \\a color.\ntemplate<>\ninline RgbaColor::RgbaColor(const Color &color)\n{\n red = color.red();\n green = color.green();\n blue = color.blue();\n alpha = color.alpha();\n}\n\n/// Constructs a new RgbaColor from the color \\a color.\ntemplate<>\ninline RgbaColor::RgbaColor(const Color &color)\n{\n red = float(color.red()) / 255.f;\n green = float(color.green()) / 255.f;\n blue = float(color.blue()) / 255.f;\n alpha = float(color.alpha()) / 255.f;\n}\n\nRgbaColor Color::to_argb_uint() const\n{\n return RgbaColor(*this);\n}\n\nRgbaColor Color::to_argb_float() const\n{\n return RgbaColor(*this);\n}\n\n} // namespace slint\n" }, { "path": "api/cpp/include/slint_config.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \n\n#if UINTPTR_MAX == 0xFFFFFFFF\n# define SLINT_TARGET_32\n#elif UINTPTR_MAX == 0xFFFFFFFFFFFFFFFFu\n# define SLINT_TARGET_64\n#endif\n\n#if !defined(DOXYGEN)\n# if defined(_MSC_VER)\n# define SLINT_DLL_IMPORT __declspec(dllimport)\n# elif defined(__GNUC__)\n# if defined(_WIN32) || defined(_WIN64)\n# define SLINT_DLL_IMPORT __declspec(dllimport)\n# else\n# define SLINT_DLL_IMPORT __attribute__((visibility(\"default\")))\n# endif\n# else\n# define SLINT_DLL_IMPORT\n# endif\n#endif // !defined(DOXYGEN)\n" }, { "path": "api/cpp/include/slint_image.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n#include \n#include \n#include \"slint_generated_public.h\"\n#include \"slint_size.h\"\n#include \"slint_image_internal.h\"\n#include \"slint_string.h\"\n#include \"slint_sharedvector.h\"\n\nnamespace slint {\n\n/// SharedPixelBuffer is a container for storing image data as pixels. It is\n/// internally reference counted and cheap to copy.\n///\n/// You can construct a new empty shared pixel buffer with its default constructor,\n/// or you can copy it from an existing contiguous buffer that you might already have, using the\n/// range constructor.\n///\n/// See the documentation for Image for examples how to use this type to integrate\n/// Slint with external rendering functions.\ntemplate\nstruct SharedPixelBuffer\n{\n /// Construct an empty SharedPixelBuffer.\n SharedPixelBuffer() = default;\n\n /// Construct a SharedPixelBuffer with the given \\a width and \\a height. The pixels are default\n /// initialized.\n SharedPixelBuffer(uint32_t width, uint32_t height)\n : m_width(width), m_height(height), m_data(width * height)\n {\n }\n\n /// Construct a SharedPixelBuffer by copying the data from the \\a data array.\n /// The array must be of size \\a width * \\a height .\n SharedPixelBuffer(uint32_t width, uint32_t height, const Pixel *data)\n : m_width(width), m_height(height), m_data(data, data + (width * height))\n {\n }\n\n /// Returns the width of the buffer in pixels.\n uint32_t width() const { return m_width; }\n /// Returns the height of the buffer in pixels.\n uint32_t height() const { return m_height; }\n\n /// Returns a const pointer to the first pixel of this buffer.\n const Pixel *begin() const { return m_data.begin(); }\n /// Returns a const pointer past this buffer.\n const Pixel *end() const { return m_data.end(); }\n /// Returns a pointer to the first pixel of this buffer.\n Pixel *begin() { return m_data.begin(); }\n /// Returns a pointer past this buffer.\n Pixel *end() { return m_data.end(); }\n /// Returns a const pointer to the first pixel of this buffer.\n const Pixel *cbegin() const { return m_data.begin(); }\n /// Returns a const pointer past this buffer.\n const Pixel *cend() const { return m_data.end(); }\n\n /// Compare two SharedPixelBuffers. They are considered equal if all their pixels are equal.\n bool operator==(const SharedPixelBuffer &other) const = default;\n\nprivate:\n friend struct Image;\n friend class Window;\n uint32_t m_width;\n uint32_t m_height;\n SharedVector m_data;\n};\n\n/// An image type that can be displayed by the Image element\n///\n/// You can construct Image objects from a path to an image file on disk, using\n/// Image::load_from_path().\n///\n/// Another typical use-case is to render the image content with C++ code.\n/// For this it’s most efficient to create a new SharedPixelBuffer with the known dimensions and\n/// pass the pixel pointer returned by begin() to your rendering function. Afterwards you can create\n/// an Image using the constructor taking a SharedPixelBuffer.\n///\n/// The following example creates a 320x200 RGB pixel buffer and calls a function to draw a shape\n/// into it:\n/// ```cpp\n/// slint::SharedPixelBuffer pixel_buffer(320, 200);\n/// low_level_render(pixel_buffer.width(), pixel_buffer.height(),\n/// static_cast(pixel_buffer.begin()));\n/// slint::Image image(pixel_buffer);\n/// ```\n///\n/// Another use-case is to import existing image data into Slint, by\n/// creating a new Image through copying of the buffer:\n///\n/// ```cpp\n/// slint::Image image(slint::SharedPixelBuffer(the_width, the_height,\n/// static_cast(the_data));\n/// ```\n///\n/// This only works if the static_cast is valid and the underlying data has the same\n/// memory layout as slint::Rgb8Pixel or slint::Rgba8Pixel. Otherwise, you will have to do a\n/// pixel conversion as you copy the pixels:\n///\n/// ```cpp\n/// slint::SharedPixelBuffer pixel_buffer(the_width, the_height);\n/// slint::Rgb8Pixel *raw_data = pixel_buffer.begin();\n/// for (int i = 0; i < the_width * the_height; i++) {\n/// raw_data[i] = { bgr_data[i * 3 + 2], bgr_data[i * 3 + 1], bgr_data[i * 3] };\n/// }\n/// ```\nstruct Image\n{\npublic:\n /// This enum describes the origin to use when rendering a borrowed OpenGL texture.\n enum class BorrowedOpenGLTextureOrigin {\n /// The top-left of the texture is the top-left of the texture drawn on the screen.\n TopLeft,\n /// The bottom-left of the texture is the top-left of the texture draw on the screen,\n /// flipping it vertically.\n BottomLeft,\n };\n\n Image() : data(Data::ImageInner_None()) { }\n\n#if !defined(SLINT_FEATURE_FREESTANDING) || defined(DOXYGEN)\n /// Load an image from an image file\n [[nodiscard]] static Image load_from_path(const SharedString &file_path)\n {\n Image img;\n cbindgen_private::types::slint_image_load_from_path(&file_path, &img.data);\n return img;\n }\n#endif\n\n /// Constructs a new Image from an existing OpenGL texture. The texture remains borrowed by\n /// Slint for the duration of being used for rendering, such as when assigned as source property\n /// to an `Image` element. It's the application's responsibility to delete the texture when it\n /// is not used anymore.\n ///\n /// The texture must be bindable against the `GL_TEXTURE_2D` target, have `GL_RGBA` as format\n /// for the pixel data.\n ///\n /// When Slint renders the texture, it assumes that the origin of the texture is at the\n /// top-left. This is different from the default OpenGL coordinate system. If you want to\n /// flip the origin, use BorrowedOpenGLTextureOrigin::BottomLeft.\n ///\n /// Safety:\n ///\n /// This function is unsafe because invalid texture ids may lead to undefined behavior in OpenGL\n /// drivers. A valid texture id is one that was created by the same OpenGL context that is\n /// current during any of the invocations of the callback set on\n /// [`Window::set_rendering_notifier()`]. OpenGL contexts between instances of [`slint::Window`]\n /// are not sharing resources. Consequently\n /// [`slint::Image`] objects created from borrowed OpenGL textures cannot be shared between\n /// different windows.\n [[nodiscard]] static Image create_from_borrowed_gl_2d_rgba_texture(\n uint32_t texture_id, Size size,\n BorrowedOpenGLTextureOrigin origin = BorrowedOpenGLTextureOrigin::TopLeft)\n {\n cbindgen_private::types::BorrowedOpenGLTextureOrigin origin_private =\n origin == BorrowedOpenGLTextureOrigin::TopLeft\n ? cbindgen_private::types::BorrowedOpenGLTextureOrigin::TopLeft\n : cbindgen_private::types::BorrowedOpenGLTextureOrigin::BottomLeft;\n return Image(Data::ImageInner_BorrowedOpenGLTexture(\n cbindgen_private::types::BorrowedOpenGLTexture {\n texture_id,\n size,\n origin_private,\n })\n\n );\n }\n\n /// Construct an image from a SharedPixelBuffer of RGB pixels.\n Image(SharedPixelBuffer buffer)\n : data(Data::ImageInner_EmbeddedImage(\n cbindgen_private::types::ImageCacheKey::Invalid(),\n cbindgen_private::types::SharedImageBuffer::RGB8(\n cbindgen_private::types::SharedPixelBuffer {\n .width = buffer.width(),\n .height = buffer.height(),\n .data = buffer.m_data })))\n {\n }\n\n /// Construct an image from a SharedPixelBuffer of RGBA pixels.\n Image(SharedPixelBuffer buffer)\n : data(Data::ImageInner_EmbeddedImage(\n cbindgen_private::types::ImageCacheKey::Invalid(),\n cbindgen_private::types::SharedImageBuffer::RGBA8(\n cbindgen_private::types::SharedPixelBuffer {\n .width = buffer.width(),\n .height = buffer.height(),\n .data = buffer.m_data })))\n {\n }\n\n /// Returns the size of the Image in pixels.\n Size size() const { return cbindgen_private::types::slint_image_size(&data); }\n\n /// Returns the path of the image on disk, if it was constructed via Image::load_from_path().\n std::optional path() const\n {\n if (auto *str = cbindgen_private::types::slint_image_path(&data)) {\n return *str;\n } else {\n return {};\n }\n }\n\n /// Sets the nine-slice edges of the image.\n ///\n /// [Nine-slice scaling](https://en.wikipedia.org/wiki/9-slice_scaling) is a method for scaling\n /// images in such a way that the corners are not distorted.\n /// The arguments define the pixel sizes of the edges that cut the image into 9 slices.\n void set_nine_slice_edges(unsigned short top, unsigned short right, unsigned short bottom,\n unsigned short left)\n {\n cbindgen_private::types::slint_image_set_nine_slice_edges(&data, top, right, bottom, left);\n }\n\n /// Returns the pixel buffer for the Image if available in RGB format without alpha.\n /// Returns nullopt if the pixels cannot be obtained, for example when the image was created\n /// from borrowed OpenGL textures.\n std::optional> to_rgb8() const\n {\n SharedPixelBuffer result;\n if (cbindgen_private ::types::slint_image_to_rgb8(&data, &result.m_data, &result.m_width,\n &result.m_height)) {\n return result;\n } else {\n return {};\n }\n }\n\n /// Returns the pixel buffer for the Image if available in RGBA format.\n /// Returns nullopt if the pixels cannot be obtained, for example when the image was created\n /// from borrowed OpenGL textures.\n std::optional> to_rgba8() const\n {\n SharedPixelBuffer result;\n if (cbindgen_private ::types::slint_image_to_rgba8(&data, &result.m_data, &result.m_width,\n &result.m_height)) {\n return result;\n } else {\n return {};\n }\n }\n\n /// Returns the pixel buffer for the Image if available in RGBA format, with the alpha channel\n /// pre-multiplied to the red, green, and blue channels. Returns nullopt if the pixels cannot be\n /// obtained, for example when the image was created from borrowed OpenGL textures.\n std::optional> to_rgba8_premultiplied() const\n {\n SharedPixelBuffer result;\n if (cbindgen_private ::types::slint_image_to_rgba8_premultiplied(\n &data, &result.m_data, &result.m_width, &result.m_height)) {\n return result;\n } else {\n return {};\n }\n }\n\n /// Returns true if \\a a refers to the same image as \\a b; false otherwise.\n friend bool operator==(const Image &a, const Image &b)\n {\n return cbindgen_private::types::slint_image_compare_equal(&a.data, &b.data);\n }\n /// Returns false if \\a a refers to the same image as \\a b; true otherwise.\n friend bool operator!=(const Image &a, const Image &b) { return !(a == b); }\n\n /// \\private\n explicit Image(cbindgen_private::types::Image inner) : data(inner) { }\n\nprivate:\n using Tag = cbindgen_private::types::ImageInner::Tag;\n using Data = cbindgen_private::types::Image;\n Data data;\n};\n\nnamespace private_api {\ninline Image load_image_from_embedded_data(std::span data,\n std::string_view extension)\n{\n cbindgen_private::types::Image img(cbindgen_private::types::Image::ImageInner_None());\n cbindgen_private::types::slint_image_load_from_embedded_data(\n make_slice(data.data(), data.size()), string_to_slice(extension), &img);\n return Image(img);\n}\n\ninline Image image_from_embedded_textures(const cbindgen_private::types::StaticTextures *textures)\n{\n cbindgen_private::types::Image img(cbindgen_private::types::Image::ImageInner_None());\n cbindgen_private::types::slint_image_from_embedded_textures(textures, &img);\n return Image(img);\n}\n}\n\n}\n" }, { "path": "api/cpp/include/slint_interpreter.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#warning \"the header is renamed \"\n#include \"slint-interpreter.h\"\n" }, { "path": "api/cpp/include/slint_item_tree.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint_internal.h\"\n#include \"slint_window.h\"\n\nnamespace slint {\nnamespace private_api {\n// Bring opaque structure in scope\nusing namespace cbindgen_private;\nusing ItemTreeRef = vtable::VRef;\nusing IndexRange = cbindgen_private::IndexRange;\nusing ItemRef = vtable::VRef;\nusing ItemVisitorRefMut = vtable::VRefMut;\nusing ItemTreeNode = cbindgen_private::ItemTreeNode;\nusing ItemArrayEntry =\n vtable::VOffset;\nusing ItemArray = slint::cbindgen_private::Slice;\n\nconstexpr inline ItemTreeNode make_item_node(uint32_t child_count, uint32_t child_index,\n uint32_t parent_index, uint32_t item_array_index,\n bool is_accessible)\n{\n return ItemTreeNode { ItemTreeNode::Item_Body { ItemTreeNode::Tag::Item, is_accessible,\n child_count, child_index, parent_index,\n item_array_index } };\n}\n\nconstexpr inline ItemTreeNode make_dyn_node(std::uint32_t offset, std::uint32_t parent_index)\n{\n return ItemTreeNode { ItemTreeNode::DynamicTree_Body { ItemTreeNode::Tag::DynamicTree, offset,\n parent_index } };\n}\n\ninline ItemRef get_item_ref(ItemTreeRef item_tree,\n const cbindgen_private::Slice item_tree_array,\n const private_api::ItemArray item_array, int index)\n{\n const auto item_array_index = item_tree_array.ptr[index].item.item_array_index;\n const auto item = item_array[item_array_index];\n return ItemRef { item.vtable, reinterpret_cast(item_tree.instance) + item.offset };\n}\n\n} // namespace private_api\n\ntemplate\nclass ComponentWeakHandle;\n\n/// The component handle is like a shared pointer to a component in the generated code.\n/// In order to get a component, use `T::create()` where T is the name of the component\n/// in the .slint file. This give you a `ComponentHandle`\ntemplate\nclass ComponentHandle\n{\n vtable::VRc inner;\n friend class ComponentWeakHandle;\n\npublic:\n /// internal constructor\n ComponentHandle(const vtable::VRc &inner) : inner(inner) { }\n\n /// Arrow operator that implements pointer semantics.\n const T *operator->() const\n {\n private_api::assert_main_thread();\n return inner.operator->();\n }\n /// Dereference operator that implements pointer semantics.\n const T &operator*() const\n {\n private_api::assert_main_thread();\n return inner.operator*();\n }\n /// Arrow operator that implements pointer semantics.\n T *operator->()\n {\n private_api::assert_main_thread();\n return inner.operator->();\n }\n /// Dereference operator that implements pointer semantics.\n T &operator*()\n {\n private_api::assert_main_thread();\n return inner.operator*();\n }\n\n /// internal function that returns the internal handle\n vtable::VRc into_dyn() const { return inner.into_dyn(); }\n};\n\n/// A weak reference to the component. Can be constructed from a `ComponentHandle`\ntemplate\nclass ComponentWeakHandle\n{\n vtable::VWeak inner;\n\npublic:\n /// Constructs a null ComponentWeakHandle. lock() will always return empty.\n ComponentWeakHandle() = default;\n /// Copy-constructs a new ComponentWeakHandle from \\a other.\n ComponentWeakHandle(const ComponentHandle &other) : inner(other.inner) { }\n /// Returns a new strong ComponentHandle if the component the weak handle points to is\n /// still referenced by any other ComponentHandle. An empty std::optional is returned\n /// otherwise.\n std::optional> lock() const\n {\n private_api::assert_main_thread();\n if (auto l = inner.lock()) {\n return { ComponentHandle(*l) };\n } else {\n return {};\n }\n }\n};\n\n}\n" }, { "path": "api/cpp/include/slint_live_preview.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint.h\"\n\n#ifndef SLINT_FEATURE_LIVE_PREVIEW\n# error SLINT_FEATURE_LIVE_PREVIEW must be activated\n#else\n\n# include \"slint-interpreter.h\"\n\n/// Internal API to support the live-preview generated code\nnamespace slint::private_api::live_preview {\n\ntemplate\n requires(std::convertible_to)\nslint::interpreter::Value into_slint_value(const T &val)\n{\n return val;\n}\n\ntemplate\n requires requires(T val) { val.into_slint_value(); }\nslint::interpreter::Value into_slint_value(const T &val)\n{\n return val.into_slint_value();\n}\n\ninline slint::interpreter::Value into_slint_value(const slint::interpreter::Value &val)\n{\n return val;\n}\n\ntemplate\n requires std::is_same_v\ninline void from_slint_value(const slint::interpreter::Value &, const T *)\n{\n}\ninline bool from_slint_value(const slint::interpreter::Value &val, const bool *)\n{\n return val.to_bool().value();\n}\ninline slint::SharedString from_slint_value(const slint::interpreter::Value &val,\n const slint::SharedString *)\n{\n return val.to_string().value();\n}\ninline int from_slint_value(const slint::interpreter::Value &val, const int *)\n{\n return val.to_number().value();\n}\ninline float from_slint_value(const slint::interpreter::Value &val, const float *)\n{\n return val.to_number().value();\n}\ninline slint::Color from_slint_value(const slint::interpreter::Value &val, const slint::Color *)\n{\n return val.to_brush().value().color();\n}\ninline interpreter::Value into_slint_value(const slint::Color &val)\n{\n return slint::Brush(val);\n}\ninline slint::Brush from_slint_value(const slint::interpreter::Value &val, const slint::Brush *)\n{\n return val.to_brush().value();\n}\ninline slint::Image from_slint_value(const slint::interpreter::Value &val, const slint::Image *)\n{\n return val.to_image().value();\n}\n/// duration\ninline long int from_slint_value(const slint::interpreter::Value &val, const long int *)\n{\n return val.to_number().value();\n}\ninline interpreter::Value into_slint_value(const long int &val)\n{\n return double(val);\n}\n\ntemplate\nstd::shared_ptr>\nfrom_slint_value(const slint::interpreter::Value &,\n const std::shared_ptr> *);\n\ntemplate\nslint::interpreter::Value into_slint_value(const std::shared_ptr> &val);\n\ninline slint::interpreter::Value into_slint_value(const slint::StandardListViewItem &val)\n{\n slint::interpreter::Struct s;\n s.set_field(\"text\", val.text);\n return s;\n}\n\ninline slint::StandardListViewItem from_slint_value(const slint::interpreter::Value &val,\n const slint::StandardListViewItem *)\n{\n auto s = val.to_struct().value();\n return slint::StandardListViewItem { .text = s.get_field(\"text\").value().to_string().value() };\n}\n\ninline slint::interpreter::Value into_slint_value(const slint::LogicalPosition &val)\n{\n slint::interpreter::Struct s;\n s.set_field(\"x\", val.x);\n s.set_field(\"y\", val.y);\n return s;\n}\n\ninline slint::LogicalPosition from_slint_value(const slint::interpreter::Value &val,\n const slint::LogicalPosition *)\n{\n auto s = val.to_struct().value();\n return slint::LogicalPosition({ float(s.get_field(\"x\").value().to_number().value()),\n float(s.get_field(\"y\").value().to_number().value()) });\n}\n\ntemplate\nT from_slint_value(const slint::interpreter::Value &v)\n{\n return from_slint_value(v, static_cast(nullptr));\n}\n\nclass LiveReloadingComponent\n{\n const cbindgen_private::LiveReloadingComponentInner *inner;\n\npublic:\n /// Libraries is an array of string that have in the form `lib=...`\n LiveReloadingComponent(std::string_view file_name, std::string_view component_name,\n const slint::SharedVector &include_paths,\n const slint::SharedVector &libraries,\n std::string_view style, std::string_view translation_domain,\n bool no_default_translation_context)\n {\n assert_main_thread();\n inner = cbindgen_private::slint_live_preview_new(\n string_to_slice(file_name), string_to_slice(component_name), &include_paths,\n &libraries, string_to_slice(style), string_to_slice(translation_domain),\n no_default_translation_context);\n }\n\n LiveReloadingComponent(const LiveReloadingComponent &other) : inner(other.inner)\n {\n assert_main_thread();\n cbindgen_private::slint_live_preview_clone(other.inner);\n }\n LiveReloadingComponent &operator=(const LiveReloadingComponent &other)\n {\n assert_main_thread();\n if (this == &other)\n return *this;\n cbindgen_private::slint_live_preview_drop(inner);\n inner = other.inner;\n cbindgen_private::slint_live_preview_clone(inner);\n return *this;\n }\n ~LiveReloadingComponent()\n {\n assert_main_thread();\n cbindgen_private::slint_live_preview_drop(inner);\n }\n\n void set_property(std::string_view name, const interpreter::Value &value) const\n {\n assert_main_thread();\n return cbindgen_private::slint_live_preview_set_property(inner, string_to_slice(name),\n value.inner);\n }\n\n interpreter::Value get_property(std::string_view name) const\n {\n assert_main_thread();\n auto val = slint::interpreter::Value(\n cbindgen_private::slint_live_preview_get_property(inner, string_to_slice(name)));\n return val;\n }\n\n template\n interpreter::Value invoke(std::string_view name, Args &...args) const\n {\n assert_main_thread();\n std::array args_values { into_slint_value(args)... };\n cbindgen_private::Slice args_slice {\n reinterpret_cast(args_values.data()), args_values.size()\n };\n interpreter::Value val(cbindgen_private::slint_live_preview_invoke(\n inner, string_to_slice(name), args_slice));\n return val;\n }\n\n template> F>\n requires(std::is_convertible_v>,\n interpreter::Value>)\n void set_callback(std::string_view name, F &&callback) const\n {\n assert_main_thread();\n auto actual_cb =\n [](void *data,\n cbindgen_private::Slice> arg) {\n std::span args_view {\n reinterpret_cast(arg.ptr), arg.len\n };\n interpreter::Value r = (*reinterpret_cast(data))(args_view);\n auto inner = r.inner;\n r.inner = cbindgen_private::slint_interpreter_value_new();\n return inner;\n };\n return cbindgen_private::slint_live_preview_set_callback(\n inner, slint::private_api::string_to_slice(name), actual_cb,\n new F(std::move(callback)), [](void *data) { delete reinterpret_cast(data); });\n }\n\n slint::Window &window() const\n {\n const cbindgen_private::WindowAdapterRcOpaque *win_ptr = nullptr;\n cbindgen_private::slint_live_preview_window(inner, &win_ptr);\n return const_cast(*reinterpret_cast(win_ptr));\n }\n\n // Helper function that abuse the friend on Value\n static slint::interpreter::Value value_from_enum(std::string_view name, std::string_view value)\n {\n return slint::interpreter::Value(cbindgen_private::slint_interpreter_value_new_enum(\n string_to_slice(name), string_to_slice(value)));\n }\n static slint::SharedString get_enum_value(const slint::interpreter::Value &value)\n {\n slint::SharedString result;\n slint::cbindgen_private::slint_interpreter_value_enum_to_string(value.inner, &result);\n return result;\n }\n};\n\nclass LiveReloadModelWrapperBase : public private_api::ModelChangeListener\n{\n cbindgen_private::ModelNotifyOpaque notify;\n // This means that the rust code has ownership of \"this\" until the drop function is called\n std::shared_ptr self = nullptr;\n\n void row_added(size_t index, size_t count) override\n {\n cbindgen_private::slint_interpreter_model_notify_row_added(¬ify, index, count);\n }\n void row_changed(size_t index) override\n {\n cbindgen_private::slint_interpreter_model_notify_row_changed(¬ify, index);\n }\n void row_removed(size_t index, size_t count) override\n {\n cbindgen_private::slint_interpreter_model_notify_row_removed(¬ify, index, count);\n }\n void reset() override { cbindgen_private::slint_interpreter_model_notify_reset(¬ify); }\n\n static const ModelAdaptorVTable *vtable()\n {\n auto row_count = [](VRef self) -> uintptr_t {\n return reinterpret_cast(self.instance)->row_count();\n };\n auto row_data = [](VRef self,\n uintptr_t row) -> slint::cbindgen_private::Value * {\n std::optional v =\n reinterpret_cast(self.instance)\n ->row_data(int(row));\n if (v.has_value()) {\n slint::cbindgen_private::Value *rval = v->inner;\n v->inner = cbindgen_private::slint_interpreter_value_new();\n return rval;\n } else {\n return nullptr;\n }\n };\n auto set_row_data = [](VRef self, uintptr_t row,\n slint::cbindgen_private::Value *value) {\n interpreter::Value v(std::move(value));\n reinterpret_cast(self.instance)->set_row_data(row, v);\n };\n auto get_notify =\n [](VRef self) -> const cbindgen_private::ModelNotifyOpaque * {\n return &reinterpret_cast(self.instance)->notify;\n };\n auto drop = [](vtable::VRefMut self) {\n reinterpret_cast(self.instance)->self = nullptr;\n };\n\n static const ModelAdaptorVTable vt { row_count, row_data, set_row_data, get_notify, drop };\n return &vt;\n }\n\nprotected:\n LiveReloadModelWrapperBase() { cbindgen_private::slint_interpreter_model_notify_new(¬ify); }\n virtual ~LiveReloadModelWrapperBase()\n {\n cbindgen_private::slint_interpreter_model_notify_destructor(¬ify);\n }\n\n virtual int row_count() const = 0;\n virtual std::optional row_data(int i) const = 0;\n virtual void set_row_data(int i, const slint::interpreter::Value &value) = 0;\n\n static interpreter::Value wrap(std::shared_ptr wrapper)\n {\n wrapper->self = wrapper;\n return interpreter::Value(cbindgen_private::slint_interpreter_value_new_model(\n reinterpret_cast(wrapper.get()), vtable()));\n }\n\npublic:\n // get the model wrapper from a value (or nullptr if the value don't contain a model)\n static const LiveReloadModelWrapperBase *get(const slint::interpreter::Value &value)\n {\n if (auto model =\n cbindgen_private::slint_interpreter_value_to_model(value.inner, vtable())) {\n return reinterpret_cast(model);\n } else {\n return nullptr;\n }\n }\n};\n\ntemplate\nclass LiveReloadModelWrapper : public LiveReloadModelWrapperBase\n{\npublic:\n LiveReloadModelWrapper(std::shared_ptr> model) : model(std::move(model))\n {\n }\n\n std::shared_ptr> model = nullptr;\n\n int row_count() const override { return model->row_count(); }\n\n std::optional row_data(int i) const override\n {\n if (auto v = model->row_data(i))\n return into_slint_value(*v);\n else\n return {};\n }\n\n void set_row_data(int i, const slint::interpreter::Value &value) override\n {\n model->set_row_data(i, from_slint_value(value));\n }\n\n static slint::interpreter::Value wrap(std::shared_ptr> model)\n {\n auto self = std::make_shared>(model);\n auto peer = std::weak_ptr(self);\n model->attach_peer(peer);\n return LiveReloadModelWrapperBase::wrap(self);\n }\n};\n\ntemplate\nconcept HasFromSlintValue = requires(const slint::interpreter::Value &val) {\n { from_slint_value(val, std::declval()) };\n};\n\ntemplate\nslint::interpreter::Value into_slint_value(const std::shared_ptr> &val)\n{\n if (!val) {\n return {};\n }\n if constexpr (HasFromSlintValue) {\n return LiveReloadModelWrapper::wrap(val);\n }\n return {};\n}\n\ntemplate\nstd::shared_ptr>\nfrom_slint_value(const slint::interpreter::Value &value,\n const std::shared_ptr> *)\n{\n if (const LiveReloadModelWrapperBase *base = LiveReloadModelWrapperBase::get(value)) {\n if (auto wrapper = dynamic_cast *>(base)) {\n return wrapper->model;\n }\n }\n if constexpr (HasFromSlintValue) {\n if (auto array = value.to_array(); array && array->size() > 0) {\n std::vector data;\n data.reserve(array->size());\n for (auto &v : *array) {\n data.push_back(from_slint_value(v));\n }\n return std::make_shared>(std::move(data));\n }\n }\n return {};\n}\n\n} // namespace slint::private_api::live_preview\n\n#endif // SLINT_FEATURE_LIVE_PREVIEW\n" }, { "path": "api/cpp/include/slint_models.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint_item_tree.h\"\n\n#include \n#include \n#include \n#include \n#include \n\nnamespace slint {\n\nnamespace private_api {\n\nstruct ModelChangeListener\n{\n virtual ~ModelChangeListener() = default;\n virtual void row_added(size_t index, size_t count) = 0;\n virtual void row_removed(size_t index, size_t count) = 0;\n virtual void row_changed(size_t index) = 0;\n virtual void reset() = 0;\n};\nusing ModelPeer = std::weak_ptr;\n\ntemplate\nauto access_array_index(const std::shared_ptr &model, std::ptrdiff_t index)\n{\n if (!model || index < 0) {\n return decltype(*model->row_data_tracked(index)) {};\n } else if (const auto v = model->row_data_tracked(index)) {\n return *v;\n } else {\n return decltype(*v) {};\n }\n}\n\ntemplate\nlong int model_length(const std::shared_ptr &model)\n{\n if (!model) {\n return 0;\n } else {\n model->track_row_count_changes();\n return model->row_count();\n }\n}\n\n} // namespace private_api\n\n/// \\rst\n/// A Model is providing Data for Slint |Models|_ or |ListView|_ elements of the\n/// :code:`.slint` language\n/// \\endrst\n///\n/// This is typically used in a `std::shared_ptr`.\n/// Model is an abstract class and you can derive from it to provide your own data model,\n/// or use one of the provided models such as `slint::VectorModel`\n///\n/// An implementation of the Model can provide data to slint by re-implementing the `row_count` and\n/// `row_data` functions. It is the responsibility of the Model implementation to call the\n/// `Model::notify_row_changed()`, `Model::notify_row_added()`, `Model::notify_row_removed()`, or\n/// `Model::notify_reset()` functions when the underlying data changes.\n///\n/// Note that the Model is not thread-safe. All Model operations need to be done in the main thread.\n/// If you need to update the model data from another thread, use the\n/// `slint::invoke_from_event_loop()` function to send the data to the main thread and update the\n/// model.\ntemplate\nclass Model\n{\npublic:\n virtual ~Model() = default;\n Model() = default;\n Model(const Model &) = delete;\n Model &operator=(const Model &) = delete;\n\n /// The amount of row in the model\n virtual size_t row_count() const = 0;\n /// Returns the data for a particular row. This function should be called with `row <\n /// row_count()`.\n virtual std::optional row_data(size_t i) const = 0;\n /// Sets the data for a particular row.\n ///\n /// This function should only be called with `row < row_count()`.\n ///\n /// If the model cannot support data changes, then it is ok to do nothing.\n /// The default implementation will print a warning to stderr.\n ///\n /// If the model can update the data, it should also call `row_changed`\n virtual void set_row_data(size_t, const ModelData &)\n {\n#ifndef SLINT_FEATURE_FREESTANDING\n std::cerr << \"Model::set_row_data was called on a read-only model\" << std::endl;\n#endif\n };\n\n /// \\private\n /// Internal function called by the view to register itself\n void attach_peer(private_api::ModelPeer p) { peers.push_back(std::move(p)); }\n\n /// \\private\n /// Internal function called from within bindings to register with the currently\n /// evaluating dependency and get notified when this model's row count changes.\n void track_row_count_changes() const { model_row_count_dirty_property.get(); }\n\n /// \\private\n /// Internal function called from within bindings to register with the currently\n /// evaluating dependency and get notified when this model's row data changes.\n void track_row_data_changes(size_t row) const\n {\n auto it = std::lower_bound(tracked_rows.begin(), tracked_rows.end(), row);\n if (it == tracked_rows.end() || row < *it) {\n tracked_rows.insert(it, row);\n }\n model_row_data_dirty_property.get();\n }\n\n /// \\private\n /// Convenience function that calls `track_row_data_changes` before returning `row_data`\n std::optional row_data_tracked(size_t row) const\n {\n track_row_data_changes(row);\n return row_data(row);\n }\n\nprotected:\n /// Notify the views that a specific row was changed\n ///\n /// Your model implementation should call this function after the data of a row changes.\n void notify_row_changed(size_t row)\n {\n private_api::assert_main_thread();\n if (std::binary_search(tracked_rows.begin(), tracked_rows.end(), row)) {\n model_row_data_dirty_property.mark_dirty();\n }\n for_each_peers([=](auto peer) { peer->row_changed(row); });\n }\n /// Notify the views that rows were added\n ///\n /// Your model implementation should call this function after the row were added.\n void notify_row_added(size_t index, size_t count)\n {\n private_api::assert_main_thread();\n model_row_count_dirty_property.mark_dirty();\n tracked_rows.clear();\n model_row_data_dirty_property.mark_dirty();\n for_each_peers([=](auto peer) { peer->row_added(index, count); });\n }\n /// Notify the views that rows were removed\n ///\n /// Your model implementation should call this function after the row were removed.\n void notify_row_removed(size_t index, size_t count)\n {\n private_api::assert_main_thread();\n model_row_count_dirty_property.mark_dirty();\n tracked_rows.clear();\n model_row_data_dirty_property.mark_dirty();\n for_each_peers([=](auto peer) { peer->row_removed(index, count); });\n }\n\n /// Notify the views that the model has been changed and that everything needs to be reloaded\n ///\n /// Your model implementation should call this function after the model has been changed.\n void notify_reset()\n {\n private_api::assert_main_thread();\n model_row_count_dirty_property.mark_dirty();\n tracked_rows.clear();\n model_row_data_dirty_property.mark_dirty();\n for_each_peers([=](auto peer) { peer->reset(); });\n }\n\n /// \\deprecated\n [[deprecated(\"Renamed to notify_row_changed\")]] void row_changed(size_t row)\n {\n notify_row_changed(row);\n }\n /// \\deprecated\n [[deprecated(\"Renamed to notify_row_added\")]] void row_added(size_t index, size_t count)\n {\n notify_row_added(index, count);\n }\n /// \\deprecated\n [[deprecated(\"Renamed to notify_row_removed\")]] void row_removed(size_t index, size_t count)\n {\n notify_row_removed(index, count);\n }\n /// \\deprecated\n [[deprecated(\"Renamed to notify_reset\")]] void reset() { notify_reset(); }\n\nprivate:\n template\n void for_each_peers(const F &f)\n {\n peers.erase(std::remove_if(peers.begin(), peers.end(),\n [&](const auto &p) {\n if (auto pp = p.lock()) {\n f(pp);\n return false;\n }\n return true;\n }),\n peers.end());\n }\n std::vector peers;\n private_api::Property model_row_count_dirty_property;\n private_api::Property model_row_data_dirty_property;\n mutable std::vector tracked_rows;\n};\n\nnamespace private_api {\n/// A Model backed by a std::array of constant size\n/// \\private\ntemplate\nclass ArrayModel : public Model\n{\n std::array data;\n\npublic:\n /// Constructs a new ArrayModel by forwarding \\a to the std::array constructor.\n template\n ArrayModel(A &&...a) : data { std::forward(a)... }\n {\n }\n size_t row_count() const override { return Count; }\n std::optional row_data(size_t i) const override\n {\n if (i >= row_count())\n return {};\n return data[i];\n }\n void set_row_data(size_t i, const ModelData &value) override\n {\n if (i < row_count()) {\n data[i] = value;\n this->notify_row_changed(i);\n }\n }\n};\n\n// Specialize for the empty array. We can't have a Model, but `int` will work for our purpose\ntemplate<>\nclass ArrayModel<0, void> : public Model\n{\npublic:\n size_t row_count() const override { return 0; }\n std::optional row_data(size_t) const override { return {}; }\n};\n\n/// Model to be used when we just want to repeat without data.\nstruct UIntModel : Model\n{\n /// Constructs a new IntModel with \\a d rows.\n UIntModel(uint32_t d) : data(d) { }\n /// \\private\n uint32_t data;\n /// \\copydoc Model::row_count\n size_t row_count() const override { return data; }\n std::optional row_data(size_t value) const override\n {\n if (value >= row_count())\n return {};\n return static_cast(value);\n }\n};\n} // namespace private_api\n\n/// A Model backed by a SharedVector\ntemplate\nclass VectorModel : public Model\n{\n std::vector data;\n\npublic:\n /// Constructs a new empty VectorModel.\n VectorModel() = default;\n /// Constructs a new VectorModel from \\a array.\n VectorModel(std::vector array) : data(std::move(array)) { }\n size_t row_count() const override { return data.size(); }\n std::optional row_data(size_t i) const override\n {\n if (i >= row_count())\n return {};\n return std::optional { data[i] };\n }\n void set_row_data(size_t i, const ModelData &value) override\n {\n if (i < row_count()) {\n data[i] = value;\n this->notify_row_changed(i);\n }\n }\n\n /// Append a new row with the given value\n void push_back(const ModelData &value)\n {\n data.push_back(value);\n this->notify_row_added(data.size() - 1, 1);\n }\n\n /// Remove the row at the given index from the model\n void erase(size_t index)\n {\n data.erase(data.begin() + index);\n this->notify_row_removed(index, 1);\n }\n\n /// Inserts the given value as a new row at the specified index\n void insert(size_t index, const ModelData &value)\n {\n data.insert(data.begin() + index, value);\n this->notify_row_added(index, 1);\n }\n\n /// Erases all rows from the VectorModel.\n void clear()\n {\n if (!data.empty()) {\n data.clear();\n this->notify_reset();\n }\n }\n\n /// Replaces the underlying VectorModel's vector with \\a array.\n void set_vector(std::vector array)\n {\n data = std::move(array);\n this->notify_reset();\n }\n};\n\ntemplate\nclass FilterModel;\n\nnamespace private_api {\ntemplate\nstruct FilterModelInner : private_api::ModelChangeListener\n{\n FilterModelInner(std::shared_ptr> source_model,\n std::function filter_fn,\n slint::FilterModel &target_model)\n : source_model(source_model), filter_fn(filter_fn), target_model(target_model)\n {\n }\n\n void row_added(size_t index, size_t count) override\n {\n if (filtered_rows_dirty) {\n reset();\n return;\n }\n\n if (count == 0) {\n return;\n }\n\n std::vector added_accepted_rows;\n for (auto i = index; i < index + count; ++i) {\n if (auto data = source_model->row_data(i)) {\n if (filter_fn(*data)) {\n added_accepted_rows.push_back(i);\n }\n }\n }\n\n if (added_accepted_rows.empty()) {\n return;\n }\n\n auto insertion_point = std::lower_bound(accepted_rows.begin(), accepted_rows.end(), index);\n\n insertion_point = accepted_rows.insert(insertion_point, added_accepted_rows.begin(),\n added_accepted_rows.end());\n\n for (auto it = insertion_point + added_accepted_rows.size(); it != accepted_rows.end();\n ++it)\n (*it) += count;\n\n target_model.notify_row_added(insertion_point - accepted_rows.begin(),\n added_accepted_rows.size());\n }\n void row_changed(size_t index) override\n {\n if (filtered_rows_dirty) {\n reset();\n return;\n }\n\n auto existing_row = std::lower_bound(accepted_rows.begin(), accepted_rows.end(), index);\n auto existing_row_index = std::distance(accepted_rows.begin(), existing_row);\n bool is_contained = existing_row != accepted_rows.end() && *existing_row == index;\n auto accepted_updated_row = filter_fn(*source_model->row_data(index));\n\n if (is_contained && accepted_updated_row) {\n target_model.notify_row_changed(existing_row_index);\n } else if (!is_contained && accepted_updated_row) {\n accepted_rows.insert(existing_row, index);\n target_model.notify_row_added(existing_row_index, 1);\n } else if (is_contained && !accepted_updated_row) {\n accepted_rows.erase(existing_row);\n target_model.notify_row_removed(existing_row_index, 1);\n }\n }\n void row_removed(size_t index, size_t count) override\n {\n if (filtered_rows_dirty) {\n reset();\n return;\n }\n\n auto mapped_row_start = std::lower_bound(accepted_rows.begin(), accepted_rows.end(), index);\n auto mapped_row_end =\n std::lower_bound(accepted_rows.begin(), accepted_rows.end(), index + count);\n\n auto mapped_removed_len = std::distance(mapped_row_start, mapped_row_end);\n\n auto mapped_removed_index =\n (mapped_row_start != accepted_rows.end() && *mapped_row_start == index)\n ? std::optional(mapped_row_start - accepted_rows.begin())\n : std::nullopt;\n\n auto it = accepted_rows.erase(mapped_row_start, mapped_row_end);\n for (; it != accepted_rows.end(); ++it) {\n *it -= count;\n }\n\n if (mapped_removed_index) {\n target_model.notify_row_removed(*mapped_removed_index, mapped_removed_len);\n }\n }\n void reset() override\n {\n filtered_rows_dirty = true;\n update_mapping();\n target_model.notify_reset();\n }\n\n void update_mapping()\n {\n if (!filtered_rows_dirty) {\n return;\n }\n\n accepted_rows.clear();\n for (size_t i = 0, count = source_model->row_count(); i < count; ++i) {\n if (auto data = source_model->row_data(i)) {\n if (filter_fn(*data)) {\n accepted_rows.push_back(i);\n }\n }\n }\n\n filtered_rows_dirty = false;\n }\n\n bool filtered_rows_dirty = true;\n std::shared_ptr> source_model;\n std::function filter_fn;\n std::vector accepted_rows;\n slint::FilterModel &target_model;\n};\n}\n\n/// The FilterModel acts as an adapter model for a given source model by applying a filter\n/// function. The filter function is called for each row on the source model and if the\n/// filter accepts the row (i.e. returns true), the row is also visible in the FilterModel.\ntemplate\nclass FilterModel : public Model\n{\n friend struct private_api::FilterModelInner;\n\npublic:\n /// Constructs a new FilterModel that provides a limited view on the \\a source_model by applying\n /// \\a filter_fn on each row. If the provided function returns true, the row is exposed by the\n /// FilterModel.\n FilterModel(std::shared_ptr> source_model,\n std::function filter_fn)\n : inner(std::make_shared>(\n std::move(source_model), std::move(filter_fn), *this))\n {\n inner->source_model->attach_peer(inner);\n }\n\n size_t row_count() const override\n {\n inner->update_mapping();\n return inner->accepted_rows.size();\n }\n\n std::optional row_data(size_t i) const override\n {\n inner->update_mapping();\n if (i >= inner->accepted_rows.size())\n return {};\n return inner->source_model->row_data(inner->accepted_rows[i]);\n }\n\n void set_row_data(size_t i, const ModelData &value) override\n {\n inner->update_mapping();\n inner->source_model->set_row_data(inner->accepted_rows[i], value);\n }\n\n /// Re-applies the model's filter function on each row of the source model. Use this if state\n /// external to the filter function has changed.\n void reset() { inner->reset(); }\n\n /// Given the \\a filtered_row index, this function returns the corresponding row index in the\n /// source model.\n int unfiltered_row(int filtered_row) const\n {\n inner->update_mapping();\n return inner->accepted_rows[filtered_row];\n }\n\n /// Returns the source model of this filter model.\n std::shared_ptr> source_model() const { return inner->source_model; }\n\nprivate:\n std::shared_ptr> inner;\n};\n\ntemplate\nclass MapModel;\n\nnamespace private_api {\ntemplate\nstruct MapModelInner : private_api::ModelChangeListener\n{\n MapModelInner(slint::MapModel &target_model)\n : target_model(target_model)\n {\n }\n\n void row_added(size_t index, size_t count) override\n {\n target_model.notify_row_added(index, count);\n }\n void row_changed(size_t index) override { target_model.notify_row_changed(index); }\n void row_removed(size_t index, size_t count) override\n {\n target_model.notify_row_removed(index, count);\n }\n void reset() override { target_model.notify_reset(); }\n\n slint::MapModel &target_model;\n};\n}\n\n/// The MapModel acts as an adapter model for a given source model by applying a mapping\n/// function. The mapping function is called for each row on the source model and allows\n/// transforming the values on the fly. The MapModel has two template parameters: The\n/// SourceModelData specifies the data type of the underlying source model, and the\n/// MappedModelData the data type of this MapModel. This permits not only changing the\n/// values of the underlying source model, but also changing the data type itself. For\n/// example a MapModel can be used to adapt a model that provides numbers to be a model\n/// that exposes all numbers converted to strings, by calling `std::to_string` on each\n/// value given in the mapping lambda expression.\n///\n/// \\code\n/// auto source_model = std::make_shared>(...);\n/// auto mapped_model = std::make_shared>(\n/// source_model, [](const Person &person) {\n// return fmt::format(\"{} {}\", person.first, person.last);\n// });\n/// \\endcode\ntemplate\nclass MapModel : public Model\n{\n friend struct private_api::MapModelInner;\n\npublic:\n /// Constructs a new MapModel that provides an altered view on the \\a source_model by applying\n /// \\a map_fn on the data in each row.\n MapModel(std::shared_ptr> source_model,\n std::function map_fn)\n : inner(std::make_shared>(\n *this)),\n model(source_model),\n map_fn(map_fn)\n {\n model->attach_peer(inner);\n }\n\n size_t row_count() const override { return model->row_count(); }\n\n std::optional row_data(size_t i) const override\n {\n if (auto source_data = model->row_data(i))\n return map_fn(*source_data);\n else\n return {};\n }\n\n /// Returns the source model of this filter model.\n std::shared_ptr> source_model() const { return model; }\n\n /// Re-applies the model's mapping function on each row of the source model. Use this if state\n /// external to the mapping function has changed.\n void reset() { inner->reset(); }\n\nprivate:\n std::shared_ptr> inner;\n std::shared_ptr> model;\n std::function map_fn;\n};\n\ntemplate\nclass SortModel;\n\nnamespace private_api {\ntemplate\nstruct SortModelInner : private_api::ModelChangeListener\n{\n SortModelInner(std::shared_ptr> source_model,\n std::function comp,\n slint::SortModel &target_model)\n : source_model(source_model), comp(comp), target_model(target_model)\n {\n }\n\n void row_added(size_t first_inserted_row, size_t count) override\n {\n if (sorted_rows_dirty) {\n reset();\n return;\n }\n\n // Adjust the existing sorted row indices to match the updated source model\n for (auto &row : sorted_rows) {\n if (row >= first_inserted_row)\n row += count;\n }\n\n for (size_t row = first_inserted_row; row < first_inserted_row + count; ++row) {\n auto inserted_value = source_model->row_data(row);\n if (!inserted_value)\n continue;\n auto insertion_point =\n std::lower_bound(sorted_rows.begin(), sorted_rows.end(), *inserted_value,\n [this](size_t sorted_row, const ModelData &inserted_value) {\n auto sorted_elem = source_model->row_data(sorted_row);\n return sorted_elem && comp(*sorted_elem, inserted_value);\n });\n\n insertion_point = sorted_rows.insert(insertion_point, row);\n target_model.notify_row_added(std::distance(sorted_rows.begin(), insertion_point), 1);\n }\n }\n void row_changed(size_t changed_row) override\n {\n if (sorted_rows_dirty) {\n reset();\n return;\n }\n\n auto removed_row_it =\n sorted_rows.erase(std::find(sorted_rows.begin(), sorted_rows.end(), changed_row));\n auto removed_row = std::distance(sorted_rows.begin(), removed_row_it);\n\n auto changed_value = source_model->row_data(changed_row);\n if (!changed_value)\n return;\n auto insertion_point =\n std::lower_bound(sorted_rows.begin(), sorted_rows.end(), *changed_value,\n [this](size_t sorted_row, const ModelData &changed_value) {\n auto sorted_elem = source_model->row_data(sorted_row);\n return sorted_elem && comp(*sorted_elem, changed_value);\n });\n\n insertion_point = sorted_rows.insert(insertion_point, changed_row);\n auto inserted_row = std::distance(sorted_rows.begin(), insertion_point);\n\n if (inserted_row == removed_row) {\n target_model.notify_row_changed(removed_row);\n } else {\n target_model.notify_row_removed(removed_row, 1);\n target_model.notify_row_added(inserted_row, 1);\n }\n }\n void row_removed(size_t first_removed_row, size_t count) override\n {\n if (sorted_rows_dirty) {\n reset();\n return;\n }\n\n std::vector removed_rows;\n removed_rows.reserve(count);\n\n for (auto it = sorted_rows.begin(); it != sorted_rows.end();) {\n if (*it >= first_removed_row) {\n if (*it < first_removed_row + count) {\n removed_rows.push_back(std::distance(sorted_rows.begin(), it));\n it = sorted_rows.erase(it);\n continue;\n } else {\n *it -= count;\n }\n }\n ++it;\n }\n\n for (auto removed_row : removed_rows) {\n target_model.notify_row_removed(removed_row, 1);\n }\n }\n\n void reset() override\n {\n sorted_rows_dirty = true;\n target_model.notify_reset();\n }\n\n void ensure_sorted()\n {\n if (!sorted_rows_dirty) {\n return;\n }\n\n sorted_rows.resize(source_model->row_count());\n for (size_t i = 0; i < sorted_rows.size(); ++i)\n sorted_rows[i] = i;\n\n std::sort(sorted_rows.begin(), sorted_rows.end(), [this](auto lhs_index, auto rhs_index) {\n auto lhs_elem = source_model->row_data(lhs_index);\n auto rhs_elem = source_model->row_data(rhs_index);\n return rhs_elem && lhs_elem && comp(*lhs_elem, *rhs_elem);\n });\n\n sorted_rows_dirty = false;\n }\n\n std::shared_ptr> source_model;\n std::function comp;\n slint::SortModel &target_model;\n std::vector sorted_rows;\n bool sorted_rows_dirty = true;\n};\n}\n\n/// The SortModel acts as an adapter model for a given source model by sorting all rows\n/// with by order provided by the given sorting function. The sorting function is called for\n/// pairs of elements of the source model.\n///\n/// \\code\n/// auto source_model = std::make_shared>(\n// std::vector { \"lorem\", \"ipsum\", \"dolor\" });\n/// auto sorted_model = std::make_shared>(\n/// source_model, [](auto lhs, auto rhs) { return lhs < rhs; }));\n/// \\endcode\n\ntemplate\nclass SortModel : public Model\n{\n friend struct private_api::SortModelInner;\n\npublic:\n /// Constructs a new SortModel that provides a sorted view on the \\a source_model by applying\n /// the order given by the specified \\a comp.\n SortModel(std::shared_ptr> source_model,\n std::function comp)\n : inner(std::make_shared>(std::move(source_model),\n std::move(comp), *this))\n {\n inner->source_model->attach_peer(inner);\n }\n\n size_t row_count() const override { return inner->source_model->row_count(); }\n\n std::optional row_data(size_t i) const override\n {\n inner->ensure_sorted();\n return inner->source_model->row_data(inner->sorted_rows[i]);\n }\n\n void set_row_data(size_t i, const ModelData &value) override\n {\n inner->source_model->set_row_data(inner->sorted_rows[i], value);\n }\n\n /// Re-applies the model's sort function on each row of the source model. Use this if state\n /// external to the sort function has changed.\n void reset() { inner->reset(); }\n\n /// Given the \\a sorted_row_index, this function returns the corresponding row index in the\n /// source model.\n int unsorted_row(int sorted_row_index) const\n {\n inner->ensure_sorted();\n return inner->sorted_rows[sorted_row_index];\n }\n\n /// Returns the source model of this filter model.\n std::shared_ptr> source_model() const { return inner->source_model; }\n\nprivate:\n std::shared_ptr> inner;\n};\n\ntemplate\nclass ReverseModel;\n\nnamespace private_api {\ntemplate\nstruct ReverseModelInner : private_api::ModelChangeListener\n{\n ReverseModelInner(std::shared_ptr> source_model,\n slint::ReverseModel &target_model)\n : source_model(source_model), target_model(target_model)\n {\n }\n\n void row_added(size_t first_inserted_row, size_t count) override\n {\n auto row_count = source_model->row_count();\n auto old_row_count = row_count - count;\n auto row = old_row_count - first_inserted_row;\n\n target_model.notify_row_added(row, count);\n }\n\n void row_changed(size_t changed_row) override\n {\n target_model.notify_row_changed(source_model->row_count() - 1 - changed_row);\n }\n\n void row_removed(size_t first_removed_row, size_t count) override\n {\n target_model.notify_row_removed(source_model->row_count() - first_removed_row, count);\n }\n\n void reset() override { target_model.notify_reset(); }\n\n std::shared_ptr> source_model;\n slint::ReverseModel &target_model;\n};\n}\n\n/// The ReverseModel acts as an adapter model for a given source model by reserving all rows.\n/// This means that the first row in the source model is the last row of this model, the second\n/// row is the second last, and so on.\n///\n/// \\code\n/// auto source_model = std::make_shared>(\n// std::vector { 1, 2, 3, 4, 5 });\n/// auto reversed_model = std::make_shared>(source_model);\n/// \\endcode\ntemplate\nclass ReverseModel : public Model\n{\n friend struct private_api::ReverseModelInner;\n\npublic:\n /// Constructs a new ReverseModel that provides a reversed view on the \\a source_model.\n ReverseModel(std::shared_ptr> source_model)\n : inner(std::make_shared>(std::move(source_model),\n *this))\n {\n inner->source_model->attach_peer(inner);\n }\n\n size_t row_count() const override { return inner->source_model->row_count(); }\n\n std::optional row_data(size_t i) const override\n {\n auto count = inner->source_model->row_count();\n return inner->source_model->row_data(count - i - 1);\n }\n\n void set_row_data(size_t i, const ModelData &value) override\n {\n auto count = inner->source_model->row_count();\n inner->source_model->set_row_data(count - i - 1, value);\n }\n\n /// Returns the source model of this reserve model.\n std::shared_ptr> source_model() const { return inner->source_model; }\n\nprivate:\n std::shared_ptr> inner;\n};\n\nnamespace private_api {\n\ntemplate\nclass Repeater\n{\n struct RepeaterInner : ModelChangeListener\n {\n enum class State { Clean, Dirty };\n struct RepeatedInstanceWithState\n {\n State state = State::Dirty;\n std::optional> ptr;\n };\n std::vector data;\n private_api::Property is_dirty { true };\n std::shared_ptr> model;\n\n void row_added(size_t index, size_t count) override\n {\n if (index > data.size()) {\n // Can happen before ensure_updated was called\n return;\n }\n is_dirty.set(true);\n data.resize(data.size() + count);\n std::rotate(data.begin() + index, data.end() - count, data.end());\n for (std::size_t i = index; i < data.size(); ++i) {\n // all the indexes are dirty\n data[i].state = State::Dirty;\n }\n }\n void row_changed(size_t index) override\n {\n if (index >= data.size()) {\n return;\n }\n auto &c = data[index];\n if (model && c.ptr) {\n std::optional data = model->row_data(index);\n (*c.ptr)->update_data(index, data ? *data : ModelData {});\n c.state = State::Clean;\n } else {\n c.state = State::Dirty;\n }\n }\n void row_removed(size_t index, size_t count) override\n {\n if (index + count > data.size()) {\n // Can happen before ensure_updated was called\n return;\n }\n is_dirty.set(true);\n data.erase(data.begin() + index, data.begin() + index + count);\n for (std::size_t i = index; i < data.size(); ++i) {\n // all the indexes are dirty\n data[i].state = State::Dirty;\n }\n }\n void reset() override\n {\n is_dirty.set(true);\n data.clear();\n }\n };\n\n private_api::Property>> model;\n mutable std::shared_ptr inner;\n\n vtable::VRef item_at(int i) const\n {\n const auto &x = inner->data.at(i);\n return { &C::static_vtable, const_cast(&(**x.ptr)) };\n }\n\npublic:\n template\n void set_model_binding(F &&binding) const\n {\n model.set_binding(std::forward(binding));\n }\n\n template\n void ensure_updated(const Parent *parent) const\n {\n if (model.is_dirty()) {\n auto old_model = model.get_internal();\n auto m = model.get();\n if (!inner || old_model != m) {\n inner = std::make_shared();\n if (m) {\n inner->model = m;\n m->attach_peer(inner);\n }\n }\n }\n\n if (inner && inner->is_dirty.get()) {\n inner->is_dirty.set(false);\n if (auto m = model.get()) {\n auto count = m->row_count();\n inner->data.resize(count);\n for (size_t i = 0; i < count; ++i) {\n auto &c = inner->data[i];\n bool created = false;\n if (!c.ptr) {\n c.ptr = C::create(parent);\n created = true;\n }\n if (c.state == RepeaterInner::State::Dirty) {\n std::optional data = m->row_data(i);\n (*c.ptr)->update_data(i, data ? *data : ModelData {});\n }\n if (created) {\n (*c.ptr)->init();\n }\n }\n } else {\n inner->data.clear();\n }\n } else {\n // just do a get() on the model to register dependencies so that, for example, the\n // layout property tracker becomes dirty.\n model.get();\n }\n }\n\n template\n void ensure_updated_listview(const Parent *parent,\n const private_api::Property *viewport_width,\n const private_api::Property *viewport_height,\n const private_api::Property *viewport_y,\n float listview_width, [[maybe_unused]] float listview_height) const\n {\n // TODO: the rust code in model.rs try to only allocate as many items as visible items\n ensure_updated(parent);\n\n float h = compute_layout_listview(viewport_width, listview_width, viewport_y->get());\n viewport_height->set(h);\n }\n\n uint64_t visit(TraversalOrder order, private_api::ItemVisitorRefMut visitor) const\n {\n for (std::size_t i = 0; i < inner->data.size(); ++i) {\n auto index = order == TraversalOrder::BackToFront ? i : inner->data.size() - 1 - i;\n auto ref = item_at(index);\n if (ref.vtable->visit_children_item(ref, -1, order, visitor)\n != std::numeric_limits::max()) {\n return index;\n }\n }\n return std::numeric_limits::max();\n }\n\n vtable::VWeak instance_at(std::size_t i) const\n {\n if (i >= inner->data.size()) {\n return {};\n }\n const auto &x = inner->data.at(i);\n return vtable::VWeak { x.ptr->into_dyn() };\n }\n\n private_api::IndexRange index_range() const\n {\n return private_api::IndexRange { 0, inner->data.size() };\n }\n\n std::size_t len() const { return inner ? inner->data.size() : 0; }\n\n float compute_layout_listview(const private_api::Property *viewport_width,\n float listview_width, float viewport_y) const\n {\n float offset = viewport_y;\n auto vp_width = listview_width;\n if (!inner)\n return offset;\n for (auto &x : inner->data) {\n vp_width = std::max(vp_width, (*x.ptr)->listview_layout(&offset));\n }\n viewport_width->set(vp_width);\n return offset - viewport_y;\n }\n\n void model_set_row_data(size_t row, const ModelData &data) const\n {\n if (model.is_dirty()) {\n std::abort();\n }\n if (auto m = model.get()) {\n if (row < m->row_count()) {\n m->set_row_data(row, data);\n }\n }\n }\n\n void for_each(auto &&f) const\n {\n if (inner) {\n for (auto &&x : inner->data) {\n f(*x.ptr);\n }\n }\n }\n};\n\ntemplate\nclass Conditional\n{\n private_api::Property model;\n mutable std::optional> instance;\n\npublic:\n template\n void set_model_binding(F &&binding) const\n {\n model.set_binding(std::forward(binding));\n }\n\n template\n void ensure_updated(const Parent *parent) const\n {\n if (!model.get()) {\n instance = std::nullopt;\n } else if (!instance) {\n instance = C::create(parent);\n (*instance)->init();\n }\n }\n\n uint64_t visit(TraversalOrder order, private_api::ItemVisitorRefMut visitor) const\n {\n if (instance) {\n vtable::VRef ref { &C::static_vtable,\n const_cast(&(**instance)) };\n if (ref.vtable->visit_children_item(ref, -1, order, visitor)\n != std::numeric_limits::max()) {\n return 0;\n }\n }\n return std::numeric_limits::max();\n }\n\n vtable::VWeak instance_at(std::size_t i) const\n {\n if (i != 0 || !instance) {\n return {};\n }\n return vtable::VWeak { instance->into_dyn() };\n }\n\n private_api::IndexRange index_range() const { return private_api::IndexRange { 0, len() }; }\n\n std::size_t len() const { return instance ? 1 : 0; }\n\n void for_each(auto &&f) const\n {\n if (instance) {\n f(*instance);\n }\n }\n};\n\n} // namespace private_api\n\n} // namespace slint\n" }, { "path": "api/cpp/include/slint_pathdata.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n#include \n#include \n#include \"slint_pathdata_internal.h\"\n\nnamespace slint::private_api {\nusing cbindgen_private::PathEvent;\nusing cbindgen_private::types::PathArcTo;\nusing cbindgen_private::types::PathCubicTo;\nusing cbindgen_private::types::PathElement;\nusing cbindgen_private::types::PathLineTo;\nusing cbindgen_private::types::PathMoveTo;\nusing cbindgen_private::types::PathQuadraticTo;\nusing cbindgen_private::types::Point;\n\nstruct PathData\n{\npublic:\n using Tag = cbindgen_private::types::PathData::Tag;\n\n PathData() : data(Data::None()) { }\n PathData(const PathElement *firstElement, size_t count)\n : data(Data::Elements(elements_from_array(firstElement, count)))\n {\n }\n\n PathData(const PathEvent *firstEvent, size_t event_count, const Point *firstCoordinate,\n size_t coordinate_count)\n : data(events_from_array(firstEvent, event_count, firstCoordinate, coordinate_count))\n {\n }\n\n PathData(const SharedString &commands)\n : data(cbindgen_private::types::PathData::Commands(commands))\n {\n }\n\n friend bool operator==(const PathData &a, const PathData &b) = default;\n\nprivate:\n static SharedVector elements_from_array(const PathElement *firstElement,\n size_t count)\n {\n SharedVector tmp;\n slint_new_path_elements(&tmp, firstElement, count);\n return tmp;\n }\n\n static cbindgen_private::types::PathData events_from_array(const PathEvent *firstEvent,\n size_t event_count,\n const Point *firstCoordinate,\n size_t coordinate_count)\n {\n SharedVector events;\n SharedVector coordinates;\n slint_new_path_events(&events, &coordinates, firstEvent, event_count, firstCoordinate,\n coordinate_count);\n return Data::Events(events, coordinates);\n }\n\n using Data = cbindgen_private::types::PathData;\n Data data;\n};\n\n}\n" }, { "path": "api/cpp/include/slint_point.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \n\nnamespace slint {\n\n/// The Point structure is used to represent a two-dimensional point\n/// with x and y coordinates.\ntemplate\nstruct Point\n{\n /// The x coordinate of the point\n T x;\n /// The y coordinate of the point\n T y;\n\n /// Compares with \\a other and returns true if they are equal; false otherwise.\n bool operator==(const Point &other) const = default;\n};\n\nnamespace cbindgen_private {\n// The Point types are expanded to the Point2D<...> type from the euclid crate which\n// is binary compatible with Point\ntemplate\nusing Point2D = Point;\n}\n\n/// A position in logical pixel coordinates\nstruct LogicalPosition : public Point\n{\n /// Explicitly convert a Point to a LogicalPosition\n explicit LogicalPosition(const Point p) : Point(p) { };\n /// Default construct a LogicalPosition in the origin\n LogicalPosition() : Point { 0., 0. } { };\n};\n/// A position in physical pixel coordinates\nstruct PhysicalPosition : public Point\n{\n /// Explicitly convert a Point to a LogicalPosition\n explicit PhysicalPosition(const Point p) : Point(p) { };\n /// Default construct a PhysicalPosition in the origin\n PhysicalPosition() : Point { 0, 0 } { };\n};\n\n}\n" }, { "path": "api/cpp/include/slint_properties.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n#include \n#include \n\nnamespace slint::cbindgen_private {\nstruct PropertyAnimation;\nstruct ChangeTracker\n{\n void *inner;\n};\n}\n\n#include \"slint_properties_internal.h\"\n#include \"slint_builtin_structs_internal.h\"\n\nnamespace slint::private_api {\n\nusing cbindgen_private::StateInfo;\n\ninline void slint_property_set_animated_binding_helper(\n const cbindgen_private::PropertyHandleOpaque *handle, void (*binding)(void *, int *),\n void *user_data, void (*drop_user_data)(void *),\n cbindgen_private::PropertyAnimation (*transition_data)(void *, uint64_t **))\n{\n cbindgen_private::slint_property_set_animated_binding_int(handle, binding, user_data,\n drop_user_data, transition_data);\n}\n\ninline void slint_property_set_animated_binding_helper(\n const cbindgen_private::PropertyHandleOpaque *handle, void (*binding)(void *, float *),\n void *user_data, void (*drop_user_data)(void *),\n cbindgen_private::PropertyAnimation (*transition_data)(void *, uint64_t **))\n{\n cbindgen_private::slint_property_set_animated_binding_float(handle, binding, user_data,\n drop_user_data, transition_data);\n}\n\ninline void slint_property_set_animated_binding_helper(\n const cbindgen_private::PropertyHandleOpaque *handle, void (*binding)(void *, Color *),\n void *user_data, void (*drop_user_data)(void *),\n cbindgen_private::PropertyAnimation (*transition_data)(void *, uint64_t **))\n{\n cbindgen_private::slint_property_set_animated_binding_color(handle, binding, user_data,\n drop_user_data, transition_data);\n}\n\ninline void slint_property_set_animated_binding_helper(\n const cbindgen_private::PropertyHandleOpaque *handle, void (*binding)(void *, Brush *),\n void *user_data, void (*drop_user_data)(void *),\n cbindgen_private::PropertyAnimation (*transition_data)(void *, uint64_t **))\n{\n cbindgen_private::slint_property_set_animated_binding_brush(handle, binding, user_data,\n drop_user_data, transition_data);\n}\n\ntemplate\nstruct Property\n{\n Property() { cbindgen_private::slint_property_init(&inner); }\n ~Property() { cbindgen_private::slint_property_drop(&inner); }\n Property(const Property &) = delete;\n Property(Property &&) = delete;\n Property &operator=(const Property &) = delete;\n explicit Property(const T &value) : value(value)\n {\n cbindgen_private::slint_property_init(&inner);\n }\n\n /* Should it be implicit?\n void operator=(const T &value) {\n set(value);\n }*/\n\n void set(const T &value) const\n {\n if ((inner._0 & 0b10) == 0b10 || this->value != value) {\n this->value = value;\n cbindgen_private::slint_property_set_changed(&inner, &this->value);\n }\n }\n\n const T &get() const\n {\n cbindgen_private::slint_property_update(&inner, &value);\n return value;\n }\n\n template\n void set_binding(F binding) const\n {\n cbindgen_private::slint_property_set_binding(\n &inner,\n [](void *user_data, void *value) {\n *reinterpret_cast(value) = (*reinterpret_cast(user_data))();\n },\n new F(binding), [](void *user_data) { delete reinterpret_cast(user_data); },\n nullptr, nullptr);\n }\n\n inline void set_animated_value(const T &value,\n const cbindgen_private::PropertyAnimation &animation_data) const;\n\n template\n inline void set_animated_binding(F binding, Trans animation) const\n {\n struct UserData\n {\n F binding;\n Trans animation;\n };\n private_api::slint_property_set_animated_binding_helper(\n &inner,\n [](void *user_data, T *value) {\n *reinterpret_cast(value) =\n reinterpret_cast(user_data)->binding();\n },\n new UserData { binding, animation },\n [](void *user_data) { delete reinterpret_cast(user_data); },\n [](void *user_data, uint64_t **instant) {\n return reinterpret_cast(user_data)->animation(instant);\n });\n }\n\n bool is_dirty() const { return cbindgen_private::slint_property_is_dirty(&inner); }\n void mark_dirty() const { cbindgen_private::slint_property_mark_dirty(&inner); }\n\n static void link_two_way(const Property *p1, const Property *p2)\n {\n auto value = p2->get();\n cbindgen_private::PropertyHandleOpaque handle {};\n if ((p2->inner._0 & 0b10) == 0b10) {\n std::swap(handle, const_cast *>(p2)->inner);\n }\n auto common_property = std::make_shared>(handle, std::move(value));\n cbindgen_private::slint_property_set_binding(\n &p1->inner, TwoWayBinding::call_fn, new TwoWayBinding { common_property },\n TwoWayBinding::del_fn, TwoWayBinding::intercept_fn,\n TwoWayBinding::intercept_binding_fn);\n cbindgen_private::slint_property_set_binding(\n &p2->inner, TwoWayBinding::call_fn, new TwoWayBinding { common_property },\n TwoWayBinding::del_fn, TwoWayBinding::intercept_fn,\n TwoWayBinding::intercept_binding_fn);\n }\n\n template\n static void link_two_way_with_map(const Property *prop1, const Property *prop2, M1 map1,\n M2 map2)\n {\n // TODO: neither this nor link_two_way manages to re-use a common_property like the Rust\n // equivalent does.\n\n auto value = prop1->get();\n cbindgen_private::PropertyHandleOpaque handle {};\n if ((prop1->inner._0 & 0b10) == 0b10) {\n std::swap(handle, const_cast *>(prop1)->inner);\n }\n auto common_property = std::make_shared>(handle, std::move(value));\n\n struct TwoWayBindingWithMap\n {\n std::shared_ptr> common_property;\n M1 map_to;\n M2 map_from;\n };\n auto del_fn = [](void *user_data) {\n delete reinterpret_cast(user_data);\n };\n auto call_fn = [](void *user_data, void *value) {\n auto self = reinterpret_cast(user_data);\n *reinterpret_cast(value) = self->map_to(self->common_property->get());\n };\n auto intercept_fn = [](void *user_data, const void *value) {\n auto self = reinterpret_cast(user_data);\n T old = self->common_property->get();\n self->map_from(old, *reinterpret_cast(value));\n self->common_property->set(old);\n return true;\n };\n auto intercept_binding_fn = [](void *user_data, void *t2_binding) {\n struct BindingMapper\n {\n void *t2_binding;\n M1 map_to;\n M2 map_from;\n ~BindingMapper() { cbindgen_private::slint_property_delete_binding(t2_binding); }\n const BindingMapper &operator=(const BindingMapper &) = delete;\n };\n auto self = reinterpret_cast(user_data);\n cbindgen_private::slint_property_set_binding(\n &self->common_property->inner,\n [](void *user_data, void *value) {\n auto self = reinterpret_cast(user_data);\n T &v = *reinterpret_cast(value);\n T2 sub_value = self->map_to(v);\n cbindgen_private::slint_property_evaluate_binding(self->t2_binding,\n &sub_value);\n self->map_from(v, sub_value);\n },\n new BindingMapper { t2_binding, self->map_to, self->map_from },\n [](void *user_data) { delete reinterpret_cast(user_data); },\n nullptr, nullptr);\n return true;\n };\n\n cbindgen_private::slint_property_set_binding(\n &prop1->inner, TwoWayBinding::call_fn, new TwoWayBinding { common_property },\n TwoWayBinding::del_fn, TwoWayBinding::intercept_fn,\n TwoWayBinding::intercept_binding_fn);\n\n cbindgen_private::slint_property_set_binding(\n &prop2->inner, call_fn, new TwoWayBindingWithMap { common_property, map1, map2 },\n del_fn, intercept_fn, intercept_binding_fn);\n }\n\n /// Internal (private) constructor used by link_two_way\n explicit Property(cbindgen_private::PropertyHandleOpaque inner, T value)\n : inner(inner), value(std::move(value))\n {\n }\n\n const T &get_internal() const { return value; }\n\n void set_constant() const { cbindgen_private::slint_property_set_constant(&inner); }\n\nprivate:\n cbindgen_private::PropertyHandleOpaque inner;\n mutable T value {};\n template\n friend void set_state_binding(const Property &property, F binding);\n\n template\n friend struct Property;\n\n struct TwoWayBinding\n {\n std::shared_ptr> common_property;\n\n static void del_fn(void *user_data)\n {\n delete reinterpret_cast(user_data);\n };\n static void call_fn(void *user_data, void *value)\n {\n *reinterpret_cast(value) =\n reinterpret_cast(user_data)->common_property->get();\n };\n static bool intercept_fn(void *user_data, const void *value)\n {\n reinterpret_cast(user_data)->common_property->set(\n *reinterpret_cast(value));\n return true;\n };\n static bool intercept_binding_fn(void *user_data, void *value)\n {\n cbindgen_private::slint_property_set_binding_internal(\n &reinterpret_cast(user_data)->common_property->inner, value);\n return true;\n };\n };\n};\n\ntemplate<>\ninline void Property::set_animated_value(\n const int32_t &new_value, const cbindgen_private::PropertyAnimation &animation_data) const\n{\n cbindgen_private::slint_property_set_animated_value_int(&inner, value, new_value,\n &animation_data);\n}\n\ntemplate<>\ninline void\nProperty::set_animated_value(const float &new_value,\n const cbindgen_private::PropertyAnimation &animation_data) const\n{\n cbindgen_private::slint_property_set_animated_value_float(&inner, value, new_value,\n &animation_data);\n}\n\ntemplate<>\ninline void\nProperty::set_animated_value(const Color &new_value,\n const cbindgen_private::PropertyAnimation &animation_data) const\n{\n cbindgen_private::slint_property_set_animated_value_color(&inner, value, new_value,\n &animation_data);\n}\n\ntemplate\nvoid set_state_binding(const Property &property, F binding)\n{\n cbindgen_private::slint_property_set_state_binding(\n &property.inner,\n [](void *user_data) -> int32_t { return (*reinterpret_cast(user_data))(); },\n new F(binding), [](void *user_data) { delete reinterpret_cast(user_data); });\n}\n\n/// PropertyTracker allows keeping track of when properties change and lazily evaluate code\n/// if necessary.\n/// Once constructed, you can call evaluate() with a functor that will be invoked. Any\n/// Property types that have their value read from within the invoked functor or any code that's\n/// reached from there are added to internal book-keeping. When after returning from evaluate(),\n/// any of these accessed properties change their value, the property tracker's is_dirt() function\n/// will return true.\n///\n/// PropertyTracker instances nest, so if during the evaluation of one tracker, another tracker's\n/// evaluate() function gets called and properties from within that evaluation change their value\n/// later, both tracker instances will report true for is_dirty(). If you would like to disable the\n/// nesting, use the evaluate_as_dependency_root() function instead.\nstruct PropertyTracker\n{\n /// Constructs a new property tracker instance.\n PropertyTracker() { cbindgen_private::slint_property_tracker_init(&inner); }\n /// Destroys the property tracker.\n ~PropertyTracker() { cbindgen_private::slint_property_tracker_drop(&inner); }\n /// The copy constructor is intentionally deleted, property trackers cannot be copied.\n PropertyTracker(const PropertyTracker &) = delete;\n /// The assignment operator is intentionally deleted, property trackers cannot be copied.\n PropertyTracker &operator=(const PropertyTracker &) = delete;\n\n /// Returns true if any properties accessed during the last evaluate() call have changed their\n /// value since then.\n bool is_dirty() const { return cbindgen_private::slint_property_tracker_is_dirty(&inner); }\n\n /// Invokes the provided functor \\a f and tracks accessed to any properties during that\n /// invocation.\n template\n auto evaluate(const F &f) const -> std::enable_if_t>\n {\n cbindgen_private::slint_property_tracker_evaluate(\n &inner, [](void *f) { (*reinterpret_cast(f))(); }, const_cast(&f));\n }\n\n /// Invokes the provided functor \\a f and tracks accessed to any properties during that\n /// invocation. Use this overload if your functor returns a value, as evaluate() will pass it on\n /// and return it.\n template\n auto evaluate(const F &f) const\n -> std::enable_if_t, decltype(f())>\n {\n decltype(f()) result;\n this->evaluate([&] { result = f(); });\n return result;\n }\n\n /// Invokes the provided functor \\a f and tracks accessed to any properties during that\n /// invocation.\n ///\n /// This starts a new dependency chain and if called during the evaluation of another\n /// property tracker, the outer tracker will not be notified if any accessed properties change.\n template\n auto evaluate_as_dependency_root(const F &f) const\n -> std::enable_if_t>\n {\n cbindgen_private::slint_property_tracker_evaluate_as_dependency_root(\n &inner, [](void *f) { (*reinterpret_cast(f))(); }, const_cast(&f));\n }\n\n /// Invokes the provided functor \\a f and tracks accessed to any properties during that\n /// invocation. Use this overload if your functor returns a value, as evaluate() will pass it on\n /// and return it.\n ///\n /// This starts a new dependency chain and if called during the evaluation of another\n /// property tracker, the outer tracker will not be notified if any accessed properties change.\n template\n auto evaluate_as_dependency_root(const F &f) const\n -> std::enable_if_t, decltype(f())>\n {\n decltype(f()) result;\n this->evaluate_as_dependency_root([&] { result = f(); });\n return result;\n }\n\nprivate:\n cbindgen_private::PropertyTrackerOpaque inner;\n};\n\nstruct ChangeTracker\n{\n ChangeTracker() { cbindgen_private::slint_change_tracker_construct(&inner); }\n ~ChangeTracker() { cbindgen_private::slint_change_tracker_drop(&inner); }\n\n template\n void init(Data data, FnEval fn_eval, FnNotify fn_notify)\n {\n using Value = std::invoke_result_t;\n struct Inner\n {\n Data data;\n FnEval fn_eval;\n FnNotify fn_notify;\n Value value;\n };\n auto data_ptr =\n new Inner { std::move(data), std::move(fn_eval), std::move(fn_notify), Value() };\n cbindgen_private::slint_change_tracker_init(\n &inner, data_ptr, [](void *d) { delete reinterpret_cast(d); },\n [](void *d) {\n auto inner = reinterpret_cast(d);\n auto v = inner->fn_eval(inner->data);\n bool r = v != inner->value;\n inner->value = v;\n return r;\n },\n [](void *d) {\n auto inner = reinterpret_cast(d);\n inner->fn_notify(inner->data, inner->value);\n });\n }\n\nprivate:\n cbindgen_private::ChangeTracker inner;\n};\n\n} // namespace slint::private_api\n" }, { "path": "api/cpp/include/slint_sharedvector.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n#include \"slint_sharedvector_internal.h\"\n#include \n#include \n#include \n#include \n\nnamespace slint {\n\n/// SharedVector is a vector template class similar to std::vector that's primarily used for passing\n/// data in and out of the Slint run-time library. It uses implicit-sharing to make creating\n/// copies cheap. Only when a function changes the vector's data, a copy is is made.\ntemplate\nstruct SharedVector\n{\n /// Creates a new, empty vector.\n SharedVector()\n : inner(const_cast(reinterpret_cast(\n cbindgen_private::slint_shared_vector_empty())))\n {\n }\n\n /// Creates a new vector that holds all the elements of the given std::initializer_list \\a args.\n SharedVector(std::initializer_list args)\n : SharedVector(SharedVector::with_capacity(args.size()))\n {\n auto new_data = reinterpret_cast(inner + 1);\n auto input_it = args.begin();\n for (std::size_t i = 0; i < args.size(); ++i, ++input_it) {\n new (new_data + i) T(*input_it);\n inner->size++;\n }\n }\n\n /// Creates a vector of a given size, with default-constructed data.\n explicit SharedVector(size_t size) : SharedVector(SharedVector::with_capacity(size))\n {\n auto new_data = reinterpret_cast(inner + 1);\n for (std::size_t i = 0; i < size; ++i) {\n new (new_data + i) T();\n inner->size++;\n }\n }\n\n /// Creates a vector of a given size, initialized with copies of the \\a value.\n explicit SharedVector(size_t size, const T &value)\n : SharedVector(SharedVector::with_capacity(size))\n {\n auto new_data = reinterpret_cast(inner + 1);\n for (std::size_t i = 0; i < size; ++i) {\n new (new_data + i) T(value);\n inner->size++;\n }\n }\n\n /// Constructs the container with the contents of the range `[first, last)`.\n template\n SharedVector(InputIt first, InputIt last)\n : SharedVector(SharedVector::with_capacity(std::distance(first, last)))\n {\n std::uninitialized_copy(first, last, begin());\n inner->size = inner->capacity;\n }\n\n /// Creates a new vector that is a copy of \\a other.\n SharedVector(const SharedVector &other) : inner(other.inner)\n {\n if (inner->refcount > 0) {\n ++inner->refcount;\n }\n }\n\n /// Destroys this vector. The underlying data is destroyed if no other\n /// vector references it.\n ~SharedVector() { drop(); }\n /// Assigns the data of \\a other to this vector and returns a reference to this vector.\n SharedVector &operator=(const SharedVector &other)\n {\n if (other.inner == inner) {\n return *this;\n }\n drop();\n inner = other.inner;\n if (inner->refcount > 0) {\n ++inner->refcount;\n }\n return *this;\n }\n /// Move-assign's \\a other to this vector and returns a reference to this vector.\n SharedVector &operator=(SharedVector &&other)\n {\n std::swap(inner, other.inner);\n return *this;\n }\n\n /// Returns a const pointer to the first element of this vector.\n const T *cbegin() const { return reinterpret_cast(inner + 1); }\n\n /// Returns a const pointer that points past the last element of this vector. The\n /// pointer cannot be dereferenced, it can only be used for comparison.\n const T *cend() const { return cbegin() + inner->size; }\n\n /// Returns a const pointer to the first element of this vector.\n const T *begin() const { return cbegin(); }\n /// Returns a const pointer that points past the last element of this vector. The\n /// pointer cannot be dereferenced, it can only be used for comparison.\n const T *end() const { return cend(); }\n\n /// Returns a pointer to the first element of this vector.\n T *begin()\n {\n detach(inner->size);\n return reinterpret_cast(inner + 1);\n }\n\n /// Returns a pointer that points past the last element of this vector. The\n /// pointer cannot be dereferenced, it can only be used for comparison.\n T *end()\n {\n detach(inner->size);\n return begin() + inner->size;\n }\n\n /// Returns the number of elements in this vector.\n std::size_t size() const { return inner->size; }\n\n /// Returns true if there are no elements on this vector; false otherwise.\n bool empty() const { return inner->size == 0; }\n\n /// This indexing operator returns a reference to the \\a `index`th element of this vector.\n T &operator[](std::size_t index) { return begin()[index]; }\n /// This indexing operator returns a const reference to the \\a `index`th element of this vector.\n const T &operator[](std::size_t index) const { return begin()[index]; }\n\n /// Returns a reference to the \\a `index`th element of this vector.\n const T &at(std::size_t index) const { return begin()[index]; }\n\n /// Appends the \\a value as a new element to the end of this vector.\n void push_back(const T &value)\n {\n detach(inner->size + 1);\n new (end()) T(value);\n inner->size++;\n }\n /// Moves the \\a value as a new element to the end of this vector.\n void push_back(T &&value)\n {\n detach(inner->size + 1);\n new (end()) T(std::move(value));\n inner->size++;\n }\n\n /// Clears the vector and removes all elements. The capacity remains unaffected.\n void clear()\n {\n if (inner->refcount != 1) {\n *this = SharedVector();\n } else {\n auto b = cbegin(), e = cend();\n inner->size = 0;\n for (auto it = b; it < e; ++it) {\n it->~T();\n }\n }\n }\n\n /// Returns true if the vector \\a a has the same number of elements as \\a b\n /// and all the elements also compare equal; false otherwise.\n friend bool operator==(const SharedVector &a, const SharedVector &b)\n {\n if (a.size() != b.size())\n return false;\n return std::equal(a.cbegin(), a.cend(), b.cbegin());\n }\n\n /// \\private\n std::size_t capacity() const { return inner->capacity; }\n\nprivate:\n void detach(std::size_t expected_capacity)\n {\n if (inner->refcount == 1 && expected_capacity <= inner->capacity) {\n return;\n }\n auto new_array = SharedVector::with_capacity(expected_capacity);\n auto old_data = reinterpret_cast(inner + 1);\n auto new_data = reinterpret_cast(new_array.inner + 1);\n for (std::size_t i = 0; i < inner->size; ++i) {\n new (new_data + i) T(old_data[i]);\n new_array.inner->size++;\n }\n *this = std::move(new_array);\n }\n\n void drop()\n {\n if (inner->refcount > 0 && (--inner->refcount) == 0) {\n auto b = cbegin(), e = cend();\n for (auto it = b; it < e; ++it) {\n it->~T();\n }\n cbindgen_private::slint_shared_vector_free(reinterpret_cast(inner),\n sizeof(SharedVectorHeader)\n + inner->capacity * sizeof(T),\n alignof(SharedVectorHeader));\n }\n }\n\n static SharedVector with_capacity(std::size_t capacity)\n {\n auto mem = cbindgen_private::slint_shared_vector_allocate(\n sizeof(SharedVectorHeader) + capacity * sizeof(T), alignof(SharedVectorHeader));\n return SharedVector(new (mem) SharedVectorHeader { { 1 }, 0, capacity });\n }\n\n#if !defined(DOXYGEN)\n // Unfortunately, this cannot be generated by cbindgen because std::atomic is not understood\n struct SharedVectorHeader\n {\n std::atomic refcount;\n std::size_t size;\n std::size_t capacity;\n };\n static_assert(alignof(T) <= alignof(SharedVectorHeader),\n \"Not yet supported because we would need to add padding\");\n SharedVectorHeader *inner;\n explicit SharedVector(SharedVectorHeader *inner) : inner(inner) { }\n#endif\n};\n\n#if !defined(DOXYGEN) // Hide these from Doxygen as Slice is private API\ntemplate\nbool operator==(cbindgen_private::Slice a, cbindgen_private::Slice b)\n{\n if (a.len != b.len)\n return false;\n return std::equal(a.ptr, a.ptr + a.len, b.ptr);\n}\ntemplate\nbool operator!=(cbindgen_private::Slice a, cbindgen_private::Slice b)\n{\n return !(a != b);\n}\n#endif // !defined(DOXYGEN)\n\n}\n" }, { "path": "api/cpp/include/slint_size.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \n\nnamespace slint {\n\n/// The Size structure is used to represent a two-dimensional size\n/// with width and height.\ntemplate\nstruct Size\n{\n /// The width of the size\n T width;\n /// The height of the size\n T height;\n\n /// Compares with \\a other and returns true if they are equal; false otherwise.\n bool operator==(const Size &other) const = default;\n};\n\nnamespace cbindgen_private {\n// The Size types are expanded to the Size2D<...> type from the euclid crate which\n// is binary compatible with Size\ntemplate\nusing Size2D = Size;\n}\n\n/// A size given in logical pixels\nstruct LogicalSize : public Size\n{\n /// Explicitly convert a Size to a LogicalSize\n explicit constexpr LogicalSize(const Size s = { 0, 0 }) : Size(s) { }\n};\n/// A size given in physical pixels.\nstruct PhysicalSize : public Size\n{\n /// Explicitly convert a Size to a LogicalSize\n explicit constexpr PhysicalSize(const Size s = { 0, 0 }) : Size(s) { }\n};\n\n}\n" }, { "path": "api/cpp/include/slint_string.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n#include \n#include \n#include \"slint_string_internal.h\"\n\nnamespace slint {\n\n/// A string type used by the Slint run-time.\n///\n/// SharedString uses implicit data sharing to make it efficient to pass around copies. When\n/// copying, a reference to the data is cloned, not the data itself.\n///\n/// The class provides constructors from std::string_view as well as the automatic conversion to\n/// a std::string_view.\n///\n/// For convenience, it's also possible to convert a number to a string using\n/// SharedString::from_number(double).\n///\n/// Under the hood the string data is UTF-8 encoded and it is always terminated with a null\n/// character.\nstruct SharedString\n{\n /// Creates an empty default constructed string.\n SharedString() { cbindgen_private::slint_shared_string_from_bytes(this, \"\", 0); }\n /// Creates a new SharedString from the string view \\a s. The underlying string data\n /// is copied.\n SharedString(std::string_view s)\n {\n cbindgen_private::slint_shared_string_from_bytes(this, s.data(), s.size());\n }\n /// Creates a new SharedString from the null-terminated string pointer \\a s. The underlying\n /// string data is copied. It is assumed that the string is UTF-8 encoded.\n SharedString(const char *s) : SharedString(std::string_view(s)) { }\n /// Creates a new SharedString from the null-terminated string pointer \\a s. The underlying\n /// string data is copied.\n SharedString(const char8_t *s) : SharedString(reinterpret_cast(s)) { }\n /// Creates a new SharedString from the string view \\a s. The underlying string data is copied.\n SharedString(std::u8string_view s)\n {\n cbindgen_private::slint_shared_string_from_bytes(\n this, reinterpret_cast(s.data()), s.size());\n }\n /// Creates a new SharedString from \\a other.\n SharedString(const SharedString &other)\n {\n cbindgen_private::slint_shared_string_clone(this, &other);\n }\n /// Destroys this SharedString and frees the memory if this is the last instance\n /// referencing it.\n ~SharedString() { cbindgen_private::slint_shared_string_drop(this); }\n /// Assigns \\a other to this string and returns a reference to this string.\n SharedString &operator=(const SharedString &other)\n {\n cbindgen_private::slint_shared_string_drop(this);\n cbindgen_private::slint_shared_string_clone(this, &other);\n return *this;\n }\n /// Assigns the string view \\a s to this string and returns a reference to this string.\n /// The underlying string data is copied. It is assumed that the string is UTF-8 encoded.\n SharedString &operator=(std::string_view s)\n {\n cbindgen_private::slint_shared_string_drop(this);\n cbindgen_private::slint_shared_string_from_bytes(this, s.data(), s.size());\n return *this;\n }\n /// Assigns null-terminated string pointer \\a s to this string and returns a reference\n /// to this string. The underlying string data is copied. It is assumed that the string\n /// is UTF-8 encoded.\n SharedString &operator=(const char *s) { return *this = std::string_view(s); }\n\n /// Move-assigns \\a other to this SharedString instance.\n SharedString &operator=(SharedString &&other)\n {\n std::swap(inner, other.inner);\n return *this;\n }\n\n /// Provides a view to the string data. The returned view is only valid as long as at\n /// least this SharedString exists.\n operator std::string_view() const { return cbindgen_private::slint_shared_string_bytes(this); }\n /// Provides a raw pointer to the string data. The returned pointer is only valid as long as at\n /// least this SharedString exists.\n auto data() const -> const char * { return cbindgen_private::slint_shared_string_bytes(this); }\n /// Size of the string, in bytes. This excludes the terminating null character.\n std::size_t size() const { return std::string_view(*this).size(); }\n\n /// Returns a pointer to the first character. It is only safe to dereference the pointer if the\n /// string contains at least one character.\n const char *begin() const { return data(); }\n /// Returns a point past the last character of the string. It is not safe to dereference the\n /// pointer, but it is suitable for comparison.\n const char *end() const\n {\n std::string_view view(*this);\n return view.data() + view.size();\n }\n\n /// \\return true if the string contains no characters; false otherwise.\n bool empty() const { return std::string_view(*this).empty(); }\n\n /// \\return true if the string starts with the specified prefix string; false otherwise\n bool starts_with(std::string_view prefix) const\n {\n return std::string_view(*this).substr(0, prefix.size()) == prefix;\n }\n\n /// \\return true if the string ends with the specified prefix string; false otherwise\n bool ends_with(std::string_view prefix) const\n {\n std::string_view self_view(*this);\n return self_view.size() >= prefix.size()\n && self_view.compare(self_view.size() - prefix.size(), std::string_view::npos,\n prefix)\n == 0;\n }\n\n /// Reset to an empty string\n void clear() { *this = std::string_view(\"\", 0); }\n\n /// Creates a new SharedString from the given number \\a n. The string representation of the\n /// number uses a minimal formatting scheme: If \\a n has no fractional part, the number will be\n /// formatted as an integer.\n ///\n /// For example:\n /// \\code\n /// auto str = slint::SharedString::from_number(42); // creates \"42\"\n /// auto str2 = slint::SharedString::from_number(100.5) // creates \"100.5\"\n /// \\endcode\n static SharedString from_number(double n) { return SharedString(n); }\n\n /// Returns the lowercase equivalent of this string, as a new SharedString.\n ///\n /// For example:\n /// \\code\n /// auto str = slint::SharedString(\"Hello\");\n /// auto str2 = str.to_lowercase(); // creates \"hello\"\n /// \\endcode\n SharedString to_lowercase() const\n {\n auto out = SharedString();\n cbindgen_private::slint_shared_string_to_lowercase(&out, this);\n return out;\n }\n\n /// Returns the uppercase equivalent of this string, as a new SharedString.\n ///\n /// For example:\n /// \\code\n /// auto str = slint::SharedString(\"Hello\");\n /// auto str2 = str.to_uppercase(); // creates \"HELLO\"\n /// \\endcode\n SharedString to_uppercase() const\n {\n auto out = SharedString();\n cbindgen_private::slint_shared_string_to_uppercase(&out, this);\n return out;\n }\n\n /// Returns true if \\a a is equal to \\a b; otherwise returns false.\n friend bool operator==(const SharedString &a, const SharedString &b)\n {\n return std::string_view(a) == std::string_view(b);\n }\n /// Returns true if \\a a is not equal to \\a b; otherwise returns false.\n friend bool operator!=(const SharedString &a, const SharedString &b)\n {\n return std::string_view(a) != std::string_view(b);\n }\n\n /// Returns true if \\a a is lexicographically less than \\a b; false otherwise.\n friend bool operator<(const SharedString &a, const SharedString &b)\n {\n return std::string_view(a) < std::string_view(b);\n }\n /// Returns true if \\a a is lexicographically less or equal than \\a b; false otherwise.\n friend bool operator<=(const SharedString &a, const SharedString &b)\n {\n return std::string_view(a) <= std::string_view(b);\n }\n /// Returns true if \\a a is lexicographically greater than \\a b; false otherwise.\n friend bool operator>(const SharedString &a, const SharedString &b)\n {\n return std::string_view(a) > std::string_view(b);\n }\n /// Returns true if \\a a is lexicographically greater or equal than \\a b; false otherwise.\n friend bool operator>=(const SharedString &a, const SharedString &b)\n {\n return std::string_view(a) >= std::string_view(b);\n }\n\n /// Writes the \\a shared_string to the specified \\a stream and returns a reference to the\n /// stream.\n friend std::ostream &operator<<(std::ostream &stream, const SharedString &shared_string)\n {\n return stream << std::string_view(shared_string);\n }\n\n /// Concatenates \\a a and \\a and returns the result as a new SharedString.\n friend SharedString operator+(const SharedString &a, std::string_view b)\n {\n SharedString a2 = a;\n return a2 += b;\n }\n /// Move-concatenates \\a b to \\a and returns a reference to \\a a.\n friend SharedString operator+(SharedString &&a, std::string_view b)\n {\n a += b;\n return a;\n }\n /// Appends \\a other to this string and returns a reference to this.\n SharedString &operator+=(std::string_view other)\n {\n cbindgen_private::slint_shared_string_append(this, other.data(), other.size());\n return *this;\n }\n\nprivate:\n /// Use SharedString::from_number\n explicit SharedString(double n) { cbindgen_private::slint_shared_string_from_number(this, n); }\n void *inner; // opaque\n};\n\nnamespace private_api {\n\n/// Styled text that has been parsed and seperated into paragraphs\nstruct StyledText\n{\npublic:\n /// Creates an default styled text.\n StyledText() { cbindgen_private::slint_styled_text_new(this); }\n /// Destroys this StyledText.\n ~StyledText() { cbindgen_private::slint_styled_text_drop(this); }\n\n /// Creates a new StyledText from \\a other.\n StyledText(const StyledText &other) { cbindgen_private::slint_styled_text_clone(this, &other); }\n\n /// Assigns \\a other to this styled text and returns a reference to this styled text.\n StyledText &operator=(const StyledText &other)\n {\n cbindgen_private::slint_styled_text_drop(this);\n cbindgen_private::slint_styled_text_clone(this, &other);\n return *this;\n }\n\n /// Move-assigns \\a other to this StyledText instance.\n StyledText &operator=(StyledText &&other)\n {\n std::swap(inner, other.inner);\n return *this;\n }\n\n /// Returns true if \\a a is equal to \\a b; otherwise returns false.\n friend bool operator==(const StyledText &a, const StyledText &b)\n {\n return cbindgen_private::slint_styled_text_eq(&a, &b);\n }\n\nprivate:\n // Ensure that the alignment (8 bytes) is the same as the Rust struct.\n void *inner alignas(8);\n};\n\ntemplate\ninline cbindgen_private::Slice make_slice(const T *ptr, size_t len)\n{\n return cbindgen_private::Slice {\n // Rust uses a NonNull, so even empty slices shouldn't use nullptr\n .ptr = ptr ? const_cast(ptr) : reinterpret_cast(sizeof(T)),\n .len = len,\n };\n}\n\ntemplate\ninline cbindgen_private::Slice> make_slice(std::span span)\n{\n return make_slice(span.data(), span.size());\n}\n\ninline cbindgen_private::Slice string_to_slice(std::string_view str)\n{\n return make_slice(reinterpret_cast(str.data()), str.size());\n}\n\ninline std::string_view slice_to_string_view(cbindgen_private::Slice str)\n{\n return std::string_view(reinterpret_cast(str.ptr), str.len);\n}\n\n}\n}\n" }, { "path": "api/cpp/include/slint_tests_helpers.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n#include \"slint-testing.h\"\n#include \n\n// this file contains function useful for internal testing\n\nnamespace slint::private_api::testing {\n\ninline void mock_elapsed_time(int64_t time_in_ms)\n{\n cbindgen_private::slint_mock_elapsed_time(time_in_ms);\n}\n\ninline uint64_t get_mocked_time()\n{\n return cbindgen_private::slint_get_mocked_time();\n}\n\ntemplate\ninline void send_mouse_click(const Component *component, float x, float y)\n{\n cbindgen_private::slint_send_mouse_click(x, y, &component->window().window_handle());\n}\n\ntemplate\ninline void send_keyboard_key_text(const Component *component, const slint::SharedString &text,\n bool pressed)\n{\n cbindgen_private::slint_send_keyboard_key_text(&text, pressed,\n &component->window().window_handle());\n}\n\ntemplate\ninline void send_keyboard_char(const Component *component, const slint::SharedString &str,\n bool pressed)\n{\n cbindgen_private::slint_send_keyboard_char(&str, pressed, &component->window().window_handle());\n}\n\ntemplate\ninline void send_key_combo(const Component *component, std::vector keys)\n{\n for (const auto &key : keys) {\n send_keyboard_key_text(component, key, true);\n }\n std::reverse(std::begin(keys), std::end(keys));\n for (const auto &key : keys) {\n send_keyboard_key_text(component, key, false);\n }\n}\n\ntemplate\ninline void send_keyboard_string_sequence(const Component *component,\n const slint::SharedString &str)\n{\n cbindgen_private::send_keyboard_string_sequence(&str, &component->window().window_handle());\n}\n\n#define assert_eq(A, B) \\\n slint::private_api::testing::assert_eq_impl(A, B, #A, #B, __FILE__, __LINE__)\n\ntemplate B>\nvoid assert_eq_impl(const A &a, const B &b, const char *a_str, const char *b_str, const char *file,\n int line)\n{\n bool nok = true;\n if constexpr (std::is_integral_v && std::is_integral_v) {\n // Do a cast to the common type to avoid warning about signed vs. unsigned compare\n using T = std::common_type_t;\n nok = T(a) != T(b);\n } else if constexpr (std::is_floating_point_v && std::is_floating_point_v) {\n const double dEpsilon = 0.000001; // or some other small number\n nok = fabs(a - b) > dEpsilon * fabs(a);\n } else {\n nok = a != b;\n }\n if (nok) {\n std::cerr << file << \":\" << line << \": assert_eq FAILED!\\n\"\n << a_str << \": \" << a << \"\\n\"\n << b_str << \": \" << b << std::endl;\n std::abort();\n }\n}\n\n} // namespace slint\n" }, { "path": "api/cpp/include/slint_timer.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n// cSpell: ignore singleshot\n\n#pragma once\n\n#include \n#include \n\n#ifndef SLINT_FEATURE_FREESTANDING\n# include \n# include \n#endif\n\nnamespace slint {\n\nnamespace private_api {\n/// Internal function that checks that the API that must be called from the main\n/// thread is indeed called from the main thread, or abort the program otherwise\n///\n/// Most API should be called from the main thread. When using thread one must\n/// use slint::invoke_from_event_loop\ninline void assert_main_thread()\n{\n#ifndef SLINT_FEATURE_FREESTANDING\n# ifndef NDEBUG\n static auto main_thread_id = std::this_thread::get_id();\n if (main_thread_id != std::this_thread::get_id()) {\n std::cerr << \"A function that should be only called from the main thread was called from a \"\n \"thread.\"\n << std::endl;\n std::cerr << \"Most API should be called from the main thread. When using thread one must \"\n \"use slint::invoke_from_event_loop.\"\n << std::endl;\n std::abort();\n }\n# endif\n#endif\n}\n} // namespace private_api\n\nusing cbindgen_private::TimerMode;\n\n/// A Timer that can call a callback at repeated interval\n///\n/// Use the static single_shot function to make a single shot timer\nstruct Timer\n{\n /// Construct a null timer. Use the start() method to activate the timer with a mode, interval\n /// and callback.\n Timer() = default;\n /// Construct a timer which will repeat the callback every `interval` milliseconds until\n /// the destructor of the timer is called.\n ///\n /// This is a convenience function and equivalent to calling\n /// `start(slint::TimerMode::Repeated, interval, callback);` on a default constructed Timer.\n template\n Timer(std::chrono::milliseconds interval, F callback)\n : id(cbindgen_private::slint_timer_start(\n 0, TimerMode::Repeated, interval.count(),\n [](void *data) { (*reinterpret_cast(data))(); }, new F(std::move(callback)),\n [](void *data) { delete reinterpret_cast(data); }))\n {\n private_api::assert_main_thread();\n }\n Timer(const Timer &) = delete;\n Timer &operator=(const Timer &) = delete;\n ~Timer()\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_timer_destroy(id);\n }\n\n /// Starts the timer with the given \\a mode and \\a interval, in order for the \\a callback to\n /// called when the timer fires. If the timer has been started previously and not fired yet,\n /// then it will be restarted.\n template\n void start(TimerMode mode, std::chrono::milliseconds interval, F callback)\n {\n private_api::assert_main_thread();\n id = cbindgen_private::slint_timer_start(\n id, mode, interval.count(), [](void *data) { (*reinterpret_cast(data))(); },\n new F(std::move(callback)), [](void *data) { delete reinterpret_cast(data); });\n }\n /// Stops the previously started timer. Does nothing if the timer has never been started. A\n /// stopped timer cannot be restarted with restart(). Use start() instead.\n void stop()\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_timer_stop(id);\n }\n /// Restarts the timer. If the timer was previously started by calling [`Self::start()`]\n /// with a duration and callback, then the time when the callback will be next invoked\n /// is re-calculated to be in the specified duration relative to when this function is called.\n ///\n /// Does nothing if the timer was never started.\n void restart()\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_timer_restart(id);\n }\n /// Returns true if the timer is running; false otherwise.\n bool running() const\n {\n private_api::assert_main_thread();\n return cbindgen_private::slint_timer_running(id);\n }\n /// Returns the interval of the timer.\n /// Returns 0 if the timer was never started.\n std::chrono::milliseconds interval() const\n {\n private_api::assert_main_thread();\n return std::chrono::milliseconds(cbindgen_private::slint_timer_interval(id));\n }\n\n /// Call the callback after the given duration.\n template\n static void single_shot(std::chrono::milliseconds duration, F callback)\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_timer_singleshot(\n duration.count(), [](void *data) { (*reinterpret_cast(data))(); },\n new F(std::move(callback)), [](void *data) { delete reinterpret_cast(data); });\n }\n\nprivate:\n uint64_t id = 0;\n};\n\n} // namespace slint\n" }, { "path": "api/cpp/include/slint_window.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \"slint_internal.h\"\n\n#if (!defined(__APPLE__) && !defined(_WIN32) && !defined(_WIN64) \\\n && !defined(SLINT_FEATURE_FREESTANDING)) \\\n || defined(DOXYGEN)\n\nstruct wl_surface;\nstruct wl_display;\n\n#endif\n#if (defined(__APPLE__) && !defined(_WIN32) && !defined(_WIN64) \\\n && !defined(SLINT_FEATURE_FREESTANDING)) \\\n || defined(DOXYGEN)\n\n# ifdef __OBJC__\n@class NSView;\n# else\ntypedef struct objc_object NSView;\n# endif\n\n#endif\n#if (!defined(__APPLE__) && (defined(_WIN32) || defined(_WIN64)) \\\n && !defined(SLINT_FEATURE_FREESTANDING)) \\\n || defined(DOXYGEN)\n\nclass HINSTANCE__;\ntypedef HINSTANCE__ *HINSTANCE;\n\nclass HWND__;\ntypedef HWND__ *HWND;\n\n#endif\n\nnamespace slint {\n#if !defined(DOXYGEN)\nnamespace platform {\nclass SkiaRenderer;\nclass SoftwareRenderer;\n}\n#endif\n\nnamespace private_api {\nusing ItemTreeRc = vtable::VRc;\nusing slint::LogicalPosition;\n\n/// Looking forward for C++23 std::optional::transform\ntemplate\nauto optional_transform(const std::optional &o, F &&f) -> decltype(std::optional(f(*o)))\n{\n if (o) {\n return std::optional(f(*o));\n }\n return std::nullopt;\n}\n\ntemplate\nvoid optional_then(const std::optional &o, F &&f)\n{\n if (o) {\n f(*o);\n }\n}\n\n/// Waiting for C++23 std::optional::and_then\ntemplate\nauto optional_and_then(const std::optional &o, F &&f) -> decltype(f(*o))\n{\n if (o) {\n return f(*o);\n }\n return std::nullopt;\n}\n\ntemplate\nT optional_or_default(const std::optional &o)\n{\n if (o) {\n return *o;\n }\n return {};\n}\n\nclass WindowAdapterRc\n{\npublic:\n explicit WindowAdapterRc(cbindgen_private::WindowAdapterRcOpaque adopted_inner)\n {\n assert_main_thread();\n cbindgen_private::slint_windowrc_clone(&adopted_inner, &inner);\n }\n WindowAdapterRc() { cbindgen_private::slint_windowrc_init(&inner); }\n ~WindowAdapterRc() { cbindgen_private::slint_windowrc_drop(&inner); }\n WindowAdapterRc(const WindowAdapterRc &other) : WindowAdapterRc(other.inner) { }\n WindowAdapterRc(WindowAdapterRc &&) = delete;\n WindowAdapterRc &operator=(WindowAdapterRc &&) = delete;\n WindowAdapterRc &operator=(const WindowAdapterRc &other)\n {\n assert_main_thread();\n if (this != &other) {\n cbindgen_private::slint_windowrc_drop(&inner);\n cbindgen_private::slint_windowrc_clone(&other.inner, &inner);\n }\n return *this;\n }\n\n void show() const { slint_windowrc_show(&inner); }\n void hide() const { slint_windowrc_hide(&inner); }\n bool is_visible() const { return slint_windowrc_is_visible(&inner); }\n\n float scale_factor() const { return slint_windowrc_get_scale_factor(&inner); }\n void set_const_scale_factor(float value) const\n {\n slint_windowrc_set_const_scale_factor(&inner, value);\n }\n\n cbindgen_private::ColorScheme color_scheme() const\n {\n return slint_windowrc_color_scheme(&inner);\n }\n bool supports_native_menu_bar() const\n {\n return slint_windowrc_supports_native_menu_bar(&inner);\n }\n\n bool text_input_focused() const { return slint_windowrc_get_text_input_focused(&inner); }\n void set_text_input_focused(bool value) const\n {\n slint_windowrc_set_text_input_focused(&inner, value);\n }\n\n template\n void unregister_item_tree(Component *c, ItemArray items) const\n {\n cbindgen_private::slint_unregister_item_tree(\n vtable::VRef { &Component::static_vtable, c },\n items, &inner);\n }\n\n void set_focus_item(const ItemTreeRc &component_rc, uint32_t item_index, bool set_focus,\n cbindgen_private::FocusReason reason)\n {\n cbindgen_private::ItemRc item_rc { component_rc, item_index };\n cbindgen_private::slint_windowrc_set_focus_item(&inner, &item_rc, set_focus, reason);\n }\n\n void set_component(const cbindgen_private::ItemTreeWeak &weak) const\n {\n auto item_tree_rc = (*weak.lock()).into_dyn();\n slint_windowrc_set_component(&inner, &item_tree_rc);\n }\n\n template\n uint32_t show_popup(const Parent *parent_component, PosGetter pos,\n cbindgen_private::PopupClosePolicy close_policy,\n cbindgen_private::ItemRc parent_item) const\n {\n auto popup = Component::create(parent_component);\n auto p = pos(popup);\n auto popup_dyn = popup.into_dyn();\n auto id = cbindgen_private::slint_windowrc_show_popup(&inner, &popup_dyn, p, close_policy,\n &parent_item, false);\n popup->user_init();\n return id;\n }\n\n void close_popup(uint32_t popup_id) const\n {\n if (popup_id > 0) {\n cbindgen_private::slint_windowrc_close_popup(&inner, popup_id);\n }\n }\n\n template\n uint32_t show_popup_menu(\n SharedGlobals *globals, LogicalPosition pos, cbindgen_private::ItemRc context_menu_rc,\n InitFn init,\n std::optional> menu = std::nullopt) const\n {\n if (menu) {\n if (cbindgen_private::slint_windowrc_show_native_popup_menu(&inner, &menu.value(), pos,\n &context_menu_rc)) {\n return 0;\n }\n }\n\n auto popup = Component::create(globals);\n init(&*popup);\n auto popup_dyn = popup.into_dyn();\n auto id = cbindgen_private::slint_windowrc_show_popup(\n &inner, &popup_dyn, pos, cbindgen_private::PopupClosePolicy::CloseOnClickOutside,\n &context_menu_rc, true);\n popup->user_init();\n return id;\n }\n\n template F>\n std::optional set_rendering_notifier(F callback) const\n {\n auto actual_cb = [](RenderingState state, GraphicsAPI graphics_api, void *data) {\n (*reinterpret_cast(data))(state, graphics_api);\n };\n SetRenderingNotifierError err;\n if (cbindgen_private::slint_windowrc_set_rendering_notifier(\n &inner, actual_cb,\n [](void *user_data) { delete reinterpret_cast(user_data); },\n new F(std::move(callback)), &err)) {\n return {};\n } else {\n return err;\n }\n }\n\n // clang-format off\n template\n requires(std::is_convertible_v, CloseRequestResponse>)\n void on_close_requested(F callback) const\n // clang-format on\n {\n auto actual_cb = [](void *data) { return (*reinterpret_cast(data))(); };\n cbindgen_private::slint_windowrc_on_close_requested(\n &inner, actual_cb, [](void *user_data) { delete reinterpret_cast(user_data); },\n new F(std::move(callback)));\n }\n\n void request_redraw() const { cbindgen_private::slint_windowrc_request_redraw(&inner); }\n\n slint::PhysicalPosition position() const\n {\n slint::PhysicalPosition pos;\n cbindgen_private::slint_windowrc_position(&inner, &pos);\n return pos;\n }\n\n void set_logical_position(const slint::LogicalPosition &pos)\n {\n cbindgen_private::slint_windowrc_set_logical_position(&inner, &pos);\n }\n\n void set_physical_position(const slint::PhysicalPosition &pos)\n {\n cbindgen_private::slint_windowrc_set_physical_position(&inner, &pos);\n }\n\n slint::PhysicalSize size() const\n {\n return slint::PhysicalSize(cbindgen_private::slint_windowrc_size(&inner));\n }\n\n void set_logical_size(const slint::LogicalSize &size)\n {\n cbindgen_private::slint_windowrc_set_logical_size(&inner, &size);\n }\n\n void set_physical_size(const slint::PhysicalSize &size)\n {\n cbindgen_private::slint_windowrc_set_physical_size(&inner, &size);\n }\n\n /// Send a pointer event to this window\n void dispatch_pointer_event(const cbindgen_private::MouseEvent &event)\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_windowrc_dispatch_pointer_event(&inner, &event);\n }\n\n /// Registers a font by the specified path. The path must refer to an existing\n /// TrueType font.\n /// \\returns an empty optional on success, otherwise an error string\n inline std::optional register_font_from_path(const SharedString &path)\n {\n SharedString maybe_err;\n cbindgen_private::slint_register_font_from_path(&inner, &path, &maybe_err);\n if (!maybe_err.empty()) {\n return maybe_err;\n } else {\n return {};\n }\n }\n\n /// Registers a font by the data. The data must be valid TrueType font data.\n /// \\returns an empty optional on success, otherwise an error string\n inline std::optional register_font_from_data(const uint8_t *data, std::size_t len)\n {\n SharedString maybe_err;\n cbindgen_private::slint_register_font_from_data(&inner, make_slice(data, len), &maybe_err);\n if (!maybe_err.empty()) {\n return maybe_err;\n } else {\n return {};\n }\n }\n\n /// Registers a bitmap font for use with the software renderer.\n inline void register_bitmap_font(const cbindgen_private::BitmapFont &font)\n {\n cbindgen_private::slint_register_bitmap_font(&inner, &font);\n }\n\n /// \\private\n const cbindgen_private::WindowAdapterRcOpaque &handle() const { return inner; }\n\nprivate:\n friend class slint::platform::SkiaRenderer;\n friend class slint::platform::SoftwareRenderer;\n cbindgen_private::WindowAdapterRcOpaque inner;\n};\n\n}\n\n/// This class represents a window towards the windowing system, that's used to render the\n/// scene of a component. It provides API to control windowing system specific aspects such\n/// as the position on the screen.\nclass Window\n{\npublic:\n /// \\private\n /// Internal function used by the generated code to construct a new instance of this\n /// public API wrapper.\n explicit Window(const private_api::WindowAdapterRc &windowrc) : inner(windowrc) { }\n Window(const Window &other) = delete;\n Window &operator=(const Window &other) = delete;\n Window(Window &&other) = delete;\n Window &operator=(Window &&other) = delete;\n /// Destroys this window. Window instances are explicitly shared and reference counted.\n /// If this window instance is the last one referencing the window towards the windowing\n /// system, then it will also become hidden and destroyed.\n ~Window() = default;\n\n /// Shows the window on the screen. An additional strong reference on the\n /// associated component is maintained while the window is visible.\n ///\n /// Call hide() to make the window invisible again, and drop the additional\n /// strong reference.\n void show()\n {\n private_api::assert_main_thread();\n inner.show();\n }\n /// Hides the window, so that it is not visible anymore. The additional strong\n /// reference on the associated component, that was created when show() was called, is\n /// dropped.\n void hide()\n {\n private_api::assert_main_thread();\n inner.hide();\n }\n\n /// Returns the visibility state of the window. This function can return false even if you\n /// previously called show() on it, for example if the user minimized the window.\n bool is_visible() const\n {\n private_api::assert_main_thread();\n return inner.is_visible();\n }\n\n /// This function allows registering a callback that's invoked during the different phases of\n /// rendering. This allows custom rendering on top or below of the scene.\n ///\n /// The provided callback must be callable with a slint::RenderingState and the\n /// slint::GraphicsAPI argument.\n ///\n /// On success, the function returns a std::optional without value. On error, the function\n /// returns the error code as value in the std::optional.\n template F>\n std::optional set_rendering_notifier(F &&callback) const\n {\n private_api::assert_main_thread();\n return inner.set_rendering_notifier(std::forward(callback));\n }\n\n /// This function allows registering a callback that's invoked when the user tries to close\n /// a window.\n /// The callback has to return a CloseRequestResponse.\n // clang-format off\n template\n requires(std::is_convertible_v, CloseRequestResponse>)\n void on_close_requested(F &&callback) const\n // clang-format on\n {\n private_api::assert_main_thread();\n return inner.on_close_requested(std::forward(callback));\n }\n\n /// This function issues a request to the windowing system to redraw the contents of the window.\n void request_redraw() const\n {\n private_api::assert_main_thread();\n inner.request_redraw();\n }\n\n /// Returns the position of the window on the screen, in physical screen coordinates and\n /// including a window frame (if present).\n slint::PhysicalPosition position() const\n {\n private_api::assert_main_thread();\n return inner.position();\n }\n\n /// Sets the position of the window on the screen, in physical screen coordinates and including\n /// a window frame (if present).\n /// Note that on some windowing systems, such as Wayland, this functionality is not available.\n void set_position(const slint::LogicalPosition &pos)\n {\n private_api::assert_main_thread();\n inner.set_logical_position(pos);\n }\n /// Sets the position of the window on the screen, in physical screen coordinates and including\n /// a window frame (if present).\n /// Note that on some windowing systems, such as Wayland, this functionality is not available.\n void set_position(const slint::PhysicalPosition &pos)\n {\n private_api::assert_main_thread();\n inner.set_physical_position(pos);\n }\n\n /// Returns the size of the window on the screen, in physical screen coordinates and excluding\n /// a window frame (if present).\n slint::PhysicalSize size() const\n {\n private_api::assert_main_thread();\n return inner.size();\n }\n\n /// Resizes the window to the specified size on the screen, in logical pixels and excluding\n /// a window frame (if present).\n void set_size(const slint::LogicalSize &size)\n {\n private_api::assert_main_thread();\n inner.set_logical_size(size);\n }\n /// Resizes the window to the specified size on the screen, in physical pixels and excluding\n /// a window frame (if present).\n void set_size(const slint::PhysicalSize &size)\n {\n private_api::assert_main_thread();\n inner.set_physical_size(size);\n }\n\n /// This function returns the scale factor that allows converting between logical and\n /// physical pixels.\n float scale_factor() const\n {\n private_api::assert_main_thread();\n return inner.scale_factor();\n }\n\n /// Returns if the window is currently fullscreen\n bool is_fullscreen() const\n {\n private_api::assert_main_thread();\n return cbindgen_private::slint_windowrc_is_fullscreen(&inner.handle());\n }\n /// Set or unset the window to display fullscreen.\n void set_fullscreen(bool fullscreen)\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_windowrc_set_fullscreen(&inner.handle(), fullscreen);\n }\n\n /// Returns if the window is currently maximized\n bool is_maximized() const\n {\n private_api::assert_main_thread();\n return cbindgen_private::slint_windowrc_is_maximized(&inner.handle());\n }\n /// Maximize or unmaximize the window.\n void set_maximized(bool maximized)\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_windowrc_set_maximized(&inner.handle(), maximized);\n }\n\n /// Returns if the window is currently minimized\n bool is_minimized() const\n {\n private_api::assert_main_thread();\n return cbindgen_private::slint_windowrc_is_minimized(&inner.handle());\n }\n /// Minimize or unminimze the window.\n void set_minimized(bool minimized)\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_windowrc_set_minimized(&inner.handle(), minimized);\n }\n\n /// Dispatch a key press event to the scene.\n ///\n /// Use this when you're implementing your own backend and want to forward user input events.\n ///\n /// The \\a text is the unicode representation of the key.\n void dispatch_key_press_event(const SharedString &text)\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_windowrc_dispatch_key_event(\n &inner.handle(), cbindgen_private::KeyEventType::KeyPressed, &text, false);\n }\n\n /// Dispatch an auto-repeated key press event to the scene.\n ///\n /// Use this when you're implementing your own backend and want to forward user input events.\n ///\n /// The \\a text is the unicode representation of the key.\n void dispatch_key_press_repeat_event(const SharedString &text)\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_windowrc_dispatch_key_event(\n &inner.handle(), cbindgen_private::KeyEventType::KeyPressed, &text, true);\n }\n\n /// Dispatch a key release event to the scene.\n ///\n /// Use this when you're implementing your own backend and want to forward user input events.\n ///\n /// The \\a text is the unicode representation of the key.\n void dispatch_key_release_event(const SharedString &text)\n {\n private_api::assert_main_thread();\n cbindgen_private::slint_windowrc_dispatch_key_event(\n &inner.handle(), cbindgen_private::KeyEventType::KeyReleased, &text, false);\n }\n\n /// Dispatches a pointer or mouse press event to the scene.\n ///\n /// Use this function when you're implementing your own backend and want to forward user\n /// pointer/mouse events.\n ///\n /// \\a pos represents the logical position of the pointer relative to the window.\n /// \\a button is the button that was pressed.\n void dispatch_pointer_press_event(LogicalPosition pos, PointerEventButton button)\n {\n private_api::assert_main_thread();\n inner.dispatch_pointer_event(\n slint::cbindgen_private::MouseEvent::Pressed({ pos.x, pos.y }, button, 0, false));\n }\n /// Dispatches a pointer or mouse release event to the scene.\n ///\n /// Use this function when you're implementing your own backend and want to forward user\n /// pointer/mouse events.\n ///\n /// \\a pos represents the logical position of the pointer relative to the window.\n /// \\a button is the button that was released.\n void dispatch_pointer_release_event(LogicalPosition pos, PointerEventButton button)\n {\n private_api::assert_main_thread();\n inner.dispatch_pointer_event(\n slint::cbindgen_private::MouseEvent::Released({ pos.x, pos.y }, button, 0, false));\n }\n /// Dispatches a pointer exit event to the scene.\n ///\n /// Use this function when you're implementing your own backend and want to forward user\n /// pointer/mouse events.\n ///\n /// This event is triggered when the pointer exits the window.\n void dispatch_pointer_exit_event()\n {\n private_api::assert_main_thread();\n inner.dispatch_pointer_event(slint::cbindgen_private::MouseEvent::Exit());\n }\n\n /// Dispatches a pointer move event to the scene.\n ///\n /// Use this function when you're implementing your own backend and want to forward user\n /// pointer/mouse events.\n ///\n /// \\a pos represents the logical position of the pointer relative to the window.\n void dispatch_pointer_move_event(LogicalPosition pos)\n {\n private_api::assert_main_thread();\n inner.dispatch_pointer_event(\n slint::cbindgen_private::MouseEvent::Moved({ pos.x, pos.y }, false));\n }\n\n /// Dispatches a scroll (or wheel) event to the scene.\n ///\n /// Use this function when you're implementing your own backend and want to forward user wheel\n /// events.\n ///\n /// \\a parameter represents the logical position of the pointer relative to the window.\n /// \\a delta_x and \\a delta_y represent the scroll delta values in the X and Y\n /// directions in logical pixels.\n void dispatch_pointer_scroll_event(LogicalPosition pos, float delta_x, float delta_y)\n {\n private_api::assert_main_thread();\n inner.dispatch_pointer_event(\n slint::cbindgen_private::MouseEvent::Wheel({ pos.x, pos.y }, delta_x, delta_y));\n }\n\n /// Set the logical size of this window after a resize event\n ///\n /// The backend must send this event to ensure that the `width` and `height` property of the\n /// root Window element are properly set.\n void dispatch_resize_event(slint::LogicalSize s)\n {\n private_api::assert_main_thread();\n using slint::cbindgen_private::WindowEvent;\n WindowEvent event { .resized =\n WindowEvent::Resized_Body { .tag = WindowEvent::Tag::Resized,\n .size = { s.width, s.height } } };\n cbindgen_private::slint_windowrc_dispatch_event(&inner.handle(), &event);\n }\n\n /// The window's scale factor has changed. This can happen for example when the display's\n /// resolution changes, the user selects a new scale factor in the system settings, or the\n /// window is moved to a different screen. Platform implementations should dispatch this event\n /// also right after the initial window creation, to set the initial scale factor the windowing\n /// system provided for the window.\n void dispatch_scale_factor_change_event(float factor)\n {\n private_api::assert_main_thread();\n using slint::cbindgen_private::WindowEvent;\n WindowEvent event { .scale_factor_changed = WindowEvent::ScaleFactorChanged_Body {\n .tag = WindowEvent::Tag::ScaleFactorChanged,\n .scale_factor = factor } };\n cbindgen_private::slint_windowrc_dispatch_event(&inner.handle(), &event);\n }\n\n /// The Window was activated or de-activated.\n ///\n /// The backend should dispatch this event with true when the window gains focus\n /// and false when the window loses focus.\n void dispatch_window_active_changed_event(bool active)\n {\n private_api::assert_main_thread();\n using slint::cbindgen_private::WindowEvent;\n WindowEvent event { .window_active_changed = WindowEvent::WindowActiveChanged_Body {\n .tag = WindowEvent::Tag::WindowActiveChanged, ._0 = active } };\n cbindgen_private::slint_windowrc_dispatch_event(&inner.handle(), &event);\n }\n\n /// The user requested to close the window.\n ///\n /// The backend should send this event when the user tries to close the window,for example by\n /// pressing the close button.\n ///\n /// This will have the effect of invoking the callback set in Window::on_close_requested() and\n /// then hiding the window depending on the return value of the callback.\n void dispatch_close_requested_event()\n {\n private_api::assert_main_thread();\n using slint::cbindgen_private::WindowEvent;\n WindowEvent event { .tag = WindowEvent::Tag::CloseRequested };\n cbindgen_private::slint_windowrc_dispatch_event(&inner.handle(), &event);\n }\n\n /// Returns true if there is an animation currently active on any property in the Window.\n bool has_active_animations() const\n {\n private_api::assert_main_thread();\n return cbindgen_private::slint_windowrc_has_active_animations(&inner.handle());\n }\n\n /// Takes a snapshot of the window contents and returns it as RGBA8 encoded pixel buffer.\n ///\n /// Note that this function may be slow to call as it may need to re-render the scene.\n std::optional> take_snapshot() const\n {\n SharedPixelBuffer result;\n if (cbindgen_private::slint_windowrc_take_snapshot(&inner.handle(), &result.m_data,\n &result.m_width, &result.m_height)) {\n return result;\n } else {\n return {};\n }\n }\n\n#if (!defined(__APPLE__) && !defined(_WIN32) && !defined(_WIN64) \\\n && !defined(SLINT_FEATURE_FREESTANDING)) \\\n || defined(DOXYGEN)\n\n /// Returns the wl_surface for this window.\n ///\n /// If the underlying window handle hasn't been created yet or isn't applicable for the\n /// platform, this will return nullptr.\n wl_surface *wayland_surface() const\n {\n return static_cast(\n cbindgen_private::slint_windowrc_wlsurface_wayland(&inner.handle()));\n }\n\n /// Returns the wl_display for this window.\n ///\n /// If the underlying window handle hasn't been created yet or isn't applicable for the\n /// platform, this will return nullptr.\n wl_display *wayland_display() const\n {\n return static_cast(\n cbindgen_private::slint_windowrc_wldisplay_wayland(&inner.handle()));\n }\n\n#endif\n#if (defined(__APPLE__) && !defined(_WIN32) && !defined(_WIN64) \\\n && !defined(SLINT_FEATURE_FREESTANDING)) \\\n || defined(DOXYGEN)\n\n /// Returns the NSView for this window.\n ///\n /// If the underlying window handle hasn't been created yet or isn't applicable for the\n /// platform, this will return nullptr.\n NSView *appkit_view() const\n {\n return static_cast(\n cbindgen_private::slint_windowrc_nsview_appkit(&inner.handle()));\n }\n\n#endif\n#if (!defined(__APPLE__) && (defined(_WIN32) || defined(_WIN64)) \\\n && !defined(SLINT_FEATURE_FREESTANDING)) \\\n || defined(DOXYGEN)\n\n /// Returns the HINSTANCE for this window.\n ///\n /// If the underlying window handle hasn't been created yet or isn't applicable for the\n /// platform, this will return nullptr.\n HWND win32_hwnd() const\n {\n return static_cast(cbindgen_private::slint_windowrc_hwnd_win32(&inner.handle()));\n }\n\n /// Returns the HINSTANCE for this window.\n ///\n /// If the underlying window handle hasn't been created yet or isn't applicable for the\n /// platform, this will return nullptr.\n HINSTANCE win32_hinstance() const\n {\n return static_cast(\n cbindgen_private::slint_windowrc_hinstance_win32(&inner.handle()));\n }\n\n#endif\n\n /// \\private\n private_api::WindowAdapterRc &window_handle() { return inner; }\n /// \\private\n const private_api::WindowAdapterRc &window_handle() const { return inner; }\n\nprivate:\n private_api::WindowAdapterRc inner;\n};\n\n}\n" }, { "path": "api/cpp/include/vtable.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\n#include \n#include \n#include \n#include \n#include \n\n#ifdef __APPLE__\n# include \n#endif\n\n#if defined(__GNUC__) || defined(__clang__)\n// In C++17, it is conditionally supported, but still valid for all compiler we care\n# pragma GCC diagnostic ignored \"-Winvalid-offsetof\"\n#endif\n\nnamespace vtable {\n\ntemplate\nstruct VRefMut\n{\n const T *vtable;\n void *instance;\n};\n\nstruct Layout\n{\n std::size_t size;\n std::size_t align;\n};\n\n// For the C++'s purpose, they are all the same\ntemplate\nusing VRef = VRefMut;\n\ntemplate\nusing Pin = T;\n\ntemplate\nstruct VBox\n{\n const T *vtable = nullptr;\n void *instance = nullptr;\n explicit VBox(const T *vtable, void *instance) : vtable(vtable), instance(instance) { }\n VBox(const VBox &) = delete;\n VBox() = default;\n VBox &operator=(const VBox &) = delete;\n ~VBox()\n {\n if (vtable && instance) {\n vtable->drop({ vtable, instance });\n }\n }\n};\n\nstruct AllowPin;\n\ntemplate\nstruct VOffset\n{\n const T *vtable;\n std::uintptr_t offset;\n};\n\ntemplate\nstruct VRcInner\n{\n template\n friend class VRc;\n template\n friend class VWeak;\n\nprivate:\n VRcInner() : layout {} { }\n const VTable *vtable = &X::static_vtable;\n std::atomic strong_ref = 1;\n std::atomic weak_ref = 1;\n std::uint16_t data_offset = offsetof(VRcInner, data);\n union {\n X data;\n Layout layout;\n };\n\n void *data_ptr() { return reinterpret_cast(this) + data_offset; }\n ~VRcInner() = delete;\n};\n\nstruct Dyn\n{\n};\n\ntemplate\nclass VRc\n{\n VRcInner *inner;\n VRc(VRcInner *inner) : inner(inner) { }\n template\n friend class VWeak;\n\npublic:\n ~VRc()\n {\n if (!--inner->strong_ref) {\n Layout layout = inner->vtable->drop_in_place({ inner->vtable, &inner->data });\n layout.size = std::max(layout.size, sizeof(Layout)); // because of the union\n layout.size += inner->data_offset;\n layout.align = std::max(layout.align, alignof(VRcInner));\n inner->layout = layout;\n if (!--inner->weak_ref) {\n inner->vtable->dealloc(inner->vtable, reinterpret_cast(inner), layout);\n }\n }\n }\n VRc(const VRc &other) : inner(other.inner) { inner->strong_ref++; }\n VRc &operator=(const VRc &other)\n {\n if (inner == other.inner)\n return *this;\n this->~VRc();\n new (this) VRc(other);\n return *this;\n }\n /// Construct a new VRc holding an X.\n ///\n /// The type X must have a static member `static_vtable` of type VTable\n template\n static VRc make(Args... args)\n {\n#if !defined(__APPLE__) || MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_14\n auto mem = ::operator new(sizeof(VRcInner),\n static_cast(alignof(VRcInner)));\n#else\n auto mem = ::operator new(sizeof(VRcInner));\n#endif\n auto inner = new (mem) VRcInner;\n new (&inner->data) X(args...);\n return VRc(inner);\n }\n\n const X *operator->() const { return &inner->data; }\n const X &operator*() const { return inner->data; }\n X *operator->() { return &inner->data; }\n X &operator*() { return inner->data; }\n\n const VRc &into_dyn() const\n {\n return *reinterpret_cast *>(this);\n }\n\n VRef borrow() const { return { inner->vtable, inner->data_ptr() }; }\n\n friend bool operator==(const VRc &a, const VRc &b) { return a.inner == b.inner; }\n friend bool operator!=(const VRc &a, const VRc &b) { return a.inner != b.inner; }\n const VTable *vtable() const { return inner->vtable; }\n};\n\ntemplate\nclass VWeak\n{\n VRcInner *inner = nullptr;\n\npublic:\n VWeak() = default;\n ~VWeak()\n {\n if (inner && !--inner->weak_ref) {\n inner->vtable->dealloc(inner->vtable, reinterpret_cast(inner),\n inner->layout);\n }\n }\n VWeak(const VWeak &other) : inner(other.inner) { inner && inner->weak_ref++; }\n VWeak(const VRc &other) : inner(other.inner) { inner && inner->weak_ref++; }\n VWeak &operator=(const VWeak &other)\n {\n if (inner == other.inner)\n return *this;\n this->~VWeak();\n new (this) VWeak(other);\n return *this;\n }\n\n std::optional> lock() const\n {\n if (!inner || inner->strong_ref == 0)\n return {};\n inner->strong_ref++;\n return { VRc(inner) };\n }\n\n const VWeak &into_dyn() const\n {\n return *reinterpret_cast *>(this);\n }\n\n friend bool operator==(const VWeak &a, const VWeak &b) { return a.inner == b.inner; }\n friend bool operator!=(const VWeak &a, const VWeak &b) { return a.inner != b.inner; }\n const VTable *vtable() const { return inner ? inner->vtable : nullptr; }\n};\n\ntemplate\nclass VRcMapped\n{\n VRc parent_strong;\n MappedType *object;\n\n template\n friend class VWeakMapped;\n\npublic:\n /// Constructs a pointer to MappedType that shares ownership with parent_strong.\n template\n explicit VRcMapped(VRc parent_strong, MappedType *object)\n : parent_strong(parent_strong.into_dyn()), object(object)\n {\n }\n\n const MappedType *operator->() const { return object; }\n const MappedType &operator*() const { return *object; }\n MappedType *operator->() { return object; }\n MappedType &operator*() { return *object; }\n};\n\ntemplate\nclass VWeakMapped\n{\n VWeak parent_weak;\n MappedType *object = nullptr;\n\npublic:\n VWeakMapped(const VRcMapped &strong)\n : parent_weak(strong.parent_strong), object(strong.object)\n {\n }\n VWeakMapped() = default;\n\n std::optional> lock() const\n {\n if (auto parent = parent_weak.lock()) {\n return VRcMapped(std::move(*parent), object);\n } else {\n return {};\n }\n }\n};\n\ntemplate\ninline void dealloc(const VTable *, uint8_t *ptr, [[maybe_unused]] Layout layout)\n{\n#ifdef __cpp_sized_deallocation\n ::operator delete(reinterpret_cast(ptr), layout.size,\n static_cast(layout.align));\n#elif !defined(__APPLE__) || MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_14\n ::operator delete(reinterpret_cast(ptr), static_cast(layout.align));\n#else\n ::operator delete(reinterpret_cast(ptr));\n#endif\n}\n\ntemplate\ninline Layout drop_in_place(VRefMut item_tree)\n{\n reinterpret_cast(item_tree.instance)->~T();\n return vtable::Layout { sizeof(T), alignof(T) };\n}\n\n} // namespace vtable\n" }, { "path": "api/cpp/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n/*! This crate just exposes the function used by the C++ integration */\n\n#![no_std]\nextern crate alloc;\n#[cfg(feature = \"std\")]\nextern crate std;\n\nuse alloc::rc::Rc;\nuse alloc::string::ToString;\nuse core::ffi::c_void;\nuse i_slint_core::SharedString;\nuse i_slint_core::items::OperatingSystemType;\nuse i_slint_core::slice::Slice;\nuse i_slint_core::styled_text::StyledText;\nuse i_slint_core::window::{WindowAdapter, ffi::WindowAdapterRcOpaque};\n\npub mod platform;\n\n#[cfg(feature = \"i-slint-backend-selector\")]\nuse i_slint_backend_selector::with_platform;\n\n#[cfg(not(feature = \"i-slint-backend-selector\"))]\npub fn with_platform(\n f: impl FnOnce(\n &dyn i_slint_core::platform::Platform,\n ) -> Result,\n) -> Result {\n i_slint_core::with_platform(|| Err(i_slint_core::platform::PlatformError::NoPlatform), f)\n}\n\n// We need to make sure something from the crate is exported,\n// otherwise its symbols are not going to be in the final binary\n#[cfg(feature = \"testing\")]\npub use i_slint_backend_testing;\n#[cfg(feature = \"slint-interpreter\")]\npub use slint_interpreter;\n\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_windowrc_init(out: *mut WindowAdapterRcOpaque) {\n assert_eq!(\n core::mem::size_of::>(),\n core::mem::size_of::()\n );\n let win = with_platform(|b| b.create_window_adapter()).unwrap();\n unsafe {\n core::ptr::write(out as *mut Rc, win);\n }\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_ensure_backend() {\n with_platform(|_b| {\n // Nothing to do, just make sure a backend was created\n Ok(())\n })\n .unwrap()\n}\n\n#[unsafe(no_mangle)]\n/// Enters the main event loop.\npub extern \"C\" fn slint_run_event_loop(quit_on_last_window_closed: bool) {\n with_platform(|b| {\n if !quit_on_last_window_closed {\n #[allow(deprecated)]\n b.set_event_loop_quit_on_last_window_closed(false);\n }\n b.run_event_loop()\n })\n .unwrap();\n}\n\n/// Will execute the given functor in the main thread\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_post_event(\n event: extern \"C\" fn(user_data: *mut c_void),\n user_data: *mut c_void,\n drop_user_data: Option,\n) {\n struct UserData {\n user_data: *mut c_void,\n drop_user_data: Option,\n }\n impl Drop for UserData {\n fn drop(&mut self) {\n if let Some(x) = self.drop_user_data {\n x(self.user_data)\n }\n }\n }\n unsafe impl Send for UserData {}\n let ud = UserData { user_data, drop_user_data };\n\n i_slint_core::api::invoke_from_event_loop(move || {\n let ud = &ud;\n event(ud.user_data);\n })\n .unwrap();\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_quit_event_loop() {\n i_slint_core::api::quit_event_loop().unwrap();\n}\n\n#[cfg(feature = \"std\")]\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_register_font_from_path(\n win: *const WindowAdapterRcOpaque,\n path: &SharedString,\n error_str: &mut SharedString,\n) {\n let window_adapter = unsafe { &*(win as *const Rc) };\n *error_str = match window_adapter\n .renderer()\n .register_font_from_path(std::path::Path::new(path.as_str()))\n {\n Ok(()) => Default::default(),\n Err(err) => i_slint_core::string::ToSharedString::to_shared_string(&err),\n };\n}\n\n#[cfg(feature = \"std\")]\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_register_font_from_data(\n win: *const WindowAdapterRcOpaque,\n data: i_slint_core::slice::Slice<'static, u8>,\n error_str: &mut SharedString,\n) {\n let window_adapter = unsafe { &*(win as *const Rc) };\n *error_str = match window_adapter.renderer().register_font_from_memory(data.as_slice()) {\n Ok(()) => Default::default(),\n Err(err) => i_slint_core::string::ToSharedString::to_shared_string(&err),\n };\n}\n\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_register_bitmap_font(\n win: *const WindowAdapterRcOpaque,\n font_data: &'static i_slint_core::graphics::BitmapFont,\n) {\n let window_adapter = unsafe { &*(win as *const Rc) };\n window_adapter.renderer().register_bitmap_font(font_data);\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_string_to_float(string: &SharedString, value: &mut f32) -> bool {\n match string.as_str().parse::() {\n Ok(v) => {\n *value = v;\n true\n }\n Err(_) => false,\n }\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_string_character_count(string: &SharedString) -> usize {\n unicode_segmentation::UnicodeSegmentation::graphemes(string.as_str(), true).count()\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_string_to_usize(string: &SharedString, value: &mut usize) -> bool {\n match string.as_str().parse::() {\n Ok(v) => {\n *value = v;\n true\n }\n Err(_) => false,\n }\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_debug(string: &SharedString) {\n i_slint_core::debug_log!(\"{string}\");\n}\n\n#[cfg(not(feature = \"std\"))]\nmod allocator {\n use core::alloc::Layout;\n use core::ffi::c_void;\n\n struct CAlloc;\n unsafe impl core::alloc::GlobalAlloc for CAlloc {\n unsafe fn alloc(&self, layout: Layout) -> *mut u8 {\n unsafe extern \"C\" {\n pub fn malloc(size: usize) -> *mut c_void;\n }\n unsafe {\n let align = layout.align();\n if align <= core::mem::size_of::() {\n malloc(layout.size()) as *mut u8\n } else {\n // Ideally we'd use aligned_alloc, but that function caused heap corruption with esp-idf\n let ptr = malloc(layout.size() + align) as *mut u8;\n let shift = align - (ptr as usize % align);\n let ptr = ptr.add(shift);\n core::ptr::write(ptr.sub(1), shift as u8);\n ptr\n }\n }\n }\n unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout) {\n let align = layout.align();\n unsafe extern \"C\" {\n pub fn free(p: *mut c_void);\n }\n unsafe {\n if align <= core::mem::size_of::() {\n free(ptr as *mut c_void);\n } else {\n let shift = core::ptr::read(ptr.sub(1)) as usize;\n free(ptr.sub(shift) as *mut c_void);\n }\n }\n }\n }\n\n #[global_allocator]\n static ALLOCATOR: CAlloc = CAlloc;\n}\n\n#[cfg(all(not(feature = \"std\"), not(feature = \"esp-backtrace\")))]\n#[panic_handler]\nfn panic(_info: &core::panic::PanicInfo) -> ! {\n loop {}\n}\n#[cfg(feature = \"esp-backtrace\")]\nuse esp_backtrace as _;\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_set_xdg_app_id(_app_id: &SharedString) {\n #[cfg(feature = \"i-slint-backend-selector\")]\n i_slint_backend_selector::with_global_context(|ctx| ctx.set_xdg_app_id(_app_id.clone()))\n .unwrap();\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_detect_operating_system() -> OperatingSystemType {\n i_slint_core::detect_operating_system()\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_parse_markdown(\n format_string: &SharedString,\n args: Slice,\n out: &mut StyledText,\n) {\n *out = i_slint_core::styled_text::parse_markdown(format_string, &args);\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_string_to_styled_text(text: SharedString, out: &mut StyledText) {\n *out = i_slint_core::styled_text::string_to_styled_text(text.to_string());\n}\n\n// Translator API is currently considered experimental due to discussions\n// about the returned string type (SharedString vs. Cow etc.). Also it\n// is not available with no_std due to the tr crate.\n// See dicussion in https://github.com/slint-ui/slint/pull/10979.\n#[cfg(all(feature = \"experimental\", feature = \"std\"))]\nmod translator {\n use crate::SharedString;\n use crate::Slice;\n use alloc::boxed::Box;\n use core::ffi::c_void;\n use i_slint_core::translations::Translator;\n use std::borrow::Cow;\n\n type DropCallback = extern \"C\" fn(obj: *const c_void);\n\n type TranslateCallback = extern \"C\" fn(\n obj: *const c_void,\n string: Slice,\n context: Slice,\n out: &mut SharedString,\n );\n\n type NTranslateCallback = extern \"C\" fn(\n obj: *const c_void,\n n: u64,\n singular: Slice,\n plural: Slice,\n context: Slice,\n out: &mut SharedString,\n );\n\n struct CppTranslator {\n pub obj: *const c_void,\n pub drop: DropCallback,\n pub translate: TranslateCallback,\n pub ntranslate: NTranslateCallback,\n }\n\n unsafe impl Send for CppTranslator {}\n unsafe impl Sync for CppTranslator {}\n\n impl Drop for CppTranslator {\n fn drop(&mut self) {\n (self.drop)(self.obj);\n }\n }\n\n impl Translator for CppTranslator {\n fn translate<'a>(&'a self, string: &'a str, context: Option<&'a str>) -> Cow<'a, str> {\n let mut out = SharedString::new();\n (self.translate)(\n self.obj,\n string.as_bytes().into(),\n context.unwrap_or_default().as_bytes().into(),\n &mut out,\n );\n Cow::Owned(out.into())\n }\n\n fn ntranslate<'a>(\n &'a self,\n n: u64,\n singular: &'a str,\n plural: &'a str,\n context: Option<&'a str>,\n ) -> Cow<'a, str> {\n let mut out = SharedString::new();\n (self.ntranslate)(\n self.obj,\n n,\n singular.as_bytes().into(),\n plural.as_bytes().into(),\n context.unwrap_or_default().as_bytes().into(),\n &mut out,\n );\n Cow::Owned(out.into())\n }\n }\n\n #[unsafe(no_mangle)]\n pub extern \"C\" fn slint_translate_set_translator(\n obj: *const c_void,\n drop: DropCallback,\n translate: TranslateCallback,\n ntranslate: NTranslateCallback,\n ) -> bool {\n #[cfg(feature = \"i-slint-backend-selector\")]\n i_slint_backend_selector::with_global_context(|ctx| {\n if !obj.is_null() {\n ctx.set_external_translator(Some(Box::new(CppTranslator {\n obj,\n drop,\n translate,\n ntranslate,\n })))\n } else {\n ctx.set_external_translator(None)\n }\n })\n .is_ok()\n }\n}\n" }, { "path": "api/cpp/platform.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse alloc::rc::Rc;\nuse alloc::{boxed::Box, string::String};\nuse core::ffi::c_void;\nuse i_slint_core::api::{\n LogicalSize, PhysicalPosition, PhysicalSize, Window, WindowPosition, WindowSize,\n};\nuse i_slint_core::graphics::IntSize;\nuse i_slint_core::graphics::euclid;\nuse i_slint_core::platform::{Clipboard, Platform, PlatformError};\nuse i_slint_core::renderer::Renderer;\nuse i_slint_core::window::ffi::WindowAdapterRcOpaque;\nuse i_slint_core::window::{WindowAdapter, WindowProperties};\nuse i_slint_core::{Brush, SharedString};\n\ntype WindowAdapterUserData = *mut c_void;\n\n// FIXME wrapper over &dyn Renderer\n#[repr(C)]\npub struct RendererPtr {\n _a: *const c_void,\n _b: *const c_void,\n}\n\npub struct CppWindowAdapter {\n window: Window,\n user_data: WindowAdapterUserData,\n drop: unsafe extern \"C\" fn(WindowAdapterUserData),\n /// Safety: the returned pointer must live for the lifetime of self\n get_renderer_ref: unsafe extern \"C\" fn(WindowAdapterUserData) -> RendererPtr,\n set_visible: unsafe extern \"C\" fn(WindowAdapterUserData, bool),\n request_redraw: unsafe extern \"C\" fn(WindowAdapterUserData),\n size: unsafe extern \"C\" fn(WindowAdapterUserData) -> IntSize,\n set_size: unsafe extern \"C\" fn(WindowAdapterUserData, IntSize),\n update_window_properties: unsafe extern \"C\" fn(WindowAdapterUserData, &WindowProperties),\n position:\n unsafe extern \"C\" fn(WindowAdapterUserData, &mut euclid::default::Point2D) -> bool,\n set_position: unsafe extern \"C\" fn(WindowAdapterUserData, euclid::default::Point2D),\n}\n\nimpl Drop for CppWindowAdapter {\n fn drop(&mut self) {\n unsafe { (self.drop)(self.user_data) };\n }\n}\n\nimpl WindowAdapter for CppWindowAdapter {\n fn window(&self) -> &Window {\n &self.window\n }\n\n fn set_visible(&self, visible: bool) -> Result<(), PlatformError> {\n unsafe { (self.set_visible)(self.user_data, visible) };\n Ok(())\n }\n\n fn position(&self) -> Option {\n let mut pos = euclid::default::Point2D::::default();\n if unsafe { (self.position)(self.user_data, &mut pos) } {\n Some(i_slint_core::graphics::ffi::physical_position_to_api(pos))\n } else {\n None\n }\n }\n\n fn set_position(&self, position: WindowPosition) {\n let physical_position = i_slint_core::graphics::ffi::physical_position_from_api(\n position.to_physical(self.window.scale_factor()),\n );\n unsafe { (self.set_position)(self.user_data, physical_position) }\n }\n\n fn set_size(&self, size: WindowSize) {\n let physical_size = i_slint_core::graphics::ffi::physical_size_from_api(\n size.to_physical(self.window.scale_factor()),\n );\n unsafe { (self.set_size)(self.user_data, physical_size) }\n }\n\n fn size(&self) -> PhysicalSize {\n let s = unsafe { (self.size)(self.user_data) };\n PhysicalSize::new(s.width, s.height)\n }\n\n fn renderer(&self) -> &dyn Renderer {\n unsafe { core::mem::transmute((self.get_renderer_ref)(self.user_data)) }\n }\n\n fn request_redraw(&self) {\n unsafe { (self.request_redraw)(self.user_data) }\n }\n\n fn update_window_properties(&self, properties: WindowProperties<'_>) {\n unsafe { (self.update_window_properties)(self.user_data, &properties) }\n }\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_window_properties_get_title(wp: &WindowProperties, out: &mut SharedString) {\n *out = wp.title();\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_window_properties_get_background(wp: &WindowProperties, out: &mut Brush) {\n *out = wp.background();\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_window_properties_get_fullscreen(wp: &WindowProperties) -> bool {\n wp.is_fullscreen()\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_window_properties_get_minimized(wp: &WindowProperties) -> bool {\n wp.is_minimized()\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_window_properties_get_maximized(wp: &WindowProperties) -> bool {\n wp.is_maximized()\n}\n\n#[repr(C)]\n#[derive(Clone, Copy)]\n/// a Repr(C) variant of slint::platform::LayoutConstraints\npub struct LayoutConstraintsReprC {\n pub min: i_slint_core::graphics::Size,\n pub max: i_slint_core::graphics::Size,\n pub preferred: i_slint_core::graphics::Size,\n pub has_min: bool,\n pub has_max: bool,\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_window_properties_get_layout_constraints(\n wp: &WindowProperties,\n) -> LayoutConstraintsReprC {\n let c = wp.layout_constraints();\n LayoutConstraintsReprC {\n min: i_slint_core::lengths::logical_size_from_api(c.min.unwrap_or_default()).to_untyped(),\n max: i_slint_core::lengths::logical_size_from_api(\n c.max.unwrap_or(LogicalSize { width: f32::MAX, height: f32::MAX }),\n )\n .to_untyped(),\n preferred: i_slint_core::lengths::logical_size_from_api(c.preferred).to_untyped(),\n has_min: c.min.is_some(),\n has_max: c.max.is_some(),\n }\n}\n\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_window_adapter_new(\n user_data: WindowAdapterUserData,\n drop: unsafe extern \"C\" fn(WindowAdapterUserData),\n get_renderer_ref: unsafe extern \"C\" fn(WindowAdapterUserData) -> RendererPtr,\n set_visible: unsafe extern \"C\" fn(WindowAdapterUserData, bool),\n request_redraw: unsafe extern \"C\" fn(WindowAdapterUserData),\n size: unsafe extern \"C\" fn(WindowAdapterUserData) -> IntSize,\n set_size: unsafe extern \"C\" fn(WindowAdapterUserData, IntSize),\n update_window_properties: unsafe extern \"C\" fn(WindowAdapterUserData, &WindowProperties),\n position: unsafe extern \"C\" fn(\n WindowAdapterUserData,\n &mut euclid::default::Point2D,\n ) -> bool,\n set_position: unsafe extern \"C\" fn(WindowAdapterUserData, euclid::default::Point2D),\n target: *mut WindowAdapterRcOpaque,\n) {\n let window = Rc::::new_cyclic(|w| CppWindowAdapter {\n window: Window::new(w.clone()),\n user_data,\n drop,\n get_renderer_ref,\n set_visible,\n request_redraw,\n size,\n set_size,\n update_window_properties,\n position,\n set_position,\n });\n\n unsafe {\n core::ptr::write(target as *mut Rc, window);\n }\n}\n\ntype PlatformUserData = *mut c_void;\n\nstruct CppPlatform {\n user_data: PlatformUserData,\n drop: unsafe extern \"C\" fn(PlatformUserData),\n window_factory: unsafe extern \"C\" fn(PlatformUserData, *mut WindowAdapterRcOpaque),\n #[cfg(not(feature = \"std\"))]\n duration_since_start: unsafe extern \"C\" fn(PlatformUserData) -> u64,\n // silent the warning despite `Clipboard` is a `#[non_exhaustive]` enum from another crate.\n #[allow(improper_ctypes_definitions)]\n set_clipboard_text: unsafe extern \"C\" fn(PlatformUserData, &SharedString, Clipboard),\n #[allow(improper_ctypes_definitions)]\n clipboard_text: unsafe extern \"C\" fn(PlatformUserData, &mut SharedString, Clipboard) -> bool,\n run_event_loop: unsafe extern \"C\" fn(PlatformUserData),\n quit_event_loop: unsafe extern \"C\" fn(PlatformUserData),\n invoke_from_event_loop: unsafe extern \"C\" fn(PlatformUserData, PlatformTaskOpaque),\n}\n\nimpl Drop for CppPlatform {\n fn drop(&mut self) {\n unsafe { (self.drop)(self.user_data) };\n }\n}\n\nimpl Platform for CppPlatform {\n fn create_window_adapter(&self) -> Result, PlatformError> {\n let mut uninit = core::mem::MaybeUninit::>::uninit();\n unsafe {\n (self.window_factory)(\n self.user_data,\n uninit.as_mut_ptr() as *mut WindowAdapterRcOpaque,\n );\n Ok(uninit.assume_init())\n }\n }\n\n #[cfg(not(feature = \"std\"))]\n fn duration_since_start(&self) -> core::time::Duration {\n core::time::Duration::from_millis(unsafe { (self.duration_since_start)(self.user_data) })\n }\n\n fn run_event_loop(&self) -> Result<(), PlatformError> {\n unsafe { (self.run_event_loop)(self.user_data) };\n Ok(())\n }\n\n fn new_event_loop_proxy(&self) -> Option> {\n Some(Box::new(CppEventLoopProxy {\n user_data: self.user_data,\n quit_event_loop: self.quit_event_loop,\n invoke_from_event_loop: self.invoke_from_event_loop,\n }))\n }\n\n fn set_clipboard_text(&self, text: &str, clipboard: Clipboard) {\n let shared_text = SharedString::from(text);\n unsafe { (self.set_clipboard_text)(self.user_data, &shared_text, clipboard) }\n }\n\n fn clipboard_text(&self, clipboard: Clipboard) -> Option {\n let mut out_text = SharedString::new();\n let status = unsafe { (self.clipboard_text)(self.user_data, &mut out_text, clipboard) };\n status.then(|| out_text.into())\n }\n\n #[cfg(feature = \"esp-println\")]\n fn debug_log(&self, arguments: core::fmt::Arguments) {\n esp_println::println!(\"{arguments}\");\n }\n}\n\nstruct CppEventLoopProxy {\n user_data: PlatformUserData,\n quit_event_loop: unsafe extern \"C\" fn(PlatformUserData),\n invoke_from_event_loop: unsafe extern \"C\" fn(PlatformUserData, PlatformTaskOpaque),\n}\n\nimpl i_slint_core::platform::EventLoopProxy for CppEventLoopProxy {\n fn quit_event_loop(&self) -> Result<(), i_slint_core::api::EventLoopError> {\n unsafe { (self.quit_event_loop)(self.user_data) };\n Ok(())\n }\n\n fn invoke_from_event_loop(\n &self,\n event: Box,\n ) -> Result<(), i_slint_core::api::EventLoopError> {\n unsafe {\n (self.invoke_from_event_loop)(\n self.user_data,\n core::mem::transmute::<*mut dyn FnOnce(), PlatformTaskOpaque>(Box::into_raw(event)),\n )\n };\n Ok(())\n }\n}\n\nunsafe impl Send for CppEventLoopProxy {}\nunsafe impl Sync for CppEventLoopProxy {}\n\n// silent the warning despite `Clipboard` is a `#[non_exhaustive]` enum from another crate.\n#[allow(improper_ctypes_definitions)]\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_platform_register(\n user_data: PlatformUserData,\n drop: unsafe extern \"C\" fn(PlatformUserData),\n window_factory: unsafe extern \"C\" fn(PlatformUserData, *mut WindowAdapterRcOpaque),\n #[allow(unused)] duration_since_start: unsafe extern \"C\" fn(PlatformUserData) -> u64,\n set_clipboard_text: unsafe extern \"C\" fn(PlatformUserData, &SharedString, Clipboard),\n clipboard_text: unsafe extern \"C\" fn(PlatformUserData, &mut SharedString, Clipboard) -> bool,\n run_event_loop: unsafe extern \"C\" fn(PlatformUserData),\n quit_event_loop: unsafe extern \"C\" fn(PlatformUserData),\n invoke_from_event_loop: unsafe extern \"C\" fn(PlatformUserData, PlatformTaskOpaque),\n) {\n let p = CppPlatform {\n user_data,\n drop,\n window_factory,\n #[cfg(not(feature = \"std\"))]\n duration_since_start,\n set_clipboard_text,\n clipboard_text,\n run_event_loop,\n quit_event_loop,\n invoke_from_event_loop,\n };\n i_slint_core::platform::set_platform(Box::new(p)).unwrap();\n}\n\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_windowrc_has_active_animations(\n handle: *const WindowAdapterRcOpaque,\n) -> bool {\n let window_adapter = unsafe { &*(handle as *const Rc) };\n window_adapter.window().has_active_animations()\n}\n\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_platform_update_timers_and_animations() {\n i_slint_core::platform::update_timers_and_animations()\n}\n\n/// Returns the duration in millisecond until the next timer or `u64::MAX` if there is no pending timers\n#[unsafe(no_mangle)]\npub extern \"C\" fn slint_platform_duration_until_next_timer_update() -> u64 {\n i_slint_core::platform::duration_until_next_timer_update()\n .map_or(u64::MAX, |d| d.as_millis() as u64)\n}\n\n#[repr(C)]\npub struct PlatformTaskOpaque(*const c_void, *const c_void);\n\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_platform_task_drop(event: PlatformTaskOpaque) {\n unsafe {\n drop(Box::from_raw(core::mem::transmute::(event)));\n }\n}\n\n#[unsafe(no_mangle)]\npub unsafe extern \"C\" fn slint_platform_task_run(event: PlatformTaskOpaque) {\n unsafe {\n let f = Box::from_raw(core::mem::transmute::(event));\n f();\n }\n}\n\n#[cfg(feature = \"renderer-software\")]\nmod software_renderer {\n use super::*;\n type SoftwareRendererOpaque = *const c_void;\n use i_slint_core::SharedVector;\n use i_slint_core::graphics::{IntRect, Rgb8Pixel};\n use i_slint_renderer_software::{\n PhysicalRegion, RepaintBufferType, Rgb565Pixel, SoftwareRenderer,\n };\n\n #[cfg(feature = \"experimental\")]\n use i_slint_renderer_software::{TargetPixelBuffer, TexturePixelFormat};\n\n #[cfg(feature = \"experimental\")]\n type CppTargetPixelBufferUserData = *mut c_void;\n\n #[cfg(feature = \"experimental\")]\n #[repr(C)]\n pub struct DrawTextureArgs {\n pub image_data: *const u8,\n pub pixel_format: TexturePixelFormat,\n pub byte_stride: usize,\n pub width: u32,\n pub height: u32,\n\n pub colorize: i_slint_core::Color,\n pub alpha: u8,\n\n pub dst_x: isize,\n pub dst_y: isize,\n pub dst_width: usize,\n pub dst_height: usize,\n /// 0, 90, 180, or 270\n pub rotation: i32,\n\n pub has_tiling: bool,\n\n pub tiling_offset_x: i32,\n pub tiling_offset_y: i32,\n pub tiling_scale_x: f32,\n pub tiling_scale_y: f32,\n pub tiling_gap_x: u32,\n pub tiling_gap_y: u32,\n }\n #[cfg(feature = \"experimental\")]\n impl From<&i_slint_renderer_software::DrawTextureArgs> for DrawTextureArgs {\n fn from(from: &i_slint_renderer_software::DrawTextureArgs) -> Self {\n let source = from.source();\n Self {\n image_data: source.data.as_ptr(),\n pixel_format: source.pixel_format,\n byte_stride: source.byte_stride,\n width: source.width,\n height: source.height,\n colorize: from.colorize.unwrap_or_default(),\n alpha: from.alpha,\n dst_x: from.dst_x,\n dst_y: from.dst_y,\n dst_width: from.dst_width,\n dst_height: from.dst_height,\n rotation: from.rotation.angle() as _,\n has_tiling: from.tiling.is_some(),\n tiling_offset_x: from.tiling.as_ref().map(|t| t.offset_x).unwrap_or_default(),\n tiling_offset_y: from.tiling.as_ref().map(|t| t.offset_y).unwrap_or_default(),\n tiling_scale_x: from.tiling.as_ref().map(|t| t.scale_x).unwrap_or_default(),\n tiling_scale_y: from.tiling.as_ref().map(|t| t.scale_y).unwrap_or_default(),\n tiling_gap_x: from.tiling.as_ref().map(|t| t.gap_x).unwrap_or_default(),\n tiling_gap_y: from.tiling.as_ref().map(|t| t.gap_y).unwrap_or_default(),\n }\n }\n }\n\n #[cfg(feature = \"experimental\")]\n #[repr(C)]\n pub struct DrawRectangleArgs {\n pub x: f32,\n pub y: f32,\n pub width: f32,\n pub height: f32,\n\n pub top_left_radius: f32,\n pub top_right_radius: f32,\n pub bottom_right_radius: f32,\n pub bottom_left_radius: f32,\n\n pub border_width: f32,\n\n pub background: Brush,\n pub border: Brush,\n\n pub alpha: u8,\n /// 0, 90, 180, or 270\n pub rotation: i32,\n }\n #[cfg(feature = \"experimental\")]\n impl From<&i_slint_renderer_software::DrawRectangleArgs> for DrawRectangleArgs {\n fn from(from: &i_slint_renderer_software::DrawRectangleArgs) -> Self {\n Self {\n x: from.x,\n y: from.y,\n width: from.width,\n height: from.height,\n top_left_radius: from.top_left_radius,\n top_right_radius: from.top_right_radius,\n bottom_right_radius: from.bottom_right_radius,\n bottom_left_radius: from.bottom_left_radius,\n border_width: from.border_width,\n background: from.background.clone(),\n border: from.border.clone(),\n alpha: from.alpha,\n rotation: from.rotation.angle() as _,\n }\n }\n }\n\n #[repr(C)]\n #[cfg(feature = \"experimental\")]\n pub struct CppTargetPixelBuffer {\n user_data: CppTargetPixelBufferUserData,\n line_slice: unsafe extern \"C\" fn(\n CppTargetPixelBufferUserData,\n usize,\n slice_ptr: &mut *mut T,\n slice_len: *mut usize,\n ),\n num_lines: unsafe extern \"C\" fn(CppTargetPixelBufferUserData) -> usize,\n fill_background:\n unsafe extern \"C\" fn(CppTargetPixelBufferUserData, &Brush, &PhysicalRegion) -> bool,\n draw_rectangle: unsafe extern \"C\" fn(\n CppTargetPixelBufferUserData,\n &DrawRectangleArgs,\n &PhysicalRegion,\n ) -> bool,\n draw_texture: unsafe extern \"C\" fn(\n CppTargetPixelBufferUserData,\n &DrawTextureArgs,\n &PhysicalRegion,\n ) -> bool,\n }\n\n #[cfg(feature = \"experimental\")]\n impl TargetPixelBuffer\n for CppTargetPixelBuffer\n {\n type TargetPixel = TargetPixel;\n\n fn line_slice(&mut self, line_number: usize) -> &mut [Self::TargetPixel] {\n unsafe {\n let mut data = core::ptr::null_mut();\n let mut len = 0;\n (self.line_slice)(self.user_data, line_number, &mut data, &mut len);\n core::slice::from_raw_parts_mut(data, len)\n }\n }\n\n fn num_lines(&self) -> usize {\n unsafe { (self.num_lines)(self.user_data) }\n }\n\n /// Fill the background of the buffer with the given brush.\n fn fill_background(\n &mut self,\n brush: &i_slint_core::Brush,\n region: &PhysicalRegion,\n ) -> bool {\n unsafe { (self.fill_background)(self.user_data, brush, region) }\n }\n\n /// Draw a rectangle specified by the DrawRectangleArgs. That rectangle must be clipped to the given region\n fn draw_rectangle(\n &mut self,\n args: &i_slint_renderer_software::DrawRectangleArgs,\n clip: &PhysicalRegion,\n ) -> bool {\n let args = args.into();\n unsafe { (self.draw_rectangle)(self.user_data, &args, clip) }\n }\n\n fn draw_texture(\n &mut self,\n texture: &i_slint_renderer_software::DrawTextureArgs,\n clip: &PhysicalRegion,\n ) -> bool {\n let texture = texture.into();\n unsafe { (self.draw_texture)(self.user_data, &texture, clip) }\n }\n }\n\n #[unsafe(no_mangle)]\n pub extern \"C\" fn slint_software_renderer_new(buffer_age: u32) -> SoftwareRendererOpaque {\n let repaint_buffer_type = match buffer_age {\n 0 => RepaintBufferType::NewBuffer,\n 1 => RepaintBufferType::ReusedBuffer,\n 2 => RepaintBufferType::SwappedBuffers,\n _ => unreachable!(),\n };\n Box::into_raw(Box::new(SoftwareRenderer::new_with_repaint_buffer_type(repaint_buffer_type)))\n as SoftwareRendererOpaque\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_drop(r: SoftwareRendererOpaque) {\n unsafe {\n drop(Box::from_raw(r as *mut SoftwareRenderer));\n }\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_render_rgb8(\n r: SoftwareRendererOpaque,\n buffer: *mut Rgb8Pixel,\n buffer_len: usize,\n pixel_stride: usize,\n ) -> PhysicalRegion {\n unsafe {\n let buffer = core::slice::from_raw_parts_mut(buffer, buffer_len);\n let renderer = &*(r as *const SoftwareRenderer);\n renderer.render(buffer, pixel_stride)\n }\n }\n\n #[cfg(feature = \"experimental\")]\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_render_accel_rgb8(\n r: SoftwareRendererOpaque,\n buffer: &mut CppTargetPixelBuffer,\n ) -> PhysicalRegion {\n let renderer = unsafe { &*(r as *const SoftwareRenderer) };\n renderer.render_into_buffer(buffer)\n }\n\n #[cfg(feature = \"experimental\")]\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_render_accel_rgb565(\n r: SoftwareRendererOpaque,\n buffer: &mut CppTargetPixelBuffer,\n ) -> PhysicalRegion {\n let renderer = unsafe { &*(r as *const SoftwareRenderer) };\n renderer.render_into_buffer(buffer)\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_render_rgb565(\n r: SoftwareRendererOpaque,\n buffer: *mut u16,\n buffer_len: usize,\n pixel_stride: usize,\n ) -> PhysicalRegion {\n unsafe {\n let buffer = core::slice::from_raw_parts_mut(buffer as *mut Rgb565Pixel, buffer_len);\n let renderer = &*(r as *const SoftwareRenderer);\n renderer.render(buffer, pixel_stride)\n }\n }\n\n struct LineByLineProcessor {\n process_line_fn: extern \"C\" fn(\n *mut core::ffi::c_void,\n usize,\n usize,\n usize,\n extern \"C\" fn(*const core::ffi::c_void, *mut TargetPixel, usize),\n *const core::ffi::c_void,\n ),\n user_data: *mut core::ffi::c_void,\n }\n\n impl\n i_slint_renderer_software::LineBufferProvider for LineByLineProcessor\n {\n type TargetPixel = TargetPixel;\n fn process_line(\n &mut self,\n line: usize,\n range: core::ops::Range,\n render_fn: impl FnOnce(&mut [TargetPixel]),\n ) {\n self.cpp_process_line(line, range, render_fn);\n }\n }\n\n impl LineByLineProcessor {\n fn cpp_process_line(\n &mut self,\n line: usize,\n range: core::ops::Range,\n render_fn: RenderFn,\n ) {\n let mut render_fn = Some(render_fn);\n let render_fn_ptr = &mut render_fn as *mut Option as *const core::ffi::c_void;\n\n extern \"C\" fn cpp_render_line_callback<\n TargetPixel,\n RenderFn: FnOnce(&mut [TargetPixel]),\n >(\n render_fn_ptr: *const core::ffi::c_void,\n line_start: *mut TargetPixel,\n len: usize,\n ) {\n let line_slice = unsafe { core::slice::from_raw_parts_mut(line_start, len) };\n let render_fn =\n unsafe { (*(render_fn_ptr as *mut Option)).take().unwrap() };\n render_fn(line_slice);\n }\n\n (self.process_line_fn)(\n self.user_data,\n line,\n range.start,\n range.end,\n cpp_render_line_callback::,\n render_fn_ptr,\n );\n }\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_render_by_line_rgb565(\n r: SoftwareRendererOpaque,\n process_line_fn: extern \"C\" fn(\n *mut core::ffi::c_void,\n usize,\n usize,\n usize,\n extern \"C\" fn(*const core::ffi::c_void, *mut Rgb565Pixel, usize),\n *const core::ffi::c_void,\n ),\n user_data: *mut core::ffi::c_void,\n ) -> PhysicalRegion {\n let renderer = unsafe { &*(r as *const SoftwareRenderer) };\n let processor = LineByLineProcessor { process_line_fn, user_data };\n renderer.render_by_line(processor)\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_render_by_line_rgb8(\n r: SoftwareRendererOpaque,\n process_line_fn: extern \"C\" fn(\n *mut core::ffi::c_void,\n usize,\n usize,\n usize,\n extern \"C\" fn(*const core::ffi::c_void, *mut Rgb8Pixel, usize),\n *const core::ffi::c_void,\n ),\n user_data: *mut core::ffi::c_void,\n ) -> PhysicalRegion {\n let renderer = unsafe { &*(r as *const SoftwareRenderer) };\n let processor = LineByLineProcessor { process_line_fn, user_data };\n renderer.render_by_line(processor)\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_set_rendering_rotation(\n r: SoftwareRendererOpaque,\n rotation: i32,\n ) {\n use i_slint_renderer_software::RenderingRotation;\n let renderer = unsafe { &*(r as *const SoftwareRenderer) };\n renderer.set_rendering_rotation(match rotation {\n 90 => RenderingRotation::Rotate90,\n 180 => RenderingRotation::Rotate180,\n 270 => RenderingRotation::Rotate270,\n _ => RenderingRotation::NoRotation,\n });\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_software_renderer_handle(\n r: SoftwareRendererOpaque,\n ) -> RendererPtr {\n unsafe {\n let r = (r as *const SoftwareRenderer) as *const dyn Renderer;\n core::mem::transmute(r)\n }\n }\n\n #[unsafe(no_mangle)]\n pub extern \"C\" fn slint_software_renderer_region_to_rects(\n region: &PhysicalRegion,\n out: &mut SharedVector,\n ) {\n *out = region\n .iter()\n .map(|r| euclid::rect(r.0.x, r.0.y, r.1.width as i32, r.1.height as i32))\n .collect();\n }\n}\n\n#[cfg(all(feature = \"i-slint-renderer-skia\", feature = \"raw-window-handle\"))]\npub mod skia {\n use super::*;\n use raw_window_handle::{RawDisplayHandle, RawWindowHandle};\n use std::sync::Arc;\n\n struct RawHandlePair((RawWindowHandle, RawDisplayHandle));\n\n impl raw_window_handle::HasDisplayHandle for RawHandlePair {\n fn display_handle(\n &self,\n ) -> Result, raw_window_handle::HandleError> {\n // Safety: It is assumed that the C++ side keeps the window/display handles alive.\n Ok(unsafe { raw_window_handle::DisplayHandle::borrow_raw(self.0.1) })\n }\n }\n\n impl raw_window_handle::HasWindowHandle for RawHandlePair {\n fn window_handle(\n &self,\n ) -> Result, raw_window_handle::HandleError> {\n // Safety: It is assumed that the C++ side keeps the window/display handles alive.\n Ok(unsafe { raw_window_handle::WindowHandle::borrow_raw(self.0.0) })\n }\n }\n\n /// Safety: This is only needed for the Skia renderer when using WGPU, which isn't supported for C++.\n unsafe impl std::marker::Send for RawHandlePair {}\n unsafe impl std::marker::Sync for RawHandlePair {}\n\n struct CppRawHandle(Arc);\n\n impl From<(RawWindowHandle, RawDisplayHandle)> for CppRawHandle {\n fn from(pair: (RawWindowHandle, RawDisplayHandle)) -> Self {\n Self(Arc::new(RawHandlePair(pair)))\n }\n }\n\n type CppRawHandleOpaque = *const c_void;\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_new_raw_window_handle_win32(\n hwnd: *mut c_void,\n _hinstance: *mut c_void,\n ) -> CppRawHandleOpaque {\n let handle = CppRawHandle::from((\n RawWindowHandle::Win32(raw_window_handle::Win32WindowHandle::new(\n (hwnd as isize).try_into().expect(\"C++: NativeWindowHandle created with null hwnd\"),\n )),\n RawDisplayHandle::Windows(raw_window_handle::WindowsDisplayHandle::new()),\n ));\n Box::into_raw(Box::new(handle)) as CppRawHandleOpaque\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_new_raw_window_handle_x11_xcb(\n window: u32,\n visual_id: u32,\n connection: *mut c_void,\n screen: core::ffi::c_int,\n ) -> CppRawHandleOpaque {\n use raw_window_handle::{XcbDisplayHandle, XcbWindowHandle};\n let handle = CppRawHandle::from((\n RawWindowHandle::Xcb({\n let mut hnd = XcbWindowHandle::new(\n window\n .try_into()\n .expect(\"C++: NativeWindowHandle created with null xcb window handle\"),\n );\n hnd.visual_id = visual_id.try_into().ok();\n hnd\n }),\n RawDisplayHandle::Xcb(XcbDisplayHandle::new(\n core::ptr::NonNull::new(connection),\n screen,\n )),\n ));\n Box::into_raw(Box::new(handle)) as CppRawHandleOpaque\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_new_raw_window_handle_x11_xlib(\n window: core::ffi::c_ulong,\n visual_id: core::ffi::c_ulong,\n display: *mut c_void,\n screen: core::ffi::c_int,\n ) -> CppRawHandleOpaque {\n use raw_window_handle::{XlibDisplayHandle, XlibWindowHandle};\n let handle = CppRawHandle::from((\n RawWindowHandle::Xlib({\n let mut hnd = XlibWindowHandle::new(window);\n hnd.visual_id = visual_id;\n hnd\n }),\n RawDisplayHandle::Xlib(XlibDisplayHandle::new(\n core::ptr::NonNull::new(display),\n screen,\n )),\n ));\n Box::into_raw(Box::new(handle)) as CppRawHandleOpaque\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_new_raw_window_handle_wayland(\n surface: *mut c_void,\n display: *mut c_void,\n ) -> CppRawHandleOpaque {\n use raw_window_handle::{WaylandDisplayHandle, WaylandWindowHandle};\n let handle = CppRawHandle::from((\n RawWindowHandle::Wayland(WaylandWindowHandle::new(\n core::ptr::NonNull::new(surface).unwrap(),\n )),\n RawDisplayHandle::Wayland(WaylandDisplayHandle::new(\n core::ptr::NonNull::new(display).unwrap(),\n )),\n ));\n Box::into_raw(Box::new(handle)) as CppRawHandleOpaque\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_new_raw_window_handle_appkit(\n ns_view: *mut c_void,\n _ns_window: *mut c_void,\n ) -> CppRawHandleOpaque {\n use raw_window_handle::{AppKitDisplayHandle, AppKitWindowHandle};\n let handle = CppRawHandle::from((\n RawWindowHandle::AppKit(AppKitWindowHandle::new(\n core::ptr::NonNull::new(ns_view).unwrap(),\n )),\n RawDisplayHandle::AppKit(AppKitDisplayHandle::new()),\n ));\n Box::into_raw(Box::new(handle)) as CppRawHandleOpaque\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_raw_window_handle_drop(handle: CppRawHandleOpaque) {\n unsafe { drop(Box::from_raw(handle as *mut CppRawHandle)) }\n }\n\n type SkiaRendererOpaque = *const c_void;\n type SkiaRenderer = i_slint_renderer_skia::SkiaRenderer;\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_skia_renderer_new(\n handle_opaque: CppRawHandleOpaque,\n size: IntSize,\n ) -> SkiaRendererOpaque {\n let handle = unsafe { &*(handle_opaque as *const CppRawHandle) };\n\n let boxed_renderer: Box = Box::new(\n SkiaRenderer::new(\n &i_slint_renderer_skia::SkiaSharedContext::default(),\n handle.0.clone(),\n handle.0.clone(),\n PhysicalSize { width: size.width, height: size.height },\n )\n .unwrap(),\n );\n Box::into_raw(boxed_renderer) as SkiaRendererOpaque\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_skia_renderer_drop(r: SkiaRendererOpaque) {\n unsafe { drop(Box::from_raw(r as *mut SkiaRenderer)) }\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_skia_renderer_render(r: SkiaRendererOpaque) {\n let r = unsafe { &*(r as *const SkiaRenderer) };\n r.render().unwrap();\n }\n\n #[unsafe(no_mangle)]\n pub unsafe extern \"C\" fn slint_skia_renderer_handle(r: SkiaRendererOpaque) -> RendererPtr {\n unsafe {\n let r = (r as *const SkiaRenderer) as *const dyn Renderer;\n core::mem::transmute(r)\n }\n }\n}\n" }, { "path": "api/cpp/tests/CMakeLists.txt", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\ninclude(FetchContent)\nFetchContent_Declare(\n Catch2\n GIT_REPOSITORY https://github.com/catchorg/Catch2.git\n GIT_TAG v3.8.0\n)\n\nFetchContent_MakeAvailable(Catch2)\n\nfind_package(Threads REQUIRED)\n\nmacro(slint_test NAME)\n add_executable(test_${NAME} ${NAME}.cpp)\n target_link_libraries(test_${NAME} PRIVATE Slint Catch2::Catch2WithMain)\n target_compile_definitions(test_${NAME} PRIVATE\n SOURCE_DIR=\\\"${CMAKE_CURRENT_SOURCE_DIR}/\\\"\n )\n # Use debug version of run-time library to enable MSVC iterator debugging\n set_property(TARGET test_${NAME} PROPERTY MSVC_RUNTIME_LIBRARY MultiThreadedDebugDLL)\n add_test(NAME test_${NAME} COMMAND test_${NAME})\n\n if(MSVC)\n target_compile_options(test_${NAME} PRIVATE /W3)\n else()\n target_compile_options(test_${NAME} PRIVATE -Wall -Wextra -Werror)\n endif()\n\n if(CMAKE_CXX_COMPILER_ID STREQUAL GNU AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 14)\n # that warning has false positives in GCC 11 https://github.com/slint-ui/slint/issues/7358\n target_compile_options(test_${NAME} PRIVATE -Wno-maybe-uninitialized)\n endif()\nendmacro(slint_test)\n\nslint_test(datastructures)\n\nif(SLINT_FEATURE_INTERPRETER)\n slint_test(interpreter)\n slint_test(window)\nendif()\n\nif(SLINT_FEATURE_INTERPRETER AND SLINT_FEATURE_EXPERIMENTAL)\n slint_test(translator)\nendif()\n\nslint_test(properties)\nif(NOT SLINT_FEATURE_FREESTANDING)\n slint_test(eventloop)\n target_link_libraries(test_eventloop PRIVATE Threads::Threads)\nendif()\nslint_test(models)\n\nif(SLINT_FEATURE_EXPERIMENTAL AND SLINT_FEATURE_TESTING)\n slint_test(testing)\nendif()\n\nif(SLINT_FEATURE_COMPILER OR SLINT_COMPILER)\n add_subdirectory(multiple-includes)\n add_subdirectory(libraries)\nendif()\n\nslint_test(platform_eventloop)\ntarget_link_libraries(test_platform_eventloop PRIVATE Threads::Threads)\n\n" }, { "path": "api/cpp/tests/datastructures.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#include \n#include \n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n\nSCENARIO(\"SharedString API\")\n{\n slint::SharedString str;\n\n REQUIRE(str.empty());\n REQUIRE(str.size() == 0);\n REQUIRE(str == \"\");\n REQUIRE(std::string_view(str.data()) == \"\"); // this test null termination of data()\n\n SECTION(\"Construct from string_view\")\n {\n std::string foo(\"Foo\");\n std::string_view foo_view(foo);\n str = foo_view;\n REQUIRE(str == \"Foo\");\n REQUIRE(std::string_view(str.data()) == \"Foo\");\n }\n\n SECTION(\"Construct from char*\")\n {\n str = \"Bar\";\n REQUIRE(str == \"Bar\");\n }\n\n SECTION(\"concatenate\")\n {\n str = \"Hello\";\n str += \" \";\n str += slint::SharedString(\"🦊\") + slint::SharedString(\"!\");\n REQUIRE(str == \"Hello 🦊!\");\n REQUIRE(std::string_view(str.data()) == \"Hello 🦊!\");\n }\n\n SECTION(\"begin/end\")\n {\n str = \"Hello\";\n REQUIRE(str.begin() + std::string_view(str).size() == str.end());\n }\n\n SECTION(\"size\")\n {\n str = \"Hello\";\n REQUIRE(str.size() == 5);\n }\n\n SECTION(\"clear\")\n {\n str = \"Hello\";\n str.clear();\n REQUIRE(str.size() == 0);\n REQUIRE(std::string_view(str.data()) == \"\");\n }\n\n SECTION(\"to_lowercase\")\n {\n str = \"Hello\";\n REQUIRE(std::string_view(str.to_lowercase().data()) == \"hello\");\n }\n SECTION(\"to_uppercase\")\n {\n str = \"Hello\";\n REQUIRE(std::string_view(str.to_uppercase().data()) == \"HELLO\");\n }\n}\n\nTEST_CASE(\"Basic SharedVector API\", \"[vector]\")\n{\n slint::SharedVector vec;\n REQUIRE(vec.empty());\n\n SECTION(\"Initializer list\")\n {\n slint::SharedVector vec({ 1, 4, 10 });\n REQUIRE(vec.size() == 3);\n REQUIRE(vec[0] == 1);\n REQUIRE(vec[1] == 4);\n REQUIRE(vec[2] == 10);\n }\n}\n\nTEST_CASE(\"Property Tracker\")\n{\n using namespace slint::private_api;\n PropertyTracker tracker1;\n PropertyTracker tracker2;\n Property prop(42);\n\n auto r = tracker1.evaluate([&]() { return tracker2.evaluate([&]() { return prop.get(); }); });\n REQUIRE(r == 42);\n\n prop.set(1);\n REQUIRE(tracker2.is_dirty());\n REQUIRE(tracker1.is_dirty());\n\n r = tracker1.evaluate(\n [&]() { return tracker2.evaluate_as_dependency_root([&]() { return prop.get(); }); });\n REQUIRE(r == 1);\n prop.set(100);\n REQUIRE(tracker2.is_dirty());\n REQUIRE(!tracker1.is_dirty());\n}\n\nTEST_CASE(\"Model row changes\")\n{\n using namespace slint::private_api;\n\n auto model = std::make_shared>();\n\n PropertyTracker tracker;\n\n REQUIRE(tracker.evaluate([&]() {\n model->track_row_count_changes();\n return model->row_count();\n }) == 0);\n REQUIRE(!tracker.is_dirty());\n model->push_back(1);\n model->push_back(2);\n REQUIRE(tracker.is_dirty());\n REQUIRE(tracker.evaluate([&]() {\n model->track_row_count_changes();\n return model->row_count();\n }) == 2);\n REQUIRE(!tracker.is_dirty());\n model->erase(0);\n REQUIRE(tracker.is_dirty());\n REQUIRE(tracker.evaluate([&]() {\n model->track_row_count_changes();\n return model->row_count();\n }) == 1);\n}\n\nTEST_CASE(\"Track model row data changes\")\n{\n using namespace slint::private_api;\n\n auto model = std::make_shared>(std::vector { 0, 1, 2, 3, 4 });\n\n PropertyTracker tracker;\n\n REQUIRE(tracker.evaluate([&]() {\n model->track_row_data_changes(1);\n return model->row_data(1);\n }) == 1);\n REQUIRE(!tracker.is_dirty());\n\n model->set_row_data(2, 42);\n REQUIRE(!tracker.is_dirty());\n model->set_row_data(1, 100);\n REQUIRE(tracker.is_dirty());\n\n REQUIRE(tracker.evaluate([&]() {\n model->track_row_data_changes(1);\n return model->row_data(1);\n }) == 100);\n REQUIRE(!tracker.is_dirty());\n\n // Any changes to rows (even if after tracked rows) for now also marks watched rows as dirty, to\n // keep the logic simple.\n model->push_back(200);\n REQUIRE(tracker.is_dirty());\n\n REQUIRE(tracker.evaluate([&]() {\n model->track_row_data_changes(1);\n return model->row_data(1);\n }) == 100);\n REQUIRE(!tracker.is_dirty());\n\n model->insert(0, 255);\n REQUIRE(tracker.is_dirty());\n}\n\nTEST_CASE(\"Image\")\n{\n using namespace slint;\n\n Image img;\n {\n auto size = img.size();\n REQUIRE(size.width == 0.);\n REQUIRE(size.height == 0.);\n }\n {\n REQUIRE(!img.path().has_value());\n }\n\n#ifndef SLINT_FEATURE_FREESTANDING\n img = Image::load_from_path(SOURCE_DIR \"/../../../logo/slint-logo-square-light-128x128.png\");\n {\n auto size = img.size();\n REQUIRE(size.width == 128.);\n REQUIRE(size.height == 128.);\n }\n {\n auto actual_path = img.path();\n REQUIRE(actual_path.has_value());\n REQUIRE(*actual_path == SOURCE_DIR \"/../../../logo/slint-logo-square-light-128x128.png\");\n }\n#endif\n\n img = Image(SharedPixelBuffer {});\n {\n auto size = img.size();\n REQUIRE(size.width == 0);\n REQUIRE(size.height == 0);\n REQUIRE(!img.path().has_value());\n }\n auto red = Rgb8Pixel { 0xff, 0, 0 };\n auto blu = Rgb8Pixel { 0, 0, 0xff };\n Rgb8Pixel some_data[] = { red, red, blu, red, blu, blu };\n img = Image(SharedPixelBuffer(3, 2, some_data));\n {\n auto size = img.size();\n REQUIRE(size.width == 3);\n REQUIRE(size.height == 2);\n REQUIRE(!img.path().has_value());\n }\n}\n\nTEST_CASE(\"Image buffer access\")\n{\n using namespace slint;\n\n auto img = Image::load_from_path(SOURCE_DIR \"/redpixel.png\");\n\n REQUIRE(!img.to_rgb8().has_value());\n\n {\n auto rgb = img.to_rgba8();\n REQUIRE(rgb.has_value());\n REQUIRE(rgb->width() == 1);\n REQUIRE(rgb->height() == 1);\n REQUIRE(*rgb->begin() == Rgba8Pixel { 255, 0, 0, 255 });\n }\n\n {\n auto rgb = img.to_rgba8_premultiplied();\n REQUIRE(rgb.has_value());\n REQUIRE(rgb->width() == 1);\n REQUIRE(rgb->height() == 1);\n REQUIRE(*rgb->begin() == Rgba8Pixel { 255, 0, 0, 255 });\n }\n}\n\nTEST_CASE(\"SharedVector\")\n{\n using namespace slint;\n\n SharedVector vec;\n vec.clear();\n vec.push_back(\"Hello\");\n vec.push_back(\"World\");\n vec.push_back(\"of\");\n vec.push_back(\"Vectors\");\n\n auto copy = vec;\n\n REQUIRE(vec.size() == 4);\n auto orig_cap = vec.capacity();\n REQUIRE(orig_cap >= vec.size());\n\n vec.clear();\n REQUIRE(vec.size() == 0);\n REQUIRE(vec.capacity() == 0); // vec was shared, so start with new empty vector.\n vec.push_back(\"Welcome back\");\n REQUIRE(vec.size() == 1);\n REQUIRE(vec.capacity() >= vec.size());\n\n REQUIRE(copy.size() == 4);\n REQUIRE(copy.capacity() == orig_cap);\n\n SharedVector vec2 { \"Hello\", \"World\", \"of\", \"Vectors\" };\n REQUIRE(copy == vec2);\n REQUIRE(copy != vec);\n\n copy.clear(); // copy is not shared (anymore), retain capacity.\n REQUIRE(copy.capacity() == orig_cap);\n\n SharedVector vec3(2, \"Welcome back\");\n REQUIRE(vec3.size() == 2);\n REQUIRE(vec3[1] == \"Welcome back\");\n REQUIRE(vec3 != vec);\n\n vec.push_back(\"Welcome back\");\n REQUIRE(vec3 == vec);\n\n SharedVector vec4(5);\n REQUIRE(vec4.size() == 5);\n REQUIRE(vec4[3] == 0);\n\n std::vector std_v(vec2.begin(), vec2.end());\n SharedVector vec6(std_v.begin(), std_v.end());\n REQUIRE(vec6 == vec2);\n}\n\nTEST_CASE(\"StyledText\")\n{\n auto empty_arguments = std::array {};\n auto text = slint::private_api::parse_markdown(\n \"Hello *world*\", slint::private_api::make_slice(std::span(empty_arguments)));\n auto text_argument = std::array { text };\n auto text2 = slint::private_api::parse_markdown(\n \"Text: {}\", slint::private_api::make_slice(std::span(text_argument)));\n}\n" }, { "path": "api/cpp/tests/eventloop.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n// cSpell: ignore singleshot\n\n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n#include \n\nTEST_CASE(\"C++ Singleshot Timers\")\n{\n using namespace slint;\n int called = 0;\n Timer testTimer(std::chrono::milliseconds(16), [&]() {\n slint::quit_event_loop();\n called += 10;\n });\n REQUIRE(called == 0);\n slint::run_event_loop();\n REQUIRE(called == 10);\n}\n\nTEST_CASE(\"C++ Repeated Timer\")\n{\n int timer_triggered = 0;\n slint::Timer timer;\n\n timer.start(slint::TimerMode::Repeated, std::chrono::milliseconds(30),\n [&]() { timer_triggered++; });\n\n REQUIRE(timer_triggered == 0);\n\n bool timer_was_running = false;\n\n slint::Timer::single_shot(std::chrono::milliseconds(500), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered > 1);\n REQUIRE(timer_was_running);\n}\n\nTEST_CASE(\"C++ Restart Singleshot Timer\")\n{\n int timer_triggered = 0;\n slint::Timer timer;\n\n timer.start(slint::TimerMode::SingleShot, std::chrono::milliseconds(30),\n [&]() { timer_triggered++; });\n\n REQUIRE(timer_triggered == 0);\n REQUIRE(timer.running());\n\n bool timer_was_running = true;\n\n slint::Timer::single_shot(std::chrono::milliseconds(500), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(!timer.running());\n REQUIRE(timer_triggered == 1);\n REQUIRE(!timer_was_running); // At that point the timer is already considered stopped!\n\n timer_triggered = 0;\n timer_was_running = true;\n\n timer.restart();\n REQUIRE(timer.running());\n slint::Timer::single_shot(std::chrono::milliseconds(500), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered == 1);\n REQUIRE(!timer_was_running);\n REQUIRE(!timer.running());\n}\n\nTEST_CASE(\"C++ Restart Repeated Timer\")\n{\n int timer_triggered = 0;\n slint::Timer timer;\n\n timer.start(slint::TimerMode::Repeated, std::chrono::milliseconds(30),\n [&]() { timer_triggered++; });\n\n REQUIRE(timer_triggered == 0);\n\n bool timer_was_running = false;\n\n slint::Timer::single_shot(std::chrono::milliseconds(500), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered > 1);\n REQUIRE(timer_was_running);\n\n timer_was_running = false;\n timer_triggered = 0;\n timer.stop();\n slint::Timer::single_shot(std::chrono::milliseconds(500), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered == 0);\n REQUIRE(!timer_was_running);\n\n timer_was_running = false;\n timer_triggered = 0;\n\n timer.restart();\n\n slint::Timer::single_shot(std::chrono::milliseconds(500), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered > 1);\n REQUIRE(timer_was_running);\n}\n\nTEST_CASE(\"Quit from event\")\n{\n int called = 0;\n slint::invoke_from_event_loop([&] {\n slint::quit_event_loop();\n called += 10;\n });\n REQUIRE(called == 0);\n slint::run_event_loop();\n REQUIRE(called == 10);\n}\n\nTEST_CASE(\"Event from thread\")\n{\n std::atomic called = 0;\n auto t = std::thread([&] {\n called += 10;\n slint::invoke_from_event_loop([&] {\n called += 100;\n slint::quit_event_loop();\n });\n });\n\n slint::run_event_loop();\n REQUIRE(called == 110);\n t.join();\n}\n\nTEST_CASE(\"Blocking Event from thread\")\n{\n std::atomic called = 0;\n auto t = std::thread([&] {\n // test returning a, unique_ptr because it is movable-only\n std::unique_ptr foo =\n slint::blocking_invoke_from_event_loop([&] { return std::make_unique(42); });\n called = *foo;\n int xxx = 123;\n slint::blocking_invoke_from_event_loop([&] {\n slint::quit_event_loop();\n xxx = 888999;\n });\n REQUIRE(xxx == 888999);\n });\n\n slint::run_event_loop();\n REQUIRE(called == 42);\n t.join();\n}\n" }, { "path": "api/cpp/tests/interpreter.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n#include \n\nSCENARIO(\"Value API\")\n{\n using namespace slint::interpreter;\n Value value;\n\n REQUIRE(value.type() == Value::Type::Void);\n\n SECTION(\"Construct a string\")\n {\n REQUIRE(!value.to_string().has_value());\n slint::SharedString cpp_str(\"Hello World\");\n value = Value(cpp_str);\n REQUIRE(value.type() == Value::Type::String);\n\n auto string_opt = value.to_string();\n REQUIRE(string_opt.has_value());\n REQUIRE(string_opt.value() == \"Hello World\");\n }\n\n SECTION(\"Construct a number\")\n {\n REQUIRE(!value.to_number().has_value());\n const double number = 42.0;\n value = Value(number);\n REQUIRE(value.type() == Value::Type::Number);\n\n auto number_opt = value.to_number();\n REQUIRE(number_opt.has_value());\n REQUIRE(number_opt.value() == number);\n\n Value v2 = 42;\n REQUIRE(v2.type() == Value::Type::Number);\n REQUIRE(v2 == value);\n REQUIRE(*v2.to_number() == number);\n }\n\n SECTION(\"Construct a bool\")\n {\n REQUIRE(!value.to_bool().has_value());\n value = Value(true);\n REQUIRE(value.type() == Value::Type::Bool);\n\n auto bool_opt = value.to_bool();\n REQUIRE(bool_opt.has_value());\n REQUIRE(bool_opt.value() == true);\n }\n\n SECTION(\"Construct an array\")\n {\n REQUIRE(!value.to_array().has_value());\n slint::SharedVector array { Value(42.0), Value(true) };\n value = Value(array);\n REQUIRE(value.type() == Value::Type::Model);\n\n auto array_opt = value.to_array();\n REQUIRE(array_opt.has_value());\n\n auto extracted_array = array_opt.value();\n REQUIRE(extracted_array.size() == 2);\n REQUIRE(extracted_array[0].to_number().value() == 42);\n REQUIRE(extracted_array[1].to_bool().value());\n }\n\n SECTION(\"Construct a brush\")\n {\n REQUIRE(!value.to_brush().has_value());\n slint::Brush brush(slint::Color::from_rgb_uint8(255, 0, 255));\n value = Value(brush);\n REQUIRE(value.type() == Value::Type::Brush);\n\n auto brush_opt = value.to_brush();\n REQUIRE(brush_opt.has_value());\n REQUIRE(brush_opt.value() == brush);\n }\n\n SECTION(\"Construct a struct\")\n {\n REQUIRE(!value.to_struct().has_value());\n slint::interpreter::Struct struc;\n value = Value(struc);\n REQUIRE(value.type() == Value::Type::Struct);\n\n auto struct_opt = value.to_struct();\n REQUIRE(struct_opt.has_value());\n }\n\n SECTION(\"Construct an image\")\n {\n REQUIRE(!value.to_image().has_value());\n slint::Image image = slint::Image::load_from_path(\n SOURCE_DIR \"/../../../logo/slint-logo-square-light-128x128.png\");\n REQUIRE(image.size().width == 128);\n value = Value(image);\n REQUIRE(value.type() == Value::Type::Image);\n\n auto image2 = value.to_image();\n REQUIRE(image2.has_value());\n REQUIRE(image2->size().width == 128);\n REQUIRE(image == *image2);\n }\n\n SECTION(\"Construct a model\")\n {\n // And test that it is properly destroyed when the value is destroyed\n struct M : slint::VectorModel\n {\n bool *destroyed;\n explicit M(bool *destroyed) : destroyed(destroyed) { }\n void play()\n {\n this->push_back(Value(4.));\n this->set_row_data(0, Value(9.));\n }\n ~M() { *destroyed = true; }\n };\n bool destroyed = false;\n auto m = std::make_shared(&destroyed);\n {\n Value value(m);\n REQUIRE(value.type() == Value::Type::Model);\n REQUIRE(!destroyed);\n m->play();\n m = nullptr;\n REQUIRE(!destroyed);\n // play a bit with the value to test the copy and move\n Value v2 = value;\n Value v3 = std::move(v2);\n REQUIRE(!destroyed);\n }\n REQUIRE(destroyed);\n }\n\n SECTION(\"Compare Values\")\n {\n Value str1 { slint::SharedString(\"Hello1\") };\n Value str2 { slint::SharedString(\"Hello2\") };\n Value fl1 { 10. };\n Value fl2 { 12. };\n\n REQUIRE(str1 == str1);\n REQUIRE(str1 != str2);\n REQUIRE(str1 != fl2);\n REQUIRE(fl1 == fl1);\n REQUIRE(fl1 != fl2);\n REQUIRE(Value() == Value());\n REQUIRE(Value() != str1);\n REQUIRE(str1 == slint::SharedString(\"Hello1\"));\n REQUIRE(str1 != slint::SharedString(\"Hello2\"));\n REQUIRE(slint::SharedString(\"Hello2\") == str2);\n REQUIRE(fl1 != slint::SharedString(\"Hello2\"));\n REQUIRE(fl2 == 12.);\n }\n}\n\nSCENARIO(\"Struct API\")\n{\n using namespace slint::interpreter;\n Struct struc;\n\n REQUIRE(!struc.get_field(\"not_there\"));\n\n struc.set_field(\"field_a\", Value(slint::SharedString(\"Hallo\")));\n\n auto value_opt = struc.get_field(\"field_a\");\n REQUIRE(value_opt.has_value());\n auto value = value_opt.value();\n REQUIRE(value.to_string().has_value());\n REQUIRE(value.to_string().value() == \"Hallo\");\n\n int count = 0;\n for (auto [k, value] : struc) {\n REQUIRE(count == 0);\n count++;\n REQUIRE(k == \"field-a\");\n REQUIRE(value.to_string().value() == \"Hallo\");\n }\n\n struc.set_field(\"field_b\", Value(slint::SharedString(\"World\")));\n std::map map;\n for (auto [k, value] : struc)\n map[std::string(k)] = *value.to_string();\n\n REQUIRE(map\n == std::map {\n { \"field-a\", slint::SharedString(\"Hallo\") },\n { \"field-b\", slint::SharedString(\"World\") } });\n}\n\nSCENARIO(\"Struct Iterator Constructor\")\n{\n using namespace slint::interpreter;\n\n std::vector> values = { { \"field_a\", Value(true) },\n { \"field_b\", Value(42.0) } };\n\n Struct struc(values.begin(), values.end());\n\n REQUIRE(!struc.get_field(\"foo\").has_value());\n REQUIRE(struc.get_field(\"field_a\").has_value());\n REQUIRE(struc.get_field(\"field_a\").value().to_bool().value());\n REQUIRE(struc.get_field(\"field_b\").value().to_number().value() == 42.0);\n}\n\nSCENARIO(\"Struct Initializer List Constructor\")\n{\n using namespace slint::interpreter;\n\n Struct struc({ { \"field_a\", Value(true) }, { \"field_b\", Value(42.0) } });\n\n REQUIRE(!struc.get_field(\"foo\").has_value());\n REQUIRE(struc.get_field(\"field_a\").has_value());\n REQUIRE(struc.get_field(\"field_a\").value().to_bool().value());\n REQUIRE(struc.get_field(\"field_b\").value().to_number().value() == 42.0);\n}\n\nSCENARIO(\"Struct empty field iteration\")\n{\n using namespace slint::interpreter;\n Struct struc;\n REQUIRE(struc.begin() == struc.end());\n}\n\nSCENARIO(\"Struct field iteration\")\n{\n using namespace slint::interpreter;\n\n Struct struc({ { \"field_a\", Value(true) }, { \"field_b\", Value(42.0) } });\n\n auto it = struc.begin();\n auto end = struc.end();\n REQUIRE(it != end);\n\n auto check_valid_entry = [](const auto &key, const auto &value) -> bool {\n if (key == \"field-a\")\n return value == Value(true);\n if (key == \"field-b\")\n return value == Value(42.0);\n return false;\n };\n\n std::set seen_fields;\n\n for (; it != end; ++it) {\n const auto [key, value] = *it;\n REQUIRE(check_valid_entry(key, value));\n auto value_inserted = seen_fields.insert(std::string(key)).second;\n REQUIRE(value_inserted);\n }\n}\n\nSCENARIO(\"Component Compiler\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n\n SECTION(\"configure include paths\")\n {\n SharedVector in_paths;\n in_paths.push_back(\"path1\");\n in_paths.push_back(\"path2\");\n compiler.set_include_paths(in_paths);\n\n auto out_paths = compiler.include_paths();\n REQUIRE(out_paths.size() == 2);\n REQUIRE(out_paths[0] == \"path1\");\n REQUIRE(out_paths[1] == \"path2\");\n }\n\n SECTION(\"configure style\")\n {\n REQUIRE(compiler.style() == \"\");\n compiler.set_style(\"fluent\");\n REQUIRE(compiler.style() == \"fluent\");\n }\n\n SECTION(\"configure translation domain\")\n {\n // Make sure this compiles.\n compiler.set_translation_domain(\"cpptests\");\n }\n\n SECTION(\"Compile failure from source\")\n {\n auto result = compiler.build_from_source(\"Syntax Error!!\", \"\");\n REQUIRE_FALSE(result.has_value());\n }\n\n SECTION(\"Compile from source\")\n {\n auto result = compiler.build_from_source(\"export component Dummy {}\", \"\");\n REQUIRE(result.has_value());\n }\n\n SECTION(\"Compile failure from path\")\n {\n auto result = compiler.build_from_path(SOURCE_DIR \"/file-not-there.slint\");\n REQUIRE_FALSE(result.has_value());\n auto diags = compiler.diagnostics();\n\n REQUIRE(diags.size() == 1);\n REQUIRE(diags[0].message.starts_with(\"Could not load\"));\n REQUIRE(diags[0].line == 0);\n REQUIRE(diags[0].column == 0);\n }\n\n SECTION(\"Compile from path\")\n {\n auto result = compiler.build_from_path(SOURCE_DIR \"/test.slint\");\n REQUIRE(result.has_value());\n }\n}\n\nSCENARIO(\"Component Definition Properties\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n auto comp_def =\n *compiler.build_from_source(\"export component Dummy { in property test; \"\n \"callback dummy; public function my-fun() {} }\",\n \"\");\n auto properties = comp_def.properties();\n REQUIRE(properties.size() == 1);\n REQUIRE(properties[0].property_name == \"test\");\n REQUIRE(properties[0].property_type == Value::Type::String);\n\n auto callback_names = comp_def.callbacks();\n REQUIRE(callback_names.size() == 1);\n REQUIRE(callback_names[0] == \"dummy\");\n\n auto function_names = comp_def.functions();\n REQUIRE(function_names.size() == 1);\n REQUIRE(function_names[0] == \"my-fun\");\n\n auto instance = comp_def.create();\n ComponentDefinition new_comp_def = instance->definition();\n auto new_props = new_comp_def.properties();\n REQUIRE(new_props.size() == 1);\n REQUIRE(new_props[0].property_name == \"test\");\n REQUIRE(new_props[0].property_type == Value::Type::String);\n}\n\nSCENARIO(\"Component Definition Properties / Two-way bindings\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n auto comp_def = *compiler.build_from_source(\n \"export component Dummy { in-out property test <=> sub_object.test; \"\n \" sub_object := Rectangle { property test; }\"\n \"}\",\n \"\");\n auto properties = comp_def.properties();\n REQUIRE(properties.size() == 1);\n REQUIRE(properties[0].property_name == \"test\");\n REQUIRE(properties[0].property_type == Value::Type::String);\n}\n\nSCENARIO(\"Invoke callback\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n\n SECTION(\"valid\")\n {\n auto result = compiler.build_from_source(\n \"export component Dummy { callback some_callback(string, int) -> string; }\", \"\");\n REQUIRE(result.has_value());\n auto instance = result->create();\n std::string local_string = \"_string_on_the_stack_\";\n REQUIRE(instance->set_callback(\"some_callback\", [local_string](auto args) {\n SharedString arg1 = *args[0].to_string();\n int arg2 = int(*args[1].to_number());\n std::string res = std::string(arg1) + \":\" + std::to_string(arg2) + local_string;\n return Value(SharedString(res));\n }));\n Value args[] = { SharedString(\"Hello\"), 42. };\n auto res = instance->invoke(\"some_callback\", args);\n REQUIRE(res.has_value());\n REQUIRE(*res->to_string() == SharedString(\"Hello:42_string_on_the_stack_\"));\n }\n\n SECTION(\"invalid\")\n {\n auto result = compiler.build_from_source(\n \"export component Dummy { callback foo(string, int) -> string; }\", \"\");\n REQUIRE(result.has_value());\n auto instance = result->create();\n REQUIRE(!instance->set_callback(\"bar\", [](auto) { return Value(); }));\n Value args[] = { SharedString(\"Hello\"), 42. };\n auto res = instance->invoke(\"bar\", args);\n REQUIRE(!res.has_value());\n }\n}\n\nSCENARIO(\"Array between .slint and C++\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n\n auto result = compiler.build_from_source(\n \"export component Dummy { in-out property <[int]> array: [1, 2, 3]; }\", \"\");\n REQUIRE(result.has_value());\n auto instance = result->create();\n\n SECTION(\".slint to C++\")\n {\n auto maybe_array = instance->get_property(\"array\");\n REQUIRE(maybe_array.has_value());\n REQUIRE(maybe_array->type() == Value::Type::Model);\n\n auto array = *maybe_array;\n REQUIRE(array.to_array() == slint::SharedVector { Value(1.), Value(2.), Value(3.) });\n }\n\n SECTION(\"C++ to .slint\")\n {\n slint::SharedVector cpp_array { Value(4.), Value(5.), Value(6.) };\n\n instance->set_property(\"array\", Value(cpp_array));\n auto maybe_array = instance->get_property(\"array\");\n REQUIRE(maybe_array.has_value());\n REQUIRE(maybe_array->type() == Value::Type::Model);\n\n auto actual_array = *maybe_array;\n REQUIRE(actual_array.to_array() == cpp_array);\n }\n}\n\nSCENARIO(\"Angle between .slint and C++\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n\n auto result = compiler.build_from_source(\n \"export component Dummy { in-out property the_angle: \"\n \"0.25turn; out property test: the_angle == 0.5turn; }\",\n \"\");\n REQUIRE(result.has_value());\n auto instance = result->create();\n\n SECTION(\"Read property\")\n {\n auto angle_value = instance->get_property(\"the-angle\");\n REQUIRE(angle_value.has_value());\n REQUIRE(angle_value->type() == Value::Type::Number);\n auto angle = angle_value->to_number();\n REQUIRE(angle.has_value());\n REQUIRE(*angle == 90);\n }\n SECTION(\"Write property\")\n {\n REQUIRE(!*instance->get_property(\"test\")->to_bool());\n bool ok = instance->set_property(\"the_angle\", 180.);\n REQUIRE(ok);\n REQUIRE(*instance->get_property(\"the_angle\")->to_number() == 180);\n REQUIRE(*instance->get_property(\"test\")->to_bool());\n }\n}\n\nSCENARIO(\"Component Definition Name\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n auto comp_def = *compiler.build_from_source(\"export component IHaveAName { }\", \"\");\n REQUIRE(comp_def.name() == \"IHaveAName\");\n}\n\nSCENARIO(\"Send key events\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n auto comp_def = compiler.build_from_source(R\"(\n export component Dummy {\n forward-focus: scope;\n out property result;\n scope := FocusScope {\n key-pressed(event) => {\n if (event.text != Key.Shift && event.text != Key.Control) {\n result += event.text;\n }\n return accept;\n }\n }\n }\n )\",\n \"\");\n REQUIRE(comp_def.has_value());\n auto instance = comp_def->create();\n slint::private_api::testing::send_keyboard_string_sequence(&*instance, \"Hello keys!\");\n REQUIRE(*instance->get_property(\"result\")->to_string() == \"Hello keys!\");\n}\n\nSCENARIO(\"Global properties\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n\n auto result = compiler.build_from_source(\n R\"(\n export global The-Global {\n in-out property the-property: \"€€€\";\n pure callback to_uppercase(string)->string;\n public function ff() -> string { return the-property; }\n }\n export component Dummy {\n out property result: The-Global.to_uppercase(\"abc\");\n }\n )\",\n \"\");\n for (auto &&x : compiler.diagnostics())\n std::cerr << x.message << std::endl;\n REQUIRE(result.has_value());\n auto component_definition = *result;\n\n SECTION(\"Globals introspection\")\n {\n auto globals = component_definition.globals();\n REQUIRE(globals.size() == 1);\n REQUIRE(globals[0] == \"The-Global\");\n\n REQUIRE(!component_definition.global_properties(\"not there\").has_value());\n\n REQUIRE(component_definition.global_properties(\"The_Global\").has_value());\n REQUIRE(component_definition.global_properties(\"The-Global\").has_value());\n\n auto properties = *component_definition.global_properties(\"The-Global\");\n REQUIRE(properties.size() == 1);\n REQUIRE(properties[0].property_name == \"the-property\");\n REQUIRE(properties[0].property_type == Value::Type::String);\n\n auto callbacks = *component_definition.global_callbacks(\"The-Global\");\n REQUIRE(callbacks.size() == 1);\n REQUIRE(callbacks[0] == \"to_uppercase\");\n\n auto functions = *component_definition.global_functions(\"The-Global\");\n REQUIRE(functions.size() == 1);\n REQUIRE(functions[0] == \"ff\");\n }\n\n auto instance = component_definition.create();\n\n SECTION(\"Invalid read\")\n {\n REQUIRE(!instance->get_global_property(\"the - global\", \"the-property\").has_value());\n REQUIRE(!instance->get_global_property(\"The-Global\", \"the property\").has_value());\n }\n SECTION(\"Invalid set\")\n {\n REQUIRE(!instance->set_global_property(\"the - global\", \"the-property\", 5.));\n REQUIRE(!instance->set_global_property(\"The-Global\", \"the property\", 5.));\n REQUIRE(!instance->set_global_property(\"The-Global\", \"the-property\", 5.));\n }\n SECTION(\"get property\")\n {\n auto value = instance->get_global_property(\"The_Global\", \"the-property\");\n REQUIRE(value.has_value());\n REQUIRE(value->to_string().has_value());\n REQUIRE(value->to_string().value() == \"€€€\");\n }\n SECTION(\"set property\")\n {\n REQUIRE(instance->set_global_property(\"The-Global\", \"the-property\", SharedString(\"§§§\")));\n auto value = instance->get_global_property(\"The-Global\", \"the_property\");\n REQUIRE(value.has_value());\n REQUIRE(value->to_string().has_value());\n REQUIRE(value->to_string().value() == \"§§§\");\n }\n SECTION(\"set/invoke callback\")\n {\n REQUIRE(instance->set_global_callback(\"The-Global\", \"to_uppercase\", [](auto args) {\n std::string arg1(*args[0].to_string());\n std::transform(arg1.begin(), arg1.end(), arg1.begin(), toupper);\n return SharedString(arg1);\n }));\n auto result = instance->get_property(\"result\");\n REQUIRE(result.has_value());\n REQUIRE(result->to_string().has_value());\n REQUIRE(result->to_string().value() == \"ABC\");\n\n Value args[] = { SharedString(\"Hello\") };\n auto res = instance->invoke_global(\"The_Global\", \"to-uppercase\", args);\n REQUIRE(res.has_value());\n REQUIRE(*res->to_string() == SharedString(\"HELLO\"));\n }\n SECTION(\"callback errors\")\n {\n REQUIRE(!instance->set_global_callback(\"TheGlobal\", \"to_uppercase\",\n [](auto) { return Value {}; }));\n REQUIRE(!instance->set_global_callback(\"The-Global\", \"touppercase\",\n [](auto) { return Value {}; }));\n REQUIRE(!instance->invoke_global(\"TheGlobal\", \"touppercase\", {}));\n REQUIRE(!instance->invoke_global(\"The-Global\", \"touppercase\", {}));\n }\n SECTION(\"invoke function\")\n {\n REQUIRE(instance->set_global_property(\"The-Global\", \"the-property\", SharedString(\"&&&\")));\n auto res = instance->invoke_global(\"The_Global\", \"ff\", {});\n REQUIRE(res.has_value());\n REQUIRE(*res->to_string() == SharedString(\"&&&\"));\n }\n}\n" }, { "path": "api/cpp/tests/libraries/CMakeLists.txt", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nadd_executable(libraries main.cpp)\ntarget_link_libraries(libraries PRIVATE Slint::Slint)\nslint_target_sources(libraries app-window.slint\n LIBRARY_PATHS\n helper_components=${CMAKE_CURRENT_SOURCE_DIR}/../../../../tests/helper_components/\n helper_buttons=${CMAKE_CURRENT_SOURCE_DIR}/../../../../tests/helper_components/test_button.slint\n)\n\n" }, { "path": "api/cpp/tests/libraries/README.md", "content": "\nThis is a test making sure that slint_target_sources accepts slint component library paths.\n" }, { "path": "api/cpp/tests/libraries/app-window.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { TestButton } from \"@helper_components/test_button.slint\";\nimport { ColorButton } from \"@helper_buttons\";\n\n\nexport component App inherits Window {\n TestButton { }\n\n ColorButton { }\n}\n" }, { "path": "api/cpp/tests/libraries/main.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#include \"app-window.h\"\n\nint main(int argc, char **argv)\n{\n auto my_ui = App::create();\n my_ui->run();\n}\n" }, { "path": "api/cpp/tests/models.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#include \n#include \n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n\nstruct ModelObserver : public slint::private_api::ModelChangeListener\n{\n void row_added(size_t index, size_t count) override\n {\n added_rows.push_back(Range { index, count });\n }\n void row_changed(size_t index) override { changed_rows.push_back(index); }\n void row_removed(size_t index, size_t count) override\n {\n removed_rows.push_back(Range { index, count });\n }\n void reset() override { model_reset = true; }\n\n void clear()\n {\n added_rows.clear();\n changed_rows.clear();\n removed_rows.clear();\n model_reset = false;\n }\n\n struct Range\n {\n size_t row_index;\n size_t count;\n\n bool operator==(const Range &) const = default;\n };\n std::vector added_rows;\n std::vector changed_rows;\n std::vector removed_rows;\n bool model_reset = false;\n};\n\nstd::ostream &operator<<(std::ostream &os, const ModelObserver::Range &value)\n{\n os << \"{ row_index: \" << value.row_index << \"; count: \" << value.count << \" }\";\n return os;\n}\n\nSCENARIO(\"Filtering Model\")\n{\n auto vec_model =\n std::make_shared>(std::vector { 1, 2, 3, 4, 5, 6 });\n\n auto even_rows = std::make_shared>(\n vec_model, [](auto value) { return value % 2 == 0; });\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n REQUIRE(even_rows->row_data(2) == 6);\n}\n\nSCENARIO(\"Filtering Insert\")\n{\n auto vec_model =\n std::make_shared>(std::vector { 1, 2, 3, 4, 5, 6 });\n\n auto even_rows = std::make_shared>(\n vec_model, [](auto value) { return value % 2 == 0; });\n\n auto observer = std::make_shared();\n even_rows->attach_peer(observer);\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n REQUIRE(even_rows->row_data(2) == 6);\n\n vec_model->insert(2, 10);\n\n REQUIRE(observer->added_rows.size() == 1);\n REQUIRE(observer->added_rows[0] == ModelObserver::Range { 1, 1 });\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(even_rows->row_count() == 4);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 10);\n REQUIRE(even_rows->row_data(2) == 4);\n REQUIRE(even_rows->row_data(3) == 6);\n\n // insert odd number -> no change\n vec_model->insert(0, 1);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n}\n\nSCENARIO(\"Filtering Change\")\n{\n auto vec_model =\n std::make_shared>(std::vector { 1, 2, 3, 4, 5, 6 });\n\n auto even_rows = std::make_shared>(\n vec_model, [](auto value) { return value % 2 == 0; });\n\n auto observer = std::make_shared();\n even_rows->attach_peer(observer);\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n REQUIRE(even_rows->row_data(2) == 6);\n\n // change leading odd 1 to odd 3 -> no change\n vec_model->set_row_data(0, 3);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n REQUIRE(even_rows->row_data(2) == 6);\n\n // change trailing 6 to odd 1 -> one row less\n vec_model->set_row_data(5, 1);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.size() == 1);\n REQUIRE(observer->removed_rows[0] == ModelObserver::Range { 2, 1 });\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(even_rows->row_count() == 2);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n\n // change leading odd 3 to even 0 -> one new row\n vec_model->set_row_data(0, 0);\n\n REQUIRE(observer->added_rows.size() == 1);\n REQUIRE(observer->added_rows[0] == ModelObserver::Range { 0, 1 });\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 0);\n REQUIRE(even_rows->row_data(1) == 2);\n REQUIRE(even_rows->row_data(2) == 4);\n\n // change trailing filtered 4 to even 0 -> one changed row\n vec_model->set_row_data(3, 0);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.size() == 1);\n REQUIRE(observer->changed_rows[0] == 2);\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 0);\n REQUIRE(even_rows->row_data(1) == 2);\n REQUIRE(even_rows->row_data(2) == 0);\n}\n\nSCENARIO(\"Filtering Model Remove\")\n{\n auto vec_model =\n std::make_shared>(std::vector { 1, 2, 3, 4, 5, 6 });\n\n auto even_rows = std::make_shared>(\n vec_model, [](auto value) { return value % 2 == 0; });\n\n auto observer = std::make_shared();\n even_rows->attach_peer(observer);\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n REQUIRE(even_rows->row_data(2) == 6);\n\n // Erase unrelated row\n vec_model->erase(0);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n REQUIRE(even_rows->row_data(2) == 6);\n\n // Erase trailing even 6\n vec_model->erase(4);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.size() == 1);\n REQUIRE(observer->removed_rows[0] == ModelObserver::Range { 2, 1 });\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(even_rows->row_count() == 2);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n}\n\nSCENARIO(\"Filtering Model Reset\")\n{\n auto vec_model =\n std::make_shared>(std::vector { 1, 2, 3, 4, 5, 6 });\n\n bool even = true;\n\n auto even_rows = std::make_shared>(\n vec_model, [&even](auto value) { return value % 2 == !even; });\n\n auto observer = std::make_shared();\n even_rows->attach_peer(observer);\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 2);\n REQUIRE(even_rows->row_data(1) == 4);\n REQUIRE(even_rows->row_data(2) == 6);\n\n even = false;\n even_rows->reset();\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(observer->model_reset);\n observer->clear();\n\n REQUIRE(even_rows->row_count() == 3);\n REQUIRE(even_rows->row_data(0) == 1);\n REQUIRE(even_rows->row_data(1) == 3);\n REQUIRE(even_rows->row_data(2) == 5);\n}\n\ntemplate\nclass TestDeferredFilterModel : public slint::FilterModel\n{\npublic:\n TestDeferredFilterModel(bool &initialized, bool &filtered,\n std::shared_ptr> source_model)\n : slint::FilterModel { std::move(source_model),\n [&filtered]([[maybe_unused]] const ModelData &) {\n if (!filtered) {\n filtered = true;\n }\n return true;\n } }\n {\n initialized = true;\n }\n};\n\nSCENARIO(\"Filtering Model Ensure Deferred\")\n{\n auto source_model =\n std::make_shared>(std::vector { 0, 1, 2, 3, 4 });\n\n bool initialized = false;\n bool filtered = false;\n\n auto filter_model =\n std::make_shared>(initialized, filtered, source_model);\n REQUIRE(initialized);\n REQUIRE_FALSE(filtered);\n\n filter_model->row_data(0);\n REQUIRE(filtered);\n}\n\nSCENARIO(\"Mapped Model\")\n{\n auto vec_model = std::make_shared>(std::vector { 1, 2, 3, 4 });\n\n int to_add = 1;\n\n auto plus_one_model = std::make_shared>(\n vec_model, [&to_add](auto value) { return value + to_add; });\n\n auto observer = std::make_shared();\n plus_one_model->attach_peer(observer);\n\n REQUIRE(plus_one_model->row_count() == 4);\n REQUIRE(plus_one_model->row_data(0) == 2);\n REQUIRE(plus_one_model->row_data(1) == 3);\n REQUIRE(plus_one_model->row_data(2) == 4);\n REQUIRE(plus_one_model->row_data(3) == 5);\n\n vec_model->insert(0, 100);\n\n REQUIRE(observer->added_rows.size() == 1);\n REQUIRE(observer->added_rows[0] == ModelObserver::Range { 0, 1 });\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(plus_one_model->row_count() == 5);\n REQUIRE(plus_one_model->row_data(0) == 101);\n REQUIRE(plus_one_model->row_data(1) == 2);\n REQUIRE(plus_one_model->row_data(2) == 3);\n REQUIRE(plus_one_model->row_data(3) == 4);\n REQUIRE(plus_one_model->row_data(4) == 5);\n\n vec_model->set_row_data(1, 3);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.size() == 1);\n REQUIRE(observer->changed_rows[0] == 1);\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(plus_one_model->row_count() == 5);\n REQUIRE(plus_one_model->row_data(0) == 101);\n REQUIRE(plus_one_model->row_data(1) == 4);\n REQUIRE(plus_one_model->row_data(2) == 3);\n REQUIRE(plus_one_model->row_data(3) == 4);\n REQUIRE(plus_one_model->row_data(4) == 5);\n\n vec_model->erase(3);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.size() == 1);\n REQUIRE(observer->removed_rows[0] == ModelObserver::Range { 3, 1 });\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(plus_one_model->row_count() == 4);\n REQUIRE(plus_one_model->row_data(0) == 101);\n REQUIRE(plus_one_model->row_data(1) == 4);\n REQUIRE(plus_one_model->row_data(2) == 3);\n REQUIRE(plus_one_model->row_data(3) == 5);\n\n to_add = 51;\n plus_one_model->reset();\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(observer->model_reset);\n observer->clear();\n\n REQUIRE(plus_one_model->row_count() == 4);\n REQUIRE(plus_one_model->row_data(0) == 151);\n REQUIRE(plus_one_model->row_data(1) == 54);\n REQUIRE(plus_one_model->row_data(2) == 53);\n REQUIRE(plus_one_model->row_data(3) == 55);\n}\n\nSCENARIO(\"Sorted Model Insert\")\n{\n auto vec_model = std::make_shared>(std::vector { 3, 4, 1, 2 });\n\n auto sorted_model = std::make_shared>(\n vec_model, [](auto lhs, auto rhs) { return lhs < rhs; });\n\n auto observer = std::make_shared();\n sorted_model->attach_peer(observer);\n\n REQUIRE(sorted_model->row_count() == 4);\n REQUIRE(sorted_model->row_data(0) == 1);\n REQUIRE(sorted_model->row_data(1) == 2);\n REQUIRE(sorted_model->row_data(2) == 3);\n REQUIRE(sorted_model->row_data(3) == 4);\n\n vec_model->insert(0, 10);\n\n REQUIRE(observer->added_rows.size() == 1);\n REQUIRE(observer->added_rows[0] == ModelObserver::Range { 4, 1 });\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(sorted_model->row_count() == 5);\n REQUIRE(sorted_model->row_data(0) == 1);\n REQUIRE(sorted_model->row_data(1) == 2);\n REQUIRE(sorted_model->row_data(2) == 3);\n REQUIRE(sorted_model->row_data(3) == 4);\n REQUIRE(sorted_model->row_data(4) == 10);\n}\n\nSCENARIO(\"Sorted Model Remove\")\n{\n auto vec_model = std::make_shared>(std::vector { 3, 4, 1, 2 });\n\n auto sorted_model = std::make_shared>(\n vec_model, [](auto lhs, auto rhs) { return lhs < rhs; });\n\n auto observer = std::make_shared();\n sorted_model->attach_peer(observer);\n\n REQUIRE(sorted_model->row_count() == 4);\n REQUIRE(sorted_model->row_data(0) == 1);\n REQUIRE(sorted_model->row_data(1) == 2);\n REQUIRE(sorted_model->row_data(2) == 3);\n REQUIRE(sorted_model->row_data(3) == 4);\n\n /// Remove the entry with the value 4\n vec_model->erase(1);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.size() == 1);\n REQUIRE(observer->removed_rows[0] == ModelObserver::Range { 3, 1 });\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(sorted_model->row_count() == 3);\n REQUIRE(sorted_model->row_data(0) == 1);\n REQUIRE(sorted_model->row_data(1) == 2);\n REQUIRE(sorted_model->row_data(2) == 3);\n}\n\nSCENARIO(\"Sorted Model Change\")\n{\n auto vec_model = std::make_shared>(std::vector { 3, 4, 1, 2 });\n\n auto sorted_model = std::make_shared>(\n vec_model, [](auto lhs, auto rhs) { return lhs < rhs; });\n\n auto observer = std::make_shared();\n sorted_model->attach_peer(observer);\n\n REQUIRE(sorted_model->row_count() == 4);\n REQUIRE(sorted_model->row_data(0) == 1);\n REQUIRE(sorted_model->row_data(1) == 2);\n REQUIRE(sorted_model->row_data(2) == 3);\n REQUIRE(sorted_model->row_data(3) == 4);\n\n /// Change the entry with the value 4 to 10 -> maintain order\n vec_model->set_row_data(1, 10);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.size() == 1);\n REQUIRE(observer->changed_rows[0] == 3);\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(sorted_model->row_count() == 4);\n REQUIRE(sorted_model->row_data(0) == 1);\n REQUIRE(sorted_model->row_data(1) == 2);\n REQUIRE(sorted_model->row_data(2) == 3);\n REQUIRE(sorted_model->row_data(3) == 10);\n\n /// Change the entry with the value 10 to 0 -> new order with remove and insert\n vec_model->set_row_data(1, 0);\n\n REQUIRE(observer->added_rows.size() == 1);\n REQUIRE(observer->added_rows[0] == ModelObserver::Range { 0, 1 });\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.size() == 1);\n REQUIRE(observer->removed_rows[0] == ModelObserver::Range { 3, 1 });\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(sorted_model->row_count() == 4);\n REQUIRE(sorted_model->row_data(0) == 0);\n REQUIRE(sorted_model->row_data(1) == 1);\n REQUIRE(sorted_model->row_data(2) == 2);\n REQUIRE(sorted_model->row_data(3) == 3);\n}\n\nSCENARIO(\"Sorted Model Reset\")\n{\n auto vec_model = std::make_shared>(std::vector { 3, 4, 1, 2 });\n\n bool ascending = true;\n\n auto sorted_model =\n std::make_shared>(vec_model, [&ascending](auto lhs, auto rhs) {\n return ascending ? lhs < rhs : rhs < lhs;\n });\n\n auto observer = std::make_shared();\n sorted_model->attach_peer(observer);\n\n REQUIRE(sorted_model->row_count() == 4);\n REQUIRE(sorted_model->row_data(0) == 1);\n REQUIRE(sorted_model->row_data(1) == 2);\n REQUIRE(sorted_model->row_data(2) == 3);\n REQUIRE(sorted_model->row_data(3) == 4);\n\n ascending = false;\n sorted_model->reset();\n\n REQUIRE(sorted_model->row_count() == 4);\n REQUIRE(sorted_model->row_data(0) == 4);\n REQUIRE(sorted_model->row_data(1) == 3);\n REQUIRE(sorted_model->row_data(2) == 2);\n REQUIRE(sorted_model->row_data(3) == 1);\n\n REQUIRE(observer->model_reset);\n}\n\ntemplate\nclass TestDeferredSortModel : public slint::SortModel\n{\npublic:\n TestDeferredSortModel(bool &initialized, bool &sorted,\n std::shared_ptr> source_model)\n : slint::SortModel { std::move(source_model),\n [&sorted](const ModelData &first, const ModelData &second) {\n if (!sorted) {\n sorted = true;\n }\n return first > second;\n } }\n {\n initialized = true;\n }\n};\n\nSCENARIO(\"Sorted Model Ensure Deferred\")\n{\n auto source_model =\n std::make_shared>(std::vector { 0, 1, 2, 3, 4 });\n\n bool initialized = false;\n bool sorted = false;\n\n auto sort_model =\n std::make_shared>(initialized, sorted, source_model);\n REQUIRE(initialized);\n REQUIRE_FALSE(sorted);\n\n sort_model->row_data(0);\n REQUIRE(sorted);\n}\n\nSCENARIO(\"Reverse Model Insert\")\n{\n auto vec_model = std::make_shared>(std::vector { 3, 4, 1, 2 });\n\n auto reverse_model = std::make_shared>(vec_model);\n\n auto observer = std::make_shared();\n reverse_model->attach_peer(observer);\n\n REQUIRE(reverse_model->row_count() == 4);\n REQUIRE(reverse_model->row_data(0) == 2);\n REQUIRE(reverse_model->row_data(1) == 1);\n REQUIRE(reverse_model->row_data(2) == 4);\n REQUIRE(reverse_model->row_data(3) == 3);\n\n vec_model->insert(0, 10);\n\n REQUIRE(observer->added_rows.size() == 1);\n REQUIRE(observer->added_rows[0] == ModelObserver::Range { 4, 1 });\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(reverse_model->row_count() == 5);\n REQUIRE(reverse_model->row_data(0) == 2);\n REQUIRE(reverse_model->row_data(1) == 1);\n REQUIRE(reverse_model->row_data(2) == 4);\n REQUIRE(reverse_model->row_data(3) == 3);\n REQUIRE(reverse_model->row_data(4) == 10);\n}\n\nSCENARIO(\"Reverse Model Remove\")\n{\n auto vec_model = std::make_shared>(std::vector { 3, 4, 1, 2 });\n\n auto reverse_model = std::make_shared>(vec_model);\n\n auto observer = std::make_shared();\n reverse_model->attach_peer(observer);\n\n REQUIRE(reverse_model->row_count() == 4);\n REQUIRE(reverse_model->row_data(0) == 2);\n REQUIRE(reverse_model->row_data(1) == 1);\n REQUIRE(reverse_model->row_data(2) == 4);\n REQUIRE(reverse_model->row_data(3) == 3);\n\n /// Remove the entry with the value 4\n vec_model->erase(1);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.size() == 1);\n REQUIRE(observer->removed_rows[0] == ModelObserver::Range { 2, 1 });\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(reverse_model->row_count() == 3);\n REQUIRE(reverse_model->row_data(0) == 2);\n REQUIRE(reverse_model->row_data(1) == 1);\n REQUIRE(reverse_model->row_data(2) == 3);\n}\n\nSCENARIO(\"Reverse Model Change\")\n{\n auto vec_model = std::make_shared>(std::vector { 3, 4, 1, 2 });\n\n auto reverse_model = std::make_shared>(vec_model);\n\n auto observer = std::make_shared();\n reverse_model->attach_peer(observer);\n\n REQUIRE(reverse_model->row_count() == 4);\n REQUIRE(reverse_model->row_data(0) == 2);\n REQUIRE(reverse_model->row_data(1) == 1);\n REQUIRE(reverse_model->row_data(2) == 4);\n REQUIRE(reverse_model->row_data(3) == 3);\n\n /// Change the entry with the value 4 to 10 -> maintain order\n vec_model->set_row_data(1, 10);\n\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.size() == 1);\n REQUIRE(observer->changed_rows[0] == 2);\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n REQUIRE(reverse_model->row_count() == 4);\n REQUIRE(reverse_model->row_data(0) == 2);\n REQUIRE(reverse_model->row_data(1) == 1);\n REQUIRE(reverse_model->row_data(2) == 10);\n REQUIRE(reverse_model->row_data(3) == 3);\n\n vec_model->clear();\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(observer->model_reset);\n observer->clear();\n\n REQUIRE(reverse_model->row_count() == 0);\n}\n\nTEST_CASE(\"VectorModel clear and replace\")\n{\n using namespace slint::private_api;\n\n auto model = std::make_shared>(std::vector { 0, 1, 2, 3, 4 });\n\n auto observer = std::make_shared();\n model->attach_peer(observer);\n\n REQUIRE(model->row_count() == 5);\n model->clear();\n REQUIRE(model->row_count() == 0);\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(observer->model_reset);\n observer->clear();\n\n model->clear();\n REQUIRE(!observer->model_reset);\n observer->clear();\n\n model->set_vector({ 2, 3, 4 });\n REQUIRE(model->row_count() == 3);\n REQUIRE(model->row_data(1) == 3);\n REQUIRE(observer->added_rows.empty());\n REQUIRE(observer->changed_rows.empty());\n REQUIRE(observer->removed_rows.empty());\n REQUIRE(observer->model_reset);\n\n // Test that taking a vector by value compiles\n std::vector new_data { 5, 6, 7, 8 };\n model->set_vector(new_data);\n}\n" }, { "path": "api/cpp/tests/multiple-includes/CMakeLists.txt", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nadd_executable(multiple-includes main.cpp logic.cpp)\ntarget_link_libraries(multiple-includes PRIVATE Slint::Slint)\nslint_target_sources(multiple-includes app-window.slint COMPILATION_UNITS 0)\nslint_target_sources(multiple-includes another-window.slint NAMESPACE other COMPILATION_UNITS 0)\n\n" }, { "path": "api/cpp/tests/multiple-includes/README.md", "content": "\nThis is a test making sure that the header can be included in several compilation without causing multiple definitions\n\nAnd also that we can include two different generated headers generated different namespaces in the same compilation unit\n" }, { "path": "api/cpp/tests/multiple-includes/another-window.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport {Button, AboutSlint} from \"std-widgets.slint\";\n\nexport global Logic {\n callback decrement(int) -> int;\n}\n\nexport struct FooBar {\n qrs: int, tuv: string\n}\n\n\nexport component AnotherWindow inherits Window {\n preferred-width: 800px;\n preferred-height: 600px;\n property count: 100;\n in property xxx;\n\n VerticalLayout {\n AboutSlint { }\n Button {\n text: \"Hello\";\n clicked => { count = Logic.decrement(count); }\n }\n Text { text: count; }\n }\n}\n" }, { "path": "api/cpp/tests/multiple-includes/app-window.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport {Button, AboutSlint} from \"std-widgets.slint\";\n\nexport global Logic {\n callback increment(int) -> int;\n}\n\nexport struct FooBar {\n abc: int, def: string\n}\n\ncomponent R {\n property foo;\n Rectangle {\n TouchArea {}\n }\n}\n\nexport component App inherits Window {\n preferred-width: 800px;\n preferred-height: 600px;\n property count;\n\n VerticalLayout {\n AboutSlint { }\n Button {\n text: \"Hello\";\n clicked => { count = Logic.increment(count); }\n }\n Text { text: count; }\n R { }\n }\n}\n" }, { "path": "api/cpp/tests/multiple-includes/logic.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#include \"logic.h\"\n#include \"app-window.h\"\n// Test that it's ok to include twice\n#include \"app-window.h\"\n\nvoid setup_logic(const Logic &logic)\n{\n logic.on_increment([](int x) { return x + 1; });\n}" }, { "path": "api/cpp/tests/multiple-includes/logic.h", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#pragma once\n\nstruct Logic;\n\nvoid setup_logic(const Logic &);\n" }, { "path": "api/cpp/tests/multiple-includes/main.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#include \"logic.h\"\n#include \"app-window.h\"\n#include \"another-window.h\"\n\nint main(int argc, char **argv)\n{\n auto my_ui = App::create();\n setup_logic(my_ui->global());\n\n auto my_ui2 = other::AnotherWindow::create();\n my_ui2->global().on_decrement([](int x) { return x - 1; });\n my_ui2->show();\n\n my_ui->run();\n}\n" }, { "path": "api/cpp/tests/platform_eventloop.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n// cSpell: ignore singleshot\n\n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n\nstruct TestPlatform : slint::platform::Platform\n{\n std::mutex the_mutex;\n std::deque queue;\n bool quit = false;\n std::condition_variable cv;\n std::chrono::time_point start = std::chrono::steady_clock::now();\n\n /// Returns a new WindowAdapter\n virtual std::unique_ptr create_window_adapter() override\n {\n#ifdef SLINT_FEATURE_RENDERER_SOFTWARE\n struct TestWindowAdapter : slint::platform::WindowAdapter\n {\n slint::platform::SoftwareRenderer r { { } };\n slint::PhysicalSize size() override { return slint::PhysicalSize({ 0, 0 }); }\n slint::platform::AbstractRenderer &renderer() override { return r; }\n };\n return std::make_unique();\n#else\n assert(!\"creating window in this test\");\n return nullptr;\n#endif\n };\n\n /// Spins an event loop and renders the visible windows.\n virtual void run_event_loop() override\n {\n quit = false;\n while (true) {\n slint::platform::update_timers_and_animations();\n std::optional event;\n {\n std::unique_lock lock(the_mutex);\n if (queue.empty()) {\n if (quit) {\n quit = false;\n break;\n }\n if (auto duration = slint::platform::duration_until_next_timer_update()) {\n cv.wait_for(lock, *duration);\n } else {\n cv.wait(lock);\n }\n continue;\n } else {\n event = std::move(queue.front());\n queue.pop_front();\n }\n }\n if (event) {\n std::move(*event).run();\n event.reset();\n }\n }\n }\n\n virtual void quit_event_loop() override\n {\n const std::unique_lock lock(the_mutex);\n quit = true;\n cv.notify_all();\n }\n\n virtual void run_in_event_loop(slint::platform::Platform::Task event) override\n {\n const std::unique_lock lock(the_mutex);\n queue.push_back(std::move(event));\n cv.notify_all();\n }\n\n#ifdef SLINT_FEATURE_FREESTANDING\n virtual std::chrono::milliseconds duration_since_start() override\n {\n return std::chrono::duration_cast(\n std::chrono::steady_clock::now() - start);\n }\n#endif\n};\n\nbool init_platform = (slint::platform::set_platform(std::make_unique()), true);\n\nTEST_CASE(\"C++ Singleshot Timers\")\n{\n using namespace slint;\n int called = 0;\n Timer testTimer(std::chrono::milliseconds(16), [&]() {\n slint::quit_event_loop();\n called += 10;\n });\n REQUIRE(called == 0);\n slint::run_event_loop();\n REQUIRE(called == 10);\n}\n\nTEST_CASE(\"C++ Repeated Timer\")\n{\n int timer_triggered = 0;\n slint::Timer timer;\n\n timer.start(slint::TimerMode::Repeated, std::chrono::milliseconds(3),\n [&]() { timer_triggered++; });\n\n REQUIRE(timer_triggered == 0);\n\n bool timer_was_running = false;\n\n slint::Timer::single_shot(std::chrono::milliseconds(100), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered > 1);\n REQUIRE(timer_was_running);\n}\n\nTEST_CASE(\"C++ Restart Singleshot Timer\")\n{\n int timer_triggered = 0;\n slint::Timer timer;\n\n timer.start(slint::TimerMode::SingleShot, std::chrono::milliseconds(3),\n [&]() { timer_triggered++; });\n REQUIRE(timer.running());\n\n REQUIRE(timer_triggered == 0);\n\n bool timer_was_running = true;\n\n slint::Timer::single_shot(std::chrono::milliseconds(50), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered == 1);\n REQUIRE(!timer_was_running); // Timer is already stopped at this point\n\n timer_was_running = true;\n timer_triggered = 0;\n timer.restart();\n REQUIRE(timer.running());\n slint::Timer::single_shot(std::chrono::milliseconds(50), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered == 1);\n REQUIRE(!timer_was_running);\n}\n\nTEST_CASE(\"C++ Restart Repeated Timer\")\n{\n int timer_triggered = 0;\n slint::Timer timer;\n\n timer.start(slint::TimerMode::Repeated, std::chrono::milliseconds(3),\n [&]() { timer_triggered++; });\n\n REQUIRE(timer_triggered == 0);\n\n bool timer_was_running = false;\n\n slint::Timer::single_shot(std::chrono::milliseconds(50), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered > 1);\n REQUIRE(timer_was_running);\n\n timer_was_running = false;\n timer_triggered = 0;\n timer.stop();\n slint::Timer::single_shot(std::chrono::milliseconds(50), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered == 0);\n REQUIRE(!timer_was_running);\n\n timer_was_running = false;\n timer_triggered = 0;\n\n timer.restart();\n\n slint::Timer::single_shot(std::chrono::milliseconds(50), [&]() {\n timer_was_running = timer.running();\n slint::quit_event_loop();\n });\n\n slint::run_event_loop();\n\n REQUIRE(timer_triggered > 1);\n REQUIRE(timer_was_running);\n}\n\nTEST_CASE(\"Quit from event\")\n{\n int called = 0;\n slint::invoke_from_event_loop([&] {\n slint::quit_event_loop();\n called += 10;\n });\n REQUIRE(called == 0);\n slint::run_event_loop();\n REQUIRE(called == 10);\n}\n\nTEST_CASE(\"Event from thread\")\n{\n std::atomic called = 0;\n auto t = std::thread([&] {\n called += 10;\n slint::invoke_from_event_loop([&] {\n called += 100;\n slint::quit_event_loop();\n });\n });\n\n slint::run_event_loop();\n REQUIRE(called == 110);\n t.join();\n}\n\nTEST_CASE(\"Blocking Event from thread\")\n{\n std::atomic called = 0;\n auto t = std::thread([&] {\n // test returning a, unique_ptr because it is movable-only\n std::unique_ptr foo =\n slint::blocking_invoke_from_event_loop([&] { return std::make_unique(42); });\n called = *foo;\n int xxx = 123;\n slint::blocking_invoke_from_event_loop([&] {\n slint::quit_event_loop();\n xxx = 888999;\n });\n REQUIRE(xxx == 888999);\n });\n\n slint::run_event_loop();\n REQUIRE(called == 42);\n t.join();\n}\n\n#if defined(SLINT_FEATURE_INTERPRETER) && defined(SLINT_FEATURE_RENDERER_SOFTWARE)\n\n# include \n\nTEST_CASE(\"Quit on last window closed\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n int ok = 0;\n\n ComponentCompiler compiler;\n auto comp_def = compiler.build_from_source(\"export component App inherits Window { }\", \"\");\n REQUIRE(comp_def.has_value());\n auto instance = comp_def->create();\n instance->hide(); // hide before show should mess the counter\n REQUIRE(instance->window().is_visible() == false);\n instance->show();\n REQUIRE(instance->window().is_visible() == true);\n\n slint::Timer::single_shot(std::chrono::milliseconds(10), [&]() {\n REQUIRE(instance->window().is_visible() == true);\n instance->hide();\n REQUIRE(instance->window().is_visible() == false);\n ok = 1;\n slint::Timer::single_shot(std::chrono::milliseconds(0), [&]() {\n // event loop should be stopped\n ok = -1;\n });\n });\n slint::run_event_loop();\n REQUIRE(ok == 1);\n REQUIRE(instance->window().is_visible() == false);\n\n ok = 0;\n slint::Timer::single_shot(std::chrono::milliseconds(5), [&]() {\n REQUIRE(ok == -1); // the event we started previously should have been ran first\n ok = 1;\n REQUIRE(instance->window().is_visible() == false);\n instance->show();\n instance->show(); // two show shouldn't make the loop alive\n slint::Timer::single_shot(std::chrono::milliseconds(0), [&]() {\n REQUIRE(instance->window().is_visible() == true);\n instance->hide();\n ok = 2;\n slint::Timer::single_shot(std::chrono::milliseconds(0), [&]() {\n // event loop should be stopped\n ok = -2;\n });\n });\n });\n slint::run_event_loop();\n REQUIRE(ok == 2);\n\n ok = 0;\n auto instance2 = comp_def->create();\n instance2->show();\n slint::Timer::single_shot(std::chrono::milliseconds(5), [&]() {\n REQUIRE(ok == -2); // the event we started previously should have been ran first\n instance->show();\n instance2->hide();\n slint::Timer::single_shot(std::chrono::milliseconds(0), [&]() {\n instance2->show();\n instance->hide();\n slint::Timer::single_shot(std::chrono::milliseconds(0), [&]() {\n instance2->hide();\n ok = 3;\n });\n });\n });\n slint::run_event_loop();\n REQUIRE(ok == 3);\n ok = 0;\n slint::Timer::single_shot(std::chrono::milliseconds(0), [&]() {\n REQUIRE(ok == 0);\n instance->show();\n slint::Timer::single_shot(std::chrono::milliseconds(0), [&]() {\n instance2->hide();\n instance->hide();\n slint::Timer::single_shot(std::chrono::milliseconds(0), [&]() {\n instance2->show();\n slint::quit_event_loop();\n ok = 4;\n });\n });\n });\n slint::run_event_loop(slint::EventLoopMode::RunUntilQuit);\n\n REQUIRE(ok == 4);\n}\n\n#endif\n" }, { "path": "api/cpp/tests/properties.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#include \n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n#include \n\nusing slint::private_api::Property;\n\nSCENARIO(\"Basic usage\")\n{\n Property prop;\n REQUIRE(prop.get() == 0);\n\n prop.set(42);\n REQUIRE(prop.get() == 42);\n\n {\n Property prop2;\n prop2.set_binding([&] { return prop.get() + 4; });\n REQUIRE(prop2.get() == 42 + 4);\n prop.set(55);\n REQUIRE(prop2.get() == 55 + 4);\n }\n\n REQUIRE(prop.get() == 55);\n prop.set(33);\n REQUIRE(prop.get() == 33);\n}\n\nSCENARIO(\"Set after binding\")\n{\n Property prop;\n REQUIRE(prop.get() == 0);\n prop.set_binding([] { return 55; });\n prop.set(0);\n REQUIRE(prop.get() == 0);\n}\n" }, { "path": "api/cpp/tests/test.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nexport componentTest := Rectangle {}\n" }, { "path": "api/cpp/tests/testing.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n#include \n#include \n\nSCENARIO(\"ElementHandle\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n\n auto result = compiler.build_from_source(\n R\"(\n component ButtonBase {\n @children\n }\n component PushButton inherits ButtonBase {\n accessible-role: button;\n in property text <=> label.text;\n label := Text {}\n }\n export component App {\n VerticalLayout {\n PushButton { text: \"first\"; }\n second := PushButton { text: \"second\"; }\n }\n }\n )\",\n \"\");\n for (auto &&x : compiler.diagnostics())\n std::cerr << x.message << std::endl;\n REQUIRE(result.has_value());\n auto component_definition = *result;\n\n auto instance = component_definition.create();\n\n SECTION(\"Find by accessible label\")\n {\n auto elements = slint::testing::ElementHandle::find_by_accessible_label(instance, \"first\");\n REQUIRE(elements.size() == 1);\n REQUIRE(*elements[0].accessible_label() == \"first\");\n REQUIRE(*elements[0].id() == \"PushButton::label\");\n REQUIRE(*elements[0].type_name() == \"Text\");\n REQUIRE((*elements[0].bases()).size() == 0);\n }\n\n SECTION(\"Find by id\")\n {\n auto elements = slint::testing::ElementHandle::find_by_element_id(instance, \"App::second\");\n REQUIRE(elements.size() == 1);\n REQUIRE(*elements[0].id() == \"App::second\");\n REQUIRE(*elements[0].type_name() == \"PushButton\");\n REQUIRE((*elements[0].bases()).size() == 1);\n REQUIRE((*elements[0].bases())[0] == \"ButtonBase\");\n REQUIRE(*elements[0].accessible_role() == slint::testing::AccessibleRole::Button);\n }\n\n SECTION(\"Find by type name\")\n {\n auto elements =\n slint::testing::ElementHandle::find_by_element_type_name(instance, \"PushButton\");\n REQUIRE(elements.size() == 2);\n REQUIRE(*elements[0].id() == \"\");\n REQUIRE(*elements[1].id() == \"App::second\");\n }\n}\n\nSCENARIO(\"LayoutKind\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n\n auto result = compiler.build_from_source(\n R\"(\n export component App {\n hl := HorizontalLayout {\n vl := VerticalLayout {\n Rectangle {}\n }\n }\n gl := GridLayout {\n Rectangle {}\n }\n rect := Rectangle {}\n }\n )\",\n \"\");\n REQUIRE(result.has_value());\n auto component_definition = *result;\n\n auto instance = component_definition.create();\n\n SECTION(\"HorizontalLayout\")\n {\n auto elements = slint::testing::ElementHandle::find_by_element_id(instance, \"App::hl\");\n REQUIRE(elements.size() == 1);\n const auto lk = elements[0].layout_kind();\n REQUIRE(lk.has_value());\n REQUIRE(*lk == slint::testing::LayoutKind::HorizontalLayout);\n REQUIRE(*elements[0].type_name() == \"HorizontalLayout\");\n }\n\n SECTION(\"VerticalLayout nested in HorizontalLayout\")\n {\n auto elements = slint::testing::ElementHandle::find_by_element_id(instance, \"App::vl\");\n REQUIRE(elements.size() == 1);\n REQUIRE(*elements[0].layout_kind() == slint::testing::LayoutKind::VerticalLayout);\n }\n\n SECTION(\"GridLayout\")\n {\n auto elements = slint::testing::ElementHandle::find_by_element_id(instance, \"App::gl\");\n REQUIRE(elements.size() == 1);\n REQUIRE(*elements[0].layout_kind() == slint::testing::LayoutKind::GridLayout);\n }\n\n SECTION(\"Non-layout element\")\n {\n auto elements = slint::testing::ElementHandle::find_by_element_id(instance, \"App::rect\");\n REQUIRE(elements.size() == 1);\n REQUIRE_FALSE(elements[0].layout_kind().has_value());\n }\n}\n" }, { "path": "api/cpp/tests/translator.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n\n#include \n\nstatic int destructor_call_count = 0;\n\nstruct TestTranslator : public slint::Translator\n{\n ~TestTranslator() { ++destructor_call_count; }\n\n slint::SharedString translate(std::string_view string, std::string_view context) const override\n {\n return slint::SharedString(\"translate(string=\") + string + \", context=\" + context + \")\";\n }\n\n slint::SharedString ntranslate(uint64_t n, std::string_view singular, std::string_view plural,\n std::string_view context) const override\n {\n return slint::SharedString(\"ntranslate(n=\") + slint::SharedString::from_number(n)\n + \", singular=\" + singular + \", plural=\" + plural + \", context=\" + context + \")\";\n }\n};\n\nTEST_CASE(\"Translate Properties\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n auto comp_def = compiler.build_from_source(R\"(\n export App := Window {\n out property singular: @tr(\"singular\");\n out property plural: @tr(\"singular\" | \"plural-{n}\" % 42);\n }\n )\",\n \"\");\n REQUIRE(comp_def.has_value());\n auto instance = comp_def->create();\n REQUIRE(instance->get_property(\"singular\").has_value());\n REQUIRE(instance->get_property(\"plural\").has_value());\n\n // Check before registering a translator, should return the original string.\n REQUIRE(*instance->get_property(\"singular\")->to_string() == \"singular\");\n REQUIRE(*instance->get_property(\"plural\")->to_string() == \"plural-42\");\n\n // Registering a translator should automatically update the properties.\n slint::set_translator(std::make_unique());\n REQUIRE(*instance->get_property(\"singular\")->to_string()\n == \"translate(string=singular, context=App)\");\n REQUIRE(*instance->get_property(\"plural\")->to_string()\n == \"ntranslate(n=42, singular=singular, plural=plural-42, context=App)\");\n\n // Unregistering the translator should restore the untranslated strings.\n slint::set_translator(nullptr);\n REQUIRE(*instance->get_property(\"singular\")->to_string() == \"singular\");\n REQUIRE(*instance->get_property(\"plural\")->to_string() == \"plural-42\");\n}\n\nTEST_CASE(\"Set/Unset Translator\")\n{\n destructor_call_count = 0;\n\n // Set nullptr should be allowed but has no effect.\n slint::set_translator(nullptr);\n\n // Registering a translator should not call the destructor.\n slint::set_translator(std::make_unique());\n REQUIRE(destructor_call_count == 0);\n\n // Registering another translator should destroy the first translator.\n slint::set_translator(std::make_unique());\n REQUIRE(destructor_call_count == 1);\n\n // Unregistering the translator should destroy the second translator.\n slint::set_translator(nullptr);\n REQUIRE(destructor_call_count == 2);\n}\n" }, { "path": "api/cpp/tests/window.cpp", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#define CATCH_CONFIG_MAIN\n#include \"catch2/catch_all.hpp\"\n\n#include \n#include \n\n#include \n\nTEST_CASE(\"Basic Window Visibility\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n auto comp_def = compiler.build_from_source(R\"(\n export App := Window {\n }\n )\",\n \"\");\n REQUIRE(comp_def.has_value());\n auto instance = comp_def->create();\n REQUIRE(instance->window().is_visible() == false);\n instance->show();\n REQUIRE(instance->window().is_visible() == true);\n instance->hide();\n REQUIRE(instance->window().is_visible() == false);\n}\n\nTEST_CASE(\"Window Scale Factory Existence\")\n{\n using namespace slint::interpreter;\n using namespace slint;\n\n ComponentCompiler compiler;\n auto comp_def = compiler.build_from_source(R\"(\n export App := Window {\n }\n )\",\n \"\");\n REQUIRE(comp_def.has_value());\n auto instance = comp_def->create();\n REQUIRE(instance->window().scale_factor() > 0);\n}\n" }, { "path": "api/node/.gitignore", "content": "rust-module.cjs\nrust-module.d.cts\nindex.js\ndocs/\nnpm/\ndist/\nbuild/\n" }, { "path": "api/node/.npmignore", "content": "target\nCargo.lock\n.cargo\n.github\nnpm\n.eslintrc\n.prettierignore\nrustfmt.toml\nyarn.lock\n*.node\n.yarn\n__test__\nrenovate.json\n*.tgz\n" }, { "path": "api/node/.yarnrc.yml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nnodeLinker: node-modules" }, { "path": "api/node/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[package]\nname = \"slint-node\"\ndescription = \"Internal Slint Runtime Library for NodeJS API.\"\nauthors.workspace = true\ndocumentation.workspace = true\nedition.workspace = true\nhomepage.workspace = true\nkeywords.workspace = true\nlicense.workspace = true\nrepository.workspace = true\nrust-version.workspace = true\nversion.workspace = true\ncategories = [\"gui\", \"development-tools\"]\nbuild = \"build.rs\"\npublish = false\n\n[lib]\ncrate-type = [\"cdylib\"]\npath = \"rust/lib.rs\"\n\n[features]\ndefault = [\"backend-winit\", \"renderer-femtovg\", \"renderer-software\", \"backend-qt\", \"accessibility\"]\n# Keep in sync with features in nightly_snapshot.yaml, cpp_package.yaml, slint_tool_binary.yaml, and api/python/slint/Cargo.toml\n# binaries: default = [\"backend-linuxkms-noseat\", \"backend-winit\", \"renderer-femtovg\", \"renderer-skia\", \"accessibility\"]\n\nbackend-qt = [\"slint-interpreter/backend-qt\"]\nbackend-winit = [\"slint-interpreter/backend-winit\"]\nbackend-winit-x11 = [\"slint-interpreter/backend-winit-x11\"]\nbackend-winit-wayland = [\"slint-interpreter/backend-winit-wayland\"]\nbackend-linuxkms = [\"slint-interpreter/backend-linuxkms\"]\nbackend-linuxkms-noseat = [\"slint-interpreter/backend-linuxkms-noseat\"]\nrenderer-femtovg = [\"slint-interpreter/renderer-femtovg\"]\nrenderer-femtovg-wgpu = [\"slint-interpreter/renderer-femtovg-wgpu\"]\nrenderer-skia = [\"slint-interpreter/renderer-skia\"]\nrenderer-skia-opengl = [\"slint-interpreter/renderer-skia-opengl\"]\nrenderer-skia-vulkan = [\"slint-interpreter/renderer-skia-vulkan\"]\nrenderer-software = [\"slint-interpreter/renderer-software\"]\naccessibility = [\"slint-interpreter/accessibility\"]\n\n# Removed by node_package xtask\ntesting = [\"dep:i-slint-backend-testing\"]\n\n[dependencies]\nnapi = { version = \"3\", default-features = false, features = [\"napi8\"] }\nnapi-derive = \"3\"\ni-slint-compiler = { workspace = true, features = [\"default\"] }\ni-slint-core = { workspace = true, features = [\"default\", \"gettext-rs\"] }\ni-slint-backend-selector = { workspace = true }\nslint-interpreter = { workspace = true, default-features = false, features = [\"display-diagnostics\", \"internal\", \"compat-1-2\"] }\nspin_on = { workspace = true }\ncss-color-parser2 = { workspace = true }\nitertools = { workspace = true }\nsend_wrapper = { workspace = true }\n# Removed by node_package xtask\ni-slint-backend-testing = { workspace = true, optional = true }\nsmol_str = { workspace = true }\n\n[build-dependencies]\nnapi-build = \"2\"\n" }, { "path": "api/node/README.md", "content": "\n# Slint-node (Beta)\n\n[![npm](https://img.shields.io/npm/v/slint-ui)](https://www.npmjs.com/package/slint-ui)\n\n[Slint](https://slint.dev/) is a UI toolkit that supports different programming languages.\nSlint-node is the integration with Node.js.\n\nTo get started you use the [walk-through tutorial](https://slint.dev/docs/slint/tutorial/quickstart).\nWe also have a [Getting Started Template](https://github.com/slint-ui/slint-nodejs-template) repository with\nthe code of a minimal application using Slint that can be used as a starting point to your program.\n\n**Warning: Beta**\nSlint-node is still in the early stages of development: APIs will change and important features are still being developed.\n\n## Slint Language Manual\n\nThe [Slint Language Documentation](../slint) covers the Slint UI description language\nin detail.\n\n## Installing Slint\n\nSlint is available via NPM, so you can install by running the following command:\n\n```sh\nnpm install slint-ui\n```\n\n### Dependencies\n\nYou need to install the following components:\n\n * **[Node.js](https://nodejs.org/download/release/)** (v20 or newer)\n * **[pnpm](https://www.pnpm.io/)**\n * **[Rust compiler](https://www.rust-lang.org/tools/install)**\n\nYou will also need a few more dependencies, see \n\n## Using Slint\n\nFirst, import the API from the `slint-ui` module. In the following examples we're using [ECMAScript module syntax](https://nodejs.org/api/esm.html#modules-ecmascript-modules), but if you prefer you can also import the API using [CommonJS](https://nodejs.org/api/modules.html#modules-commonjs-modules) syntax.\n\nTo initialize the API, you first need to import the `slint-ui` module in our code:\n\n```js\nimport * as slint from \"slint-ui\";\n```\n\nNext, load a slint file with the `loadFile` function:\n\n```js\nlet ui = slint.loadFile(\"ui/main.slint\");\n```\n\nCombining these two steps leads us to the obligatory \"Hello World\" example:\n\n```js\nimport * as slint from \"slint-ui\";\nlet ui = slint.loadFile(new URL(\".ui/main.slint\", import.meta.url));\nlet main = new ui.Main();\nmain.run();\n```\n\nFor a full example, see [/examples/todo/node](https://github.com/slint-ui/slint/tree/master/examples/todo/node).\n\n## API Overview\n\n### Instantiating a Component\n\nThe following example shows how to instantiate a Slint component from JavaScript.\n\n**`ui/main.slint`**\n\n```slint\nexport component MainWindow inherits Window {\n callback clicked <=> i-touch-area.clicked;\n\n in property counter;\n\n width: 400px;\n height: 200px;\n\n i-touch-area := TouchArea {}\n}\n```\n\nEach exported Window component is exposed as a type constructor. The type constructor takes as parameter\nan object which allow to initialize the value of public properties or callbacks.\n\n**`main.js`**\n\n```js\nimport * as slint from \"slint-ui\";\n// In this example, the main.slint file exports a module which\n// has a counter property and a clicked callback\nlet ui = slint.loadFile(new URL(\"ui/main.slint\", import.meta.url));\nlet component = new ui.MainWindow({\n counter: 42,\n clicked: function() { console.log(\"hello\"); }\n});\n```\n\n### Accessing a property\n\nProperties declared as `out` or `in-out` in `.slint` files are visible as JavaScript on the component instance.\n\n```js\ncomponent.counter = 42;\nconsole.log(component.counter);\n```\n\n### Callbacks\n\nCallbacks in Slint can be defined using the `callback` keyword and can be connected to a callback of an other component\nusing the `<=>` syntax.\n\n**`ui/my-component.slint`**\n\n```slint\nexport component MyComponent inherits Window {\n callback clicked <=> i-touch-area.clicked;\n\n width: 400px;\n height: 200px;\n\n i-touch-area := TouchArea {}\n}\n```\n\nThe callbacks in Slint are exposed as properties in JavaScript and that can be called as a function.\n\n**`main.js`**\n\n```js\nimport * as slint from \"slint-ui\";\n\nlet ui = slint.loadFile(new URL(\"ui/my-component.slint\", import.meta.url));\nlet component = new ui.MyComponent();\n\n// connect to a callback\ncomponent.clicked = function() { console.log(\"hello\"); };\n// emit a callback\ncomponent.clicked();\n```\n\n### Functions\n\nFunctions in Slint can be defined using the `function` keyword.\n\n**`ui/my-component.slint`**\n\n```slint\nexport component MyComponent inherits Window {\n width: 400px;\n height: 200px;\n\n public function my-function() -> int {\n return 42;\n }\n}\n```\n\nIf the function is marked `public`, it can also be called from JavaScript.\n\n**`main.js`**\n\n```js\nimport * as slint from \"slint-ui\";\n\nlet ui = slint.loadFile(new URL(\"ui/my-component.slint\", import.meta.url));\nlet component = new ui.MyComponent();\n\n// call a public function\nlet result = component.my_function();\n```\n\n### Type Mappings\n\nThe types used for properties in .slint design markup each translate to specific types in JavaScript. The follow table summarizes the entire mapping:\n\n| `.slint` Type | JavaScript Type | Notes |\n| --- | --- | --- |\n| `int` | `Number` | |\n| `float` | `Number` | |\n| `string` | `String` | |\n| `color` | `RgbaColor` | |\n| `brush` | `Brush` | |\n| `image` | `ImageData` | |\n| `length` | `Number` | |\n| `physical_length` | `Number` | |\n| `duration` | `Number` | The number of milliseconds |\n| `angle` | `Number` | The angle in degrees |\n| structure | `Object` | Structures are mapped to JavaScript objects where each structure field is a property. |\n| array | `Array` or any implementation of Model | |\n| enumeration | `String` | The value of an enum |\n\n### Arrays and Models\n\nFor property of array type, they can either be set using an array.\nIn that case, getting the property also return an array.\nIf the array was set within the .slint file, the array can be obtained\n\n```js\ncomponent.model = [1, 2, 3];\n// component.model.push(4); // does not work, because it operate on a copy\n// but re-assigning works\ncomponent.model = component.model.concat(4);\n```\n\nAnother option is to set a model object. A model object has the following function:\n\n* `rowCount()`: returns the number of element in the model.\n* `rowData(index)`: return the row at the given index\n* `setRowData(index, data)`: called when the model need to be changed. `this.notify.rowDataChanged` must be called if successful.\n\nAs an example, here is the implementation of the `ArrayModel` (which is available as `slint.ArrayModel`)\n\n```js\nimport * as slint from \"slint-ui\";\n\nlet array = [1, 2, 3];\n\nexport class ArrayModel extends slint.Model {\n private a: Array\n\n constructor(arr: Array) {\n super();\n this.a = arr;\n }\n\n rowCount() {\n return this.a.length;\n }\n\n rowData(row: number) {\n return this.a[row];\n }\n\n setRowData(row: number, data: T) {\n this.a[row] = data;\n this.notify.rowDataChanged(row);\n }\n\n push(...values: T[]) {\n let size = this.a.length;\n Array.prototype.push.apply(this.a, values);\n this.notify.rowAdded(size, arguments.length);\n }\n\n remove(index: number, size: number) {\n let r = this.a.splice(index, size);\n this.notify.rowRemoved(index, size);\n }\n\n get length(): number {\n return this.a.length;\n }\n\n values(): IterableIterator {\n return this.a.values();\n }\n\n entries(): IterableIterator<[number, T]> {\n return this.a.entries()\n }\n}\n\nlet model = new ArrayModel(array);\n\ncomponent.model = model;\nmodel.push(4); // this works\n// does NOT work, getting the model does not return the right object\n// component.model.push(5);\n```\n\n### structs\n\nAn exported struct can be created either by defing of an object literal or by using the new keyword.\n\n**`my-component.slint`**\n\n```slint\nexport struct Person {\n name: string,\n age: int\n}\n\nexport component MyComponent inherits Window {\n in-out property person;\n}\n```\n\n**`main.js`**\n\n```js\n\nimport * as slint from \"slint-ui\";\n\nlet ui = slint.loadFile(new URL(\"my-component.slint\", import.meta.url));\nlet component = new ui.MyComponent();\n\n// object literal\ncomponent.person = { name: \"Peter\", age: 22 };\n\n// new keyword (sets property values to default e.g. '' for string)\ncomponent.person = new ui.Person();\n\n// new keyword with parameters\ncomponent.person = new ui.Person({ name: \"Tim\", age: 30 });\n```\n\n### enums\n\nA value of an exported enum can be set as string or by using the value from the exported enum.\n\n**`my-component.slint`**\n\n```slint\nexport enum Position {\n top,\n bottom\n}\n\nexport component MyComponent inherits Window {\n in-out property position;\n}\n```\n\n**`main.js`**\n\n```js\n\nimport * as slint from \"slint-ui\";\n\nlet ui = slint.loadFile(new URL(\"my-component.slint\", import.meta.url));\nlet component = new ui.MyComponent();\n\n// set enum value as string\ncomponent.position = \"top\";\n\n// use the value of the enum\ncomponent.position = ui.Position.bottom;\n```\n" }, { "path": "api/node/__test__/api.spec.mts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { test, expect } from \"vitest\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { loadFile, loadSource, CompileError } from \"../dist/index.js\";\n\nconst dirname = path.dirname(\n fileURLToPath(import.meta.url).replace(\"build\", \"__test__\"),\n);\n\n// loadFile api\ntest(\"loadFile\", () => {\n // Test the URL variant here, to ensure that it works (esp. on Windows)\n const demo = loadFile(\n new URL(\n \"resources/test.slint\",\n import.meta.url.replace(\"build\", \"__test__\"),\n ),\n ) as any;\n const test = new demo.Test();\n expect(test.check).toBe(\"Test\");\n\n const errorPath = path.join(dirname, \"resources/error.slint\");\n\n let error: any;\n try {\n loadFile(errorPath);\n } catch (e) {\n error = e;\n }\n expect(error).toBeDefined();\n expect(error).toBeInstanceOf(CompileError);\n\n const formattedDiagnostics = error.diagnostics\n .map(\n (d) =>\n `[${d.fileName}:${d.lineNumber}:${d.columnNumber}] ${d.message}`,\n )\n .join(\"\\n\");\n expect(error.message).toBe(\n \"Could not compile \" +\n errorPath +\n `\\nDiagnostics:\\n${formattedDiagnostics}`,\n );\n expect(error.diagnostics).toStrictEqual([\n {\n columnNumber: 18,\n level: 0,\n lineNumber: 5,\n message:\n \"Missing type. The syntax to declare a property is `property name;`. Only two way bindings can omit the type\",\n fileName: errorPath,\n },\n {\n columnNumber: 22,\n level: 0,\n lineNumber: 5,\n message: \"Syntax error: expected ';'\",\n fileName: errorPath,\n },\n {\n columnNumber: 22,\n level: 0,\n lineNumber: 5,\n message: \"Parse error\",\n fileName: errorPath,\n },\n ]);\n});\n\ntest(\"loadFile constructor parameters\", () => {\n const demo = loadFile(\n path.join(dirname, \"resources/test-constructor.slint\"),\n ) as any;\n let hello = \"\";\n const test = new demo.Test({\n say_hello: function () {\n hello = \"hello\";\n },\n check: \"test\",\n });\n\n test.say_hello();\n\n expect(test.check).toBe(\"test\");\n expect(hello).toBe(\"hello\");\n});\n\ntest(\"loadFile component instances and modules are sealed\", () => {\n const demo = loadFile(path.join(dirname, \"resources/test.slint\")) as any;\n\n {\n let thrownError: any;\n try {\n demo.no_such_property = 42;\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError).toBeInstanceOf(TypeError);\n }\n\n const test = new demo.Test();\n expect(test.check).toBe(\"Test\");\n\n {\n let thrownError: any;\n try {\n test.no_such_callback = () => {};\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError).toBeInstanceOf(TypeError);\n }\n});\n\n// loadSource api\ntest(\"loadSource\", () => {\n const source = `export component Test {\n out property check: \"Test\";\n }`;\n const path = \"api.spec.ts\";\n const demo = loadSource(source, path) as any;\n const test = new demo.Test();\n expect(test.check).toBe(\"Test\");\n\n const errorSource = `export component Error {\n out property bool> check: \"Test\";\n }`;\n\n let error: any;\n try {\n loadSource(errorSource, path);\n } catch (e) {\n error = e;\n }\n expect(error).toBeDefined();\n expect(error).toBeInstanceOf(CompileError);\n\n const formattedDiagnostics = error.diagnostics\n .map(\n (d) =>\n `[${d.fileName}:${d.lineNumber}:${d.columnNumber}] ${d.message}`,\n )\n .join(\"\\n\");\n expect(error.message).toBe(\n \"Could not compile \" + path + `\\nDiagnostics:\\n${formattedDiagnostics}`,\n );\n // console.log(error?.diagnostics)\n expect(error.diagnostics).toStrictEqual([\n {\n columnNumber: 22,\n level: 0,\n lineNumber: 2,\n message:\n \"Missing type. The syntax to declare a property is `property name;`. Only two way bindings can omit the type\",\n fileName: path,\n },\n {\n columnNumber: 26,\n level: 0,\n lineNumber: 2,\n message: \"Syntax error: expected ';'\",\n fileName: path,\n },\n {\n columnNumber: 26,\n level: 0,\n lineNumber: 2,\n message: \"Parse error\",\n fileName: path,\n },\n ]);\n});\n\ntest(\"loadSource constructor parameters\", () => {\n const source = `export component Test {\n callback say_hello();\n in-out property check;\n }`;\n const path = \"api.spec.ts\";\n const demo = loadSource(source, path) as any;\n let hello = \"\";\n const test = new demo.Test({\n say_hello: function () {\n hello = \"hello\";\n },\n check: \"test\",\n });\n\n test.say_hello();\n\n expect(test.check).toBe(\"test\");\n expect(hello).toBe(\"hello\");\n});\n\ntest(\"loadSource component instances and modules are sealed\", () => {\n const source = `export component Test {\n out property check: \"Test\";\n }`;\n const path = \"api.spec.ts\";\n const demo = loadSource(source, path) as any;\n\n {\n let thrownError: any;\n try {\n demo.no_such_property = 42;\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError).toBeInstanceOf(TypeError);\n }\n\n const test = new demo.Test();\n expect(test.check).toBe(\"Test\");\n\n {\n let thrownError: any;\n try {\n test.no_such_callback = () => {};\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError).toBeInstanceOf(TypeError);\n }\n});\n\ntest(\"loadFile struct\", () => {\n const demo = loadFile(\n path.join(dirname, \"resources/test-struct.slint\"),\n ) as any;\n\n const test = new demo.Test({\n check: new demo.TestStruct(),\n });\n\n expect(test.check).toStrictEqual({ text: \"\", flag: false, value: 0 });\n});\n\ntest(\"loadFile struct constructor parameters\", () => {\n const demo = loadFile(\n path.join(dirname, \"resources/test-struct.slint\"),\n ) as any;\n\n const test = new demo.Test({\n check: new demo.TestStruct({ text: \"text\", flag: true, value: 12 }),\n });\n\n expect(test.check).toStrictEqual({ text: \"text\", flag: true, value: 12 });\n\n test.check = new demo.TestStruct({\n text: \"hello world\",\n flag: false,\n value: 8,\n });\n expect(test.check).toStrictEqual({\n text: \"hello world\",\n flag: false,\n value: 8,\n });\n});\n\ntest(\"loadFile struct constructor more parameters\", () => {\n const demo = loadFile(\n path.join(dirname, \"resources/test-struct.slint\"),\n ) as any;\n\n const test = new demo.Test({\n check: new demo.TestStruct({\n text: \"text\",\n flag: true,\n value: 12,\n noProp: \"hello\",\n }),\n });\n\n expect(test.check).toStrictEqual({ text: \"text\", flag: true, value: 12 });\n});\n\ntest(\"loadFile enum\", () => {\n const demo = loadFile(\n path.join(dirname, \"resources/test-enum.slint\"),\n ) as any;\n\n const test = new demo.Test({\n check: demo.TestEnum.b,\n });\n\n expect(test.check).toStrictEqual(\"b\");\n\n test.check = demo.TestEnum.c;\n\n expect(test.check).toStrictEqual(\"c\");\n});\n\ntest(\"file loader\", () => {\n const testSource = `export component Test {\n in-out property text: \"Hello World\";\n }`;\n const demo = loadFile(\n path.join(dirname, \"resources/test-fileloader.slint\"),\n {\n fileLoader: (path) => {\n if (path.includes(\"lib.slint\")) {\n return testSource;\n }\n return \"\";\n },\n },\n ) as any;\n\n const test = new demo.App();\n\n expect(test.test_text).toStrictEqual(\"Hello World\");\n});\n" }, { "path": "api/node/__test__/compiler.spec.mts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { test, expect } from \"vitest\";\n\nimport { private_api } from \"../dist/index.js\";\nimport * as napi from \"../rust-module.cjs\";\n\ntest(\"get/set include paths\", () => {\n const compiler = new private_api.ComponentCompiler();\n\n expect(compiler.includePaths.length).toBe(0);\n\n compiler.includePaths = [\"path/one/\", \"path/two/\", \"path/three/\"];\n\n expect(compiler.includePaths).toStrictEqual([\n \"path/one/\",\n \"path/two/\",\n \"path/three/\",\n ]);\n});\n\ntest(\"get/set library paths\", () => {\n const compiler = new private_api.ComponentCompiler();\n\n compiler.libraryPaths = {\n \"libfile.slint\": \"third_party/libfoo/ui/lib.slint\",\n libdir: \"third_party/libbar/ui/\",\n };\n\n expect(compiler.libraryPaths).toStrictEqual({\n \"libfile.slint\": \"third_party/libfoo/ui/lib.slint\",\n libdir: \"third_party/libbar/ui/\",\n });\n});\n\ntest(\"get/set style\", () => {\n const compiler = new private_api.ComponentCompiler();\n\n expect(compiler.style).toBeNull();\n\n compiler.style = \"fluent\";\n expect(compiler.style).toBe(\"fluent\");\n});\n\ntest(\"get/set build from source\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(`export component App {}`, \"\");\n expect(definition.App).not.toBeNull();\n expect(definition.App!.name).toBe(\"App\");\n});\n\ntest(\"constructor error ComponentDefinition and ComponentInstance\", () => {\n let componentDefinitionError: any;\n try {\n new private_api.ComponentDefinition();\n } catch (error) {\n componentDefinitionError = error;\n }\n expect(componentDefinitionError).toBeDefined();\n expect(componentDefinitionError.message).toBe(\n \"ComponentDefinition can only be created by using ComponentCompiler.\",\n );\n\n let componentInstanceError: any;\n try {\n new private_api.ComponentInstance();\n } catch (error) {\n componentInstanceError = error;\n }\n expect(componentInstanceError).toBeDefined();\n expect(componentInstanceError.message).toBe(\n \"ComponentInstance can only be created by using ComponentCompiler.\",\n );\n});\n\ntest(\"properties ComponentDefinition\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `export struct Struct {}\n export component App {\n in-out property bool-property;\n in-out property brush-property;\n in-out property color-property;\n in-out property float-property;\n in-out property image-property;\n in-out property int-property;\n in-out property <[string]> model-property;\n in-out property string-property;\n in-out property struct-property;\n }`,\n \"\",\n );\n expect(definition.App).not.toBeNull();\n\n const properties = definition.App!.properties;\n expect(properties.length).toBe(9);\n\n properties.sort((a, b) => {\n const nameA = a.name.toUpperCase(); // ignore upper and lowercase\n const nameB = b.name.toUpperCase(); // ignore upper and lowercase\n\n if (nameA < nameB) {\n return -1;\n }\n\n if (nameA > nameB) {\n return 1;\n }\n\n return 0;\n });\n\n expect(properties[0].name).toBe(\"bool-property\");\n expect(properties[0].valueType).toBe(napi.ValueType.Bool);\n expect(properties[1].name).toBe(\"brush-property\");\n expect(properties[1].valueType).toBe(napi.ValueType.Brush);\n expect(properties[2].name).toBe(\"color-property\");\n expect(properties[2].valueType).toBe(napi.ValueType.Brush);\n expect(properties[3].name).toBe(\"float-property\");\n expect(properties[3].valueType).toBe(napi.ValueType.Number);\n expect(properties[4].name).toBe(\"image-property\");\n expect(properties[4].valueType).toBe(napi.ValueType.Image);\n expect(properties[5].name).toBe(\"int-property\");\n expect(properties[5].valueType).toBe(napi.ValueType.Number);\n expect(properties[6].name).toBe(\"model-property\");\n expect(properties[6].valueType).toBe(napi.ValueType.Model);\n expect(properties[7].name).toBe(\"string-property\");\n expect(properties[7].valueType).toBe(napi.ValueType.String);\n expect(properties[8].name).toBe(\"struct-property\");\n expect(properties[8].valueType).toBe(napi.ValueType.Struct);\n});\n\ntest(\"callbacks ComponentDefinition\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n callback first-callback();\n callback second-callback();\n }`,\n \"\",\n );\n expect(definition.App).not.toBeNull();\n\n const callbacks = definition.App!.callbacks;\n expect(callbacks.length).toBe(2);\n\n callbacks.sort();\n\n expect(callbacks[0]).toBe(\"first-callback\");\n expect(callbacks[1]).toBe(\"second-callback\");\n});\n\ntest(\"globalProperties ComponentDefinition\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `export struct Struct {}\n\n export global TestGlobal {\n in-out property bool-property;\n in-out property brush-property;\n in-out property color-property;\n in-out property float-property;\n in-out property image-property;\n in-out property int-property;\n in-out property <[string]> model-property;\n in-out property string-property;\n in-out property struct-property;\n }\n\n export component App {\n }`,\n \"\",\n );\n\n expect(definition.App).not.toBeNull();\n\n expect(definition.App!.globalProperties(\"NonExistent\")).toBeNull();\n\n const properties = definition.App!.globalProperties(\"TestGlobal\");\n expect(properties).not.toBeNull();\n\n expect(properties!.length).toBe(9);\n\n properties!.sort((a, b) => {\n const nameA = a.name.toUpperCase(); // ignore upper and lowercase\n const nameB = b.name.toUpperCase(); // ignore upper and lowercase\n\n if (nameA < nameB) {\n return -1;\n }\n\n if (nameA > nameB) {\n return 1;\n }\n\n return 0;\n });\n\n expect(properties![0].name).toBe(\"bool-property\");\n expect(properties![0].valueType).toBe(napi.ValueType.Bool);\n expect(properties![1].name).toBe(\"brush-property\");\n expect(properties![1].valueType).toBe(napi.ValueType.Brush);\n expect(properties![2].name).toBe(\"color-property\");\n expect(properties![2].valueType).toBe(napi.ValueType.Brush);\n expect(properties![3].name).toBe(\"float-property\");\n expect(properties![3].valueType).toBe(napi.ValueType.Number);\n expect(properties![4].name).toBe(\"image-property\");\n expect(properties![4].valueType).toBe(napi.ValueType.Image);\n expect(properties![5].name).toBe(\"int-property\");\n expect(properties![5].valueType).toBe(napi.ValueType.Number);\n expect(properties![6].name).toBe(\"model-property\");\n expect(properties![6].valueType).toBe(napi.ValueType.Model);\n expect(properties![7].name).toBe(\"string-property\");\n expect(properties![7].valueType).toBe(napi.ValueType.String);\n expect(properties![8].name).toBe(\"struct-property\");\n expect(properties![8].valueType).toBe(napi.ValueType.Struct);\n});\n\ntest(\"globalCallbacks ComponentDefinition\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export global TestGlobal {\n callback first-callback();\n callback second-callback();\n }\n export component App {\n }`,\n \"\",\n );\n expect(definition.App).not.toBeNull();\n\n expect(definition.App!.globalCallbacks(\"NonExistent\")).toBeNull();\n\n const callbacks = definition.App!.globalCallbacks(\"TestGlobal\");\n expect(callbacks).not.toBeNull();\n expect(callbacks!.length).toBe(2);\n\n callbacks!.sort();\n\n expect(callbacks![0]).toBe(\"first-callback\");\n expect(callbacks![1]).toBe(\"second-callback\");\n});\n\ntest(\"compiler diagnostics\", () => {\n const compiler = new private_api.ComponentCompiler();\n expect(\n compiler.buildFromSource(\n `export component App {\n garbage\n }`,\n \"testsource.slint\",\n ),\n ).toStrictEqual({});\n\n const diags = compiler.diagnostics;\n expect(diags.length).toBe(1);\n expect(diags[0]).toStrictEqual({\n level: 0,\n message: \"Parse error\",\n lineNumber: 2,\n columnNumber: 12,\n fileName: \"testsource.slint\",\n });\n});\n\ntest(\"non-existent properties and callbacks\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n\n export component App {\n }`,\n \"\",\n );\n expect(definition.App).not.toBeNull();\n\n const instance = definition.App!.create();\n expect(instance).not.toBeNull();\n\n let prop_err: any;\n try {\n instance!.setProperty(\"non-existent\", 42);\n } catch (error) {\n prop_err = error;\n }\n expect(prop_err).toBeDefined();\n expect(prop_err.code).toBe(\"GenericFailure\");\n expect(prop_err.message).toBe(\n \"Property non-existent not found in the component\",\n );\n\n let callback_err: any;\n try {\n instance!.setCallback(\"non-existent-callback\", () => {});\n } catch (error) {\n callback_err = error;\n }\n expect(callback_err).toBeDefined();\n expect(callback_err.code).toBe(\"GenericFailure\");\n expect(callback_err.message).toBe(\n \"Callback non-existent-callback not found in the component\",\n );\n});\n" }, { "path": "api/node/__test__/eventloop.spec.mts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n// Test that the Slint event loop processes libuv's events.\n\nimport { test, expect, afterEach } from \"vitest\";\nimport * as http from \"node:http\";\n\nimport { runEventLoop, quitEventLoop, private_api } from \"../dist/index.js\";\n\nafterEach(() => {\n quitEventLoop();\n});\n\ntest.sequential(\"merged event loops with timer\", async () => {\n let invoked = false;\n\n await runEventLoop(() => {\n setTimeout(() => {\n invoked = true;\n quitEventLoop();\n }, 2);\n });\n expect(invoked).toBe(true);\n});\n\ntest.sequential(\"merged event loops with networking\", async () => {\n const listener = (request, result) => {\n result.writeHead(200);\n result.end(\"Hello World\");\n };\n\n let received_response = \"\";\n\n await runEventLoop(() => {\n const server = http.createServer(listener);\n server.listen(() => {\n const host = \"localhost\";\n const port = (server.address() as any).port;\n console.log(`server ready at ${host}:${port}`);\n\n (fetch as any)(`http://${host}:${port}/`)\n .then((response: Response) => {\n return response.text();\n })\n .then((text: string) => {\n received_response = text;\n //console.log(\"received \", text);\n quitEventLoop();\n server.close();\n });\n });\n });\n\n expect(received_response).toBe(\"Hello World\");\n});\n\ntest.sequential(\"quit event loop on last window closed with callback\", async () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n\n export component App inherits Window {\n width: 300px;\n height: 300px;\n }`,\n \"\",\n );\n expect(definition.App).not.toBeNull();\n\n const instance = definition.App!.create() as any;\n expect(instance).not.toBeNull();\n\n instance.window().show();\n await runEventLoop(() => {\n setTimeout(() => {\n instance.window().hide();\n }, 2);\n });\n});\n" }, { "path": "api/node/__test__/globals.spec.mts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { test, expect } from \"vitest\";\n\nimport { private_api } from \"../dist/index.js\";\n\ntest(\"get/set global properties\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export global Global { in-out property name: \"Initial\"; }\n export component App {}`,\n \"\",\n );\n expect(definition.App).not.toBeNull();\n\n const instance = definition.App!.create();\n expect(instance).not.toBeNull();\n\n expect(instance!.getGlobalProperty(\"Global\", \"name\")).toBe(\"Initial\");\n\n instance!.setGlobalProperty(\"Global\", \"name\", \"Hello\");\n expect(instance!.getGlobalProperty(\"Global\", \"name\")).toBe(\"Hello\");\n\n {\n let thrownError: any;\n try {\n instance!.getGlobalProperty(\"MyGlobal\", \"name\");\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"Global MyGlobal not found\");\n }\n\n {\n let thrownError: any;\n try {\n instance!.setGlobalProperty(\"MyGlobal\", \"name\", \"hello\");\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"Global MyGlobal not found\");\n }\n\n {\n let thrownError: any;\n try {\n instance!.getGlobalProperty(\"Global\", \"age\");\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"no such property\");\n }\n\n {\n let thrownError: any;\n try {\n instance!.setGlobalProperty(\"Global\", \"age\", 42);\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\n \"Property age of global Global not found in the component\",\n );\n }\n {\n let thrownError: any;\n try {\n instance!.setGlobalProperty(\"Global\", \"name\", 42);\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"StringExpected\");\n expect(thrownError.message).toContain(\"String\");\n }\n\n {\n let thrownError: any;\n try {\n instance!.setGlobalProperty(\"Global\", \"name\", { blah: \"foo\" });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"StringExpected\");\n expect(thrownError.message).toContain(\"String\");\n }\n});\n\ntest(\"invoke global callback\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export struct Person {\n name: string\n }\n\n export global Global {\n callback great(string, string, string, string, string);\n callback great-person(Person);\n callback person() -> Person;\n callback get-string() -> string;\n\n person => {\n {\n name: \"florian\"\n }\n }\n\n get-string => {\n \"string\"\n }\n }\n export component App {}\n `,\n \"\",\n );\n expect(definition.App).not.toBeNull();\n\n const instance = definition.App!.create();\n expect(instance).not.toBeNull();\n\n {\n let thrownError: any;\n try {\n instance!.setGlobalCallback(\"MyGlobal\", \"great\", () => {});\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"Global MyGlobal not found\");\n }\n\n {\n let thrownError: any;\n try {\n instance!.invokeGlobal(\"MyGlobal\", \"great\", []);\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"Global MyGlobal not found\");\n }\n\n let speakTest: string;\n instance!.setGlobalCallback(\n \"Global\",\n \"great\",\n (a: string, b: string, c: string, d: string, e: string) => {\n speakTest =\n \"hello \" + a + \", \" + b + \", \" + c + \", \" + d + \" and \" + e;\n },\n );\n\n {\n let thrownError: any;\n try {\n instance!.setGlobalCallback(\"Global\", \"bye\", () => {});\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\n \"Callback bye of global Global not found in the component\",\n );\n }\n\n {\n let thrownError: any;\n try {\n instance!.invokeGlobal(\"Global\", \"bye\", []);\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\n \"Callback bye of global Global not found in the component\",\n );\n }\n\n instance!.invokeGlobal(\"Global\", \"great\", [\n \"simon\",\n \"olivier\",\n \"auri\",\n \"tobias\",\n \"florian\",\n ]);\n expect(speakTest).toStrictEqual(\n \"hello simon, olivier, auri, tobias and florian\",\n );\n\n instance!.setGlobalCallback(\"Global\", \"great-person\", (p: any) => {\n speakTest = \"hello \" + p.name;\n });\n\n instance!.invokeGlobal(\"Global\", \"great-person\", [{ name: \"simon\" }]);\n expect(speakTest).toStrictEqual(\"hello simon\");\n\n instance!.invokeGlobal(\"Global\", \"great-person\", [{ hello: \"simon\" }]);\n expect(speakTest).toStrictEqual(\"hello \");\n\n expect(instance!.invokeGlobal(\"Global\", \"get-string\", [])).toStrictEqual(\n \"string\",\n );\n expect(instance!.invokeGlobal(\"Global\", \"person\", [])).toStrictEqual({\n name: \"florian\",\n });\n});\n" }, { "path": "api/node/__test__/helpers/utils.ts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { hook } from \"capture-console\";\n\nexport function captureAsyncStderr() {\n const chunks: string[] = [];\n\n const streams = new Set();\n streams.add(process.stderr);\n\n const consoleStderr = (globalThis.console as any)?._stderr;\n if (consoleStderr && consoleStderr !== process.stderr) {\n streams.add(consoleStderr);\n }\n\n const unhooks = Array.from(streams).map((stream) =>\n hook(stream, { quiet: true }, (chunk) => {\n chunks.push(chunk);\n }),\n );\n\n return {\n output() {\n return chunks.join(\"\");\n },\n restore() {\n while (unhooks.length) {\n const unhook = unhooks.pop();\n unhook && unhook();\n }\n },\n };\n}\n" }, { "path": "api/node/__test__/js_value_conversion.spec.mts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { test, expect } from \"vitest\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { read, ImageColorModel } from \"image-js\";\nimport { captureAsyncStderr } from \"./helpers/utils.js\";\nimport {\n private_api,\n type ImageData,\n ArrayModel,\n type Model,\n} from \"../dist/index.js\";\n\nconst filename = fileURLToPath(import.meta.url).replace(\"build\", \"__test__\");\nconst dirname = path.dirname(filename);\n\nfunction createNonNullInstance(definition: {\n App?: { create(): private_api.ComponentInstance | null };\n}): private_api.ComponentInstance {\n const app = definition.App;\n if (!app) {\n throw new Error(\"Expected App to be defined\");\n }\n const instance = app.create();\n if (!instance) {\n throw new Error(\"Expected non-null instance from App.create()\");\n }\n return instance;\n}\n\ntest(\"get/set string properties\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `export component App { in-out property name: \"Initial\"; }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n expect(instance.getProperty(\"name\")).toBe(\"Initial\");\n\n instance.setProperty(\"name\", \"Hello\");\n expect(instance.getProperty(\"name\")).toBe(\"Hello\");\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"name\", 42);\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"StringExpected\");\n expect(thrownError.message).toContain(\"String\");\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"name\", { blah: \"foo\" });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"StringExpected\");\n expect(thrownError.message).toContain(\"String\");\n }\n});\n\ntest(\"get/set number properties\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n in-out property age: 42;\n }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n expect(instance.getProperty(\"age\")).toBe(42);\n\n instance.setProperty(\"age\", 100);\n expect(instance.getProperty(\"age\")).toBe(100);\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"age\", \"Hello\");\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"NumberExpected\");\n expect(thrownError.message).toContain(\"Number\");\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"age\", { blah: \"foo\" });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"NumberExpected\");\n expect(thrownError.message).toContain(\"Number\");\n }\n});\n\ntest(\"get/set bool properties\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `export component App { in-out property ready: true; }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n expect(instance.getProperty(\"ready\")).toBe(true);\n\n instance.setProperty(\"ready\", false);\n expect(instance.getProperty(\"ready\")).toBe(false);\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"ready\", \"Hello\");\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"BooleanExpected\");\n expect(thrownError.message).toContain(\"Boolean\");\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"ready\", { blah: \"foo\" });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"BooleanExpected\");\n expect(thrownError.message).toContain(\"Boolean\");\n }\n});\n\ntest(\"set struct properties\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export struct Player {\n name: string,\n age: int,\n energy_level: float\n }\n export component App {\n in-out property player: {\n name: \"Florian\",\n age: 20,\n energy_level: 40%\n };\n }\n `,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n expect(instance.getProperty(\"player\")).toStrictEqual({\n name: \"Florian\",\n age: 20,\n energy_level: 0.4,\n });\n\n instance.setProperty(\"player\", {\n name: \"Simon\",\n age: 22,\n energy_level: 0.8,\n });\n\n expect(instance.getProperty(\"player\")).toStrictEqual({\n name: \"Simon\",\n age: 22,\n energy_level: 0.8,\n });\n\n // Extra properties are thrown away\n instance.setProperty(\"player\", {\n name: \"Excessive Player\",\n age: 100,\n energy_level: 0.8,\n weight: 200,\n });\n expect(instance.getProperty(\"player\")).toStrictEqual({\n name: \"Excessive Player\",\n age: 100,\n energy_level: 0.8,\n });\n\n // Missing properties are defaulted\n instance.setProperty(\"player\", { age: 39 });\n expect(instance.getProperty(\"player\")).toStrictEqual({\n name: \"\",\n age: 39,\n energy_level: 0.0,\n });\n});\n\ntest(\"get/set image properties\", async () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n in-out property image: @image-url(\"resources/rgb.png\");\n in property external-image;\n out property external-image-ok: self.external-image.width == 64 && self.external-image.height == 64;\n }`,\n filename,\n );\n const instance = createNonNullInstance(definition);\n\n const slintImage = instance.getProperty(\"image\");\n if (slintImage instanceof private_api.SlintImageData) {\n expect((slintImage as private_api.SlintImageData).width).toStrictEqual(\n 64,\n );\n expect((slintImage as private_api.SlintImageData).height).toStrictEqual(\n 64,\n );\n expect((slintImage as ImageData).path.endsWith(\"rgb.png\")).toBe(true);\n\n const image = await read(path.join(dirname, \"resources/rgb.png\"));\n const rgbaImage =\n image.colorModel === ImageColorModel.RGBA\n ? image\n : image.convertColor(ImageColorModel.RGBA);\n const raw = rgbaImage.getRawImage();\n\n // Sanity check: setProperty fails when passed definitely a non-image\n {\n let thrownError: any;\n try {\n instance.setProperty(\"external-image\", 42);\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.message).toBe(\n \"Cannot convert object to image, because the provided object does not have an u32 `width` property\",\n );\n }\n {\n let thrownError: any;\n try {\n instance.setProperty(\"external-image\", { garbage: true });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.message).toBe(\n \"Cannot convert object to image, because the provided object does not have an u32 `width` property\",\n );\n }\n {\n let thrownError: any;\n try {\n instance.setProperty(\"external-image\", { width: [1, 2, 3] });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.message).toBe(\n \"Cannot convert object to image, because the provided object does not have an u32 `height` property\",\n );\n }\n {\n let thrownError: any;\n try {\n instance.setProperty(\"external-image\", {\n width: 1,\n height: 1,\n data: new Uint8ClampedArray(1),\n });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.message).toBe(\n \"data property does not have the correct size; expected 1 (width) * 1 (height) * 4 = 1; got 4\",\n );\n }\n\n expect(raw.width).toBe(64);\n expect(raw.height).toBe(64);\n // Duck typing: object with width, height, data has the shape of ImageData, so\n // it should be possible to use it with Slint:\n instance.setProperty(\"external-image\", raw);\n expect(instance.getProperty(\"external-image-ok\")).toBe(true);\n\n expect(raw.data.length).toBe((slintImage as ImageData).data.length);\n expect(Buffer.from(raw.data as Uint8Array)).toStrictEqual(\n (slintImage as ImageData).data,\n );\n\n expect(\n (instance.getProperty(\"external-image\") as ImageData).path,\n ).toStrictEqual(undefined);\n }\n});\n\ntest(\"get/set brush properties\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n in-out property black: #000000;\n in-out property trans: transparent;\n in-out property ref: transparent;\n in-out property linear-gradient: @linear-gradient(90deg, #3f87a6 0%, #ebf8e1 50%, #f69d3c 100%);\n in-out property radial-gradient: @radial-gradient(circle, #f00 0%, #0f0 50%, #00f 100%);\n in-out property ref-color;\n }\n `,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n const black = instance.getProperty(\"black\");\n\n expect((black as private_api.SlintBrush).toString()).toBe(\"#000000\");\n\n if (black instanceof private_api.SlintBrush) {\n const blackSlintRgbaColor = (black as private_api.SlintBrush).color;\n expect(blackSlintRgbaColor.red).toStrictEqual(0);\n expect(blackSlintRgbaColor.green).toStrictEqual(0);\n expect(blackSlintRgbaColor.blue).toStrictEqual(0);\n }\n\n instance.setProperty(\"black\", \"#ffffff\");\n const white = instance.getProperty(\"black\");\n\n if (white instanceof private_api.SlintBrush) {\n const whiteSlintRgbaColor = (white as private_api.SlintBrush).color;\n expect(whiteSlintRgbaColor.red).toStrictEqual(255);\n expect(whiteSlintRgbaColor.green).toStrictEqual(255);\n expect(whiteSlintRgbaColor.blue).toStrictEqual(255);\n }\n\n const transparent = instance.getProperty(\"trans\");\n\n if (black instanceof private_api.SlintBrush) {\n expect((transparent as private_api.SlintBrush).isTransparent).toBe(\n true,\n );\n }\n\n const ref = new private_api.SlintBrush({\n red: 100,\n green: 110,\n blue: 120,\n alpha: 255,\n });\n instance.setProperty(\"ref\", ref);\n\n let instance_ref = instance.getProperty(\"ref\");\n\n if (instance_ref instanceof private_api.SlintBrush) {\n const ref_color = (instance_ref as private_api.SlintBrush).color;\n expect(ref_color.red).toStrictEqual(100);\n expect(ref_color.green).toStrictEqual(110);\n expect(ref_color.blue).toStrictEqual(120);\n expect(ref_color.alpha).toStrictEqual(255);\n }\n\n instance.setProperty(\"ref\", {\n color: { red: 110, green: 120, blue: 125, alpha: 255 },\n });\n\n instance_ref = instance.getProperty(\"ref\");\n\n if (instance_ref instanceof private_api.SlintBrush) {\n const ref_color = (instance_ref as private_api.SlintBrush).color;\n expect(ref_color.red).toStrictEqual(110);\n expect(ref_color.green).toStrictEqual(120);\n expect(ref_color.blue).toStrictEqual(125);\n expect(ref_color.alpha).toStrictEqual(255);\n }\n\n instance.setProperty(\"ref\", {\n red: 110,\n green: 120,\n blue: 125,\n alpha: 255,\n });\n\n instance_ref = instance.getProperty(\"ref\");\n\n if (instance_ref instanceof private_api.SlintBrush) {\n const ref_color = (instance_ref as private_api.SlintBrush).color;\n expect(ref_color.red).toStrictEqual(110);\n expect(ref_color.green).toStrictEqual(120);\n expect(ref_color.blue).toStrictEqual(125);\n expect(ref_color.alpha).toStrictEqual(255);\n }\n\n instance.setProperty(\"ref\", {});\n\n instance_ref = instance.getProperty(\"ref\");\n\n if (instance_ref instanceof private_api.SlintBrush) {\n const ref_color = (instance_ref as private_api.SlintBrush).color;\n expect(ref_color.red).toStrictEqual(0);\n expect(ref_color.green).toStrictEqual(0);\n expect(ref_color.blue).toStrictEqual(0);\n expect(ref_color.alpha).toStrictEqual(0);\n }\n\n const radialGradient = instance.getProperty(\"radial-gradient\");\n\n if (radialGradient instanceof private_api.SlintBrush) {\n expect((radialGradient as private_api.SlintBrush).toString()).toBe(\n \"radial-gradient(circle, rgba(255, 0, 0, 255) 0%, rgba(0, 255, 0, 255) 50%, rgba(0, 0, 255, 255) 100%)\",\n );\n }\n\n const linearGradient = instance.getProperty(\"linear-gradient\");\n\n if (linearGradient instanceof private_api.SlintBrush) {\n expect((linearGradient as private_api.SlintBrush).toString()).toBe(\n \"linear-gradient(90deg, rgba(63, 135, 166, 255) 0%, rgba(235, 248, 225, 255) 50%, rgba(246, 157, 60, 255) 100%)\",\n );\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"ref-color\", {\n red: \"abc\",\n blue: 0,\n green: 0,\n alpha: 0,\n });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"NumberExpected\");\n expect(thrownError.message).toBe(\n \"Failed to convert napi value String into rust type `f64`\",\n );\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"ref-color\", {\n red: 0,\n blue: true,\n green: 0,\n alpha: 0,\n });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"NumberExpected\");\n expect(thrownError.message).toBe(\n \"Failed to convert napi value Boolean into rust type `f64`\",\n );\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"ref-color\", {\n red: 0,\n blue: 0,\n green: true,\n alpha: 0,\n });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"NumberExpected\");\n expect(thrownError.message).toBe(\n \"Failed to convert napi value Boolean into rust type `f64`\",\n );\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"ref-color\", {\n red: 0,\n blue: 0,\n green: 0,\n alpha: new private_api.SlintRgbaColor(),\n });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"NumberExpected\");\n expect(thrownError.message).toBe(\n \"Failed to convert napi value Object into rust type `f64`\",\n );\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"ref-color\", { blue: 0, green: 0, alpha: 0 });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"Property red is missing\");\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"ref-color\", { red: 0, green: 0, alpha: 0 });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"Property blue is missing\");\n }\n\n instance.setProperty(\"ref-color\", { red: 0, green: 0, blue: 0 });\n instance_ref = instance.getProperty(\"ref-color\");\n\n if (instance_ref instanceof private_api.SlintBrush) {\n const ref_color = (instance_ref as private_api.SlintBrush).color;\n expect(ref_color.red).toStrictEqual(0);\n expect(ref_color.green).toStrictEqual(0);\n expect(ref_color.blue).toStrictEqual(0);\n expect(ref_color.alpha).toStrictEqual(255);\n }\n\n // ref is a brush, but setting to a color should not throw, but take the brush's color.\n instance.setProperty(\"ref-color\", ref);\n instance_ref = instance.getProperty(\"ref-color\");\n if (instance_ref instanceof private_api.SlintBrush) {\n const ref_color = (instance_ref as private_api.SlintBrush).color;\n expect(ref_color.red).toStrictEqual(ref.color.red);\n expect(ref_color.green).toStrictEqual(ref.color.green);\n expect(ref_color.blue).toStrictEqual(ref.color.blue);\n expect(ref_color.alpha).toStrictEqual(ref.color.alpha);\n }\n});\n\ntest(\"get/set enum properties\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `export enum Direction { up, down }\n export component App { in-out property direction: up; }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n expect(instance.getProperty(\"direction\")).toBe(\"up\");\n\n instance.setProperty(\"direction\", \"down\");\n expect(instance.getProperty(\"direction\")).toBe(\"down\");\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"direction\", 42);\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"42 is not a value of enum Direction\");\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"direction\", { blah: \"foo\" });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\n \"[object Object] is not a value of enum Direction\",\n );\n }\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"direction\", \"left\");\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\n \"left is not a value of enum Direction\",\n );\n }\n});\n\ntest(\"ArrayModel\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export struct Player {\n name: string,\n age: int\n }\n\n export component App {\n in-out property <[int]> int-model;\n in-out property <[string]> string-model;\n in-out property <[Player]> struct-model;\n }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n expect(Array.from(new ArrayModel([3, 2, 1]))).toStrictEqual([3, 2, 1]);\n\n instance.setProperty(\"int-model\", new ArrayModel([10, 9, 8]));\n\n const intArrayModel = instance.getProperty(\n \"int-model\",\n ) as ArrayModel;\n expect(intArrayModel.rowCount()).toStrictEqual(3);\n expect(intArrayModel.values()).toStrictEqual(\n new ArrayModel([10, 9, 8]).values(),\n );\n\n instance.setProperty(\n \"string-model\",\n new ArrayModel([\"Simon\", \"Olivier\", \"Auri\", \"Tobias\", \"Florian\"]),\n );\n\n const stringArrayModel = instance.getProperty(\n \"string-model\",\n ) as ArrayModel;\n expect(stringArrayModel.values()).toStrictEqual(\n new ArrayModel([\n \"Simon\",\n \"Olivier\",\n \"Auri\",\n \"Tobias\",\n \"Florian\",\n ]).values(),\n );\n\n instance.setProperty(\n \"struct-model\",\n new ArrayModel([\n { name: \"simon\", age: 22 },\n { name: \"florian\", age: 22 },\n ]),\n );\n\n const structArrayModel = instance.getProperty(\n \"struct-model\",\n ) as ArrayModel;\n expect(structArrayModel.values()).toStrictEqual(\n new ArrayModel([\n { name: \"simon\", age: 22 },\n { name: \"florian\", age: 22 },\n ]).values(),\n );\n});\n\ntest(\"MapModel\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n in-out property <[string]> model;\n }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n interface Name {\n first: string;\n last: string;\n }\n\n const nameModel: ArrayModel = new ArrayModel([\n { first: \"Hans\", last: \"Emil\" },\n { first: \"Max\", last: \"Mustermann\" },\n { first: \"Roman\", last: \"Tisch\" },\n ]);\n\n const mapModel = new private_api.MapModel(nameModel, (data) => {\n return data.last + \", \" + data.first;\n });\n\n instance.setProperty(\"model\", mapModel);\n\n nameModel.setRowData(0, { first: \"Simon\", last: \"Hausmann\" });\n nameModel.setRowData(1, { first: \"Olivier\", last: \"Goffart\" });\n\n const checkModel = instance.getProperty(\"model\") as Model;\n expect(checkModel.rowData(0)).toBe(\"Hausmann, Simon\");\n expect(checkModel.rowData(1)).toBe(\"Goffart, Olivier\");\n expect(checkModel.rowData(2)).toBe(\"Tisch, Roman\");\n});\n\ntest(\"MapModel undefined rowData sourcemodel\", () => {\n const nameModel: ArrayModel = new ArrayModel([1, 2, 3]);\n\n let mapFunctionCallCount = 0;\n const mapModel = new private_api.MapModel(\n nameModel,\n (data) => {\n mapFunctionCallCount++;\n return data.toString();\n },\n );\n\n for (let i = 0; i < mapModel.rowCount(); ++i) {\n mapModel.rowData(i);\n }\n expect(mapFunctionCallCount).toStrictEqual(mapModel.rowCount());\n mapFunctionCallCount = 0;\n expect(nameModel.rowData(nameModel.rowCount())).toBeUndefined();\n expect(mapFunctionCallCount).toStrictEqual(0);\n expect(mapModel.rowData(mapModel.rowCount())).toBeUndefined();\n expect(mapFunctionCallCount).toStrictEqual(0);\n});\n\ntest(\"ArrayModel rowCount\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n out property model-length: model.length;\n in-out property <[int]> model;\n }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n const model = new ArrayModel([10, 9, 8]);\n\n instance.setProperty(\"model\", model);\n expect(model.rowCount()).toBe(3);\n expect(instance.getProperty(\"model-length\") as number).toBe(3);\n});\n\ntest(\"ArrayModel rowData/setRowData\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n callback data(int) -> int;\n\n in-out property <[int]> model;\n\n data(row) => {\n model[row]\n }\n }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n const model = new ArrayModel([10, 9, 8]);\n\n instance.setProperty(\"model\", model);\n expect(model.rowData(1)).toBe(9);\n expect(instance.invoke(\"data\", [1])).toStrictEqual(9);\n\n model.setRowData(1, 4);\n expect(model.rowData(1)).toBe(4);\n expect(instance.invoke(\"data\", [1])).toStrictEqual(4);\n});\n\ntest(\"Model notify\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n width: 300px;\n height: 300px;\n\n out property layout-height: layout.height;\n in-out property<[length]> fixed-height-model;\n\n VerticalLayout {\n alignment: start;\n\n layout := VerticalLayout {\n for fixed-height in fixed-height-model: Rectangle {\n background: blue;\n height: fixed-height;\n }\n }\n }\n\n }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n const model = new ArrayModel([100, 0]);\n\n instance.setProperty(\"fixed-height-model\", model);\n expect(instance.getProperty(\"layout-height\") as number).toBe(100);\n model.setRowData(1, 50);\n expect(instance.getProperty(\"layout-height\") as number).toBe(150);\n model.push(75);\n expect(instance.getProperty(\"layout-height\") as number).toBe(225);\n model.remove(1, 2);\n expect(instance.getProperty(\"layout-height\") as number).toBe(100);\n});\n\ntest(\"model from array\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n in-out property <[int]> int-array;\n in-out property <[string]> string-array;\n }`,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n if (!instance) {\n throw new Error(\"Expected non-null instance from App.create()\");\n }\n\n instance.setProperty(\"int-array\", [10, 9, 8]);\n const wrapped_int_model = instance.getProperty(\n \"int-array\",\n ) as Model;\n expect(Array.from(wrapped_int_model)).toStrictEqual([10, 9, 8]);\n expect(wrapped_int_model.rowCount()).toStrictEqual(3);\n expect(wrapped_int_model.rowData(0)).toStrictEqual(10);\n expect(wrapped_int_model.rowData(1)).toStrictEqual(9);\n expect(wrapped_int_model.rowData(2)).toStrictEqual(8);\n expect(Array.from(wrapped_int_model)).toStrictEqual([10, 9, 8]);\n\n instance.setProperty(\"string-array\", [\n \"Simon\",\n \"Olivier\",\n \"Auri\",\n \"Tobias\",\n \"Florian\",\n ]);\n const wrapped_string_model = instance.getProperty(\n \"string-array\",\n ) as Model;\n expect(wrapped_string_model.rowCount()).toStrictEqual(5);\n expect(wrapped_string_model.rowData(0)).toStrictEqual(\"Simon\");\n expect(wrapped_string_model.rowData(1)).toStrictEqual(\"Olivier\");\n expect(wrapped_string_model.rowData(2)).toStrictEqual(\"Auri\");\n expect(wrapped_string_model.rowData(3)).toStrictEqual(\"Tobias\");\n expect(wrapped_string_model.rowData(4)).toStrictEqual(\"Florian\");\n});\n\ntest(\"invoke callback\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export struct Person {\n name: string\n }\n export component App {\n callback great(string, string, string, string, string);\n callback great-person(Person);\n callback person() -> Person;\n callback get-string() -> string;\n\n person => {\n {\n name: \"florian\"\n }\n }\n\n get-string => {\n \"string\"\n }\n }\n `,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n let speakTest: string;\n\n instance.setCallback(\n \"great\",\n (a: string, b: string, c: string, d: string, e: string) => {\n speakTest =\n \"hello \" + a + \", \" + b + \", \" + c + \", \" + d + \" and \" + e;\n },\n );\n\n instance.invoke(\"great\", [\"simon\", \"olivier\", \"auri\", \"tobias\", \"florian\"]);\n expect(speakTest).toStrictEqual(\n \"hello simon, olivier, auri, tobias and florian\",\n );\n\n instance.setCallback(\"great-person\", (p: any) => {\n speakTest = \"hello \" + p.name;\n });\n\n instance.invoke(\"great-person\", [{ name: \"simon\" }]);\n expect(speakTest).toStrictEqual(\"hello simon\");\n\n instance.invoke(\"great-person\", [{ hello: \"simon\" }]);\n expect(speakTest).toStrictEqual(\"hello \");\n\n expect(instance.invoke(\"get-string\", [])).toStrictEqual(\"string\");\n expect(instance.invoke(\"person\", [])).toStrictEqual({ name: \"florian\" });\n});\n\ntest(\"wrong callback return type \", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export struct Person {\n name: string,\n age: int,\n\n }\n export component App {\n callback get-string() -> string;\n callback get-int() -> int;\n callback get-bool() -> bool;\n callback get-person() -> Person;\n }\n `,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n let speakTest: string;\n\n instance.setCallback(\"get-string\", () => {\n return 20;\n });\n\n const string = instance.invoke(\"get-string\", []);\n expect(string).toStrictEqual(\"\");\n\n instance.setCallback(\"get-int\", () => {\n return \"string\";\n });\n\n const int = instance.invoke(\"get-int\", []);\n expect(int).toStrictEqual(0);\n\n instance.setCallback(\"get-bool\", () => {\n return \"string\";\n });\n\n const bool = instance.invoke(\"get-bool\", []);\n expect(bool).toStrictEqual(false);\n\n instance.setCallback(\"get-person\", () => {\n return \"string\";\n });\n\n const person = instance.invoke(\"get-person\", []);\n expect(person).toStrictEqual({ name: \"\", age: 0 });\n});\n\ntest(\"wrong global callback return type \", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export struct Person {\n name: string,\n age: int,\n }\n export global Global {\n callback get-string() -> string;\n callback get-int() -> int;\n callback get-bool() -> bool;\n callback get-person() -> Person;\n }\n export component App {\n }\n `,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n let speakTest: string;\n\n instance.setGlobalCallback(\"Global\", \"get-string\", () => {\n return 20;\n });\n\n const string = instance.invokeGlobal(\"Global\", \"get-string\", []);\n expect(string).toStrictEqual(\"\");\n\n instance.setGlobalCallback(\"Global\", \"get-bool\", () => {\n return \"string\";\n });\n\n const bool = instance.invokeGlobal(\"Global\", \"get-bool\", []);\n expect(bool).toStrictEqual(false);\n\n instance.setGlobalCallback(\"Global\", \"get-person\", () => {\n return \"string\";\n });\n\n const person = instance.invokeGlobal(\"Global\", \"get-person\", []);\n expect(person).toStrictEqual({ name: \"\", age: 0 });\n});\n\ntest(\"throw exception in callback\", async () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n callback throw-something();\n }\n `,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n instance.setCallback(\"throw-something\", () => {\n throw new Error(\"I'm an error\");\n });\n\n const stderrCapture = captureAsyncStderr();\n try {\n instance.invoke(\"throw-something\", []);\n // Vitest runs these tests in workers and the native binding writes to\n // stderr on the next macrotask, so yield once before restoring writers.\n await new Promise((resolve) => setTimeout(resolve, 0));\n } finally {\n stderrCapture.restore();\n }\n const output = stderrCapture.output();\n expect(\n output.includes(\"Node.js: Invoking callback 'throw-something' failed\"),\n ).toBe(true);\n expect(output.includes(\"I'm an error\")).toBe(true);\n});\n\ntest(\"throw exception set color\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n export component App {\n in-out property test;\n }\n `,\n \"\",\n );\n const instance = createNonNullInstance(definition);\n\n {\n let thrownError: any;\n try {\n instance.setProperty(\"test\", { garbage: true });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"Property red is missing\");\n }\n});\n" }, { "path": "api/node/__test__/models.spec.mts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { test, expect } from \"vitest\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n loadFile,\n loadSource,\n CompileError,\n ArrayModel,\n private_api,\n Model,\n} from \"../dist/index.js\";\n\ntest(\"MapModel notify rowChanged\", () => {\n const source = `\n export component App {\n\n in-out property <[string]> model;\n in-out property changed-items;\n\n for item in root.model : Text {\n text: item;\n\n changed text => {\n root.changed-items += self.text;\n }\n }\n }`;\n\n const path = \"api.spec.ts\";\n\n private_api.initTesting();\n const demo = loadSource(source, path) as any;\n const instance = new demo.App();\n\n interface Name {\n first: string;\n last: string;\n }\n\n const nameModel: ArrayModel = new ArrayModel([\n { first: \"Hans\", last: \"Emil\" },\n { first: \"Max\", last: \"Mustermann\" },\n { first: \"Roman\", last: \"Tisch\" },\n ]);\n\n const mapModel = new private_api.MapModel(nameModel, (data) => {\n return data.last + \", \" + data.first;\n });\n\n instance.model = mapModel;\n\n private_api.send_mouse_click(instance, 5, 5);\n\n nameModel.setRowData(0, { first: \"Simon\", last: \"Hausmann\" });\n nameModel.setRowData(1, { first: \"Olivier\", last: \"Goffart\" });\n\n private_api.send_mouse_click(instance, 5, 5);\n\n expect(instance.changed_items).toBe(\"Goffart, OlivierHausmann, Simon\");\n});\n" }, { "path": "api/node/__test__/resources/error.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nexport component Error {\n out property bool> check: \"Test\";\n}" }, { "path": "api/node/__test__/resources/test-constructor.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nexport component Test {\n callback say_hello();\n in-out property check;\n}" }, { "path": "api/node/__test__/resources/test-enum.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nexport enum TestEnum {\n a,\n b,\n c\n}\n\nexport component Test {\n in-out property check;\n}\n" }, { "path": "api/node/__test__/resources/test-fileloader.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { Test } from \"lib.slint\";\n\nexport component App inherits Window {\n out property test-text <=> test.text;\n test := Test {}\n}\n" }, { "path": "api/node/__test__/resources/test-struct.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nexport struct TestStruct {\n text: string,\n flag: bool,\n value: float\n}\n\nexport component Test {\n in-out property check;\n}\n" }, { "path": "api/node/__test__/resources/test.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nexport component Test {\n out property check: \"Test\";\n}" }, { "path": "api/node/__test__/tsconfig.json", "content": "{\n \"compilerOptions\": {\n \"module\": \"nodenext\",\n \"target\": \"esnext\",\n \"outDir\": \"../build\",\n \"skipLibCheck\": true\n },\n \"include\": [\n \"*.mts\"\n ],\n}\n" }, { "path": "api/node/__test__/types.spec.mts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { test, expect } from \"vitest\";\n\nimport { private_api, ArrayModel } from \"../dist/index.js\";\n\ntest(\"SlintColor from fromRgb\", () => {\n const color = private_api.SlintRgbaColor.fromRgb(100, 110, 120);\n\n expect(color.red).toStrictEqual(100);\n expect(color.green).toStrictEqual(110);\n expect(color.blue).toStrictEqual(120);\n});\n\ntest(\"SlintColor from fromArgb\", () => {\n const color = private_api.SlintRgbaColor.fromArgb(120, 100, 110, 120);\n\n expect(color.red).toStrictEqual(100);\n expect(color.green).toStrictEqual(110);\n expect(color.blue).toStrictEqual(120);\n});\n\ntest(\"SlintColor brighter\", () => {\n const color = private_api.SlintRgbaColor.fromRgb(100, 110, 120).brighter(\n 0.1,\n );\n\n expect(color.red).toStrictEqual(110);\n expect(color.green).toStrictEqual(121);\n expect(color.blue).toStrictEqual(132);\n});\n\ntest(\"SlintColor darker\", () => {\n const color = private_api.SlintRgbaColor.fromRgb(100, 110, 120).darker(0.1);\n\n expect(color.red).toStrictEqual(91);\n expect(color.green).toStrictEqual(100);\n expect(color.blue).toStrictEqual(109);\n});\n\ntest(\"private_api.SlintBrush from RgbaColor\", () => {\n const brush = new private_api.SlintBrush({\n red: 100,\n green: 110,\n blue: 120,\n alpha: 255,\n });\n\n expect(brush.color.red).toStrictEqual(100);\n expect(brush.color.green).toStrictEqual(110);\n expect(brush.color.blue).toStrictEqual(120);\n\n let thrownError: any;\n try {\n new private_api.SlintBrush({\n red: -100,\n green: 110,\n blue: 120,\n alpha: 255,\n });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"A channel of Color cannot be negative\");\n});\n\ntest(\"private_api.SlintBrush from Brush\", () => {\n const brush = private_api.SlintBrush.fromBrush({\n color: { red: 100, green: 110, blue: 120, alpha: 255 },\n });\n\n expect(brush.color.red).toStrictEqual(100);\n expect(brush.color.green).toStrictEqual(110);\n expect(brush.color.blue).toStrictEqual(120);\n\n let thrownError: any;\n try {\n private_api.SlintBrush.fromBrush({\n color: { red: -100, green: 110, blue: 120, alpha: 255 },\n });\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\"A channel of Color cannot be negative\");\n});\n\ntest(\"ArrayModel push\", () => {\n const arrayModel = new ArrayModel([0]);\n\n expect(arrayModel.rowCount()).toBe(1);\n expect(arrayModel.rowData(0)).toBe(0);\n\n arrayModel.push(2);\n expect(arrayModel.rowCount()).toBe(2);\n expect(arrayModel.rowData(1)).toBe(2);\n});\n\ntest(\"ArrayModel setRowData\", () => {\n const arrayModel = new ArrayModel([0]);\n\n expect(arrayModel.rowCount()).toBe(1);\n expect(arrayModel.rowData(0)).toBe(0);\n\n arrayModel.setRowData(0, 2);\n expect(arrayModel.rowCount()).toBe(1);\n expect(arrayModel.rowData(0)).toBe(2);\n});\n\ntest(\"ArrayModel remove\", () => {\n const arrayModel = new ArrayModel([0, 2, 1]);\n\n expect(arrayModel.rowCount()).toBe(3);\n expect(arrayModel.rowData(0)).toBe(0);\n expect(arrayModel.rowData(1)).toBe(2);\n\n arrayModel.remove(0, 2);\n expect(arrayModel.rowCount()).toBe(1);\n expect(arrayModel.rowData(0)).toBe(1);\n});\n" }, { "path": "api/node/__test__/window.spec.mts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { test, expect } from \"vitest\";\n\nimport { private_api, Window } from \"../dist/index.js\";\n\ntest(\"Window constructor\", () => {\n let thrownError: any;\n try {\n new private_api.Window();\n } catch (error) {\n thrownError = error;\n }\n expect(thrownError).toBeDefined();\n expect(thrownError.code).toBe(\"GenericFailure\");\n expect(thrownError.message).toBe(\n \"Window can only be created by using a Component.\",\n );\n});\n\ntest(\"Window show / hide\", () => {\n const compiler = new private_api.ComponentCompiler();\n const definition = compiler.buildFromSource(\n `\n\n export component App inherits Window {\n width: 300px;\n height: 300px;\n }`,\n \"\",\n );\n expect(definition.App).not.toBeNull();\n\n const instance = definition.App!.create();\n expect(instance).not.toBeNull();\n\n const window = instance!.window();\n expect(window.visible).toBe(false);\n window.show();\n expect(window.visible).toBe(true);\n window.hide();\n expect(window.visible).toBe(false);\n});\n" }, { "path": "api/node/binaries.json", "content": "{\n \"binaryName\": \"slint-ui\",\n \"packageName\": \"@slint-ui/slint-ui-binary\",\n \"targets\": [\n \"x86_64-unknown-linux-gnu\",\n \"aarch64-unknown-linux-gnu\",\n \"aarch64-apple-darwin\",\n \"x86_64-pc-windows-msvc\",\n \"aarch64-pc-windows-msvc\"\n ]\n}\n" }, { "path": "api/node/biome.json", "content": "{\n \"root\": true,\n \"extends\": [\"../../biome.json\"],\n \"files\": {\n \"includes\": [\n \"**\",\n \"!**/docs/\",\n \"!rust-module.d.cts\",\n \"!rust-module.cjs\"\n ]\n },\n \"linter\": {\n \"rules\": {\n \"complexity\": {\n \"useArrowFunction\": \"off\",\n \"noForEach\": \"off\",\n \"noArguments\": \"off\"\n },\n \"style\": {\n \"noNonNullAssertion\": \"off\",\n \"noUnusedTemplateLiteral\": \"off\",\n \"useTemplate\": \"off\",\n \"noInferrableTypes\": \"off\",\n \"noParameterAssign\": \"off\",\n \"useAsConstAssertion\": \"error\",\n \"useDefaultParameterLast\": \"error\",\n \"useEnumInitializers\": \"error\",\n \"useSelfClosingElements\": \"error\",\n \"useSingleVarDeclarator\": \"error\",\n \"useNumberNamespace\": \"error\",\n \"noUselessElse\": \"error\"\n },\n \"suspicious\": {\n \"noExplicitAny\": \"off\",\n \"noAssignInExpressions\": \"off\",\n \"noVar\": \"off\"\n }\n }\n }\n}\n" }, { "path": "api/node/build-on-demand.mjs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n// This file checks if a binary package was installed (through architecture dependencies), and\n// builds slint if no binary was found.\n\nimport { Worker } from \"node:worker_threads\";\nimport { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\n\nconst worker = new Worker(\"./rust-module.cjs\");\n// Define dummy error handler to prevent node from aborting on errors\nworker.on(\"error\", (error) => {\n //console.log(`Error loading rust-module.cjs: {error}`);\n});\nworker.on(\"exit\", (code) => {\n if (code !== 0) {\n // HACK: npm package removes .npmignore. If the file is present, then it means that we're in the Slint git repo,\n // and we don't want to automatically build (see https://github.com/slint-ui/slint/pull/6780).\n if (!existsSync(\"./.npmignore\")) {\n console.log(\n \"slint-ui: loading rust-module.cjs failed, building now\",\n );\n spawn(\"npm\", [\"run\", \"build\"], {\n stdio: \"inherit\",\n });\n }\n }\n});\n" }, { "path": "api/node/build.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfn main() {\n napi_build::setup();\n\n // workaround bug that the `#[napi]` macro generate some invalid `#[cfg(feature=\"...\")]`\n println!(\"cargo:rustc-check-cfg=cfg(feature,values(\\\"noop\\\", \\\"used_linker\\\"))\");\n}\n" }, { "path": "api/node/cover.md", "content": "# Slint-node (Beta)\n\n[![npm](https://img.shields.io/npm/v/slint-ui)](https://www.npmjs.com/package/slint-ui)\n\n[Slint](https://slint.dev/) is a UI toolkit that supports different programming languages.\nSlint-node is the integration with [Node.js](https://nodejs.org/en) and [Deno](https://deno.com).\n\nTo get started you use the [walk-through tutorial](https://slint.dev/docs/slint/tutorial/quickstart).\nWe also have a [Getting Started Template](https://github.com/slint-ui/slint-nodejs-template) repository with\nthe code of a minimal application using Slint that can be used as a starting point to your program.\n\n**Warning: Beta**\nSlint-node is still in the early stages of development: APIs will change and important features are still being developed.\n\n## Slint Language Manual\n\nThe [Slint Language Documentation](http://slint.dev/docs/slint) covers the Slint UI description language\nin detail.\n\n## Prerequisites\n\nTo use Slint with Node.js, ensure the following programs are installed:\n\n * **[Node.js](https://nodejs.org/download/release/)** (v20 or newer)\n * **[npm](https://www.npmjs.com/)**\n\nTo use Slint with Deno, ensure the following programs are installed:\n\n * **[Deno](https://docs.deno.com/runtime/manual)**\n\n### Building from Source\n\nSlint-node comes with pre-built binaries for macOS, Linux, and Windows. If you'd like to use Slint-node on a system\nwithout pre-built binaries, you need to additional software:\n\n * **[Rust compiler](https://www.rust-lang.org/tools/install)**\n * Depending on your operating system, you may need additional components. For a list of required system libraries,\n see .\n\n## Getting Started (Node.js)\n\n1. In a new directory, create a new Node.js project by calling [`npm init`](https://docs.npmjs.com/cli/v10/commands/npm-init).\n2. Install Slint for your project using [`npm install slint-ui`](https://docs.npmjs.com/cli/v10/commands/npm-install).\n3. Create a new file called `main.slint` with the following contents:\n\n```\nimport { AboutSlint, Button, VerticalBox } from \"std-widgets.slint\";\nexport component Demo inherits Window {\n in-out property greeting <=> label.text;\n VerticalBox {\n alignment: start;\n label := Text {\n text: \"Hello World!\";\n font-size: 24px;\n horizontal-alignment: center;\n }\n AboutSlint {\n preferred-height: 150px;\n }\n HorizontalLayout { alignment: center; Button { text: \"OK!\"; } }\n }\n}\n```\n\nThis file declares the user interface.\n\n4. Create a new file called `index.mjs` with the following contents:\n\n```js\nimport * as slint from \"slint-ui\";\nlet ui = slint.loadFile(new URL(\"main.slint\", import.meta.url));\nlet demo = new ui.Demo();\n\nawait demo.run();\n```\n\nThis is your main JavaScript entry point:\n\n* Import the Slint API as an [ECMAScript module](https://nodejs.org/api/esm.html#modules-ecmascript-modules) module. If you prefer you can\n also import it as [CommonJS](https://nodejs.org/api/modules.html#modules-commonjs-modules) module.\n* Invoke `loadFile()` to compile and load the `.slint` file.\n* Instantiate the `Demo` component declared in `main.slint`.\n* Run it by showing it on the screen and reacting to user input.\n\n5. Run the example with `node index.mjs`\n\nFor a complete example, see [/examples/todo/node](https://github.com/slint-ui/slint/tree/master/examples/todo/node).\n\n## Getting Started (Deno)\n\n1. Create a new file called `main.slint` with the following contents:\n\n```\nimport { AboutSlint, Button, VerticalBox } from \"std-widgets.slint\";\nexport component Demo inherits Window {\n in-out property greeting <=> label.text;\n VerticalBox {\n alignment: start;\n label := Text {\n text: \"Hello World!\";\n font-size: 24px;\n horizontal-alignment: center;\n }\n AboutSlint {\n preferred-height: 150px;\n }\n HorizontalLayout { alignment: center; Button { text: \"OK!\"; } }\n }\n}\n```\n\nThis file declares the user interface.\n\n2. Create a new file called `deno.json` (a [Deno Import Map](https://docs.deno.com/runtime/manual/basics/import_maps))\n with the following contents:\n\n```json\n{\n \"imports\": {\n \"slint-ui\": \"npm:slint-ui\"\n }\n}\n```\n\n3. Create a new file called `index.ts` with the following contents:\n\n```ts\nimport * as slint from \"slint-ui\";\nlet ui = slint.loadFile(new URL(\"main.slint\", import.meta.url));\nlet demo = new ui.Demo();\n\nawait demo.run();\n```\n\nThis is your main JavaScript entry point:\n\n* Import the Slint API as an [ECMAScript module](https://nodejs.org/api/esm.html#modules-ecmascript-modules) module through Deno's\n NPM compatibility layer.\n* Invoke `loadFile()` to compile and load the `.slint` file.\n* Instantiate the `Demo` component declared in `main.slint`.\n* Run it by showing it on the screen and reacting to user input.\n\n1. Run the example with `deno run --allow-read --allow-ffi --allow-sys index.ts`\n\n\n## Getting Started (bun)\n\n1. In a new directory, create a new `bun` project by calling [`bun init`](https://bun.sh/docs/cli/init).\n2. Install Slint for your project using [`bun install slint-ui`](https://bun.sh/docs/cli/install).\n3. Create a new file called `main.slint` with the following contents:\n\n```\nimport { AboutSlint, Button, VerticalBox } from \"std-widgets.slint\";\nexport component Demo inherits Window {\n in-out property greeting <=> label.text;\n VerticalBox {\n alignment: start;\n label := Text {\n text: \"Hello World!\";\n font-size: 24px;\n horizontal-alignment: center;\n }\n AboutSlint {\n preferred-height: 150px;\n }\n HorizontalLayout { alignment: center; Button { text: \"OK!\"; } }\n }\n}\n```\n\nThis file declares the user interface.\n\n4. Clear the content of `index.ts` and add the following code:\n\n```ts\nimport * as slint from \"slint-ui\";\nlet ui = slint.loadFile(new URL(\"main.slint\", import.meta.url)) as any;\nlet demo = new ui.Demo();\n\nawait demo.run();\n```\n\nThis is your main TypeScript entry point:\n\n* Import the Slint API as an [ECMAScript module](https://nodejs.org/api/esm.html#modules-ecmascript-modules) module.\n* Invoke `loadFile()` to compile and load the `.slint` file.\n* Instantiate the `Demo` component declared in `main.slint`.\n* Run it by showing it on the screen and reacting to user input.\n\n5. Run the example with `bun run index.ts`\n\n\n## API Overview\n\n### Instantiating a Component\n\nUse the {@link loadFile} function to load a `.slint` file. Instantiate the [exported component](http://slint.dev/docs/slint/guide/language/coding/file/)\nwith the new operator. Access exported callbacks and properties as JavaScript properties on the instantiated component. In addition,\nthe returned object implements the {@link ComponentHandle} interface, to show/hide the instance or access the window.\n\nThe following example shows how to instantiating a Slint component from JavaScript.\n\n**`ui/main.slint`**\n\n```\nexport component MainWindow inherits Window {\n callback clicked <=> i-touch-area.clicked;\n\n in property counter;\n\n width: 400px;\n height: 200px;\n\n i-touch-area := TouchArea {}\n}\n```\n\nThe exported component is exposed as a type constructor. The type constructor takes as parameter\nan object which allow to initialize the value of public properties or callbacks.\n\n**`main.mjs`**\n\n```js\nimport * as slint from \"slint-ui\";\n// In this example, the main.slint file exports a module which\n// has a counter property and a clicked callback\nlet ui = slint.loadFile(new URL(\"ui/main.slint\", import.meta.url));\nlet component = new ui.MainWindow({\n counter: 42,\n clicked: function() { console.log(\"hello\"); }\n});\n```\n\n### Accessing a Properties\n\n[Properties](http://slint.dev/docs/slint/guide/language/coding/properties/) declared as `out` or `in-out` in `.slint` files are visible as JavaScript properties on the component instance.\n\n**`main.slint`**\nexport component MainWindow {\n in-out property name;\n in-out property age: 42;\n}\n\n```js\nlet ui = slint.loadFile(new URL(\"main.slint\", import.meta.url));\nlet instance = new ui.MainWindow();\nconsole.log(instance.age); // Prints 42\ninstance.name = \"Joe\";\n```\n\n### Setting and Invoking Callbacks\n\n[Callbacks](http://slint.dev/docs/slint/guide/language/coding/functions-and-callbacks/) declared in `.slint` files are visible as JavaScript function properties on the component instance. Invoke them\nas function to invoke the callback, and assign JavaScript functions to set the callback handler.\n\n**`ui/my-component.slint`**\n\n```\nexport component MyComponent inherits Window {\n callback clicked <=> i-touch-area.clicked;\n\n width: 400px;\n height: 200px;\n\n i-touch-area := TouchArea {}\n}\n```\n\n**`main.mjs`**\n\n```js\nimport * as slint from \"slint-ui\";\n\nlet ui = slint.loadFile(new URL(\"ui/my-component.slint\", import.meta.url));\nlet component = new ui.MyComponent();\n\n// connect to a callback\ncomponent.clicked = function() { console.log(\"hello\"); };\n// emit a callback\ncomponent.clicked();\n```\n\n### Type Mappings\n\nThe types used for properties in .slint design markup each translate to specific types in JavaScript. The follow table summarizes the entire mapping:\n\n| `.slint` Type | JavaScript Type | Notes |\n| --- | --- | --- |\n| `int` | `Number` | |\n| `bool` | `Boolean` | |\n| `float` | `Number` | |\n| `string` | `String` | |\n| `color` | {@link RgbaColor} | |\n| `brush` | {@link Brush} | |\n| `image` | {@link ImageData} | |\n| `length` | `Number` | |\n| `physical_length` | `Number` | |\n| `duration` | `Number` | The number of milliseconds |\n| `angle` | `Number` | The angle in degrees |\n| `relative-font-size` | `Number` | Relative font size factor that is multiplied with the `Window.default-font-size` and can be converted to a `length`. |\n| structure | `Object` | Structures are mapped to JavaScript objects where each structure field is a property. |\n| array | {@link Model} | |\n\n### Arrays and Models\n\n[Array properties](http://slint.dev/docs/slint/guide/language/coding/repetition-and-data-models#arrays-and-models) can be set from JavaScript by passing\neither `Array` objects or implementations of the {@link Model} interface.\n\nWhen passing a JavaScript `Array` object, the contents of the array are copied. Any changes to the JavaScript afterwards will not be visible on the Slint side.\n\nReading a Slint array property from JavaScript will always return a @{link Model}.\n\n```js\ncomponent.model = [1, 2, 3];\n// component.model.push(4); // does not work, because assignment creates a copy.\n// Use re-assignment instead.\ncomponent.model = component.model.concat(4);\n```\n\nAnother option is to set an object that implements the {@link Model} interface.\n\n### structs\n\nAn exported struct can be created either by defing of an object literal or by using the new keyword.\n\n**`my-component.slint`**\n\n```\nexport struct Person {\n name: string,\n age: int\n}\n\nexport component MyComponent inherits Window {\n in-out property person;\n}\n```\n\n**`main.js`**\n\n```js\n\nimport * as slint from \"slint-ui\";\n\nlet ui = slint.loadFile(new URL(\"my-component.slint\", import.meta.url));\nlet component = new ui.MyComponent();\n\n// object literal\ncomponent.person = { name: \"Peter\", age: 22 };\n\n// new keyword (sets property values to default e.g. '' for string)\ncomponent.person = new ui.Person();\n\n// new keyword with parameters\ncomponent.person = new ui.Person({ name: \"Tim\", age: 30 });\n```\n\n### enums\n\nA value of an exported enum can be set as string or by using the value from the exported enum.\n\n**`my-component.slint`**\n\n```\nexport enum Position {\n top,\n bottom\n}\n\nexport component MyComponent inherits Window {\n in-out property position;\n}\n```\n\n**`main.js`**\n\n```js\n\nimport * as slint from \"slint-ui\";\n\nlet ui = slint.loadFile(new URL(\"my-component.slint\", import.meta.url));\nlet component = new ui.MyComponent();\n\n// set enum value as string\ncomponent.position = \"top\";\n\n// use the value of the enum\ncomponent.position = ui.Position.bottom;\n```\n\n### Globals\n\nYou can declare [globally available singletons](http://slint.dev/docs/slint/guide/language/coding/globals) in your\n`.slint` files. If exported, these singletons are accessible as properties on your main\ncomponen instance. Each global singleton is represented by an object with properties and callbacks,\nsimilar to API that's created for your `.slint` component.\n\nFor example the following `.slint` markup defines a global `Logic` singleton that's also exported:\n\n```\nexport global Logic {\n callback to_uppercase(string) -> string;\n}\n```\n\nAssuming this global is used together with the `MyComponent` from the\nprevious section, you can access `Logic` like this:\n\n```js\nimport * as slint from \"slint-ui\";\n\nlet ui = slint.loadFile(new URL(\"ui/my-component.slint\", import.meta.url));\nlet component = new ui.MyComponent();\n\ncomponent.Logic.to_upper_case = (str) => {\n return str.toUpperCase();\n};\n```\n\n**Note**: Global singletons are instantiated once per component. When declaring multiple components for `export` to JavaScript,\neach instance will have their own instance of associated globals singletons.\n\n## Third-Party Licenses\n\nFor a list of the third-party licenses of all dependencies, see the separate [Third-Party Licenses page](thirdparty.html).\n" }, { "path": "api/node/package.json", "content": "{\n \"name\": \"slint-ui\",\n \"version\": \"1.16.0\",\n \"main\": \"dist/index.js\",\n \"types\": \"dist/index.d.ts\",\n \"homepage\": \"https://github.com/slint-ui/slint\",\n \"license\": \"SEE LICENSE IN LICENSE.md\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/slint-ui/slint\"\n },\n \"keywords\": [\n \"GUI\",\n \"UI\",\n \"native\",\n \"node\",\n \"Slint\",\n \"desktop\",\n \"embedded\"\n ],\n \"description\": \"Slint is a declarative GUI toolkit to build native user interfaces for desktop and embedded applications.\",\n \"devDependencies\": {\n \"@biomejs/biome\": \"catalog:\",\n \"@types/capture-console\": \"1.0.5\",\n \"@types/node\": \"catalog:\",\n \"capture-console\": \"1.0.2\",\n \"image-js\": \"1.4.0\",\n \"typedoc\": \"0.28.17\",\n \"typescript\": \"catalog:\",\n \"vitest\": \"catalog:\"\n },\n \"engines\": {\n \"node\": \">= 10\"\n },\n \"scripts\": {\n \"artifacts\": \"napi artifacts\",\n \"compile\": \"tsc --build\",\n \"build\": \"napi build --platform --release --js rust-module.cjs --dts rust-module.d.cts -c binaries.json\",\n \"build:debug\": \"napi build --platform --js rust-module.cjs --dts rust-module.d.cts -c binaries.json && pnpm compile\",\n \"build:testing\": \"napi build --platform --js rust-module.cjs --dts rust-module.d.cts -c binaries.json --features testing && pnpm compile\",\n \"install\": \"node build-on-demand.mjs\",\n \"docs\": \"pnpm build && typedoc --hideGenerator --readme cover.md typescript/index.ts && cargo about generate thirdparty.hbs -o docs/thirdparty.html\",\n \"docs:debug\": \"pnpm build:debug && typedoc --hideGenerator --readme cover.md typescript/index.ts\",\n \"check\": \"biome check\",\n \"format\": \"biome format\",\n \"format:fix\": \"biome format --write\",\n \"lint\": \"biome lint\",\n \"lint:fix\": \"biome lint --fix\",\n \"test\": \"vitest run\"\n },\n \"dependencies\": {\n \"@napi-rs/cli\": \"^3.5.1\"\n }\n}\n" }, { "path": "api/node/rust/interpreter/component_compiler.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse super::JsComponentDefinition;\nuse super::JsDiagnostic;\nuse i_slint_compiler::langtype::Type;\nuse itertools::Itertools;\nuse napi::bindgen_prelude::*;\nuse napi::{Env, JsValue};\nuse slint_interpreter::Compiler;\nuse slint_interpreter::Value;\nuse smol_str::StrExt;\nuse std::collections::HashMap;\nuse std::path::PathBuf;\n\n/// ComponentCompiler is the entry point to the Slint interpreter that can be used\n/// to load .slint files or compile them on-the-fly from a string.\n#[napi(js_name = \"ComponentCompiler\")]\npub struct JsComponentCompiler {\n internal: Compiler,\n structs_and_enums: Vec,\n diagnostics: Vec,\n}\n\n#[napi]\nimpl JsComponentCompiler {\n /// Returns a new ComponentCompiler.\n #[napi(constructor)]\n pub fn new() -> Self {\n let mut compiler = Compiler::default();\n let include_paths = match std::env::var_os(\"SLINT_INCLUDE_PATH\") {\n Some(paths) => {\n std::env::split_paths(&paths).filter(|path| !path.as_os_str().is_empty()).collect()\n }\n None => Vec::new(),\n };\n let library_paths = match std::env::var_os(\"SLINT_LIBRARY_PATH\") {\n Some(paths) => std::env::split_paths(&paths)\n .filter_map(|entry| {\n entry\n .to_str()\n .unwrap_or_default()\n .split('=')\n .collect_tuple()\n .map(|(k, v)| (k.into(), v.into()))\n })\n .collect(),\n None => HashMap::new(),\n };\n\n compiler.set_include_paths(include_paths);\n compiler.set_library_paths(library_paths);\n Self { internal: compiler, diagnostics: Vec::new(), structs_and_enums: vec![] }\n }\n\n #[napi(setter)]\n pub fn set_include_paths(&mut self, include_paths: Vec) {\n self.internal.set_include_paths(include_paths.iter().map(PathBuf::from).collect());\n }\n\n #[napi(getter)]\n pub fn include_paths(&self) -> Vec {\n self.internal\n .include_paths()\n .iter()\n .map(|p| p.to_str().unwrap_or_default().to_string())\n .collect()\n }\n\n #[napi(setter)]\n pub fn set_library_paths(&mut self, paths: HashMap) {\n let mut library_paths = HashMap::new();\n for (key, path) in paths {\n library_paths.insert(key, PathBuf::from(path));\n }\n\n self.internal.set_library_paths(library_paths);\n }\n\n #[napi(getter)]\n pub fn library_paths(&self) -> HashMap {\n let mut library_paths = HashMap::new();\n\n for (key, path) in self.internal.library_paths() {\n library_paths.insert(key.clone(), path.to_str().unwrap_or_default().to_string());\n }\n\n library_paths\n }\n\n #[napi(setter)]\n pub fn set_style(&mut self, style: String) {\n self.internal.set_style(style);\n }\n\n #[napi(getter)]\n pub fn style(&self) -> Option {\n self.internal.style().cloned()\n }\n\n #[napi(getter)]\n pub fn diagnostics(&self) -> Vec {\n self.diagnostics.iter().map(|d| JsDiagnostic::from(d.clone())).collect()\n }\n\n #[napi(getter)]\n pub fn structs<'a>(&self, env: &'a Env) -> HashMap> {\n fn convert_type<'a>(env: &'a Env, ty: &Type) -> Option<(String, Unknown<'a>)> {\n match ty {\n Type::Struct(s) if s.node().is_some() => {\n let name = s.name.slint_name().unwrap();\n let struct_instance = crate::to_js_unknown(\n env,\n &Value::Struct(slint_interpreter::Struct::from_iter(s.fields.iter().map(\n |(name, field_type)| {\n (\n name.to_string(),\n slint_interpreter::default_value_for_type(field_type),\n )\n },\n ))),\n );\n\n Some((name.to_string(), struct_instance.ok()?))\n }\n _ => None,\n }\n }\n\n self.structs_and_enums\n .iter()\n .filter_map(|ty| convert_type(env, ty))\n .collect::>>()\n }\n\n #[napi(getter)]\n pub fn enums<'a>(&self, env: &'a Env) -> HashMap> {\n fn convert_type<'a>(env: &'a Env, ty: &Type) -> Option<(String, Unknown<'a>)> {\n match ty {\n Type::Enumeration(en) => {\n let mut o = Object::new(env).ok()?;\n\n for value in en.values.iter() {\n let value = value.replace_smolstr(\"-\", \"_\");\n let str_val = env.create_string(&value).ok()?;\n o.set_named_property(&value, str_val).ok()?;\n }\n Some((en.name.to_string(), o.into_unknown(env).ok()?))\n }\n _ => None,\n }\n }\n\n self.structs_and_enums\n .iter()\n .filter_map(|ty| convert_type(env, ty))\n .collect::>>()\n }\n\n #[napi(setter)]\n pub fn set_file_loader(\n &mut self,\n env: &Env,\n callback: crate::DynFunction<'_>,\n ) -> napi::Result<()> {\n let stored_fn = std::rc::Rc::new(crate::StoredFunction::new(&callback)?);\n let env = *env;\n\n self.internal.set_file_loader(move |path| {\n let path = PathBuf::from(path);\n let stored_fn = stored_fn.clone();\n Box::pin({\n async move {\n let Ok(path_str) = env.create_string(path.display().to_string().as_str())\n else {\n return Some(Err(std::io::Error::other(\n \"Node.js: wrong argument for callback file_loader.\",\n )));\n };\n\n let Ok(result) = stored_fn.call(&env, vec![path_str.raw()]) else {\n return Some(Err(std::io::Error::other(\n \"Node.js: file loader callback failed.\",\n )));\n };\n\n let js_string = result.coerce_to_string();\n let Ok(js_string) = js_string else {\n return Some(Err(std::io::Error::other(\n \"Node.js: cannot read return value of file loader callback as js string.\",\n )));\n };\n\n let Ok(utf8_string) = js_string.into_utf8() else {\n return Some(Err(std::io::Error::other(\n \"Node.js: cannot convert return value of file loader callback into utf8.\",\n )));\n };\n\n if let Ok(str) = utf8_string.as_str() {\n let string = str.to_string();\n\n return Some(Ok(string));\n };\n\n Some(Err(std::io::Error::other(\n \"Node.js: cannot convert return value of file loader callback into string.\",\n )))\n }\n })\n });\n\n Ok(())\n }\n\n /// Compile a .slint file into a ComponentDefinition\n ///\n /// Returns the compiled `ComponentDefinition` if there were no errors.\n #[napi]\n pub fn build_from_path(&mut self, path: String) -> HashMap {\n let r = spin_on::spin_on(self.internal.build_from_path(PathBuf::from(path)));\n self.structs_and_enums =\n r.structs_and_enums(i_slint_core::InternalToken {}).cloned().collect::>();\n self.diagnostics = r.diagnostics().collect();\n r.components().map(|c| (c.name().to_owned(), c.into())).collect()\n }\n\n /// Compile some .slint code into a ComponentDefinition\n #[napi]\n pub fn build_from_source(\n &mut self,\n source_code: String,\n path: String,\n ) -> HashMap {\n let r = spin_on::spin_on(self.internal.build_from_source(source_code, PathBuf::from(path)));\n self.diagnostics = r.diagnostics().collect();\n self.structs_and_enums =\n r.structs_and_enums(i_slint_core::InternalToken {}).cloned().collect::>();\n r.components().map(|c| (c.name().to_owned(), c.into())).collect()\n }\n}\n" }, { "path": "api/node/rust/interpreter/component_definition.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse napi::Result;\nuse slint_interpreter::ComponentDefinition;\n\nuse super::{JsComponentInstance, JsProperty};\n\n#[napi(js_name = \"ComponentDefinition\")]\npub struct JsComponentDefinition {\n internal: ComponentDefinition,\n}\n\nimpl From for JsComponentDefinition {\n fn from(definition: ComponentDefinition) -> Self {\n Self { internal: definition }\n }\n}\n\n#[napi]\nimpl JsComponentDefinition {\n #[napi(constructor)]\n pub fn new() -> napi::Result {\n Err(napi::Error::from_reason(\n \"ComponentDefinition can only be created by using ComponentCompiler.\".to_string(),\n ))\n }\n\n #[napi(getter)]\n pub fn properties(&self) -> Vec {\n self.internal\n .properties()\n .map(|(name, value_type)| JsProperty { name, value_type: value_type.into() })\n .collect()\n }\n\n #[napi(getter)]\n pub fn callbacks(&self) -> Vec {\n self.internal.callbacks().collect()\n }\n\n #[napi(getter)]\n pub fn functions(&self) -> Vec {\n self.internal.functions().collect()\n }\n\n #[napi(getter)]\n pub fn globals(&self) -> Vec {\n self.internal.globals().collect()\n }\n\n #[napi]\n pub fn global_properties(&self, global_name: String) -> Option> {\n self.internal.global_properties(global_name.as_str()).map(|iter| {\n iter.map(|(name, value_type)| JsProperty { name, value_type: value_type.into() })\n .collect()\n })\n }\n\n #[napi]\n pub fn global_callbacks(&self, global_name: String) -> Option> {\n self.internal.global_callbacks(global_name.as_str()).map(|iter| iter.collect())\n }\n\n #[napi]\n pub fn global_functions(&self, global_name: String) -> Option> {\n self.internal.global_functions(global_name.as_str()).map(|iter| iter.collect())\n }\n\n #[napi]\n pub fn create(&self) -> Result {\n Ok(self.internal.create().map_err(|e| napi::Error::from_reason(e.to_string()))?.into())\n }\n\n #[napi(getter)]\n pub fn name(&self) -> String {\n self.internal.name().into()\n }\n}\n" }, { "path": "api/node/rust/interpreter/component_instance.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse i_slint_compiler::langtype::Type;\nuse i_slint_core::window::WindowInner;\nuse napi::bindgen_prelude::*;\nuse napi::{Env, Result};\nuse slint_interpreter::{ComponentHandle, ComponentInstance, Value};\n\nuse crate::JsWindow;\n\nuse super::JsComponentDefinition;\n\n#[napi(js_name = \"ComponentInstance\")]\npub struct JsComponentInstance {\n inner: ComponentInstance,\n}\n\nimpl From for JsComponentInstance {\n fn from(instance: ComponentInstance) -> Self {\n Self { inner: instance }\n }\n}\n\n#[napi]\nimpl JsComponentInstance {\n #[napi(constructor)]\n pub fn new() -> napi::Result {\n Err(napi::Error::from_reason(\n \"ComponentInstance can only be created by using ComponentCompiler.\".to_string(),\n ))\n }\n\n #[napi]\n pub fn definition(&self) -> JsComponentDefinition {\n self.inner.definition().into()\n }\n\n #[napi]\n pub fn get_property<'a>(&self, env: &'a Env, name: String) -> Result> {\n let value = self\n .inner\n .get_property(name.as_ref())\n .map_err(|e| napi::Error::from_reason(e.to_string()))?;\n super::value::to_js_unknown(env, &value)\n }\n\n #[napi]\n pub fn set_property(&self, env: &Env, prop_name: String, js_value: Unknown<'_>) -> Result<()> {\n let (ty, _) = self\n .inner\n .definition()\n .properties_and_callbacks()\n .find_map(|(name, proptype)| if name == prop_name { Some(proptype) } else { None })\n .ok_or(())\n .map_err(|_| {\n napi::Error::from_reason(format!(\"Property {prop_name} not found in the component\"))\n })?;\n\n self.inner\n .set_property(&prop_name, super::value::to_value(env, js_value, &ty)?)\n .map_err(|e| napi::Error::from_reason(format!(\"{e}\")))?;\n\n Ok(())\n }\n\n #[napi]\n pub fn get_global_property<'a>(\n &self,\n env: &'a Env,\n global_name: String,\n name: String,\n ) -> Result> {\n if !self.definition().globals().contains(&global_name) {\n return Err(napi::Error::from_reason(format!(\"Global {global_name} not found\")));\n }\n let value = self\n .inner\n .get_global_property(global_name.as_ref(), name.as_ref())\n .map_err(|e| napi::Error::from_reason(e.to_string()))?;\n super::value::to_js_unknown(env, &value)\n }\n\n #[napi]\n pub fn set_global_property(\n &self,\n env: &Env,\n global_name: String,\n prop_name: String,\n js_value: Unknown<'_>,\n ) -> Result<()> {\n let (ty, _) = self\n .inner\n .definition()\n .global_properties_and_callbacks(global_name.as_str())\n .ok_or(napi::Error::from_reason(format!(\"Global {global_name} not found\")))?\n .find_map(|(name, proptype)| if name == prop_name { Some(proptype) } else { None })\n .ok_or(())\n .map_err(|_| {\n napi::Error::from_reason(format!(\n \"Property {prop_name} of global {global_name} not found in the component\"\n ))\n })?;\n\n self.inner\n .set_global_property(\n global_name.as_str(),\n &prop_name,\n super::value::to_value(env, js_value, &ty)?,\n )\n .map_err(|e| napi::Error::from_reason(format!(\"{e}\")))?;\n\n Ok(())\n }\n\n #[napi]\n pub fn set_callback(\n &self,\n env: &Env,\n callback_name: String,\n callback: DynFunction<'_>,\n ) -> Result<()> {\n let function_ref = StoredFunction::new(&callback)?;\n let env = *env;\n\n let (ty, _) = self\n .inner\n .definition()\n .properties_and_callbacks()\n .find_map(|(name, proptype)| if name == callback_name { Some(proptype) } else { None })\n .ok_or(())\n .map_err(|_| {\n napi::Error::from_reason(format!(\n \"Callback {callback_name} not found in the component\"\n ))\n })?;\n\n if let Type::Callback(callback) = ty {\n self.inner\n .set_callback(callback_name.as_str(), {\n let return_type = callback.return_type.clone();\n let callback_name = callback_name.clone();\n\n move |args| {\n let js_args: Vec = args\n .iter()\n .filter_map(|v| Some(super::value::to_js_unknown(&env, v).ok()?.raw()))\n .collect();\n\n let result = match function_ref.call(&env, js_args) {\n Ok(result) => result,\n Err(err) => {\n crate::console_err!(\n env,\n \"Node.js: Invoking callback '{callback_name}' failed: {err}\"\n );\n return Value::Void;\n }\n };\n\n if matches!(return_type, Type::Void) {\n Value::Void\n } else if let Ok(value) = super::to_value(&env, result, &return_type) {\n value\n } else {\n eprintln!(\n \"Node.js: cannot convert return type of callback {callback_name}\"\n );\n slint_interpreter::default_value_for_type(&return_type)\n }\n }\n })\n .map_err(|_| napi::Error::from_reason(\"Cannot set callback.\"))?;\n\n return Ok(());\n }\n\n Err(napi::Error::from_reason(format!(\"{callback_name} is not a callback\").as_str()))\n }\n\n #[napi]\n pub fn set_global_callback(\n &self,\n env: &Env,\n global_name: String,\n callback_name: String,\n callback: DynFunction<'_>,\n ) -> Result<()> {\n let function_ref = StoredFunction::new(&callback)?;\n let env = *env;\n\n let (ty, _) = self\n .inner\n .definition()\n .global_properties_and_callbacks(global_name.as_str())\n .ok_or(napi::Error::from_reason(format!(\"Global {global_name} not found\")))?\n .find_map(|(name, proptype)| if name == callback_name { Some(proptype) } else { None })\n .ok_or(())\n .map_err(|_| {\n napi::Error::from_reason(format!(\n \"Callback {callback_name} of global {global_name} not found in the component\"\n ))\n })?;\n\n if let Type::Callback(callback) = ty {\n self.inner\n .set_global_callback(global_name.as_str(), callback_name.as_str(), {\n let return_type = callback.return_type.clone();\n let _global_name = global_name.clone();\n let callback_name = callback_name.clone();\n\n move |args| {\n let js_args: Vec = args\n .iter()\n .filter_map(|v| Some(super::value::to_js_unknown(&env, v).ok()?.raw()))\n .collect();\n\n let result = match function_ref.call(&env, js_args) {\n Ok(result) => result,\n Err(err) => {\n crate::console_err!(env, \"Node.js: Invoking global callback '{callback_name}' failed: {err}\");\n return Value::Void;\n }\n };\n\n if matches!(return_type, Type::Void) {\n Value::Void\n } else if let Ok(value) = super::to_value(&env, result, &return_type) {\n value\n } else {\n eprintln!(\"Node.js: cannot convert return type of callback {callback_name}\");\n slint_interpreter::default_value_for_type(&return_type)\n }\n }\n })\n .map_err(|_| napi::Error::from_reason(\"Cannot set callback.\"))?;\n\n return Ok(());\n }\n\n Err(napi::Error::from_reason(format!(\"{callback_name} is not a callback\").as_str()))\n }\n\n fn invoke_args(\n env: &Env,\n callback_name: &String,\n arguments: Vec>,\n args: &[Type],\n ) -> Result> {\n let count = args.len();\n let args = arguments\n .into_iter()\n .zip(args)\n .map(|(a, ty)| super::value::to_value(env, a, ty))\n .collect::, _>>()?;\n if args.len() != count {\n return Err(napi::Error::from_reason(\n format!(\n \"{} expect {} arguments, but {} where provided\",\n callback_name,\n count,\n args.len()\n )\n .as_str(),\n ));\n }\n Ok(args)\n }\n\n #[napi]\n pub fn invoke<'a>(\n &self,\n env: &'a Env,\n callback_name: String,\n callback_arguments: Vec>,\n ) -> Result> {\n let (ty, _) = self\n .inner\n .definition()\n .properties_and_callbacks()\n .find_map(|(name, proptype)| if name == callback_name { Some(proptype) } else { None })\n .ok_or(())\n .map_err(|_| {\n napi::Error::from_reason(\n format!(\"Callback {callback_name} not found in the component\").as_str(),\n )\n })?;\n\n let args = match ty {\n Type::Callback(function) | Type::Function(function) => {\n Self::invoke_args(env, &callback_name, callback_arguments, &function.args)?\n }\n _ => {\n return Err(napi::Error::from_reason(\n format!(\"{callback_name} is not a callback or a function\").as_str(),\n ));\n }\n };\n\n let result = self\n .inner\n .invoke(callback_name.as_str(), args.as_slice())\n .map_err(|_| napi::Error::from_reason(\"Cannot invoke callback.\"))?;\n super::to_js_unknown(env, &result)\n }\n\n #[napi]\n pub fn invoke_global<'a>(\n &self,\n env: &'a Env,\n global_name: String,\n callback_name: String,\n callback_arguments: Vec>,\n ) -> Result> {\n let (ty, _) = self\n .inner\n .definition()\n .global_properties_and_callbacks(global_name.as_str())\n .ok_or(napi::Error::from_reason(format!(\"Global {global_name} not found\")))?\n .find_map(|(name, proptype)| if name == callback_name { Some(proptype) } else { None })\n .ok_or(())\n .map_err(|_| {\n napi::Error::from_reason(\n format!(\n \"Callback {callback_name} of global {global_name} not found in the component\"\n )\n .as_str(),\n )\n })?;\n\n let args = match ty {\n Type::Callback(function) | Type::Function(function) => {\n Self::invoke_args(env, &callback_name, callback_arguments, &function.args)?\n }\n _ => {\n return Err(napi::Error::from_reason(\n format!(\n \"{callback_name} is not a callback or a function on global {global_name}\"\n )\n .as_str(),\n ));\n }\n };\n\n let result = self\n .inner\n .invoke_global(global_name.as_str(), callback_name.as_str(), args.as_slice())\n .map_err(|_| napi::Error::from_reason(\"Cannot invoke callback.\"))?;\n super::to_js_unknown(env, &result)\n }\n\n #[napi]\n pub fn send_mouse_click(&self, x: f64, y: f64) {\n slint_interpreter::testing::send_mouse_click(&self.inner, x as f32, y as f32);\n }\n\n #[napi]\n pub fn send_keyboard_string_sequence(&self, sequence: String) {\n slint_interpreter::testing::send_keyboard_string_sequence(&self.inner, sequence.into());\n }\n\n #[napi]\n pub fn window(&self) -> Result {\n Ok(JsWindow { inner: WindowInner::from_pub(self.inner.window()).window_adapter() })\n }\n}\n\n/// A reference-counted handle to a JS object, for storing object references\n/// that outlive the current scope (e.g. model implementations).\npub struct RefCountedReference {\n inner: Option,\n env: Env,\n}\n\nimpl RefCountedReference {\n pub fn new(env: &Env, value: &Object) -> Result {\n let unknown = (*value).into_unknown(env)?;\n Ok(Self { inner: Some(unknown.create_ref()?), env: *env })\n }\n\n pub fn get_unknown(&self) -> Result> {\n self.inner\n .as_ref()\n .ok_or_else(|| napi::Error::from_reason(\"Reference already dropped\"))?\n .get_value(&self.env)\n }\n}\n\nimpl Drop for RefCountedReference {\n fn drop(&mut self) {\n if let Some(r) = self.inner.take() {\n let _: napi::Result<()> = r.unref(&self.env);\n }\n }\n}\n\n/// A stored reference to a JS function that can be called with dynamic arguments.\n/// Uses `FunctionRef` for lifecycle management and compat `JsFunction::call` for invocation.\n/// Type alias for a JS function that accepts dynamic arguments.\npub type DynFunction<'a> = Function<'a, crate::DynArgs, Unknown<'static>>;\n\n/// A stored reference to a JS function that can be called with dynamic arguments.\npub struct StoredFunction {\n func_ref: FunctionRef>,\n}\n\nimpl StoredFunction {\n pub fn new(func: &DynFunction<'_>) -> Result {\n Ok(Self { func_ref: func.create_ref()? })\n }\n\n /// Call the function with dynamic raw JS values.\n pub fn call(&self, env: &Env, args: Vec) -> Result> {\n let func = self.func_ref.borrow_back(env)?;\n func.call(crate::DynArgs(args))\n }\n}\n" }, { "path": "api/node/rust/interpreter/diagnostic.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse slint_interpreter::{Diagnostic, DiagnosticLevel};\n\n/// This enum describes the level or severity of a diagnostic message produced by the compiler.\n#[napi(js_name = \"DiagnosticLevel\")]\npub enum JsDiagnosticLevel {\n /// The diagnostic found is an error that prevents successful compilation.\n Error,\n\n /// The diagnostic found is a warning.\n Warning,\n\n /// The diagnostic is a note to further help with the error or warning.\n Note,\n}\n\nimpl From for JsDiagnosticLevel {\n fn from(diagnostic_level: DiagnosticLevel) -> Self {\n match diagnostic_level {\n DiagnosticLevel::Error => JsDiagnosticLevel::Error,\n DiagnosticLevel::Warning => JsDiagnosticLevel::Warning,\n DiagnosticLevel::Note => JsDiagnosticLevel::Note,\n _ => unimplemented!(),\n }\n }\n}\n\n/// This structure represent a diagnostic emitted while compiling .slint code.\n///\n/// It is basically a message, a level (warning or error), attached to a\n/// position in the code.\n#[napi(object, js_name = \"Diagnostic\")]\npub struct JsDiagnostic {\n /// The level for this diagnostic.\n pub level: JsDiagnosticLevel,\n\n /// Message for this diagnostic.\n pub message: String,\n\n /// The line number in the .slint source file. The line number starts with 1.\n pub line_number: u32,\n\n // The column in the .slint source file. The column number starts with 1.\n pub column_number: u32,\n\n /// The path of the source file where this diagnostic occurred.\n pub file_name: Option,\n}\n\nimpl From for JsDiagnostic {\n fn from(internal_diagnostic: Diagnostic) -> Self {\n let (line_number, column) = internal_diagnostic.line_column();\n Self {\n level: internal_diagnostic.level().into(),\n message: internal_diagnostic.message().into(),\n line_number: line_number as u32,\n column_number: column as u32,\n file_name: internal_diagnostic\n .source_file()\n .and_then(|path| path.to_str())\n .map(|str| str.into()),\n }\n }\n}\n" }, { "path": "api/node/rust/interpreter/value.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse crate::{\n ReadOnlyRustModel, RgbaColor, SlintBrush, SlintImageData, js_into_rust_model,\n rust_into_js_model,\n};\nuse i_slint_compiler::langtype::Type;\nuse i_slint_core::graphics::{Image, Rgba8Pixel, SharedPixelBuffer};\nuse i_slint_core::model::{ModelRc, SharedVectorModel};\nuse i_slint_core::{Brush, Color, SharedVector};\nuse napi::bindgen_prelude::*;\nuse napi::{Env, JsValue, Result, ValueType};\nuse napi_derive::napi;\nuse slint_interpreter::Value;\nuse smol_str::SmolStr;\n\n/// A dynamic-length argument list for calling JS functions with a variable\n/// number of arguments. Implements `JsValuesTupleIntoVec` so it can be used\n/// directly with `Function::call`.\npub struct DynArgs(pub Vec);\n\nimpl JsValuesTupleIntoVec for DynArgs {\n fn into_vec(self, _env: napi::sys::napi_env) -> Result> {\n Ok(self.0)\n }\n}\n\n/// Safely extract a f64 from an Unknown, failing if the type is wrong.\nfn expect_number(unknown: Unknown<'_>) -> Result {\n match unknown.get_type()? {\n ValueType::Number => unknown.coerce_to_number()?.get_double(),\n vt => Err(napi::Error::new(\n napi::Status::NumberExpected,\n format!(\"expect Number, got: {vt:?}\"),\n )),\n }\n}\n\n/// Safely extract a String from an Unknown, failing if the type is wrong.\nfn expect_string(unknown: Unknown<'_>) -> Result {\n match unknown.get_type()? {\n ValueType::String => Ok(unknown.coerce_to_string()?.into_utf8()?.as_str()?.to_owned()),\n vt => Err(napi::Error::new(\n napi::Status::StringExpected,\n format!(\"expect String, got: {vt:?}\"),\n )),\n }\n}\n\n/// Safely extract a bool from an Unknown, failing if the type is wrong.\nfn expect_bool(unknown: Unknown<'_>) -> Result {\n match unknown.get_type()? {\n ValueType::Boolean => Ok(unknown.coerce_to_bool()?),\n vt => Err(napi::Error::new(\n napi::Status::BooleanExpected,\n format!(\"expect Boolean, got: {vt:?}\"),\n )),\n }\n}\n\n#[napi(js_name = \"ValueType\")]\npub enum JsValueType {\n Void,\n Number,\n String,\n Bool,\n Model,\n Struct,\n Brush,\n Image,\n StyledText,\n}\n\nimpl From for JsValueType {\n fn from(value_type: slint_interpreter::ValueType) -> Self {\n match value_type {\n slint_interpreter::ValueType::Number => JsValueType::Number,\n slint_interpreter::ValueType::String => JsValueType::String,\n slint_interpreter::ValueType::Bool => JsValueType::Bool,\n slint_interpreter::ValueType::Model => JsValueType::Model,\n slint_interpreter::ValueType::Struct => JsValueType::Struct,\n slint_interpreter::ValueType::Brush => JsValueType::Brush,\n slint_interpreter::ValueType::Image => JsValueType::Image,\n slint_interpreter::ValueType::StyledText => JsValueType::StyledText,\n _ => JsValueType::Void,\n }\n }\n}\n\n#[napi(js_name = \"Property\")]\npub struct JsProperty {\n pub name: String,\n pub value_type: JsValueType,\n}\n\npub fn to_js_unknown<'a>(env: &'a Env, value: &Value) -> Result> {\n match value {\n Value::Void => Null.into_unknown(env),\n Value::Number(number) => (*number).into_unknown(env),\n Value::String(string) => string.as_str().into_unknown(env),\n Value::Bool(value) => (*value).into_unknown(env),\n Value::Image(image) => {\n SlintImageData::from(image.clone()).into_instance(env)?.as_object(env).into_unknown(env)\n }\n Value::Struct(struct_value) => {\n let mut o = Object::new(env)?;\n for (field_name, field_value) in struct_value.iter() {\n let key = env.create_string(field_name.replace('-', \"_\"))?;\n let val = to_js_unknown(env, field_value)?;\n o.set_property(key, val)?;\n }\n o.into_unknown(env)\n }\n Value::Keys(keys) => {\n // TODO: Make this an actual JS object\n format!(\"{keys:?}\").as_str().into_unknown(env)\n }\n Value::Brush(brush) => {\n SlintBrush::from(brush.clone()).into_instance(env)?.as_object(env).into_unknown(env)\n }\n Value::Model(model) => {\n if let Some(maybe_js_model) = rust_into_js_model(env, model) {\n maybe_js_model\n } else {\n let model_wrapper: ReadOnlyRustModel = model.clone().into();\n model_wrapper.into_js(env)\n }\n }\n Value::EnumerationValue(_, value) => value.as_str().into_unknown(env),\n _ => ().into_unknown(env),\n }\n}\n\npub fn to_value(env: &Env, unknown: Unknown<'_>, typ: &Type) -> Result {\n match typ {\n Type::Float32\n | Type::Int32\n | Type::Duration\n | Type::Angle\n | Type::PhysicalLength\n | Type::LogicalLength\n | Type::Rem\n | Type::Percent\n | Type::UnitProduct(_) => Ok(Value::Number(expect_number(unknown)?)),\n Type::String => Ok(Value::String(expect_string(unknown)?.into())),\n Type::Bool => Ok(Value::Bool(expect_bool(unknown)?)),\n Type::Color => {\n match unknown.get_type() {\n Ok(ValueType::String) => {\n let js_string = unknown.coerce_to_string()?;\n return string_to_brush(js_string);\n }\n Ok(ValueType::Object) => {\n let obj = unknown.coerce_to_object()?;\n if let Some(direct_brush) =\n obj.get::>(\"brush\").ok().flatten()\n {\n return Ok(Value::Brush(direct_brush.color().into()));\n }\n return brush_from_color(obj);\n }\n _ => {}\n }\n Err(napi::Error::from_reason(\n \"Cannot convert object to brush, because the given object is neither a brush, color, nor a string\".to_string()\n ))\n }\n Type::Brush => {\n match unknown.get_type() {\n Ok(ValueType::String) => {\n let js_string = unknown.coerce_to_string()?;\n return string_to_brush(js_string);\n }\n Ok(ValueType::Object) => {\n let obj = unknown.coerce_to_object()?;\n // this is used to make the color property of the `Brush` interface optional.\n let properties = obj.get_property_names()?;\n if properties.get_array_length()? == 0 {\n return Ok(Value::Brush(Brush::default()));\n }\n if let Some(color) = obj.get::(\"color\").ok().flatten() {\n if color.red() < 0.\n || color.green() < 0.\n || color.blue() < 0.\n || color.alpha() < 0.\n {\n return Err(napi::Error::from_reason(\n \"A channel of Color cannot be negative\",\n ));\n }\n\n return Ok(Value::Brush(Brush::SolidColor(Color::from_argb_u8(\n color.alpha() as u8,\n color.red() as u8,\n color.green() as u8,\n color.blue() as u8,\n ))));\n } else {\n return brush_from_color(obj);\n }\n }\n _ => {}\n }\n Err(napi::Error::from_reason(\n \"Cannot convert object to brush, because the given object is neither a brush, color, nor a string\".to_string()\n ))\n }\n Type::Image => {\n let object = unknown.coerce_to_object()?;\n if let Some(direct_image) = object.get::>(\"image\").ok().flatten() {\n Ok(Value::Image((*direct_image).clone()))\n } else {\n let get_size_prop = |name: &str| {\n object\n .get::(name)\n .ok()\n .flatten()\n .and_then(|p| {\n p.coerce_to_number().ok()\n .and_then(|number| number.get_int64().ok())\n .and_then(|i64_num| i64_num.try_into().ok())\n })\n .ok_or_else(\n || napi::Error::from_reason(\n format!(\"Cannot convert object to image, because the provided object does not have an u32 `{name}` property\")\n ))\n };\n\n fn try_convert_image + FromNapiValue>(\n object: &Object,\n width: u32,\n height: u32,\n ) -> Result> {\n let buffer =\n object.get::(\"data\").ok().flatten().ok_or_else(|| {\n napi::Error::from_reason(\n \"data property does not have suitable array buffer type\"\n .to_string(),\n )\n })?;\n const BPP: usize = core::mem::size_of::();\n let actual_size = buffer.as_ref().len();\n let expected_size: usize = (width as usize) * (height as usize) * BPP;\n if actual_size != expected_size {\n return Err(napi::Error::from_reason(format!(\n \"data property does not have the correct size; expected {width} (width) * {height} (height) * {BPP} = {actual_size}; got {expected_size}\"\n )));\n }\n\n Ok(SharedPixelBuffer::clone_from_slice(buffer.as_ref(), width, height))\n }\n\n let width: u32 = get_size_prop(\"width\")?;\n let height: u32 = get_size_prop(\"height\")?;\n\n let pixel_buffer =\n try_convert_image::(&object, width, height)\n .or_else(|_| try_convert_image::(&object, width, height))?;\n\n Ok(Value::Image(Image::from_rgba8(pixel_buffer)))\n }\n }\n Type::Struct(s) => {\n let js_object = unknown.coerce_to_object()?;\n\n Ok(Value::Struct(\n s.fields\n .iter()\n .map(|(pro_name, pro_ty)| {\n let prop: Unknown =\n js_object.get_named_property(&pro_name.replace('-', \"_\"))?;\n let prop_value = if prop.get_type()? == napi::ValueType::Undefined {\n slint_interpreter::default_value_for_type(pro_ty)\n } else {\n to_value(env, prop, pro_ty)?\n };\n Ok((pro_name.to_string(), prop_value))\n })\n .collect::>()?,\n ))\n }\n Type::Array(a) => {\n if unknown.is_array()? {\n let array = Array::from_unknown(unknown)?;\n let mut vec = Vec::new();\n\n for i in 0..array.len() {\n vec.push(to_value(\n env,\n array.get(i)?.ok_or(napi::Error::from_reason(format!(\n \"Cannot access array element at index {i}\"\n )))?,\n a,\n )?);\n }\n Ok(Value::Model(ModelRc::new(SharedVectorModel::from(SharedVector::from_slice(\n &vec,\n )))))\n } else {\n let obj = unknown.coerce_to_object()?;\n let rust_model = js_into_rust_model(env, &obj, a)?;\n Ok(Value::Model(rust_model))\n }\n }\n Type::Enumeration(e) => {\n let js_string = unknown.coerce_to_string()?;\n let value: SmolStr = js_string.into_utf8()?.as_str()?.into();\n\n if !e.values.contains(&value) {\n return Err(napi::Error::from_reason(format!(\n \"{value} is not a value of enum {}\",\n e.name\n )));\n }\n\n Ok(Value::EnumerationValue(e.name.to_string(), value.to_string()))\n }\n Type::Invalid\n | Type::Model\n | Type::Void\n | Type::InferredProperty\n | Type::InferredCallback\n | Type::Function { .. }\n | Type::Callback { .. }\n | Type::ComponentFactory\n | Type::Easing\n | Type::PathData\n | Type::LayoutCache\n | Type::ArrayOfU16\n | Type::Keys\n | Type::ElementReference\n | Type::StyledText => Err(napi::Error::from_reason(\"reason\")),\n }\n}\n\nfn string_to_brush(js_string: napi::JsString<'_>) -> Result {\n let string = js_string.into_utf8()?.as_str()?.to_string();\n\n let c = string\n .parse::()\n .map_err(|_| napi::Error::from_reason(format!(\"Could not convert {string} to Brush.\")))?;\n\n Ok(Value::Brush(Brush::from(Color::from_argb_u8((c.a * 255.) as u8, c.r, c.g, c.b))))\n}\n\nfn brush_from_color(rgb_color: Object) -> Result {\n let red: f64 =\n rgb_color.get(\"red\")?.ok_or(napi::Error::from_reason(\"Property red is missing\"))?;\n let green: f64 =\n rgb_color.get(\"green\")?.ok_or(napi::Error::from_reason(\"Property green is missing\"))?;\n let blue: f64 =\n rgb_color.get(\"blue\")?.ok_or(napi::Error::from_reason(\"Property blue is missing\"))?;\n let alpha: f64 = rgb_color.get(\"alpha\")?.unwrap_or(255.);\n\n if red < 0. || green < 0. || blue < 0. || alpha < 0. {\n return Err(napi::Error::from_reason(\"A channel of Color cannot be negative\"));\n }\n\n Ok(Value::Brush(Brush::SolidColor(Color::from_argb_u8(\n alpha as u8,\n red as u8,\n green as u8,\n blue as u8,\n ))))\n}\n" }, { "path": "api/node/rust/interpreter/window.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse crate::types::{SlintPoint, SlintSize};\nuse i_slint_core::window::WindowAdapterRc;\nuse slint_interpreter::{LogicalPosition, LogicalSize, PhysicalPosition, PhysicalSize};\n\n/// This type represents a window towards the windowing system, that's used to render the\n/// scene of a component. It provides API to control windowing system specific aspects such\n/// as the position on the screen.\n#[napi(js_name = \"Window\")]\npub struct JsWindow {\n pub(crate) inner: WindowAdapterRc,\n}\n\nimpl From for JsWindow {\n fn from(instance: WindowAdapterRc) -> Self {\n Self { inner: instance }\n }\n}\n\n#[napi]\nimpl JsWindow {\n /// @hidden\n #[napi(constructor)]\n pub fn new() -> napi::Result {\n Err(napi::Error::from_reason(\n \"Window can only be created by using a Component.\".to_string(),\n ))\n }\n\n /// Shows the window on the screen. An additional strong reference on the\n /// associated component is maintained while the window is visible.\n #[napi]\n pub fn show(&self) -> napi::Result<()> {\n self.inner\n .window()\n .show()\n .map_err(|_| napi::Error::from_reason(\"Cannot show window.\".to_string()))\n }\n\n /// Hides the window, so that it is not visible anymore.\n #[napi]\n pub fn hide(&self) -> napi::Result<()> {\n self.inner\n .window()\n .hide()\n .map_err(|_| napi::Error::from_reason(\"Cannot hide window.\".to_string()))\n }\n\n /// Returns the visibility state of the window. This function can return false even if you previously called show()\n /// on it, for example if the user minimized the window.\n #[napi(getter, js_name = \"visible\")]\n pub fn is_visible(&self) -> bool {\n self.inner.window().is_visible()\n }\n\n /// Returns the logical position of the window on the screen.\n #[napi(getter)]\n pub fn get_logical_position(&self) -> SlintPoint {\n let pos = self.inner.window().position().to_logical(self.inner.window().scale_factor());\n SlintPoint { x: pos.x as f64, y: pos.y as f64 }\n }\n\n /// Sets the logical position of the window on the screen.\n #[napi(setter)]\n pub fn set_logical_position(&self, position: SlintPoint) {\n self.inner\n .window()\n .set_position(LogicalPosition { x: position.x as f32, y: position.y as f32 });\n }\n\n /// Returns the physical position of the window on the screen.\n #[napi(getter)]\n pub fn get_physical_position(&self) -> SlintPoint {\n let pos = self.inner.window().position();\n SlintPoint { x: pos.x as f64, y: pos.y as f64 }\n }\n\n /// Sets the physical position of the window on the screen.\n #[napi(setter)]\n pub fn set_physical_position(&self, position: SlintPoint) {\n self.inner.window().set_position(PhysicalPosition {\n x: position.x.floor() as i32,\n y: position.y.floor() as i32,\n });\n }\n\n /// Returns the logical size of the window on the screen,\n #[napi(getter)]\n pub fn get_logical_size(&self) -> SlintSize {\n let size = self.inner.window().size().to_logical(self.inner.window().scale_factor());\n SlintSize { width: size.width as f64, height: size.height as f64 }\n }\n\n /// Sets the logical size of the window on the screen,\n #[napi(setter)]\n pub fn set_logical_size(&self, size: SlintSize) {\n self.inner.window().set_size(LogicalSize::from_physical(\n PhysicalSize { width: size.width.floor() as u32, height: size.height.floor() as u32 },\n self.inner.window().scale_factor(),\n ));\n }\n\n /// Returns the physical size of the window on the screen,\n #[napi(getter)]\n pub fn get_physical_size(&self) -> SlintSize {\n let size = self.inner.window().size();\n SlintSize { width: size.width as f64, height: size.height as f64 }\n }\n\n /// Sets the logical size of the window on the screen,\n #[napi(setter)]\n pub fn set_physical_size(&self, size: SlintSize) {\n self.inner.window().set_size(PhysicalSize {\n width: size.width.floor() as u32,\n height: size.height.floor() as u32,\n });\n }\n\n /// Issues a request to the windowing system to re-render the contents of the window.\n #[napi(js_name = \"requestRedraw\")]\n pub fn request_redraw(&self) {\n self.inner.request_redraw();\n }\n\n /// Returns if the window is currently fullscreen\n #[napi(getter)]\n pub fn get_fullscreen(&self) -> bool {\n self.inner.window().is_fullscreen()\n }\n\n /// Set or unset the window to display fullscreen.\n #[napi(setter)]\n pub fn set_fullscreen(&self, enable: bool) {\n self.inner.window().set_fullscreen(enable)\n }\n\n /// Returns if the window is currently maximized\n #[napi(getter)]\n pub fn get_maximized(&self) -> bool {\n self.inner.window().is_maximized()\n }\n\n /// Maximize or unmaximize the window.\n #[napi(setter)]\n pub fn set_maximized(&self, maximized: bool) {\n self.inner.window().set_maximized(maximized)\n }\n\n /// Returns if the window is currently minimized\n #[napi(getter)]\n pub fn get_minimized(&self) -> bool {\n self.inner.window().is_minimized()\n }\n\n /// Minimize or unminimze the window.\n #[napi(setter)]\n pub fn set_minimized(&self, minimized: bool) {\n self.inner.window().set_minimized(minimized)\n }\n}\n" }, { "path": "api/node/rust/interpreter.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nmod diagnostic;\npub use diagnostic::*;\n\nmod component_compiler;\npub use component_compiler::*;\n\nmod component_definition;\npub use component_definition::*;\n\nmod component_instance;\npub use component_instance::*;\n\nmod value;\npub use value::*;\n\nmod window;\npub use window::*;\n" }, { "path": "api/node/rust/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nmod interpreter;\nuse std::path::PathBuf;\n\npub use interpreter::*;\n\nmod types;\npub use types::*;\n\nuse napi::Env;\nuse napi::bindgen_prelude::*;\n\n#[macro_use]\nextern crate napi_derive;\n\n#[napi]\npub fn mock_elapsed_time(ms: f64) {\n i_slint_core::tests::slint_mock_elapsed_time(ms as _);\n}\n\n#[napi]\npub fn get_mocked_time() -> f64 {\n i_slint_core::tests::slint_get_mocked_time() as f64\n}\n\n#[napi]\npub enum ProcessEventsResult {\n Continue,\n Exited,\n}\n\n#[napi]\npub fn process_events() -> napi::Result {\n i_slint_backend_selector::with_platform(|b| {\n b.process_events(std::time::Duration::ZERO, i_slint_core::InternalToken)\n })\n .map_err(|e| napi::Error::from_reason(e.to_string()))\n .map(|result| match result {\n core::ops::ControlFlow::Continue(()) => ProcessEventsResult::Continue,\n core::ops::ControlFlow::Break(()) => ProcessEventsResult::Exited,\n })\n}\n\n#[napi]\npub fn invoke_from_event_loop(env: &Env, callback: DynFunction<'_>) -> napi::Result<()> {\n i_slint_backend_selector::with_platform(|_b| {\n // Nothing to do, just make sure a backend was created\n Ok(())\n })\n .map_err(|e| napi::Error::from_reason(e.to_string()))?;\n\n let stored_fn = StoredFunction::new(&callback)?;\n let env = *env;\n let wrapper = send_wrapper::SendWrapper::new((stored_fn, env));\n i_slint_core::api::invoke_from_event_loop(move || {\n let (stored_fn, env) = wrapper.take();\n if stored_fn.call(&env, vec![]).is_err() {\n eprintln!(\"Node.js: JavaScript invoke_from_event_loop threw an exception\");\n }\n })\n .map_err(|e| napi::Error::from_reason(e.to_string()))\n}\n\n#[napi]\npub fn set_quit_on_last_window_closed(quit_on_last_window_closed: bool) -> napi::Result<()> {\n if !quit_on_last_window_closed {\n i_slint_backend_selector::with_platform(|b| {\n #[allow(deprecated)]\n b.set_event_loop_quit_on_last_window_closed(false);\n Ok(())\n })\n .map_err(|e| napi::Error::from_reason(e.to_string()))?;\n }\n Ok(())\n}\n\n#[napi]\npub fn init_testing() {\n #[cfg(feature = \"testing\")]\n i_slint_backend_testing::init_integration_test_with_mock_time();\n}\n\n#[napi]\npub fn init_translations(domain: String, dir_name: String) -> napi::Result<()> {\n i_slint_core::translations::gettext_bindtextdomain(domain.as_str(), PathBuf::from(dir_name))\n .map_err(|e| napi::Error::from_reason(e.to_string()))\n}\n\n#[napi]\npub fn set_xdg_app_id(app_id: String) -> napi::Result<()> {\n i_slint_backend_selector::with_global_context(|ctx| ctx.set_xdg_app_id(app_id.into()))\n .map_err(|e| napi::Error::from_reason(e.to_string()))\n}\n\npub fn print_to_console(env: Env, function: &str, arguments: core::fmt::Arguments) {\n let Ok(global) = env.get_global() else {\n eprintln!(\"Unable to obtain global object\");\n return;\n };\n\n let console_object: Object = match global.get_named_property(\"console\") {\n Ok(c) => c,\n Err(_) => {\n eprintln!(\"Unable to obtain console object for logging\");\n return;\n }\n };\n\n let log_fn: Function = match console_object.get_named_property(function) {\n Ok(f) => f,\n Err(_) => {\n eprintln!(\"Unable to obtain console.{function}\");\n return;\n }\n };\n\n let message = arguments.to_string();\n let Ok(js_message) = env.create_string(&message) else {\n eprintln!(\"Unable to provide log message to JS env\");\n return;\n };\n\n let Ok(js_message_unknown) = js_message.into_unknown(&env) else {\n eprintln!(\"Unable to convert log message to unknown\");\n return;\n };\n\n if let Err(err) = log_fn.apply(console_object, js_message_unknown) {\n eprintln!(\"Unable to invoke console.{function}: {err}\");\n }\n}\n\n#[macro_export]\nmacro_rules! console_err {\n ($env:expr, $($t:tt)*) => ($crate::print_to_console($env, \"error\", format_args!($($t)*)))\n}\n" }, { "path": "api/node/rust/types/brush.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse i_slint_core::{Brush, Color, graphics::GradientStop};\nuse napi::{Error, Result, bindgen_prelude::External};\n\n/// RgbaColor represents a color in the Slint run-time, represented using 8-bit channels for red, green, blue and the alpha (opacity).\n#[napi(object)]\npub struct RgbaColor {\n /// Represents the red channel of the color as u8 in the range 0..255.\n pub red: f64,\n\n /// Represents the green channel of the color as u8 in the range 0..255.\n pub green: f64,\n\n /// Represents the blue channel of the color as u8 in the range 0..255.\n pub blue: f64,\n\n /// Represents the alpha channel of the color as u8 in the range 0..255.\n pub alpha: Option,\n}\n\nimpl Default for RgbaColor {\n fn default() -> Self {\n Self { red: 0., green: 0., blue: 0., alpha: None }\n }\n}\n\n// no public api only available internal because in js/ts it's exported as interface\nimpl RgbaColor {\n pub fn red(&self) -> f64 {\n self.red\n }\n\n pub fn green(&self) -> f64 {\n self.green\n }\n\n pub fn blue(&self) -> f64 {\n self.blue\n }\n\n pub fn alpha(&self) -> f64 {\n self.alpha.unwrap_or(255.)\n }\n}\n\n/// SlintRgbaColor implements {@link RgbaColor}.\n#[napi]\npub struct SlintRgbaColor {\n inner: Color,\n}\n\nimpl From for SlintRgbaColor {\n fn from(color: Color) -> Self {\n Self { inner: color }\n }\n}\n\nimpl From for RgbaColor {\n fn from(color: SlintRgbaColor) -> Self {\n Self {\n red: color.red() as f64,\n green: color.green() as f64,\n blue: color.blue() as f64,\n alpha: Some(color.alpha() as f64),\n }\n }\n}\n\n#[napi]\nimpl SlintRgbaColor {\n /// Creates a new transparent color.\n #[napi(constructor)]\n pub fn new() -> Self {\n Self { inner: Color::default() }\n }\n\n /// Construct a color from the red, green and blue color channel parameters. The alpha\n /// channel will have the value 255.\n #[napi(factory)]\n pub fn from_rgb(red: u8, green: u8, blue: u8) -> Self {\n Self { inner: Color::from_rgb_u8(red, green, blue) }\n }\n\n /// Construct a color from the alpha, red, green and blue color channel parameters.\n #[napi(factory)]\n pub fn from_argb(alpha: u8, red: u8, green: u8, blue: u8) -> Self {\n Self { inner: Color::from_argb_u8(alpha, red, green, blue) }\n }\n\n /// Returns the red channel of the color as number in the range 0..255.\n #[napi(getter)]\n pub fn red(&self) -> u8 {\n self.inner.red()\n }\n\n /// Returns the green channel of the color as number in the range 0..255.\n #[napi(getter)]\n pub fn green(&self) -> u8 {\n self.inner.green()\n }\n\n /// Returns the blue channel of the color as number in the range 0..255.\n #[napi(getter)]\n pub fn blue(&self) -> u8 {\n self.inner.blue()\n }\n\n /// Returns the alpha channel of the color as number in the range 0..255.\n #[napi(getter)]\n pub fn alpha(&self) -> u8 {\n self.inner.alpha()\n }\n\n // Returns a new version of this color that has the brightness increased\n /// by the specified factor. This is done by converting the color to the HSV\n /// color space and multiplying the brightness (value) with (1 + factor).\n /// The result is converted back to RGB and the alpha channel is unchanged.\n /// So for example `brighter(0.2)` will increase the brightness by 20%, and\n /// calling `brighter(-0.5)` will return a color that's 50% darker.\n #[napi]\n pub fn brighter(&self, factor: f64) -> SlintRgbaColor {\n SlintRgbaColor::from(self.inner.brighter(factor as f32))\n }\n\n /// Returns a new version of this color that has the brightness decreased\n /// by the specified factor. This is done by converting the color to the HSV\n /// color space and dividing the brightness (value) by (1 + factor). The\n /// result is converted back to RGB and the alpha channel is unchanged.\n /// So for example `darker(0.3)` will decrease the brightness by 30%.\n #[napi]\n pub fn darker(&self, factor: f64) -> SlintRgbaColor {\n SlintRgbaColor::from(self.inner.darker(factor as f32))\n }\n\n /// Returns a new version of this color with the opacity decreased by `factor`.\n ///\n /// The transparency is obtained by multiplying the alpha channel by `(1 - factor)`.\n #[napi]\n pub fn transparentize(&self, amount: f64) -> SlintRgbaColor {\n SlintRgbaColor::from(self.inner.transparentize(amount as f32))\n }\n\n /// Returns a new color that is a mix of `this` color and `other`. The specified factor is\n /// clamped to be between `0.0` and `1.0` and then applied to `this` color, while `1.0 - factor`\n ///is applied to `other`.\n #[napi]\n pub fn mix(&self, other: &SlintRgbaColor, factor: f64) -> SlintRgbaColor {\n SlintRgbaColor::from(self.inner.mix(&other.inner, factor as f32))\n }\n\n /// Returns a new version of this color with the opacity set to `alpha`.\n #[napi]\n pub fn with_alpha(&self, alpha: f64) -> SlintRgbaColor {\n SlintRgbaColor::from(self.inner.with_alpha(alpha as f32))\n }\n\n /// Returns the color as string in hex representation e.g. `#000000` for black.\n #[napi]\n pub fn to_string(&self) -> String {\n let alpha = self.alpha();\n if alpha == 255 {\n format!(\"#{:02x}{:02x}{:02x}\", self.red(), self.green(), self.blue())\n } else {\n format!(\"#{:02x}{:02x}{:02x}{:02x}\", self.red(), self.green(), self.blue(), alpha)\n }\n }\n}\n\n/// A brush is a data structure that is used to describe how\n/// a shape, such as a rectangle, path or even text, shall be filled.\n/// A brush can also be applied to the outline of a shape, that means\n/// the fill of the outline itself.\n#[napi(object, js_name = \"Brush\")]\npub struct JsBrush {\n /// Defines a solid color brush from rgba.\n ///\n /// If no color is set it defaults to transparent.\n pub color: Option,\n}\n\n/// SlintBrush implements {@link Brush}.\n#[napi]\npub struct SlintBrush {\n inner: Brush,\n}\n\nimpl From for SlintBrush {\n fn from(brush: Brush) -> Self {\n Self { inner: brush }\n }\n}\n\nimpl From for SlintBrush {\n fn from(color: SlintRgbaColor) -> Self {\n Self::from(Brush::from(color.inner))\n }\n}\n\n#[napi]\nimpl SlintBrush {\n #[napi(constructor)]\n pub fn new_with_color(color: RgbaColor) -> Result {\n if color.red() < 0. || color.green() < 0. || color.blue() < 0. || color.alpha() < 0. {\n return Err(Error::from_reason(\"A channel of Color cannot be negative\"));\n }\n\n Ok(Self {\n inner: Brush::SolidColor(Color::from_argb_u8(\n color.alpha().floor() as u8,\n color.red().floor() as u8,\n color.green().floor() as u8,\n color.blue().floor() as u8,\n )),\n })\n }\n\n #[napi(factory)]\n pub fn from_brush(brush: JsBrush) -> Result {\n SlintBrush::new_with_color(brush.color.unwrap_or_default())\n }\n\n /// Creates a brush form a `Color`.\n pub fn from_slint_color(color: &SlintRgbaColor) -> Self {\n Self { inner: Brush::SolidColor(color.inner) }\n }\n\n #[napi(getter)]\n pub fn color(&self) -> RgbaColor {\n self.slint_color().into()\n }\n\n /// @hidden\n #[napi(getter)]\n pub fn slint_color(&self) -> SlintRgbaColor {\n self.inner.color().into()\n }\n\n /// Returns true if this brush contains a fully transparent color (alpha value is zero)\n #[napi(getter)]\n pub fn is_transparent(&self) -> bool {\n self.inner.is_transparent()\n }\n\n /// Returns true if this brush is fully opaque.\n #[napi(getter)]\n pub fn is_opaque(&self) -> bool {\n self.inner.is_opaque()\n }\n\n /// Returns a new version of this brush that has the brightness increased\n /// by the specified factor. This is done by calling [`Color::brighter`] on\n /// all the colors of this brush.\n #[napi]\n pub fn brighter(&self, factor: f64) -> SlintBrush {\n SlintBrush::from(self.inner.brighter(factor as f32))\n }\n\n /// Returns a new version of this brush that has the brightness decreased\n /// by the specified factor. This is done by calling [`Color::darker`] on\n /// all the color of this brush.\n #[napi]\n pub fn darker(&self, factor: f64) -> SlintBrush {\n SlintBrush::from(self.inner.darker(factor as f32))\n }\n\n /// Returns a new version of this brush with the opacity decreased by `factor`.\n ///\n /// The transparency is obtained by multiplying the alpha channel by `(1 - factor)`.\n #[napi]\n pub fn transparentize(&self, amount: f64) -> SlintBrush {\n SlintBrush::from(self.inner.transparentize(amount as f32))\n }\n\n /// Returns a new version of this brush with the related color's opacities\n /// set to `alpha`.\n #[napi]\n pub fn with_alpha(&self, alpha: f64) -> SlintBrush {\n SlintBrush::from(self.inner.with_alpha(alpha as f32))\n }\n\n /// @hidden\n #[napi(getter)]\n pub fn brush(&self) -> External {\n External::new(self.inner.clone())\n }\n\n /// Returns the color as string in hex representation e.g. `#000000` for black.\n /// It is only implemented for solid color brushes.\n #[napi]\n pub fn to_string(&self) -> String {\n match &self.inner {\n Brush::SolidColor(_) => self.slint_color().to_string(),\n Brush::LinearGradient(gradient) => {\n format!(\n \"linear-gradient({}deg, {})\",\n gradient.angle(),\n gradient_stops_to_string(gradient.stops())\n )\n }\n Brush::RadialGradient(gradient) => {\n format!(\"radial-gradient(circle, {})\", gradient_stops_to_string(gradient.stops()))\n }\n _ => String::default(),\n }\n }\n}\n\nfn gradient_stops_to_string<'a>(stops: impl Iterator) -> String {\n let stops: Vec = stops\n .map(|s| {\n format!(\n \"rgba({}, {}, {}, {}) {}%\",\n s.color.red(),\n s.color.green(),\n s.color.blue(),\n s.color.alpha(),\n s.position * 100.\n )\n })\n .collect();\n\n let mut stops_string = String::default();\n let len = stops.len();\n\n for i in 0..len {\n stops_string.push_str(stops[i].as_str());\n\n if i < len - 1 {\n stops_string.push_str(\", \");\n }\n }\n\n stops_string\n}\n" }, { "path": "api/node/rust/types/image_data.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse std::vec;\n\nuse i_slint_core::{\n ImageInner,\n graphics::{Image, SharedImageBuffer, SharedPixelBuffer},\n};\nuse napi::{\n Env,\n bindgen_prelude::{Buffer, External, ToNapiValue, Unknown},\n};\n\n// This is needed for typedoc check JsImageData::image\npub type ImageData = Image;\n\n/// SlintPoint implements {@link ImageData}.\n#[napi]\npub struct SlintImageData {\n inner: Image,\n}\n\nimpl From for SlintImageData {\n fn from(image: Image) -> Self {\n Self { inner: image }\n }\n}\n\n#[napi]\nimpl SlintImageData {\n /// Constructs a new image with the given width and height.\n /// Each pixel will set to red = 0, green = 0, blue = 0 and alpha = 0.\n #[napi(constructor)]\n pub fn new(width: u32, height: u32) -> Self {\n Self { inner: Image::from_rgba8(SharedPixelBuffer::new(width, height)) }\n }\n\n /// Returns the width of the image in pixels.\n #[napi(getter)]\n pub fn width(&self) -> u32 {\n self.inner.size().width\n }\n\n /// Returns the height of the image in pixels.\n #[napi(getter)]\n pub fn height(&self) -> u32 {\n self.inner.size().height\n }\n\n /// Returns the image as buffer.\n /// A Buffer is a subclass of Uint8Array.\n #[napi(getter)]\n pub fn data(&self) -> Buffer {\n let image_inner: &ImageInner = (&self.inner).into();\n if let Some(buffer) = image_inner.render_to_buffer(None) {\n match buffer {\n SharedImageBuffer::RGB8(buffer) => {\n return Buffer::from(rgb_to_rgba(\n buffer.as_bytes(),\n (self.width() * self.height()) as usize,\n ));\n }\n SharedImageBuffer::RGBA8(buffer) => return Buffer::from(buffer.as_bytes()),\n SharedImageBuffer::RGBA8Premultiplied(buffer) => {\n return Buffer::from(rgb_to_rgba(\n buffer.as_bytes(),\n (self.width() * self.height()) as usize,\n ));\n }\n }\n }\n\n Buffer::from(vec![0; (self.width() * self.height() * 4) as usize])\n }\n\n #[napi(getter)]\n pub fn path<'a>(&self, env: &'a Env) -> napi::Result> {\n match self.inner.path() {\n None => ().into_unknown(env),\n Some(p) => env.create_string(p.to_string_lossy().as_ref())?.into_unknown(env),\n }\n }\n\n /// @hidden\n #[napi(getter)]\n pub fn image(&self) -> External {\n External::new(self.inner.clone())\n }\n}\n\nfn rgb_to_rgba(bytes: &[u8], size: usize) -> Vec {\n let mut rgba_bytes = Vec::new();\n\n for i in 0..size {\n if (i * 3) + 2 >= bytes.len() {\n continue;\n }\n\n rgba_bytes.push(bytes[i * 3]);\n rgba_bytes.push(bytes[(i * 3) + 1]);\n rgba_bytes.push(bytes[(i * 3) + 2]);\n rgba_bytes.push(255);\n }\n\n rgba_bytes\n}\n" }, { "path": "api/node/rust/types/model.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse std::rc::Rc;\n\nuse i_slint_compiler::langtype::Type;\nuse i_slint_core::model::{Model, ModelNotify, ModelRc};\nuse napi::bindgen_prelude::*;\nuse napi::{Env, JsValue, Result, ValueType};\n\nuse crate::{RefCountedReference, to_js_unknown, to_value};\n\n#[napi]\n#[derive(Clone, Default)]\npub struct SharedModelNotify(Rc);\n\nimpl core::ops::Deref for SharedModelNotify {\n type Target = Rc;\n\n fn deref(&self) -> &Self::Target {\n &self.0\n }\n}\n\npub(crate) fn js_into_rust_model(\n env: &Env,\n maybe_js_impl: &Object,\n row_data_type: &Type,\n) -> Result> {\n let shared_model_notify: ExternalRef =\n maybe_js_impl.get_named_property(\"modelNotify\")?;\n let shared_model_notify: SharedModelNotify = (*shared_model_notify).clone();\n Ok(Rc::new(JsModel {\n shared_model_notify,\n env: *env,\n js_impl: RefCountedReference::new(env, maybe_js_impl)?,\n row_data_type: row_data_type.clone(),\n })\n .into())\n}\n\npub(crate) fn rust_into_js_model<'a>(\n env: &'a Env,\n model: &ModelRc,\n) -> Option>> {\n model\n .as_any()\n .downcast_ref::()\n .map(|rust_model| rust_model.js_impl.get_unknown()?.into_unknown(env))\n}\n\nstruct JsModel {\n shared_model_notify: SharedModelNotify,\n env: Env,\n js_impl: RefCountedReference,\n row_data_type: Type,\n}\n\n#[napi]\npub fn js_model_notify_new() -> Result> {\n Ok(External::new(Default::default()))\n}\n\n#[napi]\npub fn js_model_notify_row_data_changed(notify: ExternalRef, row: u32) {\n notify.row_changed(row as usize);\n}\n\n#[napi]\npub fn js_model_notify_row_added(notify: ExternalRef, row: u32, count: u32) {\n notify.row_added(row as usize, count as usize);\n}\n\n#[napi]\npub fn js_model_notify_row_removed(notify: ExternalRef, row: u32, count: u32) {\n notify.row_removed(row as usize, count as usize);\n}\n\n#[napi]\npub fn js_model_notify_reset(notify: ExternalRef) {\n notify.reset();\n}\n\nimpl Model for JsModel {\n type Data = slint_interpreter::Value;\n\n fn row_count(&self) -> usize {\n let Ok(model_unknown) = self.js_impl.get_unknown() else {\n eprintln!(\"Node.js: JavaScript Model's rowCount threw an exception\");\n return 0;\n };\n\n let Ok(model) = model_unknown.coerce_to_object() else {\n eprintln!(\"Node.js: JavaScript Model is not an object\");\n return 0;\n };\n\n let row_count_fn: Function<(), Unknown> = match model.get_named_property(\"rowCount\") {\n Ok(f) => f,\n Err(_) => {\n eprintln!(\n \"Node.js: JavaScript Model implementation is missing rowCount property\"\n );\n return 0;\n }\n };\n\n let Ok(row_count_result) = row_count_fn.apply(model, ()) else {\n eprintln!(\"Node.js: JavaScript Model's rowCount implementation call failed\");\n return 0;\n };\n\n let Ok(row_count_number) = row_count_result.coerce_to_number() else {\n eprintln!(\n \"Node.js: JavaScript Model's rowCount function returned a value that cannot be coerced to a number\"\n );\n return 0;\n };\n\n let Ok(row_count) = row_count_number.get_uint32() else {\n eprintln!(\n \"Node.js: JavaScript Model's rowCount function returned a number that cannot be mapped to a uint32\"\n );\n return 0;\n };\n\n row_count as usize\n }\n\n fn row_data(&self, row: usize) -> Option {\n let Ok(model_unknown) = self.js_impl.get_unknown() else {\n eprintln!(\"Node.js: JavaScript Model's rowData threw an exception\");\n return None;\n };\n\n let Ok(model) = model_unknown.coerce_to_object() else {\n eprintln!(\"Node.js: JavaScript Model is not an object\");\n return None;\n };\n\n let row_data_fn: Function = match model.get_named_property(\"rowData\") {\n Ok(f) => f,\n Err(_) => {\n eprintln!(\n \"Node.js: JavaScript Model implementation is missing rowData property\"\n );\n return None;\n }\n };\n\n let Ok(row_data) = row_data_fn.apply(model, row as f64) else {\n eprintln!(\"Node.js: JavaScript Model's rowData function threw an exception\");\n return None;\n };\n\n if row_data.get_type().unwrap() == ValueType::Undefined {\n debug_assert!(row >= self.row_count());\n None\n } else {\n let Ok(js_value) = to_value(&self.env, row_data, &self.row_data_type) else {\n eprintln!(\n \"Node.js: JavaScript Model's rowData function returned data type that cannot be represented in Rust\"\n );\n return None;\n };\n Some(js_value)\n }\n }\n\n fn set_row_data(&self, row: usize, data: Self::Data) {\n let Ok(model_unknown) = self.js_impl.get_unknown() else {\n eprintln!(\"Node.js: JavaScript Model's setRowData threw an exception\");\n return;\n };\n\n let Ok(model) = model_unknown.coerce_to_object() else {\n eprintln!(\"Node.js: JavaScript Model is not an object\");\n return;\n };\n\n let set_row_data_fn: Function)>, Unknown> =\n match model.get_named_property(\"setRowData\") {\n Ok(f) => f,\n Err(_) => {\n eprintln!(\n \"Node.js: JavaScript Model implementation is missing setRowData property\"\n );\n return;\n }\n };\n\n let Ok(js_data) = to_js_unknown(&self.env, &data) else {\n eprintln!(\n \"Node.js: Model's set_row_data called by Rust with data type that can't be represented in JavaScript\"\n );\n return;\n };\n\n if let Err(exception) = set_row_data_fn.apply(model, FnArgs::from((row as f64, js_data))) {\n eprintln!(\n \"Node.js: JavaScript Model's setRowData function threw an exception: {exception}\"\n );\n }\n }\n\n fn model_tracker(&self) -> &dyn i_slint_core::model::ModelTracker {\n &**self.shared_model_notify\n }\n\n fn as_any(&self) -> &dyn core::any::Any {\n self\n }\n}\n\n#[napi]\npub struct ReadOnlyRustModel(ModelRc);\n\nimpl From> for ReadOnlyRustModel {\n fn from(model: ModelRc) -> Self {\n Self(model)\n }\n}\n\n// Implement minimal Model interface\n#[napi]\nimpl ReadOnlyRustModel {\n #[napi]\n pub fn row_count(&self) -> u32 {\n self.0.row_count() as u32\n }\n\n #[napi]\n pub fn row_data<'a>(&self, env: &'a Env, row: u32) -> Result> {\n let Some(data) = self.0.row_data(row as usize) else {\n return ().into_unknown(env);\n };\n crate::to_js_unknown(env, &data)\n }\n\n #[napi]\n pub fn set_row_data(&self, _env: &Env, _row: u32, _data: Unknown<'_>) {\n eprintln!(\n \"setRowData called on a model which does not re-implement this method. This happens when trying to modify a read-only model\"\n )\n }\n\n pub fn into_js<'a>(self, env: &'a Env) -> Result> {\n let model = self.0.clone();\n\n let mut obj = self.into_instance(env)?.as_object(env);\n\n // Implement Iterator protocol by hand until it's stable in napi-rs\n let global = env.get_global()?;\n let symbol_function: Unknown = global.get_named_property(\"Symbol\")?;\n let symbol_obj = symbol_function.coerce_to_object()?;\n let iterator_symbol: napi::JsSymbol = symbol_obj.get_named_property(\"iterator\")?;\n\n obj.set_property(\n iterator_symbol,\n env.create_function_from_closure::<(), ModelIterator, _>(\n \"rust model iterator\",\n move |ctx| Ok(ModelIterator { model: model.clone(), row: 0, env: *ctx.env }),\n )?,\n )?;\n\n obj.into_unknown(env)\n }\n}\n\n#[napi]\npub struct ModelIterator {\n model: ModelRc,\n row: usize,\n env: Env,\n}\n\n#[napi]\nimpl ModelIterator {\n // Implements the JS iterator protocol — name must be `next`.\n #[allow(clippy::should_implement_trait)]\n #[napi]\n pub fn next(&mut self) -> Result> {\n let mut result = Object::new(&self.env)?;\n if self.row >= self.model.row_count() {\n result.set_named_property(\"done\", true)?;\n } else {\n let row = self.row;\n self.row += 1;\n result.set_named_property(\n \"value\",\n self.model.row_data(row).and_then(|value| to_js_unknown(&self.env, &value).ok()),\n )?\n }\n result.into_unknown(&self.env)\n }\n}\n" }, { "path": "api/node/rust/types/point.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse napi::JsValue;\nuse napi::bindgen_prelude::{FromNapiValue, Object, Unknown};\n\n/// SlintPoint implements {@link Point}.\n#[napi]\npub struct SlintPoint {\n pub x: f64,\n pub y: f64,\n}\n\n#[napi]\nimpl SlintPoint {\n /// Constructs new point from x and y.\n #[napi(constructor)]\n pub fn new(x: f64, y: f64) -> Self {\n Self { x, y }\n }\n}\n\nimpl FromNapiValue for SlintPoint {\n unsafe fn from_napi_value(\n env: napi::sys::napi_env,\n napi_val: napi::sys::napi_value,\n ) -> napi::Result {\n let obj = unsafe { Object::from_napi_value(env, napi_val)? };\n let x: f64 = obj\n .get::(\"x\")\n .ok()\n .flatten()\n .and_then(|p| p.coerce_to_number().ok().and_then(|n| n.get_double().ok()))\n .ok_or_else(\n || napi::Error::from_reason(\n \"Cannot convert object to Point, because the provided object does not have an f64 x property\".to_string()\n ))?;\n let y: f64 = obj\n .get::(\"y\")\n .ok()\n .flatten()\n .and_then(|p| p.coerce_to_number().ok().and_then(|n| n.get_double().ok()))\n .ok_or_else(\n || napi::Error::from_reason(\n \"Cannot convert object to Point, because the provided object does not have an f64 y property\".to_string()\n ))?;\n\n Ok(SlintPoint { x, y })\n }\n}\n" }, { "path": "api/node/rust/types/size.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse napi::JsValue;\nuse napi::bindgen_prelude::{FromNapiValue, Object, Unknown};\n\n/// SlintSize implements {@link Size}.\n#[napi]\npub struct SlintSize {\n pub width: f64,\n pub height: f64,\n}\n\n#[napi]\nimpl SlintSize {\n /// Constructs a size from the given width and height.\n #[napi(constructor)]\n pub fn new(width: f64, height: f64) -> napi::Result {\n if width < 0. {\n return Err(napi::Error::from_reason(\"width cannot be negative\".to_string()));\n }\n\n if height < 0. {\n return Err(napi::Error::from_reason(\"height cannot be negative\".to_string()));\n }\n\n Ok(Self { width, height })\n }\n}\n\nimpl FromNapiValue for SlintSize {\n unsafe fn from_napi_value(\n env: napi::sys::napi_env,\n napi_val: napi::sys::napi_value,\n ) -> napi::Result {\n let obj = unsafe { Object::from_napi_value(env, napi_val)? };\n let width: f64 = obj\n .get::(\"width\")\n .ok()\n .flatten()\n .and_then(|p| p.coerce_to_number().ok().and_then(|n| n.get_double().ok()))\n .ok_or_else(\n || napi::Error::from_reason(\n \"Cannot convert object to Size, because the provided object does not have an f64 width property\".to_string()\n ))?;\n let height: f64 = obj\n .get::(\"height\")\n .ok()\n .flatten()\n .and_then(|p| p.coerce_to_number().ok().and_then(|n| n.get_double().ok()))\n .ok_or_else(\n || napi::Error::from_reason(\n \"Cannot convert object to Size, because the provided object does not have an f64 height property\".to_string()\n ))?;\n\n Ok(SlintSize { width, height })\n }\n}\n" }, { "path": "api/node/rust/types.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nmod brush;\npub use brush::*;\n\nmod image_data;\npub use image_data::*;\n\nmod model;\npub use model::*;\n\nmod point;\npub use point::*;\n\nmod size;\npub use size::*;\n" }, { "path": "api/node/thirdparty.hbs", "content": "\n\n\n\n\n\n\n\n \n\n\n\n
\n
\n

Third Party Licenses

\n

This page lists the licenses of the dependencies used by Slint.

\n
\n\n

Overview of licenses:

\n
    \n {{#each overview}}\n
  • {{name}} ({{count}})
    • \n {{/each}}\n
\n\n

All license text:

\n
    \n {{#each licenses}}\n
  • \n

    {{name}}

    \n

    Used by:

    \n
      \n {{#each used_by}}\n
    • {{crate.name}}\n {{crate.version}}
      • \n {{/each}}\n
    \n 
    {{text}}
    \n
    • \n {{/each}}\n
\n
\n\n\n\n" }, { "path": "api/node/tsconfig.json", "content": "{\n \"compilerOptions\": {\n \"module\": \"CommonJS\",\n \"target\": \"esnext\",\n \"declaration\": true,\n \"outDir\": \"dist\",\n \"skipLibCheck\": true\n },\n \"include\": [\n \"typescript/\"\n ],\n \"exclude\": [\"**/node_modules/**\"]\n}\n" }, { "path": "api/node/typescript/index.ts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport * as napi from \"../rust-module.cjs\";\nexport {\n Diagnostic,\n DiagnosticLevel,\n RgbaColor,\n Brush,\n} from \"../rust-module.cjs\";\n\nimport { Model } from \"./models\";\nexport { Model };\n\nexport { ArrayModel } from \"./models\";\n\nimport { Diagnostic } from \"../rust-module.cjs\";\n\nimport { fileURLToPath } from \"node:url\";\n\n/**\n * Represents a two-dimensional point.\n */\nexport interface Point {\n /**\n * Defines the x coordinate of the point.\n */\n x: number;\n\n /**\n * Defines the y coordinate of the point.\n */\n y: number;\n}\n\n/**\n * Represents a two-dimensional size.\n */\nexport interface Size {\n /**\n * Defines the width length of the size.\n */\n width: number;\n\n /**\n * Defines the height length of the size.\n */\n height: number;\n}\n\n/**\n * This type represents a window towards the windowing system, that's used to render the\n * scene of a component. It provides API to control windowing system specific aspects such\n * as the position on the screen.\n */\nexport interface Window {\n /** Gets or sets the logical position of the window on the screen. */\n logicalPosition: Point;\n\n /** Gets or sets the physical position of the window on the screen. */\n physicalPosition: Point;\n\n /** Gets or sets the logical size of the window on the screen, */\n logicalSize: Size;\n\n /** Gets or sets the physical size of the window on the screen, */\n physicalSize: Size;\n\n /** Gets or sets the window's fullscreen state **/\n fullscreen: boolean;\n\n /** Gets or sets the window's maximized state **/\n maximized: boolean;\n\n /** Gets or sets the window's minimized state **/\n minimized: boolean;\n\n /**\n * Returns the visibility state of the window. This function can return false even if you previously called show()\n * on it, for example if the user minimized the window.\n */\n get visible(): boolean;\n\n /**\n * Shows the window on the screen. An additional strong reference on the\n * associated component is maintained while the window is visible.\n */\n show(): void;\n\n /** Hides the window, so that it is not visible anymore. */\n hide(): void;\n\n /** Issues a request to the windowing system to re-render the contents of the window. */\n requestRedraw(): void;\n}\n\n/**\n * An image data type that can be displayed by the Image element.\n *\n * This interface is inspired by the web [ImageData](https://developer.mozilla.org/en-US/docs/Web/API/ImageData) interface.\n */\nexport interface ImageData {\n /**\n * Returns the path of the image, if it was loaded from disk. Otherwise\n * the property is undefined.\n */\n readonly path?: string;\n\n /**\n * Returns the image as buffer.\n */\n get data(): Uint8Array;\n\n /**\n * Returns the width of the image in pixels.\n */\n get width(): number;\n\n /**\n * Returns the height of the image in pixels.\n */\n get height(): number;\n}\n\n/**\n * This interface describes the public API of a Slint component that is common to all instances. Use this to\n * show() the window on the screen, access the window and subsequent window properties, or start the\n * Slint event loop with run().\n */\nexport interface ComponentHandle {\n /**\n * Shows the window and runs the event loop. The returned promise is resolved when the event loop\n * is terminated, for example when the last window was closed, or {@link quitEventLoop} was called.\n *\n * This function is a convenience for calling {@link show}, followed by {@link runEventLoop}, and\n * {@link hide} when the event loop's promise is resolved.\n */\n run(): Promise;\n\n /**\n * Shows the component's window on the screen.\n */\n show();\n\n /**\n * Hides the component's window, so that it is not visible anymore.\n */\n hide();\n\n /**\n * Returns the {@link Window} associated with this component instance.\n * The window API can be used to control different aspects of the integration into the windowing system, such as the position on the screen.\n */\n get window(): Window;\n}\n\n/**\n * @hidden\n */\nclass Component implements ComponentHandle {\n #instance: napi.ComponentInstance;\n\n /**\n * @hidden\n */\n constructor(instance: napi.ComponentInstance) {\n this.#instance = instance;\n }\n\n get window(): Window {\n return this.#instance.window();\n }\n\n /**\n * @hidden\n */\n get component_instance(): napi.ComponentInstance {\n return this.#instance;\n }\n\n async run() {\n this.show();\n await runEventLoop();\n this.hide();\n }\n\n show() {\n this.#instance.window().show();\n }\n\n hide() {\n this.#instance.window().hide();\n }\n}\n\n/**\n * Represents an errors that can be emitted by the compiler.\n */\nexport class CompileError extends Error {\n /**\n * List of {@link Diagnostic} items emitted while compiling .slint code.\n */\n diagnostics: napi.Diagnostic[];\n\n /**\n * Creates a new CompileError.\n *\n * @param message human-readable description of the error.\n * @param diagnostics represent a list of diagnostic items emitted while compiling .slint code.\n */\n constructor(message: string, diagnostics: napi.Diagnostic[]) {\n const formattedDiagnostics = diagnostics\n .map(\n (d) =>\n `[${d.fileName}:${d.lineNumber}:${d.columnNumber}] ${d.message}`,\n )\n .join(\"\\n\");\n\n let formattedMessage = message;\n if (diagnostics.length > 0) {\n formattedMessage += `\\nDiagnostics:\\n${formattedDiagnostics}`;\n }\n\n super(formattedMessage);\n this.diagnostics = diagnostics;\n }\n}\n\n/**\n * LoadFileOptions are used to defines different optional parameters that can be used to configure the compiler.\n */\nexport interface LoadFileOptions {\n /**\n * If set to true warnings from the compiler will not be printed to the console.\n */\n quiet?: boolean;\n\n /**\n * Sets the widget style the compiler is currently using when compiling .slint files.\n */\n style?: string;\n\n /**\n * Sets the include paths used for looking up `.slint` imports to the specified vector of paths.\n */\n includePaths?: Array;\n\n /**\n * Sets library paths used for looking up `@library` imports to the specified map of library names to paths.\n */\n libraryPaths?: Record;\n\n /**\n * @hidden\n */\n fileLoader?: (path: string) => string;\n}\n\ntype LoadData =\n | {\n fileData: {\n filePath: string;\n options?: LoadFileOptions;\n };\n from: \"file\";\n }\n | {\n fileData: {\n source: string;\n filePath: string;\n options?: LoadFileOptions;\n };\n from: \"source\";\n };\n\nfunction translateName(key: string): string {\n return key.replace(/-/g, \"_\");\n}\n\nfunction loadSlint(loadData: LoadData): Object {\n const { filePath, options } = loadData.fileData;\n\n const compiler = new napi.ComponentCompiler();\n\n if (typeof options !== \"undefined\") {\n if (typeof options.style !== \"undefined\") {\n compiler.style = options.style;\n }\n if (typeof options.includePaths !== \"undefined\") {\n compiler.includePaths = options.includePaths;\n }\n if (typeof options.libraryPaths !== \"undefined\") {\n compiler.libraryPaths = options.libraryPaths;\n }\n if (typeof options.fileLoader !== \"undefined\") {\n compiler.fileLoader = options.fileLoader;\n }\n }\n\n const definitions =\n loadData.from === \"file\"\n ? compiler.buildFromPath(filePath)\n : compiler.buildFromSource(loadData.fileData.source, filePath);\n const diagnostics = compiler.diagnostics;\n\n if (diagnostics.length > 0) {\n const warnings = diagnostics.filter(\n (d) => d.level === napi.DiagnosticLevel.Warning,\n );\n\n if (typeof options !== \"undefined\" && options.quiet !== true) {\n warnings.forEach((w) => console.warn(\"Warning: \" + w));\n }\n\n const errors = diagnostics.filter(\n (d) => d.level === napi.DiagnosticLevel.Error,\n );\n\n if (errors.length > 0) {\n throw new CompileError(\"Could not compile \" + filePath, errors);\n }\n }\n\n const slint_module = Object.create({});\n\n // generate structs\n const structs = compiler.structs;\n\n for (const key in compiler.structs) {\n Object.defineProperty(slint_module, translateName(key), {\n value: function (properties: any) {\n const defaultObject = structs[key] as any;\n const newObject = Object.create({});\n\n for (const propertyKey in defaultObject) {\n const propertyName = translateName(propertyKey);\n const propertyValue =\n properties !== undefined &&\n Object.hasOwn(properties, propertyName)\n ? properties[propertyName]\n : defaultObject[propertyKey];\n\n Object.defineProperty(newObject, propertyName, {\n value: propertyValue,\n writable: true,\n enumerable: true,\n });\n }\n\n return Object.seal(newObject);\n },\n });\n }\n\n // generate enums\n const enums = compiler.enums;\n\n for (const key in enums) {\n Object.defineProperty(slint_module, translateName(key), {\n value: Object.seal(enums[key]),\n enumerable: true,\n });\n }\n\n Object.keys(definitions).forEach((key) => {\n const definition = definitions[key];\n\n Object.defineProperty(slint_module, translateName(definition.name), {\n value: function (properties: any) {\n const instance = definition.create();\n\n if (instance == null) {\n throw Error(\n \"Could not create a component handle for\" + filePath,\n );\n }\n\n for (var key in properties) {\n const value = properties[key];\n\n if (value instanceof Function) {\n instance.setCallback(key, value);\n } else {\n instance.setProperty(key, properties[key]);\n }\n }\n\n const componentHandle = new Component(instance!);\n instance!.definition().properties.forEach((prop) => {\n const propName = translateName(prop.name);\n\n if (componentHandle[propName] !== undefined) {\n console.warn(\"Duplicated property name \" + propName);\n } else {\n Object.defineProperty(componentHandle, propName, {\n get() {\n return instance!.getProperty(prop.name);\n },\n set(value) {\n instance!.setProperty(prop.name, value);\n },\n enumerable: true,\n });\n }\n });\n\n instance!.definition().callbacks.forEach((cb) => {\n const callbackName = translateName(cb);\n\n if (componentHandle[callbackName] !== undefined) {\n console.warn(\n \"Duplicated callback name \" + callbackName,\n );\n } else {\n Object.defineProperty(\n componentHandle,\n translateName(cb),\n {\n get() {\n return function () {\n return instance!.invoke(\n cb,\n Array.from(arguments),\n );\n };\n },\n set(callback) {\n instance!.setCallback(cb, callback);\n },\n enumerable: true,\n },\n );\n }\n });\n\n instance!.definition().functions.forEach((cb) => {\n const functionName = translateName(cb);\n\n if (componentHandle[functionName] !== undefined) {\n console.warn(\n \"Duplicated function name \" + functionName,\n );\n } else {\n Object.defineProperty(\n componentHandle,\n translateName(cb),\n {\n get() {\n return function () {\n return instance!.invoke(\n cb,\n Array.from(arguments),\n );\n };\n },\n enumerable: true,\n },\n );\n }\n });\n\n // globals\n instance!.definition().globals.forEach((globalName) => {\n const jsName = translateName(globalName);\n if (componentHandle[jsName] !== undefined) {\n console.warn(\n \"Duplicated property name \" +\n globalName +\n \" (In JS: \" +\n jsName +\n \")\",\n );\n } else {\n const globalObject = Object.create({});\n\n instance!\n .definition()\n .globalProperties(globalName)\n .forEach((prop) => {\n const propName = translateName(prop.name);\n\n if (globalObject[propName] !== undefined) {\n console.warn(\n \"Duplicated property name \" +\n propName +\n \" on global \" +\n global,\n );\n } else {\n Object.defineProperty(\n globalObject,\n propName,\n {\n get() {\n return instance!.getGlobalProperty(\n globalName,\n prop.name,\n );\n },\n set(value) {\n instance!.setGlobalProperty(\n globalName,\n prop.name,\n value,\n );\n },\n enumerable: true,\n },\n );\n }\n });\n\n instance!\n .definition()\n .globalCallbacks(globalName)\n .forEach((cb) => {\n const callbackName = translateName(cb);\n\n if (globalObject[callbackName] !== undefined) {\n console.warn(\n \"Duplicated property name \" +\n cb +\n \" on global \" +\n global,\n );\n } else {\n Object.defineProperty(\n globalObject,\n translateName(cb),\n {\n get() {\n return function () {\n return instance!.invokeGlobal(\n globalName,\n cb,\n Array.from(arguments),\n );\n };\n },\n set(callback) {\n instance!.setGlobalCallback(\n globalName,\n cb,\n callback,\n );\n },\n enumerable: true,\n },\n );\n }\n });\n\n instance!\n .definition()\n .globalFunctions(globalName)\n .forEach((cb) => {\n const functionName = translateName(cb);\n\n if (globalObject[functionName] !== undefined) {\n console.warn(\n \"Duplicated function name \" +\n cb +\n \" on global \" +\n global,\n );\n } else {\n Object.defineProperty(\n globalObject,\n translateName(cb),\n {\n get() {\n return function () {\n return instance!.invokeGlobal(\n globalName,\n cb,\n Array.from(arguments),\n );\n };\n },\n enumerable: true,\n },\n );\n }\n });\n\n Object.defineProperty(componentHandle, jsName, {\n get() {\n return globalObject;\n },\n enumerable: true,\n });\n }\n });\n\n return Object.seal(componentHandle);\n },\n });\n });\n return Object.seal(slint_module);\n}\n\n/**\n * Loads the specified Slint file and returns an object containing functions to construct the exported\n * components defined within the Slint file.\n *\n * The following example loads a \"Hello World\" style Slint file and changes the Text label to a new greeting:\n * **`main.slint`**:\n * ```\n * export component Main inherits Window {\n * in-out property greeting <=> label.text;\n * label := Text {\n * text: \"Hello World\";\n * }\n * }\n * ```\n *\n * **`index.js`**:\n * ```javascript\n * import * as slint from \"slint-ui\";\n * let ui = slint.loadFile(\"main.slint\");\n * let main = new ui.Main();\n * main.greeting = \"Hello friends\";\n * ```\n *\n * @param filePath The path to the file to load as `string` or `URL`. Relative paths are resolved against the process' current working directory.\n * @param options An optional {@link LoadFileOptions} to configure additional Slint compilation settings,\n * such as include search paths, library imports, or the widget style.\n * @returns Returns an object that is immutable and provides a constructor function for each exported Window component found in the `.slint` file.\n * For instance, in the example above, a `Main` property is available, which can be used to create instances of the `Main` component using the `new` keyword.\n * These instances offer properties and event handlers, adhering to the {@link ComponentHandle} interface.\n * For further information on the available properties, refer to [Instantiating A Component](../index.html#instantiating-a-component).\n * @throws {@link CompileError} if errors occur during compilation.\n */\nexport function loadFile(\n filePath: string | URL,\n options?: LoadFileOptions,\n): Object {\n const pathname =\n filePath instanceof URL ? fileURLToPath(filePath) : filePath;\n return loadSlint({\n fileData: { filePath: pathname, options },\n from: \"file\",\n });\n}\n\n/**\n * Loads the given Slint source code and returns an object that contains a functions to construct the exported\n * components of the Slint source code.\n *\n * The following example loads a \"Hello World\" style Slint source code and changes the Text label to a new greeting:\n * ```js\n * import * as slint from \"slint-ui\";\n * const source = `export component Main {\n * in-out property greeting <=> label.text;\n * label := Text {\n * text: \"Hello World\";\n * }\n * }`; // The content of main.slint\n * let ui = slint.loadSource(source, \"main.js\");\n * let main = new ui.Main();\n * main.greeting = \"Hello friends\";\n * ```\n * @param source The Slint source code to load.\n * @param filePath A path to the file to show log and resolve relative import and images.\n * Relative paths are resolved against the process' current working directory.\n * @param options An optional {@link LoadFileOptions} to configure additional Slint compilation settings,\n * such as include search paths, library imports, or the widget style.\n * @returns Returns an object that is immutable and provides a constructor function for each exported Window component found in the `.slint` file.\n * For instance, in the example above, a `Main` property is available, which can be used to create instances of the `Main` component using the `new` keyword.\n * These instances offer properties and event handlers, adhering to the {@link ComponentHandle} interface.\n * For further information on the available properties, refer to [Instantiating A Component](../index.html#instantiating-a-component).\n * @throws {@link CompileError} if errors occur during compilation.\n */\nexport function loadSource(\n source: string,\n filePath: string,\n options?: LoadFileOptions,\n): Object {\n return loadSlint({\n fileData: { filePath, options, source },\n from: \"source\",\n });\n}\n\nclass EventLoop {\n #quit_loop: boolean = false;\n #terminationPromise: Promise | null = null;\n #terminateResolveFn: ((_value: unknown) => void) | null;\n\n start(\n running_callback?: Function,\n quitOnLastWindowClosed: boolean = true,\n ): Promise {\n if (this.#terminationPromise != null) {\n return this.#terminationPromise;\n }\n\n this.#terminationPromise = new Promise((resolve) => {\n this.#terminateResolveFn = resolve;\n });\n this.#quit_loop = false;\n\n napi.setQuitOnLastWindowClosed(quitOnLastWindowClosed);\n\n if (running_callback !== undefined) {\n napi.invokeFromEventLoop(() => {\n running_callback();\n running_callback = undefined;\n });\n }\n\n // Give the nodejs event loop 16 ms to tick. This polling is sub-optimal, but it's the best we\n // can do right now.\n const nodejsPollInterval = 16;\n const id = setInterval(() => {\n if (\n napi.processEvents() === napi.ProcessEventsResult.Exited ||\n this.#quit_loop\n ) {\n clearInterval(id);\n this.#terminateResolveFn!(undefined);\n this.#terminateResolveFn = null;\n this.#terminationPromise = null;\n return;\n }\n }, nodejsPollInterval);\n\n return this.#terminationPromise;\n }\n\n quit() {\n this.#quit_loop = true;\n }\n}\n\nvar globalEventLoop: EventLoop = new EventLoop();\n\n/**\n * Spins the Slint event loop and returns a promise that resolves when the loop terminates.\n *\n * If the event loop is already running, then this function returns the same promise as from\n * the earlier invocation.\n *\n * @param args As Function it defines a callback that's invoked once when the event loop is running.\n * @param args.runningCallback Optional callback that's invoked once when the event loop is running.\n * The function's return value is ignored.\n * @param args.quitOnLastWindowClosed if set to `true` event loop is quit after last window is closed otherwise\n * it is closed after {@link quitEventLoop} is called.\n * This is useful for system tray applications where the application needs to stay alive even if no windows are visible.\n * (default true).\n *\n * Note that the event loop integration with Node.js is slightly imperfect. Due to conflicting\n * implementation details between Slint's and Node.js' event loop, the two loops are merged\n * by spinning one after the other, at 16 millisecond intervals. This means that when the\n * application is idle, it continues to consume a low amount of CPU cycles, checking if either\n * event loop has any pending events.\n */\nexport function runEventLoop(\n args?:\n | Function\n | { runningCallback?: Function; quitOnLastWindowClosed?: boolean },\n): Promise {\n if (args === undefined) {\n return globalEventLoop.start(undefined);\n }\n\n if (args instanceof Function) {\n return globalEventLoop.start(args);\n }\n\n return globalEventLoop.start(\n args.runningCallback,\n args.quitOnLastWindowClosed,\n );\n}\n\n/**\n * Stops a spinning event loop. This function returns immediately, and the promise returned\n from run_event_loop() will resolve in a later tick of the nodejs event loop.\n */\nexport function quitEventLoop() {\n globalEventLoop.quit();\n}\n\nexport namespace private_api {\n /**\n * Provides rows that are generated by a map function based on the rows of another Model.\n *\n * @template T item type of source model that is mapped to U.\n * @template U the type of the mapped items\n *\n * ## Example\n *\n * Here we have a {@link ArrayModel} holding rows of a custom interface `Name` and a {@link MapModel} that maps the name rows\n * to single string rows.\n *\n * ```ts\n * import { Model, ArrayModel, MapModel } from \"./index\";\n *\n * interface Name {\n * first: string;\n * last: string;\n * }\n *\n * const model = new ArrayModel([\n * {\n * first: \"Hans\",\n * last: \"Emil\",\n * },\n * {\n * first: \"Max\",\n * last: \"Mustermann\",\n * },\n * {\n * first: \"Roman\",\n * last: \"Tisch\",\n * },\n * ]);\n *\n * const mappedModel = new MapModel(\n * model,\n * (data) => {\n * return data.last + \", \" + data.first;\n * }\n * );\n *\n * // prints \"Emil, Hans\"\n * console.log(mappedModel.rowData(0));\n *\n * // prints \"Mustermann, Max\"\n * console.log(mappedModel.rowData(1));\n *\n * // prints \"Tisch, Roman\"\n * console.log(mappedModel.rowData(2));\n *\n * // Alternatively you can use the shortcut {@link MapModel.map}.\n *\n * const model = new ArrayModel([\n * {\n * first: \"Hans\",\n * last: \"Emil\",\n * },\n * {\n * first: \"Max\",\n * last: \"Mustermann\",\n * },\n * {\n * first: \"Roman\",\n * last: \"Tisch\",\n * },\n * ]);\n *\n * const mappedModel = model.map(\n * (data) => {\n * return data.last + \", \" + data.first;\n * }\n * );\n *\n *\n * // prints \"Emil, Hans\"\n * console.log(mappedModel.rowData(0));\n *\n * // prints \"Mustermann, Max\"\n * console.log(mappedModel.rowData(1));\n *\n * // prints \"Tisch, Roman\"\n * console.log(mappedModel.rowData(2));\n *\n * // You can modifying the underlying {@link ArrayModel}:\n *\n * const model = new ArrayModel([\n * {\n * first: \"Hans\",\n * last: \"Emil\",\n * },\n * {\n * first: \"Max\",\n * last: \"Mustermann\",\n * },\n * {\n * first: \"Roman\",\n * last: \"Tisch\",\n * },\n * ]);\n *\n * const mappedModel = model.map(\n * (data) => {\n * return data.last + \", \" + data.first;\n * }\n * );\n *\n * model.setRowData(1, { first: \"Minnie\", last: \"Musterfrau\" } );\n *\n * // prints \"Emil, Hans\"\n * console.log(mappedModel.rowData(0));\n *\n * // prints \"Musterfrau, Minnie\"\n * console.log(mappedModel.rowData(1));\n *\n * // prints \"Tisch, Roman\"\n * console.log(mappedModel.rowData(2));\n * ```\n */\n export class MapModel extends Model {\n readonly sourceModel: Model;\n #mapFunction: (data: T) => U;\n\n /**\n * Constructs the MapModel with a source model and map functions.\n * @template T item type of source model that is mapped to U.\n * @template U the type of the mapped items.\n * @param sourceModel the wrapped model.\n * @param mapFunction maps the data from T to U.\n */\n constructor(sourceModel: Model, mapFunction: (data: T) => U) {\n super(sourceModel.modelNotify);\n this.sourceModel = sourceModel;\n this.#mapFunction = mapFunction;\n }\n\n /**\n * Returns the number of entries in the model.\n */\n rowCount(): number {\n return this.sourceModel.rowCount();\n }\n\n /**\n * Returns the data at the specified row.\n * @param row index in range 0..(rowCount() - 1).\n * @returns undefined if row is out of range otherwise the data.\n */\n rowData(row: number): U | undefined {\n const data = this.sourceModel.rowData(row);\n if (data === undefined) {\n return undefined;\n }\n return this.#mapFunction(data);\n }\n }\n}\n\n/**\n * Initialize translations.\n *\n * Call this with the path where translations are located. This function internally calls the [bindtextdomain](https://man7.org/linux/man-pages/man3/bindtextdomain.3.html) function from gettext.\n *\n * Translations are expected to be found at //LC_MESSAGES/.mo, where path is the directory passed as an argument to this function, locale is a locale name (e.g., en, en_GB, fr), and domain is the package name.\n *\n * @param domain defines the domain name e.g. name of the package.\n * @param path specifies the directory as `string` or as `URL` in which gettext should search for translations.\n *\n * For example, assuming this is in a package called example and the default locale is configured to be French, it will load translations at runtime from ``/path/to/example/translations/fr/LC_MESSAGES/example.mo`.\n *\n * ```js\n * import * as slint from \"slint-ui\";\n * slint.initTranslations(\"example\", new URL(\"translations/\", import.meta.url));\n * ````\n */\nexport function initTranslations(domain: string, path: string | URL) {\n const pathname = path instanceof URL ? fileURLToPath(path) : path;\n napi.initTranslations(domain, pathname);\n}\n\n/**\n * Sets the application id for use on Wayland or X11 with [xdg](https://specifications.freedesktop.org/desktop-entry-spec/latest/)\n * compliant window managers. This must be set before the window is shown.\n */\nexport function setXdgAppId(app_id: string) {\n napi.setXdgAppId(app_id);\n}\n\n/**\n * @hidden\n */\nexport namespace private_api {\n export import mock_elapsed_time = napi.mockElapsedTime;\n export import get_mocked_time = napi.getMockedTime;\n export import ComponentCompiler = napi.ComponentCompiler;\n export import ComponentDefinition = napi.ComponentDefinition;\n export import ComponentInstance = napi.ComponentInstance;\n export import ValueType = napi.ValueType;\n export import Window = napi.Window;\n\n export import SlintBrush = napi.SlintBrush;\n export import SlintRgbaColor = napi.SlintRgbaColor;\n export import SlintSize = napi.SlintSize;\n export import SlintPoint = napi.SlintPoint;\n export import SlintImageData = napi.SlintImageData;\n\n export function send_mouse_click(\n component: Component,\n x: number,\n y: number,\n ) {\n component.component_instance.sendMouseClick(x, y);\n }\n\n export function send_keyboard_string_sequence(\n component: Component,\n s: string,\n ) {\n component.component_instance.sendKeyboardStringSequence(s);\n }\n\n export import initTesting = napi.initTesting;\n}\n" }, { "path": "api/node/typescript/models.ts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport * as napi from \"../rust-module.cjs\";\n\nclass ModelIterator implements Iterator {\n private row: number;\n private model: Model;\n\n constructor(model: Model) {\n this.model = model;\n this.row = 0;\n }\n\n public next(): IteratorResult {\n if (this.row < this.model.rowCount()) {\n const row = this.row;\n this.row++;\n return {\n done: false,\n value: this.model.rowData(row),\n };\n }\n return {\n done: true,\n value: undefined,\n };\n }\n}\n\n/**\n * Model is the interface for feeding dynamic data into\n * `.slint` views.\n *\n * A model is organized like a table with rows of data. The\n * fields of the data type T behave like columns.\n *\n * @template T the type of the model's items.\n *\n * ### Example\n * As an example let's see the implementation of {@link ArrayModel}\n *\n * ```js\n * export class ArrayModel extends Model {\n * private a: Array\n *\n * constructor(arr: Array) {\n * super();\n * this.a = arr;\n * }\n *\n * rowCount() {\n * return this.a.length;\n * }\n *\n * rowData(row: number) {\n * return this.a[row];\n * }\n *\n * setRowData(row: number, data: T) {\n * this.a[row] = data;\n * this.notifyRowDataChanged(row);\n * }\n *\n * push(...values: T[]) {\n * let size = this.a.length;\n * Array.prototype.push.apply(this.a, values);\n * this.notifyRowAdded(size, arguments.length);\n * }\n *\n * remove(index: number, size: number) {\n * let r = this.a.splice(index, size);\n * this.notifyRowRemoved(index, size);\n * }\n *\n * get length(): number {\n * return this.a.length;\n * }\n *\n * values(): IterableIterator {\n * return this.a.values();\n * }\n *\n * entries(): IterableIterator<[number, T]> {\n * return this.a.entries()\n * }\n *}\n * ```\n */\nexport abstract class Model implements Iterable {\n /**\n * @hidden\n */\n modelNotify: napi.ExternalObject;\n\n /**\n * @hidden\n */\n constructor(modelNotify?: napi.ExternalObject) {\n this.modelNotify = modelNotify ?? napi.jsModelNotifyNew();\n }\n\n // /**\n // * Returns a new Model where all elements are mapped by the function `mapFunction`.\n // * @template T the type of the source model's items.\n // * @param mapFunction functions that maps\n // * @returns a new {@link MapModel} that wraps the current model.\n // */\n // map(\n // mapFunction: (data: T) => U\n // ): MapModel {\n // return new MapModel(this, mapFunction);\n // }\n\n /**\n * Implementations of this function must return the current number of rows.\n */\n abstract rowCount(): number;\n /**\n * Implementations of this function must return the data at the specified row.\n * @param row index in range 0..(rowCount() - 1).\n * @returns undefined if row is out of range otherwise the data.\n */\n abstract rowData(row: number): T | undefined;\n\n /**\n * Implementations of this function must store the provided data parameter\n * in the model at the specified row.\n * @param _row index in range 0..(rowCount() - 1).\n * @param _data new data item to store on the given row index\n */\n setRowData(_row: number, _data: T): void {\n console.log(\n \"setRowData called on a model which does not re-implement this method. This happens when trying to modify a read-only model\",\n );\n }\n\n [Symbol.iterator](): Iterator {\n return new ModelIterator(this);\n }\n\n /**\n * Notifies the view that the data of the current row is changed.\n * @param row index of the changed row.\n */\n protected notifyRowDataChanged(row: number): void {\n napi.jsModelNotifyRowDataChanged(this.modelNotify, row);\n }\n\n /**\n * Notifies the view that multiple rows are added to the model.\n * @param row index of the first added row.\n * @param count the number of added items.\n */\n protected notifyRowAdded(row: number, count: number): void {\n napi.jsModelNotifyRowAdded(this.modelNotify, row, count);\n }\n\n /**\n * Notifies the view that multiple rows are removed to the model.\n * @param row index of the first removed row.\n * @param count the number of removed items.\n */\n protected notifyRowRemoved(row: number, count: number): void {\n napi.jsModelNotifyRowRemoved(this.modelNotify, row, count);\n }\n\n /**\n * Notifies the view that the complete data must be reload.\n */\n protected notifyReset(): void {\n napi.jsModelNotifyReset(this.modelNotify);\n }\n}\n\n/**\n * ArrayModel wraps a JavaScript array for use in `.slint` views. The underlying\n * array can be modified with the [[ArrayModel.push]] and [[ArrayModel.remove]] methods.\n */\nexport class ArrayModel extends Model {\n /**\n * @hidden\n */\n #array: Array;\n\n /**\n * Creates a new ArrayModel.\n *\n * @param arr\n */\n constructor(arr: Array) {\n super();\n this.#array = arr;\n }\n\n /**\n * Returns the number of entries in the array model.\n */\n get length(): number {\n return this.#array.length;\n }\n\n /**\n * Returns the number of entries in the array model.\n */\n rowCount() {\n return this.#array.length;\n }\n\n /**\n * Returns the data at the specified row.\n * @param row index in range 0..(rowCount() - 1).\n * @returns undefined if row is out of range otherwise the data.\n */\n rowData(row: number) {\n return this.#array[row];\n }\n\n /**\n * Stores the given data on the given row index and notifies run-time about the changed row.\n * @param row index in range 0..(rowCount() - 1).\n * @param data new data item to store on the given row index\n */\n setRowData(row: number, data: T) {\n this.#array[row] = data;\n this.notifyRowDataChanged(row);\n }\n\n /**\n * Pushes new values to the array that's backing the model and notifies\n * the run-time about the added rows.\n * @param values list of values that will be pushed to the array.\n */\n push(...values: T[]) {\n const size = this.#array.length;\n Array.prototype.push.apply(this.#array, values);\n this.notifyRowAdded(size, arguments.length);\n }\n\n /**\n * Removes the last element from the array and returns it.\n *\n * @returns The removed element or undefined if the array is empty.\n */\n pop(): T | undefined {\n const last = this.#array.pop();\n if (last !== undefined) {\n this.notifyRowRemoved(this.#array.length, 1);\n }\n return last;\n }\n\n // FIXME: should this be named splice and have the splice api?\n /**\n * Removes the specified number of element from the array that's backing\n * the model, starting at the specified index.\n * @param index index of first row to remove.\n * @param size number of rows to remove.\n */\n remove(index: number, size: number) {\n const r = this.#array.splice(index, size);\n this.notifyRowRemoved(index, size);\n }\n\n /**\n * Returns an iterable of values in the array.\n */\n values(): IterableIterator {\n return this.#array.values();\n }\n\n /**\n * Returns an iterable of key, value pairs for every entry in the array.\n */\n entries(): IterableIterator<[number, T]> {\n return this.#array.entries();\n }\n}\n" }, { "path": "api/node/vitest.config.ts", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport { defineConfig } from \"vitest/config\";\n\nexport default defineConfig({\n test: {\n include: [\"**/*.spec.mts\"],\n globals: true, // Enable global test/expect/describe\n pool: \"forks\", // Use process forks (required for native modules that need main thread)\n teardownTimeout: 5000, // Force teardown after 5s to prevent hanging processes\n reporters: [\"verbose\"], // Show individual test names\n },\n});\n" }, { "path": "api/python/briefcase/README.md", "content": "\n# Briefcase Slint Plugin\n\nThe `briefcasex-slint` package extends the [Briefcase](https://briefcase.beeware.org/en/stable/) tool\nwith support for Slint as toolkit for standalone applications.\n\nInstall it in your Python environment, and `briefcase new` will offer you Slint as GUI framework for your next application.\n\n## Get Started\n\nIn a terminal, create a new Python environment and run the following commands:\n\n1. `pip install briefcasex-slint`\n2. `briefcase new -Q bootstrap=Slint`\n\nFollowing the instructions on the screen.\n" }, { "path": "api/python/briefcase/pyproject.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[project]\nname = \"briefcasex-slint\"\nversion = \"1.16.0b1\"\ndescription = \"Plugin for Briefcase to offer Slint application templates\"\nreadme = \"README.md\"\nrequires-python = \">=3.10\"\ndependencies = [\"briefcase>=0.3.23\"]\n\n[project.entry-points.\"briefcase.bootstraps\"]\nSlint = \"briefcasex_slint:SlintGuiBootstrap\"\n\n[build-system]\nrequires = [\"hatchling\"]\nbuild-backend = \"hatchling.build\"\n" }, { "path": "api/python/briefcase/src/briefcasex_slint/__init__.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom pathlib import Path\n\nfrom briefcase.bootstraps.base import BaseGuiBootstrap\n\n\nclass SlintGuiBootstrap(BaseGuiBootstrap):\n display_name_annotation = \"does not support Android/Web deployment\"\n\n def app_source(self):\n return \"\"\"\\\nimport slint\n\nclass {{ cookiecutter.class_name }}(slint.loader.{{ cookiecutter.module_name }}.resources.app_window.AppWindow):\n @slint.callback\n def request_increase_value(self):\n self.counter = self.counter + 1\n\n\ndef main():\n main_window = {{ cookiecutter.class_name }}()\n main_window.show()\n main_window.run()\n\"\"\"\n\n def app_start_source(self):\n return \"\"\"\\\nfrom {{ cookiecutter.module_name }}.app import main\n\nif __name__ == \"__main__\":\n main()\n\"\"\"\n\n def pyproject_table_briefcase_app_extra_content(self):\n return \"\"\"\nrequires = [\n]\ntest_requires = [\n{% if cookiecutter.test_framework == \"pytest\" %}\n \"pytest\",\n{% endif %}\n]\n\"\"\"\n\n def pyproject_table_macOS(self):\n return \"\"\"\\\nuniversal_build = false\nrequires = [\n \"slint\",\n]\n\"\"\"\n\n def pyproject_table_linux(self):\n return \"\"\"\\\nrequires = [\n \"slint\",\n]\n\"\"\"\n\n def pyproject_table_windows(self):\n return \"\"\"\\\nrequires = [\n \"slint\",\n]\n\"\"\"\n\n def pyproject_table_iOS(self):\n return \"\"\"\\\nrequires = [\n \"slint\",\n]\n\"\"\"\n\n def post_generate(self, base_path: Path) -> None:\n target_dir = base_path / self.context[\"source_dir\"] / \"resources\"\n target_dir.mkdir(parents=True, exist_ok=True)\n with open(target_dir / \"app-window.slint\", \"w\") as slint_file:\n slint_file.write(r\"\"\"\nimport { Button, VerticalBox, AboutSlint } from \"std-widgets.slint\";\n\nexport component AppWindow inherits Window {\n in-out property counter: 42;\n callback request-increase-value();\n VerticalBox {\n alignment: center;\n AboutSlint {}\n Text {\n text: \"Counter: \\{root.counter}\";\n }\n Button {\n text: \"Increase value\";\n clicked => {\n root.request-increase-value();\n }\n }\n }\n}\n\"\"\")\n" }, { "path": "api/python/slint/.gitignore", "content": "slint/*.so\nslint/language.pyi\nuv.lock\ndocs\n" }, { "path": "api/python/slint/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[package]\nname = \"slint-python\"\nversion.workspace = true\nauthors.workspace = true\nedition.workspace = true\nlicense.workspace = true\ndescription = \"Slint Python integration\"\nrepository.workspace = true\nhomepage.workspace = true\npublish = false\nrust-version.workspace = true\n\n[lib]\npath = \"lib.rs\"\ncrate-type = [\"cdylib\", \"rlib\"]\n\n[[bin]]\nname = \"stub-gen\"\npath = \"stub-gen/main.rs\"\n\n[features]\ndefault = [\"backend-winit\", \"renderer-femtovg\", \"renderer-software\", \"backend-qt\", \"accessibility\"]\n# Keep in sync with features in nightly_snapshot.yaml, cpp_package.yaml, slint_tool_binary.yaml, and api/node/Cargo.toml\n# binaries: default = [\"backend-linuxkms-noseat\", \"backend-winit\", \"renderer-femtovg\", \"renderer-skia\", \"accessibility\"]\n\nbackend-qt = [\"slint-interpreter/backend-qt\"]\nbackend-winit = [\"slint-interpreter/backend-winit\"]\nbackend-winit-x11 = [\"slint-interpreter/backend-winit-x11\"]\nbackend-winit-wayland = [\"slint-interpreter/backend-winit-wayland\"]\nbackend-linuxkms = [\"slint-interpreter/backend-linuxkms\"]\nbackend-linuxkms-noseat = [\"slint-interpreter/backend-linuxkms-noseat\"]\nbackend-testing = [\"i-slint-backend-selector/backend-testing\"]\nrenderer-femtovg = [\"slint-interpreter/renderer-femtovg\"]\nrenderer-femtovg-wgpu = [\"slint-interpreter/renderer-femtovg-wgpu\"]\nrenderer-skia = [\"slint-interpreter/renderer-skia\"]\nrenderer-skia-opengl = [\"slint-interpreter/renderer-skia-opengl\"]\nrenderer-skia-vulkan = [\"slint-interpreter/renderer-skia-vulkan\"]\nrenderer-software = [\"slint-interpreter/renderer-software\"]\naccessibility = [\"slint-interpreter/accessibility\"]\n\n\n[dependencies]\ni-slint-backend-selector = { workspace = true }\ni-slint-common = { workspace = true }\ni-slint-core = { workspace = true, features = [\"tr\"] }\nslint-interpreter = { workspace = true, features = [\"default\", \"display-diagnostics\", \"internal\", \"internal-highlight\"] }\ni-slint-compiler = { workspace = true, features = [\"python\"] }\npyo3 = { version = \"0.28\", features = [\"extension-module\", \"indexmap\", \"chrono\", \"abi3-py311\"] }\nindexmap = { version = \"2.1.0\" }\nchrono = \"0.4\"\nspin_on = { workspace = true }\ncss-color-parser2 = { workspace = true }\npyo3-stub-gen = { version = \"0.18.0\", default-features = false }\nsmol = { version = \"2.0.0\" }\n\n[build-dependencies]\ni-slint-common = { workspace = true }\n\n[package.metadata.maturin]\npython-source = \"slint\"\n" }, { "path": "api/python/slint/README.md", "content": "\n# Slint-python (Beta)\n\n[Slint](https://slint.dev/) is a UI toolkit that supports different programming languages.\nSlint-python is the integration with Python.\n\n**Warning**\nSlint-python is in a beta phase of development: The APIs while mostly stable, may be subject to further changes. Any changes will be documented in the ChangeLog.\n\nYou can track the progress for the Python integration by looking at python-labelled issues at https://github.com/slint-ui/slint/labels/a%3Alanguage-python .\n\n## Slint Language Manual\n\nThe [Slint Language Documentation](../slint) covers the Slint UI description language\nin detail.\n\n## Prerequisites\n\n * [Python 3](https://python.org/)\n * [uv](https://docs.astral.sh/uv/) or [pip](https://pypi.org/project/pip/)\n\n## Installation\n\nInstall Slint with `uv` or `pip` from the [Python Package Index](https://pypi.org):\n\n```bash\nuv add slint\n```\n\nThe installation uses binaries provided for macOS, Windows, and Linux for various architectures. If your target platform\nis not covered by binaries, `uv` will automatically build Slint from source. If that happens, you will then need some\nsoftware development tools on your machine, as well as [Rust](https://www.rust-lang.org/learn/get-started).\n\n## Quick Start\n\n1. Create a new project with `uv init`.\n2. Add the Slint Python package to your Python project: `uv add slint`\n3. Create a file called `app-window.slint`:\n\n```slint\nimport { Button, VerticalBox } from \"std-widgets.slint\";\n\nexport component AppWindow inherits Window {\n in-out property counter: 42;\n callback request-increase-value();\n VerticalBox {\n Text {\n text: \"Counter: \\{root.counter}\";\n }\n Button {\n text: \"Increase value\";\n clicked => {\n root.request-increase-value();\n }\n }\n }\n}\n```\n\n4. Create a file called `main.py`:\n\n```python\nimport slint\n\n# slint.loader will look in `sys.path` for `app-window.slint`.\nclass App(slint.loader.app_window.AppWindow):\n @slint.callback\n def request_increase_value(self):\n self.counter = self.counter + 1\n\napp = App()\napp.run()\n```\n\n5. Run it with `uv run main.py`\n\n## API Overview\n\n### Instantiating a Component\n\nThe following example shows how to instantiate a Slint component in Python:\n\n**`app.slint`**\n\n```slint\nexport component MainWindow inherits Window {\n callback clicked <=> i-touch-area.clicked;\n\n in property counter;\n\n width: 400px;\n height: 200px;\n\n i-touch-area := TouchArea {}\n}\n```\n\nThe exported component is exposed as a Python class. To access this class, you have two options:\n\n1. Call `slint.load_file(\"app.slint\")`. The returned object is a [namespace](https://docs.python.org/3/library/types.html#types.SimpleNamespace),\n that provides the `MainWindow` class as well as any other explicitly exported component that inherits `Window`:\n\n ```python\n import slint\n components = slint.load_file(\"app.slint\")\n main_window = components.MainWindow()\n ```\n\n2. Use Slint's auto-loader, which lazily loads `.slint` files from `sys.path`:\n\n ```python\n import slint\n # Look for for `app.slint` in `sys.path`:\n main_window = slint.loader.app.MainWindow()\n ```\n\n Any attribute lookup in `slint.loader` is searched for in `sys.path`. If a directory with the name exists, it is\n returned as a loader object, and subsequent attribute lookups follow the same logic.\n\n If the name matches a file with the `.slint` extension, it is automatically loaded with `load_file` and the\n [namespace](https://docs.python.org/3/library/types.html#types.SimpleNamespace) is returned.\n\n If the file name contains a dash, like `app-window.slint`, an attribute lookup for `app_window` tries to\n locate `app_window.slint` and then fall back to `app-window.slint`.\n\n### Accessing Properties\n\n[Properties](../slint/src/language/syntax/properties) declared as `out` or `in-out` in `.slint` files are visible as\nproperties on the component instance.\n\n```python\nmain_window.counter = 42\nprint(main_window.counter)\n```\n\n### Accessing Globals\n\n[Global Singletons](https://slint.dev/docs/slint/src/language/syntax/globals#global-singletons) are accessible in\nPython as properties in the component instance.\n\nFor example, this Slint code declares a `PrinterJobQueue` singleton:\n\n```slint\nexport global PrinterJobQueue {\n in-out property job-count;\n}\n```\n\nAccess it as a property on the component instance by its name:\n\n```python\nprint(\"job count:\", instance.PrinterJobQueue.job_count)\n```\n\n**Note**: Global singletons are instantiated once per component. When declaring multiple components for `export` to Python,\neach instance has their own associated globals singletons.\n\n### Setting and Invoking Callbacks\n\n[Callbacks](src/language/syntax/callbacks) declared in `.slint` files are visible as callable properties on the component\ninstance. Invoke them as functions to invoke the callback, and assign Python callables to set the callback handler.\n\nIn Slint, callbacks are defined using the `callback` keyword and can be connected to another component's callback using\nthe `<=>` syntax.\n\n**`my-component.slint`**\n\n```slint\nexport component MyComponent inherits Window {\n callback clicked <=> i-touch-area.clicked;\n\n width: 400px;\n height: 200px;\n\n i-touch-area := TouchArea {}\n}\n```\n\nThe callbacks in Slint are exposed as properties and that can be called as functions.\n\n**`main.py`**\n\n```python\nimport slint\n\ncomponent = slint.loader.my_component.MyComponent()\n# connect to a callback\n\ndef clicked():\n print(\"hello\")\n\ncomponent.clicked = clicked\n// invoke a callback\ncomponent.clicked();\n```\n\nAnother way to set callbacks is to sub-class and use the `@slint.callback` decorator:\n\n```python\nimport slint\n\nclass Component(slint.loader.my_component.MyComponent):\n @slint.callback\n def clicked(self):\n print(\"hello\")\n\ncomponent = Component()\n```\n\nThe `@slint.callback()` decorator accepts a `name` argument, if the name of the method does not match the name of the\ncallback in the `.slint` file. Similarly, a `global_name` argument can be used to bind a method to a callback in a global\nsingleton.\n\n### Type Mappings\n\nEach type used for properties in the Slint Language translates to a specific type in Python. The following table summarizes\nthe mapping:\n\n| `.slint` Type | Python Type | Notes |\n| ------------- | ----------- | ----- |\n| `int` | `int` | |\n| `float` | `float` | |\n| `string` | `str` | |\n| `color` | `slint.Color` | |\n| `brush` | `slint.Brush` | |\n| `image` | `slint.Image` | |\n| `length` | `float` | |\n| `physical_length` | `float` | |\n| `duration` | `float` | The number of milliseconds |\n| `angle` | `float` | The angle in degrees |\n| structure | `dict`/`Struct` | When reading, structures are mapped to data classes, when writing dicts are also accepted. |\n| array | `slint.Model` | |\n\n### Arrays and Models\n\nYou can set [array properties](../slint/src/language/syntax/types#arrays-and-models) from Python by passing subclasses of\n`slint.Model`.\n\nUse the `slint.ListModel` class to construct a model from an iterable:\n\n```python\ncomponent.model = slint.ListModel([1, 2, 3]);\ncomponent.model.append(4)\ndel component.model[0]\n```\n\nWhen sub-classing `slint.Model`, provide the following methods:\n\n```python\n def row_count(self):\n \"\"\"Return the number of rows in your model\"\"\"\n\n def row_data(self, row):\n \"\"\"Return data at specified row\"\"\"\n\n def set_row_data(self, row, data):\n \"\"\"For read-write models, store data in the given row. When done call set.notify_row_changed:\"\n ...\"\"\"\n self.notify_row_changed(row)\n```\n\nWhen adding or inserting rows, call `notify_row_added(row, count)` on the super class. Similarly, when removing rows, notify\nSlint by calling `notify_row_removed(row, count)`.\n\n### Structs\n\nStructs declared in Slint and exposed to Python via `export` are then accessible in the namespace that is returned\nwhen [instantiating a component](#instantiating-a-component).\n\n**`app.slint`**\n\n```slint\nexport struct MyData {\n name: string,\n age: int\n}\n\nexport component MainWindow inherits Window {\n in-out property data;\n}\n```\n\n**`main.py`**\n\nThe exported `MyData` struct can be constructed as follows:\n\n```python\nimport slint\n# Look for for `app.slint` in `sys.path`:\nmain_window = slint.loader.app.MainWindow()\n\ndata = slint.loader.app.MyData(name = \"Simon\")\ndata.age = 10\nmain_window.data = data\n```\n\n### Enums\n\nEnums declared in Slint and exposed to Python via `export` are then accessible in the namespace that is returned\nwhen [instantiating a component](#instantiating-a-component). The enums are subclasses of [enum.Enum](https://docs.python.org/3/library/enum.html).\n\n**`app.slint`**\n\n```slint\nexport enum MyOption {\n Variant1,\n Variant2\n}\n\nexport component MainWindow inherits Window {\n in-out property data;\n}\n```\n\n**`main.py`**\n\nVariants of the exported `MyOption` enum can be constructed as follows:\n\n```python\nimport slint\n# Look for for `app.slint` in `sys.path`:\nmain_window = slint.loader.app.MainWindow()\n\nvalue = slint.loader.app.MyOption.Variant2\nmain_window.data = value\n```\n\n## Asynchronous I/O\n\nUse Python's [asyncio](https://docs.python.org/3/library/asyncio.html) library to write concurrent Python code with the `async`/`await` syntax.\n\nSlint's event loop is a full-featured [asyncio event loop](https://docs.python.org/3/library/asyncio-eventloop.html#asyncio-event-loop). While\nthe event loop is running, [`asyncio.get_event_loop()`](https://docs.python.org/3/library/asyncio-eventloop.html#asyncio.get_running_loop) returns\na valid loop. To run an async function when starting the loop, pass a coroutine to `slint.run_event_loop()`.\n\nFor the common use case of interacting with REST APIs, we recommend the [`aiohttp` library](https://docs.aiohttp.org/en/stable/).\n\n### Known Limitations\n\n- Pipes and sub-processes are only supported on Unix-like platforms.\n\n## Type Hints\n\n[PEP 484](https://peps.python.org/pep-0484/) introduces a standard syntax for type annotations to Python, enabling static analysis for\ntype checking, refactoring, and code completion. Popular type checkers include [mypy](http://mypy-lang.org/), [Pyre](https://pyre-check.org),\nand Astral's [ty](https://docs.astral.sh/ty/).\n\nUse Slint's [slint-compiler](https://pypi.org/project/slint-compiler/) to generate stub `.py` files for `.slint` files, which are annotated with\ntype information. These replace the need to call `load_file` or any use of `slint.loader`.\n\n1. Create a new project with `uv init`.\n2. Add the Slint Python package to your Python project: `uv add slint`\n3. Create a file called `app-window.slint`:\n\n```slint\nimport { Button, VerticalBox } from \"std-widgets.slint\";\n\nexport component AppWindow inherits Window {\n in-out property counter: 42;\n callback request-increase-value();\n VerticalBox {\n Text {\n text: \"Counter: \\{root.counter}\";\n }\n Button {\n text: \"Increase value\";\n clicked => {\n root.request-increase-value();\n }\n }\n }\n}\n```\n\n4. Run the [slint-compiler](https://pypi.org/project/slint-compiler/) to generate `app_window.py`:\n `uvx slint-compiler -f python -o app_window.py app-window.slint`\n\n5. Create a file called `main.py`:\n\n```python\nimport slint\nimport app_window\n\nclass App(app_window.AppWindow):\n @slint.callback\n def request_increase_value(self):\n self.counter = self.counter + 1\n\napp = App()\napp.run()\n```\n\n5. Run it with `uv run main.py`\n\n\n## Third-Party Licenses\n\nFor a list of the third-party licenses of all dependencies, see the separate [Third-Party Licenses page](thirdparty.html).\n" }, { "path": "api/python/slint/api_match.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse std::path::PathBuf;\n\nuse pyo3::prelude::*;\nuse pyo3_stub_gen::{derive::gen_stub_pyclass, derive::gen_stub_pymethods};\n\n#[gen_stub_pyclass]\n#[pyclass(name = \"GeneratedAPI\", unsendable)]\npub struct PyGeneratedAPI {\n pub(crate) path: PathBuf,\n pub(crate) module: i_slint_compiler::generator::python::PyModule,\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl PyGeneratedAPI {\n #[new]\n fn new(path: PathBuf, json: &str) -> PyResult {\n let module = i_slint_compiler::generator::python::PyModule::load_from_json(json)\n .map_err(|e| pyo3::exceptions::PyRuntimeError::new_err(e.to_string()))?;\n Ok(Self { path, module })\n }\n\n #[staticmethod]\n fn compare_generated_vs_actual(generated: &Self, actual: &Self) -> PyResult<()> {\n let changed_globals = generated.module.changed_globals(&actual.module);\n let changed_components = generated.module.changed_components(&actual.module);\n let changed_structs_or_enums = generated.module.changed_structs_or_enums(&actual.module);\n\n let diff = changed_globals.is_some()\n || changed_components.is_some()\n || changed_structs_or_enums.is_some();\n\n let incompatible_changes =\n changed_globals.as_ref().map_or(false, |c| c.incompatible_changes())\n || changed_components.as_ref().map_or(false, |c| c.incompatible_changes())\n || changed_structs_or_enums.as_ref().map_or(false, |c| c.incompatible_changes());\n\n if diff {\n let slint_file = actual.path.display();\n let python_file = generated.path.display();\n eprintln!(\n r#\"Changes detected between {slint_file} and {python_file}\nRe-run the slint compiler to re-generate the file, for example:\n\nuxv slint-compiler -f python -o {slint_file} {python_file}\n\"#,\n )\n }\n\n if incompatible_changes {\n Err(pyo3::exceptions::PyRuntimeError::new_err(format!(\n \"Incompatible API changes detected between {} and {}\",\n generated.path.display(),\n actual.path.display()\n )))\n } else {\n Ok(())\n }\n }\n}\n" }, { "path": "api/python/slint/async_adapter.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse std::rc::Rc;\n\nuse pyo3::prelude::*;\nuse pyo3_stub_gen::{derive::gen_stub_pyclass, derive::gen_stub_pymethods};\n\n#[cfg(unix)]\nstruct PyFdWrapper(std::os::fd::RawFd);\n\n#[cfg(unix)]\nimpl std::os::fd::AsFd for PyFdWrapper {\n fn as_fd(&self) -> std::os::fd::BorrowedFd<'_> {\n unsafe { std::os::fd::BorrowedFd::borrow_raw(self.0) }\n }\n}\n\n#[cfg(windows)]\nstruct PyFdWrapper(#[cfg(windows)] std::os::windows::io::RawSocket);\n\n#[cfg(windows)]\nimpl std::os::windows::io::AsSocket for PyFdWrapper {\n fn as_socket(&self) -> std::os::windows::io::BorrowedSocket<'_> {\n unsafe { std::os::windows::io::BorrowedSocket::borrow_raw(self.0) }\n }\n}\n\nstruct AdapterInner {\n adapter: smol::Async,\n readable_callback: Option>,\n writable_callback: Option>,\n}\n\n#[gen_stub_pyclass]\n#[pyclass(unsendable)]\npub struct AsyncAdapter {\n inner: Option>,\n task: Option>,\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl AsyncAdapter {\n #[new]\n fn py_new(fd: i32) -> Self {\n #[cfg(windows)]\n let fd = u64::try_from(fd).unwrap();\n AsyncAdapter {\n inner: Some(Rc::new(AdapterInner {\n adapter: smol::Async::new(PyFdWrapper(fd)).unwrap(),\n readable_callback: Default::default(),\n writable_callback: Default::default(),\n })),\n task: None,\n }\n }\n\n fn wait_for_readable(&mut self, callback: Py) {\n self.restart_after_mut_inner_access(|inner| {\n inner.readable_callback.replace(callback);\n });\n }\n\n fn wait_for_writable(&mut self, callback: Py) {\n self.restart_after_mut_inner_access(|inner| {\n inner.writable_callback.replace(callback);\n });\n }\n}\n\nimpl AsyncAdapter {\n fn restart_after_mut_inner_access(&mut self, callback: impl FnOnce(&mut AdapterInner)) {\n if let Some(task) = self.task.take() {\n task.abort();\n }\n\n // This detaches and basically makes any existing future that might get woke up fail when\n // trying to upgrade the weak.\n let mut inner = Rc::into_inner(self.inner.take().unwrap()).unwrap();\n\n callback(&mut inner);\n\n let inner = Rc::new(inner);\n let inner_weak = Rc::downgrade(&inner);\n self.inner = Some(inner);\n self.task = Some(\n slint_interpreter::spawn_local(std::future::poll_fn(move |cx| {\n loop {\n let Some(inner) = inner_weak.upgrade() else {\n return std::task::Poll::Ready(());\n };\n\n let readable_poll_status: Option>> =\n inner.readable_callback.as_ref().map(|callback| {\n if inner.adapter.poll_readable(cx).is_ready() {\n std::task::Poll::Ready(Python::attach(|py| callback.clone_ref(py)))\n } else {\n std::task::Poll::Pending\n }\n });\n\n let writable_poll_status: Option>> =\n inner.writable_callback.as_ref().map(|callback| {\n if inner.adapter.poll_writable(cx).is_ready() {\n std::task::Poll::Ready(Python::attach(|py| callback.clone_ref(py)))\n } else {\n std::task::Poll::Pending\n }\n });\n\n let fd = inner.adapter.get_ref().0;\n\n drop(inner);\n\n if let Some(std::task::Poll::Ready(callback)) = &readable_poll_status {\n Python::attach(|py| {\n callback.call1(py, (fd,)).expect(\n \"unexpected failure running python async readable adapter callback\",\n );\n });\n }\n\n if let Some(std::task::Poll::Ready(callback)) = &writable_poll_status {\n Python::attach(|py| {\n callback.call1(py, (fd,)).expect(\n \"unexpected failure running python async writable adapter callback\",\n );\n });\n }\n\n match &readable_poll_status {\n Some(std::task::Poll::Ready(..)) => continue, // poll again and then probably return in the next iteration\n Some(std::task::Poll::Pending) => return std::task::Poll::Pending, // waker registered, come back later\n None => {} // Nothing to poll\n }\n\n match &writable_poll_status {\n Some(std::task::Poll::Ready(..)) => continue, // poll again and then probably return in the next iteration\n Some(std::task::Poll::Pending) => return std::task::Poll::Pending, // waker registered, come back later\n None => {} // Nothing to poll\n }\n\n return std::task::Poll::Ready(());\n }\n }))\n .unwrap(),\n );\n }\n}\n" }, { "path": "api/python/slint/brush.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse pyo3::prelude::*;\nuse pyo3_stub_gen::{derive::gen_stub_pyclass, derive::gen_stub_pymethods, impl_stub_type};\n\nuse crate::errors::PyColorParseError;\n\n#[gen_stub_pyclass]\n#[pyclass]\n#[derive(FromPyObject)]\nstruct RgbaColor {\n #[pyo3(get, set)]\n red: u8,\n #[pyo3(get, set)]\n green: u8,\n #[pyo3(get, set)]\n blue: u8,\n #[pyo3(get, set)]\n alpha: u8,\n}\n\n#[gen_stub_pyclass]\n#[pyclass]\n#[derive(FromPyObject)]\nstruct RgbColor {\n #[pyo3(get, set)]\n red: u8,\n #[pyo3(get, set)]\n green: u8,\n #[pyo3(get, set)]\n blue: u8,\n}\n\n#[derive(FromPyObject)]\n#[pyclass]\nenum PyColorInput {\n ColorStr(String),\n // This variant must come before RgbColor\n RgbaColor {\n #[pyo3(item)]\n red: u8,\n #[pyo3(item)]\n green: u8,\n #[pyo3(item)]\n blue: u8,\n #[pyo3(item)]\n alpha: u8,\n },\n RgbColor {\n #[pyo3(item)]\n red: u8,\n #[pyo3(item)]\n green: u8,\n #[pyo3(item)]\n blue: u8,\n },\n}\n\nimpl_stub_type!(PyColorInput = String | RgbaColor | RgbColor);\n\n/// A Color object represents a color in the RGB color space with an alpha. Each color channel and the alpha is represented\n/// as an 8-bit integer. The alpha channel is 0 for fully transparent and 255 for fully opaque.\n///\n/// Construct colors from a CSS color string, or by specifying the red, green, blue, and (optional) alpha channels in a dict.\n#[gen_stub_pyclass]\n#[pyclass(name = \"Color\", from_py_object)]\n#[derive(Clone)]\npub struct PyColor {\n pub color: slint_interpreter::Color,\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl PyColor {\n #[new]\n #[pyo3(signature = (maybe_value=None))]\n fn py_new(maybe_value: Option) -> PyResult {\n let Some(value) = maybe_value else {\n return Ok(Self { color: Default::default() });\n };\n\n match value {\n PyColorInput::ColorStr(color_str) => color_str\n .parse::()\n .map(|c| Self {\n color: slint_interpreter::Color::from_argb_u8(\n (c.a * 255.) as u8,\n c.r,\n c.g,\n c.b,\n ),\n })\n .map_err(|color_err| PyColorParseError(color_err).into()),\n PyColorInput::RgbaColor { red, green, blue, alpha } => {\n Ok(Self { color: slint_interpreter::Color::from_argb_u8(alpha, red, green, blue) })\n }\n PyColorInput::RgbColor { red, green, blue } => {\n Ok(Self { color: slint_interpreter::Color::from_rgb_u8(red, green, blue) })\n }\n }\n }\n\n /// The red channel.\n #[getter]\n fn red(&self) -> u8 {\n self.color.red()\n }\n\n /// The green channel.\n #[getter]\n fn green(&self) -> u8 {\n self.color.green()\n }\n\n /// The blue channel.\n #[getter]\n fn blue(&self) -> u8 {\n self.color.blue()\n }\n\n /// The alpha channel.\n #[getter]\n fn alpha(&self) -> u8 {\n self.color.alpha()\n }\n\n /// Returns a new color that is brighter than this color by the given factor.\n fn brighter(&self, factor: f32) -> Self {\n Self { color: self.color.brighter(factor) }\n }\n\n /// Returns a new color that is darker than this color by the given factor.\n fn darker(&self, factor: f32) -> Self {\n Self { color: self.color.darker(factor) }\n }\n\n /// Returns a new version of this color with the opacity decreased by `factor`.\n ///\n /// The transparency is obtained by multiplying the alpha channel by `(1 - factor)`.\n fn transparentize(&self, factor: f32) -> Self {\n Self { color: self.color.transparentize(factor) }\n }\n\n /// Returns a new color that is a mix of this color and `other`. The specified factor is\n /// clamped to be between `0.0` and `1.0` and then applied to this color, while `1.0 - factor`\n /// is applied to `other`.\n fn mix(&self, other: &Self, factor: f32) -> Self {\n Self { color: self.color.mix(&other.color, factor) }\n }\n\n /// Returns a new version of this color with the opacity set to `alpha`.\n fn with_alpha(&self, alpha: f32) -> Self {\n Self { color: self.color.with_alpha(alpha) }\n }\n\n fn __str__(&self) -> String {\n self.color.to_string()\n }\n\n fn __eq__(&self, other: &Self) -> bool {\n self.color == other.color\n }\n}\n\nimpl From for PyColor {\n fn from(color: slint_interpreter::Color) -> Self {\n Self { color }\n }\n}\n\n#[derive(FromPyObject)]\n#[pyclass]\nenum PyBrushInput {\n SolidColor(PyColor),\n}\n\nimpl_stub_type!(PyBrushInput = PyColor);\n\n/// A brush is a data structure that is used to describe how a shape, such as a rectangle, path or even text,\n/// shall be filled. A brush can also be applied to the outline of a shape, that means the fill of the outline itself.\n///\n/// Brushes can only be constructed from solid colors.\n///\n/// **Note:** In future, we plan to reduce this constraint and allow for declaring graidient brushes programmatically.\n#[gen_stub_pyclass]\n#[pyclass(name = \"Brush\")]\npub struct PyBrush {\n pub brush: slint_interpreter::Brush,\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl PyBrush {\n #[new]\n #[pyo3(signature = (maybe_value=None))]\n fn py_new(maybe_value: Option) -> PyResult {\n let Some(value) = maybe_value else {\n return Ok(Self { brush: Default::default() });\n };\n\n match value {\n PyBrushInput::SolidColor(pycol) => Ok(Self { brush: pycol.color.into() }),\n }\n }\n\n /// The brush's color.\n #[getter]\n fn color(&self) -> PyColor {\n self.brush.color().into()\n }\n\n /// Returns true if this brush contains a fully transparent color (alpha value is zero).\n fn is_transparent(&self) -> bool {\n self.brush.is_transparent()\n }\n\n /// Returns true if this brush is fully opaque.\n fn is_opaque(&self) -> bool {\n self.brush.is_opaque()\n }\n\n /// Returns a new version of this brush that has the brightness increased\n /// by the specified factor. This is done by calling `Color.brighter` on\n /// all the colors of this brush.\n fn brighter(&self, factor: f32) -> Self {\n Self { brush: self.brush.brighter(factor) }\n }\n\n /// Returns a new version of this brush that has the brightness decreased\n /// by the specified factor. This is done by calling `Color.darker` on\n /// all the color of this brush.\n fn darker(&self, factor: f32) -> Self {\n Self { brush: self.brush.darker(factor) }\n }\n\n /// Returns a new version of this brush with the opacity decreased by `factor`.\n ///\n /// The transparency is obtained by multiplying the alpha channel by `(1 - factor)`.\n ///\n /// See also `Color.transparentize`.\n fn transparentize(&self, amount: f32) -> Self {\n Self { brush: self.brush.transparentize(amount) }\n }\n\n /// Returns a new version of this brush with the related color's opacities\n /// set to `alpha`.\n fn with_alpha(&self, alpha: f32) -> Self {\n Self { brush: self.brush.with_alpha(alpha) }\n }\n\n fn __eq__(&self, other: &Self) -> bool {\n self.brush == other.brush\n }\n}\n\nimpl From for PyBrush {\n fn from(brush: slint_interpreter::Brush) -> Self {\n Self { brush }\n }\n}\n" }, { "path": "api/python/slint/build.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse std::fs::File;\nuse std::io::{BufWriter, Write};\n\nfn map_type(ty: &str) -> &str {\n match ty {\n \"bool\" => \"bool\",\n \"SharedString\" => \"str\",\n \"i32\" => \"int\",\n \"f32\" | \"Coord\" => \"float\",\n _ => \"typing.Any\",\n }\n}\n\nfn map_default(ty: &str) -> &str {\n match ty {\n \"bool\" => \"False\",\n \"SharedString\" => \"\\\"\\\"\",\n \"i32\" => \"0\",\n \"f32\" | \"Coord\" => \"0.0\",\n _ => \"None\",\n }\n}\n\nmacro_rules! generate_builtin_structs_pyi {\n ($(\n $(#[doc = $struct_doc:literal])*\n $(#[non_exhaustive])?\n $(#[derive(Copy, Eq)])?\n struct $Name:ident {\n @name = $NameTy:ident :: $Variant:ident,\n export {\n $( $(#[doc = $pub_doc:literal])* $pub_field:ident : $pub_type:ident, )*\n }\n private {\n $($private:tt)*\n }\n }\n )*) => {\n fn generate_pyi(writer: &mut impl Write) {\n // REUSE-IgnoreStart\n writeln!(writer, \"# Copyright © SixtyFPS GmbH \").unwrap();\n writeln!(writer, \"# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\").unwrap();\n // REUSE-IgnoreEnd\n writeln!(writer, \"\").unwrap();\n writeln!(writer, \"import typing\").unwrap();\n\n $(\n generate_builtin_structs_pyi!(@check writer, $NameTy, $Name,\n [$($struct_doc),*],\n [$([$($pub_doc),*] $pub_field : $pub_type),*]\n );\n )*\n }\n };\n (@check $writer:expr, BuiltinPublicStruct, $Name:ident,\n [$($struct_doc:literal),*],\n [$([$($pub_doc:literal),*] $pub_field:ident : $pub_type:ident),*]\n ) => {\n writeln!($writer, \"\\nclass {}(typing.NamedTuple):\", stringify!($Name)).unwrap();\n let struct_doc = vec![$($struct_doc),*].join(\"\\n\").trim().to_string();\n if !struct_doc.is_empty() {\n writeln!($writer, \" \\\"\\\"\\\"\").unwrap();\n for line in struct_doc.lines() {\n if line.is_empty() {\n writeln!($writer).unwrap();\n } else {\n writeln!($writer, \" {}\", line).unwrap();\n }\n }\n writeln!($writer, \" \\\"\\\"\\\"\").unwrap();\n }\n writeln!($writer, \"\").unwrap();\n $(\n writeln!($writer, \" {}: {} = {}\", stringify!($pub_field), map_type(stringify!($pub_type)), map_default(stringify!($pub_type))).unwrap();\n let field_doc = vec![$($pub_doc),*].join(\"\\n\").trim().to_string();\n if !field_doc.is_empty() {\n writeln!($writer, \" \\\"\\\"\\\"\").unwrap();\n for line in field_doc.lines() {\n if line.is_empty() {\n writeln!($writer).unwrap();\n } else {\n writeln!($writer, \" {}\", line).unwrap();\n }\n }\n writeln!($writer, \" \\\"\\\"\\\"\").unwrap();\n }\n )*\n };\n (@check $writer:expr, BuiltinPrivateStruct, $Name:ident,\n [$($struct_doc:literal),*],\n [$([$($pub_doc:literal),*] $pub_field:ident : $pub_type:ident),*]\n ) => {};\n}\n\ni_slint_common::for_each_builtin_structs!(generate_builtin_structs_pyi);\n\nfn main() {\n let pyi_path = std::path::Path::new(\"slint/language.pyi\");\n if let Some(parent) = pyi_path.parent() {\n std::fs::create_dir_all(parent).expect(\"Failed to create slint/ directory\");\n }\n let file = File::create(pyi_path).expect(\"Failed to create language.pyi\");\n let mut writer = BufWriter::new(file);\n generate_pyi(&mut writer);\n}\n" }, { "path": "api/python/slint/build_docs.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport slint\nimport pdoc\nimport pathlib\nimport subprocess\nimport typing\n\n\ndoc = pdoc.doc.Module(slint)\n\nmodel_cls = typing.cast(pdoc.doc.Class, doc.get(\"Model\"))\nassert model_cls is not None\nfor method in model_cls.inherited_members[(\"builtins\", \"PyModelBase\")]:\n method.is_inherited = False\n if not method.name.startswith(\"_\") and method.name != \"init_self\":\n model_cls.own_members.append(method)\n\nall_modules: dict[str, pdoc.doc.Module] = {}\n\n\ndef add_modules(m: pdoc.doc.Module):\n all_modules[m.fullname] = m\n for submod in m.submodules:\n add_modules(submod)\n\n\nadd_modules(doc)\n\noutput_directory = pathlib.Path(\"docs\")\n\nfor module in all_modules.values():\n out = pdoc.render.html_module(module, all_modules)\n outfile = output_directory / f\"{module.fullname.replace('.', '/')}.html\"\n outfile.parent.mkdir(parents=True, exist_ok=True)\n outfile.write_bytes(out.encode())\n\nindex = pdoc.render.html_index(all_modules)\n(output_directory / \"index.html\").write_bytes(index.encode())\n\nsearch = pdoc.render.search_index(all_modules)\n(output_directory / \"search.js\").write_bytes(search.encode())\n\nsubprocess.call(\n \"cargo about generate thirdparty.hbs -o docs/thirdparty.html\", shell=True\n)\n" }, { "path": "api/python/slint/errors.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse pyo3::PyErr;\n\npub struct PyGetPropertyError(pub slint_interpreter::GetPropertyError);\n\nimpl From for PyErr {\n fn from(err: PyGetPropertyError) -> Self {\n pyo3::exceptions::PyValueError::new_err(err.0.to_string())\n }\n}\n\nimpl From for PyGetPropertyError {\n fn from(err: slint_interpreter::GetPropertyError) -> Self {\n Self(err)\n }\n}\n\npub struct PySetPropertyError(pub slint_interpreter::SetPropertyError);\n\nimpl From for PyErr {\n fn from(err: PySetPropertyError) -> Self {\n pyo3::exceptions::PyValueError::new_err(err.0.to_string())\n }\n}\n\nimpl From for PySetPropertyError {\n fn from(err: slint_interpreter::SetPropertyError) -> Self {\n Self(err)\n }\n}\n\npub struct PyPlatformError(pub slint_interpreter::PlatformError);\n\nimpl From for PyErr {\n fn from(err: PyPlatformError) -> Self {\n pyo3::exceptions::PyRuntimeError::new_err(err.0.to_string())\n }\n}\n\nimpl From for PyPlatformError {\n fn from(err: slint_interpreter::PlatformError) -> Self {\n Self(err)\n }\n}\n\npub struct PyEventLoopError(pub slint_interpreter::EventLoopError);\n\nimpl From for PyErr {\n fn from(err: PyEventLoopError) -> Self {\n pyo3::exceptions::PyRuntimeError::new_err(err.0.to_string())\n }\n}\n\nimpl From for PyEventLoopError {\n fn from(err: slint_interpreter::EventLoopError) -> Self {\n Self(err)\n }\n}\n\npub struct PyInvokeError(pub slint_interpreter::InvokeError);\n\nimpl From for PyErr {\n fn from(err: PyInvokeError) -> Self {\n pyo3::exceptions::PyRuntimeError::new_err(err.0.to_string())\n }\n}\n\nimpl From for PyInvokeError {\n fn from(err: slint_interpreter::InvokeError) -> Self {\n Self(err)\n }\n}\n\npub struct PySetCallbackError(pub slint_interpreter::SetCallbackError);\n\nimpl From for PyErr {\n fn from(err: PySetCallbackError) -> Self {\n pyo3::exceptions::PyRuntimeError::new_err(err.0.to_string())\n }\n}\n\nimpl From for PySetCallbackError {\n fn from(err: slint_interpreter::SetCallbackError) -> Self {\n Self(err)\n }\n}\n\npub struct PyLoadImageError(pub slint_interpreter::LoadImageError);\n\nimpl From for PyErr {\n fn from(err: PyLoadImageError) -> Self {\n pyo3::exceptions::PyRuntimeError::new_err(err.0.to_string())\n }\n}\n\nimpl From for PyLoadImageError {\n fn from(err: slint_interpreter::LoadImageError) -> Self {\n Self(err)\n }\n}\n\npub struct PyColorParseError(pub css_color_parser2::ColorParseError);\n\nimpl From for PyErr {\n fn from(err: PyColorParseError) -> Self {\n pyo3::exceptions::PyRuntimeError::new_err(err.0.to_string())\n }\n}\n\nimpl From for PyColorParseError {\n fn from(err: css_color_parser2::ColorParseError) -> Self {\n Self(err)\n }\n}\n" }, { "path": "api/python/slint/image.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse pyo3::prelude::*;\nuse pyo3_stub_gen::{derive::gen_stub_pyclass, derive::gen_stub_pymethods};\nuse slint_interpreter::SharedPixelBuffer;\n\n/// Image objects can be set on Slint Image elements for display. Use `Image.load_from_path` to construct Image\n/// objects from a path to an image file on disk.\n#[gen_stub_pyclass]\n#[pyclass(unsendable, name = \"Image\")]\npub struct PyImage {\n pub image: slint_interpreter::Image,\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl PyImage {\n #[new]\n fn py_new() -> PyResult {\n Ok(Self { image: Default::default() })\n }\n\n /// The size of the image as tuple of `width` and `height`.\n #[getter]\n fn size(&self) -> PyResult<(u32, u32)> {\n Ok(self.image.size().into())\n }\n\n /// The width of the image in pixels.\n #[getter]\n fn width(&self) -> PyResult {\n Ok(self.image.size().width)\n }\n\n /// The height of the image in pixels.\n #[getter]\n fn height(&self) -> PyResult {\n Ok(self.image.size().height)\n }\n\n /// The path of the image if it was loaded from disk, or None.\n #[getter]\n fn path(&self) -> PyResult> {\n Ok(self.image.path().map(|p| p.to_path_buf()))\n }\n\n /// Loads the image from the specified path. Returns None if the image can't be loaded.\n #[staticmethod]\n fn load_from_path(path: std::path::PathBuf) -> Result {\n let image = slint_interpreter::Image::load_from_path(&path)?;\n Ok(Self { image })\n }\n\n /// Creates a new image from a string that describes the image in SVG format.\n #[staticmethod]\n fn load_from_svg_data(data: Vec) -> Result {\n let image = slint_interpreter::Image::load_from_svg_data(&data)?;\n Ok(Self { image })\n }\n\n /// Creates a new image from an array-like object that implements the [Buffer Protocol](https://docs.python.org/3/c-api/buffer.html).\n /// Use this function to import images created by third-party modules such as matplotlib or Pillow.\n ///\n /// The array must satisfy certain contraints to represent an image:\n ///\n /// - The buffer's format needs to be `B` (unsigned char)\n /// - The shape must be a tuple of (height, width, bytes-per-pixel)\n /// - If a stride is defined, the row stride must be equal to width * bytes-per-pixel, and the column stride must equal the bytes-per-pixel.\n /// - A value of 3 for bytes-per-pixel is interpreted as RGB image, a value of 4 means RGBA.\n ///\n /// The image is created by performing a deep copy of the array's data. Subsequent changes to the buffer are not automatically\n /// reflected in a previously created Image.\n ///\n /// Example of importing a matplot figure into an image:\n /// ```python\n /// import slint\n /// import matplotlib\n ///\n /// from matplotlib.backends.backend_agg import FigureCanvasAgg\n /// from matplotlib.figure import Figure\n ///\n /// fig = Figure(figsize=(5, 4), dpi=100)\n /// canvas = FigureCanvasAgg(fig)\n /// ax = fig.add_subplot()\n /// ax.plot([1, 2, 3])\n /// canvas.draw()\n ///\n /// buffer = canvas.buffer_rgba()\n /// img = slint.Image.load_from_array(buffer)\n /// ```\n ///\n /// Example of loading an image with Pillow:\n /// ```python\n /// import slint\n /// from PIL import Image\n /// import numpy as np\n ///\n /// pil_img = Image.open(\"hello.jpeg\")\n /// array = np.array(pil_img)\n /// img = slint.Image.load_from_array(array)\n /// ```\n #[staticmethod]\n fn load_from_array(array: &Bound<'_, PyAny>) -> PyResult {\n let buffer: pyo3::buffer::PyBuffer = pyo3::buffer::PyBuffer::get(array)?;\n\n let shape = buffer.shape();\n if shape.len() != 3 {\n return Err(pyo3::exceptions::PyRuntimeError::new_err(\n \"Arrays must have a shape of (height, width, bpp) for image conversion\",\n ));\n }\n let bpp: u32 = shape[2]\n .try_into()\n .map_err(|_| pyo3::exceptions::PyRuntimeError::new_err(\"Image bpp exceeds u32\"))?;\n let width = shape[1]\n .try_into()\n .map_err(|_| pyo3::exceptions::PyRuntimeError::new_err(\"Image width exceeds u32\"))?;\n let height = shape[0]\n .try_into()\n .map_err(|_| pyo3::exceptions::PyRuntimeError::new_err(\"Image height exceeds u32\"))?;\n\n if buffer.item_size() != 1 {\n return Err(pyo3::exceptions::PyRuntimeError::new_err(format!(\n \"Item size {} is not valid. Arrays must contain bytes for image conversion\",\n buffer.item_size(),\n )));\n }\n\n if buffer.format() != c\"B\" {\n return Err(pyo3::exceptions::PyRuntimeError::new_err(format!(\n \"Unexpected buffer format {}, expected 'B' for unsigned char\",\n buffer.format().to_str().unwrap_or_default(),\n )));\n }\n\n let strides = buffer.strides();\n if strides.len() > 0 {\n if strides.len() != 3 {\n return Err(pyo3::exceptions::PyRuntimeError::new_err(format!(\n \"Unexpected strides size {}. Arrays must provides stride tuple of 3 for image conversion\",\n strides.len(),\n )));\n }\n\n let row_stride: u32 = strides[0].try_into().map_err(|_| {\n pyo3::exceptions::PyRuntimeError::new_err(\"Image row stride cannot be negative\")\n })?;\n let column_stride: u32 = strides[1].try_into().map_err(|_| {\n pyo3::exceptions::PyRuntimeError::new_err(\"Image column stride cannot be negative\")\n })?;\n let elem_stride: u32 = strides[2].try_into().map_err(|_| {\n pyo3::exceptions::PyRuntimeError::new_err(\"Image element stride cannot be negative\")\n })?;\n\n if row_stride != width * bpp {\n return Err(pyo3::exceptions::PyRuntimeError::new_err(format!(\n \"Unexpected row stride {}. Expected {}\",\n row_stride,\n height * bpp,\n )));\n }\n\n if column_stride != bpp {\n return Err(pyo3::exceptions::PyRuntimeError::new_err(format!(\n \"Unexpected column stride {}. Expected {}\",\n column_stride, bpp,\n )));\n }\n\n if elem_stride != 1 {\n return Err(pyo3::exceptions::PyRuntimeError::new_err(format!(\n \"Unexpected element stride {}. Expected 1\",\n column_stride,\n )));\n }\n }\n\n Ok(Self {\n image: match bpp {\n 3 => {\n let mut pixel_buffer = SharedPixelBuffer::new(width, height);\n buffer.copy_to_slice(array.py(), pixel_buffer.make_mut_bytes())?;\n slint_interpreter::Image::from_rgb8(pixel_buffer)\n }\n 4 => {\n let mut pixel_buffer = SharedPixelBuffer::new(width, height);\n buffer.copy_to_slice(array.py(), pixel_buffer.make_mut_bytes())?;\n slint_interpreter::Image::from_rgba8(pixel_buffer)\n }\n _ => {\n return Err(pyo3::exceptions::PyRuntimeError::new_err(format!(\n \"Unexpected bits per pixel {}. Expected 3 or 4\",\n bpp,\n )));\n }\n },\n })\n }\n}\n\nimpl From for PyImage {\n fn from(image: slint_interpreter::Image) -> Self {\n Self { image: image }\n }\n}\n" }, { "path": "api/python/slint/interpreter.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse std::cell::RefCell;\nuse std::collections::HashMap;\nuse std::path::PathBuf;\nuse std::rc::Rc;\n\nuse i_slint_compiler::generator::python::ident;\nuse pyo3::IntoPyObjectExt;\nuse pyo3_stub_gen::derive::{gen_stub_pyclass, gen_stub_pyclass_enum, gen_stub_pymethods};\nuse slint_interpreter::{ComponentHandle, Value};\n\nuse i_slint_compiler::langtype::Type;\nuse i_slint_compiler::parser::normalize_identifier;\n\nuse indexmap::IndexMap;\nuse pyo3::PyTraverseError;\nuse pyo3::gc::PyVisit;\nuse pyo3::prelude::*;\nuse pyo3::types::PyTuple;\n\nuse crate::api_match::PyGeneratedAPI;\nuse crate::errors::{\n PyGetPropertyError, PyInvokeError, PyPlatformError, PySetCallbackError, PySetPropertyError,\n};\nuse crate::value::{SlintToPyValue, TypeCollection};\n\n#[gen_stub_pyclass]\n#[pyclass(unsendable)]\npub struct Compiler {\n compiler: slint_interpreter::Compiler,\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl Compiler {\n #[new]\n fn py_new() -> PyResult {\n Ok(Self { compiler: Default::default() })\n }\n\n #[getter]\n fn get_include_paths(&self) -> PyResult> {\n Ok(self.compiler.include_paths().clone())\n }\n\n #[setter]\n fn set_include_paths(&mut self, paths: Vec) {\n self.compiler.set_include_paths(paths)\n }\n\n #[getter]\n fn get_style(&self) -> PyResult> {\n Ok(self.compiler.style().cloned())\n }\n\n #[setter]\n fn set_style(&mut self, style: String) {\n self.compiler.set_style(style)\n }\n\n #[getter]\n fn get_library_paths(&self) -> PyResult> {\n Ok(self.compiler.library_paths().clone())\n }\n\n #[setter]\n fn set_library_paths(&mut self, libraries: HashMap) {\n self.compiler.set_library_paths(libraries)\n }\n\n #[setter]\n fn set_translation_domain(&mut self, domain: String) {\n self.compiler.set_translation_domain(domain)\n }\n\n fn build_from_path(&mut self, py: Python<'_>, path: PathBuf) -> CompilationResult {\n let result = spin_on::spin_on(self.compiler.build_from_path(&path));\n CompilationResult::new(result, path, py)\n }\n\n fn build_from_source(\n &mut self,\n py: Python<'_>,\n source_code: String,\n path: PathBuf,\n ) -> CompilationResult {\n let result = spin_on::spin_on(self.compiler.build_from_source(source_code, path.clone()));\n CompilationResult::new(result, path, py)\n }\n}\n\n#[derive(Debug, Clone)]\n#[gen_stub_pyclass]\n#[pyclass(unsendable, from_py_object)]\npub struct PyDiagnostic(slint_interpreter::Diagnostic);\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl PyDiagnostic {\n #[getter]\n fn level(&self) -> PyDiagnosticLevel {\n match self.0.level() {\n slint_interpreter::DiagnosticLevel::Error => PyDiagnosticLevel::Error,\n slint_interpreter::DiagnosticLevel::Warning => PyDiagnosticLevel::Warning,\n slint_interpreter::DiagnosticLevel::Note => PyDiagnosticLevel::Note,\n _ => unimplemented!(),\n }\n }\n\n #[getter]\n fn message(&self) -> &str {\n self.0.message()\n }\n\n #[getter]\n fn column_number(&self) -> usize {\n self.0.line_column().1\n }\n\n #[getter]\n fn line_number(&self) -> usize {\n self.0.line_column().0\n }\n\n #[getter]\n fn source_file(&self) -> Option {\n self.0.source_file().map(|path| path.to_path_buf())\n }\n\n fn __str__(&self) -> String {\n self.0.to_string()\n }\n}\n\n#[gen_stub_pyclass_enum]\n#[pyclass(name = \"DiagnosticLevel\", eq, eq_int)]\n#[derive(PartialEq)]\npub enum PyDiagnosticLevel {\n Error,\n Warning,\n Note,\n}\n\n#[gen_stub_pyclass]\n#[pyclass(unsendable)]\npub struct CompilationResult {\n result: slint_interpreter::CompilationResult,\n type_collection: TypeCollection,\n path: PathBuf,\n}\n\nimpl CompilationResult {\n fn new(result: slint_interpreter::CompilationResult, path: PathBuf, py: Python<'_>) -> Self {\n let type_collection = TypeCollection::new(&result, py);\n Self { result, type_collection, path }\n }\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl CompilationResult {\n #[getter]\n fn component_names(&self) -> Vec {\n self.result.component_names().map(ToString::to_string).collect()\n }\n\n fn component(&self, name: &str) -> Option {\n self.result.component(name).map(|definition| ComponentDefinition {\n definition,\n type_collection: self.type_collection.clone(),\n })\n }\n\n #[getter]\n fn get_diagnostics(&self) -> Vec {\n self.result.diagnostics().map(|diag| PyDiagnostic(diag.clone())).collect()\n }\n\n #[getter]\n fn structs_and_enums<'py>(\n &self,\n py: Python<'py>,\n ) -> (HashMap>, HashMap>) {\n let mut structs = HashMap::new();\n\n for struct_or_enum in self.result.structs_and_enums(i_slint_core::InternalToken {}) {\n match struct_or_enum {\n Type::Struct(s) if s.node().is_some() => {\n let struct_instance =\n self.type_collection.struct_to_py(slint_interpreter::Struct::from_iter(\n s.fields.iter().map(|(name, field_type)| {\n (\n ident(&name).into(),\n slint_interpreter::default_value_for_type(field_type),\n )\n }),\n ));\n\n structs.insert(\n ident(&s.name.slint_name().unwrap()).into(),\n struct_instance.into_bound_py_any(py).unwrap(),\n );\n }\n _ => {}\n }\n }\n\n (\n structs,\n self.type_collection\n .enums()\n .map(|(name, enum_cls)| (name.clone(), enum_cls.into_bound_py_any(py).unwrap()))\n .collect(),\n )\n }\n\n #[getter]\n fn named_exports(&self) -> Vec<(String, String)> {\n self.result.named_exports(i_slint_core::InternalToken {}).cloned().collect::>()\n }\n\n #[getter]\n fn generated_api(&self) -> PyResult {\n let type_loader = self\n .result\n .components()\n .next()\n .ok_or_else(|| {\n pyo3::exceptions::PyRuntimeError::new_err(\n \"Cannot generated API for empty slint file\",\n )\n })?\n .type_loader();\n let doc = type_loader.get_document(&self.path).ok_or_else(|| {\n pyo3::exceptions::PyRuntimeError::new_err(\n \"Failed to load document from cache for API generation\",\n )\n })?;\n i_slint_compiler::generator::python::generate_py_module(\n doc,\n &i_slint_compiler::CompilerConfiguration::new(\n i_slint_compiler::generator::OutputFormat::Python,\n ),\n )\n .map_err(|e| {\n pyo3::exceptions::PyRuntimeError::new_err(format!(\"Error generating pymodule: {}\", e))\n })\n .map(|module| PyGeneratedAPI { path: self.path.clone(), module })\n }\n}\n\n#[gen_stub_pyclass]\n#[pyclass(unsendable)]\npub struct ComponentDefinition {\n definition: slint_interpreter::ComponentDefinition,\n type_collection: TypeCollection,\n}\n\n#[pymethods]\nimpl ComponentDefinition {\n #[getter]\n fn name(&self) -> &str {\n self.definition.name()\n }\n\n #[getter]\n fn properties(&self) -> IndexMap {\n self.definition\n .properties_and_callbacks()\n .filter_map(|(name, (ty, _))| ty.is_property_type().then(|| (name, ty.into())))\n .collect()\n }\n\n #[getter]\n fn callbacks(&self) -> Vec {\n self.definition.callbacks().collect()\n }\n\n #[getter]\n fn functions(&self) -> Vec {\n self.definition.functions().collect()\n }\n\n #[getter]\n fn globals(&self) -> Vec {\n self.definition.globals().collect()\n }\n\n fn global_properties(&self, name: &str) -> Option> {\n self.definition.global_properties_and_callbacks(name).map(|propiter| {\n propiter\n .filter_map(|(name, (ty, _))| ty.is_property_type().then(|| (name, ty.into())))\n .collect()\n })\n }\n\n fn global_callbacks(&self, name: &str) -> Option> {\n self.definition.global_callbacks(name).map(|callbackiter| callbackiter.collect())\n }\n\n fn global_functions(&self, name: &str) -> Option> {\n self.definition.global_functions(name).map(|functioniter| functioniter.collect())\n }\n\n fn callback_returns_void(&self, callback_name: &str) -> Option {\n let callback_name = normalize_identifier(callback_name);\n self.definition.properties_and_callbacks().find_map(|(name, (ty, _))| {\n if normalize_identifier(&name) == callback_name {\n if let Type::Callback(signature) = ty {\n return Some(signature.return_type == Type::Void);\n }\n }\n None\n })\n }\n\n fn global_callback_returns_void(&self, global_name: &str, callback_name: &str) -> Option {\n let global_name = normalize_identifier(global_name);\n let callback_name = normalize_identifier(callback_name);\n self.definition.global_properties_and_callbacks(&global_name).and_then(|mut props| {\n props.find_map(|(name, (ty, _))| {\n if normalize_identifier(&name) == callback_name {\n if let Type::Callback(signature) = ty {\n return Some(signature.return_type == Type::Void);\n }\n }\n None\n })\n })\n }\n\n fn create(&self) -> Result {\n Ok(ComponentInstance {\n instance: self.definition.create()?,\n callbacks: GcVisibleCallbacks {\n callables: Default::default(),\n type_collection: self.type_collection.clone(),\n },\n global_callbacks: Default::default(),\n type_collection: self.type_collection.clone(),\n })\n }\n}\n\n#[gen_stub_pyclass_enum]\n#[pyclass(name = \"ValueType\", eq, eq_int)]\n#[derive(PartialEq)]\npub enum PyValueType {\n Void,\n Number,\n String,\n Bool,\n Model,\n Struct,\n Brush,\n Image,\n Enumeration,\n}\n\nimpl From for PyValueType {\n fn from(ty: i_slint_compiler::langtype::Type) -> Self {\n use i_slint_compiler::langtype::Type;\n match ty {\n Type::Bool => PyValueType::Bool,\n Type::Void => PyValueType::Void,\n Type::Float32\n | Type::Int32\n | Type::Duration\n | Type::Angle\n | Type::PhysicalLength\n | Type::LogicalLength\n | Type::Percent\n | Type::Rem\n | Type::UnitProduct(_) => PyValueType::Number,\n Type::String => PyValueType::String,\n Type::Array(..) => PyValueType::Model,\n Type::Struct { .. } => PyValueType::Struct,\n Type::Brush => PyValueType::Brush,\n Type::Color => PyValueType::Brush,\n Type::Image => PyValueType::Image,\n Type::Enumeration(..) => PyValueType::Enumeration,\n Type::Keys => PyValueType::String,\n _ => unimplemented!(),\n }\n }\n}\n\n#[gen_stub_pyclass]\n#[pyclass(unsendable, weakref)]\npub struct ComponentInstance {\n instance: slint_interpreter::ComponentInstance,\n callbacks: GcVisibleCallbacks,\n global_callbacks: HashMap,\n type_collection: TypeCollection,\n}\n\n#[pymethods]\nimpl ComponentInstance {\n #[getter]\n fn definition(&self) -> ComponentDefinition {\n ComponentDefinition {\n definition: self.instance.definition(),\n type_collection: self.type_collection.clone(),\n }\n }\n\n fn get_property(&self, name: &str) -> Result {\n Ok(self.type_collection.to_py_value(self.instance.get_property(name)?))\n }\n\n fn set_property(&self, name: &str, value: Bound<'_, PyAny>) -> PyResult<()> {\n let pv =\n TypeCollection::slint_value_from_py_value_bound(&value, Some(&self.type_collection))?;\n Ok(self.instance.set_property(name, pv).map_err(|e| PySetPropertyError(e))?)\n }\n\n fn get_global_property(\n &self,\n global_name: &str,\n prop_name: &str,\n ) -> Result {\n Ok(self\n .type_collection\n .to_py_value(self.instance.get_global_property(global_name, prop_name)?))\n }\n\n fn set_global_property(\n &self,\n global_name: &str,\n prop_name: &str,\n value: Bound<'_, PyAny>,\n ) -> PyResult<()> {\n let pv =\n TypeCollection::slint_value_from_py_value_bound(&value, Some(&self.type_collection))?;\n Ok(self\n .instance\n .set_global_property(global_name, prop_name, pv)\n .map_err(|e| PySetPropertyError(e))?)\n }\n\n #[pyo3(signature = (callback_name, *args))]\n fn invoke(&self, callback_name: &str, args: Bound<'_, PyTuple>) -> PyResult {\n let mut rust_args = Vec::new();\n for arg in args.iter() {\n let pv =\n TypeCollection::slint_value_from_py_value_bound(&arg, Some(&self.type_collection))?;\n rust_args.push(pv)\n }\n Ok(self.type_collection.to_py_value(\n self.instance.invoke(callback_name, &rust_args).map_err(|e| PyInvokeError(e))?,\n ))\n }\n\n #[pyo3(signature = (global_name, callback_name, *args))]\n fn invoke_global(\n &self,\n global_name: &str,\n callback_name: &str,\n args: Bound<'_, PyTuple>,\n ) -> PyResult {\n let mut rust_args = Vec::new();\n for arg in args.iter() {\n let pv =\n TypeCollection::slint_value_from_py_value_bound(&arg, Some(&self.type_collection))?;\n rust_args.push(pv)\n }\n Ok(self.type_collection.to_py_value(\n self.instance\n .invoke_global(global_name, callback_name, &rust_args)\n .map_err(|e| PyInvokeError(e))?,\n ))\n }\n\n fn set_callback(&self, name: &str, callable: Py) -> Result<(), PySetCallbackError> {\n let rust_cb = self.callbacks.register(name.to_string(), callable);\n Ok(self.instance.set_callback(name, rust_cb)?.into())\n }\n\n fn set_global_callback(\n &mut self,\n global_name: &str,\n callback_name: &str,\n callable: Py,\n ) -> Result<(), PySetCallbackError> {\n let rust_cb = self\n .global_callbacks\n .entry(global_name.to_string())\n .or_insert_with(|| GcVisibleCallbacks {\n callables: Default::default(),\n type_collection: self.type_collection.clone(),\n })\n .register(callback_name.to_string(), callable);\n Ok(self.instance.set_global_callback(global_name, callback_name, rust_cb)?.into())\n }\n\n fn show(&self) -> Result<(), PyPlatformError> {\n Ok(self.instance.show()?)\n }\n\n fn hide(&self) -> Result<(), PyPlatformError> {\n Ok(self.instance.hide()?)\n }\n\n fn __traverse__(&self, visit: PyVisit<'_>) -> Result<(), PyTraverseError> {\n self.callbacks.__traverse__(&visit)?;\n for global_callbacks in self.global_callbacks.values() {\n global_callbacks.__traverse__(&visit)?;\n }\n\n for value in self.properties_for_gc() {\n crate::value::traverse_value(&value, &visit)?;\n }\n\n Ok(())\n }\n\n fn __clear__(&mut self) {\n self.callbacks.__clear__();\n self.global_callbacks.clear();\n\n for value in self.properties_for_gc() {\n crate::value::clear_strongrefs_in_value(&value)\n }\n }\n}\n\nimpl ComponentInstance {\n fn properties_for_gc(&self) -> Vec {\n let mut props = Vec::new();\n\n props.extend(\n self.instance\n .definition()\n .properties_and_callbacks()\n .filter_map(|(name, (ty, _))| ty.is_property_type().then(|| name))\n .filter_map(|prop_name| self.instance.get_property(&prop_name).ok()),\n );\n\n for global_name in self.instance.definition().globals() {\n if let Some(prop_iter) =\n self.instance.definition().global_properties_and_callbacks(&global_name)\n {\n props.extend(\n prop_iter\n .filter_map(|(name, (ty, _))| ty.is_property_type().then(|| name))\n .filter_map(|prop_name| {\n self.instance.get_global_property(&global_name, &prop_name).ok()\n }),\n );\n }\n }\n\n props\n }\n}\n\nstruct GcVisibleCallbacks {\n callables: Rc>>>,\n type_collection: TypeCollection,\n}\n\nimpl GcVisibleCallbacks {\n fn register(&self, name: String, callable: Py) -> impl Fn(&[Value]) -> Value + 'static {\n self.callables.borrow_mut().insert(name.clone(), callable);\n\n let callables = self.callables.clone();\n let type_collection = self.type_collection.clone();\n\n move |args| {\n let callables = callables.borrow();\n let callable = callables.get(&name).unwrap();\n Python::attach(|py| {\n let py_args =\n PyTuple::new(py, args.iter().map(|v| type_collection.to_py_value(v.clone())))\n .unwrap();\n let result = match callable.call(py, py_args, None) {\n Ok(result) => result,\n Err(err) => {\n crate::handle_unraisable(\n py,\n format!(\n \"Python: Invoking python callback for {name} threw an exception\"\n ),\n err,\n );\n return Value::Void;\n }\n };\n\n let pv = match TypeCollection::slint_value_from_py_value(\n py,\n &result,\n Some(&type_collection),\n ) {\n Ok(value) => value,\n Err(err) => {\n crate::handle_unraisable(\n py,\n format!(\n \"Python: Unable to convert return value of Python callback for {name} to Slint value\"\n ),\n err,\n );\n return Value::Void;\n }\n };\n pv\n })\n }\n }\n\n fn __traverse__(&self, visit: &PyVisit<'_>) -> Result<(), PyTraverseError> {\n for callback in self.callables.borrow().values() {\n visit.call(callback)?;\n }\n Ok(())\n }\n\n fn __clear__(&mut self) {\n self.callables.borrow_mut().clear();\n }\n}\n" }, { "path": "api/python/slint/language.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n//! This module generates Python `typing.NamedTuple` bindings for public Slint\n//! structs using the `for_each_builtin_structs` macro, reusing documentation\n//! from `builtin_structs.rs`.\n//!\n//! The pattern follows `cbindgen.rs`: a macro consumes `for_each_builtin_structs`,\n//! matches on `BuiltinPublicStruct` variants, and generates NamedTuple classes\n//! with the original doc comments. Private structs are skipped.\n\nuse pyo3::IntoPyObjectExt;\nuse pyo3::prelude::*;\nuse pyo3::types::{PyDict, PyTuple};\n\nfn get_default_value<'py>(py: Python<'py>, ty: &str) -> PyResult> {\n match ty {\n \"bool\" => false.into_bound_py_any(py),\n \"SharedString\" => \"\".into_bound_py_any(py),\n \"i32\" => 0_i32.into_bound_py_any(py),\n \"f32\" | \"Coord\" => 0.0_f32.into_bound_py_any(py),\n _ => Ok(py.None().into_bound(py)),\n }\n}\n\n/// Dynamically creates a Python `typing.NamedTuple` class and registers it\n/// in the `slint.language` submodule.\nfn register_named_tuple(\n py: Python<'_>,\n m: &Bound<'_, PyModule>,\n class_name: &str,\n class_doc: &str,\n fields: &[(&str, &str, String)], // name, rust_type, doc\n) -> PyResult<()> {\n let collections = py.import(\"collections\")?;\n let namedtuple = collections.getattr(\"namedtuple\")?;\n\n let mut field_names = Vec::new();\n let mut defaults = Vec::new();\n let mut full_doc = class_doc.to_string();\n\n for (name, rust_ty, doc) in fields {\n field_names.push(*name);\n defaults.push(get_default_value(py, rust_ty)?);\n if !doc.is_empty() {\n use std::fmt::Write;\n let _ = write!(full_doc, \"\\n\\n:param {name}: {doc}\");\n }\n }\n\n let kwargs = PyDict::new(py);\n kwargs.set_item(\"defaults\", PyTuple::new(py, defaults)?)?;\n kwargs.set_item(\"module\", \"slint.language\")?;\n\n let class = namedtuple.call((class_name, field_names), Some(&kwargs))?;\n class.setattr(\"__doc__\", full_doc)?;\n\n // Register the class in the \"slint.language\" submodule.\n // The submodule is created lazily on the first call and reused for subsequent structs.\n let language_mod = match m.getattr(\"language\") {\n Ok(existing) => existing.cast_into::()?,\n Err(_) => {\n let sub = PyModule::new(py, \"slint.language\")?;\n m.add(\"language\", &sub)?;\n // Register in sys.modules so \"from slint.language import ...\" works\n let sys = py.import(\"sys\")?;\n let modules = sys.getattr(\"modules\")?;\n modules.set_item(\"slint.language\", &sub)?;\n sub\n }\n };\n\n language_mod.add(class_name, class)?;\n Ok(())\n}\n\n/// This macro processes `for_each_builtin_structs` and generates a single `register_all`\n/// function that registers all public structs as NamedTuples in the `slint.language` submodule.\nmacro_rules! declare_python_public_structs {\n // Top-level arm: matches the full list of struct definitions emitted by\n // `for_each_builtin_structs!`. For each struct, it delegates to the\n // `@register` arm which decides whether to register or skip it based\n // on whether it's a BuiltinPublicStruct or BuiltinPrivateStruct.\n ($(\n $(#[doc = $struct_doc:literal])*\n $(#[non_exhaustive])?\n $(#[derive(Copy, Eq)])?\n struct $Name:ident {\n @name = $NameTy:ident :: $NameVariant:ident,\n export {\n $( $(#[doc = $pub_doc:literal])* $pub_field:ident : $pub_type:ident, )*\n }\n private {\n $( $(#[doc = $pri_doc:literal])* $pri_field:ident : $pri_type:ty, )*\n }\n }\n )*) => {\n /// Registers all public builtin structs as NamedTuples in `slint.language`.\n /// Called once during module initialization from `lib.rs`.\n pub fn register_all(py: Python<'_>, m: &Bound<'_, PyModule>) -> PyResult<()> {\n $(\n declare_python_public_structs!(@register $NameTy, $Name, py, m;\n docs: [$(#[doc = $struct_doc])*],\n fields: [$( $(#[doc = $pub_doc])* $pub_field : $pub_type ,)*],\n );\n )*\n Ok(())\n }\n };\n\n // Public struct arm: collects doc comments and field metadata, then calls\n // `register_named_tuple` to create and register the NamedTuple class.\n (@register BuiltinPublicStruct, $Name:ident, $py:ident, $m:ident;\n docs: [$(#[doc = $struct_doc:literal])*],\n fields: [$( $(#[doc = $field_doc:literal])* $pub_field:ident : $pub_type:ident ,)*],\n ) => {\n {\n let class_doc = [ $($struct_doc),* ].join(\"\\n\");\n let fields = vec![\n $(\n (stringify!($pub_field), stringify!($pub_type), [ $($field_doc),* ].join(\"\\n\")),\n )*\n ];\n register_named_tuple($py, $m, stringify!($Name), &class_doc, &fields)?;\n }\n };\n\n // Private struct arm: intentionally empty — private structs are not exposed to Python.\n (@register BuiltinPrivateStruct, $_Name:ident, $py:ident, $m:ident;\n docs: [$(#[$struct_meta:meta])*],\n fields: [$( $(#[$field_meta:meta])* $pub_field:ident : $pub_type:ty ,)*],\n ) => {};\n}\n\ni_slint_common::for_each_builtin_structs!(declare_python_public_structs);\n" }, { "path": "api/python/slint/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse std::cell::{Cell, RefCell};\n\nuse pyo3_stub_gen::{define_stub_info_gatherer, derive::gen_stub_pyfunction};\n\nmod image;\nmod interpreter;\nmod language;\nuse interpreter::{\n CompilationResult, Compiler, ComponentDefinition, ComponentInstance, PyDiagnostic,\n PyDiagnosticLevel, PyValueType,\n};\nmod api_match;\nmod async_adapter;\nmod brush;\nmod errors;\nmod models;\nmod timer;\nmod value;\nuse i_slint_core::translations::Translator;\n\nfn handle_unraisable(py: Python<'_>, context: String, err: PyErr) {\n let exception = err.value(py);\n let __notes__ = exception\n .getattr(pyo3::intern!(py, \"__notes__\"))\n .unwrap_or_else(|_| pyo3::types::PyList::empty(py).into_any());\n if let Ok(notes_list) = __notes__.cast::() {\n let _ = notes_list.append(context);\n let _ = exception.setattr(pyo3::intern!(py, \"__notes__\"), __notes__);\n }\n\n if EVENT_LOOP_RUNNING.get() && err.is_instance_of::(py) {\n EVENT_LOOP_EXCEPTION.replace(Some(err));\n let _ = slint_interpreter::quit_event_loop();\n } else {\n err.write_unraisable(py, None);\n }\n}\n\nthread_local! {\n static EVENT_LOOP_RUNNING: Cell = Cell::new(false);\n static EVENT_LOOP_EXCEPTION: RefCell> = RefCell::new(None)\n}\n\n#[gen_stub_pyfunction]\n#[pyfunction]\nfn run_event_loop(py: Python<'_>) -> Result<(), PyErr> {\n EVENT_LOOP_EXCEPTION.replace(None);\n EVENT_LOOP_RUNNING.set(true);\n // Release the GIL while running the event loop, so that other Python threads can run.\n let result = py.detach(|| slint_interpreter::run_event_loop());\n EVENT_LOOP_RUNNING.set(false);\n result.map_err(|e| errors::PyPlatformError::from(e))?;\n EVENT_LOOP_EXCEPTION.take().map_or(Ok(()), |err| Err(err))\n}\n\n#[gen_stub_pyfunction]\n#[pyfunction]\nfn quit_event_loop() -> Result<(), errors::PyEventLoopError> {\n slint_interpreter::quit_event_loop().map_err(|e| e.into())\n}\n\n#[gen_stub_pyfunction]\n#[pyfunction]\nfn set_xdg_app_id(app_id: String) -> Result<(), errors::PyPlatformError> {\n slint_interpreter::set_xdg_app_id(app_id).map_err(|e| e.into())\n}\n\n#[gen_stub_pyfunction]\n#[pyfunction]\nfn invoke_from_event_loop(callable: Py) -> Result<(), errors::PyEventLoopError> {\n slint_interpreter::invoke_from_event_loop(move || {\n Python::attach(|py| {\n if let Err(err) = callable.call0(py) {\n eprintln!(\"Error invoking python callable from closure invoked via slint::invoke_from_event_loop: {}\", err)\n }\n })\n })\n .map_err(|e| e.into())\n}\n\n#[gen_stub_pyfunction]\n#[pyfunction]\nfn init_translations(_py: Python<'_>, translations: Bound) -> PyResult<()> {\n i_slint_backend_selector::with_global_context(|ctx| {\n ctx.set_external_translator(if translations.is_none() {\n None\n } else {\n Some(Box::new(PyGettextTranslator(translations.unbind())))\n });\n })\n .map_err(|e| errors::PyPlatformError(e))?;\n Ok(())\n}\n\nstruct PyGettextTranslator(\n /// A reference to a `gettext.GNUTranslations` object.\n Py,\n);\n\nimpl Translator for PyGettextTranslator {\n fn translate<'a>(\n &'a self,\n string: &'a str,\n context: Option<&'a str>,\n ) -> std::borrow::Cow<'a, str> {\n Python::try_attach(|py| {\n match if let Some(context) = context {\n self.0.call_method(py, pyo3::intern!(py, \"pgettext\"), (context, string), None)\n } else {\n self.0.call_method(py, pyo3::intern!(py, \"gettext\"), (string,), None)\n } {\n Ok(translation) => Some(translation),\n Err(err) => {\n handle_unraisable(py, \"calling pgettext/gettext\".into(), err);\n None\n }\n }\n .and_then(|maybe_str| maybe_str.extract::(py).ok())\n .map(std::borrow::Cow::Owned)\n })\n .flatten()\n .unwrap_or(std::borrow::Cow::Borrowed(string))\n .into()\n }\n\n fn ntranslate<'a>(\n &'a self,\n n: u64,\n singular: &'a str,\n plural: &'a str,\n context: Option<&'a str>,\n ) -> std::borrow::Cow<'a, str> {\n Python::try_attach(|py| {\n match if let Some(context) = context {\n self.0.call_method(\n py,\n pyo3::intern!(py, \"npgettext\"),\n (context, singular, plural, n),\n None,\n )\n } else {\n self.0.call_method(py, pyo3::intern!(py, \"ngettext\"), (singular, plural, n), None)\n } {\n Ok(translation) => Some(translation),\n Err(err) => {\n handle_unraisable(py, \"calling npgettext/ngettext\".into(), err);\n None\n }\n }\n .and_then(|maybe_str| maybe_str.extract::(py).ok())\n .map(std::borrow::Cow::Owned)\n })\n .flatten()\n .unwrap_or(std::borrow::Cow::Borrowed(singular))\n .into()\n }\n}\n\nuse pyo3::prelude::*;\n\n#[pymodule]\nfn slint(_py: Python<'_>, m: &Bound<'_, PyModule>) -> PyResult<()> {\n i_slint_backend_selector::with_platform(|_b| {\n // Nothing to do, just make sure a backend was created\n Ok(())\n })\n .map_err(|e| errors::PyPlatformError(e))?;\n\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_class::()?;\n m.add_function(wrap_pyfunction!(run_event_loop, m)?)?;\n m.add_function(wrap_pyfunction!(quit_event_loop, m)?)?;\n m.add_function(wrap_pyfunction!(set_xdg_app_id, m)?)?;\n m.add_function(wrap_pyfunction!(invoke_from_event_loop, m)?)?;\n m.add_function(wrap_pyfunction!(init_translations, m)?)?;\n\n language::register_all(m.py(), m)?;\n\n Ok(())\n}\n\ndefine_stub_info_gatherer!(stub_info);\n" }, { "path": "api/python/slint/models.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse std::cell::RefCell;\nuse std::rc::Rc;\n\nuse i_slint_core::model::{Model, ModelNotify, ModelRc};\n\nuse pyo3::PyTraverseError;\nuse pyo3::exceptions::PyIndexError;\nuse pyo3::gc::PyVisit;\nuse pyo3::prelude::*;\n\nuse crate::value::{SlintToPyValue, TypeCollection};\n\npub struct PyModelShared {\n notify: ModelNotify,\n self_ref: RefCell>>,\n /// The type collection is needed when calling a Python implementation of set_row_data and\n /// the model data provided (for example from within a .slint file) contains an enum. Then\n /// we need to know how to map it to the correct Python enum. This field is lazily set, whenever\n /// time the Python model is exposed to Slint.\n type_collection: RefCell>,\n}\n\nimpl PyModelShared {\n pub fn apply_type_collection(&self, type_collection: &TypeCollection) {\n if let Ok(mut type_collection_ref) = self.type_collection.try_borrow_mut() {\n *type_collection_ref = Some(type_collection.clone());\n }\n }\n\n pub fn __traverse__(&self, visit: &PyVisit<'_>) -> Result<(), PyTraverseError> {\n if let Some(this) = self.self_ref.borrow().as_ref() {\n visit.call(this)?;\n }\n Ok(())\n }\n\n pub fn __clear__(&self) {\n *self.self_ref.borrow_mut() = None;\n }\n}\n\n#[derive(Clone)]\n#[pyclass(unsendable, weakref, subclass, skip_from_py_object)]\npub struct PyModelBase {\n inner: Rc,\n}\n\nimpl PyModelBase {\n pub fn as_model(&self) -> ModelRc {\n self.inner.clone().into()\n }\n}\n\n#[pymethods]\nimpl PyModelBase {\n #[new]\n fn new() -> Self {\n Self {\n inner: Rc::new(PyModelShared {\n notify: Default::default(),\n self_ref: RefCell::new(None),\n type_collection: RefCell::new(None),\n }),\n }\n }\n\n fn init_self(&self, self_ref: Py) {\n *self.inner.self_ref.borrow_mut() = Some(self_ref);\n }\n\n fn notify_row_added(&self, index: usize, count: usize) {\n self.inner.notify.row_added(index, count)\n }\n\n fn notify_row_changed(&self, index: usize) {\n self.inner.notify.row_changed(index)\n }\n\n fn notify_row_removed(&self, index: usize, count: usize) {\n self.inner.notify.row_removed(index, count)\n }\n\n fn __traverse__(&self, visit: PyVisit<'_>) -> Result<(), PyTraverseError> {\n self.inner.__traverse__(&visit)\n }\n\n fn __clear__(&mut self) {\n self.inner.__clear__();\n }\n}\n\nimpl i_slint_core::model::Model for PyModelShared {\n type Data = slint_interpreter::Value;\n\n fn row_count(&self) -> usize {\n Python::try_attach(|py| {\n let obj = self.self_ref.borrow();\n let Some(obj) = obj.as_ref() else {\n eprintln!(\"Python: Model implementation is lacking self object (in row_count)\");\n return 0;\n };\n let result = match obj.call_method0(py, \"row_count\") {\n Ok(result) => result,\n Err(err) => {\n crate::handle_unraisable(\n py,\n \"Python: Model implementation of row_count() threw an exception\".into(),\n err,\n );\n return 0;\n }\n };\n\n match result.extract::(py) {\n Ok(count) => count,\n Err(err) => {\n crate::handle_unraisable(\n py,\n \"Python: Model implementation of row_count() returned value that cannot be cast to usize\".into(),\n err,\n );\n 0\n }\n }\n }).unwrap_or_default()\n }\n\n fn row_data(&self, row: usize) -> Option {\n Python::try_attach(|py| {\n let obj = self.self_ref.borrow();\n let Some(obj) = obj.as_ref() else {\n eprintln!(\"Python: Model implementation is lacking self object (in row_data)\");\n return None;\n };\n\n let result = match obj.call_method1(py, \"row_data\", (row,)) {\n Ok(result) => result,\n Err(err) if err.is_instance_of::(py) => return None,\n Err(err) => {\n crate::handle_unraisable(\n py,\n \"Python: Model implementation of row_data() threw an exception\".into(),\n err,\n );\n return None;\n }\n };\n\n match TypeCollection::slint_value_from_py_value(\n py,\n &result,\n self.type_collection.borrow().as_ref(),\n ) {\n Ok(pv) => Some(pv),\n Err(err) => {\n crate::handle_unraisable(\n py,\n \"Python: Model implementation of row_data() returned value that cannot be cast to usize\".into(),\n err,\n );\n None\n }\n }\n }).flatten()\n }\n\n fn set_row_data(&self, row: usize, data: Self::Data) {\n Python::try_attach(|py| {\n let obj = self.self_ref.borrow();\n let Some(obj) = obj.as_ref() else {\n eprintln!(\"Python: Model implementation is lacking self object (in set_row_data)\");\n return;\n };\n\n let Some(type_collection) = self.type_collection.borrow().as_ref().cloned() else {\n eprintln!(\n \"Python: Model implementation is lacking type collection (in set_row_data)\"\n );\n return;\n };\n\n if let Err(err) =\n obj.call_method1(py, \"set_row_data\", (row, type_collection.to_py_value(data)))\n {\n crate::handle_unraisable(\n py,\n \"Python: Model implementation of set_row_data() threw an exception\".into(),\n err,\n );\n };\n });\n }\n\n fn model_tracker(&self) -> &dyn i_slint_core::model::ModelTracker {\n &self.notify\n }\n\n fn as_any(&self) -> &dyn core::any::Any {\n self\n }\n}\n\nimpl PyModelShared {\n pub fn rust_into_py_model<'py>(\n model: &ModelRc,\n py: Python<'py>,\n ) -> Option> {\n model.as_any().downcast_ref::().and_then(|rust_model| {\n rust_model.self_ref.borrow().as_ref().map(|obj| obj.clone_ref(py).into_bound(py))\n })\n }\n}\n\n#[pyclass(unsendable)]\npub struct ReadOnlyRustModel {\n pub model: ModelRc,\n pub type_collection: TypeCollection,\n}\n\n#[pymethods]\nimpl ReadOnlyRustModel {\n fn row_count(&self) -> usize {\n self.model.row_count()\n }\n\n fn row_data(&self, row: usize) -> Option {\n self.model.row_data(row).map(|value| self.type_collection.to_py_value(value))\n }\n\n fn __len__(&self) -> usize {\n self.row_count()\n }\n\n fn __iter__(slf: PyRef<'_, Self>) -> ReadOnlyRustModelIterator {\n ReadOnlyRustModelIterator {\n model: slf.model.clone(),\n row: 0,\n type_collection: slf.type_collection.clone(),\n }\n }\n\n fn __getitem__(&self, index: usize) -> Option {\n self.row_data(index)\n }\n}\n\n#[pyclass(unsendable)]\nstruct ReadOnlyRustModelIterator {\n model: ModelRc,\n row: usize,\n type_collection: TypeCollection,\n}\n\n#[pymethods]\nimpl ReadOnlyRustModelIterator {\n fn __iter__(slf: PyRef<'_, Self>) -> PyRef<'_, Self> {\n slf\n }\n\n fn __next__(&mut self) -> Option {\n if self.row >= self.model.row_count() {\n return None;\n }\n let row = self.row;\n self.row += 1;\n self.model.row_data(row).map(|value| self.type_collection.to_py_value(value))\n }\n}\n" }, { "path": "api/python/slint/pyproject.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[build-system]\nrequires = [\"maturin>=1,<2\"]\nbuild-backend = \"maturin\"\n\n[project]\nname = \"slint\"\nversion = \"1.16.0b1\"\nrequires-python = \">= 3.12\"\nauthors = [{ name = \"Slint Team\", email = \"info@slint.dev\" }]\nclassifiers = [\n \"Development Status :: 3 - Alpha\",\n \"Environment :: MacOS X\",\n \"Environment :: X11 Applications\",\n \"Environment :: Win32 (MS Windows)\",\n \"Intended Audience :: Developers\",\n \"Programming Language :: Python\",\n \"Programming Language :: Rust\",\n \"License :: OSI Approved :: GNU General Public License v3 (GPLv3)\",\n \"License :: Other/Proprietary License\",\n \"Topic :: Software Development\",\n \"Topic :: Software Development :: Libraries :: Application Frameworks\",\n \"Topic :: Software Development :: User Interfaces\",\n \"Topic :: Software Development :: Widget Sets\",\n \"Programming Language :: Python\",\n \"Programming Language :: Python :: 3\",\n \"Programming Language :: Python :: 3.10\",\n]\ndescription = \"GUI toolkit to efficiently develop fluid graphical user interfaces for embedded devices and desktop applications\"\nreadme = \"README.md\"\n\n[project.urls]\nHomepage = \"https://slint.dev\"\nDocumentation = \"https://slint.dev/docs\"\nRepository = \"https://github.com/slint-ui/slint\"\nChangelog = \"https://github.com/slint-ui/slint/blob/master/CHANGELOG.md\"\nTracker = \"https://github.com/slint-ui/slint/issues\"\n\n[project.optional-dependencies]\ndev = [\"pytest\", \"numpy>=2.3.2\", \"pillow>=11.3.0\", \"aiohttp>=3.12.15\"]\n\n[dependency-groups]\ndev = [\"pdoc>=15.0.1\", \"pytest>=8.3.4\", \"ruff>=0.9.6\", \"pillow>=11.3.0\", \"numpy>=2.3.2\", \"aiohttp>=3.12.15\"]\n\n[tool.uv]\n# Rebuild package when any rust files change\ncache-keys = [{ file = \"pyproject.toml\" }, { file = \"Cargo.toml\" }, { file = \"**/*.rs\" }]\n# Uncomment to build rust code in development mode\n# config-settings = { build-args = '--profile=dev' }\n\n[tool.maturin]\neditable-profile = \"dev\"\n# added so it includes in wheel build to overrite the default behavior of not including untracked files\ninclude = [\"slint/language.pyi\"]\n" }, { "path": "api/python/slint/slint/__init__.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nr\"\"\"\n.. include:: ../README.md\n\"\"\"\n\nimport os\nimport sys\nfrom . import slint as native\nfrom . import language\n\nimport types\nimport logging\nimport copy\nimport typing\nfrom typing import Any\nimport pathlib\nfrom .models import ListModel, Model\nfrom .slint import Image, Color, Brush, Timer, TimerMode\nfrom .loop import SlintEventLoop\nfrom pathlib import Path\nfrom collections.abc import Coroutine\nimport asyncio\nimport gettext\nimport gzip\nimport base64\n\n\nStruct = native.PyStruct\n\n\nclass CompileError(Exception):\n message: str\n \"\"\"The error message that produced this compile error.\"\"\"\n\n diagnostics: list[native.PyDiagnostic]\n \"\"\"A list of detailed diagnostics that were produced as part of the compilation.\"\"\"\n\n def __init__(self, message: str, diagnostics: list[native.PyDiagnostic]):\n \"\"\"@private\"\"\"\n super().__init__(message)\n self.message = message\n self.diagnostics = diagnostics\n for diag in self.diagnostics:\n self.add_note(str(diag))\n\n\nclass Component:\n \"\"\"Component is the base class for all instances of Slint components. Use the member functions to show or hide the\n window, or spin the event loop.\"\"\"\n\n __instance__: native.ComponentInstance\n\n def show(self) -> None:\n \"\"\"Shows the window on the screen.\"\"\"\n\n self.__instance__.show()\n\n def hide(self) -> None:\n \"\"\"Hides the window from the screen.\"\"\"\n\n self.__instance__.hide()\n\n def run(self) -> None:\n \"\"\"Shows the window, runs the event loop, hides it when the loop is quit, and returns.\"\"\"\n self.show()\n run_event_loop()\n self.hide()\n\n\ndef _normalize_prop(name: str) -> str:\n return name.replace(\"-\", \"_\")\n\n\ndef _build_global_class(compdef: native.ComponentDefinition, global_name: str) -> Any:\n properties_and_callbacks = {}\n\n for prop_name in compdef.global_properties(global_name).keys():\n python_prop = _normalize_prop(prop_name)\n if python_prop in properties_and_callbacks:\n logging.warning(f\"Duplicated property {prop_name}\")\n continue\n\n def mk_setter_getter(prop_or_callback_name: str) -> property:\n def getter(self: Component) -> Any:\n return self.__instance__.get_global_property(\n global_name, prop_or_callback_name\n )\n\n def setter(self: Component, value: Any) -> None:\n self.__instance__.set_global_property(\n global_name, prop_or_callback_name, value\n )\n\n return property(getter, setter)\n\n properties_and_callbacks[python_prop] = mk_setter_getter(prop_name)\n\n for callback_name in compdef.global_callbacks(global_name):\n python_prop = _normalize_prop(callback_name)\n if python_prop in properties_and_callbacks:\n logging.warning(f\"Duplicated property {prop_name}\")\n continue\n\n def mk_setter_getter(prop_or_callback_name: str) -> property:\n def getter(self: Component) -> typing.Callable[..., Any]:\n def call(*args: Any) -> Any:\n return self.__instance__.invoke_global(\n global_name, prop_or_callback_name, *args\n )\n\n return call\n\n def setter(self: Component, value: typing.Callable[..., Any]) -> None:\n self.__instance__.set_global_callback(\n global_name, prop_or_callback_name, value\n )\n\n return property(getter, setter)\n\n properties_and_callbacks[python_prop] = mk_setter_getter(callback_name)\n\n for function_name in compdef.global_functions(global_name):\n python_prop = _normalize_prop(function_name)\n if python_prop in properties_and_callbacks:\n logging.warning(f\"Duplicated function {prop_name}\")\n continue\n\n def mk_getter(function_name: str) -> property:\n def getter(self: Component) -> typing.Callable[..., Any]:\n def call(*args: Any) -> Any:\n return self.__instance__.invoke_global(\n global_name, function_name, *args\n )\n\n return call\n\n return property(getter)\n\n properties_and_callbacks[python_prop] = mk_getter(function_name)\n\n return type(\"SlintGlobalClassWrapper\", (), properties_and_callbacks)\n\n\ndef _build_class(\n compdef: native.ComponentDefinition,\n) -> typing.Callable[..., Component]:\n def cls_init(self: Component, **kwargs: Any) -> Any:\n self.__instance__ = compdef.create()\n for name, value in self.__class__.__dict__.items():\n if hasattr(value, \"slint.callback\"):\n callback_info = getattr(value, \"slint.callback\")\n name = callback_info[\"name\"]\n\n is_async = getattr(value, \"slint.async\", False)\n if is_async:\n if \"global_name\" in callback_info:\n global_name = callback_info[\"global_name\"]\n is_void = compdef.global_callback_returns_void(\n global_name, name\n )\n if is_void is None:\n raise AttributeError(\n f\"Callback '{name}' in global '{global_name}' cannot be used with a callback decorator for an async function, as it is not declared in Slint component\"\n )\n if not is_void:\n raise RuntimeError(\n f\"Callback '{name}' in global '{global_name}' cannot be used with a callback decorator for an async function, as it doesn't return void\"\n )\n else:\n is_void = compdef.callback_returns_void(name)\n if is_void is None:\n raise AttributeError(\n f\"Callback '{name}' cannot be used with a callback decorator for an async function, as it is not declared in Slint component\"\n )\n if not is_void:\n raise RuntimeError(\n f\"Callback '{name}' cannot be used with a callback decorator for an async function, as it doesn't return void\"\n )\n\n def mk_callback(\n self: Any, callback: typing.Callable[..., Any]\n ) -> typing.Callable[..., Any]:\n def invoke(*args: Any, **kwargs: Any) -> Any:\n return callback(self, *args, **kwargs)\n\n return invoke\n\n if \"global_name\" in callback_info:\n self.__instance__.set_global_callback(\n callback_info[\"global_name\"], name, mk_callback(self, value)\n )\n else:\n self.__instance__.set_callback(name, mk_callback(self, value))\n\n for prop, val in kwargs.items():\n setattr(self, prop, val)\n\n properties_and_callbacks: dict[Any, Any] = {\"__init__\": cls_init}\n\n for prop_name in compdef.properties.keys():\n python_prop = _normalize_prop(prop_name)\n if python_prop in properties_and_callbacks:\n logging.warning(f\"Duplicated property {prop_name}\")\n continue\n\n def mk_setter_getter(prop_or_callback_name: str) -> property:\n def getter(self: Component) -> Any:\n return self.__instance__.get_property(prop_or_callback_name)\n\n def setter(self: Component, value: Any) -> None:\n self.__instance__.set_property(prop_or_callback_name, value)\n\n return property(getter, setter)\n\n properties_and_callbacks[python_prop] = mk_setter_getter(prop_name)\n\n for callback_name in compdef.callbacks:\n python_prop = _normalize_prop(callback_name)\n if python_prop in properties_and_callbacks:\n logging.warning(f\"Duplicated property {prop_name}\")\n continue\n\n def mk_setter_getter(prop_or_callback_name: str) -> property:\n def getter(self: Component) -> typing.Callable[..., Any]:\n def call(*args: Any) -> Any:\n return self.__instance__.invoke(prop_or_callback_name, *args)\n\n return call\n\n def setter(self: Component, value: typing.Callable[..., Any]) -> None:\n self.__instance__.set_callback(prop_or_callback_name, value)\n\n return property(getter, setter)\n\n properties_and_callbacks[python_prop] = mk_setter_getter(callback_name)\n\n for function_name in compdef.functions:\n python_prop = _normalize_prop(function_name)\n if python_prop in properties_and_callbacks:\n logging.warning(f\"Duplicated function {prop_name}\")\n continue\n\n def mk_getter(function_name: str) -> property:\n def getter(self: Component) -> typing.Callable[..., Any]:\n def call(*args: Any) -> Any:\n return self.__instance__.invoke(function_name, *args)\n\n return call\n\n return property(getter)\n\n properties_and_callbacks[python_prop] = mk_getter(function_name)\n\n for global_name in compdef.globals:\n global_class = _build_global_class(compdef, global_name)\n\n def mk_global(global_class: typing.Callable[..., Any]) -> property:\n def global_getter(self: Component) -> Any:\n wrapper = global_class()\n setattr(wrapper, \"__instance__\", self.__instance__)\n return wrapper\n\n return property(global_getter)\n\n properties_and_callbacks[global_name] = mk_global(global_class)\n\n return type(\"SlintClassWrapper\", (Component,), properties_and_callbacks)\n\n\ndef _build_struct(name: str, struct_prototype: native.PyStruct) -> type:\n def new_struct(cls: Any, *args: Any, **kwargs: Any) -> native.PyStruct:\n inst = copy.copy(struct_prototype)\n\n for prop, val in kwargs.items():\n setattr(inst, prop, val)\n\n return inst\n\n type_dict = {\n \"__new__\": new_struct,\n }\n\n return type(name, (), type_dict)\n\n\ndef _load_file(\n path: str | os.PathLike[Any] | pathlib.Path,\n quiet: bool = False,\n style: typing.Optional[str] = None,\n include_paths: typing.Optional[typing.List[os.PathLike[Any] | pathlib.Path]] = None,\n library_paths: typing.Optional[\n typing.Dict[str, os.PathLike[Any] | pathlib.Path]\n ] = None,\n translation_domain: typing.Optional[str] = None,\n) -> typing.Tuple[types.SimpleNamespace, native.CompilationResult]:\n \"\"\"This function is the low-level entry point into Slint for instantiating components. It loads the `.slint` file at\n the specified `path` and returns a namespace with all exported components as Python classes, as well as enums, and structs.\n\n * `quiet`: Set to true to prevent any warnings during compilation from being printed to stderr.\n * `style`: Specify a widget style.\n * `include_paths`: Additional include paths used to look up `.slint` files imported from other `.slint` files.\n * `library_paths`: A dictionary that maps library names to their location in the file system. This is then used to look up\n library imports, such as `import { MyButton } from \"@mylibrary\";`.\n * `translation_domain`: The domain to use for looking up the catalogue run-time translations. This must match the\n translation domain used when extracting translations with `slint-tr-extractor`.\n\n \"\"\"\n\n compiler = native.Compiler()\n\n if style is not None:\n compiler.style = style\n if include_paths is not None:\n compiler.include_paths = include_paths\n if library_paths is not None:\n compiler.library_paths = library_paths\n if translation_domain is not None:\n compiler.translation_domain = translation_domain\n\n result = compiler.build_from_path(Path(path))\n\n diagnostics = result.diagnostics\n if diagnostics:\n if not quiet:\n for diag in diagnostics:\n if diag.level == native.DiagnosticLevel.Warning:\n logging.warning(diag)\n if diag.level == native.DiagnosticLevel.Note:\n logging.debug(diag)\n\n errors = [\n diag for diag in diagnostics if diag.level == native.DiagnosticLevel.Error\n ]\n if errors:\n raise CompileError(f\"Could not compile {path}\", diagnostics)\n\n module = types.SimpleNamespace()\n for comp_name in result.component_names:\n wrapper_class = _build_class(result.component(comp_name))\n\n setattr(module, comp_name, wrapper_class)\n\n structs, enums = result.structs_and_enums\n\n for name, struct_prototype in structs.items():\n name = _normalize_prop(name)\n struct_wrapper = _build_struct(name, struct_prototype)\n setattr(module, name, struct_wrapper)\n\n for name, enum_class in enums.items():\n name = _normalize_prop(name)\n setattr(module, name, enum_class)\n\n for orig_name, new_name in result.named_exports:\n orig_name = _normalize_prop(orig_name)\n new_name = _normalize_prop(new_name)\n setattr(module, new_name, getattr(module, orig_name))\n\n return (module, result)\n\n\ndef load_file(\n path: str | os.PathLike[Any] | pathlib.Path,\n quiet: bool = False,\n style: typing.Optional[str] = None,\n include_paths: typing.Optional[typing.List[os.PathLike[Any] | pathlib.Path]] = None,\n library_paths: typing.Optional[\n typing.Dict[str, os.PathLike[Any] | pathlib.Path]\n ] = None,\n translation_domain: typing.Optional[str] = None,\n) -> types.SimpleNamespace:\n \"\"\"This function is the low-level entry point into Slint for instantiating components. It loads the `.slint` file at\n the specified `path` and returns a namespace with all exported components as Python classes, as well as enums, and structs.\n\n * `quiet`: Set to true to prevent any warnings during compilation from being printed to stderr.\n * `style`: Specify a widget style.\n * `include_paths`: Additional include paths used to look up `.slint` files imported from other `.slint` files.\n * `library_paths`: A dictionary that maps library names to their location in the file system. This is then used to look up\n library imports, such as `import { MyButton } from \"@mylibrary\";`.\n * `translation_domain`: The domain to use for looking up the catalogue run-time translations. This must match the\n translation domain used when extracting translations with `slint-tr-extractor`.\n\n \"\"\"\n\n return _load_file(\n path, quiet, style, include_paths, library_paths, translation_domain\n )[0]\n\n\ndef _load_file_checked(\n path: str | os.PathLike[Any] | pathlib.Path,\n expected_api_base64_compressed: str,\n generated_file: str | os.PathLike[Any] | pathlib.Path,\n) -> types.SimpleNamespace:\n \"\"\"@private\"\"\"\n\n module, compilation_result = _load_file(path)\n\n expected_api = gzip.decompress(\n base64.standard_b64decode(expected_api_base64_compressed)\n ).decode(\"utf-8\")\n\n generated_api_module = native.GeneratedAPI(path=generated_file, json=expected_api)\n actual_api_module = compilation_result.generated_api\n\n generated_api_module.compare_generated_vs_actual(\n generated=generated_api_module, actual=actual_api_module\n )\n\n return module\n\n\nclass SlintAutoLoader:\n def __init__(self, base_dir: Path | None = None):\n self.local_dirs: typing.List[Path] | None = None\n if base_dir:\n self.local_dirs = [base_dir]\n\n def __getattr__(self, name: str) -> Any:\n for path in self.local_dirs or sys.path:\n dir_candidate = Path(path) / name\n if os.path.isdir(dir_candidate):\n loader = SlintAutoLoader(dir_candidate)\n setattr(self, name, loader)\n return loader\n\n file_candidate = dir_candidate.with_suffix(\".slint\")\n if os.path.isfile(file_candidate):\n type_namespace = load_file(file_candidate)\n setattr(self, name, type_namespace)\n return type_namespace\n\n dir_candidate = Path(path) / name.replace(\"_\", \"-\")\n file_candidate = dir_candidate.with_suffix(\".slint\")\n if os.path.isfile(file_candidate):\n type_namespace = load_file(file_candidate)\n setattr(self, name, type_namespace)\n return type_namespace\n\n return None\n\n\nloader = SlintAutoLoader()\n\"\"\"Use the global `loader` object to load Slint files from the file system. It exposes two stages of attributes:\n1. Any lookup of an attribute in the loader tries to match a file in `sys.path` with the `.slint` extension. For example\n `loader.my_component` looks for a file `my_component.slint` in the directories in `sys.path`.\n2. Any lookup in the object returned by the first stage tries to match an exported component in the loaded file, or a\n struct, or enum. For example `loader.my_component.MyComponent` looks for an *exported* component named `MyComponent`\n in the file `my_component.slint`.\n\n**Note:** The first entry in the module search path `sys.path` is the directory that contains the input script.\n\nExample:\n```python\nimport slint\n# Look for a file `main.slint` in the current directory,\n# #load & compile it, and instantiate the exported `MainWindow` component\nmain_window = slint.loader.main_window.MainWindow()\nmain_window.show()\n...\n```\n\"\"\"\n\n\ndef _callback_decorator(\n callable: typing.Callable[..., Any], info: typing.Dict[str, Any]\n) -> typing.Callable[..., Any]:\n if \"name\" not in info:\n info[\"name\"] = typing.cast(Any, callable).__name__\n setattr(callable, \"slint.callback\", info)\n\n try:\n import inspect\n\n if inspect.iscoroutinefunction(callable):\n\n def run_as_task(*args, **kwargs) -> None:\n loop = asyncio.get_event_loop()\n loop.create_task(callable(*args, **kwargs))\n\n setattr(run_as_task, \"slint.callback\", info)\n setattr(run_as_task, \"slint.async\", True)\n return run_as_task\n except ImportError:\n pass\n\n return callable\n\n\ndef callback(\n global_name: typing.Callable[..., Any] | str | None = None, name: str | None = None\n) -> typing.Callable[..., Any]:\n \"\"\"Use the callback decorator to mark a method as a callback that can be invoked from the Slint component.\n\n For the decorator to work, the method must be a member of a class that is Slint component.\n\n Example:\n ```python\n import slint\n\n class AppMainWindow(slint.loader.main_window.MainWindow):\n\n # Automatically connected to a callback button_clicked()\n # in main_window.slint's MainWindow.\n @slint.callback()\n def button_clicked(self):\n print(\"Button clicked\")\n\n ...\n ```\n\n If your Python method has a different name from the Slint component's callback, use the `name` parameter to specify\n the correct name. Similarly, use the `global_name` parameter to specify the name of the correct global singleton in\n the Slint component.\n\n **Note:** The callback decorator can also be used with async functions. They will be run as task in the asyncio event loop.\n This is only supported for callbacks that don't return any value, and requires Python >= 3.13.\n \"\"\"\n\n if callable(global_name):\n callback = global_name\n return _callback_decorator(callback, {})\n else:\n info = {}\n if name:\n info[\"name\"] = name\n if global_name:\n info[\"global_name\"] = global_name\n return lambda callback: _callback_decorator(callback, info)\n\n\ndef set_xdg_app_id(app_id: str) -> None:\n \"\"\"Sets the application id for use on Wayland or X11 with [xdg](https://specifications.freedesktop.org/desktop-entry-spec/latest/)\n compliant window managers. This id must be set before the window is shown; it only applies to Wayland or X11.\"\"\"\n\n native.set_xdg_app_id(app_id)\n\n\nquit_event = asyncio.Event()\n\n\ndef run_event_loop(\n main_coro: typing.Optional[Coroutine[None, None, None]] = None,\n) -> None:\n \"\"\"Runs the main Slint event loop. If specified, the coroutine `main_coro` is run in parallel. The event loop doesn't\n terminate when the coroutine finishes, it terminates when calling `quit_event_loop()`.\n\n Example:\n ```python\n import slint\n\n ...\n image_model: slint.ListModel[slint.Image] = slint.ListModel()\n ...\n\n async def main_receiver(image_model: slint.ListModel) -> None:\n async with aiohttp.ClientSession() as session:\n async with session.get(\"http://some.server/svg-image\") as response:\n svg = await response.read()\n image = slint.Image.from_svg_data(svg)\n image_model.append(image)\n\n ...\n slint.run_event_loop(main_receiver(image_model))\n ```\n\n \"\"\"\n\n async def run_inner() -> None:\n global quit_event\n loop = typing.cast(SlintEventLoop, asyncio.get_event_loop())\n\n quit_task = asyncio.ensure_future(quit_event.wait(), loop=loop)\n\n tasks: typing.List[asyncio.Task[typing.Any]] = [quit_task]\n\n main_task = None\n if main_coro:\n main_task = loop.create_task(main_coro)\n tasks.append(main_task)\n\n done, pending = await asyncio.wait(tasks, return_when=asyncio.FIRST_COMPLETED)\n\n if main_task is not None and main_task in done:\n main_task.result() # propagate exception if thrown\n if quit_task in pending:\n await quit_event.wait()\n\n global quit_event\n quit_event = asyncio.Event()\n asyncio.run(run_inner(), debug=False, loop_factory=SlintEventLoop)\n\n\ndef quit_event_loop() -> None:\n \"\"\"Quits the running event loop in the next event processing cycle. This will make an earlier call to `run_event_loop()`\n return.\"\"\"\n global quit_event\n quit_event.set()\n\n\ndef init_translations(translations: typing.Optional[gettext.GNUTranslations]) -> None:\n \"\"\"Installs the specified translations object to handle translations originating from the Slint code.\n\n Example:\n ```python\n import gettext\n import slint\n\n translations_dir = os.path.join(os.path.dirname(__file__), \"lang\")\n try:\n translations = gettext.translation(\"my_app\", translations_dir, [\"de\"])\n slint.install_translations(translations)\n except OSError:\n pass\n ```\n \"\"\"\n native.init_translations(translations)\n\n\n__all__ = [\n \"CompileError\",\n \"Component\",\n \"load_file\",\n \"_load_file_checked\",\n \"loader\",\n \"Image\",\n \"Color\",\n \"Brush\",\n \"Model\",\n \"ListModel\",\n \"Timer\",\n \"TimerMode\",\n \"set_xdg_app_id\",\n \"callback\",\n \"run_event_loop\",\n \"quit_event_loop\",\n \"init_translations\",\n \"language\",\n]\n" }, { "path": "api/python/slint/slint/language.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom . import slint as native\n\nStandardListViewItem = native.language.StandardListViewItem # type: ignore[unresolved-attribute]\n\nKeyboardModifiers = native.language.KeyboardModifiers # type: ignore[unresolved-attribute]\n" }, { "path": "api/python/slint/slint/loop.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom . import slint as native\nimport asyncio.selector_events\nimport asyncio\nimport asyncio.events\nimport selectors\nimport typing\nfrom collections.abc import Mapping\nimport datetime\n\n\nclass HasFileno(typing.Protocol):\n def fileno(self) -> int: ...\n\n\ndef fd_for_fileobj(fileobj: int | HasFileno) -> int:\n if isinstance(fileobj, int):\n return fileobj\n return int(fileobj.fileno())\n\n\nclass _SlintSelectorMapping(Mapping[typing.Any, selectors.SelectorKey]):\n def __init__(self, slint_selector: \"_SlintSelector\") -> None:\n self.slint_selector = slint_selector\n\n def __len__(self) -> int:\n return len(self.slint_selector.fd_to_selector_key)\n\n def get(self, fileobj, default=None):\n fd = fd_for_fileobj(fileobj)\n return self.slint_selector.fd_to_selector_key.get(fd, default)\n\n def __getitem__(self, fileobj: typing.Any) -> selectors.SelectorKey:\n fd = fd_for_fileobj(fileobj)\n return self.slint_selector.fd_to_selector_key[fd]\n\n def __iter__(self):\n return iter(self.slint_selector.fd_to_selector_key)\n\n\nclass _SlintSelector(selectors.BaseSelector):\n def __init__(self) -> None:\n self.fd_to_selector_key: typing.Dict[typing.Any, selectors.SelectorKey] = {}\n self.mapping = _SlintSelectorMapping(self)\n self.adapters: typing.Dict[int, native.AsyncAdapter] = {}\n\n def register(\n self, fileobj: typing.Any, events: typing.Any, data: typing.Any = None\n ) -> selectors.SelectorKey:\n fd = fd_for_fileobj(fileobj)\n key = selectors.SelectorKey(fileobj, fd, events, data)\n self.fd_to_selector_key[fd] = key\n\n adapter = native.AsyncAdapter(fd)\n self.adapters[fd] = adapter\n\n if events & selectors.EVENT_READ:\n adapter.wait_for_readable(self.read_notify)\n if events & selectors.EVENT_WRITE:\n adapter.wait_for_writable(self.write_notify)\n\n return key\n\n def unregister(self, fileobj: typing.Any) -> selectors.SelectorKey:\n fd = fd_for_fileobj(fileobj)\n key = self.fd_to_selector_key.pop(fd)\n\n try:\n del self.adapters[fd]\n except KeyError:\n pass\n\n return key\n\n def modify(\n self, fileobj: typing.Any, events: int, data: typing.Any = None\n ) -> selectors.SelectorKey:\n fd = fd_for_fileobj(fileobj)\n key = self.fd_to_selector_key[fd]\n\n if key.events != events:\n self.unregister(fileobj)\n key = self.register(fileobj, events, data)\n elif key.data != data:\n key._replace(data=data)\n self.fd_to_selector_key[fd] = key\n\n return key\n\n def select(\n self, timeout: float | None = None\n ) -> typing.List[typing.Tuple[selectors.SelectorKey, int]]:\n raise NotImplementedError\n\n def close(self) -> None:\n pass\n\n def get_map(self) -> Mapping[int | HasFileno, selectors.SelectorKey]:\n return self.mapping\n\n def read_notify(self, fd: int) -> None:\n key = self.fd_to_selector_key[fd]\n (reader, writer) = key.data\n reader._run()\n\n def write_notify(self, fd: int) -> None:\n key = self.fd_to_selector_key[fd]\n (reader, writer) = key.data\n writer._run()\n\n\nclass SlintEventLoop(asyncio.SelectorEventLoop):\n def __init__(self) -> None:\n self._is_running = False\n self._timers: typing.Set[native.Timer] = set()\n self.stop_run_forever_event = asyncio.Event()\n self._soon_tasks: typing.List[asyncio.TimerHandle] = []\n super().__init__(_SlintSelector())\n\n def run_forever(self) -> None:\n async def loop_stopper(event: asyncio.Event) -> None:\n await event.wait()\n native.quit_event_loop()\n\n asyncio.events._set_running_loop(self)\n self._is_running = True\n try:\n self.stop_run_forever_event = asyncio.Event()\n self.create_task(loop_stopper(self.stop_run_forever_event))\n native.run_event_loop()\n finally:\n self._is_running = False\n asyncio.events._set_running_loop(None)\n\n def run_until_complete[T](self, future: typing.Awaitable[T]) -> T | None:\n def stop_loop(future: typing.Any) -> None:\n self.stop()\n\n future = asyncio.ensure_future(future, loop=self)\n future.add_done_callback(stop_loop)\n\n try:\n self.run_forever()\n finally:\n future.remove_done_callback(stop_loop)\n\n if future.done():\n return future.result()\n else:\n if self.stop_run_forever_event.is_set():\n raise RuntimeError(\"run_until_complete's future isn't done\", future)\n else:\n # If the loop was quit for example because the user closed the last window, then\n # don't thrown an error but return a None sentinel. The return value of asyncio.run()\n # isn't used by slint.run_event_loop() anyway\n # TODO: see if we can properly cancel the future by calling cancel() and throwing\n # the task cancellation exception.\n return None\n\n def _run_forever_setup(self) -> None:\n pass\n\n def _run_forever_cleanup(self) -> None:\n pass\n\n def stop(self) -> None:\n self.stop_run_forever_event.set()\n\n def is_running(self) -> bool:\n return self._is_running\n\n def close(self) -> None:\n super().close()\n\n def is_closed(self) -> bool:\n return False\n\n def call_later(self, delay, callback, *args, context=None) -> asyncio.TimerHandle:\n timer = native.Timer()\n\n handle = asyncio.TimerHandle(\n when=self.time() + delay,\n callback=callback,\n args=args,\n loop=self,\n context=context,\n )\n\n timers = self._timers\n\n def timer_done_cb() -> None:\n timers.remove(timer)\n if not handle._cancelled:\n handle._run()\n\n timer.start(\n native.TimerMode.SingleShot,\n interval=datetime.timedelta(seconds=delay),\n callback=timer_done_cb,\n )\n\n timers.add(timer)\n\n return handle\n\n def call_at(self, when, callback, *args, context=None) -> asyncio.TimerHandle:\n return self.call_later(when - self.time(), callback, *args, context=context)\n\n def call_soon(self, callback, *args, context=None) -> asyncio.TimerHandle:\n # Collect call-soon tasks in a separate list to ensure FIFO order, as there's no guarantee\n # that multiple single-shot timers in Slint are run in order.\n handle = asyncio.TimerHandle(\n when=self.time(), callback=callback, args=args, loop=self, context=context\n )\n self._soon_tasks.append(handle)\n self.call_later(0, self._flush_soon_tasks)\n return handle\n\n def _flush_soon_tasks(self) -> None:\n tasks_now = self._soon_tasks\n self._soon_tasks = []\n for handle in tasks_now:\n if not handle._cancelled:\n handle._run()\n\n def call_soon_threadsafe(self, callback, *args, context=None) -> asyncio.Handle:\n handle = asyncio.Handle(\n callback=callback,\n args=args,\n loop=self,\n context=context,\n )\n\n def run_handle_cb() -> None:\n if not handle._cancelled:\n handle._run()\n\n native.invoke_from_event_loop(run_handle_cb)\n return handle\n\n def _write_to_self(self) -> None:\n raise NotImplementedError\n" }, { "path": "api/python/slint/slint/models.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom . import slint as native\nfrom collections.abc import Iterable\nfrom abc import abstractmethod\nimport typing\nfrom typing import Any, cast, Iterator\n\n\nclass Model[T](native.PyModelBase, Iterable[T]):\n \"\"\"Model is the base class for feeding dynamic data into Slint views.\n\n Subclass Model to implement your own models, or use `ListModel` to wrap a list.\n\n Models are iterable and can be used in for loops.\"\"\"\n\n def __new__(cls, *args: Any) -> \"Model[T]\":\n return super().__new__(cls)\n\n def __init__(self) -> None:\n self.init_self(self)\n\n def __len__(self) -> int:\n return self.row_count()\n\n def __getitem__(self, index: int) -> typing.Optional[T]:\n return self.row_data(index)\n\n def __setitem__(self, index: int, value: T) -> None:\n self.set_row_data(index, value)\n\n def __iter__(self) -> Iterator[T]:\n return ModelIterator(self)\n\n def set_row_data(self, row: int, value: T) -> None:\n \"\"\"Call this method on mutable models to change the data for the given row.\n The UI will also call this method when modifying a model's data.\n Re-implement this method in a sub-class to handle the change.\"\"\"\n super().set_row_data(row, value)\n\n @abstractmethod\n def row_data(self, row: int) -> typing.Optional[T]:\n \"\"\"Returns the data for the given row.\n Re-implement this method in a sub-class to provide the data.\"\"\"\n return cast(T, super().row_data(row))\n\n def notify_row_changed(self, row: int) -> None:\n \"\"\"Call this method from a sub-class to notify the views that a row has changed.\"\"\"\n super().notify_row_changed(row)\n\n def notify_row_removed(self, row: int, count: int) -> None:\n \"\"\"Call this method from a sub-class to notify the views that\n `count` rows have been removed starting at `row`.\"\"\"\n super().notify_row_removed(row, count)\n\n def notify_row_added(self, row: int, count: int) -> None:\n \"\"\"Call this method from a sub-class to notify the views that\n `count` rows have been added starting at `row`.\"\"\"\n super().notify_row_added(row, count)\n\n\nclass ListModel[T](Model[T]):\n \"\"\"ListModel is a `Model` that stores its data in a Python list.\n\n Construct a ListMode from an iterable (such as a list itself).\n Use `ListModel.append()` to add items to the model, and use the\n `del` statement to remove items.\n\n Any changes to the model are automatically reflected in the views\n in UI they're used with.\n \"\"\"\n\n def __init__(self, iterable: typing.Optional[Iterable[T]] = None):\n \"\"\"Constructs a new ListModel from the give iterable. All the values\n the iterable produces are stored in a list.\"\"\"\n\n super().__init__()\n if iterable is not None:\n self.list = list(iterable)\n else:\n self.list = []\n\n def row_count(self) -> int:\n return len(self.list)\n\n def row_data(self, row: int) -> typing.Optional[T]:\n return self.list[row]\n\n def set_row_data(self, row: int, value: T) -> None:\n self.list[row] = value\n super().notify_row_changed(row)\n\n def __delitem__(self, key: int | slice) -> None:\n if isinstance(key, slice):\n start, stop, step = key.indices(len(self.list))\n del self.list[key]\n count = len(range(start, stop, step))\n super().notify_row_removed(start, count)\n else:\n del self.list[key]\n super().notify_row_removed(key, 1)\n\n def append(self, value: T) -> None:\n \"\"\"Appends the value to the end of the list.\"\"\"\n index = len(self.list)\n self.list.append(value)\n super().notify_row_added(index, 1)\n\n\nclass ModelIterator[T](Iterator[T]):\n def __init__(self, model: Model[T]):\n self.model = model\n self.index = 0\n\n def __iter__(self) -> \"ModelIterator[T]\":\n return self\n\n def __next__(self) -> T:\n if self.index >= self.model.row_count():\n raise StopIteration()\n index = self.index\n self.index += 1\n data = self.model.row_data(index)\n assert data is not None\n return data\n" }, { "path": "api/python/slint/slint/py.typed", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# This file is just a marker\n" }, { "path": "api/python/slint/slint/slint.pyi", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n# This file is automatically generated by pyo3_stub_gen\n# ruff: noqa: E501, F401\n\nimport builtins\nimport datetime\nimport os\nimport pathlib\nimport typing\nfrom typing import Any, List\nfrom collections.abc import Callable, Buffer, Coroutine\nfrom enum import Enum, auto\nimport gettext\n\nclass RgbColor:\n red: int\n green: int\n blue: int\n\nclass RgbaColor:\n red: int\n green: int\n blue: int\n alpha: int\n\nclass Color:\n red: int\n green: int\n blue: int\n alpha: int\n def __new__(\n cls,\n maybe_value: typing.Optional[\n str | RgbaColor | RgbColor | typing.Dict[str, int]\n ] = None,\n ) -> \"Color\": ...\n def brighter(self, factor: float) -> \"Color\": ...\n def darker(self, factor: float) -> \"Color\": ...\n def transparentize(self, factor: float) -> \"Color\": ...\n def mix(self, other: \"Image\", factor: float) -> \"Color\": ...\n def with_alpha(self, alpha: float) -> \"Color\": ...\n def __str__(self) -> str: ...\n def __eq__(self, other: object) -> bool: ...\n\nclass Brush:\n color: Color\n def __new__(cls, maybe_value: typing.Optional[Color]) -> \"Brush\": ...\n def is_transparent(self) -> bool: ...\n def is_opaque(self) -> bool: ...\n def brighter(self, factor: float) -> \"Brush\": ...\n def darker(self, factor: float) -> \"Brush\": ...\n def transparentize(self, amount: float) -> \"Brush\": ...\n def with_alpha(self, alpha: float) -> \"Brush\": ...\n def __eq__(self, other: object) -> bool: ...\n\nclass Image:\n r\"\"\"\n Image objects can be set on Slint Image elements for display. Construct Image objects from a path to an\n image file on disk, using `Image.load_from_path`.\n \"\"\"\n\n size: tuple[int, int]\n width: int\n height: int\n path: typing.Optional[pathlib.Path]\n def __new__(\n cls,\n ) -> \"Image\": ...\n @staticmethod\n def load_from_path(path: str | os.PathLike[Any] | pathlib.Path) -> \"Image\":\n r\"\"\"\n Loads the image from the specified path. Returns None if the image can't be loaded.\n \"\"\"\n ...\n\n @staticmethod\n def load_from_svg_data(data: typing.Sequence[int]) -> \"Image\":\n r\"\"\"\n Creates a new image from a string that describes the image in SVG format.\n \"\"\"\n ...\n\n @staticmethod\n def load_from_array(array: Buffer) -> Image:\n r\"\"\"\n Creates a new image from an array-like object that implements the [Buffer Protocol](https://docs.python.org/3/c-api/buffer.html).\n Use this function to import images created by third-party modules such as matplotlib or Pillow.\n\n The array must satisfy certain contraints to represent an image:\n\n - The buffer's format needs to be `B` (unsigned char)\n - The shape must be a tuple of (height, width, bytes-per-pixel)\n - If a stride is defined, the row stride must be equal to width * bytes-per-pixel, and the column stride must equal the bytes-per-pixel.\n - A value of 3 for bytes-per-pixel is interpreted as RGB image, a value of 4 means RGBA.\n\n Example of importing a matplot figure into an image:\n ```python\n import slint\n import matplotlib\n\n from matplotlib.backends.backend_agg import FigureCanvasAgg\n from matplotlib.figure import Figure\n\n fig = Figure(figsize=(5, 4), dpi=100)\n canvas = FigureCanvasAgg(fig)\n ax = fig.add_subplot()\n ax.plot([1, 2, 3])\n canvas.draw()\n\n buffer = canvas.buffer_rgba()\n img = slint.Image.load_from_array(buffer)\n ```\n\n Example of loading an image with Pillow:\n ```python\n import slint\n from PIL import Image\n import numpy as np\n\n pil_img = Image.open(\"hello.jpeg\")\n array = np.array(pil_img)\n img = slint.Image.load_from_array(array)\n ```\n \"\"\"\n\nclass TimerMode(Enum):\n SingleShot = auto()\n Repeated = auto()\n\nclass Timer:\n running: bool\n interval: datetime.timedelta\n def __new__(\n cls,\n ) -> \"Timer\": ...\n def start(\n self, mode: TimerMode, interval: datetime.timedelta, callback: typing.Any\n ) -> None: ...\n @staticmethod\n def single_shot(duration: datetime.timedelta, callback: typing.Any) -> None: ...\n def stop(self) -> None: ...\n def restart(self) -> None: ...\n\ndef set_xdg_app_id(app_id: str) -> None: ...\ndef invoke_from_event_loop(callable: typing.Callable[[], None]) -> None: ...\ndef run_event_loop() -> None: ...\ndef quit_event_loop() -> None: ...\ndef init_translations(\n translations: typing.Optional[gettext.GNUTranslations],\n) -> None: ...\n\nclass PyModelBase:\n def init_self(self, *args: Any) -> None: ...\n def row_count(self) -> int: ...\n def row_data(self, row: int) -> typing.Optional[Any]: ...\n def set_row_data(self, row: int, value: Any) -> None: ...\n def notify_row_changed(self, row: int) -> None: ...\n def notify_row_removed(self, row: int, count: int) -> None: ...\n def notify_row_added(self, row: int, count: int) -> None: ...\n\nclass PyStruct(Any): ...\n\nclass ValueType(Enum):\n Void = auto()\n Number = auto()\n String = auto()\n Bool = auto()\n Model = auto()\n Struct = auto()\n Brush = auto()\n Image = auto()\n\nclass DiagnosticLevel(Enum):\n Error = auto()\n Warning = auto()\n Note = auto()\n\nclass PyDiagnostic:\n level: DiagnosticLevel\n message: str\n line_number: int\n column_number: int\n source_file: typing.Optional[str]\n\nclass ComponentInstance:\n def show(self) -> None: ...\n def hide(self) -> None: ...\n def invoke(self, callback_name: str, *args: Any) -> Any: ...\n def invoke_global(\n self, global_name: str, callback_name: str, *args: Any\n ) -> Any: ...\n def set_property(self, property_name: str, value: Any) -> None: ...\n def get_property(self, property_name: str) -> Any: ...\n def set_callback(\n self, callback_name: str, callback: Callable[..., Any]\n ) -> None: ...\n def set_global_callback(\n self, global_name: str, callback_name: str, callback: Callable[..., Any]\n ) -> None: ...\n def set_global_property(\n self, global_name: str, property_name: str, value: Any\n ) -> None: ...\n def get_global_property(self, global_name: str, property_name: str) -> Any: ...\n\nclass ComponentDefinition:\n def create(self) -> ComponentInstance: ...\n name: str\n globals: list[str]\n functions: list[str]\n callbacks: list[str]\n properties: dict[str, ValueType]\n def global_functions(self, global_name: str) -> list[str]: ...\n def global_callbacks(self, global_name: str) -> list[str]: ...\n def global_properties(self, global_name: str) -> typing.Dict[str, ValueType]: ...\n def callback_returns_void(self, callback_name: str) -> bool: ...\n def global_callback_returns_void(\n self, global_name: str, callback_name: str\n ) -> bool: ...\n\nclass CompilationResult:\n component_names: list[str]\n diagnostics: list[PyDiagnostic]\n named_exports: list[typing.Tuple[str, str]]\n structs_and_enums: typing.Tuple[typing.Dict[str, PyStruct], typing.Dict[str, Enum]]\n generated_api: GeneratedAPI\n def component(self, name: str) -> ComponentDefinition: ...\n\nclass Compiler:\n include_paths: list[os.PathLike[Any] | pathlib.Path]\n library_paths: dict[str, os.PathLike[Any] | pathlib.Path]\n translation_domain: str\n style: str\n def build_from_path(\n self, path: os.PathLike[Any] | pathlib.Path\n ) -> CompilationResult: ...\n def build_from_source(\n self, source: str, path: os.PathLike[Any] | pathlib.Path\n ) -> CompilationResult: ...\n\nclass AsyncAdapter:\n def __new__(\n cls,\n fd: int,\n ) -> \"AsyncAdapter\": ...\n def wait_for_readable(self, callback: typing.Callable[[int], None]) -> None: ...\n def wait_for_writable(self, callback: typing.Callable[[int], None]) -> None: ...\n\nclass GeneratedAPI:\n def __new__(\n cls, path: str | os.PathLike[Any] | pathlib.Path, json: str\n ) -> \"GeneratedAPI\": ...\n @staticmethod\n def compare_generated_vs_actual(\n generated: \"GeneratedAPI\", actual: \"GeneratedAPI\"\n ) -> None: ...\n" }, { "path": "api/python/slint/stub-gen/main.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse pyo3_stub_gen::Result;\n\nfn main() -> Result<()> {\n // `stub_info` is a function defined by `define_stub_info_gatherer!` macro.\n let stub = slint_python::stub_info()?;\n stub.generate()?;\n Ok(())\n}\n" }, { "path": "api/python/slint/tests/api-match.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nexport component Test inherits Window {\n in-out property name;\n}\n" }, { "path": "api/python/slint/tests/test-file-error.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n\nexport component App inherits Window {\n property foo;\n NewType { }\n}\n" }, { "path": "api/python/slint/tests/test-load-file.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nexport global MyGlobal {\n in-out property global-prop: \"This is global\";\n callback global-callback(string) -> string;\n public function minus-one(value: int) {\n return value - 1;\n }\n}\n\nexport global SecondGlobal {\n out property second: \"second\";\n}\n\nexport struct MyData {\n name: string,\n age: int,\n}\n\nstruct Secret-Struct {\n balance: int,\n}\n\nexport { Secret-Struct as Public-Struct }\n\nexport enum TestEnum {\n Variant1,\n Variant2,\n Variant-three,\n}\n\nexport component App inherits Window {\n in-out property hello: \"World\";\n callback say-hello(string) -> string;\n callback say_hello_again(string) -> string;\n\n callback invoke-say-hello(string) -> string;\n invoke-say-hello(arg) => {\n return self.say-hello(arg);\n }\n callback invoke-say-hello-again(string) -> string;\n invoke-say-hello-again(arg) => {\n return self.say-hello-again(arg);\n }\n callback invoke-global-callback(string) -> string;\n invoke-global-callback(arg) => {\n return MyGlobal.global-callback(arg);\n }\n public function plus-one(value: int) {\n return value + 1;\n }\n callback invoke-call-void();\n invoke-call-void => {\n call-void();\n }\n callback call-void();\n callback invoke-call-void2();\n invoke-call-void2 => {\n call_void2();\n }\n callback call_void2();\n\n in-out property enum-property: TestEnum.Variant2;\n in-out property <[TestEnum]> model-with-enums: [TestEnum.Variant2, TestEnum.Variant1];\n\n Rectangle {\n color: red;\n }\n\n in-out property translated: @tr(\"Yes\");\n}\n\ncomponent Diag inherits Window { }\n\nexport { Diag as MyDiag }\n" }, { "path": "api/python/slint/tests/test_api_match.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport pytest\nfrom slint import _load_file_checked\nfrom pathlib import Path\nimport base64\nimport gzip\n\n\ndef base_dir() -> Path:\n assert __spec__\n origin = __spec__.origin\n assert origin is not None\n base_dir = Path(origin).parent\n assert base_dir is not None\n return base_dir\n\n\ndef compress_and_encode(json: str) -> str:\n return base64.standard_b64encode(gzip.compress(json.encode(\"utf-8\"))).decode(\n \"utf-8\"\n )\n\n\ndef test_no_change() -> None:\n _load_file_checked(\n base_dir() / \"api-match.slint\",\n expected_api_base64_compressed=compress_and_encode(r\"\"\"\n {\n \"version\":\"1.0\",\n \"globals\":[],\n \"components\":[\n {\n \"name\":\"Test\",\n \"properties\":[\n {\n \"name\": \"name\",\n \"ty\": \"str\"\n }\n ],\n \"aliases\":[]\n }\n ],\n \"structs_and_enums\":[]\n }\"\"\"),\n generated_file=\"/some/path.py\",\n )\n\n\ndef test_incompatible_changes() -> None:\n with pytest.raises(RuntimeError) as excinfo:\n _load_file_checked(\n base_dir() / \"api-match.slint\",\n expected_api_base64_compressed=compress_and_encode(r\"\"\"\n {\n \"version\":\"1.0\",\n \"globals\":[],\n \"components\":[\n {\n \"name\":\"Test\",\n \"properties\":[\n {\n \"name\": \"name\",\n \"ty\": \"str\"\n },\n {\n \"name\": \"not_there_anymore\",\n \"ty\": \"str\"\n }\n ],\n \"aliases\":[]\n }\n ],\n \"structs_and_enums\":[]\n }\"\"\"),\n generated_file=\"/some/path.py\",\n )\n assert (\n f\"Incompatible API changes detected between /some/path.py and {base_dir() / 'api-match.slint'}\"\n == str(excinfo.value)\n )\n" }, { "path": "api/python/slint/tests/test_async.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport slint\nfrom slint import slint as native\nimport asyncio\nimport typing\nimport aiohttp\nfrom aiohttp import web\nimport socket\nimport threading\nimport pytest\nimport sys\nimport platform\nfrom datetime import timedelta\n\n\ndef test_async_basic() -> None:\n async def quit_soon(call_check: typing.List[bool]) -> None:\n await asyncio.sleep(1)\n call_check[0] = True\n slint.quit_event_loop()\n\n call_check = [False]\n\n slint.run_event_loop(quit_soon(call_check))\n\n assert call_check[0]\n\n\ndef test_async_aiohttp() -> None:\n def probe_port() -> int:\n s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)\n s.bind((\"127.0.0.1\", 0))\n port = typing.cast(int, s.getsockname()[1])\n # This is a race condition, but should be good enough for test environments\n s.close()\n return port\n\n async def hello(request: web.Request) -> web.Response:\n return web.Response(text=\"Hello, world\")\n\n async def run_network_requests(\n port: int, exceptions: typing.List[Exception]\n ) -> None:\n try:\n app = web.Application()\n app.add_routes([web.get(\"/\", hello)])\n runner = web.AppRunner(app)\n await runner.setup()\n\n site = web.TCPSite(runner, \"127.0.0.1\", port)\n await site.start()\n\n async with aiohttp.ClientSession() as session:\n async with session.get(f\"http://127.0.0.1:{port}\") as response:\n #\n print(\"Status:\", response.status)\n print(\"Content-type:\", response.headers[\"content-type\"])\n #\n html = await response.text()\n print(\"Body:\", html[:15], \"...\")\n assert html == \"Hello, world\"\n\n await runner.cleanup()\n except Exception as e:\n exceptions.append(e)\n finally:\n slint.quit_event_loop()\n\n exceptions: typing.List[Exception] = []\n slint.run_event_loop(run_network_requests(probe_port(), exceptions))\n assert len(exceptions) == 0\n\n\ndef test_basic_socket() -> None:\n def server_thread(server_socket: socket.socket) -> None:\n server_socket.listen(1)\n conn, _ = server_socket.accept()\n try:\n data = conn.recv(1024)\n if data == b\"ping\":\n conn.sendall(b\"pong\")\n else:\n conn.sendall(b\"error\")\n finally:\n conn.close()\n server_socket.close()\n\n server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)\n server_socket.bind((\"127.0.0.1\", 0))\n port = server_socket.getsockname()[1]\n thread = threading.Thread(target=server_thread, args=(server_socket,))\n thread.start()\n\n async def run_network_request(port: int) -> None:\n reader, writer = await asyncio.open_connection(\"127.0.0.1\", port)\n\n writer.write(b\"ping\")\n await writer.drain()\n\n response = []\n while chunk := await reader.read(1024):\n response.append(chunk)\n\n writer.close()\n await writer.wait_closed()\n\n assert response[0] == b\"pong\"\n slint.quit_event_loop()\n\n slint.run_event_loop(run_network_request(port))\n thread.join()\n\n\ndef test_server_socket() -> None:\n async def handle_client(\n reader: asyncio.StreamReader, writer: asyncio.StreamWriter\n ) -> None:\n data = await reader.read(1024)\n if data == b\"ping\":\n writer.write(b\"pong\")\n else:\n writer.write(b\"error\")\n await writer.drain()\n writer.close()\n await writer.wait_closed()\n\n async def run_network_request(port: int) -> None:\n try:\n reader, writer = await asyncio.open_connection(\"127.0.0.1\", port)\n\n writer.write(b\"ping\")\n await writer.drain()\n\n response = []\n while chunk := await reader.read(1024):\n response.append(chunk)\n\n writer.close()\n await writer.wait_closed()\n\n assert response[0] == b\"pong\"\n finally:\n slint.quit_event_loop()\n\n async def run_server_and_client(exception_check: typing.List[Exception]) -> None:\n try:\n server = await asyncio.start_server(handle_client, \"127.0.0.1\", 0)\n port = server.sockets[0].getsockname()[1]\n\n async with server:\n await asyncio.gather(\n server.serve_forever(),\n run_network_request(port),\n )\n except Exception as e:\n exception_check.append(e)\n raise\n\n exception_check: typing.List[Exception] = []\n slint.run_event_loop(run_server_and_client(exception_check))\n if len(exception_check) > 0:\n raise exception_check[0]\n\n\ndef test_loop_close_while_main_future_runs() -> None:\n def q() -> None:\n native.quit_event_loop()\n\n async def never_quit() -> None:\n loop = asyncio.get_running_loop()\n # Call native.quit_event_loop() directly as if the user closed the last window. We should gracefully\n # handle that the future that this function represents isn't terminated.\n loop.call_later(0.1, q)\n while True:\n await asyncio.sleep(1)\n\n try:\n slint.run_event_loop(never_quit())\n except Exception:\n pytest.fail(\"Should not throw a run-time error\")\n\n\ndef test_loop_continues_when_main_coro_finished() -> None:\n async def quit_later(quit_event: asyncio.Event) -> None:\n await quit_event.wait()\n slint.quit_event_loop()\n\n async def simple(quit_event: asyncio.Event) -> None:\n loop = asyncio.get_event_loop()\n loop.create_task(quit_later(quit_event))\n\n quit_event = asyncio.Event()\n slint.Timer.single_shot(\n duration=timedelta(milliseconds=100), callback=lambda: quit_event.set()\n )\n slint.run_event_loop(simple(quit_event))\n assert quit_event.is_set()\n\n\n@pytest.mark.skipif(platform.system() == \"Windows\", reason=\"pipes aren't supported yet\")\ndef test_subprocess() -> None:\n async def launch_process(exception_check: typing.List[Exception]) -> None:\n try:\n proc = await asyncio.create_subprocess_exec(\n sys.executable,\n \"--version\",\n stdout=asyncio.subprocess.PIPE,\n stderr=asyncio.subprocess.STDOUT,\n )\n\n stdout, _ = await proc.communicate()\n output = stdout.decode().strip()\n print(f\"Process output: {output}\")\n\n assert proc.returncode == 0\n assert output != \"\"\n slint.quit_event_loop()\n except Exception as e:\n exception_check[0] = e\n raise\n\n exception_check: typing.List[Exception] = []\n slint.run_event_loop(launch_process(exception_check))\n if len(exception_check) > 0:\n raise exception_check[0]\n\n\ndef test_exception_thrown() -> None:\n async def throws() -> None:\n raise RuntimeError(\"Boo\")\n\n with pytest.raises(RuntimeError, match=\"Boo\"):\n slint.run_event_loop(throws())\n" }, { "path": "api/python/slint/tests/test_brush.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import Color, Brush\n\n\ndef test_col_default() -> None:\n col = Color()\n assert col.red == 0\n assert col.green == 0\n assert col.blue == 0\n assert col.alpha == 0\n\n\ndef test_col_from_str() -> None:\n col = Color(\"#123456\")\n assert col.red == 0x12\n assert col.green == 0x34\n assert col.blue == 0x56\n assert col.alpha == 255\n assert str(col) == \"argb(255, 18, 52, 86)\"\n\n\ndef test_col_from_rgb_dict() -> None:\n coldict = {\"red\": 0x12, \"green\": 0x34, \"blue\": 0x56}\n col = Color(coldict)\n assert col.red == 0x12\n assert col.green == 0x34\n assert col.blue == 0x56\n assert col.alpha == 255\n\n\ndef test_col_from_rgba_dict() -> None:\n coldict = {\"red\": 0x12, \"green\": 0x34, \"blue\": 0x56, \"alpha\": 128}\n col = Color(coldict)\n assert col.red == 0x12\n assert col.green == 0x34\n assert col.blue == 0x56\n assert col.alpha == 128\n\n\ndef test_from_col() -> None:\n col = Color(\"#123456\")\n brush = Brush(col)\n assert brush.color == col\n" }, { "path": "api/python/slint/tests/test_callback_decorators.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import load_file\nimport slint\nimport pytest\nfrom pathlib import Path\nimport asyncio\n\n\ndef base_dir() -> Path:\n assert __spec__\n origin = __spec__.origin\n assert origin is not None\n base_dir = Path(origin).parent\n assert base_dir is not None\n return base_dir\n\n\ndef test_callback_decorators(caplog: pytest.LogCaptureFixture) -> None:\n module = load_file(base_dir() / \"test-load-file.slint\", quiet=False)\n\n class SubClass(module.App):\n @slint.callback()\n def say_hello_again(self, arg: str) -> str:\n return \"say_hello_again:\" + arg\n\n @slint.callback(name=\"say-hello\")\n def renamed(self, arg: str) -> str:\n return \"renamed:\" + arg\n\n @slint.callback(global_name=\"MyGlobal\", name=\"global-callback\")\n def global_callback(self, arg: str) -> str:\n return \"global:\" + arg\n\n instance = SubClass()\n assert instance.invoke_say_hello(\"ok\") == \"renamed:ok\"\n assert instance.invoke_say_hello_again(\"ok\") == \"say_hello_again:ok\"\n assert instance.invoke_global_callback(\"ok\") == \"global:ok\"\n del instance\n\n\ndef test_callback_decorators_async() -> None:\n module = load_file(base_dir() / \"test-load-file.slint\", quiet=False)\n\n class SubClass(module.App):\n def __init__(self, in_queue: asyncio.Queue[int], out_queue: asyncio.Queue[int]):\n super().__init__()\n self.in_queue = in_queue\n self.out_queue = out_queue\n\n @slint.callback()\n async def call_void(self) -> None:\n value = await self.in_queue.get()\n await self.out_queue.put(value + 1)\n\n @slint.callback()\n async def call_void2(self) -> None:\n value = await self.in_queue.get()\n await self.out_queue.put(value + 2)\n\n async def main(\n instance: SubClass, in_queue: asyncio.Queue[int], out_queue: asyncio.Queue[int]\n ) -> None:\n await in_queue.put(42)\n instance.invoke_call_void()\n assert await out_queue.get() == 43\n await in_queue.put(43)\n instance.invoke_call_void2()\n assert await out_queue.get() == 45\n slint.quit_event_loop()\n\n in_queue: asyncio.Queue[int] = asyncio.Queue()\n out_queue: asyncio.Queue[int] = asyncio.Queue()\n instance = SubClass(in_queue, out_queue)\n slint.run_event_loop(main(instance, in_queue, out_queue))\n\n\ndef test_callback_decorators_async_err() -> None:\n module = load_file(base_dir() / \"test-load-file.slint\", quiet=False)\n\n class SubClass(module.App):\n def __init__(self) -> None:\n super().__init__()\n\n @slint.callback()\n async def say_hello(self, msg: str) -> str:\n return msg\n\n with pytest.raises(RuntimeError) as excinfo:\n SubClass()\n err = excinfo.value\n assert (\n str(err)\n == \"Callback 'say_hello' cannot be used with a callback decorator for an async function, as it doesn't return void\"\n )\n" }, { "path": "api/python/slint/tests/test_compiler.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import slint as native\nfrom slint.slint import ValueType\nfrom pathlib import Path\n\n\ndef test_basic_compiler() -> None:\n compiler = native.Compiler()\n\n assert compiler.include_paths == []\n compiler.include_paths = [Path(\"testing\")]\n assert compiler.include_paths == [Path(\"testing\")]\n\n assert len(compiler.build_from_source(\"Garbage\", Path(\"\")).component_names) == 0\n\n result = compiler.build_from_source(\n \"\"\"\n export global TestGlobal {\n in property theglobalprop;\n callback globallogic();\n public function globalfun() {}\n }\n\n export component Test {\n in property strprop;\n in property intprop;\n in property floatprop;\n in property boolprop;\n in property imgprop;\n in property brushprop;\n in property colprop;\n in property <[string]> modelprop;\n\n callback test-callback();\n public function ff() {}\n }\n \"\"\",\n Path(\"\"),\n )\n assert result.component_names == [\"Test\"]\n compdef = result.component(\"Test\")\n\n assert compdef is not None\n\n assert compdef.name == \"Test\"\n\n props = [(name, type) for name, type in compdef.properties.items()]\n assert props == [\n (\"boolprop\", ValueType.Bool),\n (\"brushprop\", ValueType.Brush),\n (\"colprop\", ValueType.Brush),\n (\"floatprop\", ValueType.Number),\n (\"imgprop\", ValueType.Image),\n (\"intprop\", ValueType.Number),\n (\"modelprop\", ValueType.Model),\n (\"strprop\", ValueType.String),\n ]\n\n assert compdef.callbacks == [\"test-callback\"]\n assert compdef.functions == [\"ff\"]\n\n assert compdef.globals == [\"TestGlobal\"]\n\n assert compdef.global_properties(\"Garbage\") is None\n assert [\n (name, type) for name, type in compdef.global_properties(\"TestGlobal\").items()\n ] == [(\"theglobalprop\", ValueType.String)]\n\n assert compdef.global_callbacks(\"Garbage\") is None\n assert compdef.global_callbacks(\"TestGlobal\") == [\"globallogic\"]\n\n assert compdef.global_functions(\"Garbage\") is None\n assert compdef.global_functions(\"TestGlobal\") == [\"globalfun\"]\n\n instance = compdef.create()\n assert instance is not None\n\n\ndef test_compiler_build_from_path() -> None:\n compiler = native.Compiler()\n\n result = compiler.build_from_path(Path(\"Nonexistent.slint\"))\n assert len(result.component_names) == 0\n\n diags = result.diagnostics\n assert len(diags) == 1\n\n assert diags[0].level == native.DiagnosticLevel.Error\n assert diags[0].message.startswith(\"Could not load Nonexistent.slint:\")\n" }, { "path": "api/python/slint/tests/test_enums.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport pytest\nfrom slint import load_file, ListModel\nfrom pathlib import Path\n\n\ndef base_dir() -> Path:\n assert __spec__\n origin = __spec__.origin\n assert origin is not None\n base_dir = Path(origin).parent\n assert base_dir is not None\n return base_dir\n\n\ndef test_enums() -> None:\n module = load_file(base_dir() / \"test-load-file.slint\", quiet=False)\n\n TestEnum = module.TestEnum\n\n assert TestEnum.Variant1.name == \"Variant1\"\n assert TestEnum.Variant1.value == \"Variant1\"\n assert TestEnum.Variant2.name == \"Variant2\"\n assert TestEnum.Variant2.value == \"Variant2\"\n with pytest.raises(\n AttributeError, match=\"type object 'TestEnum' has no attribute 'Variant3'\"\n ):\n TestEnum.Variant3\n\n instance = module.App()\n assert instance.enum_property == TestEnum.Variant2\n assert instance.enum_property.__class__ is TestEnum\n instance.enum_property = TestEnum.Variant1\n assert instance.enum_property == TestEnum.Variant1\n assert instance.enum_property.__class__ is TestEnum\n instance.enum_property = TestEnum.Variant_three\n assert instance.enum_property == TestEnum.Variant_three\n assert instance.enum_property.__class__ is TestEnum\n\n model_with_enums = instance.model_with_enums\n assert len(model_with_enums) == 2\n assert model_with_enums[0] == TestEnum.Variant2\n assert model_with_enums[1] == TestEnum.Variant1\n assert model_with_enums[0].__class__ is TestEnum\n model_with_enums = None\n\n instance.model_with_enums = ListModel([TestEnum.Variant1, TestEnum.Variant2])\n assert len(instance.model_with_enums) == 2\n assert instance.model_with_enums[0] == TestEnum.Variant1\n assert instance.model_with_enums[1] == TestEnum.Variant2\n assert instance.model_with_enums[0].__class__ is TestEnum\n" }, { "path": "api/python/slint/tests/test_gc.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import slint as native\nimport slint\nimport weakref\nimport gc\nimport typing\nfrom pathlib import Path\n\n\ndef test_callback_gc() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export component Test {\n out property test-value: \"Ok\";\n callback test-callback(string) -> string;\n }\n \"\"\",\n Path(\"\"),\n ).component(\"Test\")\n assert compdef is not None\n\n instance: native.ComponentInstance | None = compdef.create()\n assert instance is not None\n\n class Handler:\n def __init__(self, instance: native.ComponentInstance) -> None:\n self.instance = instance\n\n def python_callback(self, input: str) -> str:\n return input + typing.cast(str, self.instance.get_property(\"test-value\"))\n\n handler: Handler | None = Handler(instance)\n assert handler is not None\n instance.set_callback(\"test-callback\", handler.python_callback)\n handler = None\n\n assert instance.invoke(\"test-callback\", \"World\") == \"WorldOk\"\n\n wr = weakref.ref(instance)\n assert wr() is not None\n instance = None\n gc.collect()\n assert wr() is None\n\n\ndef test_struct_gc() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export struct Foo {\n data: [int]\n }\n export component Test {\n out property test-value;\n }\n \"\"\",\n Path(\"\"),\n ).component(\"Test\")\n assert compdef is not None\n\n instance: native.ComponentInstance | None = compdef.create()\n assert instance is not None\n\n model: typing.Optional[slint.ListModel[int]] = slint.ListModel([1, 2, 3])\n assert model\n assert model.row_count() == 3\n\n test_value = instance.get_property(\"test-value\")\n test_value.data = model\n model = None\n # test_value as a struct should hold a strong reference to the model field within\n gc.collect()\n assert test_value.data.row_count() == 3\n\n\ndef test_properties_gc() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export component Test {\n in-out property <[int]> test-value;\n }\n \"\"\",\n Path(\"\"),\n ).component(\"Test\")\n assert compdef is not None\n\n instance: native.ComponentInstance | None = compdef.create()\n assert instance is not None\n\n model: typing.Optional[slint.ListModel[int]] = slint.ListModel([1, 2, 3])\n assert model\n assert model.row_count() == 3\n\n instance.set_property(\"test-value\", model)\n model = None\n gc.collect()\n assert instance.get_property(\"test-value\").row_count() == 3\n" }, { "path": "api/python/slint/tests/test_image.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport slint\nimport numpy as np\nfrom PIL import Image\nfrom pathlib import Path\n\n\ndef base_dir() -> Path:\n assert __spec__\n origin = __spec__.origin\n assert origin is not None\n base_dir = Path(origin).parent\n assert base_dir is not None\n return base_dir\n\n\ndef test_image_loading() -> None:\n image = Image.open(\n base_dir() / \"..\" / \"..\" / \"..\" / \"..\" / \"logo\" / \"slint-logo-simple-dark.png\"\n )\n assert image.size == (282, 84)\n array = np.array(image)\n slint_image = slint.Image.load_from_array(array)\n assert slint_image.width == 282\n assert slint_image.height == 84\n" }, { "path": "api/python/slint/tests/test_instance.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport pytest\nfrom slint import slint as native\nfrom slint.slint import Image, Color, Brush\nimport os\nfrom pathlib import Path\n\n\ndef test_property_access() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export global TestGlobal {\n in property theglobalprop: \"Hey\";\n callback globallogic();\n }\n\n export struct MyStruct {\n title: string,\n finished: bool,\n dash-prop: bool,\n }\n\n export component Test {\n in property strprop: \"Hello\";\n in property intprop: 42;\n in property floatprop: 100;\n in property boolprop: true;\n in property imgprop;\n in property brushprop: Colors.rgb(255, 0, 255);\n in property colprop: Colors.rgb(0, 255, 0);\n in property <[string]> modelprop;\n in property structprop: {\n title: \"builtin\",\n finished: true,\n dash-prop: true,\n };\n in property imageprop: @image-url(\"../../../../demos/printerdemo/ui/images/cat.jpg\");\n\n callback test-callback();\n }\n \"\"\",\n Path(__file__).parent / \"main.slint\",\n ).component(\"Test\")\n assert compdef is not None\n\n instance = compdef.create()\n assert instance is not None\n\n with pytest.raises(ValueError, match=\"no such property\"):\n instance.set_property(\"nonexistent\", 42)\n\n assert instance.get_property(\"strprop\") == \"Hello\"\n instance.set_property(\"strprop\", \"World\")\n assert instance.get_property(\"strprop\") == \"World\"\n with pytest.raises(ValueError, match=\"wrong type\"):\n instance.set_property(\"strprop\", 42)\n\n assert instance.get_property(\"intprop\") == 42\n instance.set_property(\"intprop\", 100)\n assert instance.get_property(\"intprop\") == 100\n with pytest.raises(ValueError, match=\"wrong type\"):\n instance.set_property(\"intprop\", False)\n\n assert instance.get_property(\"floatprop\") == 100\n instance.set_property(\"floatprop\", 42)\n assert instance.get_property(\"floatprop\") == 42\n with pytest.raises(ValueError, match=\"wrong type\"):\n instance.set_property(\"floatprop\", \"Blah\")\n\n assert instance.get_property(\"boolprop\")\n instance.set_property(\"boolprop\", False)\n assert not instance.get_property(\"boolprop\")\n with pytest.raises(ValueError, match=\"wrong type\"):\n instance.set_property(\"boolprop\", 0)\n\n structval = instance.get_property(\"structprop\")\n assert isinstance(structval, native.PyStruct)\n assert structval.title == \"builtin\"\n assert structval.finished\n assert structval.dash_prop\n instance.set_property(\n \"structprop\", {\"title\": \"new\", \"finished\": False, \"dash_prop\": False}\n )\n structval = instance.get_property(\"structprop\")\n assert structval.title == \"new\"\n assert not structval.finished\n assert not structval.dash_prop\n\n imageval = instance.get_property(\"imageprop\")\n assert imageval.width == 320\n assert imageval.height == 480\n assert \"cat.jpg\" in imageval.path.name\n\n with pytest.raises(RuntimeError, match=\"The image cannot be loaded\"):\n Image.load_from_path(\"non-existent.png\")\n\n instance.set_property(\n \"imageprop\",\n Image.load_from_path(\n os.path.join(\n os.path.dirname(__file__),\n \"../../../../examples/iot-dashboard/images/humidity.png\",\n )\n ),\n )\n imageval = instance.get_property(\"imageprop\")\n assert imageval.size == (36, 36)\n assert \"humidity.png\" in str(imageval.path)\n\n with pytest.raises(TypeError, match=\"'int' object is not an instance of 'str'\"):\n instance.set_property(\"structprop\", {42: \"wrong\"})\n\n brushval = instance.get_property(\"brushprop\")\n assert str(brushval.color) == \"argb(255, 255, 0, 255)\"\n instance.set_property(\"brushprop\", Brush(Color(\"rgb(128, 128, 128)\")))\n brushval = instance.get_property(\"brushprop\")\n assert str(brushval.color) == \"argb(255, 128, 128, 128)\"\n\n brushval = instance.get_property(\"colprop\")\n assert str(brushval.color) == \"argb(255, 0, 255, 0)\"\n instance.set_property(\"colprop\", Color(\"rgb(128, 128, 128)\"))\n brushval = instance.get_property(\"colprop\")\n assert str(brushval.color) == \"argb(255, 128, 128, 128)\"\n\n with pytest.raises(ValueError, match=\"no such property\"):\n instance.set_global_property(\"nonexistent\", \"theglobalprop\", 42)\n with pytest.raises(ValueError, match=\"no such property\"):\n instance.set_global_property(\"TestGlobal\", \"nonexistent\", 42)\n\n assert instance.get_global_property(\"TestGlobal\", \"theglobalprop\") == \"Hey\"\n instance.set_global_property(\"TestGlobal\", \"theglobalprop\", \"Ok\")\n assert instance.get_global_property(\"TestGlobal\", \"theglobalprop\") == \"Ok\"\n\n\ndef test_callbacks() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export global TestGlobal {\n callback globallogic(string) -> string;\n globallogic(value) => {\n return \"global \" + value;\n }\n }\n\n export component Test {\n callback test-callback(string) -> string;\n test-callback(value) => {\n return \"local \" + value;\n }\n callback void-callback();\n }\n \"\"\",\n Path(\"\"),\n ).component(\"Test\")\n assert compdef is not None\n\n instance = compdef.create()\n assert instance is not None\n\n assert instance.invoke(\"test-callback\", \"foo\") == \"local foo\"\n\n assert instance.invoke_global(\"TestGlobal\", \"globallogic\", \"foo\") == \"global foo\"\n\n with pytest.raises(RuntimeError, match=\"no such callback\"):\n instance.set_callback(\"non-existent\", lambda x: x)\n\n instance.set_callback(\"test-callback\", lambda x: \"python \" + x)\n assert instance.invoke(\"test-callback\", \"foo\") == \"python foo\"\n\n with pytest.raises(RuntimeError, match=\"no such callback\"):\n instance.set_global_callback(\"TestGlobal\", \"non-existent\", lambda x: x)\n\n instance.set_global_callback(\n \"TestGlobal\", \"globallogic\", lambda x: \"python global \" + x\n )\n assert (\n instance.invoke_global(\"TestGlobal\", \"globallogic\", \"foo\")\n == \"python global foo\"\n )\n\n instance.set_callback(\"void-callback\", lambda: None)\n instance.invoke(\"void-callback\")\n\n\nif __name__ == \"__main__\":\n import slint\n\n module = slint.load_file(Path(\"../../../demos/printerdemo/ui/printerdemo.slint\"))\n instance = module.MainWindow()\n instance.PrinterQueue.start_job = lambda title: print(f\"new print job {title}\")\n instance.run()\n" }, { "path": "api/python/slint/tests/test_invoke_from_event_loop.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import slint as native\nimport threading\nfrom datetime import timedelta\n\nwas_here = False\n\n\ndef test_threads() -> None:\n global was_here\n was_here = False\n\n def invoked_from_event_loop() -> None:\n global was_here\n was_here = True\n native.quit_event_loop()\n\n def quit() -> None:\n native.invoke_from_event_loop(invoked_from_event_loop)\n\n thr = threading.Thread(target=quit)\n native.Timer.single_shot(timedelta(milliseconds=10), lambda: thr.start())\n fallback_timer = native.Timer()\n fallback_timer.start(\n native.TimerMode.Repeated, timedelta(milliseconds=100), native.quit_event_loop\n )\n native.run_event_loop()\n thr.join()\n fallback_timer.stop()\n assert was_here\n" }, { "path": "api/python/slint/tests/test_load_file.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport pytest\nfrom slint import load_file, CompileError\nfrom pathlib import Path\n\n\ndef base_dir() -> Path:\n assert __spec__\n origin = __spec__.origin\n assert origin is not None\n base_dir = Path(origin).parent\n assert base_dir is not None\n return base_dir\n\n\ndef test_load_file(caplog: pytest.LogCaptureFixture) -> None:\n module = load_file(base_dir() / \"test-load-file.slint\", quiet=False)\n\n assert (\n \"The property 'color' has been deprecated. Please use 'background' instead\"\n in caplog.text\n )\n\n assert len(list(module.__dict__.keys())) == 7\n assert \"App\" in module.__dict__\n assert \"Diag\" in module.__dict__\n assert \"MyDiag\" in module.__dict__\n assert \"MyData\" in module.__dict__\n assert \"Secret_Struct\" in module.__dict__\n assert \"Public_Struct\" in module.__dict__\n assert \"TestEnum\" in module.__dict__\n instance = module.App()\n del instance\n instance = module.MyDiag()\n del instance\n\n struct_instance = module.MyData()\n struct_instance.name = \"Test\"\n struct_instance.age = 42\n\n struct_instance = module.MyData(name=\"testing\")\n assert struct_instance.name == \"testing\"\n\n assert module.Public_Struct is module.Secret_Struct\n assert module.MyDiag is module.Diag\n\n\ndef test_load_file_fail() -> None:\n with pytest.raises(CompileError, match=\"Could not compile non-existent.slint\"):\n load_file(\"non-existent.slint\")\n\n\ndef test_compile_error() -> None:\n with pytest.raises(CompileError) as excinfo:\n load_file(base_dir() / \"test-file-error.slint\")\n err = excinfo.value\n diagnostics = err.diagnostics\n assert len(diagnostics) == 2\n assert diagnostics[0].message == \"Unknown type 'garbage'\"\n assert diagnostics[0].line_number == 6\n assert diagnostics[0].column_number == 15\n assert diagnostics[1].message == \"Unknown element 'NewType'\"\n assert diagnostics[1].line_number == 7\n assert diagnostics[1].column_number == 5\n path = base_dir() / \"test-file-error.slint\"\n assert str(err) == f\"Could not compile {path}\"\n assert len(err.__notes__) == 2\n assert err.__notes__[0] == f\"{path}:6: Unknown type 'garbage'\"\n assert err.__notes__[1] == f\"{path}:7: Unknown element 'NewType'\"\n\n\ndef test_load_file_wrapper() -> None:\n module = load_file(base_dir() / \"test-load-file.slint\", quiet=False)\n\n instance = module.App()\n\n assert instance.hello == \"World\"\n instance.hello = \"Ok\"\n assert instance.hello == \"Ok\"\n\n instance.say_hello = lambda x: \"from here: \" + x\n assert instance.say_hello(\"wohoo\") == \"from here: wohoo\"\n\n assert instance.plus_one(42) == 43\n\n assert instance.MyGlobal.global_prop == \"This is global\"\n\n assert instance.MyGlobal.minus_one(100) == 99\n\n assert instance.SecondGlobal.second == \"second\"\n\n del instance\n\n\ndef test_constructor_kwargs() -> None:\n module = load_file(base_dir() / \"test-load-file.slint\", quiet=False)\n\n def early_say_hello(arg: str) -> str:\n return \"early:\" + arg\n\n instance = module.App(hello=\"Set early\", say_hello=early_say_hello)\n\n assert instance.hello == \"Set early\"\n assert instance.invoke_say_hello(\"test\") == \"early:test\"\n\n del instance\n" }, { "path": "api/python/slint/tests/test_loader.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import loader\nimport sys\nimport os\n\n\ndef test_magic_import() -> None:\n instance = loader.test_load_file.App()\n del instance\n\n\ndef test_magic_import_path() -> None:\n oldsyspath = sys.path\n assert loader.printerdemo is None\n try:\n sys.path.append(os.path.join(os.path.dirname(__file__), \"..\", \"..\", \"..\", \"..\"))\n instance = loader.demos.printerdemo.ui.printerdemo.MainWindow()\n del instance\n finally:\n sys.path = oldsyspath\n" }, { "path": "api/python/slint/tests/test_loop.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport slint\nfrom slint import slint as native\nfrom datetime import timedelta\nimport pytest\nimport sys\n\n\ndef test_sysexit_exception() -> None:\n def call_sys_exit() -> None:\n sys.exit(42)\n\n slint.Timer.single_shot(timedelta(milliseconds=100), call_sys_exit)\n with pytest.raises(SystemExit) as exc_info:\n native.run_event_loop()\n assert (\n \"unexpected failure running python singleshot timer callback\"\n in exc_info.value.__notes__\n )\n" }, { "path": "api/python/slint/tests/test_models.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import slint as native\nfrom slint import models as models\nimport typing\nfrom pathlib import Path\n\n\ndef test_model_notify() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export component App {\n width: 300px;\n height: 300px;\n\n out property layout-height: layout.height;\n in-out property<[length]> fixed-height-model;\n\n VerticalLayout {\n alignment: start;\n\n layout := VerticalLayout {\n for fixed-height in fixed-height-model: Rectangle {\n background: blue;\n height: fixed-height;\n }\n }\n }\n\n }\n \"\"\",\n Path(\"\"),\n ).component(\"App\")\n assert compdef is not None\n\n instance = compdef.create()\n assert instance is not None\n\n model = models.ListModel([100, 0])\n\n instance.set_property(\"fixed-height-model\", model)\n\n assert instance.get_property(\"layout-height\") == 100\n model.set_row_data(1, 50)\n assert instance.get_property(\"layout-height\") == 150\n model.append(75)\n assert instance.get_property(\"layout-height\") == 225\n del model[1:]\n assert instance.get_property(\"layout-height\") == 100\n\n assert isinstance(instance.get_property(\"fixed-height-model\"), models.ListModel)\n\n\ndef test_model_from_list() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export component App {\n in-out property<[int]> data: [1, 2, 3, 4];\n }\n \"\"\",\n Path(\"\"),\n ).component(\"App\")\n assert compdef is not None\n\n instance = compdef.create()\n assert instance is not None\n\n model = instance.get_property(\"data\")\n assert model.row_count() == 4\n assert model.row_data(2) == 3\n\n instance.set_property(\"data\", models.ListModel([0]))\n instance.set_property(\"data\", model)\n assert list(instance.get_property(\"data\")) == [1, 2, 3, 4]\n\n\ndef test_python_model_sequence() -> None:\n model = models.ListModel([1, 2, 3, 4, 5])\n\n assert len(model) == 5\n assert list(model) == [1, 2, 3, 4, 5]\n model[0] = 100\n assert list(model) == [100, 2, 3, 4, 5]\n assert model[2] == 3\n\n\ndef test_python_model_iterable() -> None:\n def test_generator(max: int) -> typing.Iterator[int]:\n i = 0\n while i < max:\n yield i\n i += 1\n\n model = models.ListModel(test_generator(5))\n\n assert len(model) == 5\n assert list(model) == [0, 1, 2, 3, 4]\n\n\ndef test_rust_model_sequence() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export component App {\n in-out property<[int]> data: [1, 2, 3, 4, 5];\n }\n \"\"\",\n Path(\"\"),\n ).component(\"App\")\n assert compdef is not None\n\n instance = compdef.create()\n assert instance is not None\n\n model = instance.get_property(\"data\")\n\n assert len(model) == 5\n assert list(model) == [1, 2, 3, 4, 5]\n assert model[2] == 3\n\n\ndef test_model_writeback() -> None:\n compiler = native.Compiler()\n\n compdef = compiler.build_from_source(\n \"\"\"\n export component App {\n width: 300px;\n height: 300px;\n\n in-out property<[int]> model;\n callback write-to-model(int, int);\n write-to-model(index, value) => {\n self.model[index] = value\n }\n\n }\n \"\"\",\n Path(\"\"),\n ).component(\"App\")\n assert compdef is not None\n\n instance = compdef.create()\n assert instance is not None\n\n model = models.ListModel([100, 0])\n\n instance.set_property(\"model\", model)\n\n instance.invoke(\"write-to-model\", 1, 42)\n assert list(instance.get_property(\"model\")) == [100, 42]\n instance.invoke(\"write-to-model\", 0, 25)\n assert list(instance.get_property(\"model\")) == [25, 42]\n" }, { "path": "api/python/slint/tests/test_named_tuples.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nimport pytest\nfrom slint.language import StandardListViewItem, KeyboardModifiers\n\n\nNAMED_TUPLES = [\n (StandardListViewItem, {\"text\": \"\"}),\n (\n KeyboardModifiers,\n {\"shift\": False, \"control\": False, \"alt\": False, \"meta\": False},\n ),\n]\n\n\n@pytest.fixture(params=NAMED_TUPLES, ids=lambda t: t[0].__name__)\ndef named_tuple_info(request):\n return request.param\n\n\ndef test_is_tuple_subclass(named_tuple_info):\n cls, _ = named_tuple_info\n assert issubclass(cls, tuple)\n\n\ndef test_default_values(named_tuple_info):\n cls, defaults = named_tuple_info\n instance = cls()\n for field, expected in defaults.items():\n assert getattr(instance, field) == expected\n\n\ndef test_instance_is_tuple(named_tuple_info):\n cls, _ = named_tuple_info\n assert isinstance(cls(), tuple)\n\n\ndef test_asdict(named_tuple_info):\n cls, defaults = named_tuple_info\n d = cls()._asdict()\n assert isinstance(d, dict)\n for field in defaults:\n assert field in d\n\n\ndef test_has_docstring(named_tuple_info):\n cls, _ = named_tuple_info\n assert cls.__doc__ is not None\n assert len(cls.__doc__) > 0\n\n\ndef test_fields_attribute(named_tuple_info):\n cls, defaults = named_tuple_info\n assert hasattr(cls, \"_fields\")\n assert set(cls._fields) == set(defaults.keys())\n\n\ndef test_keyword_init(named_tuple_info):\n cls, defaults = named_tuple_info\n first_field = next(iter(defaults))\n instance = cls(**{first_field: defaults[first_field]})\n assert getattr(instance, first_field) == defaults[first_field]\n\n\ndef test_replace(named_tuple_info):\n cls, defaults = named_tuple_info\n instance = cls()\n first_field = next(iter(defaults))\n replaced = instance._replace(**{first_field: defaults[first_field]})\n assert getattr(replaced, first_field) == defaults[first_field]\n\n\ndef test_StandardListViewItem() -> None:\n item = StandardListViewItem()\n assert item.text == \"\"\n item = item._replace(text=\"Test\")\n assert item.text == \"Test\"\n\n\ndef test_KeyboardModifiers() -> None:\n # Test initialization with default values\n mods = KeyboardModifiers()\n assert mods.shift is False\n assert mods.control is False\n assert mods.alt is False\n assert mods.meta is False\n\n # Test initialization with arguments\n mods = KeyboardModifiers(shift=True, control=True, alt=True, meta=True)\n assert mods.shift is True\n assert mods.control is True\n assert mods.alt is True\n assert mods.meta is True\n\n # Test setters (_replace for NamedTuple)\n mods = mods._replace(shift=False)\n assert mods.shift is False\n mods = mods._replace(control=False)\n assert mods.control is False\n mods = mods._replace(alt=False)\n assert mods.alt is False\n mods = mods._replace(meta=False)\n assert mods.meta is False\n\n # Test equality\n mods2 = KeyboardModifiers()\n assert mods == mods2\n mods3 = mods2._replace(shift=True)\n assert mods2 != mods3\n" }, { "path": "api/python/slint/tests/test_timers.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import slint as native\nfrom datetime import timedelta\n\ncounter: int\n\n\ndef test_timer() -> None:\n global counter\n counter = 0\n\n def quit_after_two_invocations() -> None:\n global counter\n counter = min(counter + 1, 2)\n if counter == 2:\n native.quit_event_loop()\n\n test_timer = native.Timer()\n test_timer.start(\n native.TimerMode.Repeated,\n timedelta(milliseconds=100),\n quit_after_two_invocations,\n )\n native.run_event_loop()\n test_timer.stop()\n assert counter == 2\n\n\ndef test_single_shot() -> None:\n native.Timer.single_shot(timedelta(milliseconds=100), native.quit_event_loop)\n native.run_event_loop()\n" }, { "path": "api/python/slint/tests/test_translations.py", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nfrom slint import load_file, init_translations\nfrom pathlib import Path\nimport gettext\nimport typing\n\n\ndef base_dir() -> Path:\n assert __spec__\n origin = __spec__.origin\n assert origin is not None\n base_dir = Path(origin).parent\n assert base_dir is not None\n return base_dir\n\n\nclass DummyTranslation:\n def gettext(self, message: str) -> str:\n if message == \"Yes\":\n return \"Ja\"\n return message\n\n def pgettext(self, context: str, message: str) -> str:\n return self.gettext(message)\n\n\ndef test_load_file() -> None:\n module = load_file(base_dir() / \"test-load-file.slint\")\n\n testcase = module.App()\n\n assert testcase.translated == \"Yes\"\n init_translations(typing.cast(gettext.GNUTranslations, DummyTranslation()))\n try:\n assert testcase.translated == \"Ja\"\n finally:\n init_translations(None)\n assert testcase.translated == \"Yes\"\n" }, { "path": "api/python/slint/thirdparty.hbs", "content": "\n\n\n\n\n\n\n\n \n\n\n\n
\n
\n

Third Party Licenses

\n

This page lists the licenses of the dependencies used by Slint.

\n
\n\n

Overview of licenses:

\n
    \n {{#each overview}}\n
  • {{name}} ({{count}})
    • \n {{/each}}\n
\n\n

All license text:

\n
    \n {{#each licenses}}\n
  • \n

    {{name}}

    \n

    Used by:

    \n
      \n {{#each used_by}}\n
    • {{crate.name}}\n {{crate.version}}
      • \n {{/each}}\n
    \n 
    {{text}}
    \n
    • \n {{/each}}\n
\n
\n\n\n\n" }, { "path": "api/python/slint/timer.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse pyo3::prelude::*;\nuse pyo3_stub_gen::{\n derive::gen_stub_pyclass, derive::gen_stub_pyclass_enum, derive::gen_stub_pymethods,\n};\n\n/// The TimerMode specifies what should happen after the timer fired.\n///\n/// Used by the `Timer.start()` function.\n#[derive(Copy, Clone, PartialEq)]\n#[gen_stub_pyclass_enum]\n#[pyclass(name = \"TimerMode\", eq, eq_int, from_py_object)]\npub enum PyTimerMode {\n /// A SingleShot timer is fired only once.\n SingleShot,\n /// A Repeated timer is fired repeatedly until it is stopped or dropped.\n Repeated,\n}\n\nimpl From for i_slint_core::timers::TimerMode {\n fn from(value: PyTimerMode) -> Self {\n match value {\n PyTimerMode::SingleShot => i_slint_core::timers::TimerMode::SingleShot,\n PyTimerMode::Repeated => i_slint_core::timers::TimerMode::Repeated,\n }\n }\n}\n\n/// Timer is a handle to the timer system that triggers a callback after a specified\n/// period of time.\n///\n/// Use `Timer.start()` to create a timer that that repeatedly triggers a callback, or\n/// `Timer.single_shot()` to trigger a callback only once.\n///\n/// The timer will automatically stop when garbage collected. You must keep the Timer object\n/// around for as long as you want the timer to keep firing.\n///\n/// ```python\n/// class AppWindow(...)\n/// def __init__(self):\n/// super().__init__()\n/// self.my_timer = None\n///\n/// @slint.callback\n/// def button_clicked(self):\n/// self.my_timer = slint.Timer()\n/// self.my_timer.start(timedelta(seconds=1), self.do_something)\n///\n/// def do_something(self):\n/// pass\n/// ```\n///\n/// Timers can only be used in the thread that runs the Slint event loop. They don't\n/// fire if used in another thread.\n#[gen_stub_pyclass]\n#[pyclass(name = \"Timer\", unsendable)]\npub struct PyTimer {\n timer: i_slint_core::timers::Timer,\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl PyTimer {\n #[new]\n fn py_new() -> Self {\n PyTimer { timer: Default::default() }\n }\n\n /// Starts the timer with the given mode and interval, in order for the callback to called when the\n /// timer fires. If the timer has been started previously and not fired yet, then it will be restarted.\n ///\n /// Arguments:\n /// * `mode`: The timer mode to apply, i.e. whether to repeatedly fire the timer or just once.\n /// * `interval`: The duration from now until when the timer should firethe first time, and subsequently\n /// for `TimerMode.Repeated` timers.\n /// * `callback`: The function to call when the time has been reached or exceeded.\n fn start(\n &self,\n mode: PyTimerMode,\n interval: chrono::Duration,\n callback: Py,\n ) -> PyResult<()> {\n let interval = interval\n .to_std()\n .map_err(|e| pyo3::exceptions::PyValueError::new_err(e.to_string()))?;\n self.timer.start(mode.into(), interval, move || {\n Python::attach(|py| {\n if let Err(err) = callback.call0(py) {\n crate::handle_unraisable(\n py,\n \"unexpected failure running python timer callback\".into(),\n err,\n );\n }\n });\n });\n Ok(())\n }\n\n /// Starts the timer with the duration and the callback to called when the\n /// timer fires. It is fired only once and then deleted.\n ///\n /// Arguments:\n /// * `duration`: The duration from now until when the timer should fire.\n /// * `callback`: The function to call when the time has been reached or exceeded.\n #[staticmethod]\n fn single_shot(duration: chrono::Duration, callback: Py) -> PyResult<()> {\n let duration = duration\n .to_std()\n .map_err(|e| pyo3::exceptions::PyValueError::new_err(e.to_string()))?;\n i_slint_core::timers::Timer::single_shot(duration, move || {\n Python::attach(|py| {\n if let Err(err) = callback.call0(py) {\n crate::handle_unraisable(\n py,\n \"unexpected failure running python singleshot timer callback\".into(),\n err,\n );\n }\n });\n });\n Ok(())\n }\n\n /// Stops the previously started timer. Does nothing if the timer has never been started.\n fn stop(&self) {\n self.timer.stop();\n }\n\n /// Restarts the timer. If the timer was previously started by calling `Timer.start()`\n /// with a duration and callback, then the time when the callback will be next invoked\n /// is re-calculated to be in the specified duration relative to when this function is called.\n ///\n /// Does nothing if the timer was never started.\n fn restart(&self) {\n self.timer.restart();\n }\n\n /// Set to true if the timer is running; false otherwise.\n #[getter]\n fn running(&self) -> bool {\n self.timer.running()\n }\n\n /// The duration of timer.\n ///\n /// When setting this property and the timer is running (see `Timer.running`),\n /// then the time when the callback will be next invoked is re-calculated to be in the\n /// specified duration relative to when this property is set.\n #[setter]\n fn set_interval(&self, interval: chrono::Duration) -> PyResult<()> {\n let interval = interval\n .to_std()\n .map_err(|e| pyo3::exceptions::PyValueError::new_err(e.to_string()))?;\n self.timer.set_interval(interval);\n Ok(())\n }\n\n #[getter]\n fn interval(&self) -> core::time::Duration {\n self.timer.interval()\n }\n}\n" }, { "path": "api/python/slint/value.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse i_slint_compiler::generator::python::ident;\nuse pyo3::types::PyDict;\nuse pyo3::{IntoPyObjectExt, PyTraverseError};\nuse pyo3::{PyVisit, prelude::*};\nuse pyo3_stub_gen::{derive::gen_stub_pyclass, derive::gen_stub_pymethods};\n\nuse std::cell::OnceCell;\nuse std::collections::HashMap;\nuse std::rc::Rc;\n\nuse i_slint_compiler::langtype::Type;\n\nuse i_slint_core::model::{Model, ModelRc};\n\n#[gen_stub_pyclass]\npub struct SlintToPyValue {\n pub slint_value: slint_interpreter::Value,\n pub type_collection: TypeCollection,\n}\n\nimpl<'py> IntoPyObject<'py> for SlintToPyValue {\n type Target = PyAny;\n type Output = Bound<'py, Self::Target>;\n type Error = PyErr;\n\n fn into_pyobject(self, py: Python<'py>) -> Result {\n let type_collection = self.type_collection;\n use slint_interpreter::Value;\n match self.slint_value {\n Value::Void => ().into_bound_py_any(py),\n Value::Number(num) => num.into_bound_py_any(py),\n Value::String(str) => str.into_bound_py_any(py),\n Value::Bool(b) => b.into_bound_py_any(py),\n Value::Image(image) => crate::image::PyImage::from(image).into_bound_py_any(py),\n Value::Model(model) => crate::models::PyModelShared::rust_into_py_model(&model, py)\n .map_or_else(\n || type_collection.model_to_py(&model).into_bound_py_any(py),\n |m| Ok(m),\n ),\n Value::Struct(structval) => {\n type_collection.struct_to_py(structval).into_bound_py_any(py)\n }\n Value::Brush(brush) => crate::brush::PyBrush::from(brush).into_bound_py_any(py),\n Value::EnumerationValue(enum_name, enum_value) => {\n type_collection.enum_to_py(&enum_name, &enum_value, py)?.into_bound_py_any(py)\n }\n Value::Keys(keys) => format!(\"{keys:?}\").into_bound_py_any(py),\n v @ _ => {\n eprintln!(\n \"Python: conversion from slint to python needed for {v:#?} and not implemented yet\"\n );\n ().into_bound_py_any(py)\n }\n }\n }\n}\n\npub fn traverse_value(\n value: &slint_interpreter::Value,\n visit: &PyVisit<'_>,\n) -> Result<(), PyTraverseError> {\n match value {\n slint_interpreter::Value::Model(model) => {\n if let Some(rust_model) = model.as_any().downcast_ref::()\n {\n rust_model.__traverse__(&visit)?\n }\n }\n slint_interpreter::Value::Struct(structval) => traverse_struct(&structval, visit)?,\n _ => {}\n }\n\n Ok(())\n}\n\nfn traverse_struct(\n structval: &slint_interpreter::Struct,\n visit: &PyVisit<'_>,\n) -> Result<(), PyTraverseError> {\n for (_, value) in structval.iter() {\n traverse_value(value, visit)?;\n }\n Ok(())\n}\n\npub fn clear_strongrefs_in_value(value: &slint_interpreter::Value) {\n match value {\n slint_interpreter::Value::Model(model) => {\n if let Some(rust_model) = model.as_any().downcast_ref::()\n {\n rust_model.__clear__();\n }\n }\n slint_interpreter::Value::Struct(structval) => clear_strongrefs_in_struct(&structval),\n _ => {}\n }\n}\n\nfn clear_strongrefs_in_struct(structval: &slint_interpreter::Struct) {\n for (_, value) in structval.iter() {\n clear_strongrefs_in_value(value);\n }\n}\n\n#[gen_stub_pyclass]\n#[pyclass(subclass, unsendable, skip_from_py_object)]\n#[derive(Clone)]\npub struct PyStruct {\n pub data: slint_interpreter::Struct,\n pub type_collection: TypeCollection,\n}\n\n#[pymethods]\nimpl PyStruct {\n fn __getattr__(&self, key: &str) -> PyResult {\n self.data.get_field(key).map_or_else(\n || {\n Err(pyo3::exceptions::PyAttributeError::new_err(format!(\n \"Python: No such field {key} on PyStruct\"\n )))\n },\n |value| Ok(self.type_collection.to_py_value(value.clone())),\n )\n }\n fn __setattr__(&mut self, py: Python<'_>, key: String, value: Py) -> PyResult<()> {\n let pv =\n TypeCollection::slint_value_from_py_value(py, &value, Some(&self.type_collection))?;\n self.data.set_field(key, pv);\n Ok(())\n }\n\n fn __iter__(slf: PyRef<'_, Self>) -> PyStructFieldIterator {\n PyStructFieldIterator {\n inner: slf\n .data\n .iter()\n .map(|(name, val)| (name.to_string(), val.clone()))\n .collect::>()\n .into_iter(),\n type_collection: slf.type_collection.clone(),\n }\n }\n\n fn __copy__(&self) -> Self {\n self.clone()\n }\n\n fn __traverse__(&self, visit: PyVisit<'_>) -> Result<(), PyTraverseError> {\n traverse_struct(&self.data, &visit)\n }\n\n fn __clear__(&mut self) {\n for (_, value) in self.data.iter() {\n clear_strongrefs_in_value(&value);\n }\n }\n}\n\n#[gen_stub_pyclass]\n#[pyclass(unsendable)]\nstruct PyStructFieldIterator {\n inner: std::collections::hash_map::IntoIter,\n type_collection: TypeCollection,\n}\n\n#[gen_stub_pymethods]\n#[pymethods]\nimpl PyStructFieldIterator {\n fn __iter__(slf: PyRef<'_, Self>) -> PyRef<'_, Self> {\n slf\n }\n\n fn __next__(mut slf: PyRefMut<'_, Self>) -> Option<(String, SlintToPyValue)> {\n slf.inner.next().map(|(name, val)| (name, slf.type_collection.to_py_value(val)))\n }\n}\n\nthread_local! {\n static ENUM_CLASS: OnceCell> = OnceCell::new();\n}\n\npub fn enum_class(py: Python) -> Py {\n ENUM_CLASS.with(|cls| {\n cls.get_or_init(|| -> Py {\n let enum_module = py.import(\"enum\").unwrap();\n enum_module.getattr(\"Enum\").unwrap().into()\n })\n .clone_ref(py)\n })\n}\n\n#[derive(Clone)]\n/// Struct that knows about the enums (and maybe other types) exported by\n/// a `.slint` file loaded with load_file. This is used to map enums\n/// provided by Slint to the correct python enum classes.\npub struct TypeCollection {\n enum_classes: Rc>>,\n}\n\nimpl TypeCollection {\n pub fn new(result: &slint_interpreter::CompilationResult, py: Python<'_>) -> Self {\n let mut enum_classes = HashMap::new();\n\n let enum_ctor = crate::value::enum_class(py);\n\n for struct_or_enum in result.structs_and_enums(i_slint_core::InternalToken {}) {\n match struct_or_enum {\n Type::Enumeration(en) => {\n let enum_type = enum_ctor\n .call(\n py,\n (\n en.name.to_string(),\n en.values\n .iter()\n .map(|val| (ident(&val).to_string(), val.to_string()))\n .collect::>(),\n ),\n None,\n )\n .unwrap();\n\n enum_classes.insert(ident(&en.name).into(), enum_type);\n }\n _ => {}\n }\n }\n\n let enum_classes = Rc::new(enum_classes);\n Self { enum_classes }\n }\n\n pub fn to_py_value(&self, value: slint_interpreter::Value) -> SlintToPyValue {\n SlintToPyValue { slint_value: value, type_collection: self.clone() }\n }\n\n pub fn struct_to_py(&self, s: slint_interpreter::Struct) -> PyStruct {\n PyStruct { data: s, type_collection: self.clone() }\n }\n\n pub fn enum_to_py(\n &self,\n enum_name: &str,\n enum_value: &str,\n py: Python<'_>,\n ) -> Result, PyErr> {\n let enum_cls = self.enum_classes.get(ident(enum_name).as_str()).ok_or_else(|| {\n PyErr::new::(format!(\n \"Slint provided enum {enum_name} is unknown\"\n ))\n })?;\n enum_cls.getattr(py, enum_value)\n }\n\n pub fn model_to_py(\n &self,\n model: &ModelRc,\n ) -> crate::models::ReadOnlyRustModel {\n crate::models::ReadOnlyRustModel { model: model.clone(), type_collection: self.clone() }\n }\n\n pub fn enums(&self) -> impl Iterator)> {\n self.enum_classes.iter()\n }\n\n pub fn slint_value_from_py_value(\n py: Python<'_>,\n ob: &Py,\n type_collection: Option<&Self>,\n ) -> PyResult {\n Self::slint_value_from_py_value_bound(&ob.bind(py), type_collection)\n }\n\n pub fn slint_value_from_py_value_bound(\n ob: &Bound<'_, PyAny>,\n type_collection: Option<&Self>,\n ) -> PyResult {\n if ob.is_none() {\n return Ok(slint_interpreter::Value::Void);\n }\n\n let interpreter_val = ob\n .extract::()\n .map(|b| slint_interpreter::Value::Bool(b))\n .or_else(|_| {\n ob.extract::<&'_ str>().map(|s| slint_interpreter::Value::String(s.into()))\n })\n .or_else(|_| ob.extract::().map(|num| slint_interpreter::Value::Number(num)))\n .or_else(|_| {\n ob.extract::>()\n .map(|pyimg| slint_interpreter::Value::Image(pyimg.image.clone()))\n })\n .or_else(|_| {\n ob.extract::>()\n .map(|pybrush| slint_interpreter::Value::Brush(pybrush.brush.clone()))\n })\n .or_else(|_| {\n ob.extract::>()\n .map(|pycolor| slint_interpreter::Value::Brush(pycolor.color.clone().into()))\n })\n .or_else(|_| {\n ob.extract::>().map(|pymodel| {\n slint_interpreter::Value::Model(Self::apply(\n type_collection,\n pymodel.as_model(),\n ))\n })\n })\n .or_else(|_| {\n ob.extract::>().map(|rustmodel| {\n slint_interpreter::Value::Model(Self::apply(\n type_collection,\n rustmodel.model.clone(),\n ))\n })\n })\n .or_else(|_| {\n ob.extract::>().and_then(|pystruct| {\n Ok(slint_interpreter::Value::Struct(pystruct.data.clone()))\n })\n })\n .or_else(|_| {\n ob.is_instance(&enum_class(ob.py()).into_bound(ob.py())).and_then(|r| {\n r.then(|| {\n let enum_name =\n ob.getattr(\"__class__\").and_then(|cls| cls.getattr(\"__name__\"))?;\n let enum_value = ob.getattr(\"name\")?;\n Ok(slint_interpreter::Value::EnumerationValue(\n enum_name.to_string(),\n enum_value.to_string(),\n ))\n })\n .unwrap_or_else(|| {\n Err(PyErr::new::(\n \"Object to convert is not an enum\",\n ))\n })\n })\n })\n .or_else(|_| {\n // Try NamedTuple conversion first, then fall back to direct PyDict cast.\n // NamedTuples (e.g. StandardListViewItem) are tuple subclasses registered\n // as `typing.NamedTuple` in language.rs. We guard with an isinstance(ob, tuple)\n // check to avoid false positives from unrelated types that also have `_asdict`.\n let dict = if ob.is_instance_of::()\n && ob.hasattr(pyo3::intern!(ob.py(), \"_fields\")).unwrap_or(false)\n {\n let asdict = ob.call_method0(pyo3::intern!(ob.py(), \"_asdict\"))?;\n asdict.cast::().cloned().map_err(|e| -> PyErr { e.into() })\n } else {\n ob.cast::().cloned().map_err(|_| {\n pyo3::exceptions::PyTypeError::new_err(\"Object is not a dict or NamedTuple\")\n })\n }?;\n let dict_items: Result, PyErr> = dict\n .iter()\n .map(|(name, pyval)| {\n let name = name.extract::<&str>()?.to_string();\n let slintval =\n Self::slint_value_from_py_value_bound(&pyval, type_collection)?;\n Ok((name, slintval))\n })\n .collect::, PyErr>>();\n Ok::<_, PyErr>(slint_interpreter::Value::Struct(\n slint_interpreter::Struct::from_iter(dict_items?.into_iter()),\n ))\n })?;\n\n Ok(interpreter_val)\n }\n\n fn apply(\n type_collection: Option<&Self>,\n model: ModelRc,\n ) -> ModelRc {\n let Some(type_collection) = type_collection else {\n return model;\n };\n if let Some(rust_model) = model.as_any().downcast_ref::() {\n rust_model.apply_type_collection(type_collection);\n }\n model\n }\n}\n" }, { "path": "api/rs/build/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[package]\nname = \"slint-build\"\ndescription = \"Helper for Slint build script\"\nauthors.workspace = true\nedition = \"2024\"\nhomepage = \"https://slint.rs\"\nkeywords.workspace = true\nlicense.workspace = true\nrepository.workspace = true\nrust-version.workspace = true\nversion.workspace = true\ncategories = [\"gui\", \"rendering::engine\", \"development-tools::build-utils\"]\n\n[lib]\npath = \"lib.rs\"\n\n[features]\ndefault = []\n## Enable the [`CompilerConfiguration::with_sdf_fonts`] function that encodes the font's glyphs as scalable signed distance fields, to reduce the size.\nsdf-fonts = [\"i-slint-compiler/sdf-fonts\"]\n## Enable this feature when building `.slint` libraries.\n## This feature is experimental and may change or be removed in the future,\n## enabling it implies opting out of [semver](https://semver.org).\n## For details of this experiment, see: \nexperimental-module-builds = [\"i-slint-compiler/experimental-library-module\"]\n\n[dependencies]\ni-slint-compiler = { workspace = true, features = [\"default\", \"rust\", \"display-diagnostics\", \"software-renderer\", \"bundle-translations\"] }\n\nspin_on = { workspace = true }\ntoml_edit = { workspace = true }\nderive_more = { workspace = true, features = [\"std\", \"error\"] }\n\n[target.'cfg(target_os = \"linux\")'.dependencies]\n# Workaround cross compiling on linux where here in slint-build we depend on fontique through the software\n# renderer compiler feature but fontconfig's build script find the target library via pkg-config and causes link errors\nfontique = { workspace = true, features = [\"fontconfig-dlopen\"] }\n\n[package.metadata.docs.rs]\nfeatures = [\"sdf-fonts\"]\nrustdoc-args = [\"--generate-link-to-definition\"]\n" }, { "path": "api/rs/build/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n/*!\nThis crate serves as a companion crate of the slint crate.\nIt is meant to allow you to compile the `.slint` files from your `build.rs` script.\n\nThe main entry point of this crate is the [`compile()`] function\n\nThe generated code must be included in your crate by using the `slint::include_modules!()` macro.\n\n## Example\n\nIn your Cargo.toml:\n\n```toml\n[package]\n...\nbuild = \"build.rs\"\n\n[dependencies]\nslint = \"1.15\"\n...\n\n[build-dependencies]\nslint-build = \"1.15\"\n```\n\nIn the `build.rs` file:\n\n```ignore\nfn main() {\n slint_build::compile(\"ui/hello.slint\").unwrap();\n}\n```\n\nThen in your main file\n\n```ignore\nslint::include_modules!();\nfn main() {\n HelloWorld::new().run();\n}\n```\n*/\n#![doc(html_logo_url = \"https://slint.dev/logo/slint-logo-square-light.svg\")]\n#![warn(missing_docs)]\n\n#[cfg(not(feature = \"default\"))]\ncompile_error!(\n \"The feature `default` must be enabled to ensure \\\n forward compatibility with future version of this crate\"\n);\n\nuse std::collections::HashMap;\nuse std::env;\nuse std::io::{BufWriter, Write};\nuse std::path::Path;\n\nuse i_slint_compiler::diagnostics::BuildDiagnostics;\n\n/// Argument of [`CompilerConfiguration::with_default_translation_context()`]\n///\npub use i_slint_compiler::DefaultTranslationContext;\n\n/// The structure for configuring aspects of the compilation of `.slint` markup files to Rust.\n#[derive(Clone)]\npub struct CompilerConfiguration {\n config: i_slint_compiler::CompilerConfiguration,\n}\n\n/// How should the slint compiler embed images and fonts\n///\n/// Parameter of [`CompilerConfiguration::embed_resources()`]\n#[derive(Clone, PartialEq)]\npub enum EmbedResourcesKind {\n /// Paths specified in .slint files are made absolute and the absolute\n /// paths will be used at run-time to load the resources from the file system.\n AsAbsolutePath,\n /// The raw files in .slint files are embedded in the application binary.\n EmbedFiles,\n /// File names specified in .slint files will be loaded by the Slint compiler,\n /// optimized for use with the software renderer and embedded in the application binary.\n EmbedForSoftwareRenderer,\n}\n\nimpl Default for CompilerConfiguration {\n fn default() -> Self {\n Self {\n config: i_slint_compiler::CompilerConfiguration::new(\n i_slint_compiler::generator::OutputFormat::Rust,\n ),\n }\n }\n}\n\nimpl CompilerConfiguration {\n /// Creates a new default configuration.\n pub fn new() -> Self {\n Self::default()\n }\n\n /// Create a new configuration that includes sets the include paths used for looking up\n /// `.slint` imports to the specified vector of paths.\n #[must_use]\n pub fn with_include_paths(self, include_paths: Vec) -> Self {\n let mut config = self.config;\n config.include_paths = include_paths;\n Self { config }\n }\n\n /// Create a new configuration that sets the library paths used for looking up\n /// `@library` imports to the specified map of paths.\n ///\n /// Each library path can either be a path to a `.slint` file or a directory.\n /// If it's a file, the library is imported by its name prefixed by `@` (e.g.\n /// `@example`). The specified file is the only entry-point for the library\n /// and other files from the library won't be accessible from the outside.\n /// If it's a directory, a specific file in that directory must be specified\n /// when importing the library (e.g. `@example/widgets.slint`). This allows\n /// exposing multiple entry-points for a single library.\n ///\n /// Compile `ui/main.slint` and specify an \"example\" library path:\n /// ```rust,no_run\n /// let manifest_dir = std::path::PathBuf::from(std::env::var_os(\"CARGO_MANIFEST_DIR\").unwrap());\n /// let library_paths = std::collections::HashMap::from([(\n /// \"example\".to_string(),\n /// manifest_dir.join(\"third_party/example/ui/lib.slint\"),\n /// )]);\n /// let config = slint_build::CompilerConfiguration::new().with_library_paths(library_paths);\n /// slint_build::compile_with_config(\"ui/main.slint\", config).unwrap();\n /// ```\n ///\n /// Import the \"example\" library in `ui/main.slint`:\n /// ```slint,ignore\n /// import { Example } from \"@example\";\n /// ```\n #[must_use]\n pub fn with_library_paths(self, library_paths: HashMap) -> Self {\n let mut config = self.config;\n config.library_paths = library_paths;\n Self { config }\n }\n\n /// Create a new configuration that selects the style to be used for widgets.\n #[must_use]\n pub fn with_style(self, style: String) -> Self {\n let mut config = self.config;\n config.style = Some(style);\n Self { config }\n }\n\n /// Selects how the resources such as images and font are processed.\n ///\n /// See [`EmbedResourcesKind`]\n #[must_use]\n pub fn embed_resources(self, kind: EmbedResourcesKind) -> Self {\n let mut config = self.config;\n config.embed_resources = match kind {\n EmbedResourcesKind::AsAbsolutePath => {\n i_slint_compiler::EmbedResourcesKind::OnlyBuiltinResources\n }\n EmbedResourcesKind::EmbedFiles => {\n i_slint_compiler::EmbedResourcesKind::EmbedAllResources\n }\n EmbedResourcesKind::EmbedForSoftwareRenderer => {\n i_slint_compiler::EmbedResourcesKind::EmbedTextures\n }\n };\n Self { config }\n }\n\n /// Sets the scale factor to be applied to all `px` to `phx` conversions\n /// as constant value. This is only intended for MCU environments. Use\n /// in combination with [`Self::embed_resources`] to pre-scale images and glyphs\n /// accordingly.\n ///\n /// If this is set, changing the scale factor at runtime will not have any effect.\n #[must_use]\n pub fn with_scale_factor(mut self, factor: f32) -> Self {\n self.config.const_scale_factor = Some(factor);\n self\n }\n\n /// Configures the compiler to bundle translations when compiling Slint code.\n ///\n /// It expects the path to be the root directory of the translation files.\n ///\n /// If given a relative path, it will be resolved relative to `$CARGO_MANIFEST_DIR`.\n ///\n /// The translation files should be in the gettext `.po` format and follow this pattern:\n /// `//LC_MESSAGES/.po`\n #[must_use]\n pub fn with_bundled_translations(\n self,\n path: impl Into,\n ) -> CompilerConfiguration {\n let mut config = self.config;\n config.translation_path_bundle = Some(path.into());\n Self { config }\n }\n\n /// Unless explicitly specified with the `@tr(\"context\" => ...)`, the default translation context is the component name.\n /// Use this option with [`DefaultTranslationContext::None`] to disable the default translation context.\n ///\n /// The translation file must also not have context\n /// (`--no-default-translation-context` argument of `slint-tr-extractor`)\n #[must_use]\n pub fn with_default_translation_context(\n mut self,\n default_translation_context: DefaultTranslationContext,\n ) -> Self {\n self.config.default_translation_context = default_translation_context;\n self\n }\n\n /// Configures the compiler to emit additional debug info when compiling Slint code.\n ///\n /// This is the equivalent to setting `SLINT_EMIT_DEBUG_INFO=1` and using the `slint!()` macro\n /// and is primarily used by `i-slint-backend-testing`.\n #[doc(hidden)]\n #[must_use]\n pub fn with_debug_info(self, enable: bool) -> Self {\n let mut config = self.config;\n config.debug_info = enable;\n Self { config }\n }\n\n /// Configures the compiler to treat the Slint as part of a library.\n ///\n /// Use this when the components and types of the Slint code need\n /// to be accessible from other modules.\n ///\n /// **Note**: This feature is experimental and may change or be removed in the future.\n #[cfg(feature = \"experimental-module-builds\")]\n #[must_use]\n pub fn as_library(self, library_name: &str) -> Self {\n let mut config = self.config;\n config.library_name = Some(library_name.to_string());\n Self { config }\n }\n\n /// Specify the Rust module to place the generated code in.\n ///\n /// **Note**: This feature is experimental and may change or be removed in the future.\n #[cfg(feature = \"experimental-module-builds\")]\n #[must_use]\n pub fn rust_module(self, rust_module: &str) -> Self {\n let mut config = self.config;\n config.rust_module = Some(rust_module.to_string());\n Self { config }\n }\n /// Configures the compiler to use Signed Distance Field (SDF) encoding for fonts.\n ///\n /// This flag only takes effect when `embed_resources` is set to [`EmbedResourcesKind::EmbedForSoftwareRenderer`],\n /// and requires the `sdf-fonts` cargo feature to be enabled.\n ///\n /// [SDF](https://en.wikipedia.org/wiki/Signed_distance_function) reduces the binary size by\n /// using an alternative representation for fonts, trading off some rendering quality\n /// for a smaller binary footprint.\n /// Rendering is slower and may result in slightly inferior visual output.\n /// Use this on systems with limited flash memory.\n #[cfg(feature = \"sdf-fonts\")]\n #[must_use]\n pub fn with_sdf_fonts(self, enable: bool) -> Self {\n let mut config = self.config;\n config.use_sdf_fonts = enable;\n Self { config }\n }\n\n /// Converts any relative include_paths or library_paths to absolute paths relative to the manifest_dir.\n #[must_use]\n fn with_absolute_paths(self, manifest_dir: &std::path::Path) -> Self {\n let mut config = self.config;\n\n let to_absolute_path = |path: &mut std::path::PathBuf| {\n if path.is_relative() {\n *path = manifest_dir.join(&path);\n }\n };\n\n for path in config.library_paths.values_mut() {\n to_absolute_path(path);\n }\n\n for path in config.include_paths.iter_mut() {\n to_absolute_path(path);\n }\n\n Self { config }\n }\n}\n\n/// Error returned by the `compile` function\n#[derive(derive_more::Error, derive_more::Display, Debug)]\n#[non_exhaustive]\npub enum CompileError {\n /// Cannot read environment variable CARGO_MANIFEST_DIR or OUT_DIR. The build script need to be run via cargo.\n #[display(\n \"Cannot read environment variable CARGO_MANIFEST_DIR or OUT_DIR. The build script need to be run via cargo.\"\n )]\n NotRunViaCargo,\n /// Parse error. The error are printed in the stderr, and also are in the vector\n #[display(\"{_0:?}\")]\n CompileError(#[error(not(source))] Vec),\n /// Cannot write the generated file\n #[display(\"Cannot write the generated file: {_0}\")]\n SaveError(std::io::Error),\n}\n\nstruct CodeFormatter {\n indentation: usize,\n /// We are currently in a string\n in_string: bool,\n /// number of bytes after the last `'`, 0 if there was none\n in_char: usize,\n /// In string or char, and the previous character was `\\\\`\n escaped: bool,\n sink: Sink,\n}\n\nimpl CodeFormatter {\n pub fn new(sink: Sink) -> Self {\n Self { indentation: 0, in_string: false, in_char: 0, escaped: false, sink }\n }\n}\n\nimpl Write for CodeFormatter {\n fn write(&mut self, mut s: &[u8]) -> std::io::Result {\n let len = s.len();\n while let Some(idx) = s.iter().position(|c| match c {\n b'{' if !self.in_string && self.in_char == 0 => {\n self.indentation += 1;\n true\n }\n b'}' if !self.in_string && self.in_char == 0 => {\n self.indentation -= 1;\n true\n }\n b';' if !self.in_string && self.in_char == 0 => true,\n b'\"' if !self.in_string && self.in_char == 0 => {\n self.in_string = true;\n self.escaped = false;\n false\n }\n b'\"' if self.in_string && !self.escaped => {\n self.in_string = false;\n false\n }\n b'\\'' if !self.in_string && self.in_char == 0 => {\n self.in_char = 1;\n self.escaped = false;\n false\n }\n b'\\'' if !self.in_string && self.in_char > 0 && !self.escaped => {\n self.in_char = 0;\n false\n }\n b' ' | b'>' if self.in_char > 2 && !self.escaped => {\n // probably a lifetime\n self.in_char = 0;\n false\n }\n b'\\\\' if (self.in_string || self.in_char > 0) && !self.escaped => {\n self.escaped = true;\n // no need to increment in_char since \\ isn't a single character\n false\n }\n _ if self.in_char > 0 => {\n self.in_char += 1;\n self.escaped = false;\n false\n }\n _ => {\n self.escaped = false;\n false\n }\n }) {\n let idx = idx + 1;\n self.sink.write_all(&s[..idx])?;\n self.sink.write_all(b\"\\n\")?;\n for _ in 0..self.indentation {\n self.sink.write_all(b\" \")?;\n }\n s = &s[idx..];\n }\n self.sink.write_all(s)?;\n Ok(len)\n }\n fn flush(&mut self) -> std::io::Result<()> {\n self.sink.flush()\n }\n}\n\n#[test]\nfn formatter_test() {\n fn format_code(code: &str) -> String {\n let mut res = Vec::new();\n let mut formatter = CodeFormatter::new(&mut res);\n formatter.write_all(code.as_bytes()).unwrap();\n String::from_utf8(res).unwrap()\n }\n\n assert_eq!(\n format_code(\"fn main() { if ';' == '}' { return \\\";\\\"; } else { panic!() } }\"),\n r#\"fn main() {\n if ';' == '}' {\n return \";\";\n }\n else {\n panic!() }\n }\n\"#\n );\n\n assert_eq!(\n format_code(r#\"fn xx<'lt>(foo: &'lt str) { println!(\"{}\", '\\u{f700}'); return Ok(()); }\"#),\n r#\"fn xx<'lt>(foo: &'lt str) {\n println!(\"{}\", '\\u{f700}');\n return Ok(());\n }\n\"#\n );\n\n assert_eq!(\n format_code(r#\"fn main() { \"\"; \"'\"; \"\\\"\"; \"{}\"; \"\\\\\"; \"\\\\\\\"\"; }\"#),\n r#\"fn main() {\n \"\";\n \"'\";\n \"\\\"\";\n \"{}\";\n \"\\\\\";\n \"\\\\\\\"\";\n }\n\"#\n );\n\n assert_eq!(\n format_code(r#\"fn main() { '\"'; '\\''; '{'; '}'; '\\\\'; }\"#),\n r#\"fn main() {\n '\"';\n '\\'';\n '{';\n '}';\n '\\\\';\n }\n\"#\n );\n}\n\n/// Compile the `.slint` file and generate rust code for it.\n///\n/// The generated code code will be created in the directory specified by\n/// the `OUT` environment variable as it is expected for build script.\n///\n/// The following line need to be added within your crate in order to include\n/// the generated code.\n/// ```ignore\n/// slint::include_modules!();\n/// ```\n///\n/// The path is relative to the `CARGO_MANIFEST_DIR`.\n///\n/// In case of compilation error, the errors are shown in `stderr`, the error\n/// are also returned in the [`CompileError`] enum. You must `unwrap` the returned\n/// result to make sure that cargo make the compilation fail in case there were\n/// errors when generating the code.\n///\n/// Please check out the documentation of the `slint` crate for more information\n/// about how to use the generated code.\n///\n/// This function can only be called within a build script run by cargo.\n///\n/// See also [`compile_with_config()`] if you want to specify a configuration.\npub fn compile(path: impl AsRef) -> Result<(), CompileError> {\n compile_with_config(path, CompilerConfiguration::default())\n}\n\n/// Same as [`compile`], but allow to specify a configuration.\n///\n/// Compile `ui/hello.slint` and select the \"material\" style:\n/// ```rust,no_run\n/// let config =\n/// slint_build::CompilerConfiguration::new()\n/// .with_style(\"material\".into());\n/// slint_build::compile_with_config(\"ui/hello.slint\", config).unwrap();\n/// ```\npub fn compile_with_config(\n relative_slint_file_path: impl AsRef,\n config: CompilerConfiguration,\n) -> Result<(), CompileError> {\n let manifest_path = std::path::PathBuf::from(\n env::var_os(\"CARGO_MANIFEST_DIR\").ok_or(CompileError::NotRunViaCargo)?,\n );\n let config = config.with_absolute_paths(&manifest_path);\n\n let path = manifest_path.join(relative_slint_file_path.as_ref());\n\n let absolute_rust_output_file_path =\n Path::new(&env::var_os(\"OUT_DIR\").ok_or(CompileError::NotRunViaCargo)?).join(\n path.file_stem()\n .map(Path::new)\n .unwrap_or_else(|| Path::new(\"slint_out\"))\n .with_extension(\"rs\"),\n );\n\n #[cfg(feature = \"experimental-module-builds\")]\n if let Some(library_name) = config.config.library_name.clone() {\n println!(\"cargo::metadata=SLINT_LIBRARY_NAME={}\", library_name);\n println!(\n \"cargo::metadata=SLINT_LIBRARY_PACKAGE={}\",\n std::env::var(\"CARGO_PKG_NAME\").ok().unwrap_or_default()\n );\n println!(\"cargo::metadata=SLINT_LIBRARY_SOURCE={}\", path.display());\n if let Some(rust_module) = &config.config.rust_module {\n println!(\"cargo::metadata=SLINT_LIBRARY_MODULE={}\", rust_module);\n }\n }\n let paths_dependencies =\n compile_with_output_path(path, absolute_rust_output_file_path.clone(), config)?;\n\n for path_dependency in paths_dependencies {\n println!(\"cargo:rerun-if-changed={}\", path_dependency.display());\n }\n\n println!(\"cargo:rerun-if-env-changed=SLINT_STYLE\");\n println!(\"cargo:rerun-if-env-changed=SLINT_FONT_SIZES\");\n println!(\"cargo:rerun-if-env-changed=SLINT_SCALE_FACTOR\");\n println!(\"cargo:rerun-if-env-changed=SLINT_ASSET_SECTION\");\n println!(\"cargo:rerun-if-env-changed=SLINT_EMBED_RESOURCES\");\n println!(\"cargo:rerun-if-env-changed=SLINT_EMIT_DEBUG_INFO\");\n println!(\"cargo:rerun-if-env-changed=SLINT_LIVE_PREVIEW\");\n\n println!(\n \"cargo:rustc-env=SLINT_INCLUDE_GENERATED={}\",\n absolute_rust_output_file_path.display()\n );\n\n Ok(())\n}\n\n/// Similar to [`compile_with_config`], but meant to be used independently of cargo.\n///\n/// Will compile the input file and write the result in the given output file.\n///\n/// Both input_slint_file_path and output_rust_file_path should be absolute paths.\n///\n/// Doesn't print any cargo messages.\n///\n/// Returns a list of all input files that were used to generate the output file. (dependencies)\npub fn compile_with_output_path(\n input_slint_file_path: impl AsRef,\n output_rust_file_path: impl AsRef,\n config: CompilerConfiguration,\n) -> Result, CompileError> {\n let mut diag = BuildDiagnostics::default();\n let syntax_node = i_slint_compiler::parser::parse_file(&input_slint_file_path, &mut diag);\n\n if diag.has_errors() {\n let vec = diag.to_string_vec();\n diag.print();\n return Err(CompileError::CompileError(vec));\n }\n\n let mut compiler_config = config.config;\n compiler_config.translation_domain = std::env::var(\"CARGO_PKG_NAME\").ok();\n\n let syntax_node = syntax_node.expect(\"diags contained no compilation errors\");\n\n // 'spin_on' is ok here because the compiler in single threaded and does not block if there is no blocking future\n let (doc, diag, loader) =\n spin_on::spin_on(i_slint_compiler::compile_syntax_node(syntax_node, diag, compiler_config));\n\n if diag.has_errors()\n || (!diag.is_empty() && std::env::var(\"SLINT_COMPILER_DENY_WARNINGS\").is_ok())\n {\n let vec = diag.to_string_vec();\n diag.print();\n return Err(CompileError::CompileError(vec));\n }\n\n let output_file =\n std::fs::File::create(&output_rust_file_path).map_err(CompileError::SaveError)?;\n let mut code_formatter = CodeFormatter::new(BufWriter::new(output_file));\n let generated = i_slint_compiler::generator::rust::generate(&doc, &loader.compiler_config)\n .map_err(|e| CompileError::CompileError(vec![e.to_string()]))?;\n\n let mut dependencies: Vec = Vec::new();\n\n for x in &diag.all_loaded_files {\n if x.is_absolute() {\n dependencies.push(x.clone());\n }\n }\n\n // print warnings\n diag.diagnostics_as_string().lines().for_each(|w| {\n if !w.is_empty() {\n println!(\"cargo:warning={}\", w.strip_prefix(\"warning: \").unwrap_or(w))\n }\n });\n\n write!(code_formatter, \"{generated}\").map_err(CompileError::SaveError)?;\n dependencies.push(input_slint_file_path.as_ref().to_path_buf());\n\n for resource in doc.embedded_file_resources.borrow().keys() {\n if !resource.starts_with(\"builtin:\") {\n dependencies.push(Path::new(resource).to_path_buf());\n }\n }\n\n code_formatter.sink.flush().map_err(CompileError::SaveError)?;\n\n Ok(dependencies)\n}\n\n/// This function is for use the application's build script, in order to print any device specific\n/// build flags reported by the backend\npub fn print_rustc_flags() -> std::io::Result<()> {\n if let Some(board_config_path) =\n std::env::var_os(\"DEP_MCU_BOARD_SUPPORT_BOARD_CONFIG_PATH\").map(std::path::PathBuf::from)\n {\n let config = std::fs::read_to_string(board_config_path.as_path())?;\n let toml = config.parse::().expect(\"invalid board config toml\");\n\n for link_arg in\n toml.get(\"link_args\").and_then(toml_edit::Item::as_array).into_iter().flatten()\n {\n if let Some(option) = link_arg.as_str() {\n println!(\"cargo:rustc-link-arg={option}\");\n }\n }\n\n for link_search_path in\n toml.get(\"link_search_path\").and_then(toml_edit::Item::as_array).into_iter().flatten()\n {\n if let Some(mut path) = link_search_path.as_str().map(std::path::PathBuf::from) {\n if path.is_relative() {\n path = board_config_path.parent().unwrap().join(path);\n }\n println!(\"cargo:rustc-link-search={}\", path.to_string_lossy());\n }\n }\n println!(\"cargo:rerun-if-env-changed=DEP_MCU_BOARD_SUPPORT_MCU_BOARD_CONFIG_PATH\");\n println!(\"cargo:rerun-if-changed={}\", board_config_path.display());\n }\n\n Ok(())\n}\n\n#[cfg(test)]\nfn root_path_prefix() -> std::path::PathBuf {\n #[cfg(windows)]\n return std::path::PathBuf::from(\"C:/\");\n #[cfg(not(windows))]\n return std::path::PathBuf::from(\"/\");\n}\n\n#[test]\nfn with_absolute_library_paths_test() {\n use std::path::PathBuf;\n\n let library_paths = std::collections::HashMap::from([\n (\"relative\".to_string(), PathBuf::from(\"some/relative/path\")),\n (\"absolute\".to_string(), root_path_prefix().join(\"some/absolute/path\")),\n ]);\n let config = CompilerConfiguration::new().with_library_paths(library_paths);\n\n let manifest_path = root_path_prefix().join(\"path/to/manifest\");\n let absolute_config = config.clone().with_absolute_paths(&manifest_path);\n let relative = &absolute_config.config.library_paths[\"relative\"];\n assert!(relative.is_absolute());\n assert!(relative.starts_with(&manifest_path));\n\n assert!(!absolute_config.config.library_paths[\"absolute\"].starts_with(&manifest_path));\n}\n\n#[test]\nfn with_absolute_include_paths_test() {\n use std::path::PathBuf;\n\n let config = CompilerConfiguration::new().with_include_paths(Vec::from([\n root_path_prefix().join(\"some/absolute/path\"),\n PathBuf::from(\"some/relative/path\"),\n ]));\n\n let manifest_path = root_path_prefix().join(\"path/to/manifest\");\n let absolute_config = config.clone().with_absolute_paths(&manifest_path);\n assert_eq!(\n absolute_config.config.include_paths,\n Vec::from([\n root_path_prefix().join(\"some/absolute/path\"),\n manifest_path.join(\"some/relative/path\"),\n ])\n )\n}\n" }, { "path": "api/rs/macros/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[package]\nname = \"slint-macros\"\ndescription = \"Macro helper for slint crate\"\nauthors.workspace = true\nedition = \"2024\"\nhomepage = \"https://slint.rs\"\nkeywords.workspace = true\nlicense.workspace = true\nrepository.workspace = true\nrust-version.workspace = true\nversion.workspace = true\ncategories = [\"gui\", \"development-tools\"]\n\n[lib]\nproc-macro = true\npath = \"lib.rs\"\n\n[features]\ndefault = []\n\n[dependencies]\ni-slint-compiler = { workspace = true, features = [\"default\", \"proc_macro_span\", \"rust\", \"display-diagnostics\"] }\nproc-macro2 = \"1.0.17\"\nquote = \"1.0\"\nspin_on = { workspace = true }\n\n[package.metadata.docs.rs]\nrustdoc-args = [\"--generate-link-to-definition\"]\n" }, { "path": "api/rs/macros/README.md", "content": "\n**NOTE**: This library is an **internal** crate for the [Slint project](https://slint.rs).\nThis crate should **not be used directly** by applications using Slint.\nYou should use the `slint` crate instead.\n\n**WARNING**: This crate does not follow the semver convention for versioning and can\nonly be used with `version = \"=x.y.z\"` in Cargo.toml.\n" }, { "path": "api/rs/macros/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n// cSpell:ignore punct\n\n#![doc = include_str!(\"README.md\")]\n#![doc(html_logo_url = \"https://slint.dev/logo/slint-logo-square-light.svg\")]\n\nextern crate proc_macro;\n\nuse i_slint_compiler::diagnostics::BuildDiagnostics;\nuse i_slint_compiler::parser::SyntaxKind;\nuse i_slint_compiler::*;\nuse proc_macro::{Spacing, TokenStream, TokenTree};\nuse quote::quote;\nuse std::path::PathBuf;\n\n/// Returns true if the two token are touching. For example the two token `foo`and `-` are touching if\n/// it was written like so in the source code: `foo-` but not when written like so `foo -`\n///\n/// Returns None if we couldn't detect whether they are touching (eg, our heuristics don't work with rust-analyzer)\nfn are_token_touching(token1: proc_macro::Span, token2: proc_macro::Span) -> Option {\n let t1 = token1.end();\n let t2 = token2.start();\n let t1_column = t1.column();\n if t1_column == 1 && t1.line() == 1 && t2.end().line() == 1 && t2.end().column() == 1 {\n // If everything is 1, this means that Span::line and Span::column are not working properly\n // (eg, rust-analyzer)\n return None;\n }\n Some(t1.line() == t2.line() && t1_column == t2.column())\n}\n\nfn fill_token_vec(stream: impl Iterator, vec: &mut Vec) {\n let mut prev_spacing = Spacing::Alone;\n let mut prev_span = proc_macro::Span::call_site();\n for t in stream {\n let span = t.span();\n match t {\n TokenTree::Ident(i) => {\n if let Some(last) = vec.last_mut()\n && ((last.kind == SyntaxKind::ColorLiteral && last.text.len() == 1)\n || (last.kind == SyntaxKind::Identifier\n && are_token_touching(prev_span, span)\n .unwrap_or_else(|| last.text.ends_with('-'))))\n {\n last.text = format!(\"{}{}\", last.text, i).into();\n prev_span = span;\n continue;\n }\n vec.push(parser::Token {\n kind: SyntaxKind::Identifier,\n text: i.to_string().into(),\n span: Some(i.span()),\n ..Default::default()\n });\n }\n TokenTree::Punct(p) => {\n let kind = match p.as_char() {\n ':' => SyntaxKind::Colon,\n '=' => {\n if let Some(last) = vec.last_mut() {\n let kt = match last.kind {\n SyntaxKind::Star => Some((SyntaxKind::StarEqual, \"*=\")),\n SyntaxKind::Colon => Some((SyntaxKind::ColonEqual, \":=\")),\n SyntaxKind::Plus => Some((SyntaxKind::PlusEqual, \"+=\")),\n SyntaxKind::Minus => Some((SyntaxKind::MinusEqual, \"-=\")),\n SyntaxKind::Div => Some((SyntaxKind::DivEqual, \"/=\")),\n SyntaxKind::LAngle => Some((SyntaxKind::LessEqual, \"<=\")),\n SyntaxKind::RAngle => Some((SyntaxKind::GreaterEqual, \">=\")),\n SyntaxKind::Equal => Some((SyntaxKind::EqualEqual, \"==\")),\n SyntaxKind::Bang => Some((SyntaxKind::NotEqual, \"!=\")),\n _ => None,\n };\n if let Some((k, t)) = kt\n && prev_spacing == Spacing::Joint\n {\n last.kind = k;\n last.text = t.into();\n continue;\n }\n }\n SyntaxKind::Equal\n }\n ';' => SyntaxKind::Semicolon,\n '!' => SyntaxKind::Bang,\n '.' => {\n // `4..log` is lexed as `4 . . log` in rust, but should be `4. . log` in slint\n if let Some(last) = vec.last_mut()\n && last.kind == SyntaxKind::NumberLiteral\n && are_token_touching(prev_span, p.span()).unwrap_or(false)\n && !last.text.contains('.')\n && !last.text.ends_with(char::is_alphabetic)\n {\n last.text = format!(\"{}.\", last.text).into();\n prev_span = span;\n continue;\n }\n SyntaxKind::Dot\n }\n '+' => SyntaxKind::Plus,\n '-' => {\n if let Some(last) = vec.last_mut()\n && last.kind == SyntaxKind::Identifier\n && are_token_touching(prev_span, p.span()).unwrap_or(true)\n {\n last.text = format!(\"{}-\", last.text).into();\n prev_span = span;\n continue;\n }\n SyntaxKind::Minus\n }\n '*' => SyntaxKind::Star,\n '/' => SyntaxKind::Div,\n '<' => SyntaxKind::LAngle,\n '>' => {\n if let Some(last) = vec.last_mut() {\n if last.kind == SyntaxKind::LessEqual && prev_spacing == Spacing::Joint\n {\n last.kind = SyntaxKind::DoubleArrow;\n last.text = \"<=>\".into();\n continue;\n } else if last.kind == SyntaxKind::Equal\n && prev_spacing == Spacing::Joint\n {\n last.kind = SyntaxKind::FatArrow;\n last.text = \"=>\".into();\n continue;\n } else if last.kind == SyntaxKind::Minus\n && prev_spacing == Spacing::Joint\n {\n last.kind = SyntaxKind::Arrow;\n last.text = \"->\".into();\n continue;\n }\n }\n SyntaxKind::RAngle\n }\n '#' => SyntaxKind::ColorLiteral,\n '?' => SyntaxKind::Question,\n ',' => SyntaxKind::Comma,\n '&' => {\n // Since the '&' alone does not exist or cannot be part of any other token that &&\n // just consider it as '&&' and skip the joint ones. FIXME. do that properly\n if let Some(last) = vec.last_mut()\n && last.kind == SyntaxKind::AndAnd\n && prev_spacing == Spacing::Joint\n {\n continue;\n }\n SyntaxKind::AndAnd\n }\n '|' => {\n // Since the '|' alone does not exist or cannot be part of any other token that ||\n // just consider it as '||' and skip the joint ones.\n if let Some(last) = vec.last_mut()\n && last.kind == SyntaxKind::Pipe\n && prev_spacing == Spacing::Joint\n {\n last.kind = SyntaxKind::OrOr;\n continue;\n }\n SyntaxKind::Pipe\n }\n '%' => {\n // handle % as a unit\n if let Some(last) = vec.last_mut()\n && last.kind == SyntaxKind::NumberLiteral\n {\n last.text = format!(\"{}%\", last.text).into();\n continue;\n }\n SyntaxKind::Percent\n }\n '$' => SyntaxKind::Dollar,\n '@' => SyntaxKind::At,\n _ => SyntaxKind::Error,\n };\n prev_spacing = p.spacing();\n vec.push(parser::Token {\n kind,\n text: p.to_string().into(),\n span: Some(p.span()),\n ..Default::default()\n });\n }\n TokenTree::Literal(l) => {\n let s = l.to_string();\n // Why can't the rust API give me the type of the literal\n let f = s.chars().next().unwrap();\n let kind = if f == '\"' {\n SyntaxKind::StringLiteral\n } else if f.is_ascii_digit() {\n if let Some(last) = vec.last_mut()\n && ((last.kind == SyntaxKind::ColorLiteral && last.text.len() == 1)\n || (last.kind == SyntaxKind::Identifier\n && are_token_touching(prev_span, span)\n .unwrap_or_else(|| last.text.ends_with('-'))))\n {\n last.text = format!(\"{}{}\", last.text, s).into();\n prev_span = span;\n continue;\n }\n SyntaxKind::NumberLiteral\n } else {\n SyntaxKind::Error\n };\n vec.push(parser::Token {\n kind,\n text: s.into(),\n span: Some(l.span()),\n ..Default::default()\n });\n }\n TokenTree::Group(g) => {\n use SyntaxKind::*;\n use proc_macro::Delimiter::*;\n let (l, r, sl, sr) = match g.delimiter() {\n Parenthesis => (LParent, RParent, \"(\", \")\"),\n Brace => (LBrace, RBrace, \"{\", \"}\"),\n Bracket => (LBracket, RBracket, \"[\", \"]\"),\n None => todo!(),\n };\n vec.push(parser::Token {\n kind: l,\n text: sl.into(),\n span: Some(g.span()), // span_open is not stable\n ..Default::default()\n });\n fill_token_vec(g.stream().into_iter(), vec);\n vec.push(parser::Token {\n kind: r,\n text: sr.into(),\n span: Some(g.span()), // span_clone is not stable\n ..Default::default()\n });\n }\n }\n prev_span = span;\n }\n}\n\nfn extract_path(literal: proc_macro::Literal) -> std::path::PathBuf {\n let path_with_quotes = literal.to_string();\n let path_with_quotes_stripped = if let Some(p) = path_with_quotes.strip_prefix('r') {\n let hash_removed = p.trim_matches('#');\n hash_removed.strip_prefix('\\\"').unwrap().strip_suffix('\\\"').unwrap()\n } else {\n // FIXME: unescape\n path_with_quotes.trim_matches('\\\"')\n };\n path_with_quotes_stripped.into()\n}\n\nfn extract_compiler_config(\n mut stream: proc_macro::token_stream::IntoIter,\n compiler_config: &mut CompilerConfiguration,\n) -> impl Iterator {\n let mut remaining_stream;\n loop {\n remaining_stream = stream.clone();\n match (stream.next(), stream.next()) {\n (Some(TokenTree::Punct(p)), Some(TokenTree::Group(group)))\n if p.as_char() == '#' && group.delimiter() == proc_macro::Delimiter::Bracket =>\n {\n let mut attr_stream = group.stream().into_iter();\n match attr_stream.next() {\n Some(TokenTree::Ident(include_ident))\n if include_ident.to_string() == \"include_path\" =>\n {\n match (attr_stream.next(), attr_stream.next()) {\n (\n Some(TokenTree::Punct(equal_punct)),\n Some(TokenTree::Literal(path)),\n ) if equal_punct.as_char() == '=' => {\n compiler_config.include_paths.push(extract_path(path));\n }\n _ => break,\n }\n }\n Some(TokenTree::Ident(library_ident))\n if library_ident.to_string() == \"library_path\" =>\n {\n match (attr_stream.next(), attr_stream.next(), attr_stream.next()) {\n (\n Some(TokenTree::Group(group)),\n Some(TokenTree::Punct(equal_punct)),\n Some(TokenTree::Literal(path)),\n ) if group.delimiter() == proc_macro::Delimiter::Parenthesis\n && equal_punct.as_char() == '=' =>\n {\n let library_name = group.stream().into_iter().next().unwrap();\n compiler_config\n .library_paths\n .insert(library_name.to_string(), extract_path(path));\n }\n _ => break,\n }\n }\n Some(TokenTree::Ident(style_ident)) if style_ident.to_string() == \"style\" => {\n match (attr_stream.next(), attr_stream.next()) {\n (\n Some(TokenTree::Punct(equal_punct)),\n Some(TokenTree::Literal(requested_style)),\n ) if equal_punct.as_char() == '=' => {\n compiler_config.style = requested_style\n .to_string()\n .strip_prefix('\\\"')\n .unwrap()\n .strip_suffix('\\\"')\n .unwrap()\n .to_string()\n .into();\n }\n _ => break,\n }\n }\n _ => break,\n }\n }\n _ => break,\n }\n }\n remaining_stream\n}\n\n/// This macro allows you to use the Slint design markup language inline in Rust code. Within the braces of the macro\n/// you can use place Slint code and the named exported components will be available for instantiation.\n///\n/// For the documentation about the syntax of the language, see\n#[doc = concat!(\"[The Slint Language Documentation](https://slint.dev/releases/\", env!(\"CARGO_PKG_VERSION\"), \"/docs/slint)\")]\n///\n/// When Rust 1.88 or later is used, the paths for loading images with `@image-url` and importing `.slint` files\n/// are relative to the `.rs` file that contains the macro.\n/// For compatibility with older rust version, the files are also searched in the manifest directory that contains `Cargo.toml`.\n///\n/// ### Limitations\n///\n/// Within `.slint` files, you can interpolate string literals using `\\{...}` syntax.\n/// This is not possible in this macro as this wouldn't parse as a Rust string.\n#[proc_macro]\npub fn slint(stream: TokenStream) -> TokenStream {\n let token_iter = stream.into_iter();\n\n let mut compiler_config =\n CompilerConfiguration::new(i_slint_compiler::generator::OutputFormat::Rust);\n\n let token_iter = extract_compiler_config(token_iter, &mut compiler_config);\n\n let mut tokens = Vec::new();\n fill_token_vec(token_iter, &mut tokens);\n\n fn local_file(tokens: &[parser::Token]) -> Option {\n tokens.first()?.span?.local_file()\n }\n\n let source_file = if let Some(path) = local_file(&tokens) {\n diagnostics::SourceFileInner::from_path_only(path)\n } else if let Some(cargo_manifest) = std::env::var_os(\"CARGO_MANIFEST_DIR\") {\n let mut path: std::path::PathBuf = cargo_manifest.into();\n path.push(\"Cargo.toml\");\n diagnostics::SourceFileInner::from_path_only(path)\n } else {\n diagnostics::SourceFileInner::from_path_only(Default::default())\n };\n let mut diag = BuildDiagnostics::default();\n let syntax_node = parser::parse_tokens(tokens.clone(), source_file, &mut diag);\n if diag.has_errors() {\n return diag.report_macro_diagnostic(&tokens);\n }\n\n //println!(\"{syntax_node:#?}\");\n compiler_config.translation_domain = std::env::var(\"CARGO_PKG_NAME\").ok();\n let (root_component, diag, loader) =\n spin_on::spin_on(compile_syntax_node(syntax_node, diag, compiler_config));\n //println!(\"{tree:#?}\");\n if diag.has_errors() {\n return diag.report_macro_diagnostic(&tokens);\n }\n\n if std::env::var(\"RUST_ANALYZER_INTERNALS_DO_NOT_USE\").is_ok() {\n // When running on rust-analyzer, only generate the API (using the live preview) to make rust-analyzer faster and use less memory\n // (This uses an unstable env variable, but it is just an optimization)\n return generator::rust_live_preview::generate(&root_component, &loader.compiler_config)\n .unwrap_or_else(|e| {\n let e_str = e.to_string();\n quote!(compile_error!(#e_str))\n })\n .into();\n }\n\n let mut result = generator::rust::generate(&root_component, &loader.compiler_config)\n .unwrap_or_else(|e| {\n let e_str = e.to_string();\n quote!(compile_error!(#e_str))\n });\n\n // Make sure to recompile if any of the external files changes\n let reload = diag\n .all_loaded_files\n .iter()\n .filter(|path| path.is_absolute() && !path.ends_with(\"Cargo.toml\"))\n .filter_map(|p| p.to_str())\n .map(|p| quote! {const _ : &'static [u8] = ::core::include_bytes!(#p);});\n\n result.extend(reload);\n result.extend(quote! {const _ : ::core::option::Option<&'static str> = ::core::option_env!(\"SLINT_STYLE\");});\n\n let mut result = TokenStream::from(result);\n if !diag.is_empty() {\n result.extend(diag.report_macro_diagnostic(&tokens));\n }\n result\n}\n" }, { "path": "api/rs/slint/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[package]\nname = \"slint\"\ndescription = \"GUI toolkit to efficiently develop fluid graphical user interfaces for embedded devices and desktop applications\"\nauthors.workspace = true\ndocumentation.workspace = true\nedition = \"2024\"\nhomepage = \"https://slint.rs\"\nkeywords.workspace = true\nlicense.workspace = true\nrepository.workspace = true\nrust-version.workspace = true\nversion.workspace = true\ncategories = [\"gui\", \"rendering::engine\", \"no-std\"]\n\n[lib]\npath = \"lib.rs\"\n\n[features]\n\ndefault = [\"std\", \"backend-default\", \"renderer-femtovg\", \"renderer-software\", \"accessibility\", \"compat-1-2\"]\n\n## Mandatory feature:\n## This feature is required to keep the compatibility with Slint 1.2\n## Newer patch version may put current functionality behind a new feature\n## that would be enabled by default only if this feature was added.\n## [More info in this blog post](https://slint.dev/blog/rust-adding-default-cargo-feature.html)\n\"compat-1-2\" = []\n\"compat-1-0\" = [\"compat-1-2\", \"renderer-software\"]\n\n## Enable use of the Rust standard library.\nstd = [\"i-slint-core/std\", \"i-slint-renderer-software?/std\"]\n\n## Enable the translations using [gettext](https://www.gnu.org/software/gettext/gettext)\n##\n## the `@tr(...)` code from .slint files will be transformed into call to `dgettext`\n## with the crate name as domain name\n##\n## translations must be enabled with the [`init_translations!`] macro\ngettext = [\"i-slint-core/gettext-rs\"]\n\n## This feature enables floating point arithmetic emulation using the [libm](https://crates.io/crates/libm) crate. Use this\n## in MCU environments where the processor does not support floating point arithmetic.\nlibm = [\"i-slint-core/libm\", \"i-slint-renderer-software?/libm\"]\n\n## If enabled, calls of `debug()` in `.slint` files use to the [`log::debug!()`] macro\n## of the [log](https://crates.io/crates/log) crate instead of just `println!()`.\nlog = [\"dep:log\"]\n\n## Implement the `serde::Serialize` and `serde::Deserialize` for some of the base types\n## such as `SharedString` and `SharedVector`.\nserde = [\"i-slint-core/serde\"]\n\n# Deprecated feature, this is now automatically enabled when the `renderer-software` and `std` features are enabled\nsoftware-renderer-systemfonts = [\"renderer-software\"]\n\n# Enable support for Path element rendering with the software renderer. This is implicitly enabled by the\n# `std` feature, but can be enabled without `std` if you want to use the software renderer in a `#![no_std]` environment and need support for Path elements.\nsoftware-renderer-path = [\"i-slint-renderer-software/path\"]\n\n## Slint uses internally some `thread_local` state.\n##\n## When the `std` feature is enabled, Slint can use [`std::thread_local!`], but when in a `#![no_std]`\n## environment, we need a replacement. Using this feature, Slint will just use static variable\n## disregarding Rust's Send and Sync safety\n##\n## **Safety** : You must ensure that there is only one single thread that call into the Slint API\nunsafe-single-threaded = [\"i-slint-core/unsafe-single-threaded\"]\n\n## Enable integration with operating system provided accessibility APIs\n##\n## Enabling this feature will try to expose the tree of UI elements to OS provided accessibility\n## APIs to support screen readers and other assistive technologies.\naccessibility = [\"i-slint-backend-selector/accessibility\"]\n\n## Enable integration with [raw-window-handle](raw_window_handle_06) version 0.6. This provides a\n## [`Window::window_handle()`] function that returns a struct that implements\n## [HasWindowHandle](raw_window_handle_06::HasWindowHandle) and\n## [HasDisplayHandle](raw_window_handle_06::HasDisplayHandle) implementation.\nraw-window-handle-06 = [\"dep:raw-window-handle-06\", \"i-slint-backend-selector/raw-window-handle-06\"]\n\n## Enable the default image formats from the `image` crate, to support additional image formats in [`Image::load_from_path`]\n## and `@image-url`. When this feature is disabled, only PNG and JPEG are supported. When enabled,\n## the following image formats are supported:\n## AVIF, BMP, DDS, Farbfeld, GIF, HDR, ICO, JPEG, EXR, PNG, PNM, QOI, TGA, TIFF, WebP.\nimage-default-formats = [\"i-slint-core/image-default-formats\"]\n\n## Enable the live preview feature\n##\n## Enable this feature to reload the .slint files at runtime and reload it whenever the files are modified on disk.\n## For this feature to work, it's also required to set the `SLINT_LIVE_PREVIEW` environment variable during\n## application compilation.\n##\n## This is a feature for debugging and development. It's not recommended to add this feature to your Cargo.toml.\n## Instead, use the `--features` command line argument like so when building your app:\n## ```bash\n## SLINT_LIVE_PREVIEW=1 cargo build --features slint/live-preview\n## ```\nlive-preview = [\"dep:slint-interpreter\"]\n\n#! ### Backends\n\n#! Slint needs a backend that will act as liaison between Slint and the OS.\n#! By default, Slint will use the Qt backend, if Qt is installed, otherwise, it\n#! will use [Winit](https://crates.io/crates/winit) with [FemtoVG](https://crates.io/crates/femtovg).\n#! Both backends are compiled in. If you want to not compile one of these you need\n#! to disable the default feature and re-enable one backend. It is also possible\n#! to use Slint without backend if you provide the platform abstraction yourself\n#! with [`platform::set_platform()`].\n#!\n#! If you enable the Winit backend, you need to also include a renderer.\n#! `renderer-femtovg` is the default renderer.\n#!\n#! It is also possible to select the backend and renderer at runtime when several\n#! are enabled, using the `SLINT_BACKEND` environment variable.\n#! * `SLINT_BACKEND=Qt` selects the Qt backend\n#! * `SLINT_BACKEND=winit` selects the winit backend\n#! * `SLINT_BACKEND=winit-femtovg` selects the winit backend with the FemtoVG renderer\n#! * `SLINT_BACKEND=winit-skia` selects the winit backend with the skia renderer\n#! * `SLINT_BACKEND=winit-software` selects the winit backend with the software renderer\n#!\n#! If the selected backend is not available, the default will be used.\n#!\n#! Here are the cargo features controlling the backend:\n\n## The Qt backend feature uses Qt for the windowing system integration and rendering.\n## This backend also provides the `native` style.\n## It requires Qt 5.15 or later to be installed. If Qt is not installed, the\n## backend will not be operational\nbackend-qt = [\"i-slint-backend-selector/backend-qt\", \"std\", \"i-slint-backend-qt\"]\n\n## The [winit](https://crates.io/crates/winit) crate is used for the event loop and windowing system integration.\n## It supports Windows, macOS, web browsers, X11 and Wayland. X11 and wayland are only available when\n## compiling for Linux or other Unix-like operating systems. With this feature, both X11 and Wayland are supported.\n## For a smaller build, omit this feature and select one of the other specific `backend-winit-XX` features.\nbackend-winit = [\"i-slint-backend-selector/backend-winit\", \"std\"]\n\n## Simliar to `backend-winit` this enables the winit based event loop but only\n## with support for the X Window System on Unix.\nbackend-winit-x11 = [\"i-slint-backend-selector/backend-winit-x11\", \"std\"]\n\n## Simliar to `backend-winit` this enables the winit based event loop but only\n## with support for the Wayland window system on Unix.\nbackend-winit-wayland = [\"i-slint-backend-selector/backend-winit-wayland\", \"std\"]\n\n## Alias to a backend and renderer that depends on the platform.\n## Will select the Qt backend on linux if present, and the winit otherwise\nbackend-default = [\"i-slint-backend-selector/default\", \"i-slint-backend-qt\"]\n\n# deprecated aliases\nrenderer-winit-femtovg = [\"renderer-femtovg\"]\nrenderer-winit-skia = [\"renderer-skia\"]\nrenderer-winit-skia-opengl = [\"renderer-skia-opengl\"]\nrenderer-winit-skia-vulkan = [\"renderer-skia-vulkan\"]\nrenderer-winit-software = [\"renderer-software\"]\n\n## Render using the [FemtoVG](https://crates.io/crates/femtovg) crate.\nrenderer-femtovg = [\"i-slint-backend-selector/renderer-femtovg\", \"dep:i-slint-renderer-femtovg\", \"std\"]\n## Render using the [FemtoVG](https://crates.io/crates/femtovg) crate and [WGPU](https://crates.io/crates/wgpu).\nrenderer-femtovg-wgpu = [\"i-slint-backend-selector/renderer-femtovg-wgpu\", \"i-slint-renderer-femtovg/wgpu\", \"std\"]\n\n## Render using [Skia](https://skia.org/).\nrenderer-skia = [\"i-slint-backend-selector/renderer-skia\", \"std\"]\n\n## Same as `renderer-skia`, but Skia will always use OpenGL.\n## Note: This is not supported on iOS. Use `renderer-skia` on iOS to enable Meta based rendering.\nrenderer-skia-opengl = [\"i-slint-backend-selector/renderer-skia-opengl\", \"std\"]\n\n## Same as `renderer-skia`, but Skia will always use Vulkan.\nrenderer-skia-vulkan = [\"i-slint-backend-selector/renderer-skia-vulkan\", \"std\"]\n\n## Render using the software renderer.\nrenderer-software = [\"i-slint-backend-selector/renderer-software\", \"dep:i-slint-renderer-software\"]\n\n## KMS with Vulkan or EGL and libinput on Linux are used to render the application in full screen mode, without any\n## windowing system. Requires libseat. If you don't have libseat, select `backend-linuxkms-noseat` instead.\nbackend-linuxkms = [\"i-slint-backend-selector/backend-linuxkms\", \"std\"]\n\n## KMS with Vulkan or EGL and libinput on Linux are used to render the application in full screen mode, without any\n## windowing system.\nbackend-linuxkms-noseat = [\"i-slint-backend-selector/backend-linuxkms-noseat\", \"std\"]\n\n## Use the backend based on the [android-activity](https://docs.rs/android-activity) crate. (Using it's native activity feature)\nbackend-android-activity-06 = [\n \"i-slint-backend-android-activity/native-activity\",\n \"i-slint-backend-android-activity/aa-06\",\n \"i-slint-backend-selector/backend-android-activity\",\n]\n\n## **Deprecated** Use previous version of android-activity. This is mutually exclusive with `backend-android-activity-06`.\nbackend-android-activity-05 = [\n \"i-slint-backend-android-activity/native-activity\",\n \"i-slint-backend-android-activity/aa-05\",\n]\n\n## Enable support for [WGPU](http://wgpu.rs) based rendering and expose WGPU based APIs based on WGPU version 27.x.\n##\n## APIs guarded with this feature are *NOT* subject to the usual Slint API stability guarantees, because WGPU releases new major\n## versions frequently. This feature as well as the APIs changed or removed in future minor releases of Slint, likely to be replaced\n## by a feature with a similar name but the WGPU version suffix being bumped.\n##\n## To avoid unintended compilation failures, we recommend to use the [tilde requirement](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#tilde-requirements)\n## in your `Cargo.toml` when enabling this feature:\n##\n## ```toml\n## slint = { version = \"~1.16\", features = [\"unstable-wgpu-27\"] }\n## ```\nunstable-wgpu-27 = [\n \"i-slint-core/unstable-wgpu-27\",\n \"i-slint-backend-selector/unstable-wgpu-27\",\n \"i-slint-backend-android-activity?/unstable-wgpu-27\",\n \"dep:wgpu-27\",\n]\n\n## Enable support for [WGPU](http://wgpu.rs) based rendering and expose WGPU based APIs based on WGPU version 28.x.\n##\n## APIs guarded with this feature are *NOT* subject to the usual Slint API stability guarantees, because WGPU releases new major\n## versions frequently. This feature as well as the APIs changed or removed in future minor releases of Slint, likely to be replaced\n## by a feature with a similar name but the WGPU version suffix being bumped.\n##\n## To avoid unintended compilation failures, we recommend to use the [tilde requirement](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#tilde-requirements)\n## in your `Cargo.toml` when enabling this feature:\n##\n## ```toml\n## slint = { version = \"~1.16\", features = [\"unstable-wgpu-28\"] }\n## ```\nunstable-wgpu-28 = [\n \"i-slint-core/unstable-wgpu-28\",\n \"i-slint-backend-selector/unstable-wgpu-28\",\n \"i-slint-backend-android-activity?/unstable-wgpu-28\",\n \"dep:wgpu-28\",\n]\n\n## APIs guarded with this feature are *NOT* subject to the usual Slint API stability guarantees, because winit releases new major\n## versions more frequently than Slint. This feature as well as the APIs changed or removed in future minor releases of Slint, likely to be replaced\n## by a feature with a similar name but the winit version suffix being bumped.\n##\n## To avoid unintended compilation failures, we recommend to use the [tilde requirement](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#tilde-requirements)\n## in your `Cargo.toml` when enabling this feature:\n##\n## ```toml\n## slint = { version = \"~1.16\", features = [\"unstable-winit-030\"] }\n## ```\nunstable-winit-030 = [\"backend-winit\", \"dep:i-slint-backend-winit\", \"i-slint-backend-selector/unstable-winit-030\"]\n\n\n## Enable support for exposing [libinput](https://docs.rs/input/latest/input/index.html) related APIs in the LinuxKMS backend.\n##\n## APIs guarded with this feature are *NOT* subject to the usual Slint API stability guarantees. This feature as well as the APIs changed or removed\n## in future minor releases of Slint, likely to be replaced by a feature with a similar name but the input version suffix being bumped.\n##\n## To avoid unintended compilation failures, we recommend to use the [tilde requirement](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#tilde-requirements)\n## in your `Cargo.toml` when enabling this feature:\n##\n## ```toml\n## slint = { version = \"~1.16\", features = [\"unstable-libinput-09\"] }\n## ```\nunstable-libinput-09 = [\"i-slint-backend-selector/unstable-libinput-09\"]\n\n## Enable support for exposing [fontique](https://docs.rs/fontique/0.7.0/fontique/) related APIs.\n##\n## APIs guarded with this feature are *NOT* subject to the usual Slint API stability guarantees. This feature as well as the APIs changed or removed\n## in future minor releases of Slint, likely to be replaced by a feature with a similar name but the fontique version suffix being bumped.\n##\n## To avoid unintended compilation failures, we recommend to use the [tilde requirement](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#tilde-requirements)\n## in your `Cargo.toml` when enabling this feature:\n##\n## ```toml\n## slint = { version = \"~1.16\", features = [\"unstable-fontique-07\"] }\n## ```\nunstable-fontique-07 = [\"i-slint-common/shared-fontique\"]\n\n[dependencies]\ni-slint-core = { workspace = true }\nslint-macros = { workspace = true }\ni-slint-backend-selector = { workspace = true }\ni-slint-core-macros = { workspace = true }\ni-slint-common = { workspace = true }\ni-slint-renderer-software = { workspace = true, optional = true }\nslint-interpreter = { workspace = true, optional = true, default-features = false, features = [\"display-diagnostics\", \"compat-1-2\", \"internal-live-preview\"] }\n\nconst-field-offset = { version = \"0.1.2\", path = \"../../../helper_crates/const-field-offset\" }\ndocument-features = { version = \"0.2.0\", optional = true }\nvtable = { workspace = true }\n\nonce_cell = { version = \"1.5\", default-features = false, features = [\"alloc\"] }\npin-weak = { version = \"1.1\", default-features = false }\nnum-traits = { version = \"0.2\", default-features = false }\n\nlog = { workspace = true, optional = true }\n\nraw-window-handle-06 = { workspace = true, optional = true }\n\nunicode-segmentation = { workspace = true }\n\nwgpu-27 = { workspace = true, optional = true }\nwgpu-28 = { workspace = true, optional = true }\n\ni-slint-backend-winit = { workspace = true, optional = true }\n\n[target.'cfg(not(target_os = \"android\"))'.dependencies]\n# FemtoVG is disabled on android because it doesn't compile without setting RUST_FONTCONFIG_DLOPEN=on\n# end even then wouldn't work because it can't load fonts\ni-slint-renderer-femtovg = { workspace = true, optional = true }\n\n[target.'cfg(target_os = \"android\")'.dependencies]\ni-slint-backend-android-activity = { workspace = true, optional = true }\n\n[dev-dependencies]\nslint-build = { path = \"../build\" }\n# The next can not be a workspace dependency because it may not have a version\ni-slint-backend-testing = { path = \"../../../internal/backends/testing\", features = [\"internal\"] }\ni-slint-renderer-skia = { path = \"../../../internal/renderers/skia\" }\nserde_json = { workspace = true }\nserde = { workspace = true }\ntokio = { version = \"1\", features = [\"rt-multi-thread\", \"macros\", \"sync\", \"net\", \"io-util\"] }\nasync-compat = { version = \"0.2.4\" }\nbytemuck = { workspace = true }\ni-slint-renderer-software = { path = \"../../../internal/renderers/software\", features = [\"testing\"] }\n\n[target.'cfg(target_os = \"linux\")'.dependencies]\n# this line is there to add the \"enable\" feature by default, but only on linux\ni-slint-backend-qt = { workspace = true, features = [\"enable\"], optional = true }\n\n[package.metadata.docs.rs]\nfeatures = [\n \"document-features\",\n \"log\",\n \"gettext\",\n \"renderer-software\",\n \"renderer-femtovg\",\n \"raw-window-handle-06\",\n \"unstable-wgpu-28\",\n \"unstable-winit-030\",\n \"unstable-libinput-09\",\n \"unstable-fontique-07\",\n]\nrustdoc-args = [\"--generate-link-to-definition\"]\n" }, { "path": "api/rs/slint/README.md", "content": "\n# Slint\n\n[![Crates.io](https://img.shields.io/crates/v/slint)](https://crates.io/crates/slint)\n[![Docs.rs](https://docs.rs/slint/badge.svg)](https://docs.rs/slint)\n\n# A Rust UI toolkit\n\n[Slint](https://slint.rs) is a Rust based UI toolkit to build native user interfaces on desktop platforms and for embedded devices.\nThis crate provides the Rust APIs to interact with the user interface implemented in Slint.\n\nThe complete Rust documentation for Slint can be viewed online at https://slint.rs/docs/rust/slint/.\n\n## Getting Started\n\nThe [crate documentation](https://slint.dev/docs/rust/slint/) shows how to use this crate.\n\n### Hello World\n\nThe most basic \"Hello world\" application can be achieved with a few lines of code:\n\nIn your `Cargo.toml` add:\n\n```toml\n[dependencies]\nslint = \"1.15\"\n```\n\nAnd in your `main.rs`:\n\n```rust,no_run\nslint::slint!{\n export component HelloWorld {\n Text {\n text: \"hello world\";\n color: green;\n }\n }\n}\nfn main() {\n HelloWorld::new().unwrap().run().unwrap();\n}\n```\n\nThe [`slint` crate documentation](https://slint.dev/docs/rust/slint/)\ncontains more advanced examples and alternative ways to use this crate.\n\nTo quickly get started, use the [Template Repository](https://github.com/slint-ui/slint-rust-template) with\nthe code of a minimal application using Slint as a starting point for your program.\n\n1. Download and extract the [ZIP archive of the Rust Template](https://github.com/slint-ui/slint-rust-template/archive/refs/heads/main.zip).\n2. Rename the extracted directory and change into it:\n\n```bash\nmv slint-rust-template-main my-project\ncd my-project\n```\n\n## More examples\n\nYou can quickly try out the [examples](/examples) by cloning this repo and running them with `cargo run`\n\n```sh\n# Runs the \"printerdemo\" example\ncargo run --release --bin printerdemo\n```\n" }, { "path": "api/rs/slint/android.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n//! Android backend.\n//!\n//! **Note:** This module is only available on Android with the \"backend-android-activity-06\" feature\n//!\n//! Slint uses the [android-activity crate](https://github.com/rust-mobile/android-activity) as a backend.\n//!\n//! For convenience, Slint re-exports the content of the [`android-activity`](https://docs.rs/android-activity) under `slint::android::android_activity`.\n//!\n//! As with every application using the android-activity crate, the entry point to your app will be the `android_main` function.\n//! From that function, you can call [`slint::android::init`](init()) or [`slint::android::init_with_event_listener`](init_with_event_listener)\n//!\n//! # Example\n//!\n//! This is a basic example of an Android application.\n//! Do not forget the `#[unsafe(no_mangle)]`\n//!\n//! ```rust\n//! # #[cfg(target_os = \"android\")]\n//! #[unsafe(no_mangle)]\n//! fn android_main(app: slint::android::AndroidApp) {\n//! slint::android::init(app).unwrap();\n//!\n//! // ... rest of your code ...\n//! slint::slint!{\n//! export component MainWindow inherits Window {\n//! Text { text: \"Hello World\"; }\n//! }\n//! }\n//! MainWindow::new().unwrap().run().unwrap();\n//! }\n//! ```\n//!\n//! That function must be in a `cdylib` library, and you should enable the \"backend-android-activity-06\"\n//! feature of the slint crate in your Cargo.toml:\n//!\n//! ```toml\n//! [lib]\n//! crate-type = [\"cdylib\"]\n//!\n//! [dependencies]\n//! slint = { version = \"1.6\", features = [\"backend-android-activity-06\"] }\n//! ```\n//!\n//! ## Building and Deploying\n//!\n//! Building a Rust application requires the target toolchain to be installed. You can install it via `rustup`. For example, to target AArch64 Android, use the following command:\n//!\n//! ```sh\n//! rustup target add aarch64-linux-android\n//! ```\n//!\n//! Make sure that you have the Android NDK and SDK installed and set up in your development environment.\n//! For detailed instructions on how to set up the Android NDK and SDK, please refer to the [Android Developer's guide](https://developer.android.com/studio/projects/install-ndk).\n//! The following environment variables need to be set:\n//! * `ANDROID_HOME`: The directory in which your Android SDK is located. Usually `$HOME/Android/Sdk`.\n//! * `ANDROID_NDK_ROOT`: The directory in which your Android NDK is located. Usually `$HOME/Android/Sdk/ndk/${NDK_VERSION}`. ${NDK_VERSION} is the version of the NDK you have installed.\n//! * `JAVA_HOME`: The directory in which your Java compiler (`javac`) is located. This variable is optional if a `javac` is found in your `$PATH`.\n//! Otherwise you can set `JAVA_HOME` to the `javac` installation shipped with Android Studio in `android-studio/jbr`.\n//!\n//! To build and deploy your application, we suggest the usage of [cargo-apk](https://github.com/rust-mobile/cargo-apk),\n//! a cargo subcommand that allows you to build, sign, and deploy Android APKs made in Rust.\n//!\n//! You can install it and use it with the following command:\n//!\n//! ```sh\n//! cargo install cargo-apk\n//! ```\n//!\n//! Build and run your application with the following command:\n//!\n//! ```sh\n//! cargo apk run --target aarch64-linux-android --lib\n//! ```\n//!\n//!\n//! Note Slint does not require a specific build tool and can work with others, such as [xbuild](https://github.com/rust-mobile/xbuild).\n\n/// Re-export of the android-activity crate.\n#[cfg(all(\n target_os = \"android\",\n any(feature = \"backend-android-activity-05\", feature = \"backend-android-activity-06\")\n))]\npub use i_slint_backend_android_activity::android_activity;\n\n#[cfg(not(all(\n target_os = \"android\",\n any(feature = \"backend-android-activity-05\", feature = \"backend-android-activity-06\")\n)))]\n/// Re-export of the [android-activity](https://docs.rs/android-activity) crate.\npub mod android_activity {\n #[doc(hidden)]\n pub struct AndroidApp;\n #[doc(hidden)]\n pub struct PollEvent<'a>(&'a ());\n}\n\n/// Re-export of AndroidApp from the [android-activity](https://docs.rs/android-activity) crate.\n#[doc(no_inline)]\npub use android_activity::AndroidApp;\n\nuse crate::platform::SetPlatformError;\n\n/// Initializes the Android backend.\n///\n/// **Note:** This function is only available on Android with the \"backend-android-activity-06\" feature\n///\n/// This function must be called from the `android_main` function before any call to Slint that needs a backend.\n///\n/// See the [module documentation](self) for an example on how to create Android application.\n///\n/// See also [`init_with_event_listener`]\npub fn init(app: android_activity::AndroidApp) -> Result<(), SetPlatformError> {\n #[cfg(not(target_os = \"android\"))]\n unreachable!();\n #[cfg(target_os = \"android\")]\n {\n crate::platform::set_platform(Box::new(\n i_slint_backend_android_activity::AndroidPlatform::new(app),\n ))\n }\n}\n\n/// Similar to [`init()`], which allow to listen to android-activity's event\n///\n/// **Note:** This function is only available on Android with the \"backend-android-activity-06\" feature\n///\n/// The listener argument is a function that takes a [`android_activity::PollEvent`](https://docs.rs/android-activity/latest/android_activity/enum.PollEvent.html)\n///\n/// # Example\n///\n/// ```rust\n/// # #[cfg(target_os = \"android\")]\n/// #[unsafe(no_mangle)]\n/// fn android_main(app: slint::android_activity::AndroidApp) {\n/// slint::android::init_with_event_listener(\n/// app,\n/// |event| { eprintln!(\"got event {event:?}\") }\n/// ).unwrap();\n///\n/// // ... rest of your application ...\n///\n/// }\n/// ```\n///\n/// Check out the [module documentation](self) for a more complete example on how to write an android application\npub fn init_with_event_listener(\n app: android_activity::AndroidApp,\n listener: impl Fn(&android_activity::PollEvent<'_>) + 'static,\n) -> Result<(), SetPlatformError> {\n #[cfg(not(target_os = \"android\"))]\n unreachable!();\n #[cfg(target_os = \"android\")]\n {\n crate::platform::set_platform(Box::new(\n i_slint_backend_android_activity::AndroidPlatform::new_with_event_listener(\n app, listener,\n ),\n ))\n }\n}\n" }, { "path": "api/rs/slint/compile_fail_tests.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n/**\nTest that the tokenizer properly rejects tokens with spaces.\n\nThis should work:\n\n```\nmod x {\n use slint::*;\n slint!{ Hello := Rectangle { } }\n}\n```\n\nBut his not:\n\n```compile_fail\nmod x {\n use slint::*;\n slint!{ Hello : = Rectangle { } }\n}\n```\n\n*/\n#[cfg(doctest)]\nconst basic: u32 = 0;\n\n/**\nTest that invalid rust-attr are compilation error\n\nThis should result in a `compile_error!(\"Error parsing @rust-attr for struct 'Foo' declared at tests/invalid_rust_attr.slint:4:12\"`\n```compile_fail\nuse slint::*;\nslint!{\n export { Foo } from \"tests/invalid_rust_attr.slint\";\n export component Hello inherits Window { }\n}\n```\n\nBut Foo is not used/generated, then we do not detect the error\n(Having the test here to test that the previous test would otherwise work, but it would also be ok to detect the error and make it an actual slint compile error)\n```\nuse slint::*;\nslint!{\n import { Foo } from \"tests/invalid_rust_attr.slint\";\n export component Hello inherits Window { }\n}\n```\n*/\nconst INVALID_RUST_ATTR: () = ();\n\n#[cfg(doctest)]\n#[doc = include_str!(\"README.md\")]\nconst CHECK_README_EXAMPLES: () = ();\n" }, { "path": "api/rs/slint/docs.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#![cfg(doc)]\n/*!\n This is a pseudo module which only exist for documentation purposes as a way to show\n the Slint documentation as part of rustdoc.\n\n - The [`generated_code`] module contains an [commented example](generated_code::SampleComponent)\n of what is generated from the `.slint` file\n*/\n\n// cSpell: ignore rustdoc\n\n/// This module exists only to explain the API of the code generated from `.slint` design markup. Its described structure\n/// is not really contained in the compiled crate.\npub mod generated_code {\n\n use crate::ComponentHandle;\n use crate::Global;\n use crate::Weak;\n use crate::Window;\n\n /// This an example of the API that is generated for a component in `.slint` design markup. This may help you understand\n /// what functions you can call and how you can pass data in and out.\n ///\n /// This is the source code:\n ///\n /// ```slint,no-preview\n /// export component SampleComponent inherits Window {\n /// in-out property counter;\n /// // note that dashes will be replaced by underscores in the generated code\n /// in-out property user-name;\n /// callback hello;\n /// public function do-something(x: int) -> bool { return x > 0; }\n /// // ... maybe more elements here\n /// }\n /// ```\n #[derive(Clone)]\n pub struct SampleComponent {\n _marker: core::marker::PhantomData<*mut ()>,\n }\n impl SampleComponent {\n /// Creates a new instance that is reference counted and pinned in memory.\n pub fn new() -> Result {\n unimplemented!()\n }\n\n /// A getter is generated for each property declared at the root of the component.\n /// In this case, this is the getter that returns the value of the `counter`\n /// property declared in the `.slint` design markup.\n pub fn get_counter(&self) -> i32 {\n unimplemented!()\n }\n /// A setter is generated for each property declared at the root of the component,\n /// In this case, this is the setter that sets the value of the `counter` property\n /// declared in the `.slint` design markup.\n pub fn set_counter(&self, value: i32) {}\n /// Returns the value of the `user_name` property declared in the `.slint` design markup.\n pub fn get_user_name(&self) -> crate::SharedString {\n unimplemented!()\n }\n /// Assigns a new value to the `user_name` property.\n pub fn set_user_name(&self, value: crate::SharedString) {}\n\n /// For each callback declared at the root of the component, a function to synchronously call that\n /// callback is generated. This is the function that calls the `hello` callback declared\n /// in the `.slint` design markup.\n pub fn invoke_hello(&self) {}\n /// For each callback declared at the root of the component, a function connect to that callback\n /// is generated. This is the function that registers the function f as callback when the\n /// callback `hello` is emitted. In order to access\n /// the component in the callback, you'd typically capture a weak reference obtained using\n /// [`ComponentHandle::as_weak`]\n /// and then upgrade it to a strong reference when the callback is run:\n /// ```ignore\n /// let sample = SampleComponent::new().unwrap();\n /// let sample_weak = sample.as_weak();\n /// sample.on_hello(move || {\n /// let sample = sample_weak.unwrap();\n /// sample.set_counter(42);\n /// });\n /// ```\n pub fn on_hello(&self, f: impl Fn() + 'static) {}\n\n /// For each public function declared at the root of the component, a function to synchronously call\n /// that function is generated. This is the function that calls the `do-something` function\n /// declared in the `.slint` design markup.\n pub fn invoke_do_something(&self, d: i32) -> bool {\n unimplemented!()\n }\n }\n\n impl ComponentHandle for SampleComponent {\n #[doc(hidden)]\n type WeakInner = ();\n\n /// Returns a new weak pointer.\n fn as_weak(&self) -> Weak {\n unimplemented!()\n }\n\n /// Returns a clone of this handle that's a strong reference.\n fn clone_strong(&self) -> Self {\n unimplemented!();\n }\n\n #[doc(hidden)]\n fn upgrade_from_weak_inner(_: &Self::WeakInner) -> Option {\n unimplemented!();\n }\n\n /// Convenience function for [`crate::Window::show()`]. This shows the window on the screen\n /// and maintains an extra strong reference while the window is visible. To react\n /// to events from the windowing system, such as draw requests or mouse/touch input, it is\n /// still necessary to spin the event loop, using [`crate::run_event_loop`].\n fn show(&self) -> Result<(), crate::PlatformError> {\n unimplemented!();\n }\n\n /// Convenience function for [`crate::Window::hide()`]. Hides the window, so that it is not\n /// visible anymore. The additional strong reference on the associated component, that was\n /// created when show() was called, is dropped.\n fn hide(&self) -> Result<(), crate::PlatformError> {\n unimplemented!();\n }\n\n /// Returns the Window associated with this component. The window API can be used\n /// to control different aspects of the integration into the windowing system,\n /// such as the position on the screen.\n fn window(&self) -> &Window {\n unimplemented!()\n }\n\n /// This is a convenience function that first calls [`Self::show`], followed by [`crate::run_event_loop()`]\n /// and [`Self::hide`].\n fn run(&self) -> Result<(), crate::PlatformError> {\n unimplemented!();\n }\n\n /// This function provides access to instances of global singletons exported in `.slint`.\n fn global<'a, T: Global<'a, Self>>(&'a self) -> T {\n unimplemented!()\n }\n }\n}\n\npub mod mcu {\n #![doc = include_str!(\"mcu.md\")]\n #[cfg(feature = \"renderer-software\")]\n use crate::platform::software_renderer::*;\n use crate::platform::*;\n mod slint {\n pub use crate::*;\n }\n}\n\n#[i_slint_core_macros::slint_doc]\npub mod cargo_features {\n //! # Feature flags and backend selection.\n //! Use the following feature flags in your Cargo.toml to enable additional features.\n //!\n #![cfg_attr(feature = \"document-features\", doc = document_features::document_features!())]\n //!\n //! More information about the backend and renderers is available in the\n //![Slint Documentation](slint:backends_and_renderers)\")]\n use crate::*;\n}\n\npub mod type_mappings {\n #![doc = include_str!(\"type-mappings.md\")]\n use crate::*;\n}\n" }, { "path": "api/rs/slint/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n// cSpell: ignore buildrs\n\n#![cfg_attr(docsrs, feature(doc_cfg))]\n\n/*!\n# Slint\n\nThis crate is the main entry point for embedding user interfaces designed with\n[Slint](https://slint.rs/) in Rust programs.\n*/\n#![doc = i_slint_core_macros::slint_doc_str!(\"If you are new to Slint, start with the [Walk-through **tutorial**](slint:quickstart).\")]\n/*! If you are already familiar with Slint, the following topics provide related information.\n\n## Topics\n\n*/\n#![doc = i_slint_core_macros::slint_doc_str!(\"- [The Slint Language Documentation](slint:index)\")]\n/*! - [Type mappings between .slint and Rust](docs::type_mappings)\n - [Feature flags and backend selection](docs::cargo_features)\n - [Slint on Microcontrollers](docs::mcu)\n\n## How to use this crate:\n\nDesigns of user interfaces are described in the `.slint` design markup language. There are three ways\nof including them in Rust:\n\n - The `.slint` code is [inline in a macro](#the-slint-code-in-a-macro).\n - The `.slint` code in [external files compiled with `build.rs`](#the-slint-code-in-external-files-is-compiled-with-buildrs)\n*/\n#![doc = i_slint_core_macros::slint_doc_str!(\" - The `.slint` code is loaded dynamically at run-time from the file system, by using the [interpreter API](slint:rust:slint_interpreter/).\")]\n/*!\n\nWith the first two methods, the markup code is translated to Rust code and each component is turned into a Rust\nstruct with functions. Use these functions to instantiate and show the component, and\nto access declared properties. Check out our [sample component](docs::generated_code::SampleComponent) for more\ninformation about the generation functions and how to use them.\n\n### The .slint code in a macro\n\nThis method combines your Rust code with the `.slint` design markup in one file, using a macro:\n\n```rust,no_run\nslint::slint!{\n export component HelloWorld inherits Window {\n Text {\n text: \"hello world\";\n color: green;\n }\n }\n}\nfn main() {\n HelloWorld::new().unwrap().run().unwrap();\n}\n```\n\n### The .slint code in external files is compiled with `build.rs`\n\nWhen your design becomes bigger in terms of markup code, you may want move it to a dedicated\n`.slint` file. */\n#![doc = i_slint_core_macros::slint_doc_str!(\"It's also possible to split a `.slint` file into multiple files using [modules](slint:modules).\")]\n/*!Use a [build script](https://doc.rust-lang.org/cargo/reference/build-scripts.html) to compile\nyour main `.slint` file:\n\n*/\n#![doc = i_slint_core_macros::slint_doc_str!(\"In your Cargo.toml add a `build` assignment and use the [`slint-build`](slint:rust:slint_build/) crate in `build-dependencies`:\")]\n/*!\n\n```toml\n[package]\n...\nbuild = \"build.rs\"\nedition = \"2021\"\n\n[dependencies]\nslint = \"1.15\"\n...\n\n[build-dependencies]\nslint-build = \"1.15\"\n```\n\nUse the API of the slint-build crate in the `build.rs` file:\n\n```rust,no_run\nfn main() {\n slint_build::compile(\"ui/hello.slint\").unwrap();\n}\n```\n\nFinally, use the [`include_modules!`] macro in your `main.rs`:\n\n```ignore\nslint::include_modules!();\nfn main() {\n HelloWorld::new().unwrap().run().unwrap();\n}\n```\n\nUse our [Template Repository](https://github.com/slint-ui/slint-rust-template) to create a skeleton file\nhierarchy that uses this method:\n\n1. Download and extract the [ZIP archive of the Rust Template](https://github.com/slint-ui/slint-rust-template/archive/refs/heads/main.zip).\n2. Rename the extracted directory and change into it:\n\n```bash\nmv slint-rust-template-main my-project\ncd my-project\n```\n\n## Generated components\n\nExported component from the macro or the main file that inherit `Window` or `Dialog` is mapped to a Rust structure.\n\nThe components are generated and re-exported to the location of the [`include_modules!`] or [`slint!`] macro.\nIt is represented as a struct with the same name as the component.\n\nFor example, if you have\n\n```slint,no-preview\nexport component MyComponent inherits Window { /*...*/ }\n```\n\nin the .slint file, it will create a\n```rust\nstruct MyComponent { /*...*/ }\n```\n\nSee also our [sample component](docs::generated_code::SampleComponent) for more information about the API of the generated struct.\n\nA component is instantiated using the [`fn new() -> Self`](docs::generated_code::SampleComponent::new) function. The following\nconvenience functions are available through the [`ComponentHandle`] implementation:\n\n - [`fn clone_strong(&self) -> Self`](docs::generated_code::SampleComponent::clone_strong): creates a strongly referenced clone of the component instance.\n - [`fn as_weak(&self) -> Weak`](docs::generated_code::SampleComponent::as_weak): to create a [weak](Weak) reference to the component instance.\n - [`fn show(&self)`](docs::generated_code::SampleComponent::show): to show the window of the component.\n - [`fn hide(&self)`](docs::generated_code::SampleComponent::hide): to hide the window of the component.\n - [`fn run(&self)`](docs::generated_code::SampleComponent::run): a convenience function that first calls `show()`,\n followed by spinning the event loop, and `hide()` when returning from the event loop.\n - [`fn global>(&self) -> T`](docs::generated_code::SampleComponent::global): an accessor to the global singletons,\n\nFor each top-level property\n - A setter [`fn set_(&self, value: )`](docs::generated_code::SampleComponent::set_counter)\n - A getter [`fn get_(&self) -> `](docs::generated_code::SampleComponent::get_counter)\n\nFor each top-level callback\n - [`fn invoke_(&self)`](docs::generated_code::SampleComponent::invoke_hello): to invoke the callback\n - [`fn on_(&self, callback: impl Fn() + 'static)`](docs::generated_code::SampleComponent::on_hello): to set the callback handler.\n\nNote: All dashes (`-`) are replaced by underscores (`_`) in names of types or functions.\n\nAfter instantiating the component, call [`ComponentHandle::run()`] on show it on the screen and spin the event loop to\nreact to input events. To show multiple components simultaneously, call [`ComponentHandle::show()`] on each instance.\nCall [`run_event_loop()`] when you're ready to enter the event loop.\n\nThe generated component struct acts as a handle holding a strong reference (similar to an `Rc`). The `Clone` trait is\nnot implemented. Instead you need to make explicit [`ComponentHandle::clone_strong`] and [`ComponentHandle::as_weak`]\ncalls. A strong reference should not be captured by the closures given to a callback, as this would produce a reference\nloop and leak the component. Instead, the callback function should capture a weak component.\n\n## Threading and Event-loop\n\nFor platform-specific reasons, the event loop must run in the main thread, in most backends, and all the components\nmust be created in the same thread as the thread the event loop is running or is going to run.\n\nYou should perform the minimum amount of work in the main thread and delegate the actual logic to another\nthread to avoid blocking animations. Use the [`invoke_from_event_loop`] function to communicate from your worker thread to the UI thread.\n\nTo run a function with a delay or with an interval use a [`Timer`].\n\nTo run an async function or a future, use [`spawn_local()`].\n\n## Exported Global singletons\n\n*/\n#![doc = i_slint_core_macros::slint_doc_str!(\"When you export a [global singleton](slint:globals) from the main file,\")]\n/*! it is also generated with the exported name. Like the main component, the generated struct have\ninherent method to access the properties and callback:\n\nFor each property\n - A setter: `fn set_(&self, value: )`\n - A getter: `fn get_(&self) -> `\n\nFor each callback\n - `fn invoke_(&self, ) -> ` to invoke the callback\n - `fn on_(&self, callback: impl Fn() + 'static)` to set the callback handler.\n\nThe global can be accessed with the [`ComponentHandle::global()`] function, or with [`Global::get()`]\n\nSee the [documentation of the `Global` trait](Global) for an example.\n\n**Note**: Global singletons are instantiated once per component. When declaring multiple components for `export` to Rust,\neach instance will have their own instance of associated globals singletons.\n*/\n\n#![warn(missing_docs)]\n#![deny(unsafe_code)]\n#![doc(html_logo_url = \"https://slint.dev/logo/slint-logo-square-light.svg\")]\n#![cfg_attr(not(feature = \"std\"), no_std)]\n#![allow(clippy::needless_doctest_main)] // We document how to write a main function\n\nextern crate alloc;\n\n#[cfg(not(feature = \"compat-1-2\"))]\ncompile_error!(\n \"The feature `compat-1-2` must be enabled to ensure \\\n forward compatibility with future version of this crate\"\n);\n\npub use slint_macros::slint;\n\npub use i_slint_backend_selector::api::*;\npub use i_slint_core::api::*;\n#[doc(hidden)]\n#[deprecated(note = \"Experimental type was made public by mistake\")]\npub use i_slint_core::component_factory::ComponentFactory;\n#[cfg(not(target_arch = \"wasm32\"))]\npub use i_slint_core::graphics::{BorrowedOpenGLTextureBuilder, BorrowedOpenGLTextureOrigin};\npub use i_slint_core::items::{StandardListViewItem, TableColumn};\npub use i_slint_core::model::{\n FilterModel, MapModel, Model, ModelExt, ModelNotify, ModelPeer, ModelRc, ModelTracker,\n ReverseModel, SortModel, VecModel,\n};\npub use i_slint_core::timers::{Timer, TimerMode};\npub use i_slint_core::translations::{SelectBundledTranslationError, select_bundled_translation};\n\npub mod private_unstable_api;\n\n/// Enters the main event loop. This is necessary in order to receive\n/// events from the windowing system for rendering to the screen\n/// and reacting to user input.\n/// This function will run until the last window is closed or until\n/// [`quit_event_loop()`] is called.\n///\n/// See also [`run_event_loop_until_quit()`] to keep the event loop running until\n/// [`quit_event_loop()`] is called, even if all windows are closed.\npub fn run_event_loop() -> Result<(), PlatformError> {\n i_slint_backend_selector::with_platform(|b| b.run_event_loop())\n}\n\n/// Similar to [`run_event_loop()`], but this function enters the main event loop\n/// and continues to run even when the last window is closed, until\n/// [`quit_event_loop()`] is called.\n///\n/// This is useful for system tray applications where the application needs to stay alive\n/// even if no windows are visible.\npub fn run_event_loop_until_quit() -> Result<(), PlatformError> {\n i_slint_backend_selector::with_platform(|b| {\n #[allow(deprecated)]\n b.set_event_loop_quit_on_last_window_closed(false);\n b.run_event_loop()\n })\n}\n\n/// Spawns a [`Future`] to execute in the Slint event loop.\n///\n/// This function is intended to be invoked only from the main Slint thread that runs the event loop.\n///\n/// For spawning a `Send` future from a different thread, this function should be called from a closure\n/// passed to [`invoke_from_event_loop()`].\n///\n/// This function is typically called from a UI callback.\n///\n/// # Example\n///\n/// ```rust,no_run\n/// slint::spawn_local(async move {\n/// // your async code goes here\n/// }).unwrap();\n/// ```\n///\n/// # Compatibility with Tokio and other runtimes\n///\n/// The runtime used to execute the future on the main thread is platform-dependent,\n/// for instance, it could be the winit event loop. Therefore, futures that assume a specific runtime\n/// may not work. This may be an issue if you call `.await` on a future created by another\n/// runtime, or pass the future directly to `spawn_local`.\n///\n/// Futures from the [smol](https://docs.rs/smol/latest/smol/) runtime always hand off their work to\n/// separate I/O threads that run in parallel to the Slint event loop.\n///\n/// The [Tokio](https://docs.rs/tokio/latest/tokio/index.html) runtime is subject to the following constraints:\n///\n/// * Tokio futures require entering the context of a global Tokio runtime.\n/// * Tokio futures aren't guaranteed to hand off their work to separate threads and may therefore not complete, because\n/// the Slint runtime can't drive the Tokio runtime.\n/// * Tokio futures require regular yielding to the Tokio runtime for fairness, a constraint that also can't be met by Slint.\n/// * Tokio's [current-thread schedule](https://docs.rs/tokio/latest/tokio/runtime/index.html#current-thread-scheduler)\n/// cannot be used in Slint main thread, because Slint cannot yield to it.\n///\n/// To address these constraints, use [async_compat](https://docs.rs/async-compat/latest/async_compat/index.html)'s [Compat::new()](https://docs.rs/async-compat/latest/async_compat/struct.Compat.html#method.new)\n/// to implicitly allocate a shared, multi-threaded Tokio runtime that will be used for Tokio futures.\n///\n/// The following little example demonstrates the use of Tokio's [`TcpStream`](https://docs.rs/tokio/latest/tokio/net/struct.TcpStream.html) to\n/// read from a network socket. The entire future passed to `spawn_local()` is wrapped in `Compat::new()` to make it run:\n///\n/// ```rust,no_run\n/// // A dummy TCP server that once reports \"Hello World\"\n/// # i_slint_backend_testing::init_integration_test_with_mock_time();\n/// use std::io::Write;\n///\n/// let listener = std::net::TcpListener::bind(\"127.0.0.1:0\").unwrap();\n/// let local_addr = listener.local_addr().unwrap();\n/// let server = std::thread::spawn(move || {\n/// let mut stream = listener.incoming().next().unwrap().unwrap();\n/// stream.write(\"Hello World\".as_bytes()).unwrap();\n/// });\n///\n/// let slint_future = async move {\n/// use tokio::io::AsyncReadExt;\n/// let mut stream = tokio::net::TcpStream::connect(local_addr).await.unwrap();\n/// let mut data = Vec::new();\n/// stream.read_to_end(&mut data).await.unwrap();\n/// assert_eq!(data, \"Hello World\".as_bytes());\n/// slint::quit_event_loop().unwrap();\n/// };\n///\n/// // Wrap the future that includes Tokio futures in async_compat's `Compat` to ensure\n/// // presence of a Tokio run-time.\n/// slint::spawn_local(async_compat::Compat::new(slint_future)).unwrap();\n///\n/// slint::run_event_loop_until_quit().unwrap();\n///\n/// server.join().unwrap();\n/// ```\n///\n/// The use of `#[tokio::main]` is **not recommended**. If it's necessary to use though, wrap the call to enter the Slint\n/// event loop in a call to [`tokio::task::block_in_place`](https://docs.rs/tokio/latest/tokio/task/fn.block_in_place.html):\n///\n/// ```rust, no_run\n/// // Wrap the call to run_event_loop to ensure presence of a Tokio run-time.\n/// tokio::task::block_in_place(slint::run_event_loop).unwrap();\n/// ```\n#[cfg(target_has_atomic = \"ptr\")]\npub fn spawn_local(\n fut: F,\n) -> Result, EventLoopError> {\n i_slint_backend_selector::with_global_context(|ctx| ctx.spawn_local(fut))\n .map_err(|_| EventLoopError::NoEventLoopProvider)?\n}\n\n#[i_slint_core_macros::slint_doc]\n/// Include the code generated with the slint-build crate from the build script. After calling `slint_build::compile`\n/// in your `build.rs` build script, the use of this macro includes the generated Rust code and makes the exported types\n/// available for you to instantiate.\n///\n/// Check the documentation of the [`slint-build`](slint:rust:slint_build) crate for more information.\n#[macro_export]\nmacro_rules! include_modules {\n () => {\n include!(env!(\"SLINT_INCLUDE_GENERATED\"));\n };\n}\n\n#[i_slint_core_macros::slint_doc]\n/// Initialize translations when using the `gettext` feature.\n///\n/// Call this in your main function with the path where translations are located.\n/// This macro internally calls the [`bindtextdomain`](https://man7.org/linux/man-pages/man3/bindtextdomain.3.html) function from gettext.\n///\n/// The first argument of the macro must be an expression that implements `Into`.\n/// It specifies the directory in which gettext should search for translations.\n///\n/// Translations are expected to be found at `//LC_MESSAGES/.mo`,\n/// where `dirname` is the directory passed as an argument to this macro,\n/// `locale` is a locale name (e.g., `en`, `en_GB`, `fr`), and\n/// `crate` is the package name obtained from the `CARGO_PKG_NAME` environment variable.\n///\n/// See also the [Translation documentation](slint:translations).\n///\n/// ### Example\n/// ```rust\n/// fn main() {\n/// slint::init_translations!(concat!(env!(\"CARGO_MANIFEST_DIR\"), \"/translations/\"));\n/// // ...\n/// }\n/// ```\n///\n/// For example, assuming this is in a crate called `example` and the default locale\n/// is configured to be French, it will load translations at runtime from\n/// `/path/to/example/translations/fr/LC_MESSAGES/example.mo`.\n///\n/// Another example of loading translations relative to the executable:\n/// ```rust\n/// slint::init_translations!(std::env::current_exe().unwrap().parent().unwrap().join(\"translations\"));\n/// ```\n#[cfg(feature = \"gettext\")]\n#[macro_export]\nmacro_rules! init_translations {\n ($dirname:expr) => {\n $crate::private_unstable_api::init_translations(env!(\"CARGO_PKG_NAME\"), $dirname);\n };\n}\n\n/// This module contains items that you need to use or implement if you want use Slint in an environment without\n/// one of the supplied platform backends such as qt or winit.\n///\n/// The primary interface is the [`platform::Platform`] trait. Pass your implementation of it to Slint by calling\n/// [`platform::set_platform()`] early on in your application, before creating any Slint components.\n///\n/// The [Slint on Microcontrollers](crate::docs::mcu) documentation has additional examples.\npub mod platform {\n pub use i_slint_core::platform::*;\n\n /// This module contains the [`femtovg_renderer::FemtoVGRenderer`] and related types.\n ///\n /// It is only enabled when the `renderer-femtovg` Slint feature is enabled.\n #[cfg(all(\n not(target_os = \"android\"),\n any(feature = \"renderer-femtovg\", feature = \"renderer-femtovg-wgpu\")\n ))]\n pub mod femtovg_renderer {\n #[cfg(feature = \"renderer-femtovg\")]\n pub use i_slint_renderer_femtovg::FemtoVGOpenGLRenderer as FemtoVGRenderer;\n /// Use this type to render to a WGPU texture using FemtoVG.\n #[cfg(feature = \"unstable-wgpu-28\")]\n pub use i_slint_renderer_femtovg::FemtoVGWGPURenderer;\n #[cfg(feature = \"renderer-femtovg\")]\n pub use i_slint_renderer_femtovg::opengl::OpenGLInterface;\n }\n\n #[cfg(feature = \"renderer-software\")]\n /// This module contains the [`software_renderer::SoftwareRenderer`] and related types.\n ///\n /// It is only enabled when the `renderer-software` Slint feature is enabled.\n pub mod software_renderer {\n pub use i_slint_renderer_software::*;\n }\n}\n\n#[i_slint_core_macros::slint_doc]\n/// This module contains some of the enums and structs from the Slint language.\n///\n/// See also the list of [global structs and enums](slint:StructType)\npub mod language {\n pub use i_slint_core::items::ColorScheme;\n\n macro_rules! export_builtin_structs {\n ($(\n $(#[$attr:meta])*\n struct $Name:ident {\n @name = $NameTy:ident :: $NameVariant:ident,\n export {\n $( $(#[$pub_attr:meta])* $pub_field:ident : $pub_type:ty, )*\n }\n private {\n $( $(#[$pri_attr:meta])* $pri_field:ident : $pri_type:ty, )*\n }\n }\n )*) => {\n $(\n export_builtin_structs!(@export $NameTy $Name);\n )*\n };\n (@export BuiltinPublicStruct $Name:ident) => {\n pub use i_slint_core::items::$Name;\n };\n (@export BuiltinPrivateStruct $Name:ident) => {};\n }\n\n i_slint_common::for_each_builtin_structs!(export_builtin_structs);\n}\n\n#[cfg(any(\n doc,\n all(\n target_os = \"android\",\n any(feature = \"backend-android-activity-05\", feature = \"backend-android-activity-06\")\n )\n))]\npub mod android;\n\n/// Helper type that helps checking that the generated code is generated for the right version\n#[doc(hidden)]\n#[allow(non_camel_case_types)]\npub struct VersionCheck_1_16_0;\n\n#[cfg(doctest)]\nmod compile_fail_tests;\n\n#[cfg(doc)]\npub mod docs;\n\n#[cfg(feature = \"unstable-wgpu-27\")]\npub mod wgpu_27 {\n //! WGPU 27.x specific types and re-exports.\n //!\n //! *Note*: This module is behind a feature flag and may be removed or changed in future minor releases,\n //! as new major WGPU releases become available.\n //!\n //! Use the types in this module in combination with other APIs to integrate external, WGPU-based rendering engines\n //! into a UI with Slint.\n //!\n //! First, ensure that WGPU is used for rendering with Slint by using [`slint::BackendSelector::require_wgpu_27()`](i_slint_backend_selector::api::BackendSelector::require_wgpu_27()).\n //! This function accepts a pre-configured WGPU setup or configuration hints such as required features or memory limits.\n //!\n //! For rendering, it's crucial that you're using the same [`wgpu::Device`] and [`wgpu::Queue`] for allocating textures or submitting commands as Slint. Obtain the same queue\n //! by either using [`WGPUConfiguration::Manual`] to make Slint use an existing WGPU configuration, or use [`slint::Window::set_rendering_notifier()`](i_slint_core::api::Window::set_rendering_notifier())\n //! to let Slint invoke a callback that provides access device, queue, etc. in [`slint::GraphicsAPI::WGPU27`](i_slint_core::api::GraphicsAPI::WGPU27).\n //!\n //! To integrate rendering content into a scene shared with a Slint UI, use either [`slint::Window::set_rendering_notifier()`](i_slint_core::api::Window::set_rendering_notifier()) to render an underlay\n //! or overlay, or integrate externally produced [`wgpu::Texture`]s using [`slint::Image::try_from()`](i_slint_core::graphics::Image::try_from).\n //!\n //! The following example allocates a [`wgpu::Texture`] and, for the sake of simplicity in this documentation, fills with green as color, and then proceeds to set it as a `slint::Image` in the scene.\n //!\n //! `Cargo.toml`:\n //! ```toml\n //! slint = { version = \"~1.16\", features = [\"unstable-wgpu-27\"] }\n //! ```\n //!\n //! `main.rs`:\n //!```rust,no_run\n //!\n //! use slint::wgpu_27::wgpu;\n //! use wgpu::util::DeviceExt;\n //!\n //!slint::slint!{\n //! export component HelloWorld inherits Window {\n //! preferred-width: 320px;\n //! preferred-height: 300px;\n //! in-out property app-texture;\n //! VerticalLayout {\n //! Text {\n //! text: \"hello world\";\n //! color: green;\n //! }\n //! Image { source: root.app-texture; }\n //! }\n //! }\n //!}\n //!fn main() -> Result<(), Box> {\n //! slint::BackendSelector::new()\n //! .require_wgpu_27(slint::wgpu_27::WGPUConfiguration::default())\n //! .select()?;\n //! let app = HelloWorld::new()?;\n //!\n //! let app_weak = app.as_weak();\n //!\n //! app.window().set_rendering_notifier(move |state, graphics_api| {\n //! let (Some(app), slint::RenderingState::RenderingSetup, slint::GraphicsAPI::WGPU27{ device, queue, ..}) = (app_weak.upgrade(), state, graphics_api) else {\n //! return;\n //! };\n //!\n //! let mut pixels = slint::SharedPixelBuffer::::new(320, 200);\n //! pixels.make_mut_slice().fill(slint::Rgba8Pixel {\n //! r: 0,\n //! g: 255,\n //! b :0,\n //! a: 255,\n //! });\n //!\n //! let texture = device.create_texture_with_data(queue,\n //! &wgpu::TextureDescriptor {\n //! label: None,\n //! size: wgpu::Extent3d { width: 320, height: 200, depth_or_array_layers: 1 },\n //! mip_level_count: 1,\n //! sample_count: 1,\n //! dimension: wgpu::TextureDimension::D2,\n //! format: wgpu::TextureFormat::Rgba8Unorm,\n //! usage: wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::TEXTURE_BINDING,\n //! view_formats: &[],\n //! },\n //! wgpu::util::TextureDataOrder::default(),\n //! pixels.as_bytes(),\n //! );\n //!\n //! let imported_image = slint::Image::try_from(texture).unwrap();\n //!\n //! app.set_app_texture(imported_image);\n //! })?;\n //!\n //! app.run()?;\n //!\n //! Ok(())\n //!}\n //!```\n //!\n pub use i_slint_core::graphics::wgpu_27::api::*;\n}\n#[cfg(feature = \"unstable-wgpu-28\")]\npub mod wgpu_28 {\n //! WGPU 28.x specific types and re-exports.\n //!\n //! *Note*: This module is behind a feature flag and may be removed or changed in future minor releases,\n //! as new major WGPU releases become available.\n //!\n //! Use the types in this module in combination with other APIs to integrate external, WGPU-based rendering engines\n //! into a UI with Slint.\n //!\n //! First, ensure that WGPU is used for rendering with Slint by using [`slint::BackendSelector::require_wgpu_28()`](i_slint_backend_selector::api::BackendSelector::require_wgpu_28()).\n //! This function accepts a pre-configured WGPU setup or configuration hints such as required features or memory limits.\n //!\n //! For rendering, it's crucial that you're using the same [`wgpu::Device`] and [`wgpu::Queue`] for allocating textures or submitting commands as Slint. Obtain the same queue\n //! by either using [`WGPUConfiguration::Manual`] to make Slint use an existing WGPU configuration, or use [`slint::Window::set_rendering_notifier()`](i_slint_core::api::Window::set_rendering_notifier())\n //! to let Slint invoke a callback that provides access device, queue, etc. in [`slint::GraphicsAPI::WGPU28`](i_slint_core::api::GraphicsAPI::WGPU28).\n //!\n //! To integrate rendering content into a scene shared with a Slint UI, use either [`slint::Window::set_rendering_notifier()`](i_slint_core::api::Window::set_rendering_notifier()) to render an underlay\n //! or overlay, or integrate externally produced [`wgpu::Texture`]s using [`slint::Image::try_from()`](i_slint_core::graphics::Image::try_from).\n //!\n //! The following example allocates a [`wgpu::Texture`] and, for the sake of simplicity in this documentation, fills with green as color, and then proceeds to set it as a `slint::Image` in the scene.\n //!\n //! `Cargo.toml`:\n //! ```toml\n //! slint = { version = \"~1.16\", features = [\"unstable-wgpu-28\"] }\n //! ```\n //!\n //! `main.rs`:\n //!```rust,no_run\n //!\n //! use slint::wgpu_28::wgpu;\n //! use wgpu::util::DeviceExt;\n //!\n //!slint::slint!{\n //! export component HelloWorld inherits Window {\n //! preferred-width: 320px;\n //! preferred-height: 300px;\n //! in-out property app-texture;\n //! VerticalLayout {\n //! Text {\n //! text: \"hello world\";\n //! color: green;\n //! }\n //! Image { source: root.app-texture; }\n //! }\n //! }\n //!}\n //!fn main() -> Result<(), Box> {\n //! slint::BackendSelector::new()\n //! .require_wgpu_28(slint::wgpu_28::WGPUConfiguration::default())\n //! .select()?;\n //! let app = HelloWorld::new()?;\n //!\n //! let app_weak = app.as_weak();\n //!\n //! app.window().set_rendering_notifier(move |state, graphics_api| {\n //! let (Some(app), slint::RenderingState::RenderingSetup, slint::GraphicsAPI::WGPU28{ device, queue, ..}) = (app_weak.upgrade(), state, graphics_api) else {\n //! return;\n //! };\n //!\n //! let mut pixels = slint::SharedPixelBuffer::::new(320, 200);\n //! pixels.make_mut_slice().fill(slint::Rgba8Pixel {\n //! r: 0,\n //! g: 255,\n //! b :0,\n //! a: 255,\n //! });\n //!\n //! let texture = device.create_texture_with_data(queue,\n //! &wgpu::TextureDescriptor {\n //! label: None,\n //! size: wgpu::Extent3d { width: 320, height: 200, depth_or_array_layers: 1 },\n //! mip_level_count: 1,\n //! sample_count: 1,\n //! dimension: wgpu::TextureDimension::D2,\n //! format: wgpu::TextureFormat::Rgba8Unorm,\n //! usage: wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::TEXTURE_BINDING,\n //! view_formats: &[],\n //! },\n //! wgpu::util::TextureDataOrder::default(),\n //! pixels.as_bytes(),\n //! );\n //!\n //! let imported_image = slint::Image::try_from(texture).unwrap();\n //!\n //! app.set_app_texture(imported_image);\n //! })?;\n //!\n //! app.run()?;\n //!\n //! Ok(())\n //!}\n //!```\n //!\n pub use i_slint_core::graphics::wgpu_28::api::*;\n}\n\n#[cfg(feature = \"unstable-winit-030\")]\npub mod winit_030 {\n //! Winit 0.30.x specific types and re-exports.\n //!\n //! *Note*: This module is behind a feature flag and may be removed or changed in future minor releases,\n //! as new major Winit releases become available.\n //!\n //! Use the types and traits in this module in combination with other APIs to access additional window properties,\n //! create custom windows, or hook into the winit event loop.\n //!\n //! For example, use the [`WinitWindowAccessor`] to obtain access to the underling [`winit::window::Window`]:\n //!\n //! `Cargo.toml`:\n //! ```toml\n //! slint = { version = \"~1.16\", features = [\"unstable-winit-030\"] }\n //! ```\n //!\n //! `main.rs`:\n //! ```rust,no_run\n //! // Bring winit and accessor traits into scope.\n //! use slint::winit_030::{WinitWindowAccessor, winit};\n //!\n //! slint::slint!{\n //! import { VerticalBox, Button } from \"std-widgets.slint\";\n //! export component HelloWorld inherits Window {\n //! callback clicked;\n //! VerticalBox {\n //! Text {\n //! text: \"hello world\";\n //! color: green;\n //! }\n //! Button {\n //! text: \"Click me\";\n //! clicked => { root.clicked(); }\n //! }\n //! }\n //! }\n //! }\n //! fn main() -> Result<(), Box> {\n //! // Make sure the winit backed is selected:\n //! slint::BackendSelector::new()\n //! .backend_name(\"winit\".into())\n //! .select()?;\n //!\n //! let app = HelloWorld::new()?;\n //! let app_weak = app.as_weak();\n //! app.on_clicked(move || {\n //! // access the winit window\n //! let app = app_weak.unwrap();\n //! app.window().with_winit_window(|winit_window: &winit::window::Window| {\n //! eprintln!(\"window id = {:#?}\", winit_window.id());\n //! });\n //! });\n //! app.run()?;\n //! Ok(())\n //! }\n //! ```\n //! See also [`BackendSelector::with_winit_event_loop_builder()`](crate::BackendSelector::with_winit_event_loop_builder())\n //! and [`BackendSelector::with_winit_window_attributes_hook()`](crate::BackendSelector::with_winit_window_attributes_hook()).\n\n pub use i_slint_backend_winit::{\n CustomApplicationHandler, EventLoopBuilder, EventResult, SlintEvent, WinitWindowAccessor,\n winit,\n };\n\n #[deprecated(note = \"Renamed to `EventResult`\")]\n /// Deprecated alias to [`EventResult`]\n pub type WinitWindowEventResult = EventResult;\n}\n\n#[cfg(feature = \"unstable-fontique-07\")]\npub mod fontique_07 {\n //! Fontique 0.7 specific types and re-exports.\n //!\n //! *Note*: This module is behind a feature flag and may be removed or changed in future minor releases,\n //! as new major Fontique releases become available.\n //!\n //! Use the types, functions, and re-exports in this module to register custom fonts at run-time for use\n //! by Slint's renderers.\n\n pub use i_slint_common::sharedfontique::fontique;\n\n #[i_slint_core_macros::slint_doc]\n /// Returns a clone of [`fontique::Collection`] that's used by Slint for text rendering. It's set up\n /// with shared storage, so fonts registered with the returned collection or additionally configured font\n /// fallbacks apply to the entire process.\n ///\n /// Note: The recommended way of including custom fonts is at compile time of Slint files. For details,\n /// see also the [Font Handling](slint:FontHandling) documentation.\n ///\n /// The example below sketches out the steps for registering a downloaded font to add additional glyph\n /// coverage for Japanese text:\n ///\n /// `Cargo.toml`:\n /// ```toml\n /// slint = { version = \"~1.16\", features = [\"unstable-fontique-07\"] }\n /// ```\n ///\n /// `main.rs`:\n /// ```rust,no_run\n /// use slint::fontique_07::fontique;\n ///\n /// fn main() {\n /// // ...\n /// let downloaded_font: Vec = todo!(\"Download https://somewebsite.com/font.ttf\");\n /// let blob = fontique::Blob::new(std::sync::Arc::new(downloaded_font));\n /// let mut collection = slint::fontique_07::shared_collection();\n /// let fonts = collection.register_fonts(blob, None);\n /// collection\n /// .append_fallbacks(fontique::FallbackKey::new(\"Hira\", None), fonts.iter().map(|x| x.0));\n /// collection\n /// .append_fallbacks(fontique::FallbackKey::new(\"Kana\", None), fonts.iter().map(|x| x.0));\n /// collection\n /// .append_fallbacks(fontique::FallbackKey::new(\"Hani\", None), fonts.iter().map(|x| x.0));\n /// // ...\n /// }\n /// ```\n pub fn shared_collection() -> fontique::Collection {\n i_slint_core::with_global_context(\n || panic!(\"slint platform not initialized\"),\n |ctx| ctx.font_context().borrow().collection.clone(),\n )\n .unwrap()\n }\n}\n" }, { "path": "api/rs/slint/mcu.md", "content": "# Slint on Microcontrollers\n\n![](https://slint.dev/blog/porting-slint-to-microcontrollers/rp-pico_and_screen.jpg)\n\nThe following sections explain how to use Slint to develop a UI on a Microcontroller (MCU) in a bare metal environment.\n\n## Prerequisites\n\nWriting an application in Rust that runs on a MCU requires several prerequisites:\n\n* Install a Rust toolchain to cross-compile to the target architecture.\n* Locate and select the correct Hardware Abstraction Layer (HAL) crates and drivers, and depend on them in your `Cargo.toml`.\n* Install tools for flashing and debugging your code on the device.\n\nWe recommend reading the [Rust Embedded Book](https://docs.rust-embedded.org/book/),\nand the curated list of [Awesome Embedded Rust](https://github.com/rust-embedded/awesome-embedded-rust) for a wide range of\ncrates, tools, and training materials. These resources should guide you through the initial setup. Many include a \"hello world\" example\nto get started with your device.\n\nSlint requires a global memory allocator in a bare metal environment with `#![no_std]`.\n\nThe following sections assume that your setup is complete and you have a non-graphical skeleton Rust program running on your MCU.\n\n## Changes to `Cargo.toml`\n\nStart by adding a dependency to the `slint` and the `slint-build` crates to your `Cargo.toml` using the `cargo` command:\n\nStart with the `slint` crate like this:\n\n```sh\ncargo add slint@1.15 --no-default-features --features \"compat-1-2 unsafe-single-threaded libm renderer-software\"\n```\n\nThe default features of the `slint` crate are tailored towards hosted environments and includes the \"std\" feature. In bare metal environments,\nyou need to disable the default features.\n\nIn the snippet above, three features are selected:\n\n * `compat-1-2`: We select this feature when disabling the default features. For a detailed explanation see our blog post [\"Adding default cargo features without breaking Semantic Versioning\"](https://slint.dev/blog/rust-adding-default-cargo-feature.html).\n * `unsafe-single-threaded`: Slint internally uses Rust's [`thread_local!`](https://doc.rust-lang.org/std/macro.thread_local.html) macro to store global data.\n This macro is only available in the Rust Standard Library (std), but not in bare metal environments. As a fallback, the `unsafe-single-threaded`\n feature changes Slint to use unsafe static for storage. This way, you guarantee to use Slint API only from a single thread, and not from interrupt handlers.\n * `libm`: We select this feature to enable the use of the [libm](https://crates.io/crates/libm) crate to provide traits and functions for floating point arithmetic.\n They're typically provided by the Rust Standard Library (std), but that's not available in bare metal environments.\n * `renderer-software`: We select this feature to use Slint's built-in software renderer.\n\nIt might be necessary to enable the [Feature resolver version 2](https://doc.rust-lang.org/cargo/reference/features.html#feature-resolver-version-2)\nin your Cargo.toml if you notice that your dependencies are attempting to build with `std` support even when disabled.\nThis is the default when using the Rust 2021 Edition, but not if you use a workspace.\n\nThen add the `slint-build` crate as a build dependency:\n\n```sh\ncargo add --build slint-build@1.15\n```\n\nFor reference: These are the relevant parts of your `Cargo.toml` file,\nready to use Slint:\n\n```toml\n[package]\n## ...\n## Edition 2021 or later enables the feature resolver version 2.\nedition = \"2021\"\n\n[dependencies]\n## ... your other dependencies\n\n[dependencies.slint]\nversion = \"1.15\"\ndefault-features = false\nfeatures = [\"compat-1-2\", \"unsafe-single-threaded\", \"libm\", \"renderer-software\"]\n[build-dependencies]\nslint-build = \"1.15\"\n```\n\n## Changes to `build.rs`\n\nNext, write a build script to compile the `.slint` files to Rust code for embedding into the program binary, using the `slint-build` crate:\n\n```rust,no_run\nfn main() {\n slint_build::compile_with_config(\n \"ui/main.slint\",\n slint_build::CompilerConfiguration::new()\n .embed_resources(slint_build::EmbedResourcesKind::EmbedForSoftwareRenderer),\n ).unwrap();\n}\n```\n\nUse the `slint_build::EmbedResourcesKind::EmbedForSoftwareRenderer` configuration option to tell the Slint compiler to embed the images and fonts in the binary\nin a format that's suitable for the software based renderer we're going to use.\n\n## Application Structure\n\nTypically, a graphical application in hosted environments has at least three different tasks:\n\n * Receives user input from operation system APIs.\n * Reacts to the input by performing application specific computations.\n * Renders an updated user interface and presents it on the screen using device-independent operating system APIs.\n\nThe operating system provides an event loop to connect and schedule these tasks. Slint implements the\ntask of receiving user input and forwarding it to the user interface layer, and rendering the user interface to the screen.\n\nIn bare metal environments it's your responsibility to substitute and connect functionality that's otherwise provided by the operating system:\n\n * Select crates that allow you to initialize the chips that operate peripherals, such as a touch input or display controller.\n If there are no crates, you may have to to develop your own drivers.\n * Drive the event loop yourself by querying peripherals for input, forwarding that input into computational modules of your\n application and instructing Slint to render the user interface.\n\nIn Slint, the two primary APIs you need to use to accomplish these tasks are the [`slint::platform::Platform`] trait and the [`slint::Window`] struct.\nIn the following sections we're going to cover how to use them and how they integrate into your event loop.\n\n### The `Platform` Trait\n\nThe [`slint::platform::Platform`] trait defines the interface between Slint and platform APIs typically provided by operating and windowing systems.\n\nYou need to provide a minimal implementation of this trait and call [`slint::platform::set_platform`] before constructing your Slint application.\n\nThis minimal implementation needs to cover two functions:\n\n * `fn create_window_adapter(&self) -> Result, PlatformError>;`: Implement this function to return an implementation of the `WindowAdapter`\n trait that will be associated with the Slint components you create. We provide a convenience struct [`slint::platform::software_renderer::MinimalSoftwareWindow`]\n that implements this trait.\n * `fn duration_since_start(&self) -> Duration`: For animations in `.slint` design files to change properties correctly, Slint needs to know\n how much time has elapsed between two rendered frames. In a bare metal environment you need to provide a source of time. Often the HAL crate of your\n device provides a system timer API for this, which you can query in your implementation.\n\nYou may override more functions of this trait, for example to handle debug output, to delegate the event loop,\nor to deliver events in multi-threaded environments.\n\nA typical minimal implementation of the [`Platform`] trait that uses the [`MinimalSoftwareWindow`] looks like this:\n\n```rust,no_run\n#![no_std]\nextern crate alloc;\nuse alloc::{rc::Rc, boxed::Box};\n# mod hal { pub struct Timer(); impl Timer { pub fn get_time(&self) -> u64 { todo!() } } }\nuse slint::platform::{Platform, software_renderer::MinimalSoftwareWindow};\n\n# slint::slint!{ export MyUI := Window {} } /*\nslint::include_modules!();\n# */\n\nstruct MyPlatform {\n window: Rc,\n // optional: some timer device from your device's HAL crate\n timer: hal::Timer,\n // ... maybe more devices\n}\n\nimpl Platform for MyPlatform {\n fn create_window_adapter(&self) -> Result, slint::PlatformError> {\n // Since on MCUs, there can be only one window, just return a clone of self.window.\n // We'll also use the same window in the event loop.\n Ok(self.window.clone())\n }\n fn duration_since_start(&self) -> core::time::Duration {\n core::time::Duration::from_micros(self.timer.get_time())\n }\n // optional: You can put the event loop there, or in the main function, see later\n fn run_event_loop(&self) -> Result<(), slint::PlatformError> {\n todo!();\n }\n}\n\n// #[hal::entry]\nfn main() {\n // Initialize the heap allocator, peripheral devices and other things.\n // ...\n\n // Initialize a window (we'll need it later).\n let window = MinimalSoftwareWindow::new(Default::default());\n slint::platform::set_platform(Box::new(MyPlatform {\n window: window.clone(),\n timer: hal::Timer(/*...*/),\n //...\n }))\n .unwrap();\n\n // Setup the UI.\n let ui = MyUI::new();\n // ... setup callback and properties on `ui` ...\n\n // Make sure the window covers our entire screen.\n window.set_size(slint::PhysicalSize::new(320, 240));\n\n // ... start event loop (see later) ...\n}\n```\n\n### The Event Loop\n\nWith a `Platform` in place, you can write the main event loop to drive all the different tasks.\n\nYou can choose between two options:\n\n * You can implement [`slint::platform::Platform::run_event_loop`]: Use this if you want to start the\n event loop in a way similar to desktop platforms, using the [`run()`](slint::ComponentHandle::run) function\n of your component, or use [`slint::run_event_loop()`]. Both of these functions will call your implementation\n of [`slint::platform::Platform::run_event_loop`].\n * Implement a `loop { ... }` directly in your main function: This is called a super loop architecture and common\n for programs running in bare metal environments on MCUs. It allows you to initialize you device peripherals\n and access them without the need to move them into your `Platform` implementation.\n\nA typical super loop with Slint combines the tasks of querying input drivers, application specific computations,\nrendering and possibly putting the device into a low-power sleep state. Below is an example:\n\n```rust,no_run\nuse slint::platform::software_renderer::MinimalSoftwareWindow;\nlet window = MinimalSoftwareWindow::new(Default::default());\n# fn check_for_touch_event() -> Option { todo!() }\n# mod hal { pub fn wfi() {} }\n//...\nloop {\n // Let Slint run the timer hooks and update animations.\n slint::platform::update_timers_and_animations();\n\n // Check the touch screen or input device using your driver.\n if let Some(event) = check_for_touch_event(/*...*/) {\n // convert the event from the driver into a `slint::platform::WindowEvent`\n // and pass it to the window.\n window.try_dispatch_event(event).unwrap();\n }\n\n // ... maybe some more application logic ...\n\n // Draw the scene if something needs to be drawn.\n window.draw_if_needed(|renderer| {\n // see next section about rendering.\n todo!()\n });\n\n // Try to put the MCU to sleep\n if !window.has_active_animations() {\n if let Some(duration) = slint::platform::duration_until_next_timer_update() {\n // ... schedule a timer interrupt in `duration` ...\n }\n hal::wfi(); // Wait for interrupt\n }\n}\n\n```\n\n### The Renderer\n\nIn desktop and embedded environments, Slint typically uses operating system provided APIs to render the user interface using the GPU.\nIn contrast, most MCUs don't have GPUs. Instead, software rendering is used where all rendering is done by software on the CPU.\nSlint provides a SoftwareRenderer for this task.\n\nIn the earlier example, we've instantiated a [`slint::platform::software_renderer::MinimalSoftwareWindow`]. This struct implements the\n`slint::platform::WindowAdapter` trait and also holds an instance of a [`slint::platform::software_renderer::SoftwareRenderer`]. You access it\nthrough the callback parameter of the [`draw_if_needed()`](MinimalSoftwareWindow::draw_if_needed) function.\nDepending on the amount of RAM your MCU has, and the kind of screen attached, you can choose between two different ways of using the renderer:\n\n * Use the [`SoftwareRenderer::render()`] function if you have enough RAM to allocate one, or even two, copies of the entire screen (also known as\n frame buffer).\n * Use the [`SoftwareRenderer::render_by_line()`] function to render the entire user interface line by line and send each line of pixels to the screen,\n typically via the SPI. This requires allocating at least enough RAM to store one single line of pixels.\n\nWith both methods Slint renders into a provided buffer, which is a slice of a type that implements the [`slint::platform::software_renderer::TargetPixel`] trait.\nFor convenience, Slint provides an implementation for [`slint::Rgb8Pixel`] and [`slint::platform::software_renderer::Rgb565Pixel`].\n\n#### Rendering Into a Buffer\n\nThe following example uses double buffering and swaps between two buffers. This\nrequires a graphics driver that takes the address of the currently displayed\nframe buffer, also known as front buffer. A dedicated chip is then responsible\nfor reading from RAM and transferring the contents to the attached screen,\nwithout any interference of the CPU. Meanwhile, Slint renders into the second\nbuffer, the back buffer.\n\n```rust,no_run\nuse slint::platform::software_renderer::Rgb565Pixel;\n# fn is_swap_pending()->bool {false} fn swap_buffers() {}\n\n// In this example, we have two buffer: one is currently displayed, and we are\n// rendering into the second one. Hence we use `RepaintBufferType::SwappedBuffers`\nlet window = slint::platform::software_renderer::MinimalSoftwareWindow::new(\n slint::platform::software_renderer::RepaintBufferType::SwappedBuffers\n);\n\nconst DISPLAY_WIDTH: usize = 320;\nconst DISPLAY_HEIGHT: usize = 240;\nlet mut buffer1 = [Rgb565Pixel(0); DISPLAY_WIDTH * DISPLAY_HEIGHT];\nlet mut buffer2 = [Rgb565Pixel(0); DISPLAY_WIDTH * DISPLAY_HEIGHT];\n\n// ... configure the screen driver to use buffer1 or buffer2 ...\n\n// ... rest of initialization ...\n\nlet mut currently_displayed_buffer : &mut [_] = &mut buffer1;\nlet mut work_buffer : &mut [_] = &mut buffer2;\n\nloop {\n // ...\n // Draw the scene if something needs to be drawn\n window.draw_if_needed(|renderer| {\n // The screen driver might be taking some time to do the swap. We need to wait until\n // work_buffer is ready to be written in\n while is_swap_pending() {}\n\n // Do the rendering!\n renderer.render(work_buffer, DISPLAY_WIDTH);\n\n // tell the screen driver to display the other buffer.\n swap_buffers();\n\n // Swap the buffer references for our next iteration\n // (this just swap the reference, not the actual data)\n core::mem::swap::<&mut [_]>(&mut work_buffer, &mut currently_displayed_buffer);\n });\n // ...\n}\n\n```\n\n#### Rendering Line by Line\n\nWhen rendering the user interface line by line, you need to implement the [`LineBufferProvider`] trait. It\ndefines a bi-directional interface between Slint and your code to send lines to the screen:\n\n* The trait's associated `TargetPixel` type let's Slint know how to create and manipulate pixels. How exactly the pixels are\n represented in your device and how they are blended remains your implementation detail.\n* The trait's `process_line` function notifies you when a line can be rendered and provides a callback that you can invoke\n to fill a slice of pixels for the given line.\n\nThe following example defines a `DisplayWrapper` struct: It connects screen driver that implements the [`embedded_graphics`](https://lib.rs/embedded-graphics) traits\nwith Slint's `Rgb565Pixel` type to implement the `LineBufferProvider` trait. The pixels for one line are sent to the screen by calling\nthe [DrawTarget::fill_contiguous](https://docs.rs/embedded-graphics/0.7.1/embedded_graphics/draw_target/trait.DrawTarget.html) function.\n\n```rust,no_run\nuse embedded_graphics_core::{prelude::*, primitives::Rectangle, pixelcolor::raw::RawU16};\n\n# mod embedded_graphics_core {\n# pub mod prelude {\n# pub struct Point; impl Point { pub fn new(_:i32, _:i32) -> Self {todo!()} }\n# pub struct Size; impl Size { pub fn new(_:i32, _:i32) -> Self {todo!()} }\n# pub trait DrawTarget { type Color; fn fill_contiguous(&mut self, _: &super::primitives::Rectangle, _: impl IntoIterator) -> Result<(), ()> {Ok(())} }\n# }\n# pub mod primitives { pub struct Rectangle; impl Rectangle { pub fn new(_: super::prelude::Point, _: super::prelude::Size) -> Self { todo!() } } }\n# pub mod pixelcolor {\n# pub struct Rgb565;\n# pub mod raw { pub struct RawU16(); impl RawU16 { pub fn new(_:u16) -> Self {todo!()} } impl From for super::Rgb565 { fn from(_: RawU16) -> Self {todo!()} } }\n# }\n# }\n# mod hal { pub struct Display; impl Display { pub fn new()-> Self {todo!()} } }\n# impl DrawTarget for hal::Display{ type Color = embedded_graphics_core::pixelcolor::Rgb565; }\n\nstruct DisplayWrapper<'a, T>{\n display: &'a mut T,\n line_buffer: &'a mut [slint::platform::software_renderer::Rgb565Pixel],\n}\nimpl>\n slint::platform::software_renderer::LineBufferProvider for DisplayWrapper<'_, T>\n{\n type TargetPixel = slint::platform::software_renderer::Rgb565Pixel;\n fn process_line(\n &mut self,\n line: usize,\n range: core::ops::Range,\n render_fn: impl FnOnce(&mut [Self::TargetPixel]),\n ) {\n // Render into the line\n render_fn(&mut self.line_buffer[range.clone()]);\n\n // Send the line to the screen using DrawTarget::fill_contiguous\n self.display.fill_contiguous(\n &Rectangle::new(Point::new(range.start as _, line as _), Size::new(range.len() as _, 1)),\n self.line_buffer[range.clone()].iter().map(|p| RawU16::new(p.0).into())\n ).map_err(drop).unwrap();\n }\n}\n\n// Note that we use `ReusedBuffer` as parameter for MinimalSoftwareWindow to indicate\n// that we just need to re-render what changed since the last frame.\n// What's shown on the screen buffer is not in our RAM, but actually within the display itself.\n// Only the changed part of the screen will be updated.\nlet window = slint::platform::software_renderer::MinimalSoftwareWindow::new(\n slint::platform::software_renderer::RepaintBufferType::ReusedBuffer\n);\n\nconst DISPLAY_WIDTH: usize = 320;\nlet mut line_buffer = [slint::platform::software_renderer::Rgb565Pixel(0); DISPLAY_WIDTH];\n\nlet mut display = hal::Display::new(/*...*/);\n\n// ... rest of initialization ...\n\nloop {\n // ...\n window.draw_if_needed(|renderer| {\n renderer.render_by_line(DisplayWrapper{\n display: &mut display,\n line_buffer: &mut line_buffer\n });\n });\n // ...\n}\n\n```\n\nNote: In our experience, using the synchronous `DrawTarget::fill_contiguous` function is slow. If\nyour device is capable of using DMA, you may be able to achieve better performance by using\ntwo line buffers: One buffer to render into with the CPU, while the other buffer is transferred to\nthe screen using DMA asynchronously.\n\n## Example Implementations\n\nThe examples that come with Slint use a helper crate called `mcu-board-support`. It provides implementations of\nthe `Platform` trait for some MCUs, along with support for touch input and system timers.\n\nYou can find the crate in our Git repository at:\n\n\n\nIf your MCU is among the supported boards, then you can use it by specifying it as a\n[dependency from our Git repository](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#specifying-dependencies-from-git-repositories)\nin your `Cargo.toml`.\n\nFor an entire template, check out our [Slint Bare Metal Microcontroller Rust Template](https://github.com/slint-ui/slint-mcu-rust-template).\n\nWe also have a version of our printer demo that we've adapted to small screens, the [MCU Printer Demo](https://github.com/slint-ui/slint/tree/master/demos/printerdemo_mcu).\n" }, { "path": "api/rs/slint/private_unstable_api.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n//! Module containing the private api that is used by the generated code.\n//!\n//! This is internal API that shouldn't be used because compatibility is not\n//! guaranteed\n#![doc(hidden)]\n\nuse core::pin::Pin;\nuse re_exports::*;\n\n// Helper functions called from generated code to reduce code bloat from\n// extra copies of the original functions for each call site due to\n// the impl Fn() they are taking.\n\npub trait StrongItemTreeRef: Sized {\n type Weak: Clone + 'static;\n fn to_weak(&self) -> Self::Weak;\n fn from_weak(weak: &Self::Weak) -> Option;\n}\n\nimpl StrongItemTreeRef for VRc {\n type Weak = VWeak;\n fn to_weak(&self) -> Self::Weak {\n VRc::downgrade(self)\n }\n fn from_weak(weak: &Self::Weak) -> Option {\n weak.upgrade()\n }\n}\n\nimpl StrongItemTreeRef for VRcMapped {\n type Weak = VWeakMapped;\n fn to_weak(&self) -> Self::Weak {\n VRcMapped::downgrade(self)\n }\n fn from_weak(weak: &Self::Weak) -> Option {\n weak.upgrade()\n }\n}\n\nimpl StrongItemTreeRef for Pin> {\n type Weak = PinWeak;\n fn to_weak(&self) -> Self::Weak {\n PinWeak::downgrade(self.clone())\n }\n fn from_weak(weak: &Self::Weak) -> Option {\n weak.upgrade()\n }\n}\n\npub fn set_property_binding<\n T: Clone + Default + 'static,\n StrongRef: StrongItemTreeRef + 'static,\n>(\n property: Pin<&Property>,\n component_strong: &StrongRef,\n binding: fn(StrongRef) -> T,\n) {\n let weak = component_strong.to_weak();\n property.set_binding(move || {\n ::from_weak(&weak).map(binding).unwrap_or_default()\n })\n}\n\npub fn set_animated_property_binding<\n T: Clone + i_slint_core::properties::InterpolatedPropertyValue + 'static,\n StrongRef: StrongItemTreeRef + 'static,\n>(\n property: Pin<&Property>,\n component_strong: &StrongRef,\n binding: fn(StrongRef) -> T,\n compute_animation_details: fn(\n StrongRef,\n )\n -> (PropertyAnimation, Option),\n) {\n let weak_1 = component_strong.to_weak();\n let weak_2 = weak_1.clone();\n property.set_animated_binding(\n move || binding(::from_weak(&weak_1).unwrap()),\n move || {\n compute_animation_details(::from_weak(&weak_2).unwrap())\n },\n )\n}\n\npub fn set_property_state_binding(\n property: Pin<&Property>,\n component_strong: &StrongRef,\n binding: fn(StrongRef) -> i32,\n) {\n let weak = component_strong.to_weak();\n re_exports::set_state_binding(property, move || {\n binding(::from_weak(&weak).unwrap())\n })\n}\n\npub fn set_callback_handler<\n Arg: ?Sized + 'static,\n Ret: Default + 'static,\n StrongRef: StrongItemTreeRef + 'static,\n>(\n callback: Pin<&Callback>,\n component_strong: &StrongRef,\n handler: fn(StrongRef, &Arg) -> Ret,\n) {\n let weak = component_strong.to_weak();\n callback.set_handler(move |arg| {\n handler(::from_weak(&weak).unwrap(), arg)\n })\n}\n\npub fn debug(s: SharedString) {\n #[cfg(feature = \"log\")]\n log::debug!(\"{s}\");\n #[cfg(not(feature = \"log\"))]\n i_slint_core::debug_log!(\"{s}\");\n}\n\npub fn ensure_backend() -> Result<(), crate::PlatformError> {\n i_slint_backend_selector::with_platform(|_b| {\n // Nothing to do, just make sure a backend was created\n Ok(())\n })\n}\n\n/// Creates a new window to render components in.\npub fn create_window_adapter()\n-> Result, crate::PlatformError> {\n i_slint_backend_selector::with_platform(|b| b.create_window_adapter())\n}\n\n/// Wrapper around i_slint_core::translations::translate for the generated code\npub fn translate(\n origin: SharedString,\n context: SharedString,\n domain: SharedString,\n args: Slice,\n n: i32,\n plural: SharedString,\n) -> SharedString {\n i_slint_core::translations::translate(&origin, &context, &domain, args.as_slice(), n, &plural)\n}\n\n#[cfg(feature = \"gettext\")]\npub fn init_translations(domain: &str, dirname: impl Into) {\n i_slint_core::translations::gettext_bindtextdomain(domain, dirname.into()).unwrap()\n}\n\npub fn use_24_hour_format() -> bool {\n i_slint_core::date_time::use_24_hour_format()\n}\n\n/// internal re_exports used by the macro generated\npub mod re_exports {\n pub use alloc::boxed::Box;\n pub use alloc::rc::{Rc, Weak};\n pub use alloc::string::String;\n pub use alloc::{vec, vec::Vec};\n pub use const_field_offset::{self, FieldOffsets, PinnedDrop};\n pub use core::iter::FromIterator;\n pub use core::option::{Option, Option::*};\n pub use core::result::{Result, Result::*};\n pub use i_slint_core::styled_text::{StyledText, parse_markdown, string_to_styled_text};\n // This one is empty when Qt is not available, which triggers a warning\n pub use euclid::approxeq::ApproxEq;\n #[allow(unused_imports)]\n pub use i_slint_backend_selector::native_widgets::*;\n pub use i_slint_core::accessibility::{\n AccessibilityAction, AccessibleStringProperty, SupportedAccessibilityAction,\n };\n pub use i_slint_core::animations::{EasingCurve, animation_tick, current_tick};\n pub use i_slint_core::api::LogicalPosition;\n pub use i_slint_core::callbacks::Callback;\n pub use i_slint_core::context::SlintContext;\n pub use i_slint_core::date_time::*;\n pub use i_slint_core::detect_operating_system;\n pub use i_slint_core::graphics::*;\n pub use i_slint_core::input::{\n FocusEvent, FocusReason, InputEventResult, KeyEvent, KeyEventResult, KeyboardModifiers,\n Keys, MouseEvent, key_codes::Key, make_keys,\n };\n pub use i_slint_core::item_tree::{\n IndexRange, ItemTree, ItemTreeRefPin, ItemTreeVTable, ItemTreeWeak, register_item_tree,\n unregister_item_tree,\n };\n pub use i_slint_core::item_tree::{\n ItemTreeNode, ItemVisitorRefMut, ItemVisitorVTable, ItemWeak, TraversalOrder,\n VisitChildrenResult, visit_item_tree,\n };\n pub use i_slint_core::items::{Transform, *};\n pub use i_slint_core::layout::*;\n pub use i_slint_core::lengths::{\n LogicalLength, LogicalPoint, LogicalRect, logical_position_to_api,\n };\n pub use i_slint_core::menus::{Menu, MenuFromItemTree, MenuVTable};\n pub use i_slint_core::model::*;\n pub use i_slint_core::properties::{\n ChangeTracker, Property, PropertyTracker, StateInfo, set_state_binding,\n };\n pub use i_slint_core::slice::Slice;\n pub use i_slint_core::string::shared_string_from_number;\n pub use i_slint_core::string::shared_string_from_number_fixed;\n pub use i_slint_core::string::shared_string_from_number_precision;\n pub use i_slint_core::timers::{Timer, TimerMode};\n pub use i_slint_core::translations::{\n set_bundled_languages, translate_from_bundle, translate_from_bundle_with_plural,\n };\n pub use i_slint_core::window::{\n InputMethodRequest, WindowAdapter, WindowAdapterRc, WindowInner,\n };\n pub use i_slint_core::{\n Color, Coord, SharedString, SharedVector, format, string::ToSharedString,\n };\n pub use i_slint_core::{ItemTreeVTable_static, MenuVTable_static};\n pub use num_traits::float::Float;\n pub use num_traits::ops::euclid::Euclid;\n pub use once_cell::race::OnceBox;\n pub use once_cell::unsync::OnceCell;\n pub use pin_weak::rc::PinWeak;\n pub use unicode_segmentation::UnicodeSegmentation;\n pub use vtable::{self, *};\n\n #[cfg(feature = \"live-preview\")]\n pub use slint_interpreter::live_preview;\n}\n" }, { "path": "api/rs/slint/tests/invalid_rust_attr.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n@rust-attr(\"Doesn't Lex in rust \\{\"🦞\"}\")\nexport struct Foo { int: int }\n" }, { "path": "api/rs/slint/tests/partial_renderer.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse i_slint_renderer_skia::SkiaRenderer;\nuse i_slint_renderer_skia::SkiaSharedContext;\nuse i_slint_renderer_skia::skia_safe;\nuse slint::platform::software_renderer::{\n MinimalSoftwareWindow, PremultipliedRgbaColor, SoftwareRenderer, TargetPixel,\n};\nuse slint::platform::{PlatformError, WindowAdapter};\nuse slint::{Model, PhysicalPosition, PhysicalSize, SharedPixelBuffer};\nuse std::cell::{Cell, RefCell};\nuse std::rc::{Rc, Weak};\n\nthread_local! {\n static WINDOW: Rc =\n MinimalSoftwareWindow::new(slint::platform::software_renderer::RepaintBufferType::ReusedBuffer);\n static SKIA_WINDOW: Rc = SkiaTestWindow::new();\n static NEXT_WINDOW_CHOICE: Rc>>> = Rc::new(RefCell::new(None));\n}\n\nstruct TestPlatform;\nimpl slint::platform::Platform for TestPlatform {\n fn create_window_adapter(&self) -> Result, PlatformError> {\n Ok(NEXT_WINDOW_CHOICE.with(|choice| {\n choice.borrow_mut().take().unwrap_or_else(|| WINDOW.with(|x| x.clone()))\n }))\n }\n}\n\n#[derive(Clone, Copy, Default)]\nstruct TestPixel(bool);\n\nimpl TargetPixel for TestPixel {\n fn blend(&mut self, _color: PremultipliedRgbaColor) {\n *self = Self(true);\n }\n\n fn from_rgb(_red: u8, _green: u8, _blue: u8) -> Self {\n Self(true)\n }\n}\n\n#[track_caller]\nfn do_test_render_region(renderer: &SoftwareRenderer, x: i32, y: i32, x2: i32, y2: i32) {\n let mut buffer = vec![TestPixel(false); 500 * 500];\n let r = renderer.render(buffer.as_mut_slice(), 500);\n assert_eq!(r.bounding_box_size(), PhysicalSize { width: (x2 - x) as _, height: (y2 - y) as _ });\n assert_eq!(r.bounding_box_origin(), PhysicalPosition { x, y });\n\n let mut has_one_pixel = false;\n for py in 0..500 {\n for px in 0..500 {\n let in_bounding_box = (x..x2).contains(&(px as i32)) && (y..y2).contains(&(py as i32));\n if !in_bounding_box {\n assert!(\n !buffer[py * 500 + px].0,\n \"Something written outside of bounding box in {px},{py} - (x={x},y={y},x2={x2},y2={y2})\"\n )\n } else if buffer[py * 500 + px].0 {\n has_one_pixel = true;\n }\n }\n }\n assert!(has_one_pixel, \"Nothing was rendered\");\n}\n\nstruct SkiaTestWindow {\n window: slint::Window,\n renderer: SkiaRenderer,\n needs_redraw: Cell,\n size: Cell,\n render_buffer: Rc,\n}\n\nimpl SkiaTestWindow {\n fn new() -> Rc {\n let render_buffer = Rc::new(SkiaTestSoftwareBuffer::default());\n let renderer = SkiaRenderer::new_with_surface(\n &SkiaSharedContext::default(),\n Box::new(i_slint_renderer_skia::software_surface::SoftwareSurface::from(\n render_buffer.clone(),\n )),\n );\n Rc::new_cyclic(|w: &Weak| Self {\n window: slint::Window::new(w.clone()),\n renderer,\n needs_redraw: Default::default(),\n size: Default::default(),\n render_buffer,\n })\n }\n\n fn draw_if_needed(&self) -> bool {\n if self.needs_redraw.replace(false) {\n self.renderer.render().unwrap();\n true\n } else {\n false\n }\n }\n\n fn last_dirty_region_bounding_box_size(&self) -> Option {\n self.render_buffer.last_dirty_region.borrow().as_ref().map(|r| {\n let size = r.bounding_rect().size;\n slint::LogicalSize::new(size.width as _, size.height as _)\n })\n }\n fn last_dirty_region_bounding_box_origin(&self) -> Option {\n self.render_buffer.last_dirty_region.borrow().as_ref().map(|r| {\n let origin = r.bounding_rect().origin;\n slint::LogicalPosition::new(origin.x as _, origin.y as _)\n })\n }\n}\n\nimpl WindowAdapter for SkiaTestWindow {\n fn window(&self) -> &slint::Window {\n &self.window\n }\n\n fn size(&self) -> PhysicalSize {\n self.size.get()\n }\n\n fn renderer(&self) -> &dyn slint::platform::Renderer {\n &self.renderer\n }\n\n fn set_size(&self, size: slint::WindowSize) {\n self.size.set(size.to_physical(1.));\n self.window\n .dispatch_event(slint::platform::WindowEvent::Resized { size: size.to_logical(1.) })\n }\n\n fn request_redraw(&self) {\n self.needs_redraw.set(true);\n }\n}\n\n#[derive(Default)]\nstruct SkiaTestSoftwareBuffer {\n pixels: RefCell>>,\n last_dirty_region: RefCell>,\n}\n\nimpl i_slint_renderer_skia::software_surface::RenderBuffer for SkiaTestSoftwareBuffer {\n fn with_buffer(\n &self,\n _window: &slint::Window,\n size: PhysicalSize,\n render_callback: &mut dyn FnMut(\n std::num::NonZeroU32,\n std::num::NonZeroU32,\n i_slint_renderer_skia::skia_safe::ColorType,\n u8,\n &mut [u8],\n ) -> Result<\n Option,\n i_slint_core::platform::PlatformError,\n >,\n ) -> Result<(), i_slint_core::platform::PlatformError> {\n let Some((width, height)): Option<(std::num::NonZeroU32, std::num::NonZeroU32)> =\n size.width.try_into().ok().zip(size.height.try_into().ok())\n else {\n // Nothing to render\n return Ok(());\n };\n\n let mut shared_pixel_buffer = self.pixels.borrow_mut().take();\n\n if shared_pixel_buffer.as_ref().is_some_and(|existing_buffer| {\n existing_buffer.width() != width.get() || existing_buffer.height() != height.get()\n }) {\n shared_pixel_buffer = None;\n }\n\n let mut age = 1;\n let pixels = shared_pixel_buffer.get_or_insert_with(|| {\n age = 0;\n SharedPixelBuffer::new(width.get(), height.get())\n });\n\n let bytes = bytemuck::cast_slice_mut(pixels.make_mut_slice());\n *self.last_dirty_region.borrow_mut() =\n render_callback(width, height, skia_safe::ColorType::RGBA8888, age, bytes)?;\n\n *self.pixels.borrow_mut() = shared_pixel_buffer;\n\n Ok(())\n }\n}\n\n#[test]\nfn simple() {\n slint::slint! {\n export component Ui inherits Window {\n in property c: yellow;\n background: black;\n Rectangle {\n x: 1phx;\n y: 80phx;\n width: 15phx;\n height: 17phx;\n background: red;\n }\n Rectangle {\n x: 10phx;\n y: 19phx;\n Rectangle {\n x: 5phx;\n y: 80phx;\n width: 12phx;\n height: 13phx;\n background: c;\n }\n Rectangle {\n x: 50phx;\n y: 8phx;\n width: 15phx;\n height: 17phx;\n background: c;\n }\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_c(slint::Color::from_rgb_u8(45, 12, 13));\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10 + 5, 19 + 8, 10 + 50 + 15, 19 + 80 + 13);\n }));\n ui.set_c(slint::Color::from_rgb_u8(45, 12, 13));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n}\n\n#[test]\nfn visibility() {\n slint::slint! {\n export component Ui inherits Window {\n in property c : true;\n in property another: false;\n background: black;\n Rectangle {\n x: 10phx;\n y: 19phx;\n Rectangle {\n x: 5phx;\n y: 80phx;\n width: 12phx;\n height: 13phx;\n background: red;\n visible: c;\n Rectangle {\n x: 3phx;\n y: 3phx;\n width: 3phx;\n height: 3phx;\n background: another ? blue: green;\n }\n }\n Rectangle {\n x: 50phx;\n y: 8phx;\n width: 15phx;\n height: 17phx;\n background: gray;\n visible: !c;\n Rectangle {\n x: 3phx;\n y: 3phx;\n width: 3phx;\n height: 3phx;\n background: another ? blue: green;\n }\n }\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n\n ui.set_c(false);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10 + 5, 19 + 8, 10 + 50 + 15, 19 + 80 + 13);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_another(true);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10 + 50 + 3, 19 + 8 + 3, 10 + 50 + 6, 19 + 8 + 6);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n\n ui.set_c(true);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10 + 5, 19 + 8, 10 + 50 + 15, 19 + 80 + 13);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_another(false);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10 + 5 + 3, 19 + 80 + 3, 10 + 5 + 6, 19 + 80 + 6);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n}\n\n#[test]\nfn if_condition() {\n slint::slint! {\n export component Ui inherits Window {\n in property c : true;\n background: black;\n if c: Rectangle {\n x: 45px;\n y: 45px;\n background: pink;\n width: 32px;\n height: 3px;\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_c(false);\n assert!(window.draw_if_needed(|renderer| {\n // Currently we redraw when a condition becomes false because we don't track the position otherwise\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_c(true);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 45, 45, 45 + 32, 45 + 3);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n}\n\n#[test]\nfn list_view() {\n slint::slint! {\n // We can't rely on the style as they are all different so implement our own in very basic terms\n component ListView inherits Flickable {\n out property visible-width <=> self.width;\n out property visible-height <=> self.height;\n @children\n }\n export component Ui inherits Window {\n width: 300px;\n height: 300px;\n in property <[int]> model;\n ListView {\n x: 20px; y: 10px; width: 100px; height: 90px;\n for x in model: Rectangle {\n background: x == 1 ? red : blue;\n height: 10px;\n width: 25px;\n }\n\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(300, 300));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 300, 300);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n let model = std::rc::Rc::new(slint::VecModel::from(vec![0]));\n ui.set_model(model.clone().into());\n\n const LV_X: i32 = 20;\n const LV_Y: i32 = 10;\n\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, LV_X, LV_Y, LV_X + 25, LV_Y + 10);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n\n model.insert(0, 1);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, LV_X, LV_Y, LV_X + 25, LV_Y + 20);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n model.set_row_data(1, 1);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, LV_X, LV_Y + 10, LV_X + 25, LV_Y + 20);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n model.set_vec(vec![0, 0]);\n assert!(window.draw_if_needed(|renderer| {\n // Currently, when ItemTree are removed, we redraw the whole window.\n do_test_render_region(renderer, 0, 0, 300, 300);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n model.remove(1);\n assert!(window.draw_if_needed(|renderer| {\n // Currently, when ItemTree are removed, we redraw the whole window.\n do_test_render_region(renderer, 0, 0, 300, 300);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n}\n\n#[test]\n/// test for #6932\nfn scale_factor() {\n slint::slint! {\n export component Ui inherits Window {\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(500, 500));\n window.dispatch_event(slint::platform::WindowEvent::ScaleFactorChanged { scale_factor: 1.33 });\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 500, 500);\n }));\n}\n\n#[test]\nfn rotated_image() {\n slint::slint! {\n export component Ui inherits Window {\n in property rotation <=> i.transform-rotation;\n in property x-pos <=> i.x;\n background: black;\n i := Image {\n x: 50px;\n y: 50px;\n width: 50px;\n height: 150px;\n source: @image-url(\"../../../logo/slint-logo-full-dark.png\");\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n\n let window = SKIA_WINDOW.with(|w| w.clone());\n NEXT_WINDOW_CHOICE.with(|choice| {\n *choice.borrow_mut() = Some(window.clone());\n });\n let ui = Ui::new().unwrap();\n window.set_size(slint::PhysicalSize::new(250, 250).into());\n ui.show().unwrap();\n\n assert!(window.draw_if_needed());\n assert_eq!(\n window.last_dirty_region_bounding_box_size(),\n Some(slint::LogicalSize { width: 250., height: 250. })\n );\n assert_eq!(\n window.last_dirty_region_bounding_box_origin(),\n Some(slint::LogicalPosition { x: 0., y: 0. })\n );\n\n assert!(!window.draw_if_needed());\n\n ui.set_x_pos(51.);\n\n assert!(window.draw_if_needed());\n assert_eq!(\n window.last_dirty_region_bounding_box_size(),\n Some(slint::LogicalSize { width: 51., height: 150. })\n );\n assert_eq!(\n window.last_dirty_region_bounding_box_origin(),\n Some(slint::LogicalPosition { x: 50., y: 50. })\n );\n\n ui.set_rotation(90.);\n\n assert!(window.draw_if_needed());\n assert_eq!(\n window.last_dirty_region_bounding_box_size(),\n Some(slint::LogicalSize { width: 150., height: 150. })\n );\n assert_eq!(\n window.last_dirty_region_bounding_box_origin(),\n Some(slint::LogicalPosition { x: 1., y: 50. })\n );\n}\n\n#[test]\nfn window_background() {\n slint::slint! {\n export component Ui inherits Window {\n in property c: yellow;\n background: c;\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_c(slint::Color::from_rgb_u8(45, 12, 13));\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n ui.set_c(slint::Color::from_rgb_u8(45, 12, 13));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n}\n\n#[test]\nfn touch_area_doesnt_cause_redraw() {\n slint::slint! {\n export component Ui inherits Window {\n in property c: yellow;\n in property touch-area-1-x <=> ta1.x;\n in property touch-area-2-x <=> ta2.x;\n in property sole-pixel-color: red;\n background: black;\n ta1 := TouchArea {\n x: 10px;\n y: 0px;\n width: 20px;\n height: 40px;\n Rectangle {\n x: 1phx;\n y: 20phx;\n width: 15phx;\n height: 17phx;\n background: c;\n }\n }\n ta2 := TouchArea {\n x: 10px;\n y: 0px;\n width: 20px;\n height: 40px;\n }\n sole-pixel := Rectangle {\n x: 60px;\n y: 0px;\n width: 1px;\n height: 1px;\n background: sole-pixel-color;\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_c(slint::Color::from_rgb_u8(45, 12, 13));\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10 + 1, 20, 10 + 1 + 15, 20 + 17);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_touch_area_1_x(20.);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10 + 1, 20, 10 + 1 + 15 + 10, 20 + 17);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_touch_area_2_x(20.);\n ui.set_sole_pixel_color(slint::Color::from_rgb_u8(45, 12, 13));\n // Moving the touch area should not cause it to be redrawn.\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 60, 0, 61, 1);\n }));\n}\n\n#[test]\nfn shadow_redraw_beyond_geometry() {\n slint::slint! {\n export component Ui inherits Window {\n in property x-pos: 10px;\n Rectangle {\n x: root.x-pos;\n y: 10px;\n width: 20px;\n height: 20px;\n drop-shadow-blur: 5px;\n drop-shadow-offset-x: 15px;\n drop-shadow-offset-y: 5px;\n drop-shadow-color: red;\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n\n let window = SKIA_WINDOW.with(|w| w.clone());\n NEXT_WINDOW_CHOICE.with(|choice| {\n *choice.borrow_mut() = Some(window.clone());\n });\n let ui = Ui::new().unwrap();\n window.set_size(slint::PhysicalSize::new(250, 250).into());\n ui.show().unwrap();\n\n assert!(window.draw_if_needed());\n assert_eq!(\n window.last_dirty_region_bounding_box_size(),\n Some(slint::LogicalSize { width: 250., height: 250. })\n );\n assert_eq!(\n window.last_dirty_region_bounding_box_origin(),\n Some(slint::LogicalPosition { x: 0., y: 0. })\n );\n\n assert!(!window.draw_if_needed());\n\n ui.set_x_pos(20.);\n\n assert!(window.draw_if_needed());\n\n let shadow_width = /* rect width */ 20. + 2. * /* blur */ 5.;\n let move_delta = 10.;\n let shadow_height = /* rect height */ 20. + 2. * /*blur */ 5.;\n\n let old_shadow_x = /* rect x */ 10. + /* shadow offset */ 15. - /* blur */ 5.;\n let old_shadow_y = /* rect y */ 10. + /* shadow offset */ 5. - /* blur */ 5.;\n\n assert_eq!(\n window.last_dirty_region_bounding_box_size(),\n Some(slint::LogicalSize { width: shadow_width + move_delta, height: shadow_height })\n );\n assert_eq!(\n window.last_dirty_region_bounding_box_origin(),\n Some(slint::LogicalPosition { x: old_shadow_x, y: old_shadow_y })\n );\n}\n\n#[test]\nfn text_alignment() {\n slint::slint! {\n export component Ui inherits Window {\n in property c: green;\n Text {\n x: 10px;\n y: 10px;\n width: 200px;\n height: 50px;\n text: \"Ok\";\n color: c;\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n\n let window = SKIA_WINDOW.with(|w| w.clone());\n NEXT_WINDOW_CHOICE.with(|choice| {\n *choice.borrow_mut() = Some(window.clone());\n });\n let ui = Ui::new().unwrap();\n window.set_size(slint::PhysicalSize::new(250, 250).into());\n ui.show().unwrap();\n\n assert!(window.draw_if_needed());\n assert_eq!(\n window.last_dirty_region_bounding_box_size(),\n Some(slint::LogicalSize { width: 250., height: 250. })\n );\n assert_eq!(\n window.last_dirty_region_bounding_box_origin(),\n Some(slint::LogicalPosition { x: 0., y: 0. })\n );\n\n assert!(!window.draw_if_needed());\n\n ui.set_c(slint::Color::from_rgb_u8(45, 12, 13));\n\n assert!(window.draw_if_needed());\n assert_eq!(\n window.last_dirty_region_bounding_box_size(),\n Some(slint::LogicalSize { width: 200., height: 50. })\n );\n assert_eq!(\n window.last_dirty_region_bounding_box_origin(),\n Some(slint::LogicalPosition { x: 10., y: 10. })\n );\n}\n\n#[test]\nfn nowrap_text_change_doesnt_change_height() {\n slint::slint! {\n export component Ui inherits Window {\n in property first-text: \"First text\";\n out property first-label-width: first-label.width;\n out property first-label-height: first-label.height;\n background: black;\n VerticalLayout {\n first-label := Text {\n text: root.first-text;\n }\n Text {\n text: \"Second text\";\n }\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_first_text(\"Hello World longer\".into());\n\n let expected_width = ui.get_first_label_width().ceil() as _;\n let expected_height = ui.get_first_label_height().ceil() as _;\n\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, expected_width, expected_height);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n}\n\n#[test]\nfn create_item_tree_during_rendering() {\n // This test has a `init` callback which will cause item tree to be changed during rendeiring,\n // between the compute dirty region and the actual rendering.\n slint::slint! {\n export component Ui inherits Window {\n in property cond1: false;\n property cond2: false;\n property cond3: false;\n\n in property foo: 5px;\n\n if cond3: Rectangle {\n x: 12px;\n y: foo;\n width: 10px;\n height: 10px;\n background: yellow;\n }\n if cond2: Rectangle {\n x: 10px;\n y: 10px;\n width: 10px;\n height: 10px;\n background: red;\n init => { cond3=true; }\n }\n if cond1: Rectangle {\n x: 10px;\n y: 15px;\n width: 10px;\n height: 10px;\n background: blue;\n init => { cond2=true; }\n }\n if cond2: Rectangle {\n x: 12px;\n y: 10px + foo;\n width: 10px;\n height: 10px;\n background: green;\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = Ui::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_cond1(true);\n\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10, 15, 22, 25);\n }));\n // FIXME: in this case, there is nothing done to trigger any redraw. Ideally this call shouldn't be necessary.\n assert!(!window.draw_if_needed(|_| ()));\n // So therefore force a redraw\n\n ui.set_foo(4.0);\n\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 10, 4, 22, 25);\n }));\n\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n\n ui.set_foo(3.0);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 12, 3, 22, 24);\n }));\n}\n\n#[test]\nfn issue_9882_borrow_mut() {\n slint::slint! {\n export component App inherits Window {\n in-out property <[string]> strings: [\"Home\"];\n VerticalLayout {\n VerticalLayout {\n for str in root.strings: Text {\n text: str;\n }\n }\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let ui = App::new().unwrap();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_strings(slint::ModelRc::new(slint::VecModel::from_iter([slint::SharedString::from(\n \"Hello\",\n )])));\n\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n\n ui.set_strings(slint::ModelRc::new(slint::VecModel::from_iter([slint::SharedString::from(\n \"World\",\n )])));\n\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n}\n\n#[test]\n/// Check that changing the position of a rectangle is properly tracked when RepaintBufferType::NewBuffer is used.\nfn position_tracking_without_partial_rendering() {\n slint::slint! {\n export component App inherits Window {\n width: 180px;\n height: 260px;\n\n in property cond: true;\n in property rect-x: 10px;\n\n Rectangle {\n background: red;\n width: 40px;\n height: 80px;\n x: rect-x;\n }\n\n Rectangle {\n width: 100px;\n height: 100px;\n x: 1000px;\n background: cond ? green : blue;\n }\n }\n }\n\n struct TestPlatform2(Rc);\n impl slint::platform::Platform for TestPlatform2 {\n fn create_window_adapter(&self) -> Result, PlatformError> {\n Ok(self.0.clone())\n }\n }\n let window = MinimalSoftwareWindow::new(\n slint::platform::software_renderer::RepaintBufferType::NewBuffer,\n );\n slint::platform::set_platform(Box::new(TestPlatform2(window.clone()))).ok();\n let ui = App::new().unwrap();\n window.set_size(slint::PhysicalSize::new(180, 260));\n ui.show().unwrap();\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n ui.set_cond(false);\n assert!(!window.draw_if_needed(|_| {\n unreachable!(\"the rectangle is outside the window so it should not be drawn\")\n }));\n\n ui.set_rect_x(20.);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n\n ui.set_rect_x(-500.);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n\n ui.set_rect_x(20.);\n assert!(window.draw_if_needed(|renderer| {\n do_test_render_region(renderer, 0, 0, 180, 260);\n }));\n assert!(!window.draw_if_needed(|_| { unreachable!() }));\n}\n" }, { "path": "api/rs/slint/tests/popups.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse i_slint_renderer_skia::SkiaRenderer;\nuse i_slint_renderer_skia::SkiaSharedContext;\nuse i_slint_renderer_skia::skia_safe;\nuse slint::platform::software_renderer::MinimalSoftwareWindow;\nuse slint::platform::{PlatformError, WindowAdapter};\nuse slint::{PhysicalSize, SharedPixelBuffer};\nuse std::cell::{Cell, RefCell};\nuse std::rc::{Rc, Weak};\n\nthread_local! {\n static WINDOW: Rc =\n MinimalSoftwareWindow::new(slint::platform::software_renderer::RepaintBufferType::ReusedBuffer);\n static SKIA_WINDOW: Rc = SkiaTestWindow::new();\n static NEXT_WINDOW_CHOICE: Rc>>> = Rc::new(RefCell::new(None));\n}\n\nstruct TestPlatform;\nimpl slint::platform::Platform for TestPlatform {\n fn create_window_adapter(&self) -> Result, PlatformError> {\n Ok(NEXT_WINDOW_CHOICE.with(|choice| {\n choice.borrow_mut().take().unwrap_or_else(|| WINDOW.with(|x| x.clone()))\n }))\n }\n}\n\nstruct SkiaTestWindow {\n window: slint::Window,\n renderer: SkiaRenderer,\n needs_redraw: Cell,\n size: Cell,\n}\n\nimpl SkiaTestWindow {\n fn new() -> Rc {\n let render_buffer = Rc::new(SkiaTestSoftwareBuffer::default());\n let renderer = SkiaRenderer::new_with_surface(\n &SkiaSharedContext::default(),\n Box::new(i_slint_renderer_skia::software_surface::SoftwareSurface::from(\n render_buffer.clone(),\n )),\n );\n Rc::new_cyclic(|w: &Weak| Self {\n window: slint::Window::new(w.clone()),\n renderer,\n needs_redraw: Default::default(),\n size: Default::default(),\n })\n }\n\n fn draw_if_needed(&self) -> bool {\n if self.needs_redraw.replace(false) {\n self.renderer.render().unwrap();\n true\n } else {\n false\n }\n }\n}\n\nimpl WindowAdapter for SkiaTestWindow {\n fn window(&self) -> &slint::Window {\n &self.window\n }\n\n fn size(&self) -> PhysicalSize {\n self.size.get()\n }\n\n fn renderer(&self) -> &dyn slint::platform::Renderer {\n &self.renderer\n }\n\n fn set_size(&self, size: slint::WindowSize) {\n self.size.set(size.to_physical(1.));\n self.window\n .dispatch_event(slint::platform::WindowEvent::Resized { size: size.to_logical(1.) })\n }\n\n fn request_redraw(&self) {\n self.needs_redraw.set(true);\n }\n}\n\n#[derive(Default)]\nstruct SkiaTestSoftwareBuffer {\n pixels: RefCell>>,\n last_dirty_region: RefCell>,\n}\n\nimpl i_slint_renderer_skia::software_surface::RenderBuffer for SkiaTestSoftwareBuffer {\n fn with_buffer(\n &self,\n _window: &slint::Window,\n size: PhysicalSize,\n render_callback: &mut dyn FnMut(\n std::num::NonZeroU32,\n std::num::NonZeroU32,\n i_slint_renderer_skia::skia_safe::ColorType,\n u8,\n &mut [u8],\n ) -> Result<\n Option,\n i_slint_core::platform::PlatformError,\n >,\n ) -> Result<(), i_slint_core::platform::PlatformError> {\n let Some((width, height)): Option<(std::num::NonZeroU32, std::num::NonZeroU32)> =\n size.width.try_into().ok().zip(size.height.try_into().ok())\n else {\n // Nothing to render\n return Ok(());\n };\n\n let mut shared_pixel_buffer = self.pixels.borrow_mut().take();\n\n if shared_pixel_buffer.as_ref().is_some_and(|existing_buffer| {\n existing_buffer.width() != width.get() || existing_buffer.height() != height.get()\n }) {\n shared_pixel_buffer = None;\n }\n\n let mut age = 1;\n let pixels = shared_pixel_buffer.get_or_insert_with(|| {\n age = 0;\n SharedPixelBuffer::new(width.get(), height.get())\n });\n\n let bytes = bytemuck::cast_slice_mut(pixels.make_mut_slice());\n *self.last_dirty_region.borrow_mut() =\n render_callback(width, height, skia_safe::ColorType::RGBA8888, age, bytes)?;\n\n *self.pixels.borrow_mut() = shared_pixel_buffer;\n\n Ok(())\n }\n}\n\n#[test]\nfn interaction_with_dead_popup_impossible() {\n fn click(window: &Rc) {\n window.window().dispatch_event(slint::platform::WindowEvent::PointerPressed {\n position: slint::LogicalPosition { x: 50.0, y: 50.0 },\n button: slint::platform::PointerEventButton::Left,\n });\n\n window.draw_if_needed();\n\n window.window().dispatch_event(slint::platform::WindowEvent::PointerReleased {\n position: slint::LogicalPosition { x: 50.0, y: 50.0 },\n button: slint::platform::PointerEventButton::Left,\n });\n\n window.draw_if_needed();\n }\n\n slint::slint! {\n export component Ui inherits Window {\n property condition: true;\n out property result;\n out property under;\n out property open;\n\n width: 100px;\n height: 100px;\n\n TouchArea {\n clicked => {\n root.under += 1;\n debug(\"under\" , root.under);\n }\n }\n\n if condition: TouchArea {\n clicked => {\n root.open += 1;\n debug(\"open\" , root.open);\n popup.show();\n }\n popup := PopupWindow {\n close-policy: close-on-click-outside;\n width: 100%;\n height: 100%;\n Rectangle {\n width: 100%;\n height: 100%;\n background: green;\n }\n TouchArea {\n clicked => {\n root.result += 1;\n debug(\"result\", root.result);\n root.condition = false;\n debug(\"CONDITION CLEARED\");\n }\n }\n }\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n\n let window = SKIA_WINDOW.with(|w| w.clone());\n NEXT_WINDOW_CHOICE.with(|choice| {\n *choice.borrow_mut() = Some(window.clone());\n });\n let ui = Ui::new().unwrap();\n window.set_size(slint::PhysicalSize::new(100, 100).into());\n\n assert_eq!(ui.get_result(), 0);\n assert_eq!(ui.get_under(), 0);\n assert_eq!(ui.get_open(), 0);\n\n click(&window);\n assert_eq!(ui.get_result(), 0);\n assert_eq!(ui.get_under(), 0);\n assert_eq!(ui.get_open(), 1);\n\n click(&window);\n assert_eq!(ui.get_result(), 1);\n assert_eq!(ui.get_under(), 0);\n assert_eq!(ui.get_open(), 1);\n\n click(&window);\n assert_eq!(ui.get_result(), 1);\n assert_eq!(ui.get_under(), 1);\n assert_eq!(ui.get_open(), 1);\n\n click(&window);\n assert_eq!(ui.get_result(), 1);\n assert_eq!(ui.get_under(), 2);\n assert_eq!(ui.get_open(), 1);\n}\n\n#[test]\nfn interaction_with_dead_popup_panics() {\n fn click(window: &Rc) {\n window.window().dispatch_event(slint::platform::WindowEvent::PointerPressed {\n position: slint::LogicalPosition { x: 50.0, y: 50.0 },\n button: slint::platform::PointerEventButton::Left,\n });\n\n window.draw_if_needed();\n\n window.window().dispatch_event(slint::platform::WindowEvent::PointerReleased {\n position: slint::LogicalPosition { x: 50.0, y: 50.0 },\n button: slint::platform::PointerEventButton::Left,\n });\n\n window.draw_if_needed();\n }\n\n slint::slint! {\n export component Ui inherits Window {\n in-out property condition: true;\n\n width: 100px;\n height: 100px;\n\n t := Timer {\n running: false;\n interval: 1ms;\n triggered => {\n root.condition = false;\n self.running = false;\n }\n }\n if condition: TouchArea {\n clicked => {\n popup.show();\n t.start();\n }\n popup := PopupWindow {\n width: 100%;\n height: 100%;\n Rectangle {\n width: 100%;\n height: 100%;\n background: green;\n }\n TouchArea {\n clicked => {\n popup.close();\n }\n }\n }\n }\n }\n }\n\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n\n let window = SKIA_WINDOW.with(|w| w.clone());\n NEXT_WINDOW_CHOICE.with(|choice| {\n *choice.borrow_mut() = Some(window.clone());\n });\n let ui = Ui::new().unwrap();\n window.set_size(slint::PhysicalSize::new(100, 100).into());\n\n assert!(ui.get_condition());\n\n click(&window);\n assert!(ui.get_condition());\n\n ui.set_condition(false);\n\n click(&window);\n assert!(!ui.get_condition());\n}\n" }, { "path": "api/rs/slint/tests/show_strongref.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse ::slint::slint;\n\n#[test]\nfn show_maintains_strong_reference() {\n i_slint_backend_testing::init_integration_test_with_mock_time();\n\n slint!(export component TestWindow inherits Window {\n callback root-clicked();\n TouchArea {\n clicked => { root.root-clicked(); }\n }\n });\n\n let window = TestWindow::new().unwrap();\n\n let window_weak = window.as_weak();\n let window_weak_2 = window_weak.clone();\n\n slint::invoke_from_event_loop(move || {\n window_weak_2.upgrade().unwrap().hide().unwrap();\n slint::quit_event_loop().unwrap();\n })\n .unwrap();\n\n window.show().unwrap();\n drop(window);\n slint::run_event_loop().unwrap();\n\n assert!(window_weak.upgrade().is_none());\n}\n" }, { "path": "api/rs/slint/tests/simple_macro.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse ::slint::slint;\n\n#[test]\nfn simple_window() {\n i_slint_backend_testing::init_no_event_loop();\n slint!(export component X inherits Window{});\n X::new().unwrap();\n}\n#[test]\nfn empty_stuff() {\n slint!();\n slint!(export struct Hei { abcd: bool });\n slint!(export global G { });\n}\n\n#[test]\nfn test_serialize_deserialize_struct() {\n i_slint_backend_testing::init_no_event_loop();\n slint! {\n\n @rust-attr(derive(serde::Serialize, serde::Deserialize))\n export enum TestEnum {\n hello, world, xxx\n }\n\n @rust-attr(derive(serde::Serialize, serde::Deserialize))\n export struct TestStruct {\n enum: TestEnum,\n foo: int,\n }\n export component Test inherits Window { }\n }\n let data = TestStruct { foo: 1, r#enum: TestEnum::World };\n let serialized = serde_json::to_string(&data).unwrap();\n let deserialized: TestStruct = serde_json::from_str(&serialized).unwrap();\n assert_eq!(data, deserialized);\n}\n\n#[test]\nfn test_multiple_rust_attrs() {\n i_slint_backend_testing::init_no_event_loop();\n slint! {\n @rust-attr(derive(serde::Serialize, serde::Deserialize))\n @rust-attr(serde(rename_all = \"camelCase\"))\n export struct MultiAttr {\n field-foo: int,\n field-bar: float,\n }\n\n export component TestAttrs inherits Window { }\n }\n let data = MultiAttr { field_foo: 1, field_bar: 1.0 };\n let value = serde_json::to_value(&data).unwrap();\n assert_eq!(\n value,\n serde_json::json!({\n \"fieldFoo\": 1,\n \"fieldBar\": 1.0\n })\n );\n}\n" }, { "path": "api/rs/slint/tests/spawn_local.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n/// Code from https://doc.rust-lang.org/std/task/trait.Wake.html#examples\nmod executor {\n use std::future::Future;\n use std::sync::Arc;\n use std::task::{Context, Poll, Wake};\n use std::thread::{self, Thread};\n\n /// A waker that wakes up the current thread when called.\n struct ThreadWaker(Thread);\n\n impl Wake for ThreadWaker {\n fn wake(self: Arc) {\n self.0.unpark();\n }\n }\n\n /// Run a future to completion on the current thread.\n pub fn block_on(fut: impl Future) -> T {\n // Pin the future so it can be polled.\n let mut fut = Box::pin(fut);\n\n // Create a new context to be passed to the future.\n let t = thread::current();\n let waker = Arc::new(ThreadWaker(t)).into();\n let mut cx = Context::from_waker(&waker);\n\n // Run the future to completion.\n loop {\n match fut.as_mut().poll(&mut cx) {\n Poll::Ready(res) => return res,\n Poll::Pending => thread::park(),\n }\n }\n }\n}\n\n#[test]\nfn main() {\n i_slint_backend_testing::init_integration_test_with_mock_time();\n\n // test_spawn_local_from_thread\n std::thread::spawn(|| {\n assert_eq!(\n slint::spawn_local(async {\n panic!(\"the future shouldn't be run since we're in a thread\")\n })\n .map(drop),\n Err(slint::EventLoopError::NoEventLoopProvider)\n );\n })\n .join()\n .unwrap();\n\n slint::invoke_from_event_loop(|| {\n let handle = slint::spawn_local(async { String::from(\"Hello\") }).unwrap();\n slint::spawn_local(async move { panic!(\"Aborted task\") }).unwrap().abort();\n let handle2 = slint::spawn_local(async move { handle.await + \", World\" }).unwrap();\n std::thread::spawn(move || {\n let x = executor::block_on(handle2);\n assert_eq!(x, \"Hello, World\");\n });\n })\n .unwrap();\n\n // test_is_finished\n slint::invoke_from_event_loop(|| {\n let handle_one = slint::spawn_local(async { \"Hello, World!\" }).unwrap();\n assert!(!handle_one.is_finished());\n let handle_two = slint::spawn_local(async move {\n assert!(handle_one.is_finished());\n })\n .unwrap();\n std::thread::spawn(move || {\n let _ = executor::block_on(handle_two);\n });\n slint::quit_event_loop().unwrap();\n })\n .unwrap();\n slint::run_event_loop().unwrap();\n}\n\n#[test]\nfn with_context() {\n use i_slint_core::SlintContext;\n let ctx = SlintContext::new(Box::new(i_slint_backend_testing::TestingBackend::new(\n i_slint_backend_testing::TestingBackendOptions { mock_time: true, threading: true },\n )));\n let handle = ctx.spawn_local(async { String::from(\"Hello\") }).unwrap();\n ctx.spawn_local(async move { panic!(\"Aborted task\") }).unwrap().abort();\n let handle2 = ctx.spawn_local(async move { handle.await + \", World\" }).unwrap();\n let proxy = ctx.event_loop_proxy().unwrap();\n std::thread::spawn(move || {\n let x = executor::block_on(handle2);\n assert_eq!(x, \"Hello, World\");\n proxy.quit_event_loop().unwrap();\n });\n ctx.run_event_loop().unwrap()\n}\n" }, { "path": "api/rs/slint/tests/text_layout_cache.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\nuse slint::PhysicalSize;\nuse slint::platform::software_renderer::{\n MinimalSoftwareWindow, PremultipliedRgbaColor, RepaintBufferType, SoftwareRenderer, TargetPixel,\n};\nuse slint::platform::{PlatformError, WindowAdapter};\nuse std::rc::Rc;\n\nthread_local! {\n static WINDOW: Rc =\n MinimalSoftwareWindow::new(RepaintBufferType::ReusedBuffer);\n}\n\nstruct TestPlatform;\nimpl slint::platform::Platform for TestPlatform {\n fn create_window_adapter(&self) -> Result, PlatformError> {\n Ok(WINDOW.with(|x| x.clone()))\n }\n}\n\n#[allow(dead_code)]\n#[derive(Clone, Copy, Default)]\nstruct TestPixel(bool);\n\nimpl TargetPixel for TestPixel {\n fn blend(&mut self, _color: PremultipliedRgbaColor) {\n *self = Self(true);\n }\n\n fn from_rgb(_red: u8, _green: u8, _blue: u8) -> Self {\n Self(true)\n }\n}\n\nconst WIDTH: usize = 200;\nconst HEIGHT: usize = 100;\n\nfn setup() -> Rc {\n slint::platform::set_platform(Box::new(TestPlatform)).ok();\n let window = WINDOW.with(|x| x.clone());\n window.set_size(PhysicalSize::new(WIDTH as u32, HEIGHT as u32));\n window\n}\n\nfn render_and_get_miss_count(renderer: &SoftwareRenderer) -> u64 {\n renderer.text_layout_cache().reset_cache_miss_count();\n let mut buf = vec![TestPixel(false); WIDTH * HEIGHT];\n renderer.render(buf.as_mut_slice(), WIDTH);\n renderer.text_layout_cache().cache_miss_count()\n}\n\n#[test]\nfn cache_hit_avoids_reshaping() {\n let window = setup();\n\n slint::slint! {\n export component TestComponent inherits Window {\n Text {\n text: \"Hello World\";\n }\n }\n }\n\n let ui = TestComponent::new().unwrap();\n ui.show().unwrap();\n\n let mut miss_count = 0u64;\n\n // First render: should shape at least once\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert!(miss_count > 0, \"Expected at least one cache miss on first render\");\n\n // Second render without changes: should hit cache\n window.request_redraw();\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert_eq!(miss_count, 0, \"Expected zero cache misses on re-render without changes\");\n}\n\n#[test]\nfn text_change_invalidates_cache() {\n let window = setup();\n\n slint::slint! {\n export component TestComponent inherits Window {\n in property label: \"Hello\";\n Text {\n text: label;\n }\n }\n }\n\n let ui = TestComponent::new().unwrap();\n ui.show().unwrap();\n\n // First render\n window.draw_if_needed(|renderer| {\n render_and_get_miss_count(renderer);\n });\n\n // Change text\n ui.set_label(\"Goodbye\".into());\n\n let mut miss_count = 0u64;\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert!(miss_count > 0, \"Expected cache miss after text change\");\n}\n\n#[test]\nfn font_size_change_invalidates_cache() {\n let window = setup();\n\n slint::slint! {\n export component TestComponent inherits Window {\n in property size: 16px;\n Text {\n text: \"Hello\";\n font-size: size;\n }\n }\n }\n\n let ui = TestComponent::new().unwrap();\n ui.show().unwrap();\n\n // First render\n window.draw_if_needed(|renderer| {\n render_and_get_miss_count(renderer);\n });\n\n // Change font-size\n ui.set_size(24.0);\n\n let mut miss_count = 0u64;\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert!(miss_count > 0, \"Expected cache miss after font-size change\");\n}\n\n#[test]\nfn font_weight_change_invalidates_cache() {\n let window = setup();\n\n slint::slint! {\n export component TestComponent inherits Window {\n in property weight: 400;\n Text {\n text: \"Hello\";\n font-weight: weight;\n }\n }\n }\n\n let ui = TestComponent::new().unwrap();\n ui.show().unwrap();\n\n // First render\n window.draw_if_needed(|renderer| {\n render_and_get_miss_count(renderer);\n });\n\n // Change font-weight\n ui.set_weight(700);\n\n let mut miss_count = 0u64;\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert!(miss_count > 0, \"Expected cache miss after font-weight change\");\n}\n\n#[test]\nfn wrap_change_invalidates_cache() {\n let window = setup();\n\n slint::slint! {\n export component TestComponent inherits Window {\n in property use-no-wrap: false;\n Text {\n text: \"Hello World this is a long text\";\n wrap: use-no-wrap ? no-wrap : word-wrap;\n }\n }\n }\n\n let ui = TestComponent::new().unwrap();\n ui.show().unwrap();\n\n // First render (word-wrap)\n window.draw_if_needed(|renderer| {\n render_and_get_miss_count(renderer);\n });\n\n // Change wrap to no-wrap\n ui.set_use_no_wrap(true);\n\n let mut miss_count = 0u64;\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert!(miss_count > 0, \"Expected cache miss after wrap change\");\n}\n\n#[test]\nfn alignment_change_does_not_reshape() {\n let window = setup();\n\n slint::slint! {\n export component TestComponent inherits Window {\n in property use-center-align: false;\n Text {\n text: \"Hello World\";\n horizontal-alignment: use-center-align ? TextHorizontalAlignment.center : TextHorizontalAlignment.left;\n }\n }\n }\n\n let ui = TestComponent::new().unwrap();\n ui.show().unwrap();\n\n // First render (left-aligned)\n window.draw_if_needed(|renderer| {\n render_and_get_miss_count(renderer);\n });\n\n // Change alignment to center\n ui.set_use_center_align(true);\n\n let mut miss_count = 0u64;\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert_eq!(miss_count, 0, \"Alignment change should not cause reshaping\");\n}\n\n#[test]\nfn overflow_change_does_not_reshape() {\n let window = setup();\n\n slint::slint! {\n export component TestComponent inherits Window {\n in property use-elide: false;\n Text {\n text: \"Hello World\";\n overflow: use-elide ? TextOverflow.elide : TextOverflow.clip;\n }\n }\n }\n\n let ui = TestComponent::new().unwrap();\n ui.show().unwrap();\n\n // First render (clip)\n window.draw_if_needed(|renderer| {\n render_and_get_miss_count(renderer);\n });\n\n // Change overflow to elide\n ui.set_use_elide(true);\n\n let mut miss_count = 0u64;\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert_eq!(miss_count, 0, \"Overflow change should not cause reshaping\");\n}\n\n#[test]\nfn color_change_does_not_reshape() {\n let window = setup();\n\n slint::slint! {\n export component TestComponent inherits Window {\n in property text-color: black;\n Text {\n text: \"Hello World\";\n color: text-color;\n }\n }\n }\n\n let ui = TestComponent::new().unwrap();\n ui.show().unwrap();\n\n // First render\n window.draw_if_needed(|renderer| {\n render_and_get_miss_count(renderer);\n });\n\n // Change color\n ui.set_text_color(slint::Color::from_rgb_u8(255, 0, 0));\n\n let mut miss_count = 0u64;\n assert!(window.draw_if_needed(|renderer| {\n miss_count = render_and_get_miss_count(renderer);\n }));\n assert_eq!(miss_count, 0, \"Color change should not cause reshaping\");\n}\n" }, { "path": "api/rs/slint/tests/tokio.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#[test]\nfn tokio_poll_with_compat() {\n i_slint_backend_testing::init_integration_test_with_mock_time();\n use std::io::Write;\n\n let listener = std::net::TcpListener::bind(\"127.0.0.1:0\").unwrap();\n let local_addr = listener.local_addr().unwrap();\n let server = std::thread::spawn(move || {\n let mut stream = listener.incoming().next().unwrap().unwrap();\n stream.write(\"Hello World\".as_bytes()).unwrap();\n });\n\n let slint_future = async move {\n for _ in 0..1000 {\n tokio::task::consume_budget().await;\n }\n\n use tokio::io::AsyncReadExt;\n let mut stream = tokio::net::TcpStream::connect(local_addr).await.unwrap();\n let mut data = Vec::new();\n stream.read_to_end(&mut data).await.unwrap();\n assert_eq!(data, \"Hello World\".as_bytes());\n slint::quit_event_loop().unwrap();\n };\n\n slint::spawn_local(async_compat::Compat::new(slint_future)).unwrap();\n\n slint::run_event_loop_until_quit().unwrap();\n\n server.join().unwrap();\n}\n" }, { "path": "api/rs/slint/tests/tokio_block_in_place.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n#[tokio::test(flavor = \"multi_thread\", worker_threads = 1)]\nasync fn tokio_poll_with_block_in_place() {\n i_slint_backend_testing::init_integration_test_with_mock_time();\n use std::io::Write;\n\n let listener = std::net::TcpListener::bind(\"127.0.0.1:0\").unwrap();\n let local_addr = listener.local_addr().unwrap();\n let server = std::thread::spawn(move || {\n let mut stream = listener.incoming().next().unwrap().unwrap();\n stream.write(\"Hello World\".as_bytes()).unwrap();\n });\n\n let slint_future = async move {\n for _ in 0..1000 {\n tokio::task::consume_budget().await;\n }\n\n use tokio::io::AsyncReadExt;\n let mut stream = tokio::net::TcpStream::connect(local_addr).await.unwrap();\n let mut data = Vec::new();\n stream.read_to_end(&mut data).await.unwrap();\n assert_eq!(data, \"Hello World\".as_bytes());\n slint::quit_event_loop().unwrap();\n };\n\n slint::spawn_local(slint_future).unwrap();\n\n tokio::task::block_in_place(slint::run_event_loop_until_quit).unwrap();\n\n server.join().unwrap();\n}\n" }, { "path": "api/rs/slint/type-mappings.md", "content": "# Type Mappings\n\nThe types used for properties in `.slint` design markup each translate to specific types in Rust.\nThe follow table summarizes the entire mapping:\n\n| `.slint` Type | Rust Type | Note |\n| --- | --- | --- |\n| `angle` | `f32` | The angle in degrees |\n| `array` | [`ModelRc`] | Arrays are represented as models, so that their contents can change dynamically. |\n| `bool` | `bool` | |\n| `brush` | [`Brush`] | |\n| `color` | [`Color`] | |\n| `duration` | `i64` | At run-time, durations are always represented as signed 64-bit integers with millisecond precision. |\n| `float` | `f32` | |\n| `image` | [`Image`] | |\n| `int` | `i32` | |\n| `length` | `f32` | At run-time, logical lengths are automatically translated to physical pixels using the device pixel ratio. |\n| `physical_length` | `f32` | The unit are physical pixels. |\n| `Point` | [`LogicalPosition`] | A struct with `x` and `y` fields, representing logical coordinates. |\n| `relative-font-size` | `f32` | Relative font size factor that is multiplied with the `Window.default-font-size` and can be converted to a `length`. |\n| `string` | [`SharedString`] | A reference-counted string type that can be easily converted to a str reference. |\n| anonymous object | anonymous tuple | The fields are in alphabetical order. |\n| enumeration | `enum` of the same name | The values are converted to CamelCase |\n| structure | `struct` of the same name | |\n\nFor user defined structures in the .slint, an extra struct is generated.\nFor example, if the `.slint` contains\n```slint,ignore\nexport struct MyStruct {\n foo: int,\n bar: string,\n names: [string],\n}\n```\n\nThe following struct would be generated:\n\n```rust\n#[derive(Default, Clone, Debug, PartialEq)]\nstruct MyStruct {\n foo: i32,\n bar: slint::SharedString,\n names: slint::ModelRc,\n}\n```\n\nThe `.slint` file allows you to utilize Rust attributes and features for defining structures using the `@rust-attr()` directive.\nThis enables you to customize the generated code by applying additional traits, derivations, or annotations.\nConsider the following structure defined in the `.slint` file with Rust attributes:\n```slint,ignore\n@rust-attr(derive(serde::Serialize, serde::Deserialize))\nstruct MyStruct {\n foo: int,\n}\n```\n\nBased on this structure, the following Rust code would be generated:\n\n```rust\n#[derive(serde::Serialize, serde::Deserialize)]\n#[derive(Default, Clone, Debug, PartialEq)]\nstruct MyStruct {\n foo: i32,\n}\n```\n\nAlso you can use multiple `@rust-attr()` directives. For example:\n\n```slint,ignore\n@rust-attr(derive(serde::Serialize, serde::Deserialize))\n@rust-attr(serde(rename_all = \"camelCase\"))\nstruct MyStruct {\n foo-bar: int,\n}\n```\n" }, { "path": "api/wasm-interpreter/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n[package]\nname = \"slint-wasm-interpreter\"\ndescription = \"Slint wasm glue\"\nauthors.workspace = true\nedition.workspace = true\nhomepage.workspace = true\nlicense.workspace = true\nrepository.workspace = true\nrust-version.workspace = true\nversion.workspace = true\npublish = false\n\n[lib]\ncrate-type = [\"cdylib\"]\n\n[dependencies]\nslint-interpreter = { workspace = true, features = [\"std\", \"backend-winit\", \"renderer-femtovg\", \"compat-1-2\", \"internal\"] }\ni-slint-backend-winit = { workspace = true }\ni-slint-core = { workspace = true }\nsend_wrapper = { workspace = true }\n\nvtable = { workspace = true }\n\nconsole_error_panic_hook = { version = \"0.1.6\", optional = true }\njs-sys = \"0.3.44\"\nwasm-bindgen-futures = { version = \"0.4.18\" }\nwasm-bindgen = { version = \"0.2.66\" }\nweb-sys = { workspace = true, features = [\"Request\", \"RequestInit\", \"RequestMode\", \"Response\", \"Window\"] }\n\n#[dev-dependencies]\n#wasm-bindgen-test = \"0.3.13\"\n" }, { "path": "api/wasm-interpreter/src/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\n//! This wasm library can be loaded from JS to load and display the content of .slint files\n#![cfg(target_arch = \"wasm32\")]\n\nuse std::cell::RefCell;\nuse std::path::Path;\nuse std::rc::Rc;\nuse wasm_bindgen::prelude::*;\n\nuse slint_interpreter::ComponentHandle;\n\n#[wasm_bindgen]\n#[allow(dead_code)]\npub struct CompilationResult {\n component: Option,\n diagnostics: js_sys::Array,\n error_string: String,\n}\n\n#[wasm_bindgen]\nimpl CompilationResult {\n #[wasm_bindgen(getter)]\n pub fn component(&self) -> Option {\n self.component.clone()\n }\n #[wasm_bindgen(getter)]\n pub fn diagnostics(&self) -> js_sys::Array {\n self.diagnostics.clone()\n }\n #[wasm_bindgen(getter)]\n pub fn error_string(&self) -> String {\n self.error_string.clone()\n }\n}\n\n#[wasm_bindgen(typescript_custom_section)]\nconst CALLBACK_FUNCTION_SECTION: &'static str = r#\"\ntype ImportCallbackFunction = (url: string) => Promise;\ntype CurrentElementInformationCallbackFunction = (url: string, start_line: number, start_column: number, end_line: number, end_column: number) => void;\n\"#;\n\n#[wasm_bindgen]\nextern \"C\" {\n #[wasm_bindgen(typescript_type = \"ImportCallbackFunction\")]\n pub type ImportCallbackFunction;\n\n #[wasm_bindgen(typescript_type = \"CurrentElementInformationCallbackFunction\")]\n pub type CurrentElementInformationCallbackFunction;\n #[wasm_bindgen(typescript_type = \"Promise\")]\n pub type InstancePromise;\n}\n\n/// Compile the content of a string.\n///\n/// Returns a promise to a compiled component which can be run with \".run()\"\n#[wasm_bindgen]\npub async fn compile_from_string(\n source: String,\n base_url: String,\n optional_import_callback: Option,\n) -> Result {\n compile_from_string_with_style(source, base_url, String::new(), optional_import_callback).await\n}\n\n/// Same as [`compile_from_string`], but also takes a style parameter\n#[wasm_bindgen]\npub async fn compile_from_string_with_style(\n source: String,\n base_url: String,\n style: String,\n optional_import_callback: Option,\n) -> Result {\n #[allow(deprecated)]\n let mut compiler = slint_interpreter::ComponentCompiler::default();\n if !style.is_empty() {\n compiler.set_style(style)\n }\n\n if let Some(load_callback) = optional_import_callback {\n let open_import_callback = move |file_name: &Path| -> core::pin::Pin<\n Box>>>,\n > {\n Box::pin({\n let load_callback = js_sys::Function::from(load_callback.clone());\n let file_name: String = file_name.to_string_lossy().into();\n async move {\n let result = load_callback.call1(&JsValue::UNDEFINED, &file_name.into());\n let promise: js_sys::Promise = result.unwrap().into();\n let future = wasm_bindgen_futures::JsFuture::from(promise);\n match future.await {\n Ok(js_ok) => Some(Ok(js_ok.as_string().unwrap_or_default())),\n Err(js_err) => Some(Err(std::io::Error::new(\n std::io::ErrorKind::Other,\n js_err.as_string().unwrap_or_default(),\n ))),\n }\n }\n })\n };\n compiler.set_file_loader(open_import_callback);\n }\n\n let c = compiler.build_from_source(source, base_url.into()).await;\n\n let line_key = JsValue::from_str(\"lineNumber\");\n let column_key = JsValue::from_str(\"columnNumber\");\n let message_key = JsValue::from_str(\"message\");\n let file_key = JsValue::from_str(\"fileName\");\n let level_key = JsValue::from_str(\"level\");\n let mut error_as_string = String::new();\n let array = js_sys::Array::new();\n for d in compiler.diagnostics().into_iter() {\n let filename =\n d.source_file().as_ref().map_or(String::new(), |sf| sf.to_string_lossy().into());\n\n let filename_js = JsValue::from_str(&filename);\n let (line, column) = d.line_column();\n\n if d.level() == slint_interpreter::DiagnosticLevel::Error {\n if !error_as_string.is_empty() {\n error_as_string.push_str(\"\\n\");\n }\n use std::fmt::Write;\n\n write!(&mut error_as_string, \"{}:{}:{}\", filename, line, d).unwrap();\n }\n\n let error_obj = js_sys::Object::new();\n js_sys::Reflect::set(&error_obj, &message_key, &JsValue::from_str(&d.message()))?;\n js_sys::Reflect::set(&error_obj, &line_key, &JsValue::from_f64(line as f64))?;\n js_sys::Reflect::set(&error_obj, &column_key, &JsValue::from_f64(column as f64))?;\n js_sys::Reflect::set(&error_obj, &file_key, &filename_js)?;\n js_sys::Reflect::set(&error_obj, &level_key, &JsValue::from_f64(d.level() as i8 as f64))?;\n array.push(&error_obj);\n }\n\n Ok(CompilationResult {\n component: c.map(|c| WrappedCompiledComp(c)),\n diagnostics: array,\n error_string: error_as_string,\n })\n}\n\n#[wasm_bindgen]\n#[derive(Clone)]\npub struct WrappedCompiledComp(slint_interpreter::ComponentDefinition);\n\n#[wasm_bindgen]\nimpl WrappedCompiledComp {\n /// Run this compiled component in a canvas.\n /// The HTML must contains a element with the given `canvas_id`\n /// where the result is gonna be rendered\n #[wasm_bindgen]\n pub fn run(&self, canvas_id: String) {\n NEXT_CANVAS_ID.with(|next_id| {\n *next_id.borrow_mut() = Some(canvas_id);\n });\n let component = self.0.create().unwrap();\n component.show().unwrap();\n // Merely spawns the event loop, but does not block.\n slint_interpreter::run_event_loop().unwrap();\n }\n /// Creates this compiled component in a canvas, wrapped in a promise.\n /// The HTML must contains a element with the given `canvas_id`\n /// where the result is gonna be rendered.\n /// You need to call `show()` on the returned instance for rendering.\n ///\n /// Note that the promise will only be resolved after calling `slint.run_event_loop()`.\n #[wasm_bindgen]\n pub fn create(&self, canvas_id: String) -> Result {\n Ok(JsValue::from(js_sys::Promise::new(&mut |resolve, reject| {\n let comp = send_wrapper::SendWrapper::new(self.0.clone());\n let canvas_id = canvas_id.clone();\n let resolve = send_wrapper::SendWrapper::new(resolve);\n if let Err(e) = slint_interpreter::invoke_from_event_loop(move || {\n NEXT_CANVAS_ID.with(|next_id| {\n *next_id.borrow_mut() = Some(canvas_id);\n });\n let instance = WrappedInstance(comp.take().create().unwrap());\n resolve.take().call1(&JsValue::UNDEFINED, &JsValue::from(instance)).unwrap_throw();\n }) {\n reject\n .call1(\n &JsValue::UNDEFINED,\n &JsValue::from(format!(\n \"internal error: Failed to queue closure for event loop invocation: {e}\"\n )),\n )\n .unwrap_throw();\n }\n }))\n .unchecked_into::())\n }\n /// Creates this compiled component in the canvas of the provided instance, wrapped in a promise.\n /// For this to work, the provided instance needs to be visible (show() must've been\n /// called) and the event loop must be running (`slint.run_event_loop()`). After this\n /// call the provided instance is not rendered anymore and can be discarded.\n ///\n /// Note that the promise will only be resolved after calling `slint.run_event_loop()`.\n #[wasm_bindgen]\n pub fn create_with_existing_window(\n &self,\n instance: WrappedInstance,\n ) -> Result {\n Ok(JsValue::from(js_sys::Promise::new(&mut |resolve, reject| {\n let params = send_wrapper::SendWrapper::new((\n self.0.clone(),\n instance.0.clone_strong(),\n resolve,\n ));\n if let Err(e) = slint_interpreter::invoke_from_event_loop(move || {\n let (comp, instance, resolve) = params.take();\n let instance =\n WrappedInstance(comp.create_with_existing_window(instance.window()).unwrap());\n resolve.call1(&JsValue::UNDEFINED, &JsValue::from(instance)).unwrap_throw();\n }) {\n reject\n .call1(\n &JsValue::UNDEFINED,\n &JsValue::from(format!(\n \"internal error: Failed to queue closure for event loop invocation: {e}\"\n )),\n )\n .unwrap_throw();\n }\n }))\n .unchecked_into::())\n }\n}\n\n#[wasm_bindgen]\npub struct WrappedInstance(slint_interpreter::ComponentInstance);\n\nimpl Clone for WrappedInstance {\n fn clone(&self) -> Self {\n Self(self.0.clone_strong())\n }\n}\n\n#[wasm_bindgen]\nimpl WrappedInstance {\n /// Marks this instance for rendering and input handling.\n ///\n /// Note that the promise will only be resolved after calling `slint.run_event_loop()`.\n #[wasm_bindgen]\n pub fn show(&self) -> Result {\n self.invoke_from_event_loop_wrapped_in_promise(|instance| instance.show())\n }\n /// Hides this instance and prevents further updates of the canvas element.\n ///\n /// Note that the promise will only be resolved after calling `slint.run_event_loop()`.\n #[wasm_bindgen]\n pub fn hide(&self) -> Result {\n self.invoke_from_event_loop_wrapped_in_promise(|instance| instance.hide())\n }\n\n fn invoke_from_event_loop_wrapped_in_promise(\n &self,\n callback: impl FnOnce(\n &slint_interpreter::ComponentInstance,\n ) -> Result<(), slint_interpreter::PlatformError>\n + 'static,\n ) -> Result {\n let callback = std::cell::RefCell::new(Some(callback));\n Ok(js_sys::Promise::new(&mut |resolve, reject| {\n let inst_weak = self.0.as_weak();\n\n if let Err(e) = slint_interpreter::invoke_from_event_loop({\n let params = send_wrapper::SendWrapper::new((\n resolve,\n reject.clone(),\n callback.take().unwrap(),\n ));\n move || {\n let (resolve, reject, callback) = params.take();\n match inst_weak.upgrade() {\n Some(instance) => match callback(&instance) {\n Ok(()) => {\n resolve.call0(&JsValue::UNDEFINED).unwrap_throw();\n }\n Err(e) => {\n reject\n .call1(\n &JsValue::UNDEFINED,\n &JsValue::from(format!(\n \"Invocation on ComponentInstance from within event loop failed: {e}\"\n )),\n )\n .unwrap_throw();\n }\n },\n None => {\n reject\n .call1(\n &JsValue::UNDEFINED,\n &JsValue::from(format!(\n \"Invocation on ComponentInstance failed because instance was deleted too soon\"\n )),\n )\n .unwrap_throw();\n }\n }\n }\n }) {\n reject\n .call1(\n &JsValue::UNDEFINED,\n &JsValue::from(format!(\n \"internal error: Failed to queue closure for event loop invocation: {e}\"\n )),\n )\n .unwrap_throw();\n }\n }))\n }\n}\n\n/// Register DOM event handlers on all instance and set up the event loop for that.\n/// You can call this function only once. It will throw an exception but that is safe\n/// to ignore.\n#[wasm_bindgen]\npub fn run_event_loop() -> Result<(), JsValue> {\n // Merely spawns the event loop, but does not block.\n slint_interpreter::run_event_loop().map_err(|e| -> JsValue { format!(\"{e}\").into() })?;\n Ok(())\n}\n\nthread_local!(\n static NEXT_CANVAS_ID: Rc>> = Default::default();\n);\n\n#[wasm_bindgen(start)]\npub fn init() -> Result<(), JsValue> {\n #[cfg(feature = \"console_error_panic_hook\")]\n console_error_panic_hook::set_once();\n let backend = i_slint_backend_winit::Backend::builder()\n .with_spawn_event_loop(true)\n .with_window_attributes_hook(|mut attrs| {\n NEXT_CANVAS_ID.with(|next_id| {\n if let Some(canvas_id) = next_id.borrow_mut().take() {\n use i_slint_backend_winit::winit::platform::web::WindowAttributesExtWebSys;\n\n use wasm_bindgen::JsCast;\n\n let html_canvas = web_sys::window()\n .expect(\"wasm-interpreter: Could not retrieve DOM window\")\n .document()\n .expect(\"wasm-interpreter: Could not retrieve DOM document\")\n .get_element_by_id(&canvas_id)\n .unwrap_or_else(|| {\n panic!(\n \"wasm-interpreter: Could not retrieve existing HTML Canvas element '{}'\",\n canvas_id\n )\n })\n .dyn_into::()\n .unwrap_or_else(|_| {\n panic!(\n \"winit backend: Specified DOM element '{}' is not a HTML Canvas\",\n canvas_id\n )\n });\n attrs = attrs\n .with_canvas(Some(html_canvas))\n // Don't activate the window by default, as that will cause the page to scroll,\n // ignoring any existing anchors.\n .with_active(false);\n attrs\n } else {\n attrs\n }\n })\n })\n .build()\n .unwrap();\n i_slint_core::platform::set_platform(Box::new(backend))\n .map_err(|e| -> JsValue { format!(\"{e}\").into() })?;\n Ok(())\n}\n" }, { "path": "biome.json", "content": "{\n \"$schema\": \"./node_modules/@biomejs/biome/configuration_schema.json\",\n \"formatter\": {\n \"enabled\": true,\n \"formatWithErrors\": false,\n \"indentStyle\": \"space\",\n \"indentWidth\": 4,\n \"lineEnding\": \"lf\",\n \"attributePosition\": \"auto\",\n \"includes\": [\n \"**\",\n \"!**/.vscode/**\",\n \"!**/*.json\",\n \"!**/dist/**\",\n \"!**/build/**\",\n \"!**/!biome.json\",\n \"!**/editors/vscode/out/**\"\n ]\n },\n \"assist\": {\n \"actions\": {\n \"source\": {\n \"organizeImports\": \"off\"\n }\n }\n },\n \"linter\": {\n \"enabled\": true,\n \"includes\": [\"**\", \"!**/dist/**\"],\n \"rules\": {\n \"recommended\": false,\n \"complexity\": {\n \"noBannedTypes\": \"warn\",\n \"noUselessConstructor\": \"error\"\n },\n \"style\": {\n \"useBlockStatements\": \"warn\",\n \"noUselessElse\": \"off\",\n \"useConst\": \"error\",\n \"useImportType\": \"error\",\n \"useNodejsImportProtocol\": \"error\"\n },\n \"nursery\": {\n \"noFloatingPromises\": \"error\"\n },\n \"suspicious\": {\n \"noDoubleEquals\": \"error\",\n \"noRedundantUseStrict\": \"warn\",\n \"noImplicitAnyLet\": \"error\",\n \"useAwait\": \"error\"\n }\n }\n },\n \"javascript\": {\n \"formatter\": {\n \"jsxQuoteStyle\": \"double\",\n \"quoteProperties\": \"asNeeded\",\n \"semicolons\": \"always\",\n \"bracketSpacing\": true,\n \"bracketSameLine\": false,\n \"quoteStyle\": \"double\",\n \"attributePosition\": \"auto\"\n }\n }\n}\n" }, { "path": "cmake/FindOpenGLES2.cmake", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\ninclude(CheckCXXSourceCompiles)\n\nfind_path(OPENGLES2_INCLUDE_DIR NAMES \"GLES2/gl2.h\" \"OpenGLES/ES2/gl.h\" DOC \"The path where the OpenGL ES 2.0 headers are located\")\nfind_library(OPENGLES2_LIBRARY NAMES GLESv2 OpenGLES)\n\n# Sometimes EGL linkage is required, so look it up and always use if available.\nfind_package(OpenGL COMPONENTS EGL)\n\n# See if we can compile some example code with what we've found.\nset(saved_libraries \"${CMAKE_REQUIRED_LIBRARIES}\")\nset(saved_includes \"${CMAKE_REQUIRED_INCLUDES}\")\n\nif (OPENGLES2_LIBRARY)\n list(APPEND CMAKE_REQUIRED_INCLUDES \"${OPENGLES2_INCLUDE_DIR}\")\n list(APPEND CMAKE_REQUIRED_LIBRARIES \"${OPENGLES2_LIBRARY}\")\nendif()\n\nif(OPENGL_egl_LIBRARY)\n list(APPEND CMAKE_REQUIRED_INCLUDES \"${OPENGL_EGL_INCLUDE_DIRS}\")\n list(APPEND CMAKE_REQUIRED_LIBRARIES \"${OPENGL_egl_LIBRARY}\")\nendif()\n\ncheck_cxx_source_compiles(\"\n#include \n#include \n\nint main(int argc, char *argv[]) {\n glClear(GL_STENCIL_BUFFER_BIT);\n glUseProgram(0);\n}\" HAVE_OPENGLES2)\n\nset(CMAKE_REQUIRED_INCLUDES \"${saved_includes}\")\nset(CMAKE_REQUIRED_LIBRARIES \"${saved_libraries}\")\n\n# Standard CMake package dance\nset(package_args OPENGLES2_INCLUDE_DIR OPENGLES2_LIBRARY HAVE_OPENGLES2)\ninclude(FindPackageHandleStandardArgs)\nfind_package_handle_standard_args(OpenGLES2 DEFAULT_MSG ${package_args})\nmark_as_advanced(${package_args})\n\n# Create a convenience target for linkage\nif (OPENGLES2_FOUND AND NOT TARGET OpenGLES2::OpenGLES2)\n add_library(OpenGLES2::OpenGLES2 UNKNOWN IMPORTED)\n set_property(TARGET OpenGLES2::OpenGLES2 PROPERTY INTERFACE_INCLUDE_DIRECTORIES \"${OPENGLES2_INCLUDE_DIR}\")\n set_property(TARGET OpenGLES2::OpenGLES2 PROPERTY IMPORTED_LOCATION \"${OPENGLES2_LIBRARY}\")\n if (TARGET OpenGL::EGL)\n target_link_libraries(OpenGLES2::OpenGLES2 INTERFACE OpenGL::EGL)\n endif()\nendif()\n" }, { "path": "cmake/FindOpenGLES3.cmake", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-Slint-Royalty-free-2.0 OR LicenseRef-Slint-Software-3.0\n\ninclude(CheckCXXSourceCompiles)\n\nfind_path(OPENGLES3_INCLUDE_DIR NAMES \"GLES3/gl3.h\" \"OpenGLES/ES3/gl.h\" DOC \"The path where the OpenGL ES 3.0 headers are located\")\n# GLESv3 entry points are in v2 lib\nfind_library(OPENGLES3_LIBRARY NAMES GLESv2 OpenGLES)\n\n# Sometimes EGL linkage is required, so look it up and always use if available.\nfind_package(OpenGL COMPONENTS EGL)\n\n# See if we can compile some example code with what we've found.\nset(saved_libraries \"${CMAKE_REQUIRED_LIBRARIES}\")\nset(saved_includes \"${CMAKE_REQUIRED_INCLUDES}\")\n\nif (OPENGLES3_LIBRARY AND OPENGLES3_INCLUDE_DIR)\n list(APPEND CMAKE_REQUIRED_INCLUDES \"${OPENGLES3_INCLUDE_DIR}\")\n list(APPEND CMAKE_REQUIRED_LIBRARIES \"${OPENGLES3_LIBRARY}\")\nendif()\n\nif(OPENGL_egl_LIBRARY)\n list(APPEND CMAKE_REQUIRED_INCLUDES \"${OPENGL_EGL_INCLUDE_DIRS}\")\n list(APPEND CMAKE_REQUIRED_LIBRARIES \"${OPENGL_egl_LIBRARY}\")\nendif()\n\ncheck_cxx_source_compiles(\"\n#include \n#include \n\nint main(int argc, char *argv[]) {\n glClear(GL_STENCIL_BUFFER_BIT);\n glUseProgram(0);\n}\" HAVE_OPENGLES3)\n\nset(CMAKE_REQUIRED_INCLUDES \"${saved_includes}\")\nset(CMAKE_REQUIRED_LIBRARIES \"${saved_libraries}\")\n\n# Standard CMake package dance\nset(package_args OPENGLES3_INCLUDE_DIR OPENGLES3_LIBRARY HAVE_OPENGLES3)\ninclude(FindPackageHandleStandardArgs)\nfind_package_handle_standard_args(OpenGLES3 DEFAULT_MSG ${package_args})\nmark_as_advanced(${package_args})\n\n# Create a convenience target for linkage\nif (OPENGLES3_FOUND AND NOT TARGET OpenGLES3::OpenGLES3)\n add_library(OpenGLES3::OpenGLES3 UNKNOWN IMPORTED)\n set_property(TARGET OpenGLES3::OpenGLES3 PROPERTY INTERFACE_INCLUDE_DIRECTORIES \"${OPENGLES3_INCLUDE_DIR}\")\n set_property(TARGET OpenGLES3::OpenGLES3 PROPERTY IMPORTED_LOCATION \"${OPENGLES3_LIBRARY}\")\n if (TARGET OpenGL::EGL)\n target_link_libraries(OpenGLES3::OpenGLES3 INTERFACE OpenGL::EGL)\n endif()\nendif()\n" }, { "path": "cspell.json", "content": "{\n \"version\": \"0.2\",\n \"language\": \"en\",\n \"languageSettings\": [\n {\n \"languageId\": \"rust\",\n \"words\": [\n \"ARGB\",\n \"astrojs\",\n \"bbox\",\n \"bindgen\",\n \"builtins\",\n \"canonicalize\", // std::path::Path::canonicalize\n \"codemap\",\n \"concat\",\n \"Consts\",\n \"evenodd\",\n \"FBOs\", // plural of FBO (frame buffer object)\n \"femtovg\",\n \"fontdb\",\n \"fullscreen\",\n \"glutin\",\n \"glutin's\",\n \"maxx\",\n \"maxy\",\n \"minx\",\n \"miny\",\n \"peekable\",\n \"Realloc\",\n \"refcell\",\n \"Rgba\",\n \"rtti\",\n \"Smol\",\n \"smolstr\",\n \"subspan\",\n \"uninit\",\n \"unmap\",\n \"unsync\",\n \"vsync\"\n ],\n \"ignoreRegExpList\": [\n \"/#\\\\[cfg\\\\b.+\\\\]/\",\n \"/#\\\\[repr\\\\b.+\\\\]/\",\n // Exclude crate paths\n \"/(\\\\b|::)[a-z0-9_]+::/\",\n \"/::[a-z0-9_]+(\\\\b|::)/\",\n // Qt things:\n \"/\\\\bQt_[a-zA-Z0-9_]+/\"\n ]\n },\n {\n \"languageId\": \"restructuredtext\",\n \"words\": [\n \"genindex\",\n \"modindex\",\n \"toctree\"\n ],\n \"ignoreRegExpList\": [\n \"/:.+:/\"\n ]\n },\n {\n \"languageId\": [\n \"markdown\",\n \"md\",\n \"mdx\"\n ],\n \"words\": [\n \"Espressif\",\n \"linebuffer\",\n \"mylibrary\",\n \"otherlibrary\",\n \"Lmylibrary\",\n \"progressindicator\",\n \"standardbutton\",\n \"standardlistview\",\n \"standardtableview\",\n \"rustup\",\n \"setdefault\",\n \"Sonoma\",\n \"SUBDIR\",\n \"Torizon\",\n \"Yocto\",\n \"relpath\",\n \"classslint\",\n \"vectormodel\",\n \"structslint\",\n \"namespaceslint\",\n \"compilerconfiguration\",\n \"tschüß\",\n \"TSCHÜSS\",\n \"ὈΔΥΣΣΕΎΣ\",\n \"ὀδυσσεύς\",\n \"commonmark\",\n \"strikethroughs\"\n ],\n }\n ],\n \"words\": [\n \"aarch\",\n \"accesskit\",\n \"antialiasing\",\n \"armv\",\n \"astrojs\",\n \"Bezier\",\n \"Bézier\",\n \"cbindgen\",\n \"cdylib\",\n \"cmake\",\n \"colspan\",\n \"combobox\",\n \"cupertino\",\n \"datastructures\",\n \"dealloc\",\n \"distros\",\n \"Femto\",\n \"femtovg\",\n \"flexboxlayout\",\n \"flickable\",\n \"focusable\",\n \"frameless\",\n \"fullscreen\",\n \"gles\",\n \"Goffart\",\n \"gradians\",\n \"grayscale\",\n \"gridlayout\",\n \"groupbox\",\n \"Hausmann\",\n \"Helvetica\",\n \"imagefilter\",\n \"inout\",\n \"knip\",\n \"layouting\",\n \"linebreak\",\n \"lineedit\",\n \"listview\",\n \"LINUXFB\",\n \"lvalue\",\n \"microcontroller\",\n \"microcontrollers\",\n \"muda\",\n \"MSVC\",\n \"napi\",\n \"Oooops\",\n \"ogoffart\",\n \"opengl\",\n \"opengles\",\n \"pixmap\",\n \"prestart\",\n \"printerdemo\",\n \"pythonw\",\n \"riscv\",\n \"rowspan\",\n \"rustc\",\n \"rustdoc\",\n \"rustdocs\",\n \"rustflags\",\n \"rvalue\",\n \"SANDBOXING\",\n \"scrollview\",\n \"SDK\",\n \"seti\",\n \"sixtyfps\",\n \"skia\",\n \"slint\",\n \"slintdoc\",\n \"slintdocs\",\n \"slintpad\",\n \"spdx\",\n \"spinbox\",\n \"streetsidesoftware\",\n \"struct\",\n \"structs\",\n \"tableview\",\n \"tabwidget\",\n \"testcase\",\n \"textedit\",\n \"tmpobj\",\n \"toolchain\",\n \"toolkit\",\n \"touchpad\",\n \"trackpad\",\n \"trackpads\",\n \"tronical\",\n \"typeloader\",\n \"uefi\",\n \"uncompiled\",\n \"unerase\",\n \"unmapping\",\n \"untracked\",\n \"viewbox\",\n \"vtable\",\n \"vulkan\",\n \"wasm\",\n \"webassembly\",\n \"windowrc\",\n \"winit\",\n \"xtask\",\n \"xtensa\",\n \"Toradex\",\n \"Vivante\",\n \"espflash\",\n \"pico\",\n \"wgpu\",\n \"WGPU\",\n \"Xcodegen\",\n \"Xcodeproj\",\n ],\n \"ignorePaths\": [\n \"api/cpp/docs/conf.py\",\n \"Cargo.toml\",\n \"CHANGELOG.md\",\n \"cspell.json\",\n \"LICENSES\",\n \"examples/*/lang/**\",\n \".github/workflows/*.yaml\",\n \"**/package.json\"\n ],\n \"ignoreRegExpList\": [\n // Color encodings in all languages:\n \"/(\\\\b|0x|#|_)?[argbARGB][argbARGB][argbARGB]+(\\\\b|_|Color)/\"\n ],\n \"overrides\": [\n {\n \"filename\": \"**/*.rst\",\n \"languageId\": \"restructuredtext\"\n }\n ]\n}\n" }, { "path": "demos/CMakeLists.txt", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: MIT\ncmake_minimum_required(VERSION 3.21)\nproject(SlintDemos LANGUAGES CXX)\n\nlist(PREPEND CMAKE_MODULE_PATH \"${CMAKE_CURRENT_SOURCE_DIR}/../cmake\")\n\nif (NOT TARGET Slint::Slint)\n find_package(Slint REQUIRED)\n include(FetchContent)\nendif()\n\nif (TARGET Slint::slint-compiler)\n add_subdirectory(printerdemo/cpp/)\nendif()\nif (SLINT_FEATURE_INTERPRETER)\n add_subdirectory(printerdemo/cpp_interpreted/)\nendif()\n\n" }, { "path": "demos/README.md", "content": "\n# Demos\n\nThese demos showcase different complex use-cases for building UIs with Slint.\n\n\n\n| Thumbnail | Description | Demo |\n| --- | --- | --- |\n| [Printer UI ![Printer Demo image](https://github.com/user-attachments/assets/34627f84-affd-46a6-9c52-1f623d33a507)](./printerdemo) | A fictional user interface for the touch screen of a printer.
[Project...](./printerdemo) | [Wasm Demo](https://slint.dev/snapshots/master/demos/printerdemo/) |\n| [Energy Meter![Energy meter demo image](https://github.com/user-attachments/assets/abfe03e3-ded6-4ddc-82b7-8303ee45515c \"Energy meter demo image\")](./energy-monitor/) | A fictional user interface of a device that monitors energy consumption in a building.
[Project...](./energy-monitor) | [Wasm Demo](https://slint.dev/snapshots/master/demos/energy-monitor/) |\n| [Home Automation![Home Automation demo image](https://github.com/user-attachments/assets/607e07a5-2e79-4045-9fe4-3da2493ba187 \"Home Automation demo image\")](./home-automation/) | A fictional user interface of a device that automates the control of a home.
[Project...](./home-automation) | [Wasm Demo](https://slint.dev/snapshots/master/demos/home-automation/) |\n| [Weather![Weather demo image](./weather-demo/docs/img/desktop-preview.png \"7 GUI's demo image\")](./weather-demo/) | A simple, cross-platform (Desktop, Android, Wasm) weather application using real weather data from the [OpenWeather](https://openweathermap.org/) API.
[Project...](./weather-demo/) | [Wasm Demo](https://slint.dev/snapshots/master/demos/weather-demo/) |\n| [Usecases ![Usecases Demo image](https://github.com/user-attachments/assets/72dd3e98-36b8-41b6-9d6e-6eb6053ace43)](./usecases) | Different example use cases in one app.
[Project...](./usecases) | [Wasm Demo](https://slint.dev/snapshots/master/demos/usecases/) |\n\n---\n### Running the Rust Demos\n\nYou can run the examples either by going into folder or into the rust sub-folder and use `cargo run`, for example:\n\n```sh\ncd demos/printerdemo/rust\ncargo run --release\n```\n\nor you can run them from anywhere in the Cargo workspace by name:\n\n```sh\ncargo run --release --bin printerdemo\n```\n\n---\n### Wasm builds\n\nIn order to make the wasm build of the example, you first need to edit the Cargo.toml\nfiles to uncomment the line starting with `#wasm#` (or use the `sed` line bellow)\nYou can then use wasm-pack (which you may need to obtain with `cargo install wasm-pack`).\nThis will generate the wasm in the `./pkg` directory, which the `index.html` file will open.\nSince wasm files cannot be served from `file://` URL, you need to open a wab server to serve\nthe content\n\n```sh\ncd demos/printerdemo/rust\nsed -i \"s/^#wasm# //\" Cargo.toml\nwasm-pack build --release --target web\npython3 -m http.server\n```\n\n---\n### Running the C++ Examples\n\n* **When compiling Slint from sources:** If you follow the [C++ build instructions](/docs/building.md#c-build), this will build the C++\nexamples as well by default\n* **From [installed binary packages](/api/cpp/README.md#binary-packages):** Simply run cmake in one of the example directory containing a CMakeLists.txt\n\n ```sh\n mkdir build && cd build\n cmake -GNinja -DCMAKE_PREFIX_PATH=\"\" ..\n cmake --build .\n ```\n\n---\n### Running the Node Examples\n\nYou can run the examples by going into the node sub-folder and use [`pnpm`](https://pnpm.io), for example:\n\n```sh\ncd demos/printerdemo/node\npnpm install\npnpm start\n```\n" }, { "path": "demos/energy-monitor/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: MIT\n\n[package]\nname = \"energy-monitor\"\nversion = \"1.16.0\"\nauthors = [\"Slint Developers \"]\nedition.workspace = true\nbuild = \"build.rs\"\npublish = false\nlicense = \"MIT\"\n\n[lib]\ncrate-type = [\"cdylib\", \"lib\"]\n\n[dependencies]\nslint = { path = \"../../api/rs/slint\", default-features = false, features = [\"compat-1-2\"] }\nmcu-board-support = { path = \"../../examples/mcu-board-support\", optional = true }\nchrono = { version = \"0.4.34\", optional = true, default-features = false, features = [\"clock\", \"std\", \"wasmbind\"] }\nweer_api = { version = \"0.1\", optional = true }\ntokio = { version = \"1.25\", optional = true, features = [\"full\"] }\nfutures = { version = \"0.3.26\", optional = true }\n\n[target.'cfg(target_arch = \"wasm32\")'.dependencies]\nwasm-bindgen = { version = \"0.2\" }\nweb-sys = { version = \"0.3\", features = [\"console\"] }\nconsole_error_panic_hook = \"0.1.5\"\n\n[build-dependencies]\nslint-build = { path = \"../../api/rs/build\" }\n\n[features]\ndefault = [\"slint/default\", \"network\", \"chrono\", \"slint/backend-android-activity-06\"]\nsimulator = [\"mcu-board-support\", \"slint/renderer-software\", \"slint/backend-winit\", \"slint/std\"]\nnetwork = [\"dep:weer_api\", \"tokio\", \"futures\"]\n" }, { "path": "demos/energy-monitor/README.md", "content": "# Energy Monitor Demo\n\n![Energy Monitor Demo Screenshot](https://slint.dev/resources/energy-monitor-screenshot.png \"Energy Monitor\")\n\nThis is a demonstration of the Slint toolkit. This demo can be executed on various platforms.\n\n## Displaying Real-Time Weather Data\n\nTo showcase real-time weather data, you will need an application key from https://www.weatherapi.com/. You can inject the API key by setting the `WEATHER_API` environment variable. The geographical location for the weather data can be set using the `WEATHER_LAT` and `WEATHER_LONG` variables. By default, the location is set to Berlin.\n\n## Platform Compatibility\n\n### Desktop (Windows/Mac/Linux) or Embedded Linux\n\nYou can run the demo on a desktop or embedded Linux environment with the following command:\n```sh\ncargo run -p energy-monitor\n```\n\n### Microcontrollers (MCU)\n\nRefer to the [MCU backend Readme](../../examples/mcu-board-support) for instructions on how to run the demo on smaller devices like the Raspberry Pi Pico.\n\nTo run the MCU-like code on desktop, use the `--features=simulator`\n\n```sh\ncargo run -p energy-monitor --no-default-features --features=simulator --release\n```\n\n### Android\n\nFirst, [set up your Android environment](https://slint.dev/snapshots/master/docs/rust/slint/android/#building-and-deploying).\nThen, you can run the demo on an Android device with the following command:\n\n```sh\ncargo apk run -p energy-monitor --target aarch64-linux-android --lib\n```\n\n### Web\n\n```sh\ncargo install wasm-pack\ncd demos/energy-monitor/\nwasm-pack build --release --target web --no-default-features --features slint/default,chrono\npython3 -m http.server\n```\n\n### Building and running on iOS\n\nThis demo can be cross-compiled to iOS to run on iPhones, iPads, and the respective simulators.\n\n#### Prerequisites\n\n - A computer running macOS.\n - An up-to-date installation of [Xcode](https://developer.apple.com/xcode/).\n - [Xcodegen](https://github.com/yonaskolb/XcodeGen?tab=readme-ov-file#installing)\n - [Rust](https://rustup.rs). Add the target and simulator toolchains using `rustup target add aarch64-apple-ios` and `rustup target add aarch64-apple-ios-sim`\n\n#### Building\n\n1. Run `xcodegen -s ios-project.yml` to generate an XCode project file (`.xcodeproj`).\n2. Open XCode and open the generated `.xcodeproj` in it.\n3. Run, deploy, and debug the demo from within Xcode.\n\n" }, { "path": "demos/energy-monitor/build.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\n#[cfg(not(feature = \"mcu-board-support\"))]\nfn main() {\n slint_build::compile(\"ui/desktop_window.slint\").unwrap();\n}\n\n#[cfg(feature = \"mcu-board-support\")]\nfn main() {\n let config = slint_build::CompilerConfiguration::new()\n .embed_resources(slint_build::EmbedResourcesKind::EmbedForSoftwareRenderer);\n slint_build::compile_with_config(\"ui/mcu_window.slint\", config).unwrap();\n slint_build::print_rustc_flags().unwrap();\n}\n" }, { "path": "demos/energy-monitor/index.html", "content": "\n\n\n\n\n\n\n\n\n \n Slint Energy Monitor Demo (Web Assembly version)\n \n \n\n\n\n

Energy Monitor Demo

\n

This is the Slint Energy Monitor Demo compiled\n to\n WebAssembly.

\n
\n
Loading...
\n
\n \n

\n \n View Source Code on GitHub -\n \n Open in SlintPad\n \n

\n \n\n\n\n" }, { "path": "demos/energy-monitor/ios-project.yml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: MIT\nname: Energy Monitor\noptions:\n bundleIdPrefix: dev.slint.demos\nsettings:\n ENABLE_USER_SCRIPT_SANDBOXING: NO\ntargets:\n Energy Monitor:\n type: application\n platform: iOS\n deploymentTarget: \"12.0\"\n info:\n path: Info.plist\n properties:\n UILaunchScreen:\n - ImageRespectSafeAreaInsets: false\n sources: []\n postCompileScripts:\n - script: |\n ../../scripts/build_for_ios_with_cargo.bash energy-monitor\n outputFileLists:\n $TARGET_BUILD_DIR/$EXECUTABLE_PATH\n" }, { "path": "demos/energy-monitor/src/controllers/header.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nuse crate::ui::*;\nuse chrono::prelude::*;\nuse slint::*;\n\npub fn setup(window: &MainWindow) -> Timer {\n let update_timer = Timer::default();\n update_timer.start(slint::TimerMode::Repeated, std::time::Duration::from_millis(300), {\n let weak_window = window.as_weak();\n\n move || {\n update(&weak_window.unwrap().global::());\n }\n });\n\n update_timer\n}\n\nfn update(header_adapter: &HeaderAdapter) {\n let now = Local::now();\n\n header_adapter.set_date(slint::format!(\"{}\", now.format(\"%A %e %B %Y\")));\n header_adapter.set_time(slint::format!(\"{}\", now.format(\"%I:%M\")));\n header_adapter.set_time_suffix(slint::format!(\"{}\", now.format(\"%p\")));\n}\n" }, { "path": "demos/energy-monitor/src/controllers/weather.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nuse crate::ui::*;\nuse chrono::prelude::*;\nuse core::cmp::Ordering;\nuse futures::future;\nuse slint::*;\nuse std::rc::Rc;\nuse weer_api::*;\n\nuse std::thread;\n\nconst WEATHER_API_KEY: &str = \"WEATHER_API\";\nconst WEATHER_LAT_KEY: &str = \"WEATHER_LAT\";\nconst WEATHER_LONG_KEY: &str = \"WEATHER_LONG\";\nconst LAT_BERLIN: f32 = 52.520008;\nconst LONG_BERLIN: f32 = 13.404954;\nconst FORECAST_DAYS: i64 = 3;\n\npub fn setup(window: &MainWindow) -> thread::JoinHandle<()> {\n let window_weak = window.as_weak();\n\n thread::spawn(move || {\n tokio::runtime::Runtime::new().unwrap().block_on(weather_worker_loop(window_weak))\n })\n}\n\nasync fn weather_worker_loop(window_weak: Weak) {\n let api_key = api_key();\n if api_key.is_empty() {\n return;\n }\n\n let lat = lat();\n let long = long();\n\n let now = Local::now();\n\n let mut forecast_days = Vec::new();\n\n let client = Client::new(&api_key, true);\n let mut forecast_list = future::join_all((0..FORECAST_DAYS).map(|i| {\n let client = client.clone();\n async move {\n current_forecast(\n client.clone(),\n lat,\n long,\n now + chrono::TimeDelta::try_days(i).unwrap_or_default(),\n )\n .await\n }\n }))\n .await;\n\n for i in 0..forecast_list.len() {\n if let Some((date, forecast)) = forecast_list.remove(0) {\n if i == 1 {\n display_current(\n window_weak.clone(),\n forecast.current,\n SharedString::from(now.format(\"%e %B %Y\").to_string()),\n );\n }\n\n {\n let forecast = forecast.forecast;\n let mut day = forecast.forecast_day;\n\n // the api provides only one day in the forecast therefore an iteration is necessary to get all.\n if !day.is_empty() {\n forecast_days.push((day.remove(0), date.format(\"%A\").to_string()));\n }\n }\n }\n }\n\n if !forecast_days.is_empty() {\n display_forecast(window_weak.clone(), forecast_days);\n }\n}\n\nasync fn current_forecast(\n client: Client,\n lat: f32,\n long: f32,\n date: DateTime,\n) -> Option<(DateTime, Forecast)> {\n if let Ok(forecast) = client.forecast().query(Query::Coords(lat, long)).dt(date).call() {\n return Some((date, forecast));\n }\n\n None\n}\n\nfn display_current(window_weak: Weak, current: Current, current_date: SharedString) {\n window_weak\n .upgrade_in_event_loop(move |window| {\n window\n .global::()\n .set_current_temperature(SharedString::from(current.temp_c.to_string()));\n window.global::().set_current_day(current_date);\n window.global::().set_current_weather_description(SharedString::from(\n current.condition.text.to_string(),\n ));\n window\n .global::()\n .set_current_temperature_icon(get_icon(&window, ¤t.condition));\n })\n .unwrap();\n}\n\nfn display_forecast(window_weak: Weak, forecast: Vec<(ForecastDay, String)>) {\n window_weak\n .upgrade_in_event_loop(move |window| {\n let forecast_model = VecModel::default();\n\n let max_temp = forecast\n .iter()\n .max_by(|lhs, rhs| {\n if lhs.0.day.temp_c().max() > rhs.0.day.temp_c().max() {\n Ordering::Greater\n } else {\n Ordering::Less\n }\n })\n .map(|d| d.0.day.temp_c().max())\n .unwrap_or_default();\n\n let min_temp = forecast\n .iter()\n .min_by(|lhs, rhs| {\n if lhs.0.day.temp_c().min() > rhs.0.day.temp_c().min() {\n Ordering::Greater\n } else {\n Ordering::Less\n }\n })\n .map(|d| d.0.day.temp_c().min())\n .unwrap_or_default();\n\n for (forecast_day, day) in forecast {\n let model = BarTileModel {\n title: SharedString::from(&day.as_str()[0..3]),\n max: forecast_day.day.temp_c().max().round() as i32,\n min: forecast_day.day.temp_c().min().round() as i32,\n absolute_max: max_temp.round() as i32,\n absolute_min: min_temp.round() as i32,\n unit: SharedString::from(\"°\"),\n icon: get_icon(&window, &forecast_day.day.condition),\n };\n\n forecast_model.push(model);\n }\n\n window.global::().set_week_model(Rc::new(forecast_model).into());\n })\n .unwrap();\n}\n\nfn get_icon(window: &MainWindow, condition: &Condition) -> Image {\n // code mapping can be found at https://www.weatherapi.com/docs/conditions.json\n match condition.code {\n 1003 => window.global::().get_cloudy(),\n 1006 => window.global::().get_cloud(),\n _ => window.global::().get_sunny(),\n }\n}\n\nfn api_key() -> String {\n if let Some(lat) = option_env!(\"WEATHER_API\") {\n return lat.to_string();\n }\n\n #[cfg(not(feature = \"mcu-board-support\"))]\n if let Some(lat) = std::env::var_os(WEATHER_API_KEY)\n && let Some(lat) = lat.to_str()\n {\n return lat.to_string();\n }\n\n String::default()\n}\n\nfn lat() -> f32 {\n if let Some(lat) = option_env!(\"WEATHER_LAT\") {\n return lat.parse().unwrap_or_default();\n }\n\n #[cfg(not(feature = \"mcu-board-support\"))]\n if let Some(lat) = std::env::var_os(WEATHER_LAT_KEY)\n && let Some(lat) = lat.to_str()\n {\n return lat.parse().unwrap_or_default();\n }\n\n LAT_BERLIN\n}\n\nfn long() -> f32 {\n if let Some(lat) = option_env!(\"WEATHER_LONG\") {\n return lat.parse().unwrap_or_default();\n }\n\n #[cfg(not(feature = \"mcu-board-support\"))]\n if let Some(lat) = std::env::var_os(WEATHER_LONG_KEY)\n && let Some(lat) = lat.to_str()\n {\n return lat.parse().unwrap_or_default();\n }\n\n LONG_BERLIN\n}\n" }, { "path": "demos/energy-monitor/src/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\n#![cfg_attr(feature = \"mcu-board-support\", no_std)]\n\n#[cfg(feature = \"mcu-board-support\")]\nextern crate alloc;\n\n#[cfg(target_arch = \"wasm32\")]\nuse wasm_bindgen::prelude::*;\n\npub mod ui {\n slint::include_modules!();\n}\n\nuse slint::*;\nuse ui::*;\n\n#[cfg(not(feature = \"mcu-board-support\"))]\nmod controllers {\n #[cfg(feature = \"chrono\")]\n pub mod header;\n #[cfg(feature = \"network\")]\n pub mod weather;\n}\n#[cfg(not(feature = \"mcu-board-support\"))]\nuse controllers::*;\n\n#[cfg_attr(target_arch = \"wasm32\", wasm_bindgen(start))]\npub fn main() {\n // This provides better error messages in debug mode.\n // It's disabled in release mode so it doesn't bloat up the file size.\n #[cfg(all(debug_assertions, target_arch = \"wasm32\"))]\n console_error_panic_hook::set_once();\n\n let window = MainWindow::new().unwrap();\n\n // let _ to keep the timer alive.\n #[cfg(all(not(feature = \"mcu-board-support\"), feature = \"chrono\"))]\n let _timer = header::setup(&window);\n\n #[cfg(all(not(feature = \"mcu-board-support\"), feature = \"network\"))]\n let weather_join = weather::setup(&window);\n\n let _kiosk_mode_timer = kiosk_timer(&window);\n\n window.run().unwrap();\n\n #[cfg(all(not(feature = \"mcu-board-support\"), feature = \"network\"))]\n weather_join.join().unwrap();\n}\n\nfn kiosk_timer(window: &MainWindow) -> Timer {\n let kiosk_mode_timer = Timer::default();\n kiosk_mode_timer.start(TimerMode::Repeated, core::time::Duration::from_secs(4), {\n let window_weak = window.as_weak();\n move || {\n if !SettingsAdapter::get(&window_weak.unwrap()).get_kiosk_mode_checked() {\n return;\n }\n\n let current_page = MenuOverviewAdapter::get(&window_weak.unwrap()).get_current_page();\n let count = MenuOverviewAdapter::get(&window_weak.unwrap()).get_count();\n\n if current_page >= count - 1 {\n MenuOverviewAdapter::get(&window_weak.unwrap()).set_current_page(0);\n } else {\n MenuOverviewAdapter::get(&window_weak.unwrap()).set_current_page(current_page + 1);\n }\n }\n });\n\n kiosk_mode_timer\n}\n\n#[cfg(target_os = \"android\")]\n#[unsafe(no_mangle)]\nfn android_main(app: slint::android::AndroidApp) {\n slint::android::init(app).unwrap();\n main();\n}\n" }, { "path": "demos/energy-monitor/src/main.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n#![no_std]\n#![cfg_attr(all(feature = \"mcu-board-support\", not(feature = \"simulator\")), no_main)]\n\n#[cfg(feature = \"mcu-board-support\")]\n#[allow(unused_imports)]\nuse mcu_board_support::prelude::*;\n\n#[cfg(not(feature = \"mcu-board-support\"))]\npub fn main() {\n energy_monitor::main();\n}\n\n#[cfg(feature = \"mcu-board-support\")]\n#[mcu_board_support::entry]\nfn main() -> ! {\n mcu_board_support::init();\n energy_monitor::main();\n panic!(\"The MCU demo should not quit\")\n}\n" }, { "path": "demos/energy-monitor/ui/big_main.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\n\nimport { TabWidget, TabItem, BarTileModel } from \"widgets/widgets.slint\";\nimport { Dashboard, WeatherAdapter } from \"pages/pages.slint\";\nimport { Header, HeaderAdapter } from \"blocks/blocks.slint\";\n\nexport component BigMain{\n VerticalLayout {\n Header {}\n\n i-tab-widget := TabWidget {\n tabs: [\n { text: \"Dashboard\" },\n { text: \"Energy Flow\" },\n { text: \"Weather\" },\n { text: \"Statistics\" },\n { text: \"Settings\" }\n ];\n\n Dashboard {\n index: 0;\n current-index: i-tab-widget.selected-tab;\n }\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/blocks/blocks.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Header, HeaderAdapter } from \"header.slint\";\n\nexport { Header, HeaderAdapter }\n\nimport { MobileHeader } from \"mobile_header.slint\";\nexport { MobileHeader }" }, { "path": "demos/energy-monitor/ui/blocks/header.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { Images } from \"../images.slint\";\n\nexport global HeaderAdapter {\n in property date: \"Sunday 8th, January 2023\";\n in property time: \"5:20\";\n in property time-suffix: \"PM\";\n in property logo: Images.slint-logo;\n}\n\nexport component Header {\n in property date <=> HeaderAdapter.date;\n in property time <=> HeaderAdapter.time;\n in property time-suffix <=> HeaderAdapter.time-suffix;\n in property logo <=> HeaderAdapter.logo;\n\n min-height: 50px;\n vertical-stretch: 0;\n\n HorizontalLayout {\n padding: 20px;\n spacing: 5px;\n\n Rectangle {\n horizontal-stretch: 1;\n\n Text {\n x: 0px;\n color: Theme.palette.white;\n text: date;\n font-size: Theme.typo.header-item.size;\n font-weight: Theme.typo.header-item.weight;\n }\n }\n\n Rectangle {\n horizontal-stretch: 1;\n\n Image {\n height: 30px;\n source: logo;\n }\n }\n\n Rectangle {\n horizontal-stretch: 1;\n\n Text {\n x: i-time-suffix.x - 5px - self.width;\n horizontal-alignment: right;\n color: Theme.palette.white;\n text: time;\n font-size: Theme.typo.header-item.size;\n font-weight: Theme.typo.header-item.weight;\n }\n\n i-time-suffix := Text {\n x: parent.width - self.width;\n horizontal-stretch: 0;\n color: Theme.palette.shark-gray;\n text: time-suffix;\n font-size: Theme.typo.header-item.size;\n font-weight: Theme.typo.header-item.weight;\n }\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/blocks/kiosk_overlay.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { SettingsAdapter } from \"../pages/menu_page/settings.slint\";\nimport { Theme } from \"../theme.slint\";\n\nexport component KioskOverlay {\n preferred-width: 100%;\n preferred-height: 100%;\n\n TouchArea {\n clicked => {\n SettingsAdapter.kiosk-mode-checked = false;\n }\n }\n\n Rectangle {\n x: i-text.x - 1px;\n y: i-text.y - 1px;\n width: i-text.width + 2px;\n height: i-text.height + 2px;\n background: Theme.palette.pure-black;\n opacity: 0.5;\n }\n\n i-text := Text {\n x: parent.width - self.width - 5px;\n y: 5px;\n font-size: Theme.typo.description.size;\n font-weight: Theme.typo.description.weight;\n text: \"Kiosk\";\n color: Theme.palette.lemon-green;\n opacity: 0.5;\n }\n}\n" }, { "path": "demos/energy-monitor/ui/blocks/mobile_header.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component MobileHeader {\n min-height: 30px;\n vertical-stretch: 0;\n\n Rectangle {\n background: Theme.palette.pure-black;\n\n HorizontalLayout {\n padding-left: 8px;\n padding-right: 8px;\n\n @children\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/components/menu_background.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component MenuBackground inherits Rectangle {\n border-radius: 4px;\n background: Theme.palette.ebony-radial-gradient;\n clip: true;\n}" }, { "path": "demos/energy-monitor/ui/components/state_layer.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component StateLayer inherits TouchArea {\n in property border-radius <=> i-container.border-radius;\n\n width: 100%;\n height: 100%;\n\n states [\n pressed when root.pressed : {\n i-container.opacity: 0.12;\n }\n ]\n\n i-container := Rectangle {\n width: 100%;\n height: 100%;\n background: Theme.palette.pure-black;\n opacity: 0.0;\n\n animate background { duration: Theme.durations.medium; }\n }\n}" }, { "path": "demos/energy-monitor/ui/desktop_window.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme, ScreenSize } from \"theme.slint\";\nimport { SmallMain } from \"small_main.slint\";\nimport { BigMain } from \"big_main.slint\";\nimport { MidMain } from \"mid_main.slint\";\nimport { MidMain } from \"mid_main.slint\";\nimport { MobileMain } from \"mobile_main.slint\";\nimport { BarTileModel } from \"widgets/widgets.slint\";\nimport { Images } from \"images.slint\";\nimport { Theme } from \"theme.slint\";\nimport { HeaderAdapter } from \"blocks/blocks.slint\";\nimport { Navigation, MenuButton, Menu, Value } from \"widgets/widgets.slint\";\nimport {\n BalanceAdapter,\n OverviewAdapter,\n UsageAdapter,\n WeatherAdapter,\n MenuPageAdapter,\n MenuOverviewAdapter,\n SettingsAdapter,\n} from \"pages/pages.slint\";\nimport { KioskOverlay } from \"blocks/kiosk_overlay.slint\";\n\nexport { OverviewAdapter, UsageAdapter, Value, WeatherAdapter, MenuPageAdapter, MenuOverviewAdapter, SettingsAdapter,\n BarTileModel, Images, HeaderAdapter }\n\nexport component MainWindow inherits Window {\n private property big-break-point: 1366px;\n private property mid-break-point: 799px;\n private property mobile-break-point: 444px;\n private property screen-size: root.get-screen-size();\n\n title: \"EnergyMNG Demo\";\n min-width: 320px;\n min-height: 240px;\n background: Theme.palette.pure-black;\n preferred-width: 800px;\n preferred-height: 480px;\n\n /* The design is not finished yet\n if root.screen-size == ScreenSize.Desktop : BigMain {\n preferred-width: 100%;\n preferred-height: 100%;\n }\n */\n\n if root.screen-size == ScreenSize.Mobile: HorizontalLayout {\n padding-left: root.safe-area-insets.left;\n padding-top: root.safe-area-insets.top;\n padding-right: root.safe-area-insets.right;\n padding-bottom: root.safe-area-insets.bottom;\n MobileMain {\n preferred-width: 100%;\n preferred-height: 100%;\n }\n }\n\n if root.screen-size == ScreenSize.EmbeddedMedium: MidMain {\n preferred-width: 100%;\n preferred-height: 100%;\n }\n\n if root.screen-size == ScreenSize.EmbeddedSmall: SmallMain {\n preferred-width: 100%;\n preferred-height: 100%;\n }\n\n if SettingsAdapter.kiosk-mode-checked: KioskOverlay { }\n\n pure function get-screen-size() -> ScreenSize {\n if (root.width <= root.mobile-break-point && root.width < root.height) {\n return ScreenSize.Mobile;\n }\n if (root.width < root.mid-break-point) {\n return ScreenSize.EmbeddedSmall;\n }\n return ScreenSize.EmbeddedMedium;\n }\n}\n" }, { "path": "demos/energy-monitor/ui/images.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nexport global Images {\n in property arrow-left: @image-url(\"assets/arrow-left.svg\");\n in property arrow-right: @image-url(\"assets/arrow-right.svg\");\n in property check: @image-url(\"assets/check.svg\");\n in property sunny: @image-url(\"assets/sunny.svg\");\n in property cloud: @image-url(\"assets/cloud.svg\");\n in property cloudy: @image-url(\"assets/cloudy.svg\");\n in property settings: @image-url(\"assets/settings.svg\");\n in property information: @image-url(\"assets/information.svg\");\n in property slint-logo: @image-url(\"../../../logo/slint-logo-simple-dark.svg\");\n in property spyrosoft-logo: @image-url(\"assets/spyrosoft-logo.svg\");\n in property dashboard: @image-url(\"assets/dashboard.svg\");\n}" }, { "path": "demos/energy-monitor/ui/mcu_window.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"theme.slint\";\nimport { SmallMain } from \"small_main.slint\";\nimport { BarTileModel } from \"widgets/widgets.slint\";\nimport { Images } from \"images.slint\";\nimport { Theme } from \"theme.slint\";\nimport { HeaderAdapter } from \"blocks/blocks.slint\";\nimport { Navigation, MenuButton, Menu, Value } from \"widgets/widgets.slint\";\nimport { BalanceAdapter, OverviewAdapter, UsageAdapter, WeatherAdapter, MenuPageAdapter, MenuOverviewAdapter, SettingsAdapter } from \"pages/pages.slint\";\n\nexport { OverviewAdapter, UsageAdapter, Value, WeatherAdapter, MenuPageAdapter, MenuOverviewAdapter, SettingsAdapter,\n BarTileModel, Images, HeaderAdapter }\n\nexport component MainWindow inherits Window {\n title: \"EnergyMNG Demo\";\n min-width: 320px;\n min-height: 240px;\n background: Theme.palette.pure-black;\n\n SmallMain {\n preferred-width: 100%;\n preferred-height: 100%;\n }\n}" }, { "path": "demos/energy-monitor/ui/mid_main.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Header, HeaderAdapter } from \"blocks/blocks.slint\";\nimport { Images } from \"images.slint\";\nimport { Theme } from \"theme.slint\";\nimport { Menu, PageScrollView, PageContainer } from \"widgets/widgets.slint\";\nimport { MenuPage } from \"pages/pages.slint\";\nimport { Balance, Overview, Usage, UsageAdapter, Weather, About } from \"pages/pages.slint\";\n\nexport component MidMain {\n Rectangle {\n background: Theme.palette.background-gradient;\n\n VerticalLayout {\n padding-bottom: 50px;\n\n Header {}\n\n i-page-scroll-view := PageScrollView {\n vertical-stretch: 1;\n page-count: 5;\n\n PageContainer {\n clicked => { i-page-scroll-view.toggle-selection(self.index, self.x); }\n\n index: 0;\n selected <=> i-page-scroll-view.selection;\n selected-width: i-page-scroll-view.selected-width;\n selected-height: i-page-scroll-view.selected-height;\n selected-h-offset: i-page-scroll-view.selected-h-offset;\n\n Overview {}\n }\n\n PageContainer {\n clicked => { i-page-scroll-view.toggle-selection(self.index, self.x); }\n\n index: 1;\n selected <=> i-page-scroll-view.selection;\n selected-width: i-page-scroll-view.selected-width;\n selected-height: i-page-scroll-view.selected-height;\n selected-h-offset: i-page-scroll-view.selected-h-offset;\n\n Usage {}\n }\n\n PageContainer {\n clicked => { i-page-scroll-view.toggle-selection(self.index, self.x); }\n\n index: 2;\n selected <=> i-page-scroll-view.selection;\n selected-width: i-page-scroll-view.selected-width;\n selected-height: i-page-scroll-view.selected-height;\n selected-h-offset: i-page-scroll-view.selected-h-offset;\n\n Balance {}\n }\n\n PageContainer {\n clicked => { i-page-scroll-view.toggle-selection(self.index, self.x); }\n\n index: 3;\n selected <=> i-page-scroll-view.selection;\n selected-width: i-page-scroll-view.selected-width;\n selected-height: i-page-scroll-view.selected-height;\n selected-h-offset: i-page-scroll-view.selected-h-offset;\n\n Weather {}\n }\n\n PageContainer {\n clicked => { i-page-scroll-view.toggle-selection(self.index, self.x); }\n\n index: 4;\n selected <=> i-page-scroll-view.selection;\n selected-width: i-page-scroll-view.selected-width;\n selected-height: i-page-scroll-view.selected-height;\n selected-h-offset: i-page-scroll-view.selected-h-offset;\n\n About {}\n }\n }\n }\n\n i-menu := Menu {\n stays-open: true;\n preferred-width: 100%;\n preferred-height: 100%;\n start-y: 35px;\n end-y: 75px;\n menu-width: root.width / 3;\n menu-height: root.height - 75px;\n\n opened => {\n i-menu-page.current-index = 0;\n }\n\n i-menu-page := MenuPage {\n close => {\n i-menu.hide();\n }\n\n preferred-width: 100%;\n preferred-height: 100%;\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/mobile_main.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"theme.slint\";\nimport { Navigation, MenuButton, MobileMenu, Value, IconButton } from \"widgets/widgets.slint\";\nimport { Balance, Overview, Usage, UsageAdapter, Weather, MenuPage, MenuOverviewAdapter, About } from \"pages/pages.slint\";\nimport { Images } from \"images.slint\";\n\nimport { TabWidget, TabItem } from \"widgets/widgets.slint\";\nimport { DashboardMobile, Weather, About } from \"pages/pages.slint\";\nimport { MobileHeader } from \"blocks/blocks.slint\";\nimport { MenuBackground } from \"components/menu_background.slint\";\n\n\nexport component MobileMain {\n tab-widget := TabWidget {\n y: header.height + 16px;\n width: 100%;\n height: parent.height - header.height - 16px;\n tabs: [\n { text: \"Dashboard\", icon: Images.dashboard },\n { text: \"Weather\", icon: Images.sunny },\n { text: \"About\", icon: Images.information },\n ];\n\n DashboardMobile {\n index: 0;\n current-index: tab-widget.selected-tab;\n }\n\n Weather {\n index: 1;\n current-index: tab-widget.selected-tab;\n }\n\n About {\n index: 2;\n current-index: tab-widget.selected-tab;\n }\n }\n\n menu := MobileMenu {\n end-y: settings-button.y + settings-button.height;\n menu-x: settings-button.x + settings-button.width - self.menu-width;\n width: 100%;\n height: 100%;\n\n MenuPage {\n width: 100%;\n height: 100%;\n }\n }\n\n header := MobileHeader {\n width: 100%;\n y: 0px;\n\n HorizontalLayout {\n alignment: start;\n }\n\n HorizontalLayout {\n alignment: center;\n\n Image {\n horizontal-stretch: 1;\n y: (parent.height - self.height) / 2;\n height: 24px;\n source: Images.slint-logo;\n }\n }\n\n settings-button := IconButton {\n y: (parent.height - self.height) / 2;\n icon: Images.settings;\n\n clicked => {\n if (!menu.open) {\n menu.open-menu();\n return;\n }\n menu.hide();\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/pages/about.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { Images } from \"../images.slint\";\nimport { Page } from \"page.slint\";\nimport { IconButton } from \"../widgets/widgets.slint\";\nimport { GroupBox } from \"../widgets/group_box.slint\";\n\nexport component About inherits Page {\n GroupBox {\n VerticalLayout {\n vertical-stretch: 1;\n spacing: Theme.spaces.medium;\n alignment: start;\n\n Text {\n vertical-stretch: 0;\n horizontal-alignment: center;\n text: \"Developed by\";\n color: Theme.palette.slint-blue-100;\n font-size: Theme.typo.header-item.size;\n font-weight: Theme.typo.header-item.weight;\n }\n\n Image {\n preferred-height: 55px;\n source: Images.slint-logo;\n }\n\n // spacer\n Rectangle {\n vertical-stretch: 1;\n }\n\n Text {\n vertical-stretch: 0;\n horizontal-alignment: center;\n text: \"Designed by\";\n color: Theme.palette.slint-blue-100;\n font-size: Theme.typo.header-item.size;\n font-weight: Theme.typo.header-item.weight;\n }\n\n Image {\n preferred-height: 42px;\n source: Images.spyrosoft-logo;\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/pages/balance.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Page } from \"page.slint\";\nimport { GroupBox, BalanceChart } from \"../widgets/widgets.slint\";\n\nexport global BalanceAdapter {\n in property title: \"Balance\";\n in property <[string]> x-axis-model: [\n \"12:00\",\n \"\",\n \"\",\n \"16:00\",\n \"\",\n \"\",\n \"20:00\"\n ];\n in property <[int]> y-axis-model: [\n 1.0,\n 0,\n -2,\n -4,\n -6\n ];\n in property <[float]> model: [ 0.2, 0.5, -1.7, -2.0, -4.0, -5.0, -5.5, -6.0, -6.2, -6.4, -4.5, -3.0, 0.25, 0.5 ];\n in property min: -7.8;\n in property max: 2;\n in property y-unit: \"K\";\n}\n\nexport component Balance inherits Page {\n in property <[string]> x-axis-model <=> BalanceAdapter.x-axis-model;\n in property <[int]> y-axis-model <=> BalanceAdapter.y-axis-model;\n in property <[float]> model <=> BalanceAdapter.model;\n in property min <=> BalanceAdapter.min;\n in property max <=> BalanceAdapter.max;\n in property y-unit <=> BalanceAdapter.y-unit;\n in property title <=> BalanceAdapter.title;\n\n GroupBox {\n title: root.title;\n\n BalanceChart {\n x-axis-model: root.x-axis-model;\n y-axis-model: root.y-axis-model;\n model: root.model;\n min: root.min;\n max: root.max;\n y-unit: root.y-unit;\n active: root.active;\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/pages/dashboard.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Page } from \"page.slint\";\nimport { OverviewAdapter } from \"overview.slint\";\nimport { UsageAdapter } from \"usage.slint\";\nimport { WeatherAdapter } from \"weather.slint\";\nimport { BalanceAdapter } from \"balance.slint\";\nimport { GroupBox, Value, ValueDisplay, BarChart, BarTileModel, Tile, BarTiles, BalanceChart } from \"../widgets/widgets.slint\";\n\nexport component ValueTile {\n in property title <=> i-group-box.title;\n in property <[Value]> model <=> i-value-display.model;\n in property alternative-colors <=> i-value-display.alternative-colors;\n in property active;\n\n i-group-box := GroupBox {\n preferred-width: 100%;\n preferred-height: 100%;\n\n i-value-display := ValueDisplay {\n active: root.active;\n }\n }\n}\n\nexport component BarChartTile {\n in property title <=> i-group-box.title;\n in property <[Value]> value-model <=> i-value-display.model;\n in property <[float]> model <=> i-bar-chart.model;\n in property min <=> i-bar-chart.min;\n in property max <=> i-bar-chart.max;\n in property active;\n\n height: i-group-box.min-height;\n\n i-group-box := GroupBox {\n preferred-width: 100%;\n min-height: 124px;\n\n i-value-display := ValueDisplay {\n width: 100%;\n alternative-colors: true;\n active: root.active;\n vertical: true;\n }\n\n i-bar-chart := BarChart {\n horizontal-stretch: 1;\n }\n }\n}\n\nexport component WeatherTile {\n in property title <=> i-group-box.title;\n in property current-temperature-icon <=> i-tile.icon;\n in property current-temperature <=> i-tile.value;\n in property current-day <=> i-tile.text;\n in property current-weather-description <=> i-tile.sub-text;\n in property <[BarTileModel]> week-model <=> i-bar-tiles.model;\n\n i-group-box := GroupBox {\n spacing: 1px;\n i-tile := Tile {}\n i-bar-tiles := BarTiles {}\n }\n}\n\nexport component BalanceTile {\n in property <[string]> x-axis-model;\n in property <[int]> y-axis-model;\n in property <[float]> model;\n in property min;\n in property max;\n in property y-unit;\n in property title;\n\n GroupBox {\n title: root.title;\n\n BalanceChart {\n\n x-axis-model: root.x-axis-model;\n y-axis-model: root.y-axis-model;\n model: root.model;\n min: root.min;\n max: root.max;\n y-unit: root.y-unit;\n }\n }\n}\n\nexport component Dashboard inherits Page {\n GridLayout {\n padding-left: 20px;\n padding-right: 20px;\n padding-top: 20px;\n padding-bottom: 60px;\n spacing: 20px;\n\n Row {\n ValueTile {\n title: OverviewAdapter.production-title;\n model: OverviewAdapter.production-model;\n active: root.active;\n }\n\n ValueTile {\n title: OverviewAdapter.self-consumption-title;\n model: OverviewAdapter.self-consumption-model;\n alternative-colors: true;\n active: root.active;\n }\n }\n\n Row {\n BalanceTile {\n x-axis-model <=> BalanceAdapter.x-axis-model;\n y-axis-model <=> BalanceAdapter.y-axis-model;\n model <=> BalanceAdapter.model;\n min <=> BalanceAdapter.min;\n max <=> BalanceAdapter.max;\n y-unit <=> BalanceAdapter.y-unit;\n title <=> BalanceAdapter.title;\n }\n\n WeatherTile {\n title <=> WeatherAdapter.title;\n current-temperature-icon <=> WeatherAdapter.current-temperature-icon;\n current-temperature <=> WeatherAdapter.current-temperature;\n current-day <=> WeatherAdapter.current-day;\n current-weather-description <=> WeatherAdapter.current-weather-description;\n week-model <=> WeatherAdapter.week-model;\n }\n }\n\n Row {\n BarChartTile {\n colspan: 2;\n title: UsageAdapter.title;\n model: UsageAdapter.model;\n min: UsageAdapter.min;\n max: UsageAdapter.max;\n value-model: UsageAdapter.overview-model;\n active: root.active;\n }\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/pages/dashboard_mobile.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Page } from \"page.slint\";\nimport { Usage } from \"usage.slint\";\nimport { OverviewAdapter } from \"overview.slint\";\nimport { BalanceAdapter } from \"balance.slint\";\nimport { UsageAdapter } from \"usage.slint\";\nimport { UsageAdapter } from \"usage.slint\";\nimport { ScrollView, GroupBox, BalanceChart, BarChart, ValueDisplay} from \"../widgets/widgets.slint\";\nimport { ValueTile, BalanceTile, BarChartTile } from \"dashboard.slint\";\n\nexport component DashboardMobile inherits Page {\n ScrollView {\n VerticalLayout {\n alignment: start;\n spacing: 16px;\n\n ValueTile {\n title: OverviewAdapter.production-title;\n model: OverviewAdapter.production-model;\n active: root.active;\n }\n\n ValueTile {\n title: OverviewAdapter.self-consumption-title;\n model: OverviewAdapter.self-consumption-model;\n alternative-colors: true;\n active: root.active;\n }\n\n GroupBox {\n title: UsageAdapter.title;\n\n VerticalLayout {\n ValueDisplay {\n model: UsageAdapter.overview-model;\n transparent-background: true;\n alternative-colors: true;\n active: root.active;\n }\n\n BarChart {\n model: UsageAdapter.model;\n min: UsageAdapter.min;\n max: UsageAdapter.max;\n active: root.active;\n }\n }\n }\n\n GroupBox {\n title: BalanceAdapter.title;\n\n BalanceChart {\n x-axis-model: BalanceAdapter.x-axis-model;\n y-axis-model: BalanceAdapter.y-axis-model;\n model: BalanceAdapter.model;\n min: BalanceAdapter.min;\n max: BalanceAdapter.max;\n y-unit: BalanceAdapter.y-unit;\n active: root.active;\n min-height: 200px;\n }\n }\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/pages/menu_page/menu_overview.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../../theme.slint\";\nimport { Images } from \"../../images.slint\";\nimport { Page } from \"../page.slint\";\nimport { IconButton, ListView } from \"../../widgets/widgets.slint\";\n\nexport global MenuOverviewAdapter {\n in property <[StandardListViewItem]> model: [\n { text: \"Production & Self-consumption\"},\n { text: \"Usage\"},\n { text: \"Balance\"},\n { text: \"Weather\"},\n { text: \"About\"},\n ];\n in-out property current-page;\n out property count: model.length;\n}\n" }, { "path": "demos/energy-monitor/ui/pages/menu_page/menu_page.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { MenuOverviewAdapter } from \"menu_overview.slint\";\nimport { Settings, SettingsAdapter } from \"settings.slint\";\nimport { Theme } from \"../../theme.slint\";\n\nexport { MenuOverviewAdapter, SettingsAdapter }\n\nexport global MenuPageAdapter {\n in property <[StandardListViewItem]> model: [\n { text: \"Production & Self-consumption\"},\n { text: \"Usage\"},\n { text: \"Balance\"},\n { text: \"Weather\"},\n ];\n in-out property selected-index;\n}\n\nexport component MenuPage {\n in-out property current-index;\n\n callback page-changed(/* index */ int);\n callback close;\n\n private property show-settings;\n\n function back() {\n current-index = 0;\n }\n\n Rectangle {\n x: -parent.width * current-index;\n width: 2 * parent.width;\n clip: true;\n\n animate x { duration: Theme.durations.fast; }\n\n if(current-index == 0) : Settings {\n close => {\n root.close();\n }\n\n width: root.width;\n }\n }\n }\n" }, { "path": "demos/energy-monitor/ui/pages/menu_page/settings.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../../theme.slint\";\nimport { Images } from \"../../images.slint\";\nimport { Page } from \"../page.slint\";\nimport { IconButton, CheckBox, RadioButton, Switch, ScrollView, Item, ItemGroupBox } from \"../../widgets/widgets.slint\";\n\nexport global SettingsAdapter {\n // functions\n in-out property function-one-checked: true;\n in-out property kiosk-mode-checked;\n in-out property function-three-checked;\n\n // radio options\n in-out property radio-option-one-checked: true;\n in-out property radio-option-two-checked: false;\n\n // check options\n in-out property check-option-one-checked: true;\n in-out property check-option-two-checked;\n in-out property check-option-three-checked;\n\n callback check-radio-option(int /* index */);\n\n check-radio-option(index) => {\n if(index == 0) {\n radio-option-one-checked = true;\n radio-option-two-checked = false;\n return;\n }\n\n radio-option-one-checked = false;\n radio-option-two-checked = true;\n }\n}\n\nexport component Settings inherits Page {\n // functions\n in-out property function-one-checked <=> SettingsAdapter.function-one-checked;\n in-out property kiosk-mode-checked <=> SettingsAdapter.kiosk-mode-checked;\n in-out property function-three-checked <=> SettingsAdapter.function-three-checked;\n\n // radio options\n in-out property radio-option-one-checked <=> SettingsAdapter.radio-option-one-checked;\n in-out property radio-option-two-checked <=> SettingsAdapter.radio-option-two-checked;\n\n // check options\n in-out property check-option-one-checked <=> SettingsAdapter.check-option-one-checked;\n in-out property check-option-two-checked <=> SettingsAdapter.check-option-two-checked;\n in-out property check-option-three-checked <=> SettingsAdapter.check-option-three-checked;\n\n callback close();\n\n horizontal-padding: 0;\n\n VerticalLayout {\n padding-left: Theme.spaces.medium;\n padding-right: Theme.spaces.medium;\n padding-top: Theme.spaces.medium;\n padding-bottom: Theme.spaces.large;\n spacing: Theme.spaces.medium;\n\n // spacer\n ScrollView {\n vertical-stretch: 1;\n\n VerticalLayout {\n alignment: start;\n spacing: Theme.spaces.medium;\n\n Item {\n clicked => {\n i-function-one-check-box.clicked();\n }\n\n text: \"Function One\";\n\n i-function-one-check-box := CheckBox {\n checked <=> root.function-one-checked;\n }\n }\n\n ItemGroupBox {\n title: \"Subtitle\";\n\n Item {\n clicked => {\n i-radio-option-one.clicked();\n }\n\n text: \"Option One\";\n has-separator: true;\n\n i-radio-option-one := RadioButton {\n clicked => {\n SettingsAdapter.check-radio-option(0);\n }\n\n checked: root.radio-option-one-checked;\n\n\n }\n }\n\n Item {\n clicked => {\n i-radio-option-two.clicked();\n }\n\n text: \"Option Two\";\n\n i-radio-option-two := RadioButton {\n clicked => {\n SettingsAdapter.check-radio-option(1);\n }\n\n checked: root.radio-option-two-checked;\n }\n }\n }\n\n ItemGroupBox {\n title: \"Subtitle\";\n\n Item {\n clicked => {\n i-check-option-one.clicked();\n }\n\n text: \"Option One\";\n has-separator: true;\n\n i-check-option-one := CheckBox {\n checked <=> root.check-option-one-checked;\n }\n }\n\n Item {\n clicked => {\n i-check-option-two.clicked();\n }\n\n text: \"Option Two\";\n has-separator: true;\n\n i-check-option-two := CheckBox {\n checked <=> root.check-option-two-checked;\n }\n }\n\n Item {\n clicked => {\n i-check-option-three.clicked();\n }\n\n text: \"Option Three\";\n\n i-check-option-three := CheckBox {\n checked <=> root.check-option-three-checked;\n }\n }\n }\n\n Item {\n clicked => {\n i-kiosk-mode.clicked();\n }\n\n text: \"Kiosk mode\";\n\n i-kiosk-mode := Switch {\n changed => {\n close();\n }\n\n checked <=> root.kiosk-mode-checked;\n }\n }\n\n Item {\n clicked => {\n i-function-three.clicked();\n }\n\n text: \"Function Three\";\n\n i-function-three := Switch {\n checked <=> root.function-three-checked;\n }\n }\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/pages/overview.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Page } from \"page.slint\";\nimport { GroupBox, ValueDisplay, Value } from \"../widgets/widgets.slint\";\n\nexport global OverviewAdapter {\n in property production-title: \"Production\";\n in property self-consumption-title: \"Self-consumption\";\n in property <[Value]> production-model: [\n {\n title: \"Daily\",\n value: 12.56,\n unit: \"kWh\",\n },\n {\n title: \"Weekly\",\n value: 90.28,\n unit: \"kWh\",\n }\n ];\n in property <[Value]> self-consumption-model: [\n {\n title: \"Weekly\",\n value: 54.08,\n unit: \"kWh\",\n },\n {\n title: \"Monthly\",\n value: 320.18,\n unit: \"kWh\",\n }\n ];\n}\n\nexport component Overview inherits Page {\n in property production-title <=> OverviewAdapter.production-title;\n in property self-consumption-title <=> OverviewAdapter.self-consumption-title;\n in property <[Value]> production-model <=> OverviewAdapter.production-model;\n in property <[Value]> self-consumption-model <=> OverviewAdapter.self-consumption-model;\n\n width: 100%;\n height: 100%;\n\n VerticalLayout {\n spacing: 12px;\n\n i-production-group := GroupBox {\n title: root.production-title;\n\n ValueDisplay {\n active: root.active;\n model: root.production-model;\n }\n }\n\n i-self-consumption-group := GroupBox {\n title: root.self-consumption-title;\n\n ValueDisplay {\n active: root.active;\n alternative-colors: true;\n\n model: root.self-consumption-model;\n }\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/pages/page.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component Page inherits Rectangle {\n in property index;\n in property current-index;\n in property horizontal-padding: 14px;\n out property active: index == current-index;\n\n x: (index - current-index) * self.width;\n width: 100%;\n height: 100%;\n\n animate x { duration: Theme.durations.fast; }\n\n GridLayout {\n padding-left: root.horizontal-padding;\n padding-right: root.horizontal-padding;\n\n @children\n }\n}" }, { "path": "demos/energy-monitor/ui/pages/pages.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Balance, BalanceAdapter } from \"balance.slint\";\nimport { Overview, OverviewAdapter } from \"overview.slint\";\nimport { Usage, UsageAdapter } from \"usage.slint\";\nimport { Weather, WeatherAdapter } from \"weather.slint\";\nimport { Page } from \"page.slint\";\nimport { Dashboard } from \"dashboard.slint\";\nimport { DashboardMobile } from \"dashboard_mobile.slint\";\nimport { MenuPage, MenuPageAdapter, MenuOverviewAdapter, SettingsAdapter } from \"menu_page/menu_page.slint\";\nimport { About } from \"about.slint\";\n\nexport { Balance, BalanceAdapter }\nexport { Overview, OverviewAdapter }\nexport { Usage, UsageAdapter }\nexport { Weather, WeatherAdapter }\nexport { Page }\nexport { Dashboard }\nexport { DashboardMobile }\nexport { MenuPage, MenuPageAdapter, MenuOverviewAdapter, SettingsAdapter }\nexport { About }\n" }, { "path": "demos/energy-monitor/ui/pages/usage.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Page } from \"page.slint\";\nimport { GroupBox, Value , ValueDisplay, BarChart } from \"../widgets/widgets.slint\";\n\nexport global UsageAdapter {\n in property title: \"Usage\";\n in property <[Value]> overview-model: [\n {\n value: 16.41,\n title: \"Daily\",\n unit: \"kWh\",\n },\n {\n value: 15.23,\n title: \"Weekly\",\n unit: \"kWh\",\n }\n ];\n in property <[float]> model: [\n 10.0,\n 9.0,\n 11.0,\n 12.0,\n 8.0,\n 14.0,\n 9.0,\n 16.0,\n 18.0,\n 12.0,\n 11.0,\n 14.0,\n 12.0,\n 16.0\n ];\n in property min: 0.0;\n in property max: 24.0;\n}\n\nexport component Usage inherits Page {\n in property title <=> UsageAdapter.title;\n in property <[Value]> overview-model <=> UsageAdapter.overview-model;\n in property <[float]> model <=> UsageAdapter.model;\n in property min <=> UsageAdapter.min;\n in property max <=> UsageAdapter.max;\n\n GroupBox {\n title: root.title;\n\n Rectangle {\n BarChart {\n preferred-width: 100%;\n preferred-height: 100%;\n model: root.model;\n min: root.min;\n max: root.max;\n active: root.active;\n }\n\n VerticalLayout {\n alignment: start;\n\n ValueDisplay {\n model: overview-model;\n transparent-background: true;\n alternative-colors: true;\n active: root.active;\n }\n }\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/pages/weather.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Page } from \"page.slint\";\nimport { GroupBox, Tile, BarTiles, BarTileModel } from \"../widgets/widgets.slint\";\nimport { Images } from \"../images.slint\";\n\nexport global WeatherAdapter {\n in property title: \"Weather\";\n in property current-temperature-icon: Images.cloud;\n in property current-temperature: \"22°\";\n in property current-day: \"May 6th 2023\";\n in property current-weather-description: \"Very cloudy\";\n in property <[BarTileModel]> week-model: [\n {\n title: \"Thu\",\n icon: Images.cloudy,\n max: 21,\n min: 18,\n absolute-max: 21,\n absolute-min: 15,\n unit: \"°\"\n },\n {\n title: \"Fri\",\n icon: Images.cloudy,\n max: 20,\n min: 17,\n absolute-max: 21,\n absolute-min: 15,\n unit: \"°\"\n },\n {\n title: \"Sat\",\n icon: Images.cloudy,\n max: 18,\n min: 15,\n absolute-max: 21,\n absolute-min: 15,\n unit: \"°\"\n }\n ];\n}\n\nexport component Weather inherits Page {\n in property title <=> WeatherAdapter.title;\n in property current-temperature-icon <=> WeatherAdapter.current-temperature-icon;\n in property current-temperature <=> WeatherAdapter.current-temperature;\n in property current-day <=> WeatherAdapter.current-day;\n in property current-weather-description <=> WeatherAdapter.current-weather-description;\n in property <[BarTileModel]> week-model <=> WeatherAdapter.week-model;\n\n GroupBox {\n title: root.title;\n spacing: 1px;\n\n Tile {\n value: current-temperature;\n text: current-day;\n sub-text: current-weather-description;\n icon: current-temperature-icon;\n }\n\n BarTiles {\n model: week-model;\n active: root.active;\n }\n\n // stretches the empty element\n if(week-model.length == 0) : Rectangle {}\n }\n}" }, { "path": "demos/energy-monitor/ui/small_main.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"theme.slint\";\nimport { Navigation, MenuButton, Menu, Value } from \"widgets/widgets.slint\";\nimport { Balance, Overview, Usage, UsageAdapter, Weather, MenuPage, MenuOverviewAdapter, About } from \"pages/pages.slint\";\n\nexport component SmallMain {\n i-navigation := Navigation {\n pagination-clicked => {\n i-menu.open-menu();\n i-navigation.hide();\n }\n\n clicked => {\n // if the navigation is clicked and the arrow displayed a open menu button should be hide.\n i-menu.hide-button();\n }\n\n current-index <=> MenuOverviewAdapter.current-page;\n page-count: MenuOverviewAdapter.count;\n\n // check current-index to generate only displayed items\n if(i-navigation.current-index <= 1 && !i-menu.open) : Overview {\n index: 0;\n current-index: i-navigation.current-index;\n }\n\n if(i-navigation.current-index >= 0 && i-navigation.current-index <= 2 && !i-menu.open) : Usage {\n index: 1;\n current-index: i-navigation.current-index;\n }\n\n if(i-navigation.current-index >= 1 && i-navigation.current-index <= 3 && !i-menu.open) : Balance {\n index: 2;\n current-index: i-navigation.current-index;\n }\n\n if(i-navigation.current-index >= 2 && i-navigation.current-index <= 4 && !i-menu.open) : Weather {\n index: 3;\n current-index: i-navigation.current-index;\n }\n\n if(i-navigation.current-index >= 3 && i-navigation.current-index <= 5 && !i-menu.open) : About {\n index: 4;\n current-index: i-navigation.current-index;\n }\n }\n\n i-menu := Menu {\n preferred-width: 100%;\n preferred-height: 100%;\n start-y: 25px;\n end-y: 22px;\n menu-width: parent.width - 8px;\n menu-height: parent.height - 14px;\n\n if(i-menu.open) : MenuPage {\n page-changed => {\n i-menu.hide();\n }\n\n close => {\n i-menu.hide();\n }\n\n preferred-width: 100%;\n preferred-height: 100%;\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/theme.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nexport struct Palette {\n // primary\n slint-blue: brush,\n pure-black: brush,\n dark-deep-blue: brush,\n shark-gray: brush,\n lemon-green: brush,\n lemon-green-op10: brush,\n white: brush,\n dimmer: brush,\n\n // slint blue\n slint-blue-50: brush,\n slint-blue-100: brush,\n slint-blue-200: brush,\n slint-blue-300: brush,\n slint-blue-400: brush,\n slint-blue-500: brush,\n slint-blue-600: brush,\n slint-blue-700: brush,\n slint-blue-800: brush,\n slint-blue-900: brush,\n\n // lime green\n lime-green-50: brush,\n lime-green-100: brush,\n lime-green-200: brush,\n lime-green-300: brush,\n lime-green-400: brush,\n lime-green-500: brush,\n lime-green-600: brush,\n lime-green-700: brush,\n lime-green-800: brush,\n lime-green-900: brush,\n\n // gradients\n lemon-green-gradient: brush,\n lemon-green-light-gradient: brush,\n lemon-green-radial-gradient: brush,\n slint-blue-gradient: brush,\n heliotrope-gradient: brush,\n dark-left-gradient: brush,\n dark-right-gradient: brush,\n ebony-radial-gradient: brush,\n bar-gradient: brush,\n alternative-bar-gradient: brush,\n alternative-light-bar-gradient: brush,\n inverted-bar-gradient: brush,\n inverted-alternative-bar-gradient: brush,\n bar-background-gradient: brush,\n tab-gradient: brush,\n background-gradient: brush,\n}\n\nexport struct Spaces {\n small: length,\n medium: length,\n large: length,\n}\n\nexport struct Durations {\n fast: duration,\n medium: duration,\n slow: duration,\n}\n\nstruct Font {\n size: length,\n weight: float,\n}\n\nexport struct Typo {\n label: Font,\n label-light: Font,\n header: Font,\n header-item: Font,\n header-item-light: Font,\n value: Font,\n description: Font,\n description-light: Font,\n value-big: Font,\n}\n\nexport global Theme {\n in property palette: {\n // primary\n slint-blue: #0025FF,\n pure-black: #000000,\n dark-deep-blue: #040708,\n shark-gray: #2C2F36,\n lemon-green: #DEFB3A,\n lemon-green-op10: #defb3a1a,\n white: #FFFFFF,\n dimmer: #0000007b,\n\n // slint blue\n slint-blue-50: #EEE6FF,\n slint-blue-100: #D0C3FF,\n slint-blue-200: #AF9AFF,\n slint-blue-300: #896FFF,\n slint-blue-400: #654EFF,\n slint-blue-500: #2F2AFF,\n slint-blue-600: #0025FF,\n slint-blue-700: #001FF7,\n slint-blue-800: #0019F2,\n slint-blue-900: #000AEF,\n\n // lime green\n lime-green-50: #FBFFE6,\n lime-green-100: #F4FDC0,\n lime-green-200: #EBFC93,\n lime-green-300: #E2FA63,\n lime-green-400: #DEFB3A,\n lime-green-500: #D6F800,\n lime-green-600: #CBE600,\n lime-green-700: #BBCF00,\n lime-green-800: #ACB700,\n lime-green-900: #D9D9D9,\n\n // gradients\n lemon-green-gradient: @linear-gradient(135deg, #defb3a75 0%, #defb3a00 100%),\n lemon-green-light-gradient: @linear-gradient(135deg, #DEFB3A 0%, #defb3a33 100%),\n lemon-green-radial-gradient: @radial-gradient(circle, #DEFB3A20 0%, #DEFB3A00 100%),\n slint-blue-gradient: @linear-gradient(135deg, #6c4bff76 0%, #6C4BFF00 100%),\n heliotrope-gradient: @linear-gradient(180deg, #896fff 0%, #39316B 100%),\n dark-left-gradient: @linear-gradient(90deg, #040708 0%, #04070875 50%, #04070800 100%),\n dark-right-gradient: @linear-gradient(90deg, #04070800 0%, #04070875 50%, #040708 100%),\n ebony-radial-gradient: @radial-gradient(circle, #100F23 0%, #1F1946 100%),\n bar-gradient: @linear-gradient(180deg, #6C4BFF 0%, #6c4bff00 100%),\n alternative-bar-gradient: @linear-gradient(180deg, #CBE600 0%, #CBE60000 100%),\n alternative-light-bar-gradient: @linear-gradient(180deg, #EBFC93 0%, #EBFC9300 100%),\n inverted-bar-gradient: @linear-gradient(180deg, #6c4bff00 0%, #6C4BFF 100%),\n inverted-alternative-bar-gradient: @linear-gradient(180deg, #CBE60000 0%, #CBE600 100%),\n bar-background-gradient: @linear-gradient(180deg, #896FFF 0%, #896FFF00 100%),\n tab-gradient: @linear-gradient(180deg, #0026ff21 0%, #0026ff01 100%),\n background-gradient: @radial-gradient(circle, #0026ff40 50%, #0025FF00 100%),\n };\n\n in property spaces: {\n small: 5px,\n medium: 10px,\n large: 20px,\n };\n\n in property durations: {\n fast: 125ms,\n medium: 200ms,\n slow: 500ms,\n };\n\n in property typo: {\n label-light: {\n size: 12px,\n weight: 400\n },\n label: {\n size: 12px,\n weight: 500\n },\n header: {\n size: 16px,\n weight: 600\n },\n header-item: {\n size: 18px,\n weight: 400\n },\n header-item-light: {\n size: 18px,\n weight: 200\n },\n value: {\n size: 26px,\n weight: 500\n },\n description: {\n size: 14px,\n weight: 400\n },\n description-light: {\n size: 14px,\n weight: 200\n },\n value-big: {\n size: 40px,\n weight: 200\n },\n };\n}\n\nexport enum ScreenSize {\n EmbeddedSmall,\n EmbeddedMedium,\n Mobile,\n Desktop\n}" }, { "path": "demos/energy-monitor/ui/widgets/balance_chart.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { ChartAxis, AxisLabel, AxisValue } from \"chart_axis.slint\";\nimport { ChartPattern, BarBackground } from \"chart_pattern.slint\";\n\ncomponent UpBar {\n VerticalLayout {\n Rectangle {\n height: 0.6 * root.height;\n background: Theme.palette.alternative-bar-gradient;\n }\n\n Rectangle {\n height: 0.4 * root.height;\n background: Theme.palette.alternative-light-bar-gradient;\n }\n }\n}\n\ncomponent DownBar {\n VerticalLayout {\n Rectangle {\n height: 0.37 * root.height;\n background: Theme.palette.inverted-bar-gradient;\n }\n\n Rectangle {\n height: 0.26 * root.height;\n background: Theme.palette.inverted-alternative-bar-gradient;\n }\n\n Rectangle {\n height: 0.37 * root.height;\n background: Theme.palette.inverted-alternative-bar-gradient;\n }\n }\n}\n\nexport component BalanceChart {\n in property min;\n in property max;\n in property <[string]> x-axis-model;\n in property <[int]> y-axis-model;\n in property y-unit;\n in property <[float]> model;\n in property active;\n\n private property zero: root.height * (1 - (0. - min) / (max - min));\n\n i-zero-pattern := ChartPattern {\n preferred-width: 100%;\n preferred-height: 100%;\n y: 0px;\n count: x-axis-model.length;\n height: root.zero;\n cache-rendering-hint: true;\n }\n\n ChartPattern {\n preferred-width: 100%;\n preferred-height: 100%;\n y: i-zero-pattern.height;\n count: x-axis-model.length;\n height: root.height - i_zero_pattern.height;\n cache-rendering-hint: true;\n }\n\n ChartAxis {\n preferred-width: 100%;\n preferred-height: 100%;\n x-model: x-axis-model;\n y-model: y-axis-model;\n vertical-stretch: 1;\n y-min: min;\n y-max: max;\n y-unit: root.y-unit;\n }\n\n Rectangle {\n cache-rendering-hint: true;\n HorizontalLayout {\n padding-left: 6px;\n padding-right: 6px;\n spacing: 10px;\n\n for value[index] in model : Rectangle {\n private property display-value;\n\n if(value > 0.0) : UpBar {\n width: 100%;\n y: zero - self.height;\n height: parent.height * (display-value / (root.max - root.min));\n }\n\n if(value < 0.0) : DownBar {\n y: zero;\n width: 100%;\n height: parent.height * (-1 * value / (root.max - root.min));\n }\n\n states [\n active when active : {\n display-value: value;\n\n in {\n animate display-value { duration: Theme.durations.slow; easing: ease-in-out; }\n }\n }\n ]\n }\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/widgets/bar_chart.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nimport { ChartPattern } from \"chart_pattern.slint\";\n\ncomponent Bar {\n in property bar-height;\n\n horizontal-stretch: 1;\n\n Rectangle {\n border-radius: 2px;\n y: parent.height - self.height;\n height: bar-height;\n clip: true;\n\n Rectangle {\n height: root.height;\n y: parent.height - self.height;\n background: Theme.palette.bar-gradient;\n }\n }\n}\n\nexport component BarBackground inherits Rectangle {\n border-radius: 2px;\n background: Theme.palette.bar-background-gradient;\n opacity: 0.25;\n}\n\nexport component BarChart {\n in property <[float]> model;\n in property min;\n in property max;\n in property active;\n\n cache-rendering-hint: true;\n\n ChartPattern {\n count: model.length / 2;\n }\n\n layout := HorizontalLayout {\n spacing: 1px;\n\n for value in model : Bar {\n private property display-value;\n\n min-height: 120px;\n preferred-height: 100%;\n bar-height: parent.height * (display-value - root.min) / (root.max - root.min);\n\n states [\n active when active : {\n display-value: value;\n\n in {\n animate display-value { duration: Theme.durations.slow; easing: ease-in-out; }\n }\n }\n ]\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/widgets/bar_tiles.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { BarBackground } from \"bar_chart.slint\";\n\nexport struct BarTileModel {\n title: string,\n icon: image,\n max: int,\n min: int,\n absolute-min: int,\n absolute-max: int,\n unit: string,\n}\n\ncomponent ValueLabel {\n in property text;\n in property unit;\n\n HorizontalLayout {\n Text {\n color: Theme.palette.white;\n vertical-stretch: 0;\n horizontal-alignment: right;\n text: root.text;\n font-size: Theme.typo.description-light.size;\n font-weight: Theme.typo.description-light.weight;\n }\n\n Text {\n color: Theme.palette.white;\n vertical-stretch: 0;\n horizontal-alignment: left;\n text: \"°\";\n font-size: Theme.typo.description-light.size;\n font-weight: Theme.typo.description-light.weight;\n }\n }\n}\n\ncomponent BarTile {\n in property title <=> i-title.text;\n in property icon <=> i-icon.source;\n in property max;\n in property min;\n in property unit;\n in property absolute-min;\n in property absolute-max;\n\n HorizontalLayout {\n alignment: center;\n\n VerticalLayout {\n spacing: 7px;\n\n i-title := Text {\n color: Theme.palette.white;\n vertical-stretch: 0;\n horizontal-alignment: center;\n font-size: Theme.typo.description.size;\n font-weight: Theme.typo.description.weight;\n }\n\n i-icon := Image {\n height: 20px;\n vertical-stretch: 0;\n }\n\n ValueLabel {\n text: floor(max);\n unit: unit;\n }\n\n Rectangle {\n private property range: root.absolute-max - root.absolute-min;\n private property max-y: self.height * (root.max - root.absolute-min) / range;\n private property min-y: self.height * (root.min - root.absolute-min) / range;\n\n vertical-stretch: 1;\n\n HorizontalLayout {\n alignment: center;\n y: parent.height - max-y;\n height: max-y - min-y;\n\n Rectangle {\n min_width: 12px;\n border-radius: 6px;\n\n background: Theme.palette.lemon-green-light-gradient;\n }\n }\n }\n\n ValueLabel {\n text: floor(min);\n unit: unit;\n }\n }\n }\n}\n\nexport component BarTiles {\n in property <[BarTileModel]> model;\n in property active;\n\n horizontal-stretch: 1;\n vertical-stretch: 1;\n\n BarBackground {}\n\n HorizontalLayout {\n padding-right: 18px;\n padding-left: 18px;\n padding-top: 11px;\n padding-bottom: 11px;\n\n for tile in model : BarTile {\n private property display-max: tile.max;\n\n horizontal-stretch: 1;\n title: tile.title;\n icon: tile.icon;\n min: tile.min;\n absolute-min: tile.absolute-min;\n absolute-max: tile.absolute-max;\n unit: tile.unit;\n\n states [\n active when active : {\n max: display-max;\n\n in {\n animate max { duration: Theme.durations.slow; easing: cubic-bezier(0, 0, 0, 1); }\n }\n }\n ]\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/chart_axis.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component AxisLabel inherits Text {\n font-size: Theme.typo.label.size;\n font-weight: Theme.typo.label.weight;\n color: Theme.palette.white;\n horizontal-alignment: center;\n}\n\nexport struct AxisValue {\n value: int,\n unit: string\n}\n\nexport component ChartAxis {\n in property <[string]> x-model;\n in property <[int]> y-model;\n in property y-min;\n in property y-max;\n in property y-unit;\n\n private property y-zero: root.height * (1 - (0 - y-min) / (y-max - y-min));\n\n VerticalLayout {\n horizontal-stretch: 1;\n alignment: end;\n\n HorizontalLayout {\n spacing: 1px;\n\n for text in x-model : Rectangle {\n if(text != \"\") : AxisLabel {\n text: text;\n y: parent.height - self.height - 3px;\n }\n }\n }\n }\n\n HorizontalLayout {\n alignment: end;\n\n Rectangle {\n background: green;\n\n for value in y-model : AxisLabel {\n y: (value >= 0 ? parent.height * (1 - (value - y-min) / (y-max - y-min)) :\n y-zero + parent.height * (-1 * value / (y-max - y-min))) - self.height / 2;\n text: \"\\{value}\\{y-unit}\";\n }\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/widgets/chart_pattern.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component BarBackground inherits Rectangle {\n border-radius: 2px;\n background: Theme.palette.bar-background-gradient;\n opacity: 0.25;\n}\n\nexport component ChartPattern {\n in property count;\n\n HorizontalLayout {\n spacing: 1px;\n for _ in count : BarBackground {}\n }\n}" }, { "path": "demos/energy-monitor/ui/widgets/check_box.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { Images } from \"../images.slint\";\n\nexport component CheckBox {\n callback clicked <=> i-touch-area.clicked;\n in-out property checked;\n\n min-height: 18px;\n width: self.height;\n\n states [\n checked when checked : {\n i-container.border-width: 0;\n i-container.background: Theme.palette.lemon-green;\n i-check-icon.opacity: 1.0;\n }\n ]\n\n i-container := Rectangle {\n border-color: Theme.palette.slint-blue-300;\n border-width: 2px;\n border-radius: 2px;\n\n animate background { duration: Theme.durations.fast; }\n\n i-check-icon := Image {\n opacity: 0.0;\n colorize: Theme.palette.pure-black;\n source: Images.check;\n\n animate opacity { duration: Theme.durations.fast; }\n }\n }\n\n i-touch-area := TouchArea {\n clicked => {\n checked = !checked;\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/float_button.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { StateLayer } from \"../components/state_layer.slint\";\n\nexport component FloatButton {\n in property icon <=> i-icon.source;\n in property enabled <=> i-state-layer.enabled;\n\n callback clicked <=> i-state-layer.clicked;\n\n min_width: 50px;\n min_height: 50px;\n\n i-container := Rectangle {\n background: Theme.palette.heliotrope-gradient;\n border-radius: max(self.width, self.height) / 2;\n\n i-icon := Image {\n colorize: Theme.palette.white;\n }\n }\n\n i-state-layer := StateLayer {\n border-radius: i-container.border-radius;\n }\n}" }, { "path": "demos/energy-monitor/ui/widgets/group_box.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component GroupBox {\n in property title <=> i-title.text;\n in property spacing;\n\n layout := VerticalLayout {\n spacing: Theme.spaces.medium;\n\n i-title := Text {\n horizontal-alignment: left;\n color: Theme.palette.white;\n font-size: Theme.typo.header.size;\n font-weight: Theme.typo.header.weight;\n }\n\n i-layout := HorizontalLayout {\n spacing: root.spacing;\n\n @children\n }\n }\n}" }, { "path": "demos/energy-monitor/ui/widgets/icon_button.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component IconButton {\n in property icon <=> i-icon.source;\n in property enabled <=> i-touch-area.enabled;\n\n callback clicked <=> i-touch-area.clicked;\n\n vertical-stretch: 0;\n horizontal-stretch: 0;\n min-width: 24px;\n min-height: 24px;\n\n states [\n disabled when !root.enabled : {\n opacity: 0.25;\n }\n pressed when i-touch-area.pressed : {\n i-icon.colorize: Theme.palette.lemon-green;\n }\n ]\n\n GridLayout {\n padding: 4px;\n\n i-icon := Image {\n colorize: Theme.palette.slint-blue-300;\n\n animate colorize { duration: Theme.durations.medium; }\n }\n }\n\n i-touch-area := TouchArea {}\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/item.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { StateLayer } from \"../components/state_layer.slint\";\nimport { ScrollView } from \"scroll_view.slint\";\nimport { Theme } from \"../theme.slint\";\nimport { StateLayer } from \"../components/state_layer.slint\";\n\nexport component Item {\n in property text <=> i-text.text;\n in property has-separator;\n\n callback clicked <=> i-touch-area.clicked;\n\n min-height: 40px;\n\n i-container := Rectangle {\n background: Theme.palette.dark-deep-blue;\n border-radius: 4px;\n }\n\n i-touch-area := TouchArea {}\n\n HorizontalLayout {\n padding-left: Theme.spaces.medium;\n padding-top: Theme.spaces.medium;\n padding-bottom: Theme.spaces.medium;\n padding-right: Theme.spaces.medium;\n spacing: Theme.spaces.medium;\n\n i-text := Text {\n horizontal-stretch: 1;\n color: Theme.palette.white;\n font-size: Theme.typo.description.size;\n font-weight: Theme.typo.description.weight;\n vertical-alignment: center;\n }\n\n @children\n }\n\n if (has-separator) : Rectangle {\n width: parent.width - 2 * Theme.spaces.medium;\n height: 1px;\n x: Theme.spaces.medium;\n y: parent.height - self.height;\n background: Theme.palette.slint-blue-300;\n opacity: 0.25;\n }\n}\nexport component ItemGroupBox {\n in property title <=> i-title.text;\n\n VerticalLayout {\n HorizontalLayout {\n padding: Theme.spaces.medium;\n\n i-title := Text {\n color: Theme.palette.white;\n font-size: Theme.typo.header.size;\n font-weight: Theme.typo.header.weight;\n }\n }\n\n Rectangle {\n background: Theme.palette.dark-deep-blue;\n border-radius: 4px;\n\n VerticalLayout {\n @children\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/list_view.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { StateLayer } from \"../components/state_layer.slint\";\nimport { ScrollView } from \"scroll_view.slint\";\nimport { Theme } from \"../theme.slint\";\nimport { Images } from \"../images.slint\";\nimport { StateLayer } from \"../components/state_layer.slint\";\n\ncomponent ListViewItem {\n in property text <=> i-text.text;\n in property selected;\n\n callback clicked <=> i-state-layer.clicked;\n\n min-height: 40px;\n\n states [\n selected when selected : {\n i-container.border-color: Theme.palette.lemon-green;\n i-icon.visible: true;\n }\n ]\n\n i-container := Rectangle {\n background: Theme.palette.dark-deep-blue;\n border-radius: 4px;\n border-width: 1px;\n border-color: Theme.palette.slint-blue-400;\n }\n\n HorizontalLayout {\n padding-left: Theme.spaces.medium;\n padding-top: Theme.spaces.medium;\n padding-bottom: Theme.spaces.medium;\n padding-right: Theme.spaces.medium;\n spacing: Theme.spaces.medium;\n accessible-role: list-item;\n accessible-item-selectable: true;\n accessible-item-selected: root.selected;\n\n i-text := Text {\n horizontal-stretch: 1;\n color: Theme.palette.white;\n font-size: Theme.typo.description.size;\n font-weight: Theme.typo.description.weight;\n vertical-alignment: center;\n }\n\n i-icon := Image {\n horizontal-stretch: 0;\n visible: false;\n source: Images.check;\n colorize: Theme.palette.lemon-green;\n }\n }\n\n i-state-layer := StateLayer {\n width: i-container.width;\n height: i-container.height;\n border-radius: i-container.border-radius;\n }\n}\n\nexport component ListView {\n in property <[StandardListViewItem]> model;\n in-out property selected-index;\n\n callback selection-changed(/* index */ int);\n\n function select(index: int) {\n selected-index = index;\n selection-changed(index);\n }\n\n i-scroll-view := ScrollView {\n i-blub := VerticalLayout {\n alignment: start;\n spacing: Theme.spaces.medium;\n\n for item[index] in model : ListViewItem {\n clicked => {\n select(index);\n }\n\n private property offset: i-scroll-view.viewport-y + index * (self.height + parent.spacing);\n\n text: item.text;\n selected: index == selected-index;\n\n animate opacity { duration: Theme.durations.fast; }\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/menu.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { MenuButton } from \"menu_button.slint\";\nimport { MenuBackground } from \"../components/menu_background.slint\";\n\nexport component Menu {\n in-out property menu-button-visible;\n in property start-y;\n in property end-y;\n in property stays-open;\n in property menu-width <=> i-menu-container.width;\n in property menu-height <=> i-menu-container.height;\n out property open;\n\n callback opened();\n callback closed();\n\n public function hide-button() {\n menu-button-visible = false;\n }\n\n public function open-menu() {\n open = true;\n }\n\n public function hide() {\n menu-button-visible = false;\n open = false;\n closed();\n }\n\n private property container-visibility;\n\n states [\n open when root.open : {\n container-visibility: 1.0;\n i-menu-container.y: end-y;\n\n in {\n animate i-menu-container.y { duration: Theme.durations.medium; }\n }\n out {\n animate container-visibility, i-menu-container.y { duration: Theme.durations.medium; }\n }\n }\n ]\n\n if (open) : Rectangle {\n background: Theme.palette.pure-black;\n opacity: 0.5;\n\n TouchArea {\n clicked => {\n hide();\n }\n }\n }\n\n i-menu-container := Rectangle {\n x: (parent.width - self.width) / 2;\n y: parent.height - start-y;\n width: root.width / 3;\n height: root.height - 75px;\n\n i-container := MenuBackground {\n visible: container-visibility == 1.0;\n\n // avoid click-through\n TouchArea {}\n\n @children\n }\n\n if(menu-button-visible || container-visibility == 1.0 || stays-open) : HorizontalLayout {\n y: -i-menu-button.height / 2;\n alignment: center;\n\n VerticalLayout {\n alignment: start;\n\n i-menu-button := MenuButton {\n clicked => {\n if(open) {\n hide();\n } else {\n open-menu();\n }\n }\n }\n }\n }\n }\n}\n\nexport component MobileMenu {\n out property open;\n in property end-y;\n in property menu-x;\n out property menu-width: 200px;\n\n if (root.open) : Rectangle {\n background: Theme.palette.pure-black;\n opacity: 0.5;\n\n TouchArea {\n clicked => {\n hide();\n }\n }\n }\n\n public function open-menu() {\n root.open = true;\n }\n\n public function hide() {\n root.open = false;\n }\n\n Rectangle {\n clip: true;\n menu := Rectangle {\n x: root.menu-x;\n y: -self.height;\n width: root.menu-width;\n height: root.height / 2;\n visible: visibility > 0.0;\n\n private property visibility;\n\n MenuBackground {\n // avoid click-through\n TouchArea {}\n\n @children\n }\n\n states [\n open when root.open : {\n menu.y: end-y;\n visibility: 1.0;\n\n out {\n animate visibility { duration: Theme.durations.medium; }\n }\n }\n ]\n\n animate y { duration: Theme.durations.fast; }\n }\n\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/menu_button.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { StateLayer } from \"../components/state_layer.slint\";\n\nexport component MenuButton {\n callback clicked <=> i-state-layer.clicked;\n\n min-width: 100px;\n min-height: 32px;\n opacity: root.visible ? 1.0 : 0.0;\n\n animate opacity { duration: Theme.durations.fast; }\n\n i-container := Rectangle {\n background: Theme.palette.heliotrope-gradient;\n border-radius: root.height / 2;\n\n Rectangle {\n width: 55px;\n height: 5px;\n background: Theme.palette.white;\n border-radius: 3px;\n }\n }\n\n i-state-layer := StateLayer {\n border-radius: i-container.border-radius;\n }\n}" }, { "path": "demos/energy-monitor/ui/widgets/navigation.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Pagination } from \"pagination.slint\";\nimport { FloatButton } from \"float_button.slint\";\nimport { Theme } from \"../theme.slint\";\nimport { Images } from \"../images.slint\";\n\nexport component Navigation {\n in-out property current-index <=> i-pagination.selected-index;\n in property page-count <=> i-pagination.count;\n\n callback pagination-clicked <=> i-pagination.clicked;\n callback clicked;\n\n public function hide() {\n show-navigation = false;\n }\n\n private property show-navigation;\n\n function toggle-show-navigation() {\n show-navigation = !self.show-navigation;\n }\n\n function increment() {\n current-index = max(current-index - 1, 0);\n }\n\n function decrement() {\n current-index = min(current-index + 1, page-count - 1);\n }\n\n preferred-width: 100%;\n preferred-height: 100%;\n\n VerticalLayout {\n padding-top: Theme.spaces.small;\n\n Rectangle {\n clip: true;\n\n TouchArea {\n clicked => {\n toggle-show-navigation();\n root.clicked();\n }\n }\n\n @children\n }\n\n i-pagination := Pagination {}\n }\n\n if (show-navigation) : HorizontalLayout {\n Rectangle {\n visible: current-index > 0;\n opacity: self.visible ? 1 : 0;\n min_width: 129px;\n background: Theme.palette.dark-left-gradient;\n\n animate opacity { duration: Theme.durations.fast; }\n\n VerticalLayout {\n alignment: center;\n\n HorizontalLayout {\n padding-left: Theme.spaces.large;\n alignment: start;\n\n FloatButton {\n icon: Images.arrow-left;\n\n clicked => {\n root.increment();\n }\n }\n }\n }\n }\n\n Rectangle {}\n\n Rectangle {\n visible: current-index < page-count - 1;\n opacity: self.visible ? 1 : 0;\n min_width: 129px;\n background: Theme.palette.dark-right-gradient;\n\n animate opacity { duration: Theme.durations.fast; }\n\n VerticalLayout {\n alignment: center;\n\n HorizontalLayout {\n padding-right: Theme.spaces.large;\n alignment: end;\n\n FloatButton {\n icon: Images.arrow-right;\n\n clicked => {\n root.decrement();\n }\n }\n }\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/page_scroll_view.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { FloatButton } from \"float_button.slint\";\nimport { Images } from \"../images.slint\";\nimport { Theme } from \"../theme.slint\";\n\ncomponent ScrollBar {\n private property ref-width: self.width - 4px;\n\n in-out property page-size;\n in-out property value;\n in-out property maximum;\n in property enabled <=> i-ta.enabled;\n\n min-height: 14px;\n\n Rectangle {\n border-width: 1px;\n border-radius: 6px;\n border-color: Theme.palette.slint-blue-300;\n\n i-indicator := Rectangle {\n x: 2px + (root.ref-width - i-indicator.width) * (-root.value / root.maximum);\n height: parent.height - 4px;\n background: Theme.palette.slint-blue-300;\n width: max(32px, ref-width * root.page-size / (root.maximum + root.page-size));\n border-radius: parent.border-radius - 2px;\n }\n }\n\n i-ta := TouchArea {\n property pressed-value;\n\n width: parent.width;\n height: parent.height;\n\n pointer-event(event) => {\n if (event.button == PointerEventButton.left && event.kind == PointerEventKind.down) {\n self.pressed-value = -root.value;\n }\n }\n moved => {\n if (self.enabled && self.pressed) {\n root.value = -max(0px, min(root.maximum, self.pressed-value + (\n (self.mouse-x - self.pressed-x) * (root.maximum / (root.width - i-indicator.width))\n )));\n }\n }\n }\n}\n\nexport component PageContainer {\n callback clicked <=> i-touch-area.clicked;\n\n in property transparent-background: true;\n out property mouse-x: i-touch-area.mouse-x;\n\n in property selected;\n in property index;\n in property selected-height;\n in property selected-width;\n in property selected-h-offset;\n\n min-width: 320px;\n min-height: 240px;\n cache-rendering-hint: true;\n\n i-rect := Rectangle {\n height: parent.height;\n animate opacity { duration: Theme.durations.medium; }\n\n i-touch-area := TouchArea {}\n\n Rectangle {\n border-radius: 6px;\n background: Theme.palette.dark-deep-blue;\n opacity: root.transparent-background ? 0.5 : 1.0;\n }\n\n Rectangle {\n y: 10px;\n height: i-rect.height - 20px;\n\n @children\n }\n }\n\n states [\n selected when selected == index : {\n min-width: selected-width;\n i-rect.height: selected-height;\n i-rect.y: (self.height - selected-height) /2 + selected-h-offset;\n out { animate i-rect.y, i-rect.height { duration: Theme.durations.medium; } }\n in { animate i-rect.y, i-rect.height { duration: Theme.durations.medium; } }\n cache-rendering-hint: false;\n }\n shrink when selected != -1 : {\n horizontal-stretch: 0;\n i-rect.opacity: 0.0;\n }\n ]\n\n animate min-width { duration: Theme.durations.medium; }\n}\n\nexport component PageScrollView {\n in property page-count: 1;\n out property selection: -1;\n out property selected-height : root.height - i-layout.spacing;\n out property selected-width: i-flickable.width - i-layout.spacing * 2;\n out property selected-h-offset: (root.height - i-flick-container.height)/2;\n private property item-width: i-flickable.viewport-width / page-count;\n private property saved-item-width: item-width;\n\n public function toggle-selection(idx: int, x: length) {\n if (selection >= 0) {\n i-flickable.viewport-x = min(0px, max(i-flickable.width - saved-item-width * page-count , -x + i-flickable.width / 2 - saved-item-width / 2));\n selection = -1;\n } else {\n saved-item-width = item-width;\n selection = idx;\n i-flickable.viewport-x = -x + i-layout.spacing;\n }\n }\n\n function scroll-left() {\n i-flickable.viewport-x = min(i-flickable.viewport-x + item-width, 0);\n }\n\n function scroll-right() {\n i-flickable.viewport-x = max(i-flickable.viewport-x - item-width, i-flickable.width - i-flickable.viewport-width);\n }\n\n VerticalLayout {\n i-flick-container := Rectangle {\n z: 1;\n i-flickable := Flickable {\n y: 0;\n height: selection == -1 ? parent.height : selected-height ;\n animate viewport-x { duration: Theme.durations.medium; }\n viewport-height: i-flickable.height;\n i-layout := HorizontalLayout {\n y: (i-flick-container.height - self.height)/2;\n height: i-layout.preferred-height;\n width: i-layout.preferred-width;\n padding: 20px;\n spacing: 20px;\n\n @children\n }\n interactive: selection == -1;\n }\n }\n\n HorizontalLayout {\n vertical-stretch: 0;\n spacing: 25px;\n padding-left: 25px;\n padding-right: 25px;\n opacity: selection != -1 ? 0 : 1;\n animate opacity { duration: Theme.durations.medium; }\n\n FloatButton {\n visible: i-flickable.viewport-x < 0;\n horizontal-stretch: 0;\n icon: Images.arrow-left;\n enabled: selection == -1;\n\n clicked => {\n scroll-left();\n }\n }\n\n VerticalLayout {\n alignment: center;\n horizontal-stretch: 1;\n\n ScrollBar {\n maximum: i-flickable.viewport-width - i-flickable.width;\n page-size: i-flickable.width;\n value <=> i-flickable.viewport-x;\n enabled: selection == -1;\n }\n }\n\n FloatButton {\n visible: i-flickable.viewport-x > i-flickable.width - i-flickable.viewport-width;\n horizontal-stretch: 0;\n icon: Images.arrow-right;\n enabled: selection == -1;\n\n clicked => {\n scroll-right();\n }\n }\n }\n }\n\n}" }, { "path": "demos/energy-monitor/ui/widgets/pagination.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\ncomponent Bubble inherits Rectangle {\n in property selected;\n\n states [\n selected when selected : {\n background: Theme.palette.white;\n }\n ]\n\n min_width: 5px;\n min_height: 5px;\n border-radius: max(self.width, self.height) / 2;\n background: Theme.palette.slint-blue;\n\n i-touch-area := TouchArea {}\n}\n\nexport component Pagination {\n in property count;\n in property selected_index;\n\n callback clicked <=> i-touch-area.clicked;\n\n min-height: 26px;\n vertical-stretch: 0;\n\n VerticalLayout {\n alignment: center;\n\n HorizontalLayout {\n alignment: center;\n spacing: Theme.spaces.small;\n\n for index in count : Bubble {\n selected: index == selected-index;\n }\n }\n }\n\n i-touch-area := TouchArea {}\n}" }, { "path": "demos/energy-monitor/ui/widgets/radio_button.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component RadioButton {\n in property checked;\n\n callback clicked <=> i-touch-area.clicked;\n\n states [\n checked when checked : {\n i-container.border-color: Theme.palette.lemon-green;\n i-indicator.background: Theme.palette.lemon-green;\n }\n ]\n\n min-height: 18px;\n width: self.height;\n\n i-container := Rectangle {\n border-color: Theme.palette.slint-blue-300;\n border-width: 2px;\n border-radius: self.height / 2;\n\n animate border-color { duration: Theme.durations.fast; }\n\n i-indicator := Rectangle {\n height: parent.height - 4 * parent.border-width;\n width: self.height;\n border-radius: self.height / 2;\n\n animate background { duration: Theme.durations.fast; }\n }\n }\n\n i-touch-area := TouchArea {}\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/scroll_view.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { StateLayer } from \"../components/state_layer.slint\";\n\ncomponent ScrollBar inherits Rectangle {\n in-out property horizontal;\n in-out property maximum;\n in-out property page-size;\n // this is always negative and bigger than -maximum\n in-out property value;\n\n background: Theme.palette.pure-black;\n border-width: 1px;\n\n i-handle := Rectangle {\n width: !root.horizontal ? parent.width : root.maximum <= 0phx ? 0phx : parent.width * (root.page-size / (root.maximum + root.page-size));\n height: root.horizontal ? parent.height : root.maximum <= 0phx ? 0phx : parent.height * (root.page-size / (root.maximum + root.page-size));\n\n border-radius: 3px;\n background: Theme.palette.slint-blue-400;\n x: !root.horizontal ? 0phx : (root.width - i-handle.width) * (-root.value / root.maximum);\n y: root.horizontal ? 0phx : (root.height - i-handle.height) * (-root.value / root.maximum);\n }\n\n i-touch-area := StateLayer {\n private property pressed-value;\n\n pointer-event(event) => {\n if (event.button == PointerEventButton.left && event.kind == PointerEventKind.down) {\n self.pressed-value = -root.value;\n }\n }\n moved => {\n if (self.enabled && self.pressed) {\n root.value = -max(0px, min(root.maximum, self.pressed-value + (\n root.horizontal ? (i-touch-area.mouse-x - i-touch-area.pressed-x) * (root.maximum / (root.width - i-handle.width))\n : (i-touch-area.mouse-y - i-touch-area.pressed-y) * (root.maximum / (root.height - i-handle.height))\n )));\n }\n }\n\n width: parent.width;\n height: parent.height;\n }\n}\n\nexport component ScrollView {\n in property enabled: true;\n out property visible-width <=> i-flickable.width;\n out property visible-height <=> i-flickable.height;\n // FIXME: remove. This property is currently set by the ListView and is used by the native style to draw the scrollbar differently when it has focus\n in-out property has-focus;\n in-out property viewport-width <=> i-flickable.viewport-width;\n in-out property viewport-height <=> i-flickable.viewport-height;\n in-out property viewport-x <=> i-flickable.viewport-x;\n in-out property viewport-y <=> i-flickable.viewport-y;\n\n min-height: 50px;\n min-width: 50px;\n horizontal-stretch: 1;\n vertical-stretch: 1;\n\n i-flickable := Flickable {\n x: 2px;\n y: 2px;\n viewport-y <=> i-ver-bar.value;\n viewport-x <=> i-hor-bar.value;\n width: parent.width - i-ver-bar.width - Theme.spaces.medium;\n height: parent.height - i-hor-bar.height - Theme.spaces.medium;\n\n @children\n }\n\n i-ver-bar := ScrollBar {\n visible: viewport-height > visible-height;\n width: 5px;\n x: i-flickable.width + i-flickable.x + Theme.spaces.medium;\n y: i-flickable.y;\n height: i-flickable.height;\n horizontal: false;\n maximum: i-flickable.viewport-height - i-flickable.height;\n page-size: i-flickable.height;\n }\n\n i-hor-bar := ScrollBar {\n visible: viewport-width > visible-width;\n height: 5px;\n y: i-flickable.height + i-flickable.y;\n x: i-flickable.x;\n width: i-flickable.width;\n horizontal: true;\n maximum: i-flickable.viewport-width - i-flickable.width;\n page-size: i-flickable.width;\n }\n\n Rectangle {\n visible: viewport-y < 0;\n x: 2px;\n y: 2px;\n width: i-flickable.width;\n height: 38px;\n background: @linear-gradient(180deg, #D9D9D9 0%, #D9D9D900 100%);\n opacity: 0.1;\n }\n\n Rectangle {\n visible: viewport-height > visible-height && viewport-y > visible-height - viewport-height;\n x: 2px;\n y: i-flickable.y + i-flickable.height - self.height;\n width: i-flickable.width;\n height: 38px;\n background: @linear-gradient(180deg, #D9D9D900 0%, #D9D9D9 100%);\n opacity: 0.1;\n }\n}" }, { "path": "demos/energy-monitor/ui/widgets/switch.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\nexport component Switch {\n in-out property checked;\n\n callback changed(/* checked */ bool);\n callback clicked <=> i-touch-area.clicked;\n\n function toggle-checked() {\n checked = !checked;\n changed(checked);\n }\n\n min-height: 18px;\n width: 2 * self.height;\n\n states [\n checked when checked : {\n i-container.background: Theme.palette.lemon-green-op10;\n i-container.border-color: Theme.palette.lemon-green;\n i-indicator.background: Theme.palette.lemon-green;\n i-indicator.x: i-container.width - i-indicator.width - 2 * i-container.border-width;\n }\n ]\n\n i-container := Rectangle {\n border-color: Theme.palette.slint-blue-300;\n border-width: 2px;\n border-radius: self.height / 2;\n\n animate border-color { duration: Theme.durations.fast; }\n animate background { duration: Theme.durations.fast; }\n\n i-indicator := Rectangle {\n x: 2 * parent.border-width;\n height: parent.height - 4 * parent.border-width;\n width: self.height;\n border-radius: self.height / 2;\n background: Theme.palette.slint-blue-300;\n\n animate background { duration: Theme.durations.fast; }\n animate x { duration: Theme.durations.fast; }\n }\n }\n\n i-touch-area := TouchArea {\n clicked => {\n toggle-checked();\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/tab_widget.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\ncomponent Tab {\n in property title;\n in property selected;\n in property icon;\n\n callback clicked <=> i-touch-area.clicked;\n\n private property angle: Math.atan(self.height / 2 / self.width);\n private property has-icon: root.icon.width > 0 && root.icon.height > 0;\n\n preferred-width: 200px;\n\n states [\n selected when selected : {\n i-initiator.width: root.width;\n i-title.color: Theme.palette.lemon-green;\n i-gradient.opacity: 1.0;\n }\n ]\n\n GridLayout {\n padding: root.has-icon ? 7px : 25px;\n\n VerticalLayout {\n spacing: root.has-icon ? 7px : 0;\n\n if (root.has-icon) : Image {\n x: (parent.width - self.width) / 2;\n width: 24px;\n height: 24px;\n source: root.icon;\n colorize: i-title.color;\n }\n\n i-title := Text {\n text: title;\n horizontal-alignment: center;\n vertical-alignment: center;\n font-size: root.has-icon ? Theme.typo.description-light.size : Theme.typo.header-item-light.size;\n font-weight: root.has-icon ? Theme.typo.header-item-light.weight : Theme.typo.description-light.weight;\n color: Theme.palette.white;\n\n animate color { duration: Theme.durations.medium; }\n }\n }\n }\n\n i-gradient := Rectangle {\n opacity: 0;\n visible: !root.has-icon;\n\n Rectangle {\n y: 0;\n width: 50%;\n height: 50%;\n x: 0;\n background: @linear-gradient(angle, rgba(222, 251, 58, 0) , rgba(222, 251, 58, 0.2));\n }\n\n Rectangle {\n y: 0;\n width: 50%;\n height: 50%;\n x: self.width;\n background: @linear-gradient(-angle, rgba(222, 251, 58, 0) , rgba(222, 251, 58, 0.2));\n }\n\n animate opacity { duration: Theme.durations.medium; }\n }\n\n i-initiator := Rectangle {\n width: 0;\n y: 0;\n height: 1px;\n background: Theme.palette.lemon-green;\n visible: selected;\n\n animate width { duration: Theme.durations.medium; }\n }\n\n i-touch-area := TouchArea {}\n}\n\nexport struct TabItem {\n text: string,\n icon: image\n}\n\nexport component TabWidget {\n in property <[TabItem]> tabs;\n in-out property selected-tab;\n\n vertical-stretch: 1;\n\n VerticalLayout {\n Rectangle {\n vertical-stretch: 1;\n\n @children\n }\n\n Rectangle {\n vertical-stretch: 0;\n background: Theme.palette.tab-gradient;\n\n HorizontalLayout {\n alignment: center;\n min-height: 80px;\n vertical-stretch: 0;\n\n for tab[index] in tabs : Tab {\n title: tab.text;\n icon: tab.icon;\n selected: index == selected-tab;\n\n clicked => {\n selected-tab = index;\n }\n }\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/tile.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\nimport { BarBackground } from \"bar_chart.slint\";\n\nexport component Tile {\n in property icon <=> i-icon.source;\n in property value <=> i-value.text;\n in property text <=> i-text.text;\n in property sub-text <=> i-sub-text.text;\n\n horizontal-stretch: 0;\n vertical-stretch: 1;\n\n BarBackground {}\n\n VerticalLayout {\n padding-left: 20px;\n padding-right: 20px;\n padding-top: 10px;\n padding-bottom: 10px;\n spacing: 11px;\n alignment: center;\n\n i-icon := Image {\n x: (parent.width - self.width) / 2;\n min-width: 52px;\n height: 43px;\n colorize: Theme.palette.lemon-green;\n image-fit: contain;\n }\n\n i-value := Text {\n horizontal-alignment: center;\n color: Theme.palette.white;\n font-size: Theme.typo.value-big.size;\n font-weight: Theme.typo.value-big.weight;\n }\n\n VerticalLayout {\n i-text := Text {\n horizontal-alignment: center;\n color: Theme.palette.white;\n font-size: Theme.typo.description.size;\n font-weight: Theme.typo.description.weight;\n }\n\n i-sub-text := Text {\n horizontal-alignment: center;\n color: Theme.palette.lemon-green;\n font-size: Theme.typo.description-light.size;\n font-weight: Theme.typo.description-light.weight;\n }\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/value_display.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { Theme } from \"../theme.slint\";\n\ncomponent ValueDelegate {\n in property active;\n in property title <=> i-title.text;\n in property unit <=> i-unit.text;\n in property value;\n in property alternative-colors;\n\n private property display-value;\n\n states [\n active when active : {\n display-value: value;\n\n in {\n animate display-value { duration: Theme.durations.slow; }\n }\n }\n ]\n\n HorizontalLayout {\n spacing: 15px;\n\n Rectangle {\n min_width: 1px;\n background: alternative-colors ? Theme.palette.slint-blue-300 : Theme.palette.lemon-green;\n horizontal-stretch: 0;\n }\n\n VerticalLayout {\n alignment: center;\n horizontal-stretch: 1;\n\n i-title := Text {\n color: alternative-colors ? Theme.palette.slint-blue-300 : Theme.palette.lemon-green;\n font-size: Theme.typo.label.size;\n font-weight: Theme.typo.label.weight;\n }\n\n HorizontalLayout {\n alignment: start;\n spacing: 5px;\n\n Text {\n color: Theme.palette.white;\n text: round(display-value * 100) / 100;\n font-size: Theme.typo.value.size;\n font-weight: Theme.typo.value.weight;\n vertical-alignment: center;\n }\n\n i-unit := Text {\n y: Theme.spaces.small;\n vertical-alignment: center;\n color: alternative-colors ? Theme.palette.slint-blue-300 : Theme.palette.lemon-green;\n font-size: Theme.typo.label-light.size;\n font-weight: Theme.typo.label-light.weight;\n }\n }\n }\n }\n}\n\nexport struct Value {\n title: string,\n value: float,\n unit: string,\n}\n\nexport component ValueDisplay {\n in property alternative-colors;\n in property <[Value]> model;\n in property active;\n in property transparent-background;\n in property vertical;\n\n min-height: 70px;\n\n i-container := Rectangle {\n visible: !transparent-background;\n width: 100%;\n height: 100%;\n border-radius: 4px;\n background: alternative-colors ? Theme.palette.slint-blue-gradient : Theme.palette.lemon-green-gradient;\n }\n\n if(model.length > 0 && !vertical) : HorizontalLayout {\n x: 15px;\n width: parent.width - 30px;\n height: 100%;\n padding-top: 12px;\n padding-bottom: 12px;\n\n for value in root.model : ValueDelegate {\n width: parent.width / model.length;\n horizontal-stretch: 1;\n alternative-colors: root.alternative-colors;\n title: value.title;\n value: value.value;\n unit: value.unit;\n active: root.active;\n }\n }\n\n if(model.length > 0 && vertical) : VerticalLayout {\n for value in root.model : ValueDelegate {\n vertical-stretch: 1;\n alternative-colors: root.alternative-colors;\n title: value.title;\n value: value.value;\n unit: value.unit;\n active: root.active;\n }\n }\n}\n" }, { "path": "demos/energy-monitor/ui/widgets/widgets.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { BalanceChart } from \"balance_chart.slint\";\nimport { BarChart } from \"bar_chart.slint\";\nimport { FloatButton } from \"float_button.slint\";\nimport { GroupBox } from \"group_box.slint\";\nimport { MenuButton } from \"menu_button.slint\";\nimport { Menu, MobileMenu } from \"menu.slint\";\nimport { Navigation } from \"navigation.slint\";\nimport { Pagination } from \"pagination.slint\";\nimport { ValueDisplay, Value } from \"value_display.slint\";\nimport { Tile } from \"tile.slint\";\nimport { BarTiles, BarTileModel } from \"bar_tiles.slint\";\nimport { TabWidget, TabItem } from \"tab_widget.slint\";\nimport { IconButton } from \"icon_button.slint\";\nimport { ScrollView } from \"scroll_view.slint\";\nimport { ListView } from \"list_view.slint\";\nimport { Item, ItemGroupBox } from \"item.slint\";\nimport { CheckBox } from \"check_box.slint\";\nimport { RadioButton } from \"radio_button.slint\";\nimport { Switch } from \"switch.slint\";\nimport { PageScrollView, PageContainer } from \"page_scroll_view.slint\";\n\nexport { BalanceChart }\nexport { BarChart }\nexport { FloatButton }\nexport { GroupBox }\nexport { Navigation }\nexport { Pagination }\nexport { MenuButton }\nexport { Menu, MobileMenu }\nexport { ValueDisplay, Value }\nexport { Tile }\nexport { BarTiles, BarTileModel }\nexport { TabWidget, TabItem }\nexport { IconButton }\nexport { ScrollView }\nexport { ListView }\nexport { Item, ItemGroupBox }\nexport { CheckBox }\nexport { RadioButton }\nexport { Switch }\nexport { PageScrollView, PageContainer }" }, { "path": "demos/home-automation/README.md", "content": "\n### `Home Automation Demo`\n\nA fictional Home Automation User Interface.\n\n| `.slint` Design | Rust Source | C++ Source | Node Source | Online wasm Preview | Open in SlintPad |\n| --- | --- | --- | --- | --- | --- |\n| [`ui.slint`](./ui/demo.slint) | [`main.rs`](./rust/main.rs) | | [`main.js`](./node/main.js) | [Online simulation](https://slint.dev/snapshots/master/demos/home-automation/) | [Preview in Online Code Editor](https://slint.dev/snapshots/master/editor?load_url=https://raw.githubusercontent.com/slint-ui/slint/master/demos/home-automation/ui/demo.slint) |\n\n![Screenshot of the Home Automation Demo](https://github.com/user-attachments/assets/607e07a5-2e79-4045-9fe4-3da2493ba187 \"Home Automation Demo\")\n\n## Building and running on iOS\n\nThis demo can be cross-compiled to iOS to run on iPhones, iPads, and the respective simulators.\n\n### Prerequisites\n\n - A computer running macOS.\n - An up-to-date installation of [Xcode](https://developer.apple.com/xcode/).\n - [Xcodegen](https://github.com/yonaskolb/XcodeGen?tab=readme-ov-file#installing)\n - [Rust](https://rustup.rs). Add the target and simulator toolchains using `rustup target add aarch64-apple-ios` and `rustup target add aarch64-apple-ios-sim`\n\n### Building\n\n1. Run `xcodegen -s ios-project.yml` to generate an XCode project file (`.xcodeproj`).\n2. Open XCode and open the generated `.xcodeproj` in it.\n3. Run, deploy, and debug the demo from within Xcode.\n\n" }, { "path": "demos/home-automation/node/biome.json", "content": "{\n \"root\": true,\n \"extends\": [\"../../../biome.json\"],\n \"files\": {\n \"includes\": [\n \"**\",\n \"!**/.vscode/**\",\n \"!**/webviews/**\",\n \"!**/.vscode/**\",\n \"!**/build/**\",\n \"!**/out/**\"\n ]\n },\n \"linter\": {\n \"rules\": {\n \"style\": {\n \"noParameterAssign\": \"error\",\n \"useAsConstAssertion\": \"error\",\n \"useDefaultParameterLast\": \"error\",\n \"useEnumInitializers\": \"error\",\n \"useSelfClosingElements\": \"error\",\n \"useSingleVarDeclarator\": \"error\",\n \"noUnusedTemplateLiteral\": \"error\",\n \"useNumberNamespace\": \"error\",\n \"noInferrableTypes\": \"error\",\n \"noUselessElse\": \"error\"\n }\n }\n }\n}\n" }, { "path": "demos/home-automation/node/main.js", "content": "#!/usr/bin/env node\n// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport * as slint from \"slint-ui\";\n\nconst ui = slint.loadFile(\"../ui/demo.slint\");\nconst window = new ui.AppWindow();\nconst api = window.Api;\nconst date = api.current_date;\nconst time = api.current_time;\n\nconst timer = setInterval(() => {\n const now = new Date();\n date.year = now.getFullYear();\n date.month = now.getMonth() + 1;\n date.day = now.getDate();\n api.current_date = date;\n time.hour = now.getHours();\n time.minute = now.getMinutes();\n time.second = now.getSeconds();\n api.current_time = time;\n}, 1000);\n\nawait window.run();\nclearInterval(timer);\n" }, { "path": "demos/home-automation/node/package.json", "content": "{\n \"name\": \"home_automation\",\n \"version\": \"1.16.0\",\n \"main\": \"main.js\",\n \"type\": \"module\",\n \"dependencies\": {\n \"@biomejs/biome\": \"catalog:\",\n \"slint-ui\": \"workspace:*\"\n },\n \"scripts\": {\n \"start\": \"node .\",\n \"prestart\": \"cd ../../../api/node/ && pnpm run build && pnpm compile\",\n \"check\": \"biome check\",\n \"format\": \"biome format\",\n \"format:fix\": \"biome format --write\",\n \"lint\": \"biome lint\",\n \"lint:fix\": \"biome lint --fix\"\n }\n}\n" }, { "path": "demos/home-automation/rust/Cargo.toml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: MIT\n\n[package]\nname = \"home-automation\"\nversion = \"1.16.0\"\nauthors = [\"Slint Developers \"]\nedition.workspace = true\npublish = false\nlicense = \"MIT\"\n\n[[bin]]\npath = \"main.rs\"\nname = \"home-automation\"\n\n[lib]\ncrate-type = [\"lib\", \"cdylib\"]\npath = \"lib.rs\"\nname = \"home_automation_lib\"\n\n[dependencies]\nslint = { path = \"../../../api/rs/slint\", features = [\"backend-android-activity-06\"] }\nchrono = \"0.4\"\n\n[features]\nsw-renderer = []\n\n[target.'cfg(target_arch = \"wasm32\")'.dependencies]\nwasm-bindgen = { version = \"0.2\" }\nweb-sys = { version = \"0.3\", features = [\"console\"] }\nconsole_error_panic_hook = \"0.1.5\"\n" }, { "path": "demos/home-automation/rust/index.html", "content": "\n\n\n\n \n \n \n \n
Loading...
\n
\n \n \n \n
\n \n\n" }, { "path": "demos/home-automation/rust/ios-project.yml", "content": "# Copyright © SixtyFPS GmbH \n# SPDX-License-Identifier: MIT\nname: Home Automation\noptions:\n bundleIdPrefix: dev.slint.demos\nsettings:\n ENABLE_USER_SCRIPT_SANDBOXING: NO\ntargets:\n Home Automation:\n type: application\n platform: iOS\n deploymentTarget: \"12.0\"\n info:\n path: Info.plist\n properties:\n UILaunchScreen:\n - ImageRespectSafeAreaInsets: false\n sources: []\n postCompileScripts:\n - script: |\n ../../../scripts/build_for_ios_with_cargo.bash home-automation\n outputFileLists:\n $TARGET_BUILD_DIR/$EXECUTABLE_PATH\n" }, { "path": "demos/home-automation/rust/lib.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nuse chrono::{Datelike, Local, Timelike};\nuse slint::{Timer, TimerMode};\n\n#[cfg(target_arch = \"wasm32\")]\nuse wasm_bindgen::prelude::*;\n\n#[cfg(feature = \"sw-renderer\")]\nslint::slint! {\n export { Api, AppWindow } from \"../ui/demo-sw-renderer.slint\";\n}\n\n#[cfg(not(feature = \"sw-renderer\"))]\nslint::slint! {\n export { Api, AppWindow } from \"../ui/demo.slint\";\n}\n\n#[cfg_attr(target_arch = \"wasm32\", wasm_bindgen(start))]\npub fn main() {\n // This provides better error messages in debug mode.\n // It's disabled in release mode so it doesn't bloat up the file size.\n #[cfg(all(debug_assertions, target_arch = \"wasm32\"))]\n console_error_panic_hook::set_once();\n\n let app = AppWindow::new().expect(\"AppWindow::new() failed\");\n let app_weak = app.as_weak();\n\n let timer = Timer::default();\n timer.start(TimerMode::Repeated, std::time::Duration::from_millis(1000), move || {\n if let Some(app) = app_weak.upgrade() {\n let api = app.global::();\n let now = Local::now();\n let date = Date { year: now.year(), month: now.month() as i32, day: now.day() as i32 };\n api.set_current_date(date);\n\n let time = Time {\n hour: now.hour() as i32,\n minute: now.minute() as i32,\n second: now.second() as i32,\n };\n api.set_current_time(time);\n }\n });\n\n app.run().expect(\"AppWindow::run() failed\");\n}\n\n#[cfg(target_os = \"android\")]\n#[unsafe(no_mangle)]\nfn android_main(android_app: slint::android::AndroidApp) {\n slint::android::init(android_app).unwrap();\n main();\n}\n" }, { "path": "demos/home-automation/rust/main.rs", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nfn main() {\n home_automation_lib::main();\n}\n" }, { "path": "demos/home-automation/ui/api.slint", "content": "// Copyright © SixtyFPS GmbH \n// SPDX-License-Identifier: MIT\n\nimport { AppState, Orientation } from \"appState.slint\";\nimport { Date, Time } from \"std-widgets.slint\";\n\nexport enum WeatherCondition {\n sunny,\n sunny-rainy,\n sunny-cloudy,\n cloudy,\n rainy,\n}\nexport struct WeatherData {\n condition: WeatherCondition,\n day: string,\n temperature: float,\n}\n\nexport global Api {\n in property indoor-temperature: 22.0;\n in property outdoor-temperature: 24.0;\n\n in property price-of-electricity: 13.0;\n in property current-electricity-use: 152.9;\n\n out property orientation <=> AppState.orientation;\n in-out property graphics-accelerator-available <=> AppState.graphics-accelerator-available;\n\n in-out property current-date: {\n year: 2025,\n month: 3,\n day: 18,\n };\n\n in-out property