[ { "path": ".all-contributorsrc", "content": "{\n \"projectName\": \"qwik\",\n \"projectOwner\": \"QwikDev\",\n \"repoType\": \"github\",\n \"repoHost\": \"https://github.com\",\n \"files\": [\"README.md\"],\n \"imageSize\": 100,\n \"commit\": true,\n \"commitConvention\": \"angular\",\n \"contributors\": [],\n \"contributorsPerLine\": 7\n}\n" }, { "path": ".changeset/breezy-items-relax.md", "content": "---\n'@builder.io/qwik-city': patch\n---\n\nFIX: When a form POST is done, keys like \"name.1\" mean it's an array. However, later keys could be strings like \"name.value\". Now, we check if all the keys are numbers, otherwise we make an object instead of an array. This allows for more correct form data handling.\n" }, { "path": ".changeset/changelog-github-custom.cjs", "content": "'use strict';\nvar __assign =\n (this && this.__assign) ||\n function () {\n __assign =\n Object.assign ||\n function (t) {\n for (var s, i = 1, n = arguments.length; i < n; i++) {\n s = arguments[i];\n for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\n }\n return t;\n };\n return __assign.apply(this, arguments);\n };\nvar __awaiter =\n (this && this.__awaiter) ||\n function (thisArg, _arguments, P, generator) {\n function adopt(value) {\n return value instanceof P\n ? value\n : new P(function (resolve) {\n resolve(value);\n });\n }\n return new (P || (P = Promise))(function (resolve, reject) {\n function fulfilled(value) {\n try {\n step(generator.next(value));\n } catch (e) {\n reject(e);\n }\n }\n function rejected(value) {\n try {\n step(generator['throw'](value));\n } catch (e) {\n reject(e);\n }\n }\n function step(result) {\n result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);\n }\n step((generator = generator.apply(thisArg, _arguments || [])).next());\n });\n };\nvar __generator =\n (this && this.__generator) ||\n function (thisArg, body) {\n var _ = {\n label: 0,\n sent: function () {\n if (t[0] & 1) throw t[1];\n return t[1];\n },\n trys: [],\n ops: [],\n },\n f,\n y,\n t,\n g;\n return (\n (g = { next: verb(0), throw: verb(1), return: verb(2) }),\n typeof Symbol === 'function' &&\n (g[Symbol.iterator] = function () {\n return this;\n }),\n g\n );\n function verb(n) {\n return function (v) {\n return step([n, v]);\n };\n }\n function step(op) {\n if (f) throw new TypeError('Generator is already executing.');\n while ((g && ((g = 0), op[0] && (_ = 0)), _))\n try {\n if (\n ((f = 1),\n y &&\n (t =\n op[0] & 2\n ? y['return']\n : op[0]\n ? y['throw'] || ((t = y['return']) && t.call(y), 0)\n : y.next) &&\n !(t = t.call(y, op[1])).done)\n )\n return t;\n if (((y = 0), t)) op = [op[0] & 2, t.value];\n switch (op[0]) {\n case 0:\n case 1:\n t = op;\n break;\n case 4:\n _.label++;\n return { value: op[1], done: false };\n case 5:\n _.label++;\n y = op[1];\n op = [0];\n continue;\n case 7:\n op = _.ops.pop();\n _.trys.pop();\n continue;\n default:\n if (\n !((t = _.trys), (t = t.length > 0 && t[t.length - 1])) &&\n (op[0] === 6 || op[0] === 2)\n ) {\n _ = 0;\n continue;\n }\n if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) {\n _.label = op[1];\n break;\n }\n if (op[0] === 6 && _.label < t[1]) {\n _.label = t[1];\n t = op;\n break;\n }\n if (t && _.label < t[2]) {\n _.label = t[2];\n _.ops.push(op);\n break;\n }\n if (t[2]) _.ops.pop();\n _.trys.pop();\n continue;\n }\n op = body.call(thisArg, _);\n } catch (e) {\n op = [6, e];\n y = 0;\n } finally {\n f = t = 0;\n }\n if (op[0] & 5) throw op[1];\n return { value: op[0] ? op[1] : void 0, done: true };\n }\n };\nvar __spreadArray =\n (this && this.__spreadArray) ||\n function (to, from, pack) {\n if (pack || arguments.length === 2)\n for (var i = 0, l = from.length, ar; i < l; i++) {\n if (ar || !(i in from)) {\n if (!ar) ar = Array.prototype.slice.call(from, 0, i);\n ar[i] = from[i];\n }\n }\n return to.concat(ar || Array.prototype.slice.call(from));\n };\nObject.defineProperty(exports, '__esModule', { value: true });\n// @ts-ignore\nvar get_github_info_1 = require('@changesets/get-github-info');\nvar dotenv_1 = require('dotenv');\n(0, dotenv_1.config)();\nvar changelogFunctions = {\n getDependencyReleaseLine: function (changesets, dependenciesUpdated, options) {\n return __awaiter(void 0, void 0, void 0, function () {\n var changesetLink, _a, updatedDepenenciesList;\n return __generator(this, function (_b) {\n switch (_b.label) {\n case 0:\n if (!options.repo) {\n throw new Error(\n 'Please provide a repo to this changelog generator like this:\\n\"changelog\": [\"@changesets/changelog-github\", { \"repo\": \"org/repo\" }]'\n );\n }\n if (dependenciesUpdated.length === 0) return [2 /*return*/, ''];\n _a = '- Updated dependencies ['.concat;\n return [\n 4 /*yield*/,\n Promise.all(\n changesets.map(function (cs) {\n return __awaiter(void 0, void 0, void 0, function () {\n var links;\n return __generator(this, function (_a) {\n switch (_a.label) {\n case 0:\n if (!cs.commit) return [3 /*break*/, 2];\n return [\n 4 /*yield*/,\n (0, get_github_info_1.getInfo)({\n repo: options.repo,\n commit: cs.commit,\n }),\n ];\n case 1:\n links = _a.sent().links;\n return [2 /*return*/, links.commit];\n case 2:\n return [2 /*return*/];\n }\n });\n });\n })\n ),\n ];\n case 1:\n changesetLink = _a.apply('- Updated dependencies [', [\n _b\n .sent()\n .filter(function (_) {\n return _;\n })\n .join(', '),\n ']:',\n ]);\n updatedDepenenciesList = dependenciesUpdated.map(function (dependency) {\n return ' - '.concat(dependency.name, '@').concat(dependency.newVersion);\n });\n return [\n 2 /*return*/,\n __spreadArray([changesetLink], updatedDepenenciesList, true).join('\\n'),\n ];\n }\n });\n });\n },\n getReleaseLine: function (changeset, type, options) {\n return __awaiter(void 0, void 0, void 0, function () {\n var prFromSummary,\n commitFromSummary,\n usersFromSummary,\n replacedChangelog,\n linkifyIssueHints,\n _a,\n firstLine,\n futureLines,\n links,\n users,\n suffix,\n emojiFirstline;\n return __generator(this, function (_b) {\n switch (_b.label) {\n case 0:\n if (!options || !options.repo) {\n throw new Error(\n 'Please provide a repo to this changelog generator like this:\\n\"changelog\": [\"@changesets/changelog-github\", { \"repo\": \"org/repo\" }]'\n );\n }\n usersFromSummary = [];\n replacedChangelog = changeset.summary\n .replace(/^\\s*(?:pr|pull|pull\\s+request):\\s*#?(\\d+)/im, function (_, pr) {\n var num = Number(pr);\n if (!isNaN(num)) prFromSummary = num;\n return '';\n })\n .replace(/^\\s*commit:\\s*([^\\s]+)/im, function (_, commit) {\n commitFromSummary = commit;\n return '';\n })\n .replace(/^\\s*(?:author|user):\\s*@?([^\\s]+)/gim, function (_, user) {\n usersFromSummary.push(user);\n return '';\n })\n .trim();\n linkifyIssueHints = function (line) {\n return line.replace(\n /(?<=\\( ?(?:fix|fixes|see) )(#\\d+)(?= ?\\))/g,\n function (issueHash) {\n return '['\n .concat(issueHash, '](https://github.com/')\n .concat(options.repo, '/issues/')\n .concat(issueHash.substring(1), ')');\n }\n );\n };\n (_a = replacedChangelog.split('\\n').map(function (l) {\n return linkifyIssueHints(l.trimEnd());\n })),\n (firstLine = _a[0]),\n (futureLines = _a.slice(1));\n return [\n 4 /*yield*/,\n (function () {\n return __awaiter(void 0, void 0, void 0, function () {\n var links_1, shortCommitId, commitToFetchFrom, links_2;\n return __generator(this, function (_a) {\n switch (_a.label) {\n case 0:\n if (!(prFromSummary !== undefined)) return [3 /*break*/, 2];\n return [\n 4 /*yield*/,\n (0, get_github_info_1.getInfoFromPullRequest)({\n repo: options.repo,\n pull: prFromSummary,\n }),\n ];\n case 1:\n links_1 = _a.sent().links;\n if (commitFromSummary) {\n shortCommitId = commitFromSummary.slice(0, 7);\n links_1 = __assign(__assign({}, links_1), {\n commit: '[`'\n .concat(shortCommitId, '`](https://github.com/')\n .concat(options.repo, '/commit/')\n .concat(commitFromSummary, ')'),\n });\n }\n return [2 /*return*/, links_1];\n case 2:\n commitToFetchFrom = commitFromSummary || changeset.commit;\n if (!commitToFetchFrom) return [3 /*break*/, 4];\n return [\n 4 /*yield*/,\n (0, get_github_info_1.getInfo)({\n repo: options.repo,\n commit: commitToFetchFrom,\n }),\n ];\n case 3:\n links_2 = _a.sent().links;\n return [2 /*return*/, links_2];\n case 4:\n return [\n 2 /*return*/,\n {\n commit: null,\n pull: null,\n user: null,\n },\n ];\n }\n });\n });\n })(),\n ];\n case 1:\n links = _b.sent();\n users = usersFromSummary.length\n ? usersFromSummary\n .map(function (userFromSummary) {\n return '[@'\n .concat(userFromSummary, '](https://github.com/')\n .concat(userFromSummary, ')');\n })\n .join(', ')\n : links.user;\n suffix = '';\n if (links.pull || links.commit || users) {\n suffix = '('\n .concat(users ? 'by '.concat(users, ' ') : '', 'in ')\n .concat(links.pull || links.commit, ')');\n }\n emojiFirstline = firstLine\n .replace(/feat:/i, '✨')\n .replace(/chore:/i, '🛠')\n .replace(/infra:/i, '🛠')\n .replace(/fix:/i, '🐞🩹')\n .replace(/docs:/i, '📃');\n return [\n 2 /*return*/,\n '\\n\\n- '\n .concat(emojiFirstline, ' ')\n .concat(suffix, '\\n')\n .concat(\n futureLines\n .map(function (l) {\n return ' '.concat(l);\n })\n .join('\\n')\n ),\n ];\n }\n });\n });\n },\n};\nexports.default = changelogFunctions;\n" }, { "path": ".changeset/changelog-github-custom.ts", "content": "import { ChangelogFunctions } from '@changesets/types';\n// @ts-ignore\nimport { getInfo, getInfoFromPullRequest } from '@changesets/get-github-info';\nimport { config } from 'dotenv';\n\nconfig();\n\nconst changelogFunctions: ChangelogFunctions = {\n getDependencyReleaseLine: async (changesets, dependenciesUpdated, options) => {\n if (!options.repo) {\n throw new Error(\n 'Please provide a repo to this changelog generator like this:\\n\"changelog\": [\"@changesets/changelog-github\", { \"repo\": \"org/repo\" }]'\n );\n }\n if (dependenciesUpdated.length === 0) {\n return '';\n }\n\n const changesetLink = `- Updated dependencies [${(\n await Promise.all(\n changesets.map(async (cs) => {\n if (cs.commit) {\n const { links } = await getInfo({\n repo: options.repo,\n commit: cs.commit,\n });\n return links.commit;\n }\n })\n )\n )\n .filter((_) => _)\n .join(', ')}]:`;\n\n const updatedDepenenciesList = dependenciesUpdated.map(\n (dependency) => ` - ${dependency.name}@${dependency.newVersion}`\n );\n\n return [changesetLink, ...updatedDepenenciesList].join('\\n');\n },\n getReleaseLine: async (changeset, type, options) => {\n if (!options || !options.repo) {\n throw new Error(\n 'Please provide a repo to this changelog generator like this:\\n\"changelog\": [\"@changesets/changelog-github\", { \"repo\": \"org/repo\" }]'\n );\n }\n\n let prFromSummary: number | undefined;\n let commitFromSummary: string | undefined;\n const usersFromSummary: string[] = [];\n\n const replacedChangelog = changeset.summary\n .replace(/^\\s*(?:pr|pull|pull\\s+request):\\s*#?(\\d+)/im, (_, pr) => {\n const num = Number(pr);\n if (!isNaN(num)) {\n prFromSummary = num;\n }\n return '';\n })\n .replace(/^\\s*commit:\\s*([^\\s]+)/im, (_, commit) => {\n commitFromSummary = commit;\n return '';\n })\n .replace(/^\\s*(?:author|user):\\s*@?([^\\s]+)/gim, (_, user) => {\n usersFromSummary.push(user);\n return '';\n })\n .trim();\n\n const linkifyIssueHints = (line: string) =>\n line.replace(/(?<=\\( ?(?:fix|fixes|see) )(#\\d+)(?= ?\\))/g, (issueHash) => {\n return `[${issueHash}](https://github.com/${\n options.repo\n }/issues/${issueHash.substring(1)})`;\n });\n\n const [firstLine, ...futureLines] = replacedChangelog\n .split('\\n')\n .map((l) => linkifyIssueHints(l.trimEnd()));\n\n const links = await (async () => {\n if (prFromSummary !== undefined) {\n let { links } = await getInfoFromPullRequest({\n repo: options.repo,\n pull: prFromSummary,\n });\n if (commitFromSummary) {\n const shortCommitId = commitFromSummary.slice(0, 7);\n links = {\n ...links,\n commit: `[\\`${shortCommitId}\\`](https://github.com/${options.repo}/commit/${commitFromSummary})`,\n };\n }\n return links;\n }\n const commitToFetchFrom = commitFromSummary || changeset.commit;\n if (commitToFetchFrom) {\n const { links } = await getInfo({\n repo: options.repo,\n commit: commitToFetchFrom,\n });\n return links;\n }\n return {\n commit: null,\n pull: null,\n user: null,\n };\n })();\n\n const users = usersFromSummary.length\n ? usersFromSummary\n .map((userFromSummary) => `[@${userFromSummary}](https://github.com/${userFromSummary})`)\n .join(', ')\n : links.user;\n\n let suffix = '';\n if (links.pull || links.commit || users) {\n suffix = `(${users ? `by ${users} ` : ''}in ${links.pull || links.commit})`;\n }\n\n const emojiFirstline = firstLine\n .replace(/feat:/i, '✨')\n .replace(/chore:/i, '🛠')\n .replace(/infra:/i, '🛠')\n .replace(/fix:/i, '🐞🩹')\n .replace(/docs:/i, '📃');\n\n return `\\n\\n- ${emojiFirstline} ${suffix}\\n${futureLines.map((l) => ` ${l}`).join('\\n')}`;\n },\n};\n\nexport default changelogFunctions;\n" }, { "path": ".changeset/config.json", "content": "{\n \"$schema\": \"https://unpkg.com/@changesets/config@3.0.1/schema.json\",\n \"changelog\": [\"./changelog-github-custom.cjs\", { \"repo\": \"QwikDev/qwik\" }],\n \"commit\": false,\n \"fixed\": [[\"@builder.io/qwik\", \"@builder.io/qwik-city\", \"eslint-plugin-qwik\", \"create-qwik\"]],\n \"linked\": [],\n \"access\": \"public\",\n \"baseBranch\": \"origin/upcoming\",\n \"updateInternalDependencies\": \"minor\",\n \"ignore\": [\n \"qwik-docs\",\n \"@builder.io/qwik-labs\",\n \"insights\",\n \"@builder.io/qwik-worker\",\n \"qwik-cli-e2e\",\n \"qwik-react-test-app\",\n \"docs-e2e\"\n ],\n \"___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH\": {\n \"onlyUpdatePeerDependentsWhenOutOfRange\": true\n }\n}\n" }, { "path": ".changeset/deno-production-builds.md", "content": "---\n'@builder.io/qwik': patch\n'@builder.io/qwik-city': patch\n---\n\nFIX: support Deno as package manager for production builds. The Vite plugin now recognizes Deno as a Node-compatible runtime for manifest passing, and SSG delegates to the Node implementation instead of stubbing out.\n" }, { "path": ".changeset/eager-sides-sit.md", "content": "---\n'@builder.io/qwik': patch\n---\n\nFIX: the optimizer was not using the binary builds\n" }, { "path": ".changeset/fix-virtual-css-dev-ssr.md", "content": "---\n'@builder.io/qwik': patch\n---\n\nfix: resolve 404 error for virtual CSS modules during dev SSR\n" }, { "path": ".changeset/late-parrots-open.md", "content": "---\n'eslint-plugin-qwik': patch\n---\n\nSupport ESLint v10\n" }, { "path": ".changeset/shaky-ends-help.md", "content": "---\n'@builder.io/qwik-city': patch\n---\n\nfix: Link hash change now properly updates location.url.hash\n" }, { "path": ".changeset/small-candies-train.md", "content": "---\n'@builder.io/qwik-city': patch\n---\n\nfix: handle special characters in dynamic route\n" }, { "path": ".changeset/smooth-ends-count.md", "content": "---\n'@builder.io/qwik': patch\n---\n\nfix: type casts to bridge Rollup vs Rolldown type differences without changing runtime behavior\n" }, { "path": ".devcontainer/Dockerfile", "content": "FROM cimg/rust:1.88.0-node\n\nRUN rustup --version; \\\n cargo --version; \\\n rustc --version; \n\nRUN rustup update; \\\n rustup target add wasm32-unknown-unknown; \\\n cargo install cargo-insta --locked; \\\n cargo install wasm-pack --locked; \\\n rustup component add clippy; \\\n corepack enable --install-directory ~/bin\n\nRUN mkdir /home/circleci/store; \\\n pnpm config set store-dir /home/circleci/store\n" }, { "path": ".devcontainer/devcontainer.json", "content": "// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:\n// https://github.com/microsoft/vscode-dev-containers/tree/v0.217.2/containers/docker-existing-dockerfile\n{\n \"name\": \"Qwik devcontainer\",\n \"hostRequirements\": {\n \"cpus\": 4\n },\n // Add the IDs of extensions you want installed when the container is created.\n \"extensions\": [\n \"esbenp.prettier-vscode\",\n \"rust-lang.rust-analyzer\",\n \"hdevalke.rust-test-lens\",\n \"ms-playwright.playwright\",\n \"manucorporat.vermoji\",\n \"ms-azuretools.vscode-docker\",\n \"mitsuhiko.insta\",\n \"silvenon.mdx\",\n \"csstools.postcss\"\n ],\n \"build\": {\n \"dockerfile\": \"Dockerfile\"\n },\n \"waitFor\": \"updateContentCommand\",\n \"updateContentCommand\": \"corepack install && pnpm install\",\n \"forwardPorts\": [3300, 9229],\n \"customizations\": {\n \"codespaces\": {\n \"openFiles\": [\"CONTRIBUTING.md\"]\n }\n },\n \"portsAttributes\": {\n \"3300\": {\n \"label\": \"Serve\",\n \"onAutoForward\": \"openPreview\"\n }\n }\n}\n" }, { "path": ".dockerignore", "content": ".history\n.vscode\ndist\ndist-dev\nnode_modules\ntsc-out\nexternal\n*.\n**/*.log\netc\ntemp\ntsdoc-metadata.json\n**/.DS_Store\nintegration/out/\nintegration/todo/output\nintegration/*.js\nintegration/*.cjs\nintegration/*.map\npackages/qwik/src/napi/package-*\ntarget\n*.node\ntodo-express/\nqwik-app/" }, { "path": ".envrc", "content": "# shellcheck shell=bash\nuse flake\nwatch_file rust-toolchain\n" }, { "path": ".gitattributes", "content": "*.json linguist-language=JSON-with-Comments\n.yarn/releases/** binary\n.yarn/plugins/** binary\n" }, { "path": ".github/CODEOWNERS", "content": "# For all PRs\n* @QwikDev/core-veterans\n\n# For docs PRs\npackages/docs @QwikDev/docs-team @QwikDev/qwik-team\ncontributing @QwikDev/docs-team @QwikDev/qwik-team\nREADME.md @QwikDev/docs-team @QwikDev/qwik-team\nCONTRIBUTING.md @QwikDev/docs-team @QwikDev/qwik-team\nCODE_OF_CONDUCT.md @QwikDev/docs-team @QwikDev/qwik-team\n\n# For API changes\napi.json @QwikDev/api-guards\n\n# For releases\nCHANGELOG.md @QwikDev/api-guards\n\n# Protect the code owners file\n.github/CODEOWNERS @mhevery @shairez\n\n\n" }, { "path": ".github/ISSUE_TEMPLATE/bug.yaml", "content": "name: 🐞 Bug Report\ndescription: Something does not work or is flaky! let us know!\nlabels: ['TYPE: bug', 'STATUS-1: needs triage']\ntitle: '[🐞]'\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for taking the time to fill out this bug report!\n\n - type: dropdown\n id: component\n attributes:\n label: Which component is affected?\n options:\n - Qwik Runtime\n - Qwik Rollup / Vite plugin\n - Qwik Optimizer (rust)\n - Qwik React\n - Qwik City (routing)\n - Starters / CLI\n - Qwik Playground\n validations:\n required: true\n\n - type: textarea\n id: description\n attributes:\n description: 'A clear and concise description of what you expected to happen instead. If you intend to submit a PR for this issue, tell us in the description. Thanks!'\n label: Describe the bug\n placeholder: I am doing ... What I expect is ... What actually happening is ...\n\n validations:\n required: true\n\n - type: input\n id: reproduction\n attributes:\n label: Reproduction\n description: Please provide a link via [qwik.new](https://qwik.new/) or a link to a repo that can reproduce the problem you ran into. `npm create qwik@latest` can be used as a starter template. A [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) is required ([Why?](https://antfu.me/posts/why-reproductions-are-required)). If a report is vague (e.g. just a generic error message) and has no reproduction, it will receive a \"need reproduction\" label. If no reproduction is provided after 3 days, it will be auto-closed.\n placeholder: Reproduction URL\n validations:\n required: true\n\n - type: textarea\n id: reproduction-steps\n attributes:\n label: Steps to reproduce\n description: Please provide any reproduction steps that may need to be described. E.g. if it happens only when running the dev or build script make sure it's clear which one to use.\n placeholder: Run `npm install` followed by `npm run dev`\n\n - type: textarea\n id: system-info\n attributes:\n label: System Info\n description: Output of `npx envinfo --system --npmPackages '{vite,undici,typescript,@builder.io/*}' --binaries --browsers`\n render: shell\n placeholder: System, Binaries, Browsers\n validations:\n required: true\n\n - type: textarea\n id: additional_information\n attributes:\n label: Additional Information\n validations:\n required: false\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "contact_links:\n - name: ✨ Feature requests Ideas\n url: https://github.com/QwikDev/qwik-evolution/discussions\n about: Propose new features and improvements and help shape Qwik\n - name: 🤔 Support Question\n url: https://qwik.dev/chat\n about: This issue tracker is not for support questions. Please post your question on the Discord chat.\n" }, { "path": ".github/ISSUE_TEMPLATE/docs_suggestion.yml", "content": "name: 📖 Documentation Suggestion\ndescription: Suggestions on how we can improve the documentation.\ntitle: '[📖]'\nlabels: ['COMP: docs', 'STATUS-1: needs triage']\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for taking the time to fill out docs suggestion! However, if you think it's something you can fix yourself, please submit a PR instead.\n In every doc page, you will be able to find the \"Edit this page\" in the right menu!\n ![Screenshot](https://user-images.githubusercontent.com/127379/203278116-7986d8b2-6aad-45fd-9890-7f171ca26bf0.png)\n\n - type: textarea\n id: description\n attributes:\n description: 'A clear and concise description of your suggestion to improve the docs.'\n label: Suggestion\n validations:\n required: true\n" }, { "path": ".github/PULL_REQUEST_TEMPLATE.md", "content": "\n\n# What is it?\n\n\n\n- Feature / enhancement\n- Bug\n- Docs / tests / types / typos\n- Infra\n\n# Description\n\n\n\n# Checklist\n\n\n\n- [ ] My code follows the [developer guidelines of this project](https://github.com/QwikDev/qwik/blob/main/CONTRIBUTING.md)\n- [ ] I performed a self-review of my own code\n- [ ] I added a changeset with `pnpm change`\n- [ ] I made corresponding changes to the Qwik docs\n- [ ] I added new tests to cover the fix / functionality\n" }, { "path": ".github/workflows/ai-issue-triage.yml", "content": "name: AI Issue Triage\n\non:\n issues:\n types: [opened]\n\npermissions:\n issues: write\n\njobs:\n triage:\n if: github.repository == 'QwikDev/qwik'\n runs-on: ubuntu-latest\n\n steps:\n - name: Check account age (skip accounts < 30 days)\n id: check\n uses: actions/github-script@v7\n with:\n script: |\n const user = await github.rest.users.getByUsername({\n username: context.payload.issue.user.login\n });\n const created = new Date(user.data.created_at);\n const days = (Date.now() - created) / (1000 * 60 * 60 * 24);\n return days >= 30;\n\n - name: AI triage and apply labels\n if: steps.check.outputs.result == 'true'\n uses: actions/github-script@v7\n env:\n OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY }}\n with:\n script: |\n const issue = context.payload.issue;\n const issueText = `Title: ${issue.title}\\n\\nBody: ${issue.body || '(empty)'}`;\n\n // Call OpenCode Zen API (OpenAI-compatible)\n const response = await fetch('https://opencode.ai/zen/v1/chat/completions', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Authorization': `Bearer ${process.env.OPENCODE_API_KEY}`\n },\n body: JSON.stringify({\n model: 'kimi-k2.5',\n messages: [\n {\n role: 'system',\n content: `You are a Qwik framework issue triager. Given an issue, respond with ONLY a JSON array of label strings to apply. No explanation, no markdown, just the JSON array.\n\n Available labels:\n\n Type (pick exactly one):\n - \"bug\" — Something isn't working\n - \"enhancement\" — New feature or request\n\n Component (pick if clearly relevant):\n - \"runtime\", \"Optimizer\", \"Router\", \"SSR\", \"Preloader\", \"starters\", \"styling\", \"types\", \"reactivity\", \"Insights\", \"docs\", \"DX\"\n\n Status (apply if applicable):\n - \"needs reproduction\" — Bug report lacks a reproduction link\n\n Rules:\n 1. Always include exactly ONE type label.\n 2. For bugs without a reproduction link, include \"needs reproduction\".\n 3. Do NOT include \"good first issue\" unless the fix is obviously trivial.\n 4. Respond with ONLY a JSON array like: [\"bug\", \"runtime\", \"needs reproduction\"]`\n },\n {\n role: 'user',\n content: issueText\n }\n ],\n temperature: 0\n })\n });\n\n if (!response.ok) {\n const text = await response.text();\n core.setFailed(`Zen API error ${response.status}: ${text}`);\n return;\n }\n\n const data = await response.json();\n const content = data.choices[0].message.content.trim();\n\n // Parse labels from response\n let labels;\n try {\n labels = JSON.parse(content);\n } catch {\n // Try extracting JSON array from response\n const match = content.match(/\\[[\\s\\S]*\\]/);\n if (match) {\n labels = JSON.parse(match[0]);\n } else {\n core.setFailed(`Could not parse labels from: ${content}`);\n return;\n }\n }\n\n if (!Array.isArray(labels) || labels.length === 0) {\n core.setFailed(`Invalid labels response: ${content}`);\n return;\n }\n\n // Fetch actual repo labels to validate against\n const repoLabels = await github.paginate(github.rest.issues.listLabelsForRepo, {\n owner: context.repo.owner,\n repo: context.repo.repo,\n per_page: 100\n });\n const allowed = new Set(repoLabels.map(l => l.name));\n const valid = labels.filter(l => allowed.has(l));\n\n if (valid.length === 0) {\n core.setFailed(`No valid labels found in: ${JSON.stringify(labels)}`);\n return;\n }\n\n // Apply labels\n await github.rest.issues.addLabels({\n owner: context.repo.owner,\n repo: context.repo.repo,\n issue_number: issue.number,\n labels: valid\n });\n\n core.info(`Applied labels: ${valid.join(', ')}`);\n\n // Post follow-up comment for needs reproduction\n // (labeling-issues.yml won't fire because GITHUB_TOKEN labels don't trigger labeled events)\n if (valid.includes('needs reproduction')) {\n const author = issue.user.login;\n await github.rest.issues.createComment({\n owner: context.repo.owner,\n repo: context.repo.repo,\n issue_number: issue.number,\n body: `Hello @${author}. Please provide a [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) using a GitHub repository or [StackBlitz](https://qwik.new).\\n[Here](https://antfu.me/posts/why-reproductions-are-required#why-reproduction) is why reproductions help us fix issues faster.\\nThanks 🙏`\n });\n }\n" }, { "path": ".github/workflows/auto-assign-core-team.yml", "content": "name: Auto-assign PRs to core team authors\n\non:\n pull_request_target:\n types: [opened, reopened, ready_for_review, converted_to_draft]\n\npermissions:\n pull-requests: write\n contents: read\n\njobs:\n auto_assign:\n name: Assign PR author when core team member\n runs-on: ubuntu-latest\n steps:\n - name: Check team membership via REST\n id: team\n env:\n GH_TOKEN: ${{ secrets.QWIK_AUTO_ASSIGN_PR_PAT }}\n ORG: QwikDev\n TEAM_SLUG: qwik-team\n AUTHOR: ${{ github.event.pull_request.user.login }}\n run: |\n RESPONSE=$(curl -s \\\n -H \"Authorization: token ${GH_TOKEN}\" \\\n -H \"Accept: application/vnd.github+json\" \\\n \"https://api.github.com/orgs/${ORG}/teams/${TEAM_SLUG}/memberships/${AUTHOR}\")\n\n STATE=$(echo \"$RESPONSE\" | jq -r '.state // empty')\n if [ \"$STATE\" = \"active\" ]; then\n echo \"isCore=true\" >> $GITHUB_OUTPUT\n else\n echo \"isCore=false\" >> $GITHUB_OUTPUT\n fi\n\n - name: Assign PR to author\n if: steps.team.outputs.isCore == 'true'\n env:\n GH_TOKEN: ${{ secrets.QWIK_AUTO_ASSIGN_PR_PAT }}\n run: |\n PR_NUMBER=${{ github.event.pull_request.number }}\n AUTHOR=${{ github.event.pull_request.user.login }}\n curl -s -H \"Authorization: token ${GH_TOKEN}\" \\\n -H \"Accept: application/vnd.github+json\" \\\n -X POST \\\n -d \"{\\\"assignees\\\":[\\\"${AUTHOR}\\\"]}\" \\\n https://api.github.com/repos/${{ github.repository }}/issues/${PR_NUMBER}/assignees\n\n - name: Add PR to Qwik Development project\n id: add-project\n if: steps.team.outputs.isCore == 'true'\n uses: actions/add-to-project@v1.0.2\n with:\n project-url: https://github.com/orgs/QwikDev/projects/1\n github-token: ${{ secrets.QWIK_AUTO_ASSIGN_PR_PAT }}\n\n - name: Set status to \"In progress\" (draft)\n if: steps.team.outputs.isCore == 'true' && github.event.pull_request.draft == true\n uses: titoportas/update-project-fields@v0.1.0\n with:\n project-url: https://github.com/orgs/QwikDev/projects/1\n github-token: ${{ secrets.QWIK_AUTO_ASSIGN_PR_PAT }}\n item-id: ${{ steps.add-project.outputs.itemId }}\n field-keys: Status\n field-values: In progress\n\n - name: Set status to \"Waiting For Review\" (ready)\n if: steps.team.outputs.isCore == 'true' && github.event.pull_request.draft == false\n uses: titoportas/update-project-fields@v0.1.0\n with:\n project-url: https://github.com/orgs/QwikDev/projects/1\n github-token: ${{ secrets.QWIK_AUTO_ASSIGN_PR_PAT }}\n item-id: ${{ steps.add-project.outputs.itemId }}\n field-keys: Status\n field-values: Waiting For Review\n" }, { "path": ".github/workflows/bench.yml.disabled", "content": "# disabled for now, not working as expected and not checking qwik runtime performance\nname: Benchmark\n\non:\n - push\n - pull_request\n\njobs:\n changes:\n runs-on: ubuntu-latest\n outputs:\n optimizer: ${{ steps.filter.outputs.optimizer }}\n\n steps:\n - uses: actions/checkout@v5\n - uses: dorny/paths-filter@v2\n id: filter\n with:\n filters: |\n optimizer:\n - 'src/optimizer/core/**'\n\n benchmark:\n name: Performance regression check\n needs: changes\n if: ${{ needs.changes.outputs.optimizer == 'true' }}\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v5\n\n - name: Cache\n uses: actions/cache@v4\n with:\n path: |\n ~/.cargo/bin/\n ~/.cargo/registry/index/\n ~/.cargo/registry/cache/\n ~/.cargo/git/db/\n target/\n key: cargo-bench-${{ runner.os }}-${{ hashFiles('**/Cargo.lock') }}\n restore-keys: |\n cargo-bench-${{ runner.os }}-${{ hashFiles('**/Cargo.lock') }}\n\n - name: Install Rust\n uses: actions-rs/toolchain@v1\n with:\n profile: minimal\n toolchain: nightly-2021-09-30\n override: true\n\n - name: Run benchmark\n run: cargo +nightly-2021-09-30 bench --workspace | tee output.txt\n\n - name: Download previous benchmark results\n run: mkdir raw-data && curl -o raw-data/benchmark-data.json https://raw.githubusercontent.com/QwikDev/qwik-raw-data/gh-pages/benchmark-data.json\n\n - name: Analyze benchmark result\n uses: benchmark-action/github-action-benchmark@v1\n with:\n # What benchmark tool the output.txt came from\n tool: 'cargo'\n # Where the output from the benchmark tool is stored\n output-file-path: output.txt\n external-data-json-path: ./raw-data/${{ github.sha }}/benchmark-data.json\n # Workflow will fail when an alert happens\n fail-on-alert: false\n # GitHub API token to make a commit comment\n github-token: ${{ secrets.GITHUB_TOKEN }}\n # Enable alert commit comment\n comment-on-alert: true\n comment-always: true\n alert-comment-cc-users: '@manucorporat'\n skip-fetch-gh-pages: true\n\n - name: Analyze benchmark result (root)\n if: ${{ github.event_name == 'push' }}\n uses: benchmark-action/github-action-benchmark@v1\n with:\n # What benchmark tool the output.txt came from\n tool: 'cargo'\n # Where the output from the benchmark tool is stored\n output-file-path: output.txt\n external-data-json-path: ./raw-data/benchmark-data.json\n # Workflow will fail when an alert happens\n # fail-on-alert: true\n # GitHub API token to make a commit comment\n github-token: ${{ secrets.GITHUB_TOKEN }}\n # Enable alert commit comment\n comment-on-alert: true\n comment-always: true\n alert-comment-cc-users: '@manucorporat'\n max-items-in-chart: 250\n skip-fetch-gh-pages: true\n auto-push: false\n\n - name: Deploy to qwik-raw-data\n if: ${{ github.ref == 'refs/heads/main' }}\n uses: JamesIves/github-pages-deploy-action@4.1.0\n with:\n token: ${{ secrets.PAT_GITHUB_TOKEN }}\n branch: gh-pages\n folder: raw-data\n clean: false\n single-commit: false\n git-config-email: github-bot@builder.io\n repository-name: QwikDev/qwik-raw-data\n commit-message: 'Update'\n" }, { "path": ".github/workflows/ci.yml", "content": "# Build and test everything\n#\n# First it builds the packages and stores them in artifacts/cache.\n# Meanwhile it lints the code.\n# Then it runs the unit tests with the artifacts, as well as builds the docs and insights\n# Once it all works, it does a release\n#\n# NOTE: only use pnpm run scripts for build commands\n# This way we're sure that dev and CI environments are consistent\n\nname: Qwik CI\n\n# TODO fix e2e tests hanging and not cancelling\n# # We only need one instance of the workflow running at a time, per branch\n# concurrency:\n# group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.ref }}\n# cancel-in-progress: true\n\non:\n pull_request:\n push:\n branches:\n - main\n - upcoming\n - next\n - qwik-labs\n - vercelserverless\n - 'build/**'\n workflow_dispatch:\n inputs:\n disttag:\n description: 'Publish \"@builder.io/qwik\" to NPM using this dist-tag, push the git-tag to the repo and create a GitHub release. The \"latest\" and \"next\" dist-tags will use the version number already committed in package.json.'\n required: true\n type: choice\n default: 'dev'\n options:\n - dev\n - next\n - latest\n\nenv:\n # Disable incremental build, speeds up CI\n CARGO_INCREMENTAL: 0\n\npermissions:\n id-token: write\n contents: write\n pull-requests: write\n\njobs:\n changes:\n name: Setup\n runs-on: ubuntu-latest\n outputs:\n hash-qwik: ${{ steps.cache-qwik.outputs.cache-primary-key }}\n hash-rust: ${{ steps.cache-rust.outputs.cache-primary-key }}\n hash-others: ${{ steps.cache-others.outputs.cache-primary-key }}\n hash-docs: ${{ steps.cache-docs.outputs.cache-primary-key }}\n hash-insights: ${{ steps.cache-insights.outputs.cache-primary-key }}\n hash-unit: ${{ steps.cache-unit.outputs.cache-primary-key }}\n hash-e2e: ${{ steps.cache-e2e.outputs.cache-primary-key }}\n hash-cli-e2e: ${{ steps.cache-cli-e2e.outputs.cache-primary-key }}\n build-qwik: ${{ steps.cache-qwik.outputs.cache-hit != 'true' }}\n build-rust: ${{ steps.cache-rust.outputs.cache-hit != 'true' }}\n build-others: ${{ steps.cache-others.outputs.cache-hit != 'true' }}\n build-docs: ${{ steps.cache-docs.outputs.cache-hit != 'true' }}\n build-insights: ${{ steps.cache-insights.outputs.cache-hit != 'true' }}\n build-unit: ${{ steps.cache-unit.outputs.cache-hit != 'true' }}\n build-e2e: ${{ steps.cache-e2e.outputs.cache-hit != 'true' }}\n build-cli-e2e: ${{ steps.cache-cli-e2e.outputs.cache-hit != 'true' }}\n disttag: ${{ steps.set_dist_tag.outputs.disttag }}\n\n steps:\n - name: Branch\n run: echo \"${{ github.ref }}\"\n - name: NPM Dist Tag from input\n run: echo \"${{ github.event.inputs.disttag }}\"\n - name: Github event\n run: echo event_name=${{ github.event_name }}\n\n - name: Checkout\n uses: actions/checkout@v5\n\n - name: Set Dist Tag\n id: set_dist_tag\n if: |\n github.ref == 'refs/heads/upcoming' && (\n github.event_name == 'push' ||\n github.event_name == 'workflow_dispatch'\n )\n run: |\n if [ ${{ github.event_name }} == 'workflow_dispatch' ]; then\n disttag=\"${{ github.event.inputs.disttag }}\"\n echo \"Overriding disttag with input: $disttag\"\n echo \"disttag=${disttag}\" >> $GITHUB_OUTPUT\n exit 0\n fi\n\n is_release=false\n commit_id=${{ github.sha }}\n owner=${{ github.repository_owner }}\n repo=${{ github.event.repository.name }}\n\n removed_files=$(curl -s -H \"Authorization: token ${{ secrets.GITHUB_TOKEN }}\" \\\n \"https://api.github.com/repos/$owner/$repo/commits/$commit_id\" | jq -r '.files[] | select(.status == \"removed\") | .filename')\n\n echo \"Removed files: $removed_files\"\n\n md_file_removed=false\n for file in $removed_files; do\n if [[ $file == .changeset/*.md ]]; then\n md_file_removed=true\n break\n fi\n done\n\n if [ $md_file_removed = true ]; then\n if ! ls .changeset/*.md > /dev/null 2>&1; then\n is_release=true\n fi\n fi\n\n echo \"is_release: $is_release\"\n\n if [ \"$is_release\" = true ]; then\n disttag='latest'\n else \n disttag=\"${{github.event.inputs.disttag}}\"\n fi\n\n echo \"disttag: $disttag\"\n\n echo \"disttag=${disttag}\" >> $GITHUB_OUTPUT\n\n - run: jq .scripts package.json > scripts.json\n\n - name: 'check cache: qwik'\n id: cache-qwik\n uses: actions/cache/restore@v4\n with:\n lookup-only: true\n path: packages/qwik/dist\n # Note that this includes the package.json of qwik\n key: ${{ hashfiles('.github/workflows/ci.yml', 'pnpm-lock.yaml', 'scripts.json', 'scripts/**/*', 'packages/qwik/**/*', 'starters/features/**/*', 'starters/adapters/**/*', 'starters/templates/**/*', '!**/*.unit.*', '!**/*.rs', '!starters/apps/e2e') }}\n - run: 'echo ${{ steps.cache-qwik.outputs.cache-primary-key }} > qwik-key.txt'\n - name: 'check cache: rust'\n id: cache-rust\n uses: actions/cache/restore@v4\n with:\n lookup-only: true\n path: packages/qwik/bindings\n key: ${{ hashfiles('Makefile', 'rust-toolchain', '**/Cargo.toml', '**/Cargo.lock', '**/*.rs') }}\n - run: 'echo ${{ steps.cache-rust.outputs.cache-primary-key }} > rust-key.txt'\n - name: 'check cache: others'\n id: cache-others\n uses: actions/cache/restore@v4\n with:\n lookup-only: true\n path: |\n packages/qwik-city/lib\n packages/qwik-labs/lib\n packages/qwik-labs/vite\n packages/qwik-react/lib\n packages/eslint-plugin-qwik/dist\n packages/create-qwik/dist\n # note that all inputs need to be listed here, including qwik, for correct cache invalidation\n key: ${{ hashfiles('qwik-key.txt', 'rust-key.txt', 'packages/qwik-city/**/*', 'packages/qwik-labs/**/*', 'packages/qwik-react/**/*', 'packages/eslint-plugin-qwik/**/*', 'packages/create-qwik/**/*', 'starters/apps/**/*', '!**/*.unit.*') }}\n - run: 'echo ${{ steps.cache-others.outputs.cache-primary-key }} > others-key.txt'\n - name: 'check cache: docs'\n id: cache-docs\n uses: actions/cache/restore@v4\n with:\n lookup-only: true\n path: docs-build-completed.txt\n key: ${{ hashfiles('others-key.txt', 'packages/docs/**/*') }}\n - name: 'check cache: insights'\n id: cache-insights\n uses: actions/cache/restore@v4\n with:\n lookup-only: true\n path: |\n packages/insights/dist\n packages/insights/.netlify\n key: ${{ hashfiles('others-key.txt', 'packages/insights/**/*') }}\n - name: 'check cache: unit tests'\n id: cache-unit\n uses: actions/cache/restore@v4\n with:\n lookup-only: true\n path: unit-tests-completed.txt\n key: ${{ hashfiles('others-key.txt', 'packages/**/*.unit.*') }}\n - name: 'check cache: e2e tests'\n id: cache-e2e\n uses: actions/cache/restore@v4\n with:\n lookup-only: true\n path: e2e-tests-completed.txt\n key: ${{ hashfiles('others-key.txt', 'starters/**/*') }}\n - name: 'check cache: cli e2e tests'\n id: cache-cli-e2e\n uses: actions/cache/restore@v4\n with:\n lookup-only: true\n path: cli-e2e-tests-completed.txt\n key: ${{ hashfiles('others-key.txt', 'e2e/**/*') }}\n\n ############ BUILD Qwik ############\n build-qwik:\n if: needs.changes.outputs.build-qwik == 'true'\n name: Build Qwik\n needs: changes\n runs-on: ubuntu-latest\n steps:\n - name: Checkout\n uses: actions/checkout@v5\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - name: Install NPM Dependencies\n run: |\n # Ensure that the qwik binary gets made\n mkdir -p packages/qwik/bindings/\n pnpm install --frozen-lockfile\n\n - name: 'build: qwik'\n run: pnpm build --qwik --set-dist-tag=\"${{ needs.changes.outputs.disttag }}\"\n\n - name: Print Qwik Dist Build\n continue-on-error: true\n run: tree -a packages/qwik/dist/\n\n - name: Save qwik cache\n uses: actions/cache/save@v4\n with:\n key: ${{ needs.changes.outputs.hash-qwik }}\n path: packages/qwik/dist\n\n - name: Save artifacts\n uses: actions/upload-artifact@v4\n with:\n name: artifact-qwik-no-optimizer\n include-hidden-files: true\n path: packages/qwik/dist/\n if-no-files-found: error\n\n ############ BUILD PLATFORM BINDINGS ############\n build-bindings:\n if: needs.changes.outputs.build-rust == 'true'\n strategy:\n matrix:\n settings:\n - host: ubuntu-latest\n target: x86_64-unknown-linux-gnu\n wasm: true\n\n # the last x86 macos available as a standard runner\n - host: macos-13\n target: x86_64-apple-darwin\n\n - host: macos-latest\n target: aarch64-apple-darwin\n\n - host: windows-latest\n target: x86_64-pc-windows-msvc\n\n name: Build optimizer ${{ matrix.settings.target }}\n runs-on: ${{ matrix.settings.host }}\n\n needs: changes\n\n steps:\n - name: Checkout\n uses: actions/checkout@v5\n\n - name: Install Rust toolchain\n uses: actions-rust-lang/setup-rust-toolchain@v1\n with:\n components: clippy,rustfmt\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - run: pnpm install\n - if: matrix.settings.wasm\n run: pnpm install -w wasm-pack\n\n - name: Lint check\n if: matrix.settings.wasm\n run: pnpm lint.rust\n\n - name: Unit tests\n if: matrix.settings.wasm\n run: pnpm test.rust\n\n - name: Build Platform Binding\n run: pnpm build --platform-binding\n\n - name: Build Wasm Binding\n if: matrix.settings.wasm\n run: pnpm build --wasm\n\n - name: Print Packages Dist Build\n continue-on-error: true\n run: ls -lR packages/qwik/bindings/\n\n - name: Upload Platform Binding Artifact\n uses: actions/upload-artifact@v4\n with:\n name: artifact-bindings-${{ matrix.settings.target }}\n include-hidden-files: true\n path: packages/qwik/bindings/\n if-no-files-found: error\n\n ############ BUILD PACKAGE ############\n combined-qwik:\n name: Bundle Qwik\n if: always()\n runs-on: ubuntu-latest\n needs:\n - build-qwik\n - build-bindings\n - changes\n\n steps:\n - name: Verify builds\n if: |\n !(\n (needs.build-qwik.result == 'success' || needs.build-qwik.result == 'skipped') &&\n (needs.build-bindings.result == 'success' || needs.build-bindings.result == 'skipped')\n )\n run: exit 1\n\n - name: Restore artifacts\n if: needs.changes.outputs.build-rust == 'true'\n uses: actions/download-artifact@v4\n\n - name: Restore Qwik from cache\n uses: actions/cache/restore@v4\n with:\n path: packages/qwik/dist\n key: ${{ needs.changes.outputs.hash-qwik }}\n\n - name: Restore Rust from cache\n if: needs.changes.outputs.build-rust != 'true'\n uses: actions/cache/restore@v4\n with:\n path: packages/qwik/bindings\n key: ${{ needs.changes.outputs.hash-rust }}\n\n - name: Move Rust Artifacts\n if: needs.changes.outputs.build-rust == 'true'\n run: |\n mkdir -p packages/qwik/bindings\n mv artifact-bindings-*/* packages/qwik/bindings\n\n - name: Save rust cache\n if: needs.changes.outputs.build-rust == 'true'\n uses: actions/cache/save@v4\n with:\n key: ${{ needs.changes.outputs.hash-rust }}\n path: packages/qwik/bindings\n\n - name: Upload Qwik artifact\n uses: actions/upload-artifact@v4\n with:\n name: artifact-qwik\n include-hidden-files: true\n path: |\n packages/qwik/bindings\n packages/qwik/dist\n if-no-files-found: error\n\n build-other-packages:\n name: Build Other Packages\n needs:\n - changes\n - combined-qwik\n if: always()\n runs-on: ubuntu-latest\n steps:\n - name: Verify combined-qwik\n if: needs.combined-qwik.result != 'success'\n run: exit 1\n\n - name: Checkout\n if: needs.changes.outputs.build-others == 'true'\n uses: actions/checkout@v5\n\n - uses: pnpm/action-setup@v4\n if: needs.changes.outputs.build-others == 'true'\n - name: Setup Node\n if: needs.changes.outputs.build-others == 'true'\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - name: Restore Qwik artifact\n uses: actions/download-artifact@v4\n with:\n name: artifact-qwik\n path: packages/qwik/\n\n - name: Install NPM Dependencies\n if: needs.changes.outputs.build-others == 'true'\n run: pnpm install\n\n - name: 'build: qwik-city & others'\n if: needs.changes.outputs.build-others == 'true'\n run: pnpm build --tsc --api --qwikcity --cli --qwiklabs --qwikreact --eslint --set-dist-tag=\"${{ needs.changes.outputs.disttag }}\"\n - name: Save others cache\n if: needs.changes.outputs.build-others == 'true'\n uses: actions/cache/save@v4\n with:\n key: ${{ needs.changes.outputs.hash-others }}\n path: |\n packages/qwik-city/lib\n packages/qwik-labs/lib\n packages/qwik-labs/vite\n packages/qwik-react/lib\n packages/eslint-plugin-qwik/dist\n packages/create-qwik/dist\n\n - name: 'restore: qwik-city & others'\n if: needs.changes.outputs.build-others != 'true'\n uses: actions/cache/restore@v4\n with:\n path: |\n packages/qwik-city/lib\n packages/qwik-labs/lib\n packages/qwik-labs/vite\n packages/qwik-react/lib\n packages/eslint-plugin-qwik/dist\n packages/create-qwik/dist\n key: ${{ needs.changes.outputs.hash-others }}\n\n - name: Print QwikCity Lib Build\n run: tree -a packages/qwik-city/lib/\n\n - name: Upload QwikCity Build Artifacts\n uses: actions/upload-artifact@v4\n with:\n name: artifact-qwikcity\n include-hidden-files: true\n path: packages/qwik-city/lib/\n if-no-files-found: error\n\n - name: Print QwikLabs Lib Build\n run: tree -a packages/qwik-labs/lib/ packages/qwik-labs/vite/\n\n - name: Upload QwikLabs+React Build Artifacts\n uses: actions/upload-artifact@v4\n with:\n name: artifact-qwiklabs\n include-hidden-files: true\n path: |\n packages/qwik-labs/lib/\n packages/qwik-labs/vite/\n packages/qwik-labs/package.json\n if-no-files-found: error\n\n - name: Print qwik-react Lib Build\n run: tree -a packages/qwik-react/lib/\n\n - name: Upload qwik-react Build Artifacts\n uses: actions/upload-artifact@v4\n with:\n name: artifact-qwikreact\n include-hidden-files: true\n path: |\n packages/qwik-react/lib/\n packages/qwik-react/package.json\n if-no-files-found: error\n\n - name: Print Create Qwik CLI Dist Build\n run: tree -a packages/create-qwik/dist/\n\n - name: Upload Create Qwik CLI Build Artifacts\n uses: actions/upload-artifact@v4\n with:\n name: artifact-create-qwik\n include-hidden-files: true\n path: packages/create-qwik/dist/\n if-no-files-found: error\n\n - name: Print Eslint rules Dist Build\n run: tree -a packages/eslint-plugin-qwik/dist/\n\n - name: Upload Eslint rules Build Artifacts\n uses: actions/upload-artifact@v4\n with:\n name: artifact-eslint-plugin-qwik\n include-hidden-files: true\n path: packages/eslint-plugin-qwik/dist/\n if-no-files-found: error\n\n ############ BUILD INSIGHTS ############\n build-insights:\n if: always() && needs.changes.outputs.build-insights == 'true'\n name: Build Insights\n needs:\n - changes\n - build-other-packages\n runs-on: ubuntu-latest\n\n steps:\n - name: Verify build-other-packages\n if: needs.build-other-packages.result != 'success'\n run: exit 1\n\n - name: Checkout\n uses: actions/checkout@v5\n\n - name: Download Build Artifacts\n uses: actions/download-artifact@v4\n\n - name: Move Distribution Artifacts\n run: |\n mv artifact-qwik/* packages/qwik/\n mkdir -p packages/qwik-city/lib/\n mv artifact-qwikcity/* packages/qwik-city/lib/\n mkdir -p packages/create-qwik/dist/\n mv artifact-create-qwik/* packages/create-qwik/dist/\n mkdir -p packages/eslint-plugin-qwik/dist/\n mv artifact-eslint-plugin-qwik/* packages/eslint-plugin-qwik/dist/\n mv artifact-qwiklabs/lib packages/qwik-labs/lib\n mv artifact-qwiklabs/vite packages/qwik-labs/vite\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - run: pnpm install --frozen-lockfile\n - name: Build Qwik Insights\n run: pnpm run build.packages.insights\n\n - name: Save Insights Cache\n uses: actions/cache/save@v4\n with:\n key: ${{ needs.changes.outputs.hash-insights }}\n path: |\n packages/insights/dist\n packages/insights/.netlify\n\n ############ BUILD DOCS ############\n build-docs:\n if: always() && needs.changes.outputs.build-docs == 'true'\n name: Build Docs\n needs:\n - changes\n - build-other-packages\n runs-on: ubuntu-latest\n\n steps:\n - name: Verify build-other-packages\n if: needs.build-other-packages.result != 'success'\n run: exit 1\n\n - name: Checkout\n uses: actions/checkout@v5\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - name: Download Build Artifacts\n uses: actions/download-artifact@v4\n\n - name: Move Distribution Artifacts\n run: |\n mv artifact-qwik/* packages/qwik/\n mkdir -p packages/qwik-city/lib/\n mv artifact-qwikcity/* packages/qwik-city/lib/\n mkdir -p packages/create-qwik/dist/\n mv artifact-create-qwik/* packages/create-qwik/dist/\n mkdir -p packages/eslint-plugin-qwik/dist/\n mv artifact-eslint-plugin-qwik/* packages/eslint-plugin-qwik/dist/\n mv artifact-qwiklabs/lib packages/qwik-labs/lib\n mv artifact-qwiklabs/vite packages/qwik-labs/vite\n mv artifact-qwikreact/lib packages/qwik-react/lib\n\n - run: pnpm install --frozen-lockfile\n - name: Build Qwik Docs\n run: pnpm run build.packages.docs && echo ok > docs-build-completed.txt\n\n - name: Save Docs Artifacts\n uses: actions/upload-artifact@v4\n with:\n name: artifact-docs\n include-hidden-files: true\n path: |\n packages/docs/dist\n packages/docs/server\n\n - name: Save Docs Cache\n uses: actions/cache/save@v4\n with:\n key: ${{ needs.changes.outputs.hash-docs }}\n path: docs-build-completed.txt\n\n ############ UNIT TEST ############\n test-unit:\n name: Unit Tests\n if: always() && needs.changes.outputs.build-unit == 'true'\n runs-on: ubuntu-latest\n needs:\n - changes\n - build-other-packages\n\n steps:\n - name: Verify build-other-packages\n if: needs.build-other-packages.result != 'success'\n run: exit 1\n\n - name: Checkout\n uses: actions/checkout@v5\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - name: Download Build Artifacts\n uses: actions/download-artifact@v4\n\n - name: Move Distribution Artifacts\n run: |\n mv artifact-qwik/* packages/qwik/\n mkdir -p packages/qwik-city/lib/\n mv artifact-qwikcity/* packages/qwik-city/lib/\n mkdir -p packages/create-qwik/dist/\n mv artifact-create-qwik/* packages/create-qwik/dist/\n mkdir -p packages/eslint-plugin-qwik/dist/\n mv artifact-eslint-plugin-qwik/* packages/eslint-plugin-qwik/dist/\n\n - run: pnpm install --frozen-lockfile\n\n - name: Unit Tests\n run: pnpm run test.unit && echo ok > unit-tests-completed.txt\n\n - name: Save unit tests cache\n uses: actions/cache/save@v4\n with:\n key: ${{ needs.changes.outputs.hash-unit }}\n path: unit-tests-completed.txt\n\n ############ E2E TEST ############\n test-e2e:\n # Sometimes the tests just hang\n timeout-minutes: 20\n name: E2E Tests\n if: always() && needs.changes.outputs.build-e2e == 'true'\n\n needs:\n - build-other-packages\n - changes\n - test-unit\n\n strategy:\n matrix:\n settings:\n - host: ubuntu-latest\n browser: chromium\n # too slow and flaky. Perhaps better in v2?\n # - host: ubuntu-latest\n # browser: firefox\n - host: macos-latest\n browser: webkit\n - host: windows-latest\n browser: chromium\n\n runs-on: ${{ matrix.settings.host }}\n\n steps:\n - name: Checkout\n uses: actions/checkout@v5\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - name: Download Build Artifacts\n uses: actions/download-artifact@v4\n\n - name: Move Distribution Artifacts\n run: |\n mv artifact-qwik/* packages/qwik/\n mkdir -p packages/qwik-city/lib/\n mv artifact-qwikcity/* packages/qwik-city/lib/\n mkdir -p packages/create-qwik/dist/\n mv artifact-create-qwik/* packages/create-qwik/dist/\n mkdir -p packages/eslint-plugin-qwik/dist/\n mv artifact-eslint-plugin-qwik/* packages/eslint-plugin-qwik/dist/\n mkdir -p packages/qwik-react/lib/\n mv artifact-qwikreact/lib/* packages/qwik-react/lib/\n\n - run: pnpm install --frozen-lockfile\n\n - name: Install Playwright\n run: npx playwright install ${{ matrix.settings.browser }} --with-deps\n\n - name: Playwright E2E Tests\n run: pnpm run test.e2e.${{ matrix.settings.browser }} --timeout 60000 --retries 7 --workers 1\n\n - name: Playwright E2E Integration Tests\n run: pnpm run test.e2e.integrations.${{ matrix.settings.browser }} --timeout 60000 --retries 7 --workers 1\n\n - name: Playwright E2E Qwik React Tests\n run: pnpm run test.e2e.qwik-react.${{ matrix.settings.browser }} --timeout 60000 --retries 7 --workers 1\n\n - name: Validate Create Qwik Cli\n if: matrix.settings.host != 'windows-latest'\n run: pnpm cli.validate\n\n ############ E2E CLI TEST ############\n test-cli-e2e:\n name: E2E CLI Tests\n if: always() && needs.changes.outputs.build-cli-e2e == 'true'\n\n needs:\n - build-other-packages\n - changes\n - test-unit\n\n strategy:\n matrix:\n settings:\n - host: ubuntu-latest\n - host: macos-latest\n - host: windows-latest\n\n runs-on: ${{ matrix.settings.host }}\n\n steps:\n - name: Checkout\n uses: actions/checkout@v5\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - name: Download Build Artifacts\n uses: actions/download-artifact@v4\n\n - name: Move Distribution Artifacts\n run: |\n mv artifact-qwik/* packages/qwik/\n mkdir -p packages/qwik-city/lib/\n mv artifact-qwikcity/* packages/qwik-city/lib/\n mkdir -p packages/create-qwik/dist/\n mv artifact-create-qwik/* packages/create-qwik/dist/\n mkdir -p packages/eslint-plugin-qwik/dist/\n mv artifact-eslint-plugin-qwik/* packages/eslint-plugin-qwik/dist/\n\n - run: pnpm install --frozen-lockfile\n\n - name: CLI E2E Tests\n run: pnpm run test.e2e.cli\n\n ########### LINT PACKAGES ############\n lint-package:\n name: Lint Package\n runs-on: ubuntu-latest\n steps:\n - name: Checkout\n uses: actions/checkout@v5\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - run: pnpm install --frozen-lockfile\n\n - name: SyncPack Check\n if: always()\n run: pnpm run lint.syncpack\n\n - name: Prettier Check\n if: always()\n run: pnpm run lint.prettier\n\n - name: Build ESLint\n if: always()\n run: pnpm build --eslint\n\n - name: ESLint Check\n if: always()\n run: pnpm run lint.eslint\n\n ############ RELEASE ############\n release:\n name: Release\n runs-on: ubuntu-latest\n\n needs:\n - changes\n - test-unit\n - test-e2e\n - test-cli-e2e\n # test-unit runs when any packages changes, so we have to release\n # on \"upcoming\", we always check if we have something to release\n # don't run on forks\n if: |\n always() && \n github.repository == 'QwikDev/qwik' && (\n github.ref == 'refs/heads/upcoming' ||\n needs.test-unit.result == 'success' || \n needs.test-unit.result == 'skipped'\n )\n\n steps:\n - name: Verify test-e2e\n if: needs.test-e2e.result != 'skipped'\n run: |\n if [ \"${{ needs.test-e2e.result }}\" != success ] ; then\n exit 1\n else\n echo ok > e2e-tests-completed.txt\n fi\n - name: Save e2e tests cache\n if: needs.test-e2e.result != 'skipped'\n uses: actions/cache/save@v4\n with:\n key: ${{ needs.changes.outputs.hash-e2e }}\n path: e2e-tests-completed.txt\n\n - name: Verify test-cli-e2e\n if: needs.test-cli-e2e.result != 'skipped'\n run: |\n if [ \"${{ needs.test-cli-e2e.result }}\" != success ] ; then\n exit 1\n else\n echo ok > cli-e2e-tests-completed.txt\n fi\n - name: Save cli-e2e tests cache\n if: needs.test-cli-e2e.result != 'skipped'\n uses: actions/cache/save@v4\n with:\n key: ${{ needs.changes.outputs.hash-cli-e2e }}\n path: cli-e2e-tests-completed.txt\n\n - name: Checkout\n uses: actions/checkout@v5\n\n - uses: pnpm/action-setup@v4\n - name: Setup Node\n uses: actions/setup-node@v5\n with:\n node-version: 24.x\n cache: 'pnpm'\n registry-url: https://registry.npmjs.org/\n\n - name: Download Build Artifacts\n uses: actions/download-artifact@v4\n\n - name: Move Distribution Artifacts\n run: |\n mv artifact-qwik/* packages/qwik/\n mkdir -p packages/qwik-city/lib/\n mv artifact-qwikcity/* packages/qwik-city/lib/\n mkdir -p packages/create-qwik/dist/\n mv artifact-create-qwik/* packages/create-qwik/dist/\n mkdir -p packages/eslint-plugin-qwik/dist/\n mv artifact-eslint-plugin-qwik/* packages/eslint-plugin-qwik/dist/\n mv artifact-qwiklabs/lib packages/qwik-labs/lib\n mv artifact-qwiklabs/vite packages/qwik-labs/vite\n mv artifact-qwikreact/lib packages/qwik-react/lib\n rm -rf artifact-*\n\n - run: pnpm install --frozen-lockfile\n\n # Do this before other release steps to avoid\n # publishing temporary files\n - name: Create Release Pull Request or Publish to npm\n if: github.ref == 'refs/heads/upcoming'\n id: changesets\n uses: changesets/action@v1\n with:\n publish: pnpm release\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n - name: Fixup package.json files\n run: pnpm run release.fixup-package-json\n\n - name: Commit Build Artifacts\n if: github.event_name == 'push'\n env:\n QWIK_API_TOKEN_GITHUB: ${{ secrets.QWIK_API_TOKEN_GITHUB }}\n run: pnpm run qwik-push-build-repos\n\n - name: Publish packages for testing\n if: github.event_name != 'workflow_dispatch'\n run: pnpm release.pkg-pr-new\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n ############ TRIGGER QWIKCITY E2E TEST ############\n trigger-qwikcity-e2e:\n name: Trigger Qwik City E2E\n runs-on: ubuntu-latest\n if: github.ref == 'refs/heads/upcoming'\n\n needs:\n - changes\n - release\n\n steps:\n - name: Repository Dispatch\n uses: peter-evans/repository-dispatch@v2\n with:\n token: ${{ secrets.QWIK_API_TOKEN_GITHUB }}\n repository: builderIO/qwik-city-e2e\n event-type: main-updated\n\n ############ Everything is fine ############\n requirements-passed:\n name: All requirements are met\n runs-on: ubuntu-latest\n needs:\n - test-unit\n - test-e2e\n - test-cli-e2e\n - lint-package\n - build-docs\n - build-insights\n if: always()\n steps:\n - name: check status\n if: |\n !(\n (needs.test-unit.result == 'success' || needs.test-unit.result == 'skipped') &&\n (needs.test-e2e.result == 'success' || needs.test-e2e.result == 'skipped') &&\n (needs.test-cli-e2e.result == 'success' || needs.test-cli-e2e.result == 'skipped') &&\n (needs.lint-package.result == 'success' || needs.lint-package.result == 'skipped') &&\n (needs.build-docs.result == 'success' || needs.build-docs.result == 'skipped') &&\n (needs.build-insights.result == 'success' || needs.build-insights.result == 'skipped')\n )\n run: exit 1\n" }, { "path": ".github/workflows/closing-issues.yml", "content": "name: Closing Issues For Inactivity\n\non:\n schedule:\n - cron: '0 0 * * *'\n\njobs:\n close-issues:\n if: github.repository == 'QwikDev/qwik'\n runs-on: ubuntu-latest\n steps:\n - name: needs reproduction\n uses: actions-cool/issues-helper@v3\n with:\n actions: 'close-issues'\n token: ${{ secrets.GITHUB_TOKEN }}\n labels: 'STATUS-2: needs reproduction'\n inactive-day: 14\n\n - name: missing info\n uses: actions-cool/issues-helper@v3\n with:\n actions: 'close-issues'\n token: ${{ secrets.GITHUB_TOKEN }}\n labels: 'STATUS-2: missing info'\n inactive-day: 14\n" }, { "path": ".github/workflows/deploy-docs.yml", "content": "# a workflow that runs after the \"Qwik CI\" workflow is successful\n# and deploys the documentation to CloudFlare Pages.\n\nname: Deploy Docs\n\non:\n workflow_run:\n workflows: ['Qwik CI']\n types:\n - completed\n\npermissions:\n actions: read\n deployments: write\n contents: read\n pull-requests: write\n\njobs:\n deploy:\n name: Cloudflare Pages Deployment\n if: >\n github.repository == 'QwikDev/qwik'\n runs-on: ubuntu-latest\n steps:\n - name: Check for docs artifact\n id: check-artifact\n uses: actions/github-script@v7\n with:\n retries: 3\n script: |\n try {\n const artifacts = await github.rest.actions.listWorkflowRunArtifacts({\n owner: context.repo.owner,\n repo: context.repo.repo,\n run_id: context.payload.workflow_run.id\n });\n const hasDocsArtifact = artifacts.data.artifacts.some(a => a.name === 'artifact-docs');\n core.setOutput('has-docs', hasDocsArtifact);\n } catch (error) {\n console.error('Error checking for artifacts:', error);\n core.setOutput('has-docs', false);\n }\n\n - name: Checkout code\n if: ${{ steps.check-artifact.outputs.has-docs == 'true' }}\n uses: actions/checkout@v5\n\n - name: Download docs artifact\n if: ${{ steps.check-artifact.outputs.has-docs == 'true' }}\n uses: actions/download-artifact@v4\n with:\n name: artifact-docs\n github-token: ${{ secrets.GITHUB_TOKEN }}\n run-id: ${{ github.event.workflow_run.id }}\n path: packages/docs\n\n - name: Verify dist directory exists\n if: ${{ steps.check-artifact.outputs.has-docs == 'true' }}\n run: |\n ls -la packages/docs\n if [ ! -d \"packages/docs/dist\" ]; then\n echo \"Creating dist directory\"\n mkdir -p packages/docs/dist\n cp -r packages/docs/* packages/docs/dist/ || true\n fi\n\n # not the official version, so be careful when updating\n - name: Deploy to Cloudflare Pages\n if: ${{ steps.check-artifact.outputs.has-docs == 'true' }}\n uses: AdrianGonz97/refined-cf-pages-action@6c0d47ff7c97c48fa702b6d9f71f7e3a7c30c7d8\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n projectName: 'qwik-docs'\n directory: packages/docs/dist\n githubToken: ${{ secrets.GITHUB_TOKEN }}\n\n - name: Skip message when no docs artifact\n if: ${{ steps.check-artifact.outputs.has-docs != 'true' }}\n run: echo \"No docs artifact found, skipping deployment\"\n" }, { "path": ".github/workflows/labeling-issues.yml", "content": "name: Labling Issues\n\non:\n issues:\n types: [labeled]\n\njobs:\n handle-labeled:\n if: github.repository == 'QwikDev/qwik'\n runs-on: ubuntu-latest\n\n steps:\n - name: ensure STATUS-1 label is present\n id: status-1-label-presence\n # GH's built-in functions do not allow to search for array values that start with something, so we're using node for this\n run: |\n echo present=$( \n node -e '\n const labels = JSON.parse(`${{ toJSON(github.event.issue.labels.*.name) }}`);\n console.log(labels.some(l => l.startsWith(\"STATUS-1:\")));\n ' \n ) >> $GITHUB_OUTPUT\n - name: remove needs triage\n if: steps.status-1-label-presence.outputs.present == 'true' && (contains(github.event.label.name, 'STATUS-2:') || contains(github.event.label.name, 'STATUS-3:'))\n uses: actions-cool/issues-helper@v3\n with:\n actions: 'remove-labels'\n token: ${{ secrets.GITHUB_TOKEN }}\n issue-number: ${{ github.event.issue.number }}\n labels: 'STATUS-1: needs triage'\n\n - name: needs reproduction time limit\n if: contains(github.event.label.name, 'needs reproduction')\n uses: actions-cool/issues-helper@v3\n with:\n actions: 'create-comment'\n token: ${{ secrets.GITHUB_TOKEN }}\n issue-number: ${{ github.event.issue.number }}\n body: |\n Hello @${{ github.event.issue.user.login }}. Please provide a [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) using a GitHub repository or [StackBlitz](https://qwik.new). \n [Here](https://antfu.me/posts/why-reproductions-are-required#why-reproduction) is why we really need a minimal reproduction. \n Issues marked with `needs reproduction` will be automatically closed if they have no activity within 14 days.\n Thanks 🙏\n\n - name: missing info time limit\n if: contains(github.event.label.name, 'missing info')\n uses: actions-cool/issues-helper@v3\n with:\n actions: 'create-comment'\n token: ${{ secrets.GITHUB_TOKEN }}\n issue-number: ${{ github.event.issue.number }}\n body: |\n Hello @${{ github.event.issue.user.login }}. Please provide the missing information requested above. \n Issues marked with `missing info` will be automatically closed if they have no activity within 14 days.\n Thanks 🙏\n" }, { "path": ".gitignore", "content": "# Keep \"OS\" and \"IDE and local environment\" ignores on your local machine in user home\n# git config --global core.excludesFile ~/.gitignore\n# https://git-scm.com/docs/gitignore\n\n# OS\n**/.DS_Store\netc\ntemp\n.history\n.lh\n*.\n**/*.log\n*.node\n\n# Application\nqwik-app/\n/server/\n/starters/**/server/\n/packages/*/server/\n!/packages/qwik/server/\n/packages/*/src/styled-system/\ntodo-express/\ntarget\n!/packages/docs/src/routes/demo/events/target\nsrc/napi/package-*\n\n# Node\nnode_modules\n\n# Artifacts\ntsc-out\ndist\ndist-dev\nexternal\nlib\ntsdoc-metadata.json\npackages/qwik/bindings\n\n# IDE and local environment\n.idea\n.eslintcache\ntest-results\n.direnv\n\n# Package Managers\n.yarn/*\n!.yarn/releases\n.pnpm-store/*\n\n# Local Netlify folder\n.netlify\nsandbox\n\n# AI tools\n.planning\n\n# We need to ignore this because \"changesets\" will try to replace it\n/CHANGELOG.md" }, { "path": ".node-version", "content": "24\n" }, { "path": ".nvmrc", "content": "24\n" }, { "path": ".prettierignore", "content": "**/**.api.md\n**/*.log\n**/.DS_Store\n*.\npnpm-lock.yaml\n.*\n!.eslintrc.cjs\n!.prettierignore\n!.prettierrc.json\n\n# Build output\ndist\ndist-dev\nlib\ntarget\nstarters/apps/**/dist\nnode_modules\n\ntsconfig.tsbuildinfo\n\n# REPL files\npackages/docs/public/repl/repl-sw.js*\n\n# build output\npackages/*/lib\npackages/*/dist\npackages/*/server\n\n# API output files\npackages/docs/src/routes/api\n\n# Prettier doesn't handle mdx files well\npackages/docs/**/*.mdx\n\npackages/insights/drizzle\npackages/insights/.netlify\npackages/insights/scripts\npackages/insights/**/*.gen.d.ts\npackages/qwik-labs/lib-types\npackages/qwik-labs/vite\n\n# insights cache files\n**/q-insights.json\n\n# Exclude builder js files from formatting - delete after migration\npackages/docs/public/builder\n" }, { "path": ".prettierrc.json", "content": "{\n \"plugins\": [\"./node_modules/prettier-plugin-jsdoc/dist/index.js\"],\n \"jsdocPreferCodeFences\": true,\n \"tsdoc\": true,\n \"trailingComma\": \"es5\",\n \"tabWidth\": 2,\n \"semi\": true,\n \"singleQuote\": true,\n \"printWidth\": 100,\n \"useTabs\": false\n}\n" }, { "path": ".vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"dbaeumer.vscode-eslint\",\n \"unifiedjs.vscode-mdx\",\n \"esbenp.prettier-vscode\",\n \"ms-playwright.playwright\",\n \"rust-lang.rust-analyzer\",\n \"ms-azuretools.vscode-docker\",\n \"manucorporat.vermoji\",\n \"vadimcn.vscode-lldb\",\n \"streetsidesoftware.code-spell-checker\",\n \"vitest.explorer\"\n ],\n \"unwantedRecommendations\": []\n}\n" }, { "path": ".vscode/launch.json", "content": "{\n // Use IntelliSense to learn about possible attributes.\n // Hover to view descriptions of existing attributes.\n // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387\n \"version\": \"0.2.0\",\n \"configurations\": [\n {\n \"type\": \"node\",\n \"name\": \"docs dev.debug\",\n \"request\": \"launch\",\n \"skipFiles\": [\"/**\"],\n \"cwd\": \"${workspaceFolder}/packages/docs\",\n \"program\": \"${workspaceFolder}/packages/docs/node_modules/vite/bin/vite.js\",\n \"args\": [\"--mode\", \"ssr\", \"--force\"]\n },\n {\n \"type\": \"node\",\n \"name\": \"insights dev.debug\",\n \"request\": \"launch\",\n \"skipFiles\": [\"/**\"],\n \"cwd\": \"${workspaceFolder}/packages/insights\",\n \"program\": \"${workspaceFolder}/packages/insights/node_modules/vite/bin/vite.js\",\n \"args\": [\"--mode\", \"ssr\", \"--force\"]\n },\n {\n \"type\": \"node\",\n \"name\": \"docs build.client\",\n \"request\": \"launch\",\n \"skipFiles\": [\"/**\"],\n \"cwd\": \"${workspaceFolder}/packages/docs\",\n \"program\": \"${workspaceFolder}/packages/docs/node_modules/vite/bin/vite.js\",\n \"args\": [\"build\"]\n },\n {\n \"type\": \"node\",\n \"name\": \"docs build.server\",\n \"request\": \"launch\",\n \"skipFiles\": [\"/**\"],\n \"cwd\": \"${workspaceFolder}/packages/docs\",\n \"program\": \"${workspaceFolder}/packages/docs/node_modules/vite/bin/vite.js\",\n \"args\": [\"build\", \"-c\", \"adapters/cloudflare-pages/vite.config.mts\"]\n },\n {\n \"type\": \"node\",\n \"name\": \"preloader-test build.client\",\n \"request\": \"launch\",\n \"runtimeExecutable\": \"pnpm\",\n \"runtimeArgs\": [\n \"run\",\n \"build.client\"\n ],\n \"skipFiles\": [\"/**\"],\n \"cwd\": \"${workspaceFolder}/starters/apps/preloader-test\"\n },\n {\n \"type\": \"node\",\n \"name\": \"e2e.test\",\n \"request\": \"launch\",\n \"console\": \"integratedTerminal\",\n \"internalConsoleOptions\": \"neverOpen\",\n \"program\": \"${workspaceFolder}/./node_modules/tsm/bin.js\",\n \"cwd\": \"${workspaceFolder}\",\n \"args\": [\"./starters/dev-server.ts\", \"3301\"]\n },\n {\n \"type\": \"node\",\n \"name\": \"vitest\",\n \"request\": \"launch\",\n \"console\": \"integratedTerminal\",\n \"internalConsoleOptions\": \"neverOpen\",\n \"program\": \"${workspaceFolder}/./node_modules/vitest/vitest.mjs\",\n \"cwd\": \"${workspaceFolder}\",\n \"args\": [\"${file}\"]\n }\n ]\n}\n" }, { "path": ".vscode/qwik.code-snippets", "content": "{\n \"Qwik component\": {\n \"scope\": \"typescriptreact\",\n \"prefix\": \"q:component w/props\",\n \"description\": \"Qwik component w/ props\",\n \"body\": [\n \"export interface ${1:${TM_FILENAME_BASE/(.*)/${1:/capitalize}/}}Props {\",\n \" $2\",\n \"}\",\n \"\",\n \"export const $1 = component$((props: $1Props) => {\",\n \" const state = useStore({\",\n \" $3\",\n \" });\",\n \" \",\n \" return <${4:button} on${5:Click}$={(${6:e}) => {$7}}>$8\",\n \"});\",\n ],\n },\n \"Qwik component (simple)\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:component simple\",\n \"description\": \"Simple Qwik component\",\n \"body\": [\n \"export const ${1:${TM_FILENAME_BASE/(.*)/${1:/capitalize}/}} = component$(() => {\",\n \" return <${2:button}>$4\",\n \"});\",\n ],\n },\n \"Qwik state\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:useStore$\",\n \"description\": \"useStore() declaration\",\n \"body\": [\"const ${1:state} = useStore({\", \" $2\", \"});\", \"$0\"],\n },\n \"Qwik signal\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:useSignal\",\n \"description\": \"useSignal() declaration\",\n \"body\": [\"const ${1:signal} = useSignal($2);\", \"$0\"],\n },\n \"$ hook\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:$\",\n \"description\": \"$() function hook\",\n \"body\": [\"$(() => {\", \" $0\", \"});\", \"\"],\n },\n \"useVisibleTask\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:useVisibleTask\",\n \"description\": \"useVisibleTask$() function hook\",\n \"body\": [\"useVisibleTask$(({ track }) => {\", \" $0\", \"});\", \"\"],\n },\n \"useTask\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:useTask\",\n \"description\": \"useTask$() function hook\",\n \"body\": [\"useTask$(({ track }) => {\", \" track(() => $1);\", \" $0\", \"});\", \"\"],\n },\n \"useResource\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:useResource$\",\n \"description\": \"useResource$() declaration\",\n \"body\": [\"const $1 = useResource$(({ track, previous, cleanup }) => {\", \" $0\", \"});\", \"\"],\n },\n \"useOn\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:useOn\",\n \"description\": \"useOn declaration\",\n \"body\": [\"useOn(\", \"'$1',\", \"$((event) => {\", \" const { $3 } = event as $2;\", \" })\", \");\"],\n },\n \"useOnDocument\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:useOnDocument\",\n \"description\": \"useOnDocument declaration\",\n \"body\": [\n \"useOnDocument(\",\n \"'$1',\",\n \"$((event) => {\",\n \" const { $3 } = event as $2;\",\n \" })\",\n \");\",\n ],\n },\n \"useOnWindow\": {\n \"scope\": \"javascriptreact,typescriptreact\",\n \"prefix\": \"q:useOnWindow\",\n \"description\": \"useOnWindow declaration\",\n \"body\": [\n \"useOnWindow(\",\n \"'$1',\",\n \"$((event) => {\",\n \" const { $3 } = event as $2;\",\n \" })\",\n \");\",\n ],\n },\n}\n" }, { "path": ".vscode/settings.json", "content": "{\n \"vitest.include\": [\"**/*.unit.{js,mjs,cjs,ts,mts,cts,jsx,tsx}\"],\n \"vitest.exclude\": [\n \"**/node_modules/**\",\n \"**/dist/**\",\n \"**/dist-dev/**\",\n \"**/cypress/**\",\n \"**/.{idea,git,cache,output,temp}/**\"\n ],\n \"javascript.preferences.autoImportFileExcludePatterns\": [\"node:test\"],\n \"typescript.preferences.preferTypeOnlyAutoImports\": true,\n \"typescript.tsdk\": \"./node_modules/typescript/lib\",\n \"typescript.enablePromptUseWorkspaceTsdk\": true\n}\n" }, { "path": "@types/bun.d.ts", "content": "declare const Bun: {\n fileURLToPath: (url: string) => string;\n env: any;\n file: (path: string) => {\n text: () => Promise;\n stream: () => Promise>;\n };\n};\n" }, { "path": "@types/deno.d.ts", "content": "declare module 'https://deno.land/std/path/mod.ts' {\n export function extname(paths: string): string;\n export function fromFileUrl(url: string): string;\n export function join(...paths: string[]): string;\n}\n\ninterface FsFile {\n readable: ReadableStream;\n}\ndeclare const Deno: {\n env: any;\n open(path: string, mode: { read: boolean }): Promise;\n readTextFile(path: string): Promise;\n readFile(path: string): Promise;\n version: {\n deno: string;\n };\n};\n" }, { "path": "AGENTS.md", "content": "# Qwik — AI Agent Instructions\n\n> Canonical instruction file for AI coding agents working on the Qwik monorepo.\n> For detailed contributor setup, see [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n## Overview\n\nQwik is a **resumable** web framework — it serializes application state and framework state into HTML during SSR, then resumes on the client without re-executing component code. This enables it to stream javascript (a.k.a javascript streaming). There’s no waiting for the entire code to be downloaded (a.k.a hydration). The developer can write code very similar to other reactive frameworks; the app is automatically instant, regardless the amount of javascript.\n\n**Key concepts:** Resumability, QRLs (lazy-loading primitives), the `$` suffix transform, fine-grained signals, and the Rust-based optimizer.\n\n## Monorepo Layout\n\n| Package | Path | Description |\n| ------------------------- | ----------------------------- | ---------------------------------------------- |\n| `@builder.io/qwik` | `packages/qwik` | Core framework (runtime + optimizer) |\n| `@builder.io/qwik-city` | `packages/qwik-city` | Meta-framework (routing, middleware, adapters) |\n| `@builder.io/qwik-react` | `packages/qwik-react` | React integration layer |\n| `@builder.io/qwik-auth` | `packages/qwik-auth` | Auth.js integration |\n| `@builder.io/qwik-dom` | `packages/qwik-dom` | Server-side DOM implementation |\n| `@builder.io/qwik-worker` | `packages/qwik-worker` | Web Worker support (experimental) |\n| `@builder.io/qwik-labs` | `packages/qwik-labs` | Experimental features (private) |\n| `eslint-plugin-qwik` | `packages/eslint-plugin-qwik` | ESLint rules for Qwik |\n| `create-qwik` | `packages/create-qwik` | Project scaffolding CLI |\n| `qwik-docs` | `packages/docs` | Documentation site (private) |\n| `insights` | `packages/insights` | Analytics dashboard (private) |\n\n## Setup\n\n**Requirements:** Node ≥22.18.0, pnpm ≥10.14.0\n\n```bash\npnpm install\npnpm build.local # builds everything without Rust (copies optimizer from npm)\n```\n\nUse `pnpm build.full` only if you modified Rust/optimizer code.\n\nPrefer `pnpm build --qwik --qwikcity --dev` to build qwik and qwik-city faster.\n\n## Key Commands\n\n| Task | Command | Notes |\n| ------------------------ | ------------------------ | ------------------------------------------- |\n| **Install** | `pnpm install` | |\n| **Install** | `pnpm install` | |\n| **Build (no Rust)** | `pnpm build.local` | For a fresh start |\n| **Build (with Rust)** | `pnpm build.full` | Only for optimizer changes |\n| **Build core only** | `pnpm build.core` | Fast — just Qwik + Qwik City + types |\n| **Watch mode** | `pnpm build.watch` | Rebuilds on change |\n| **Unit tests** | `pnpm test.unit` | Vitest — runs `packages/**/*.unit.{ts,tsx}` |\n| **E2E tests (Chromium)** | `pnpm test.e2e.chromium` | Playwright |\n| **E2E tests (City)** | `pnpm test.e2e.city` | Qwik City–specific E2E |\n| **Lint** | `pnpm lint` | ESLint + Prettier + Rust lint |\n| **Lint fix** | `pnpm lint.fix` | Auto-fix ESLint issues |\n| **Format** | `pnpm fmt` | Prettier + syncpack |\n| **Type check** | `pnpm tsc.check` | Full TypeScript check |\n| **Update API docs** | `pnpm api.update` | Regenerates public API `.md` files |\n| **Create changeset** | `pnpm change` | Interactive — creates `.changeset/*.md` |\n| **Dev server** | `pnpm serve` | Port 3300 |\n| **Docs dev** | `pnpm docs.dev` | Documentation site |\n\n### Running a Single Test File\n\n```bash\n# Unit test — single file\npnpm vitest run packages/qwik/src/core/qrl/qrl.unit.ts\n\n# E2E test — single file\npnpm playwright test starters/e2e/e2e.events.spec.ts --project chromium\n```\n\n## Architecture Essentials\n\n### Resumability\n\nQwik serializes the full application state into HTML at SSR time. On the client, it **resumes** from that serialized state instead of re-executing components (no hydration). The serialization/deserialization logic lives in `packages/qwik/src/core/container/`.\n\n### QRL & the `$` Transform\n\nA **QRL** (Qwik Resource Locator) is a lazy reference to a closure. Any function ending with `$` (e.g., `component$`, `useTask$`, `$()`) creates a QRL boundary — the optimizer extracts these into separate chunks for lazy loading.\n\n- QRL implementation: `packages/qwik/src/core/qrl/`\n- The Rust optimizer rewrites `$`-suffixed calls at build time\n\n### Signals\n\nFine-grained reactivity system. Signals track subscriptions and update only the DOM nodes or tasks that read them — no virtual DOM diffing.\n\n- Implementation: `packages/qwik/src/core/state/signal.ts`\n- Stores (proxy-based deep reactivity): `packages/qwik/src/core/state/store.ts`\n\n### Optimizer (Rust)\n\nThe optimizer is a Rust-based compiler plugin (SWC transform) that:\n\n1. Extracts `$`-suffixed closures into separate entry points\n2. Captures lexical scope for serialization\n3. Generates manifest metadata for prefetching\n\n- Rust source: `packages/qwik/src/optimizer/core/`\n- WASM build: `packages/qwik/src/wasm/`\n- Native bindings: `packages/qwik/src/napi/`\n\n### Qwik City (Meta-framework)\n\nQwik City provides file-based routing, data loaders (`routeLoader$`), actions (`routeAction$`), middleware, and server adapters.\n\n- Runtime: `packages/qwik-city/src/runtime/`\n- Build tooling: `packages/qwik-city/src/buildtime/`\n- Adapters: `packages/qwik-city/src/adapters/`\n\n## Code Style\n\n**Config:** Prettier (`.prettierrc.json`) + ESLint 9 flat config (`eslint.config.js`)\n\n| Rule | Setting |\n| -------------- | -------------------------- |\n| Semi | `true` |\n| Quotes | Single |\n| Print width | 100 |\n| Tabs | Spaces (2) |\n| Trailing comma | ES5 |\n| `no-console` | Error (warn/error allowed) |\n| `curly` | Always required |\n\n### Naming Conventions\n\n| Pattern | Usage | Example |\n| -------------- | ------------------------------------------------- | ----------------------------------- |\n| `use*` | Hooks (must be called in component or task scope) | `useSignal`, `useStore`, `useTask$` |\n| `*$` | QRL boundary — optimizer extracts the closure | `component$`, `routeLoader$` |\n| `create*` | Factory functions | `createDOM`, `createContextId` |\n| `*.unit.ts(x)` | Unit test files | `qrl.unit.ts` |\n| `*.spec.ts` | E2E test files | `e2e.events.spec.ts` |\n\n## Testing\n\n### Unit Tests (Vitest)\n\n- File pattern: `*.unit.ts` / `*.unit.tsx`\n- Config: `vitest.config.ts` (root)\n- Run all: `pnpm test.unit`\n- Run one: `pnpm vitest run `\n- Server-side DOM helper: `createDOM()` from `@builder.io/qwik/testing`\n\n### E2E Tests (Playwright)\n\n- File pattern: `*.spec.ts` in `starters/e2e/`\n- Config: `starters/playwright.config.ts`\n- Run: `pnpm test.e2e.chromium`\n- Run one: `pnpm playwright test --project chromium`\n- Additional E2E suites: `e2e/adapters-e2e/`, `e2e/docs-e2e/`, `e2e/qwik-react-e2e/`\n\n### Rust Tests\n\n- Run: `pnpm test.rust` (or `make test`)\n- Update snapshots: `pnpm test.rust.update` (or `make test-update`)\n\n## Git Workflow\n\n### Commit Convention\n\n```\ntype(scope): description\n```\n\nTypes: `feat`, `fix`, `docs`, `lint`, `refactor`, `perf`, `test`, `chore`\n\n- Use imperative mood (\"add feature\" not \"added feature\")\n- No trailing period\n- Scope is optional but encouraged (e.g., `fix(qwik-city): ...`)\n\n### Changesets\n\nIf your change affects published packages, create a changeset:\n\n```bash\npnpm change\n```\n\nThis creates a `.changeset/*.md` file describing the change. The core packages (`@builder.io/qwik`, `@builder.io/qwik-city`, `eslint-plugin-qwik`, `create-qwik`) are **fixed-versioned** — they always release together.\n\n### Branch Strategy\n\n- **Base branch:** `main` (trunk-based development)\n- PRs target `main`\n- CI runs on all PRs\n\n### Before Pushing a PR\n\n1. `pnpm build.core`\n2. `pnpm test.unit` (run relevant tests)\n3. `pnpm lint`\n4. `pnpm api.update` (if you changed public API)\n5. `pnpm change` (to document patches or new features)\n\n## Boundaries — What NOT to Do\n\n1. **Don't run the full test suite** — Use `pnpm test.unit` or target specific files. The full `pnpm test` runs build + all tests and takes a very long time.\n2. **Don't forget `pnpm api.update`** — If you change any public API, CI will fail without regenerated API docs.\n3. **Don't modify Rust code without rebuilding** — After touching `packages/qwik/src/optimizer/core/`, run `pnpm build.full` (requires Rust toolchain + wasm-pack).\n4. **Don't skip changesets for user-facing changes** — CI checks for changesets on PRs that touch published packages.\n5. **Don't commit `.only` tests** — ESLint rule `no-only-tests` blocks this.\n6. **Don't edit generated files** — Files in `dist/`, `lib/`, and API docs under `packages/docs/` are generated. Edit the source instead.\n" }, { "path": "CLAUDE.md", "content": "@AGENTS.md\n" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nWe as members, contributors, and leaders pledge to make participation in our\ncommunity a harassment-free experience for everyone, regardless of age, body\nsize, visible or invisible disability, ethnicity, sex characteristics, gender\nidentity and expression, level of experience, education, socio-economic status,\nnationality, personal appearance, race, religion, or sexual identity\nand orientation.\n\nWe pledge to act and interact in ways that contribute to an open, welcoming,\ndiverse, inclusive, and healthy community.\n\n## Our Standards\n\nExamples of behavior that contributes to a positive environment for our\ncommunity include:\n\n- Demonstrating empathy and kindness toward other people\n- Being respectful of differing opinions, viewpoints, and experiences\n- Giving and gracefully accepting constructive feedback\n- Accepting responsibility and apologizing to those affected by our mistakes,\n and learning from the experience\n- Focusing on what is best not just for us as individuals, but for the\n overall community\n\nExamples of unacceptable behavior include:\n\n- The use of sexualized language or imagery, and sexual attention or\n advances of any kind\n- Trolling, insulting or derogatory comments, and personal or political attacks\n- Public or private harassment\n- Publishing others' private information, such as a physical or email\n address, without their explicit permission\n- Other conduct which could reasonably be considered inappropriate in a\n professional setting\n\n## Enforcement Responsibilities\n\nCommunity leaders are responsible for clarifying and enforcing our standards of\nacceptable behavior and will take appropriate and fair corrective action in\nresponse to any behavior that they deem inappropriate, threatening, offensive,\nor harmful.\n\nCommunity leaders have the right and responsibility to remove, edit, or reject\ncomments, commits, code, wiki edits, issues, and other contributions that are\nnot aligned to this Code of Conduct, and will communicate reasons for moderation\ndecisions when appropriate.\n\n## Scope\n\nThis Code of Conduct applies within all community spaces, and also applies when\nan individual is officially representing the community in public spaces.\nExamples of representing our community include using an official e-mail address,\nposting via an official social media account, or acting as an appointed\nrepresentative at an online or offline event.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be\nreported to the community leaders responsible for enforcement at\ninfo@builder.io.\nAll complaints will be reviewed and investigated promptly and fairly.\n\nAll community leaders are obligated to respect the privacy and security of the\nreporter of any incident.\n\n## Enforcement Guidelines\n\nCommunity leaders will follow these Community Impact Guidelines in determining\nthe consequences for any action they deem in violation of this Code of Conduct:\n\n### 1. Correction\n\n**Community Impact**: Use of inappropriate language or other behavior deemed\nunprofessional or unwelcome in the community.\n\n**Consequence**: A private, written warning from community leaders, providing\nclarity around the nature of the violation and an explanation of why the\nbehavior was inappropriate. A public apology may be requested.\n\n### 2. Warning\n\n**Community Impact**: A violation through a single incident or series\nof actions.\n\n**Consequence**: A warning with consequences for continued behavior. No\ninteraction with the people involved, including unsolicited interaction with\nthose enforcing the Code of Conduct, for a specified period of time. This\nincludes avoiding interactions in community spaces as well as external channels\nlike social media. Violating these terms may lead to a temporary or\npermanent ban.\n\n### 3. Temporary Ban\n\n**Community Impact**: A serious violation of community standards, including\nsustained inappropriate behavior.\n\n**Consequence**: A temporary ban from any sort of interaction or public\ncommunication with the community for a specified period of time. No public or\nprivate interaction with the people involved, including unsolicited interaction\nwith those enforcing the Code of Conduct, is allowed during this period.\nViolating these terms may lead to a permanent ban.\n\n### 4. Permanent Ban\n\n**Community Impact**: Demonstrating a pattern of violation of community\nstandards, including sustained inappropriate behavior, harassment of an\nindividual, or aggression toward or disparagement of classes of individuals.\n\n**Consequence**: A permanent ban from any sort of public interaction within\nthe community.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage],\nversion 2.0, available at\nhttps://www.contributor-covenant.org/version/2/0/code_of_conduct.html.\n\nCommunity Impact Guidelines were inspired by [Mozilla's code of conduct\nenforcement ladder](https://github.com/mozilla/diversity).\n\n[homepage]: https://www.contributor-covenant.org\n\nFor answers to common questions about this code of conduct, see the FAQ at\nhttps://www.contributor-covenant.org/faq. Translations are available at\nhttps://www.contributor-covenant.org/translations.\n" }, { "path": "CONTINUOUS_BUILD.md", "content": "# Continuous Build Artifacts\n\nThis repo contains build artifacts that are generated as part of the continues build pipeline.\n\nCurrently supported artifacts:\n\n- [`@builder.io/qwik`](https://github.com/QwikDev/qwik-build)\n- [`@builder.io/qwik-city`](https://github.com/QwikDev/qwik-city-build)\n- [`@builder.io/qwik-labs`](https://github.com/QwikDev/qwik-labs-build)\n\nThe build artifact is created if:\n\n- Code is merged to `main` branch\n- Code is merged to `build/*` branch\n\n## How to use\n\nThe build artifacts are useful if you want to:\n\n- Install an un-released change.\n- Bisect which specific commit caused a regression.\n\n## Install specific build artifact\n\nTo install a specific build artifact change you `package.json` like so (not all lines may be needed):\n\n```json\n{\n \"dependencies\": {\n \"@builder.io/qwik\": \"github:QwikDev/qwik-build#SHA\",\n \"@builder.io/qwik-city\": \"github:QwikDev/qwik-city-build#SHA\",\n \"@builder.io/qwik-labs\": \"github:QwikDev/qwik-labs-build#SHA\"\n }\n}\n```\n\nWhere `#SHA` is one of the following:\n\n- `#SHA` - Install a specific build SHA. You can get the SHA from:\n - [`@builder.io/qwik`](https://github.com/QwikDev/qwik-build/commits/) commits\n - [`@builder.io/qwik-city`](https://github.com/QwikDev/qwik-city-build/commits/) commits\n - [`@builder.io/qwik-labs`](https://github.com/QwikDev/qwik-labs-build/commits/) commits\n- `#build/name` (or `#main`) - Install a specific `build/*` (or `#main`) branch:\n - [`@builder.io/qwik`](https://github.com/QwikDev/qwik-build/branches/) branches\n - [`@builder.io/qwik-city`](https://github.com/QwikDev/qwik-city-build/branches/) branches\n - [`@builder.io/qwik-labs`](https://github.com/QwikDev/qwik-labs-build/branches/) branches\n > NOTE: Package managers will treat any SHA in the lock file which is on the branch as valid, and so they will not auto upgrade to the latest. For this reason this is not recommended.\n\n## Bisect for regression\n\nYou can bisect different commits to `main` to determine which specific change has cause the regression.\n\n1. Install latest to get an upper mound\n2. Install oldest known good to get a lower bound\n3. Keep bisecting until you find a specific SHA where the code breaks.\n\nWhen creating the issue please include which SHA has caused the regression.\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing to Qwik\n\nThank you for taking an interest in contributing to Qwik! We appreciate you! 🫶🏽\n\nBelow are the guidelines on how to help in the best possible way.\n\n## Submitting an Issue\n\nBefore creating a new issue, please search through open issues using the [GitHub issue search bar](https://docs.github.com/en/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests). You might find the solution to your problem, or can verify that it is an already known issue.\n\nWe want a bug-free and best-performing project. That's why we take all reported issues to heart. But please be aware that if we can't reproduce the problem, we won't have a way of locating and adequately fixing it.\n\nTherefore, to solve the problem in the best possible way, please create a minimal repository that reproduces the problem with the least possible code explaining and demonstrating the error.\n\nWithout enough information to reproduce the issue, we will close it because we can't recreate and solve it.\n\n## Triaging Issues\n\nIf you're interested in helping out with triaging issues, please follow the [Triaging Guide](./contributing/TRIAGE.md).\n\n## Submitting a Pull Request (PR)\n\n### Branch Organization\n\nWe adopt [trunk-based development](https://trunkbaseddevelopment.com/) therefore all Pull Requests are made against the main branch.\nBefore releasing, we merge `main` into a release branch, for testing purposes.\n\n### Good first issue\n\nThe issues marked with [_Good first issue_](https://github.com/QwikDev/qwik/issues?q=is%3Aissue+is%3Aopen+label%3A%22COMMUNITY%3A++good+first+issue%22) are a good starting point to familiarize yourself with the project.\n\nBefore solving the problem, please check with the maintainers that the issue is still relevant. Feel free to leave a comment on the issue to show your intention to work on it and prevent other people from unintentionally duplicating your effort.\n\n### Sending a Pull Request\n\nBefore submitting a pull request, consider the following guidelines:\n\n- Fork the repository into your own account.\n- In your forked repository, create a new branch: `git checkout -b my-branch main`\n- Make your changes/fixes.\n- Run `pnpm fmt` to lint the code.\n- Add a changeset with `pnpm change` if needed ([follow this tutorial](https://go.screenpal.com/watch/cZivIcVPJQV))\n- Push your branch to GitHub: `git push origin my-branch`\n- In GitHub, send a pull request to `QwikDev:main`.\n\n> If you aren't sure your PR is ready, open it as a [draft](https://github.blog/2019-02-14-introducing-draft-pull-requests/) to make it clear to the maintainer.\n\n### ⚠ Troubleshooting PR build issues on CI\n\nEvery PR is being automatically merged with `main` before the CI Github actions run.\nThat's why if the CI checks aren't passing your PR branch is probably not up to date.\n\n**For non documentation PRs please do the following:**\n\n1. Merge `main` into your PR branch\n2. Run `pnpm api.update`\n3. Run `pnpm build.local` or `pnpm build.full` if you made a change to the Rust code\n4. Commit and push any changes as a result of the above steps\n\n## Local development\n\nThis is the best approach because all required dependencies will be installed in the docker container for you and won't affect your personal configuration in any way.\n\n### Prerequisites\n\nYou need to have these tools up and running in your local machine:\n\n- an editor. We recommend [VSCode](https://code.visualstudio.com/).\n- one of the following:\n - [Nix](https://nixos.org)\n - [Docker](https://www.docker.com/)\n - Locally installed NodeJS v22+ and optionally Rust\n\n#### Nix\n\n[Nix](https://nixos.org/download.html) can be used on macOS and Linux. It keeps installation files in `/nix` and doesn't write anywhere else. It has a declarative configuration in the `flake.nix` file, which describes all the tools needed to build the project.\n\n- Install it on your machine and enable flakes. The [DetSys installer](https://github.com/DeterminateSystems/nix-installer) makes that easy.\n- run `nix develop` in the project root to open a shell with all the tools, or use `direnv` to have them automatically added into your current shell.\n\n##### Nix + Direnv (optional)\n\nYou can additionally use [direnv](https://direnv.net/) to automatically load the dev environment when you enter the project directory.\nThere is also a VSCode plugin for direnv that reloads the extensions so they get environment changes.\nWhen you install direnv, you'll need to allow it once with `direnv allow` in the project root. From then on, when you `cd` into the project, it will automatically have the correct tools installed.\n\n#### Docker\n\n- Install the [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extension in your VSCode.\n- Once installed you will be prompted to 'Reopen the folder to develop in a container [learn more](https://code.visualstudio.com/docs/devcontainers/containers) or Clone repository in Docker volume for [better I/O performance](https://code.visualstudio.com/docs/devcontainers/containers#_quick-start-open-a-git-repository-or-github-pr-in-an-isolated-container-volume)'. If you're not prompted, you can run the `Dev Containers: Open Folder in Container` command from the [VSCode Command Palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette).\n\nAlternatively you can use [devcontainers/cli](https://github.com/devcontainers/cli):\n\n- Install devcontainers following their documentation.\n- In your terminal navigate to the Qwik's project root directory.\n- Then run `devcontainer up --workspace-folder .`. This command will start a Docker container with all required environment dependencies.\n\n> [!TIP]\n> If you are using Podman, be sure to update the [VSCode dev container settings](https://code.visualstudio.com/remote/advancedcontainers/docker-options#_podman). Don't forget to allocate enough resources to the Podman machine to avoid slow builds.\n\n> [!NOTE]\n> You may run into an `EEXISTS` error when the Dev Container runs the \"updateContentCommand\" script. This may happen if pnpm gets installed automatically during the setup process. You can ignore the error because the container will be setup correctly, then run `pnpm install` in the project root once the container is connected and the terminal is available.\n\n> [!CAUTION]\n> The Dev Container may not work on Windows properly due to a difference with Windows container host volume permissions and ownership. It's recommended to use Mac or Linux instead, or configure your environment to build the project without Dev Containers.\n\n##### Using development container without Dev Containers and VSCode\n\nIf you would like to make use of the development container solution, but don't use VSCode or Dev Containers, you still can do so, by following steps:\n\n- Build development container locally: `cd .devcontainer; docker build -t qwik-container .`\n- Run development container from Qwik project root, binding the directory to container: `cd ..; docker run --rm -d --name qwik-container -p 3300:3300 -p 9229:9299 -v $PWD:/home/circleci/project -t qwik-container`\n\nDocker command does:\n\n- Create a new container that is removed once stopped,\n- In daemon mode,\n- With name `qwik-container`,\n- That exposes the ports `3300` and `9229`, and\n- Binds `qwik` project directory to container working directory.\n\n##### Podman extras\n\n> This section is highly influenced by SO answer: https://serverfault.com/a/1075838/352338\n> If you use [Podman](https://podman.io/) instead of Docker as your containers engine, then you need to know the following:\n\n- Container runs as user `circleci` with UID `1001` and GID `1002`.\n- As you are accustomed to using Podman, you will need to append `:Z` to `volumes | -v` parameter so the command becomes:\n\n```bash\n$ subuid_size=65536\n$ subgid_size=65536\n$ container_uid=1001\n$ container_gid=1002\n$ podman run --rm \\\n --user $container_uid:$container_gid \\\n --uidmap=0:1:$container_uid \\\n --uidmap=$((container_uid + 1)):$((container_uid + 1)):$((subuid_size - $container_uid)) \\\n --uidmap=$container_uid:0:1 \\\n --gidmap=0:1:$container_gid \\\n --gidmap=$((container_gid + 1)):$((container_gid + 1)):$((subgid_size - $container_gid)) \\\n --gidmap=$container_gid:0:1 \\\n -d --name qwik-container \\\n -p 3300:3300 -p 9229:9299 \\\n -v .:/home/circleci/project:Z \\\n -t qwik-container\n```\n\n#### Locally installed tools\n\nIf you're not able to use the dev container, make sure you have NodeJS v18+ installed, as well as `pnpm`.\n\nFurthermore, to build the optimizer you optionally need Rust.\n\n1. Make sure [Rust](https://www.rust-lang.org/tools/install) is installed.\n2. Install [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/) with `cargo install wasm-pack` .\n3. Node version >= `22`.\n4. Make sure you have [pnpm](https://pnpm.io/installation) installed.\n5. run `pnpm install`\n\n> On Windows, Rust requires [C++ build tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/). You can also select _Desktop development with C++_\n> while installing Visual Studio.\n\n---\n\n## Development\n\nTo build Qwik for local development, install the dev dependencies using [pnpm](https://pnpm.io/) and then do an initial build.\n\n```shell\npnpm install && pnpm build.local\n```\n\nIf you want to work on the Rust code, use `build.full` instead of `build.local`.\n\n> [!NOTE]\n> After running `build.local`, you may see Git diffs for API-related files and `JSXNode`. You should run the `api.update` script to resolve them.\n\n### Fast build\n\nThis will build only Qwik and Qwik City and their types. This is not enough to run the docs.\n\n```shell\npnpm build.core\n```\n\n### Custom build\n\nOnce you have done a full build, the types are built, and you can build just the code you're working on. For qwik and qwik-city, you can do very fast rebuilds with\n\n```shell\npnpm build --dev --qwik --qwikcity\n```\n\nThe `--dev` flag skips type checking and generating.\n\nYou can run `pnpm build` without parameters to see which flags are available. Notable:\n\n- `--tsc`: build types\n- `--api`: build API docs and type bundles. Requires `--tsc` to have run.\n- `--build`: Qwik (you'll probably also need `--dev`)\n- `--qwikcity`: Qwik City (you'll probably also need `--dev`)\n- `--qwikreact`: Qwik React\n- `--qwiklabs`: Qwik Labs\n- `--eslint`: Eslint plugin\n\nE.g. to build only the React integration, you'd run `pnpm build --qwikreact`.\n\n### Full build without Rust\n\nThis builds everything except Rust prerequisites and the optimizer binaries. Instead, those binaries are copied from the latest Qwik package on NPM.\n\n```shell\npnpm build.local\n```\n\n### Full build with Rust\n\nIt will build **everything**, including Rust packages and WASM.\n\n> First build might be very slow.\n\n- Builds each submodule\n- Generates bundled `.d.ts` files for each submodule with [API Extractor](https://api-extractor.com/)\n- Checks the public API hasn't changed\n- Builds a minified `core.min.mjs` file\n- Generates the publishing `package.json`\n\n```shell\npnpm build.full\n```\n\nThe build output will be written to `packages/qwik/dist`, which will be the directory that is published to [@builder.io/qwik](https://www.npmjs.com/package/@builder.io/qwik).\n\nTo update the Rust test snapshots after you've made changes to the Rust code, run `pnpm test.rust.update`.\n\n### Run in your own app\n\nSay you made changes to the repo and you want to try them out in your app. Once built, all the Qwik packages are directly usable in your project by using the linking in your package manager.\n\nThis is very easy to do with `pnpm`:\nAssuming qwik is in `../qwik`, run this inside the root of your app:\n\n```shell\npnpm link ../qwik/packages/qwik\npnpm link ../qwik/packages/qwik-city\n```\n\nOther package managers probably need to first be told about the packages. For example, with `bun` you need to `cd ../qwik/packages/qwik` and `bun link`, repeat for `qwik-city`. Then in your app run `bun link @builder.io/qwik @builder.io/qwik-city`.\n\nIf you can't use package linking, just copy the contents of `packages/qwik` into your projects' `node_modules/@builder.io/qwik` folder, and/or the contents of `packages/qwik-city` into your projects' `node_modules/@builder.io/qwik-city` folder.\n\n### Working on the docs site\n\nAt the root of the Qwik repo folder run:\n\n```shell\npnpm docs.dev\n```\n\n### To open the test apps for debugging run\n\n```shell\npnpm serve\n```\n\n### Unit Tests Only\n\nUnit tests use [vitest](https://vitest.dev)\n\n```shell\npnpm test.unit\n```\n\n### E2E Tests Only\n\nE2E tests use [Playwright](https://playwright.dev/).\n\nTo run the Playwright tests headless, from start to finish, run:\n\n```shell\npnpm test.e2e.chromium\n```\n\nFinally, you can use `pnpm --filter` command to run packages' commands, for example:\n\n```shell\npnpm --filter qwik-docs start\n```\n\nMore commands can be found in each package's package.json scripts section.\n\n### Updating dependencies\n\nTo update all dependencies, run:\n\n```shell\npnpm deps\n```\n\nThis will show an interactive UI to update all dependencies. Be careful about performing major updates, especially for the docs site, since not all functionality has test coverage there. Be sure to test thoroughly.\n\n## Starter CLI `create-qwik`\n\n- [Starter CLI](https://github.com/QwikDev/qwik/blob/main/starters/README.md)\n\n## Pull Requests\n\n- [Open Qwik in StackBlitz Codeflow](https://pr.new/github.com/QwikDev/qwik/)\n- Review PR in StackBlitz\n ![image](https://user-images.githubusercontent.com/4918140/195581745-8dfca1f9-2dcd-4f6a-b7aa-705f3627f8fa.png)\n\n### Coding conventions\n\nWrite code that is clean, simple and easy to understand. Complicated one-liners are generally frowned upon, unless they are for performance reasons and are clearly marked as such with a comment and explanation.\n\nWhen code does something unexpected, add a comment explaining why.\n\nWhen a comment is longer, prefer using `/** */` JSDoc comments as that will be auto-formatted as Markdown.\nJSDoc comments will also become part of the API documentation when they apply to exports, so write them as such.\n\n`pnpm fmt` is your friend, and we recommend setting up Prettier and using format-on-save in your editor.\n\n### Commit conventions\n\nIf you don't follow these commit conventions, your PR will be squashed. This means your local branch will not be part of the commit history of the target branch.\nFor larger PRs, it would really help if you follow these guidelines.\n\n- Create a commit for each logical unit and make sure it passes linting.\n- Keep your commits focused and atomic. Each commit should represent a single, coherent change.\n- If you have commits like `wip lol` or `fixup`, squash them. Use `git rebase -i`.\n- Commits must follow the format: `type(scope): description`\n For example: `feat(qwik-city): confetti animations` or `chore: pnpm api.update`\n\n Common types include:\n - feat: A new feature\n - fix: A bug fix\n - docs: Documentation only changes\n - lint: Changes that do not affect the meaning of the code (white-space, formatting, etc)\n - refactor: A code change that neither fixes a bug nor adds a feature\n - perf: A code change that improves performance\n - test: Adding missing tests or correcting existing tests\n - chore: Changes to the build process or auxiliary tools and libraries such as documentation generation\n\n The `scope` is optional and should be a short identifier for the changed part of the code.\n\n- Use the imperative mood in the description. For example, use \"add\" instead of \"added\" or \"adds\".\n- For consistency, there should not be a period at the end of the commit message's summary line (the first line of the commit message).\n\n### Writing good commit messages\n\nIn addition to writing properly formatted commit messages, it's important to include relevant information so other developers can later understand _why_ a change was made. While this information usually can be found by digging into the code, pull request discussions or upstream changes, it may require a lot of work.\n\n- Be clear and concise in your commit messages.\n- Explain the reason for the change, not just what was changed.\n- If the commit fixes a specific issue, reference it in the commit message (e.g., \"Fixes #123\").\n\n### Adding a changeset\n\nWhenever you make a change that requires mentioning in the changelog, you should add a changeset. This will automatically generate meaningful release notes and changelog files.\n\nYou can add multiple changesets in a PR, for example because you implement different features for different packages, or because you have multiple noteworthy commits.\n\nYou create a new changeset file by running:\n\n```shell\npnpm change\n```\n\nThis will ask you which packages should be included in the changeset, and if the changes require a new version bump. Generally you should not select `major`, and you should only select `minor` if there are new features or significant improvements. If you don't select either it will become `patch`.\n\nFor your convenience, we prepared a video tutorial that covers the process of adding a changeset:\n\n[📽 TUTORIAL: Adding a changeset](https://go.screenpal.com/watch/cZivIcVPJQV)\n\n## PR merging (maintainers)\n\nMake sure the PR follows all the guidelines in this document. Once you think the PR is good to merge, if the commits are \"nice\", you can merge the PR. If not, squash the PR.\n\nIn case the PR is stuck waiting for the original author to apply a trivial\nchange (a typo, capitalization change, etc.) and the author allowed the members\nto modify the PR, consider applying it yourself (or commit the existing review\nsuggestion). You should pay extra attention to make sure the addition doesn't go\nagainst the idea of the original PR and would not be opposed by the author.\n\n## Releasing (maintainers)\n\nMerge the \"version\" PR, that is automatically created when a PR with a changeset is merged. You can first edit the files it created to get a nicer changelog.\n\nOnce CI passes, the GitHub Action will publish the new version to NPM.\n" }, { "path": "Cargo.toml", "content": "[workspace]\n\nmembers = [\n \"packages/qwik/src/napi\",\n \"packages/qwik/src/wasm\",\n \"packages/qwik/src/optimizer/cli\",\n \"packages/qwik/src/optimizer/core\",\n]\nexclude = [\"packages/qwik/src/wasm\"]\nresolver = \"2\"\n\n[profile.release]\ndebug = 0\nlto = true\ncodegen-units = 1\nopt-level = \"z\"\npanic = \"abort\"\n\n" }, { "path": "Dockerfile", "content": "FROM node:16.12.0-buster\n\nRUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y\nADD . /\nENV PATH=\"/root/.cargo/bin:${PATH}\"\nRUN make install-rust-deps\nRUN pnpm install\nRUN pnpm build\n" }, { "path": "GOVERNANCE.md", "content": "# Qwik Project Governance\n\nThis governance document reflects our dedication to maintaining Qwik as an open, fair, and collaborative project and is a continuation of our [community values](https://docs.google.com/document/d/1MrSp2caaREETHUL56C2fIIJeFJsBA_sWJ9raL6hWoo8/edit#heading=h.bpbzghkvfgrn).\n\nQwik is rooted in a commitment to innovation and community-driven development where the needs of the community drive the framework's evolution.\n\nOur decisions are guided by what serves Qwik and the broader web ecosystem best, with a strong emphasis on seeking consensus.\n\nThe following outlines the structure of the project, including the roles and responsibilities of its members.\n\n## Community Contributors\n\nA Community contributor is any community member who contributes to the success of the framework.\n\nContributors usually are part of one or more of the following categories:\n\n1. **Code Contributors** - Developers who contribute by identifying issues, submitting pull requests, or maintaining community-driven Qwik projects.\n2. **Docs Contributors** - Members who enhance or correct the Qwik documentation, ensuring it remains accurate and accessible.\n3. **Support Contributors** - Members who assist other developers by answering questions and offering support.\n4. **Content Creators** - Those who produce educational content, tutorials, and other resources to help the community better understand and use Qwik.\n5. **Local Community Leaders** - Members who organize and lead local Qwik communities, fostering in-person engagement and knowledge sharing.\n\n## Qwik Heroes\n\nQwik Heroes are recognized as top contributors who have exceptional dedication and enthusiasm for Qwik.\n\nHeroes have easier access to the core team and participate in monthly meetings to provide feedback, ask questions, and discuss internal topics together with the team.\n\n#### Nomination\n\nAny community contributor can be nominated as a Qwik Hero by an existing member or by any of the leadership teams. Selections are made by the Community Management Team (and in conjunction with the core team for cases of “code heroes”).\n\n#### Status Change\n\nRemoval of Qwik Heroes is done by either a voluntary resignation or by a Community Management Team decision, or (in extreme cases) by a Stewardship Team motion.\n\nQwik Heroes who become inactive for 6 months are automatically reverted to regular community contributor status.\n\n## Core Team\n\nCore team members are contributors who have merging rights to the project and are actively involved in the ongoing development of Qwik. They are essential to the framework's evolution, participating in weekly sprint meetings and Core Leadership meetings (although only Core Leadership members can vote in these meetings).\n\nThe Core Team will have a Core Team Lead who will be in charge of the ongoing project management and development progress.\n\n#### Nomination\n\nA Qwik Hero member can be nominated as a Core Team member by any member of the Core Team. Nominations are decided upon by a standard Core Leadership motion.\n\n#### Status Change\n\nRemoval of Core Team members is done by either a voluntary resignation or by a standard Core Leadership motion, or (in extreme cases) by a Stewardship Team motion.\n\nA Core Team member will be automatically converted back to a \"Qwik Hero\" if they are not active in the project for over 3 months.\n\n## Core Leadership Team\n\nThe Core Leadership Team includes Core Team members who are granted voting rights on strategic technical decisions.\n\nThese individuals are selected because of their experience, judgment, good faith, and alignment with Qwik's core values.\n\nMembers of this team are expected to participate in Core Leadership Team activities and meetings and can cast votes when consensus is not reached on a specific decision.\n\n#### Nomination\n\nRegular Core Team members can be nominated to the Core Leadership Team by any current Core Leadership member, with the final decision made through a standard Core Leadership motion.\n\n#### Status Change\n\nRemoval of voting Core Leadership members is done by either a voluntary resignation or by a standard Core Leadership motion, or (in extreme cases) by a Stewardship Team motion.\n\nA Core Leadership member will be automatically converted to a regular Core Team member if they do not participate in 3 consecutive votes or have been inactive for over 4 months.\n\n## Docs Team\n\nThe Docs Team is responsible for maintaining and improving Qwik's documentation.\n\nThis team ensures that the documentation is up-to-date, accurate, and user-friendly, and also handles the triage of docs-related issues and the merging of related PRs.\n\n#### Nomination\n\nA Qwik Hero member can be nominated as a Docs Team member by any member of the Docs Team. Nominations need to be approved by the Growth Manager.\n\n#### Status Change\n\nRemoval of Docs Team members is done by either a voluntary resignation or by a Growth Manager decision, or (in extreme cases) by a Stewardship Team motion.\n\nA Docs Team member will be automatically converted back to a \"Qwik Hero\" if they are not active in the project for over 3 months.\n\n## Community Management Team\n\nThe Community Management Team oversees the onboarding, safety, and overall vibe of the Qwik community.\n\nThey ensure that the community remains a friendly and inclusive space where members follow the Qwik community guidelines.\n\nThe team is responsible for managing \"Local Community Leaders\" and \"Support Heroes\" and helping them succeed in their roles and contributions.\n\n#### Nomination\n\nQwik Heroes may be nominated to the Community Management Team by any current team member. Nominations need to be approved by the Growth Manager.\n\n#### Status Change\n\nRemoval of Community Management Team members is done by either a voluntary resignation or by a Growth Manager decision, or (in extreme cases) by a Stewardship Team motion.\n\nA Community Management Team member will be automatically converted back to a \"Qwik Hero\" if they are not active in the project for over 3 months.\n\n## Outreach Team\n\nThe Outreach Team is responsible of spreading Qwik's message, ensuring that more developers are introduced to the framework and give it a try. Their responsibilities include managing social media, collaborating with content creators, representing Qwik at conferences, and more.\n\n#### Nomination\n\nQwik Heroes may be nominated to the Outreach Team by any current team member. Nominations need to be approved by the Growth Manager.\n\n#### Status Change\n\nRemoval of Outreach Team members is done by either a voluntary resignation or by a Growth Manager decision, or (in extreme cases) by a Stewardship Team motion.\n\nAn Outreach Team member will be automatically converted back to a \"Qwik Hero\" if they are not active in the project for over 3 months.\n\n## Growth Manager\n\nThe Growth Manager is responsible for overseeing the Community Management, Outreach, and Docs Teams, ensuring that their efforts are aligned and that messaging across these teams remains consistent.\n\nThis role is crucial in driving the strategic direction of Qwik's growth and ensuring that all community-facing activities are cohesive and effective.\n\nThe Growth Manager is appointed or replaced by a standard Stewardship Team motion.\n\n## Stewardship Team\n\nThe project's stewards are in charge of all aspects regarding the framework.\n\nThis includes the development, community, and growth of the framework, but also creating proper management processes, managing sponsorships and budgets, collaborations, and more.\n\nThe project stewards are: Misko Hevery and Shai Reznik.\n\nThe project stewards will be used as \"tiebreakers\" in votes and hold veto rights on decisions (to protect the framework from rare and extreme cases).\n\nBecause the framework can be forked by the community at any point, the project stewards must manage the project in a fair, honest, and thoughtful way, taking into account what's good for the community and resolving conflicting needs as much as possible.\n\n---\n\ninspired by [Node](https://github.com/nodejs/node/blob/main/GOVERNANCE.md), [Vue](https://github.com/vuejs/vue/wiki/Governance-Document), [Astro](https://github.com/withastro/.github/blob/main/GOVERNANCE.md) and [Nuxt](https://github.com/nuxt/governance)\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2024 QwikDev\nCopyright (c) 2021 BuilderIO\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "Makefile", "content": "install-rust:\n\tcurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y\n\ninstall-rust-deps:\n\trustup update\n\trustup target add wasm32-unknown-unknown\n\tcargo install cargo-insta\n\trustup component add clippy\n\nadd-target:\n\trustup target add wasm32-unknown-unknown\n\ninstall-all: install-rust install-rust-deps\n\ninstall-cli:\n\tcd src/optimizer/cli && cargo install --path .\n\nfix:\n\tcargo fmt\n\ncheck:\n\tcargo fmt -- --check && cargo check --all-features\n\nlint:\n\tcargo clippy --all-features && cargo check --all-features && cargo fmt -- --check\n\n# We only test core because there are no other tests and qwik-napi breaks the build\ntest:\n\tcargo test --manifest-path packages/qwik/src/optimizer/core/Cargo.toml\n\ntest-update:\n\tif ! cargo test --manifest-path packages/qwik/src/optimizer/core/Cargo.toml; then \\\n\t\tcd packages/qwik/src/optimizer/core/src/snapshots/; \\\n\t\tfor i in *.new; do f=$$(basename $$i .new); mv $$i $$f; done; \\\n\t\tcd -; \\\n\t\tcargo test --manifest-path packages/qwik/src/optimizer/core/Cargo.toml; \\\n\tfi\n\npublish-core:\n\tcd src/optimizer/core && cargo publish --all-features\n\npublish-cli:\n\tcd src/optimizer/cli && cargo publish\n\npublish: publish-core publish-cli\n\nvalidate: check lint test\n" }, { "path": "README.md", "content": "
\n

\n \"Qwik\n

\n
\n

\n \"Qwik\n

\n
\n
\n\n

Instant-loading web apps, without effort

\n\nQwik offers the fastest possible page load times - regardless of the complexity of your website. Qwik is so fast because it allows fully interactive sites to load with almost no JavaScript and [pickup from where the server left off](https://qwik.dev/docs/concepts/resumable/).\n\nAs users interact with the site, only the necessary parts of the site load on-demand. This [precision lazy-loading](https://qwik.dev/docs/concepts/progressive/) is what makes Qwik so quick.\n\n## Getting Started\n\n```sh\nnpm create qwik@latest\n# or\npnpm create qwik@latest\n# or\nyarn create qwik@latest\n# or\nbun create qwik@latest\n```\n\n- Understand the difference between [resumable and replayable](https://qwik.dev/docs/concepts/resumable/) applications.\n- Learn about Qwik's high level [mental model](https://qwik.dev/docs/concepts/think-qwik/).\n\n## Resources\n\n- [Docs](https://qwik.dev/)\n- [Examples](https://qwik.dev/examples/introduction/hello-world/)\n- [Tutorials](https://qwik.dev/tutorial/welcome/overview/)\n- [Videos](https://qwik.dev/media/#videos)\n- [Podcasts](https://qwik.dev/media/#podcasts)\n- [Presentations](https://qwik.dev/media/#presentations)\n- [Blogs](https://qwik.dev/media/#blogs)\n\n## Community\n\n- Ping us at [@QwikDev](https://twitter.com/QwikDev)\n- Join our [Discord](https://qwik.dev/chat) community\n- Join all the [other community groups](https://qwik.dev/ecosystem/#community)\n\n## Development\n\n- See [Contributing.md](https://github.com/QwikDev/qwik/blob/main/CONTRIBUTING.md) for more information on how to build Qwik from the source and contribute!\n\n## Related\n\n- [Partytown](https://partytown.qwik.dev/): Relocate resource intensive third-party scripts off of the main thread and into a web worker 🎉.\n- [Mitosis](https://github.com/BuilderIO/mitosis): Write components once, run everywhere. Compiles to Vue, React, Solid, Angular, Svelte, and more.\n- [Builder](https://github.com/BuilderIO/builder): Drag and drop page builder and CMS for React, Vue, Angular, and more.\n\n
\n
\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
special sponsor
\n \n \n \n \"Special\n \n \n
sponsors
\n \n \n \n \n \"Company\n \n \n
\n \n \n \n \n \"Company\n \n \n
\n" }, { "path": "SECURITY.md", "content": "# Reporting Security Issues\n\nThe Qwik team and community are dedicated to keeping our project secure, and we appreciate your help in identifying and disclosing security issues responsibly. Your efforts make a big difference!\n\nTo report a security issue, please use the \"[Report a Vulnerability](https://github.com/QwikDev/qwik/security/advisories/new)\" tab on our GitHub Security Advisory page.\n\nAfter you submit a report, we'll get back to you with the next steps. We'll keep you updated on our progress towards fixing the issue and any related announcements. If we need more information, we might reach out to you for further details.\n\nFor security issues in third-party modules, please contact the maintainer of the module directly. Alternatively, you can use the [npm contact form](https://www.npmjs.com/support) and select \"I'm reporting a security vulnerability.\"\n\nThanks for helping us keep Qwik safe and secure!\n" }, { "path": "contributing/TRIAGE.md", "content": "# Triage Titans Guide\n\nHey there! Welcome to the wild world of the **Triage Titans**, where we tame bugs and nurture enhancements with the precision of true repository doctors.\n\nLet's keep the code healthy, the project smooth, and have some fun along the way.\n\n## Note about tags prefixes:\n\n1. **STATUS-1**: The initial `needs triage` gets automatically added to newly created issues\n2. **STATUS-2**: A \"waiting for someone/something\" status.\n3. **STATUS-3**: The final state of an issue. This is a \"resolution\" status.\n\n---\n\n👇 _Inspiration for the diagrams below came from the Vite project_\n\n## Bug Triaging Process\n\nOur bug triaging process makes sure every reported issue gets the attention it deserves. We categorize, prioritize, and assign bugs to the right person to squash them quickly.\n\nHere's how the Triage Titans handle bug reports in the Qwik repository:\n\n```mermaid\nflowchart TD\n start{Missing information?}\n start --YES--> close1[Tag with\\n'STATUS-2: missing info'\\n\\nBot will auto close if\\n no update for 14 days]\n start --NO--> dupe{Is duplicate?}\n dupe --YES--> close2[Close, point to duplicate\\n and tag with\\n'STATUS-3: duplication']\n dupe --NO--> repro{Has proper\\nreproduction?}\n repro --NO--> close3[Tag with\\n 'STATUS-2: needs reproduction'\\nBot will auto close if \\nno update for 14 days]\n repro --YES--> real{Is actually a bug?}\n real --NO--> intended{Is the intended\\nbehaviour?}\n intended --YES--> explain[Explain and close.\\nPoint to docs if needed.\\nTag with\\n'STATUS-3: works as expected']\n intended --NO--> open[Tag with\\n'STATUS-2: requires discussion'\\nand either\\n'WAITING FOR: team'\\n'WAITING FOR: user']\n real --YES--> real2[\"1. Tag with 'STATUS-2: team is working on this'\\n2. Add related feature label if\\napplicable (e.g. 'COMP: runtime')\\n3. Add priority labels (see below)\"]\n real2 --> unusable{Does the\\nbug make Qwik\\nunusable?}\n unusable --YES--> maj{Does the bug\\naffect the majority\\nof Qwik users?}\n maj --YES--> P4[P4: urgent]\n maj --NO--> P3[P3: important]\n unusable --NO--> workarounds{Are there\\nworkarounds for\\nthe bug?}\n workarounds --NO--> P2[P2: minor]\n workarounds --YES--> P1[P1: nice to have / fix]\n```\n\n---\n\n## Enhancement Triaging Process\n\nAlright, Triage Titans! Somebody got a cool new feature idea or an awesome improvement to boost Qwik?\n\nIt's our job to make sure these enhancements are properly evaluated, prioritized, and brought to life.\n\nWhat helps the team to prioritize work is the number of 👍 votes by the community on a specific issue.\n\n### A note about enhancements to the core:\n\nWe are very careful about which features we introduce into the Qwik core, because we know that every new feature adds complexity and maintenance tasks to the codebase.\n\nEvery feature is being carefully evaluated based on our vision and philosophy of \"automatic optimization\".\n\nThat's why we'll often encourage the community to implement a certain feature and evaluate its adoption over time to see if it should actually be part of the core.\n\n.\n\nNow, let's dive into how we handle enhancement requests in the Qwik repository:\n\n```mermaid\nflowchart TD\n start{Missing information?}\n start --YES--> close1[Tag with\\n'STATUS-2: missing info'\\n\\nBot will auto close if\\n no update for 14 days]\n start --NO--> dupe{Is duplicate?}\n dupe --YES--> close2[Close, point to duplicate\\n and tag with\\n'STATUS-3: duplication']\n dupe --NO--> discussion{Requires further\\ndiscussion?}\n discussion --YES--> close3[Tag with\\n 'STATUS-2: requires discussion'\\nand 'WAITING FOR: team'\\nor 'WAITING FOR: user']\n discussion --NO--> implement{Should it be\\nimplemented by core?}\n implement --NO--> community{Should it be implemented\\nby the community?}\n community --YES--> incubate[Close and tag with either\\n'STATUS-3: incubation'\\nor 'STATUS-2: waiting for community PR'\\nand 'COMMUNITY: PR is welcomed']\n community --NO--> wontfix[Close and tag with\\n'STATUS-3: won't be worked on']\n implement --YES--> doimplement[\"1. Tag with 'STATUS-2: team is working on this'\\n2. Add related feature label if\\napplicable (e.g. 'COMP: runtime')\\n3. Add version \\nlabels (e.g. 'VERSION: upcoming major')\"]\n```\n\n## Thank You!\n\nA big shoutout to all our amazing contributors and Triage Titans! Your dedication, creativity, and hard work help keep Qwik running smoothly and evolving with exciting new features. We wouldn't be able to do it without you 🫶\n\nThank you for being a part of our journey and making Qwik awesome. Keep up the great work, and let's continue building something amazing together!\n" }, { "path": "cspell.json", "content": "{\n \"words\": [\n \"Aboutus\",\n \"accumsan\",\n \"activedescendant\",\n \"adipiscing\",\n \"alertdialog\",\n \"allowpopups\",\n \"Almeida\",\n \"amet\",\n \"antipattern\",\n \"Arcrole\",\n \"asynchronicity\",\n \"basepath\",\n \"bbar\",\n \"bbox\",\n \"bday\",\n \"beforeinput\",\n \"bgsound\",\n \"Bien\",\n \"bindgen\",\n \"bivariance\",\n \"Bivariant\",\n \"Bkxp\",\n \"blinkfeatures\",\n \"Booleanish\",\n \"brotli\",\n \"browsermain\",\n \"builderio\",\n \"buildtime\",\n \"bunde\",\n \"canonicalize\",\n \"cdylib\",\n \"cjsx\",\n \"Clhb\",\n \"clic\",\n \"cmps\",\n \"codegen\",\n \"colcount\",\n \"colindex\",\n \"colspan\",\n \"columnheader\",\n \"combobox\",\n \"complext\",\n \"composability\",\n \"consectetur\",\n \"contentinfo\",\n \"Counteradd\",\n \"crossorigin\",\n \"ctxt\",\n \"datetime\",\n \"Dblclick\",\n \"Debouncer\",\n \"deno\",\n \"describedby\",\n \"dfdfd\",\n \"disableblinkfeatures\",\n \"disableguestresize\",\n \"disablewebsecurity\",\n \"divfixture\",\n \"dolor\",\n \"dropeffect\",\n \"elems\",\n \"elit\",\n \"elli\",\n \"epressed\",\n \"errormessage\",\n \"espree\",\n \"estree\",\n \"execa\",\n \"extensionless\",\n \"extless\",\n \"extname\",\n \"extnames\",\n \"fargs\",\n \"Fboth\",\n \"flowto\",\n \"frontmatter\",\n \"gesturechange\",\n \"gestureend\",\n \"gesturestart\",\n \"Gettingstarted\",\n \"gmsw\",\n \"gridcell\",\n \"guestinstance\",\n \"hackmd\",\n \"Hasher\",\n \"haspopup\",\n \"Hevery\",\n \"hola\",\n \"horiz\",\n \"hostattrs\",\n \"hotspot\",\n \"httpreferrer\",\n \"idents\",\n \"imagesizes\",\n \"imagesrcset\",\n \"importee\",\n \"Indexapi\",\n \"inlines\",\n \"inlist\",\n \"insta\",\n \"ipsum\",\n \"itemprop\",\n \"itsok\",\n \"jsxs\",\n \"keyof\",\n \"keyshortcuts\",\n \"Keyup\",\n \"kleur\",\n \"labelledby\",\n \"Layoutapi\",\n \"layoutname\",\n \"listbox\",\n \"listitem\",\n \"listitems\",\n \"lkei\",\n \"Lorem\",\n \"manu\",\n \"manualmeida\",\n \"maxage\",\n \"mdast\",\n \"mdxjs\",\n \"menuitemcheckbox\",\n \"menuitemradio\",\n \"middlewares\",\n \"mimalloc\",\n \"misko\",\n \"miško\",\n \"mjsx\",\n \"Mobify\",\n \"mondodb\",\n \"mpath\",\n \"msvc\",\n \"msvideo\",\n \"mtsx\",\n \"multiselectable\",\n \"multistatus\",\n \"myapp\",\n \"napi\",\n \"netify\",\n \"nodeintegration\",\n \"noopen\",\n \"noscript\",\n \"noserialize\",\n \"nosniff\",\n \"nothere\",\n \"nulll\",\n \"objs\",\n \"odzdfdfd\",\n \"oneline\",\n \"onrender\",\n \"onscrolling\",\n \"onwarn\",\n \"outdir\",\n \"outfile\",\n \"outro\",\n \"panose\",\n \"partytown\",\n \"pathdiff\",\n \"pfkgyr\",\n \"Pinterest\",\n \"posinset\",\n \"posix\",\n \"prefetching\",\n \"prerender\",\n \"pretium\",\n \"progressbar\",\n \"PROPPATCH\",\n \"proto\",\n \"QACTION\",\n \"qcomponent\",\n \"Qdata\",\n \"qdev\",\n \"qerror\",\n \"qfunc\",\n \"Qhook\",\n \"qidle\",\n \"qinit\",\n \"qkssr\",\n \"qprefetch\",\n \"qqhook\",\n \"qresume\",\n \"qrls\",\n \"QSLOT\",\n \"qsymbol\",\n \"quicktime\",\n \"qvisible\",\n \"qwik\",\n \"qwikauth\",\n \"qwikcity\",\n \"qwikdeps\",\n \"qwikdom\",\n \"qwikevents\",\n \"qwikfy\",\n \"qwikify\",\n \"qwikjson\",\n \"qwikloader\",\n \"qwikreact\",\n \"radiogroup\",\n \"Rctx\",\n \"reboostrap\",\n \"referrerpolicy\",\n \"regs\",\n \"rehype\",\n \"renderz\",\n \"reparse\",\n \"replayable\",\n \"resumability\",\n \"revalidates\",\n \"rlib\",\n \"Roboto\",\n \"roledescription\",\n \"rowcount\",\n \"rowgroup\",\n \"rowheader\",\n \"rowindex\",\n \"rowspan\",\n \"rsplitn\",\n \"rsps\",\n \"SAMEORIGIN\",\n \"SAMESITE\",\n \"sdfds\",\n \"searchbox\",\n \"serde\",\n \"Serializability\",\n \"setsize\",\n \"shouldkebab\",\n \"signin\",\n \"signout\",\n \"sit\",\n \"slidein\",\n \"slotdefault\",\n \"somefn\",\n \"somestring\",\n \"sourcemaps\",\n \"spinbutton\",\n \"sref\",\n \"sstyle\",\n \"stemh\",\n \"stemv\",\n \"styff\",\n \"stylesscopedblue\",\n \"stylesscopedgreen\",\n \"subdir\",\n \"submitcompleted\",\n \"svgz\",\n \"SWC's\",\n \"tablist\",\n \"tabpanel\",\n \"tagname\",\n \"tdblg\",\n \"textbox\",\n \"Textfromdefault\",\n \"threejs\",\n \"tlsv\",\n \"todoapp\",\n \"todos\",\n \"treegrid\",\n \"treeitem\",\n \"treeitems\",\n \"treeshake\",\n \"treeshaked\",\n \"tsdoc\",\n \"typecheck\",\n \"typeof\",\n \"typesafe\",\n \"undici\",\n \"unist\",\n \"unselectable\",\n \"unsub\",\n \"urlset\",\n \"valign\",\n \"valuenow\",\n \"valuetext\",\n \"Vdom\",\n \"vfile\",\n \"vite\",\n \"Vivamus\",\n \"Vnode\",\n \"Vnodes\",\n \"vulputate\",\n \"wbmp\",\n \"webfont\",\n \"webpreferences\",\n \"webworker\",\n \"wmode\",\n \"xlink\"\n ],\n \"enableFiletypes\": [\"mdx\"]\n}\n" }, { "path": "e2e/adapters-e2e/.gitignore", "content": "playwright-report\ndist\nlogs\nserver\ntmp" }, { "path": "e2e/adapters-e2e/adapters/express/vite.config.ts", "content": "import { nodeServerAdapter } from '@builder.io/qwik-city/adapters/node-server/vite';\nimport { extendConfig } from '@builder.io/qwik-city/vite';\nimport baseConfig from '../../vite.config';\n\nexport default extendConfig(baseConfig, () => {\n return {\n build: {\n ssr: true,\n rollupOptions: {\n input: ['src/entry.express.tsx', '@qwik-city-plan'],\n },\n },\n plugins: [nodeServerAdapter({ name: 'express' })],\n };\n});\n" }, { "path": "e2e/adapters-e2e/package.json", "content": "{\n \"name\": \"qwik-buffering-test-app\",\n \"description\": \"Qwik buffering test app\",\n \"engines\": {\n \"node\": \"^18.17.0 || ^20.3.0 || >=21.0.0\"\n },\n \"private\": true,\n \"scripts\": {\n \"build\": \"qwik build\",\n \"build.client\": \"vite build\",\n \"build.preview\": \"vite build --ssr src/entry.preview.tsx\",\n \"build.server\": \"vite build -c adapters/express/vite.config.ts\",\n \"build.types\": \"tsc --incremental --noEmit\",\n \"deploy\": \"vercel deploy\",\n \"dev\": \"vite --mode ssr\",\n \"dev.debug\": \"node --inspect-brk ./node_modules/vite/bin/vite.js --mode ssr --force\",\n \"express\": \"pnpm build && pnpm serve\",\n \"fmt\": \"prettier --write .\",\n \"fmt.check\": \"prettier --check .\",\n \"lint\": \"eslint \\\"src/**/*.ts*\\\"\",\n \"preview\": \"qwik build preview && vite preview --open\",\n \"qwik\": \"qwik\",\n \"serve\": \"node server/entry.express\",\n \"start\": \"vite --open --mode ssr\",\n \"test\": \"playwright test\",\n \"test.debug\": \"playwright test --debug\",\n \"test.ui\": \"playwright test --ui\"\n },\n \"type\": \"module\"\n}\n" }, { "path": "e2e/adapters-e2e/playwright.config.ts", "content": "import { defineConfig, devices } from '@playwright/test';\n\n/** See https://playwright.dev/docs/test-configuration. */\nexport default defineConfig({\n testDir: './tests',\n fullyParallel: true,\n forbidOnly: !!process.env.CI,\n retries: process.env.CI ? 2 : 0,\n workers: process.env.CI ? 1 : undefined,\n reporter: 'line',\n\n use: {\n baseURL: 'http://localhost:3000',\n // trace: 'on-first-retry',\n // screenshot: 'only-on-failure',\n\n // Increase timeouts for service worker operations\n actionTimeout: 10000,\n navigationTimeout: 10000,\n },\n\n // Increase global timeout for service worker tests\n timeout: process.env.CI ? 120000 : 30000,\n\n projects: [\n {\n name: 'chromium',\n use: {\n ...devices['Desktop Chrome'],\n },\n },\n // {\n // name: 'firefox',\n // use: { ...devices['Desktop Firefox'] },\n // },\n {\n name: 'webkit',\n use: { ...devices['Desktop Safari'] },\n },\n ],\n\n webServer: {\n command: 'npm run express',\n port: 3000,\n stdout: 'pipe',\n reuseExistingServer: !process.env.CI,\n timeout: process.env.CI ? 120000 : 30000,\n },\n});\n" }, { "path": "e2e/adapters-e2e/src/components/click-me/click-me.tsx", "content": "import { component$, useSignal } from '@builder.io/qwik';\n\n// We need to extract the component to see the bug on 1.5.7\nexport default component$(() => {\n const isOpenSig = useSignal(false);\n return (\n <>\n {\n return (isOpenSig.value = !isOpenSig.value);\n }}\n >\n click me\n \n {isOpenSig.value &&
Hi 👋
}\n \n );\n});\n" }, { "path": "e2e/adapters-e2e/src/components/router-head/router-head.tsx", "content": "import { component$ } from '@builder.io/qwik';\nimport { useDocumentHead, useLocation } from '@builder.io/qwik-city';\n\nexport const RouterHead = component$(() => {\n const head = useDocumentHead();\n const loc = useLocation();\n\n return (\n <>\n {head.title}\n\n \n \n\n {head.meta.map((m) => (\n \n ))}\n\n {head.links.map((l) => (\n \n ))}\n \n );\n});\n" }, { "path": "e2e/adapters-e2e/src/entry.dev.tsx", "content": "/*\n * WHAT IS THIS FILE?\n *\n * Development entry point using only client-side modules:\n * - Do not use this mode in production!\n * - No SSR\n * - No portion of the application is pre-rendered on the server.\n * - All of the application is running eagerly in the browser.\n * - More code is transferred to the browser than in SSR mode.\n * - Optimizer/Serialization/Deserialization code is not exercised!\n */\nimport { render, type RenderOptions } from '@builder.io/qwik';\nimport Root from './root';\n\nexport default function (opts: RenderOptions) {\n return render(document, , opts);\n}\n" }, { "path": "e2e/adapters-e2e/src/entry.express.tsx", "content": "/*\n * WHAT IS THIS FILE?\n *\n * It's the entry point for the Express HTTP server when building for production.\n *\n * Learn more about Node.js server integrations here:\n * - https://qwik.dev/docs/deployments/node/\n *\n */\nimport { createQwikCity, type PlatformNode } from '@builder.io/qwik-city/middleware/node';\nimport 'dotenv/config';\nimport qwikCityPlan from '@qwik-city-plan';\nimport { manifest } from '@qwik-client-manifest';\nimport render from './entry.ssr';\nimport express from 'express';\nimport { fileURLToPath } from 'node:url';\nimport { join } from 'node:path';\n\ndeclare global {\n type QwikCityPlatform = PlatformNode;\n}\n\n// Directories where the static assets are located\nconst distDir = join(fileURLToPath(import.meta.url), '..', '..', 'dist');\nconst buildDir = join(distDir, 'build');\n\n// Allow for dynamic port\nconst PORT = process.env.PORT ?? 3000;\n\n// Create the Qwik City Node middleware\nconst { router, notFound } = createQwikCity({\n render,\n qwikCityPlan,\n manifest,\n // getOrigin(req) {\n // // If deploying under a proxy, you may need to build the origin from the request headers\n // // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Proto\n // const protocol = req.headers[\"x-forwarded-proto\"] ?? \"http\";\n // // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host\n // const host = req.headers[\"x-forwarded-host\"] ?? req.headers.host;\n // return `${protocol}://${host}`;\n // }\n});\n\n// Create the express server\n// https://expressjs.com/\nconst app = express();\n\n// Enable gzip compression\n// app.use(compression());\n\n// Static asset handlers\n// https://expressjs.com/en/starter/static-files.html\napp.use(`/build`, express.static(buildDir, { immutable: true, maxAge: '1y' }));\napp.use(express.static(distDir, { redirect: false }));\n\n// Use Qwik City's page and endpoint request handler\napp.use(router);\n\n// Use Qwik City's 404 handler\napp.use(notFound);\n\n// Start the express server\napp.listen(PORT, () => {\n /* eslint-disable */\n console.log(`Server started: http://localhost:${PORT}/`);\n});\n" }, { "path": "e2e/adapters-e2e/src/entry.preview.tsx", "content": "/*\n * WHAT IS THIS FILE?\n *\n * It's the bundle entry point for `npm run preview`.\n * That is, serving your app built in production mode.\n *\n * Feel free to modify this file, but don't remove it!\n *\n * Learn more about Vite's preview command:\n * - https://vitejs.dev/config/preview-options.html#preview-options\n *\n */\nimport { createQwikCity } from '@builder.io/qwik-city/middleware/node';\nimport qwikCityPlan from '@qwik-city-plan';\n// make sure qwikCityPlan is imported before entry\nimport render from './entry.ssr';\n\n/** The default export is the QwikCity adapter used by Vite preview. */\nexport default createQwikCity({ render, qwikCityPlan });\n" }, { "path": "e2e/adapters-e2e/src/entry.ssr.tsx", "content": "/**\n * WHAT IS THIS FILE?\n *\n * SSR entry point, in all cases the application is rendered outside the browser, this entry point\n * will be the common one.\n *\n * - Server (express, cloudflare...)\n * - Npm run start\n * - Npm run preview\n * - Npm run build\n */\nimport { renderToStream, type RenderToStreamOptions } from '@builder.io/qwik/server';\nimport { manifest } from '@qwik-client-manifest';\nimport Root from './root';\n\nexport default function (opts: RenderToStreamOptions) {\n return renderToStream(, {\n manifest,\n ...opts,\n // Use container attributes to set attributes on the html tag.\n containerAttributes: {\n lang: 'en-us',\n ...opts.containerAttributes,\n },\n // prefetchStrategy: {\n // implementation: {\n // linkInsert: \"html-append\",\n // linkRel: \"modulepreload\",\n // },\n // },\n serverData: {\n ...opts.serverData,\n },\n });\n}\n" }, { "path": "e2e/adapters-e2e/src/root.tsx", "content": "import { component$ } from '@builder.io/qwik';\nimport { QwikCityProvider, RouterOutlet, ServiceWorkerRegister } from '@builder.io/qwik-city';\nimport { RouterHead } from './components/router-head/router-head';\n\nexport default component$(() => {\n /**\n * The root of a QwikCity site always start with the component, immediately\n * followed by the document's and .\n *\n * Don't remove the `` and `` elements.\n */\n\n return (\n \n \n \n \n {/* \n */}\n \n \n \n \n \n \n );\n});\n" }, { "path": "e2e/adapters-e2e/src/routes/index.tsx", "content": "import { component$ } from '@builder.io/qwik';\nimport { type DocumentHead } from '@builder.io/qwik-city';\nimport ClickMe from '~/components/click-me/click-me';\n\nexport default component$(() => {\n return (\n <>\n go to profile\n
\n

Home page

\n
\n {/* We need to extract the component to see the bug on 1.5.7 */}\n \n \n );\n});\n\nexport const head: DocumentHead = {\n title: 'Welcome to Qwik',\n meta: [\n {\n name: 'description',\n content: 'Qwik site description',\n },\n ],\n};\n" }, { "path": "e2e/adapters-e2e/src/routes/layout.tsx", "content": "import { component$, Slot } from '@builder.io/qwik';\n\nexport default component$(() => {\n return ;\n});\n" }, { "path": "e2e/adapters-e2e/src/routes/profile/index.tsx", "content": "import { component$ } from '@builder.io/qwik';\n\nexport default component$(() => {\n return (\n <>\n go to home\n
\n

Profile page 🙂

\n \n );\n});\n" }, { "path": "e2e/adapters-e2e/src/routes/service-worker.ts", "content": "/*\n * WHAT IS THIS FILE?\n *\n * The service-worker.ts file is used to have state of the art prefetching.\n * https://qwik.dev/qwikcity/prefetching/overview/\n *\n * Qwik uses a service worker to speed up your site and reduce latency, ie, not used in the traditional way of offline.\n * You can also use this file to add more functionality that runs in the service worker.\n */\nimport { setupServiceWorker } from '@builder.io/qwik-city/service-worker';\n\nsetupServiceWorker();\n\naddEventListener('install', () => self.skipWaiting());\n\naddEventListener('activate', () => self.clients.claim());\n\ndeclare const self: ServiceWorkerGlobalScope;\n" }, { "path": "e2e/adapters-e2e/tests/express.spec.ts", "content": "import { expect, test } from '@playwright/test';\n\ntest.describe('Verifying Express Adapter', () => {\n test('should ignore unknown qdata', async ({ page, request }) => {\n page.goto('/');\n\n const response = await request.post('/?qfunc=ThisDoesNotExist', {\n headers: {\n 'X-Qrl': 'ThisDoesNotExist',\n 'Content-Type': 'application/qwik-json',\n },\n data: {\n _entry: '2',\n _objs: ['\\u0002_#s_ThisDoesNotExist', 1, ['0', '1']],\n },\n });\n\n await expect(response.status()).toBe(500);\n\n // Verify server is still responsive by making another request\n const healthCheck = await request.get('/');\n await expect(healthCheck.ok()).toBeTruthy();\n\n await page.getByRole('link', { name: 'go to profile' }).click();\n\n await expect(page.getByRole('heading', { name: 'Profile page' })).toBeVisible();\n });\n});\n" }, { "path": "e2e/adapters-e2e/tsconfig.json", "content": "{\n \"compilerOptions\": {\n \"baseUrl\": \".\",\n \"allowJs\": true,\n \"target\": \"ES2020\",\n \"module\": \"ES2022\",\n \"lib\": [\"es2022\", \"DOM\", \"WebWorker\", \"DOM.Iterable\"],\n \"jsx\": \"react-jsx\",\n \"jsxImportSource\": \"@builder.io/qwik\",\n \"strict\": true,\n \"forceConsistentCasingInFileNames\": true,\n \"resolveJsonModule\": true,\n \"moduleResolution\": \"Bundler\",\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"incremental\": true,\n \"isolatedModules\": true,\n \"outDir\": \"tmp\",\n \"noEmit\": true,\n \"paths\": {\n \"~/*\": [\"./src/*\"]\n }\n },\n\n \"include\": [\"src\", \"./*.d.ts\", \"./*.config.ts\"]\n}\n" }, { "path": "e2e/adapters-e2e/vite.config.ts", "content": "/**\n * This is the base config for vite. When building, the adapter config is used which loads this file\n * and extends it.\n */\nimport { qwikCity } from '@builder.io/qwik-city/vite';\nimport { qwikVite } from '@builder.io/qwik/optimizer';\nimport { defineConfig, type UserConfig } from 'vite';\nimport tsconfigPaths from 'vite-tsconfig-paths';\nimport pkg from './package.json';\n\ntype PkgDep = Record;\nconst { dependencies = {}, devDependencies = {} } = pkg as any as {\n dependencies: PkgDep;\n devDependencies: PkgDep;\n [key: string]: unknown;\n};\nerrorOnDuplicatesPkgDeps(devDependencies, dependencies);\n\n/**\n * Note that Vite normally starts from `index.html` but the qwikCity plugin makes start at\n * `src/entry.ssr.tsx` instead.\n */\nexport default defineConfig((): UserConfig => {\n return {\n plugins: [qwikCity(), qwikVite(), tsconfigPaths({ root: '.' })],\n // This tells Vite which dependencies to pre-build in dev mode.\n optimizeDeps: {\n // Put problematic deps that break bundling here, mostly those with binaries.\n // For example ['better-sqlite3'] if you use that in server functions.\n exclude: [],\n },\n\n /**\n * This is an advanced setting. It improves the bundling of your server code. To use it, make\n * sure you understand when your consumed packages are dependencies or dev dependencies.\n * (otherwise things will break in production)\n */\n // ssr:\n // command === \"build\" && mode === \"production\"\n // ? {\n // // All dev dependencies should be bundled in the server build\n // noExternal: Object.keys(devDependencies),\n // // Anything marked as a dependency will not be bundled\n // // These should only be production binary deps (including deps of deps), CLI deps, and their module graph\n // // If a dep-of-dep needs to be external, add it here\n // // For example, if something uses `bcrypt` but you don't have it as a dep, you can write\n // // external: [...Object.keys(dependencies), 'bcrypt']\n // external: Object.keys(dependencies),\n // }\n // : undefined,\n\n server: {\n headers: {\n // Don't cache the server response in dev mode\n 'Cache-Control': 'public, max-age=0',\n },\n },\n preview: {\n headers: {\n // Do cache the server response in preview (non-adapter production build)\n 'Cache-Control': 'public, max-age=360',\n },\n },\n };\n});\n\n// *** utils ***\n\n/**\n * Function to identify duplicate dependencies and throw an error\n *\n * @param {Object} devDependencies - List of development dependencies\n * @param {Object} dependencies - List of production dependencies\n */\nfunction errorOnDuplicatesPkgDeps(devDependencies: PkgDep, dependencies: PkgDep) {\n let msg = '';\n // Create an array 'duplicateDeps' by filtering devDependencies.\n // If a dependency also exists in dependencies, it is considered a duplicate.\n const duplicateDeps = Object.keys(devDependencies).filter((dep) => dependencies[dep]);\n\n // include any known qwik packages\n const qwikPkg = Object.keys(dependencies).filter((value) => /qwik/i.test(value));\n\n // any errors for missing \"qwik-city-plan\"\n // [PLUGIN_ERROR]: Invalid module \"@qwik-city-plan\" is not a valid package\n msg = `Move qwik packages ${qwikPkg.join(', ')} to devDependencies`;\n\n if (qwikPkg.length > 0) {\n throw new Error(msg);\n }\n\n // Format the error message with the duplicates list.\n // The `join` function is used to represent the elements of the 'duplicateDeps' array as a comma-separated string.\n msg = `\n Warning: The dependency \"${duplicateDeps.join(', ')}\" is listed in both \"devDependencies\" and \"dependencies\".\n Please move the duplicated dependencies to \"devDependencies\" only and remove it from \"dependencies\"\n `;\n\n // Throw an error with the constructed message.\n if (duplicateDeps.length > 0) {\n throw new Error(msg);\n }\n}\n" }, { "path": "e2e/docs-e2e/.gitignore", "content": "\n# Playwright\nnode_modules/\n/test-results/\n/playwright-report/\n/blob-report/\n/playwright/.cache/\n" }, { "path": "e2e/docs-e2e/package.json", "content": "{\n \"name\": \"docs-e2e\",\n \"description\": \"\",\n \"private\": true,\n \"author\": \"\",\n \"devDependencies\": {\n \"@playwright/test\": \"1.54.1\",\n \"@types/node\": \"20.19.0\"\n },\n \"keywords\": [],\n \"license\": \"ISC\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"test\": \"pnpm exec playwright test --config=playwright.config.ts --project=chromium\",\n \"test-ui\": \"pnpm exec playwright test --config=playwright.config.ts --project=chromium --ui\"\n },\n \"type\": \"commonjs\"\n}\n" }, { "path": "e2e/docs-e2e/playwright.config.ts", "content": "import { defineConfig, devices } from '@playwright/test';\n\n/** Read environment variables from file. https://github.com/motdotla/dotenv */\n// import dotenv from 'dotenv';\n// import path from 'path';\n// dotenv.config({ path: path.resolve(__dirname, '.env') });\n\n/** See https://playwright.dev/docs/test-configuration. */\n\nconst TestingURL = 'http://127.0.0.1:3000';\n\nexport default defineConfig({\n testDir: './tests',\n /* Global timeout for each test */\n timeout: 60_000,\n expect: { timeout: 60_000 },\n /* Run tests in files in parallel */\n fullyParallel: true,\n /* Fail the build on CI if you accidentally left test.only in the source code. */\n forbidOnly: !!process.env.CI,\n /* Retry on CI only */\n retries: process.env.CI ? 2 : 0,\n /* Opt out of parallel tests on CI. */\n workers: process.env.CI ? 1 : undefined,\n /* Reporter to use. See https://playwright.dev/docs/test-reporters */\n reporter: 'html',\n /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */\n use: {\n /* Base URL to use in actions like `await page.goto('/')`. */\n baseURL: TestingURL,\n actionTimeout: 30_000,\n navigationTimeout: 60_000,\n /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */\n trace: 'on-first-retry',\n },\n\n /* Configure projects for major browsers */\n projects: [\n {\n name: 'chromium',\n use: { ...devices['Desktop Chrome'] },\n },\n {\n name: 'chrome',\n use: { ...devices['Desktop Chrome'] },\n },\n\n {\n name: 'firefox',\n use: { ...devices['Desktop Firefox'] },\n },\n\n {\n name: 'webkit',\n use: { ...devices['Desktop Safari'] },\n },\n\n /* Test against mobile viewports. */\n // {\n // name: 'Mobile Chrome',\n // use: { ...devices['Pixel 5'] },\n // },\n // {\n // name: 'Mobile Safari',\n // use: { ...devices['iPhone 12'] },\n // },\n\n /* Test against branded browsers. */\n // {\n // name: 'Microsoft Edge',\n // use: { ...devices['Desktop Edge'], channel: 'msedge' },\n // },\n // {\n // name: 'Google Chrome',\n // use: { ...devices['Desktop Chrome'], channel: 'chrome' },\n // },\n ],\n\n /* Run your local dev server before starting the tests */\n webServer: {\n command: 'pnpm -C ../../ run docs.dev',\n url: TestingURL,\n reuseExistingServer: !process.env.CI,\n },\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/advanced-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Advanced Dollar Function page loads', async ({ page }) => {\n await page.goto('/docs/advanced/dollar/');\n\n await expect(page).toHaveTitle('The $ dollar sign | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Containers page loads', async ({ page }) => {\n await page.goto('/docs/advanced/containers/');\n await expect(page).toHaveTitle('Containers | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced QRL page loads', async ({ page }) => {\n await page.goto('/docs/advanced/qrl/');\n await expect(page).toHaveTitle('QRL | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Library page loads', async ({ page }) => {\n await page.goto('/docs/advanced/library/');\n await expect(page).toHaveTitle('Component library | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Qwikloader page loads', async ({ page }) => {\n await page.goto('/docs/advanced/qwikloader/');\n await expect(page).toHaveTitle('Qwikloader | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Optimizer page loads', async ({ page }) => {\n await page.goto('/docs/advanced/optimizer/');\n await expect(page).toHaveTitle('Optimizer Rules | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Prefetching Modules page loads', async ({ page }) => {\n await page.goto('/docs/advanced/modules-prefetching/');\n await expect(page).toHaveTitle('Prefetching | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Custom Build Directory page loads', async ({ page }) => {\n await page.goto('/docs/advanced/custom-build-dir/');\n await expect(page).toHaveTitle('Custom Build Output Directory | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Vite page loads', async ({ page }) => {\n await page.goto('/docs/advanced/vite/');\n await expect(page).toHaveTitle('Vite | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Routing page loads', async ({ page }) => {\n await page.goto('/docs/advanced/routing/');\n await expect(page).toHaveTitle('Advanced Routing | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Advanced Plugins page loads', async ({ page }) => {\n await page.goto('/docs/advanced/plugins/');\n await expect(page).toHaveTitle('Qwik Plugins | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Advanced Request Handling page loads', async ({ page }) => {\n await page.goto('/docs/advanced/request-handling/');\n await expect(page).toHaveTitle('Request Handling | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Speculative Module Fetching page loads', async ({ page }) => {\n await page.goto('/docs/advanced/speculative-module-fetching/');\n await expect(page).toHaveTitle('Speculative Module Fetching | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Menu page loads', async ({ page }) => {\n await page.goto('/docs/advanced/menu/');\n await expect(page).toHaveTitle('Menu | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Generating Sitemaps page loads', async ({ page }) => {\n await page.goto('/docs/advanced/sitemaps/');\n await expect(page).toHaveTitle('Generating Sitemaps | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced ESLint-Rules page loads', async ({ page }) => {\n await page.goto('/docs/advanced/eslint/');\n // currently does not have a custom title\n await expect(page).toHaveTitle('Qwik - Framework reimagined for the edge');\n});\n\ntest('Advanced Content Security Policy page loads', async ({ page }) => {\n await page.goto('/docs/advanced/content-security-policy/');\n await expect(page).toHaveTitle('Content Security Policy | Advanced 📚 Qwik Documentation');\n});\n\ntest('Advanced Complex Forms page loads', async ({ page }) => {\n await page.goto('/docs/advanced/complex-forms/');\n await expect(page).toHaveTitle('Complex Forms | Advanced 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/community-pages.load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Community Projects page loads', async ({ page }) => {\n await page.goto('/community/projects/');\n await expect(page).toHaveTitle('Projects | Qwik Community 📚 Qwik Documentation');\n});\n\ntest('Community Groups page loads', async ({ page }) => {\n await page.goto('/community/groups/');\n await expect(page).toHaveTitle('Groups | Qwik Community 📚 Qwik Documentation');\n});\n\ntest('Community Values page loads', async ({ page }) => {\n await page.goto('/community/values/');\n await expect(page).toHaveTitle('Values | Qwik Community 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/concepts-pages-laod.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Concepts Think Qwik page loads', async ({ page }) => {\n await page.goto('/docs/concepts/think-qwik/');\n await expect(page).toHaveTitle('Think Qwik | Concepts 📚 Qwik Documentation');\n});\n\ntest('Concepts Resumable page loads', async ({ page }) => {\n await page.goto('/docs/concepts/resumable/');\n await expect(page).toHaveTitle('Resumable | Concepts 📚 Qwik Documentation');\n});\n\ntest('Concepts Progressive page loads', async ({ page }) => {\n await page.goto('/docs/concepts/progressive/');\n await expect(page).toHaveTitle('Progressive | Concepts 📚 Qwik Documentation');\n});\n\ntest('Concepts Reactivity page loads', async ({ page }) => {\n await page.goto('/docs/concepts/reactivity/');\n await expect(page).toHaveTitle('Reactivity | Concepts 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/cookbook-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Cookbook Overview page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/');\n await expect(page).toHaveTitle('Cookbook | Overview 📚 Qwik Documentation');\n});\n\ntest('Cookbook Algolia Search page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/algolia-search/');\n await expect(page).toHaveTitle('Cookbook | Algolia Search 📚 Qwik Documentation');\n});\n\ntest('Cookbook Combine Request Handlers page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/combine-request-handlers/');\n await expect(page).toHaveTitle('Cookbook | Combine Request Handlers 📚 Qwik Documentation');\n});\n\ntest('Cookbook Debouncer page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/debouncer/');\n await expect(page).toHaveTitle('Cookbook | Debouncer 📚 Qwik Documentation');\n});\n\ntest('Cookbook Fonts page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/fonts/');\n await expect(page).toHaveTitle('Cookbook | Font optimization 📚 Qwik Documentation');\n});\n\ntest('Cookbook Glob Import & Dynamic Import page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/glob-import/');\n await expect(page).toHaveTitle(\n 'Cookbook | Glob Import with import.meta.glob 📚 Qwik Documentation'\n );\n});\n\ntest('Cookbook NavLink Component page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/nav-link/');\n await expect(page).toHaveTitle('Cookbook | Navbar link 📚 Qwik Documentation');\n});\n\ntest('Cookbook Deploy with Node using Docker page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/node-docker-deploy/');\n await expect(page).toHaveTitle('Cookbook | Deploy with Node using Docker 📚 Qwik Documentation');\n});\n\ntest('Cookbook Portals page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/portals/');\n await expect(page).toHaveTitle('Cookbook | Portals 📚 Qwik Documentation');\n});\n\ntest('Cookbook Streaming/deferred loaders page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/streaming-deferred-loaders/');\n await expect(page).toHaveTitle('Cookbook | Streaming/deferred loaders 📚 Qwik Documentation');\n});\n\ntest('Cookbook sync$ Events page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/sync-events/');\n await expect(page).toHaveTitle('Cookbook | Synchronous Events with State 📚 Qwik Documentation');\n});\n\ntest('Cookbook Theme Management page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/theme-management/');\n await expect(page).toHaveTitle('Cookbook | Dark and Light Theme 📚 Qwik Documentation');\n});\n\ntest('Cookbook Drag & Drop page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/drag&drop/');\n await expect(page).toHaveTitle('Cookbook | Drag & Drop 📚 Qwik Documentation');\n});\n\ntest('Cookbook View Transition API page loads', async ({ page }) => {\n await page.goto('/docs/cookbook/view-transition/');\n await expect(page).toHaveTitle('Cookbook | View Transition API 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/deployments-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Deployments Overview page loads', async ({ page }) => {\n await page.goto('/docs/deployments/');\n await expect(page).toHaveTitle('Deployments | Guides 📚 Qwik Documentation');\n});\n\ntest('Deployments Azure Static Web Apps Middleware page loads', async ({ page }) => {\n await page.goto('/docs/deployments/azure-swa/');\n await expect(page).toHaveTitle('Azure Static Web Apps | Deployments 📚 Qwik Documentation');\n});\n\ntest('Deployments AWS Adapter page loads', async ({ page }) => {\n await page.goto('/docs/deployments/aws-lambda/');\n await expect(page).toHaveTitle('AWS Lambda | Deployments 📚 Qwik Documentation');\n});\n\ntest('Deployments Firebase Adapter page loads', async ({ page }) => {\n await page.goto('/docs/deployments/firebase/');\n await expect(page).toHaveTitle('Firebase | Deployments 📚 Qwik Documentation');\n});\n\ntest('Deployments Google Cloud Run Middleware page loads', async ({ page }) => {\n await page.goto('/docs/deployments/gcp-cloud-run/');\n await expect(page).toHaveTitle('Cloud Run Middleware | Deployments 📚 Qwik Documentation');\n});\n\ntest('Deployments Cloudflare Pages Adapter page loads', async ({ page }) => {\n await page.goto('/docs/deployments/cloudflare-pages/');\n await expect(page).toHaveTitle(\n 'Cloudflare Pages Adapter and Middleware | Deployments 📚 Qwik Documentation'\n );\n});\n\ntest('Deployments Cloudflare Workers Adapter page loads', async ({ page }) => {\n await page.goto('/docs/deployments/cloudflare-workers/');\n await expect(page).toHaveTitle(\n 'Cloudflare Workers Adapter and Middleware | Deployments 📚 Qwik Documentation'\n );\n});\n\ntest('Deployments Deno Middleware page loads', async ({ page }) => {\n await page.goto('/docs/deployments/deno/');\n await expect(page).toHaveTitle('Deno Middleware | Deployments 📚 Qwik Documentation');\n});\n\ntest('Deployments Bun Middleware page loads', async ({ page }) => {\n await page.goto('/docs/deployments/bun/');\n await expect(page).toHaveTitle('Bun Middleware | Deployments 📚 Qwik Documentation');\n});\n\ntest('Deployments Netlify Edge Adapter page loads', async ({ page }) => {\n await page.goto('/docs/deployments/netlify-edge/');\n await expect(page).toHaveTitle(\n 'Netlify Edge Adapter and Middleware | Deployments 📚 Qwik Documentation'\n );\n});\n\ntest('Deployments Node Middleware page loads', async ({ page }) => {\n await page.goto('/docs/deployments/node/');\n await expect(page).toHaveTitle('Node Middleware | Deployments 📚 Qwik Documentation');\n});\n\ntest('Deployments Vercel Edge Adapter page loads', async ({ page }) => {\n await page.goto('/docs/deployments/vercel-edge/');\n await expect(page).toHaveTitle(\n 'Vercel Edge Adapter and Middleware | Deployments 📚 Qwik Documentation'\n );\n});\n\ntest('Deployments Static Site Adapter page loads', async ({ page }) => {\n await page.goto('/docs/deployments/static/');\n await expect(page).toHaveTitle('Static Site 📚 Qwik Documentation');\n});\n\ntest('Deployments GitHub Pages Adapter page loads', async ({ page }) => {\n await page.goto('/docs/deployments/github-pages/');\n await expect(page).toHaveTitle('GitHub Pages 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/docs-components-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Components Overview page loads', async ({ page }) => {\n await page.goto('/docs/core/overview/');\n await expect(page).toHaveTitle('Overview | Components 📚 Qwik Documentation');\n});\n\ntest('Components State page loads', async ({ page }) => {\n await page.goto('/docs/core/state/');\n await expect(page).toHaveTitle('State | Components 📚 Qwik Documentation');\n});\n\ntest('Components Tasks and Lifecycle page loads', async ({ page }) => {\n await page.goto('/docs/core/tasks/');\n await expect(page).toHaveTitle('Tasks and Lifecycle | Components 📚 Qwik Documentation');\n});\n\ntest('Components Context page loads', async ({ page }) => {\n await page.goto('/docs/core/context/');\n await expect(page).toHaveTitle('Context | Components 📚 Qwik Documentation');\n});\n\ntest('Components Slots page loads', async ({ page }) => {\n await page.goto('/docs/core/slots/');\n await expect(page).toHaveTitle('Slots | Components 📚 Qwik Documentation');\n});\n\ntest('Components Rendering page loads', async ({ page }) => {\n await page.goto('/docs/core/rendering/');\n await expect(page).toHaveTitle('Rendering | Components 📚 Qwik Documentation');\n});\n\ntest('Components Styles page loads', async ({ page }) => {\n await page.goto('/docs/core/styles/');\n await expect(page).toHaveTitle('Styles | Components 📚 Qwik Documentation');\n});\n\ntest('Components API Reference page loads', async ({ page }) => {\n await page.goto('/api/qwik/');\n\n // todo V2: change this to @qwik.dev\n await expect(page).toHaveTitle('@builder.io/qwik API Reference 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/guides-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Guides Qwik in a nutshell page loads', async ({ page }) => {\n await page.goto('/docs/guides/qwik-nutshell/');\n await expect(page).toHaveTitle('Qwik in a nutshell | Introduction 📚 Qwik Documentation');\n});\n\ntest('Guides MDX page loads', async ({ page }) => {\n await page.goto('/docs/guides/mdx/');\n await expect(page).toHaveTitle('Markdown and MDX | Guides 📚 Qwik Documentation');\n});\n\ntest('Guides SSG page loads', async ({ page }) => {\n await page.goto('/docs/guides/static-site-generation/');\n await expect(page).toHaveTitle(\n 'Static Site Generation (SSG) Overview | Guides 📚 Qwik Documentation'\n );\n});\n\ntest('Guides Capacitor page loads', async ({ page }) => {\n await page.goto('/docs/guides/capacitor/');\n await expect(page).toHaveTitle('Qwik Hybrid Native App Overview | Guides 📚 Qwik Documentation');\n});\n\ntest('Guides React Cheat Sheet page loads', async ({ page }) => {\n await page.goto('/docs/guides/react-cheat-sheet/');\n await expect(page).toHaveTitle('Qwik for React developers 📚 Qwik Documentation');\n});\n\ntest('Guides Best Practices page loads', async ({ page }) => {\n await page.goto('/docs/guides/best-practices/');\n await expect(page).toHaveTitle('Best Practices | Guides 📚 Qwik Documentation');\n});\n\ntest('Guides Bundle Optimization page loads', async ({ page }) => {\n await page.goto('/docs/guides/bundle/');\n await expect(page).toHaveTitle('Bundle Optimization | Guides 📚 Qwik Documentation');\n});\n\ntest('Guides Environment Variables page loads', async ({ page }) => {\n await page.goto('/docs/guides/env-variables/');\n await expect(page).toHaveTitle('Environment variables | Qwik City 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/integrations-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Integrations Overview page loads', async ({ page }) => {\n await page.goto('/docs/integrations/');\n await expect(page).toHaveTitle('Qwik City Integrations | Guides 📚 Qwik Documentation');\n});\n\ntest('Integrations Astro page loads', async ({ page }) => {\n await page.goto('/docs/integrations/astro/');\n await expect(page).toHaveTitle('Astro | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Auth.js page loads', async ({ page }) => {\n await page.goto('/docs/integrations/authjs/');\n await expect(page).toHaveTitle('Auth.js | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Bootstrap page loads', async ({ page }) => {\n await page.goto('/docs/integrations/bootstrap/');\n await expect(page).toHaveTitle('Bootstrap | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Builder.io page loads', async ({ page }) => {\n await page.goto('/docs/integrations/builderio/');\n await expect(page).toHaveTitle('Builder.io | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Cypress page loads', async ({ page }) => {\n await page.goto('/docs/integrations/cypress/');\n await expect(page).toHaveTitle('Cypress | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Drizzle page loads', async ({ page }) => {\n await page.goto('/docs/integrations/drizzle/');\n await expect(page).toHaveTitle('Drizzle | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Internationalization page loads', async ({ page }) => {\n await page.goto('/docs/integrations/i18n/');\n await expect(page).toHaveTitle('Internationalization | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Icons page loads', async ({ page }) => {\n await page.goto('/docs/integrations/icons/');\n await expect(page).toHaveTitle('Icons | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Image Optimization page loads', async ({ page }) => {\n await page.goto('/docs/integrations/image-optimization/');\n await expect(page).toHaveTitle('Image Optimization | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations LeafletJS Map page loads', async ({ page }) => {\n await page.goto('/docs/integrations/leaflet-map/');\n await expect(page).toHaveTitle('LeafletJS Map | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Modular Forms page loads', async ({ page }) => {\n await page.goto('/docs/integrations/modular-forms/');\n await expect(page).toHaveTitle('Modular Forms | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Nx and enterprise scale monorepos page loads', async ({ page }) => {\n await page.goto('/docs/integrations/nx/');\n await expect(page).toHaveTitle('Nx Monorepos | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations OG Image / Open Graph Image page loads', async ({ page }) => {\n await page.goto('/docs/integrations/og-img/');\n await expect(page).toHaveTitle('OG Image (og-img) | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Orama page loads', async ({ page }) => {\n await page.goto('/docs/integrations/orama/');\n await expect(page).toHaveTitle('Qwik City and Orama 📚 Qwik Documentation');\n});\n\ntest('Integrations Panda CSS page loads', async ({ page }) => {\n await page.goto('/docs/integrations/panda-css/');\n await expect(page).toHaveTitle('Panda CSS | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Partytown page loads', async ({ page }) => {\n await page.goto('/docs/integrations/partytown/');\n await expect(page).toHaveTitle('Partytown | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Playwright page loads', async ({ page }) => {\n await page.goto('/docs/integrations/playwright/');\n await expect(page).toHaveTitle('Playwright | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations PostCSS page loads', async ({ page }) => {\n await page.goto('/docs/integrations/postcss/');\n await expect(page).toHaveTitle('PostCSS | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Prisma page loads', async ({ page }) => {\n await page.goto('/docs/integrations/prisma/');\n await expect(page).toHaveTitle('Prisma | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Qwik React page loads', async ({ page }) => {\n await page.goto('/docs/integrations/react/');\n await expect(page).toHaveTitle('React | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Storybook page loads', async ({ page }) => {\n await page.goto('/docs/integrations/storybook/');\n await expect(page).toHaveTitle('Storybook | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Styled Vanilla Extract page loads', async ({ page }) => {\n await page.goto('/docs/integrations/styled-vanilla-extract/');\n await expect(page).toHaveTitle('Styled Vanilla Extract | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Supabase page loads', async ({ page }) => {\n await page.goto('/docs/integrations/supabase/');\n await expect(page).toHaveTitle('Supabase | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Tailwind page loads', async ({ page }) => {\n await page.goto('/docs/integrations/tailwind/');\n await expect(page).toHaveTitle('Tailwind | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Tauri page loads', async ({ page }) => {\n await page.goto('/docs/integrations/tauri/');\n await expect(page).toHaveTitle('Tauri | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Turso page loads', async ({ page }) => {\n await page.goto('/docs/integrations/turso/');\n await expect(page).toHaveTitle('Turso | Integrations 📚 Qwik Documentation');\n});\n\ntest('Integrations Vitest page loads', async ({ page }) => {\n await page.goto('/docs/integrations/vitest/');\n await expect(page).toHaveTitle('Vitest | Integrations 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/navBarOnMobile.spec.ts", "content": "import { test, expect, devices } from '@playwright/test';\n\ntest.use({\n ...devices['iPhone 13'],\n});\n\ntest('navbar on mobile', async ({ page }) => {\n await page.goto('/');\n const openIcon = page.locator('.mobile-menu > .more-icon > svg');\n const closeIcon = page.locator('.mobile-menu > .close-icon > svg');\n const navToolKit = page.locator('.menu-toolkit');\n const body = page.locator('body');\n\n expect(body).not.toHaveClass('header-open');\n await expect(openIcon).toBeVisible();\n await openIcon.click();\n expect(body).toHaveClass('header-open');\n await expect(closeIcon).toBeVisible();\n\n await expect(navToolKit).toBeVisible();\n const menuItems = await page.locator('.menu-toolkit > li > a').allTextContents();\n const expectedMenuLinks = [\n 'Docs',\n 'Ecosystem',\n 'Tutorial',\n 'Qwik Sandbox',\n 'Blog',\n 'GitHub',\n '@QwikDev',\n 'Discord',\n ];\n\n expect(menuItems).toStrictEqual(expectedMenuLinks);\n\n await closeIcon.click();\n expect(body).not.toHaveClass('header-open');\n await expect(closeIcon).not.toBeVisible();\n await expect(openIcon).toBeVisible();\n await expect(navToolKit).not.toBeVisible();\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/pages-load-test.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('home page loads', async ({ page }) => {\n await page.goto('/');\n await expect(page).toHaveTitle('Framework reimagined for the edge! 📚 Qwik Documentation');\n});\n\ntest('docs page loads', async ({ page }) => {\n await page.goto('/docs/');\n\n await expect(page).toHaveTitle('Overview | Introduction 📚 Qwik Documentation');\n\n const introductionLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Introduction\")) ul li a')\n .allTextContents();\n\n const expectedIntroductionLinks = ['Overview', 'Getting Started', 'Project structure', 'FAQ'];\n\n expect(introductionLinksOnPage).toStrictEqual(expectedIntroductionLinks);\n\n const componentsLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Components\")) ul li a')\n .allTextContents();\n\n const expectedComponentLinks = [\n 'Overview',\n 'State',\n 'Events',\n 'Tasks & Lifecycle',\n 'Context',\n 'Slots',\n 'Rendering',\n 'Styling',\n 'API Reference',\n ];\n\n expect(componentsLinksOnPage).toStrictEqual(expectedComponentLinks);\n\n const qwikCityLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Qwik City\")) ul li a')\n .allTextContents();\n\n const expectedQwikCityLinks = [\n 'Overview',\n 'Routing',\n 'Pages',\n 'Layouts',\n 'Loaders',\n 'Actions',\n 'Validators',\n 'Endpoints',\n 'Middleware',\n 'server$',\n 'Error handling',\n 'Re-exporting loaders',\n 'Caching',\n 'HTML attributes',\n 'API reference',\n ];\n\n expect(qwikCityLinksOnPage).toStrictEqual(expectedQwikCityLinks);\n\n const cookbookLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Cookbook\")) ul li a')\n .allTextContents();\n\n const expectedCookbookLinks = [\n 'Overview',\n 'Algolia Search',\n 'Combine Handlers',\n 'Debouncer',\n 'Fonts',\n 'Glob Import',\n 'Media Controller',\n 'NavLink',\n 'Node Docker deploy',\n 'Portals',\n 'Streaming loaders',\n 'Sync events w state',\n 'Theme Management',\n 'Drag & Drop',\n 'View Transition',\n ];\n\n // if you are adding a new page to the cookbook, please add a new test for the page to load too\n expect(cookbookLinksOnPage).toStrictEqual(expectedCookbookLinks);\n\n const integrationsLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Integrations\")) ul li a')\n .allTextContents();\n\n const expectedIntegrationsLinks = [\n 'Overview',\n 'Astro',\n 'Auth.js',\n 'Bootstrap',\n 'Builder.io',\n 'Cypress',\n 'Drizzle',\n 'i18n',\n 'Icons',\n 'Image Optimization',\n 'Leaflet Map',\n 'Modular Forms',\n 'Nx Monorepos',\n 'OG Image',\n 'Orama',\n 'Panda CSS',\n 'Partytown',\n 'Playwright',\n 'PostCSS',\n 'Prisma',\n 'React',\n 'Storybook',\n 'Styled Vanilla Extract',\n 'Supabase',\n 'Tailwind',\n 'Tauri',\n 'Turso',\n 'Vitest',\n ];\n\n expect(integrationsLinksOnPage).toStrictEqual(expectedIntegrationsLinks);\n\n const deploymentsLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Deployments\")) ul li a')\n .allTextContents();\n\n const expectedDeploymentsLinks = [\n 'Overview',\n 'Azure SWA',\n 'AWS',\n 'Firebase',\n 'Google Cloud Run',\n 'Cloudflare Pages',\n 'Cloudflare Workers',\n 'Deno',\n 'Bun',\n 'Netlify Edge',\n 'Node',\n 'Self-Hosting',\n 'Vercel Edge',\n 'Static Site',\n 'Azion',\n ];\n\n expect(deploymentsLinksOnPage).toStrictEqual(expectedDeploymentsLinks);\n\n const guidesLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Guides\")) ul li a')\n .allTextContents();\n\n const expectedGuidesLinks = [\n 'Qwik in a nutshell',\n 'Markdown & MDX',\n 'SSG',\n 'Qwik Native Apps',\n 'React Cheat Sheet',\n 'Debugging',\n 'Best Practices',\n 'Bundle Optimization',\n 'Env variables',\n ];\n\n expect(guidesLinksOnPage).toStrictEqual(expectedGuidesLinks);\n\n const conceptsLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Concepts\")) ul li a')\n .allTextContents();\n\n const expectedConceptsLinks = ['Think Qwik', 'Resumable', 'Progressive', 'Reactivity'];\n\n expect(conceptsLinksOnPage).toStrictEqual(expectedConceptsLinks);\n\n const advancedLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Advanced\")) ul li a')\n .allTextContents();\n\n const expectedAdvancedLinks = [\n 'The $ dollar sign',\n 'Containers',\n 'QRL',\n 'Library mode',\n 'Qwikloader',\n 'Optimizer',\n 'Modules Prefetching',\n 'Build Directory',\n 'Vite',\n 'Advanced Routing',\n 'Qwik Plugins',\n 'Request Handling',\n 'Speculative Module Fetching',\n 'Menus',\n 'Static Assets',\n 'Sitemaps',\n 'ESLint-Rules',\n 'Content Security Policy',\n 'Complex Forms',\n ];\n\n expect(advancedLinksOnPage).toStrictEqual(expectedAdvancedLinks);\n\n const referenceLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Reference\")) ul li a')\n .allTextContents();\n\n const expectedReferenceLinks = ['API Reference', 'Deprecated Features'];\n\n expect(referenceLinksOnPage).toStrictEqual(expectedReferenceLinks);\n\n const qwikLabsLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Qwik Labs 🧪\")) ul li a')\n .allTextContents();\n\n const expectedQwikLabsLinks = [\n 'Overview',\n 'Insights',\n 'Typed Routes',\n 'Devtools',\n 'usePreventNavigate',\n ];\n\n expect(qwikLabsLinksOnPage).toStrictEqual(expectedQwikLabsLinks);\n\n const communityLinksOnPage = await page\n .locator('#qwik-sidebar')\n .locator('details:has(summary h5:text(\"Community\")) ul li a')\n .allTextContents();\n\n const expectedCommunityLinks = ['GitHub', '@QwikDev', 'Discord', 'Community Projects', 'Values'];\n\n expect(communityLinksOnPage).toStrictEqual(expectedCommunityLinks);\n});\n\ntest('getting started page loads', async ({ page }) => {\n await page.goto('/docs/getting-started/');\n await expect(page).toHaveTitle('Getting Started | Introduction 📚 Qwik Documentation');\n});\n\ntest('Project Structure page loads', async ({ page }) => {\n await page.goto('/docs/project-structure/');\n await expect(page).toHaveTitle('Project Structure | Qwik City 📚 Qwik Documentation');\n});\n\ntest('FAQ page loads', async ({ page }) => {\n await page.goto('/docs/faq/');\n await expect(page).toHaveTitle('Frequently Asked Questions | Introduction 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/qwik-city-pages-load.spec.ts", "content": "// todo V2: rename file to qwik-router-pages-load.spec.ts\n// todo V2: replace all instances of Qwik City with Qwik Router\nimport { test, expect } from '@playwright/test';\n\ntest('Qwik City Overview page loads', async ({ page }) => {\n await page.goto('/docs/qwikcity/');\n await expect(page).toHaveTitle('Overview | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Qwik City Routing page loads', async ({ page }) => {\n await page.goto('/docs/routing/');\n await expect(page).toHaveTitle('Routing | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Qwik City Pages page loads', async ({ page }) => {\n await page.goto('/docs/pages/');\n await expect(page).toHaveTitle('Pages | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Qwik City Layout page loads', async ({ page }) => {\n await page.goto('/docs/layout/');\n await expect(page).toHaveTitle('Layout & Middleware | Guides 📚 Qwik Documentation');\n});\n\ntest('Qwik City Route Loader page loads', async ({ page }) => {\n await page.goto('/docs/route-loader/');\n await expect(page).toHaveTitle('RouteLoader$ | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Qwik City Route Action page loads', async ({ page }) => {\n await page.goto('/docs/action/');\n await expect(page).toHaveTitle('RouteAction$ | QwikCity 📚 Qwik Documentation');\n});\n\ntest('Qwik City Endpoints page loads', async ({ page }) => {\n await page.goto('/docs/endpoints/');\n await expect(page).toHaveTitle('Endpoints | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Qwik City Middleware page loads', async ({ page }) => {\n await page.goto('/docs/middleware/');\n await expect(page).toHaveTitle('Middleware | Guides 📚 Qwik Documentation');\n});\n\ntest('Qwik City server$ page loads', async ({ page }) => {\n await page.goto('/docs/server$/');\n await expect(page).toHaveTitle('server$ | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Qwik City Error Handling page loads', async ({ page }) => {\n await page.goto('/docs/error-handling/');\n await expect(page).toHaveTitle('Error handling | Qwik City 📚 Qwik Documentation');\n});\n\ntest('Qwik City Re-exporting Loaders page loads', async ({ page }) => {\n await page.goto('/docs/re-exporting-loaders/');\n await expect(page).toHaveTitle('Cookbook | Re-exporting loaders 📚 Qwik Documentation');\n});\n\ntest('Qwik City HTML Attributes page loads', async ({ page }) => {\n await page.goto('/docs/html-attributes/');\n await expect(page).toHaveTitle('HTML attributes | QwikCity 📚 Qwik Documentation');\n});\n\ntest('Qwik City API Reference page loads', async ({ page }) => {\n await page.goto('/docs/api/');\n await expect(page).toHaveTitle('API Reference | Qwik City 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/qwik-labs-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Qwik Labs Overview page loads', async ({ page }) => {\n await page.goto('/docs/labs/');\n await expect(page).toHaveTitle('🧪 Qwik Labs | Overview 📚 Qwik Documentation');\n});\n\ntest('Qwik Labs Insights page loads', async ({ page }) => {\n await page.goto('/docs/labs/insights/');\n await expect(page).toHaveTitle('🧪 Insights | Qwik Labs 📚 Qwik Documentation');\n});\n\ntest('Qwik Labs usePreventNavigate page loads', async ({ page }) => {\n await page.goto('/docs/labs/usePreventNavigate/');\n await expect(page).toHaveTitle('🧪 usePreventNavigate | Qwik Labs 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/reference-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('API Reference page loads', async ({ page }) => {\n await page.goto('/api/');\n await expect(page).toHaveTitle('Qwik - Framework reimagined for the edge');\n});\n\ntest('API Reference Deprecated Features page loads', async ({ page }) => {\n await page.goto('/docs/deprecated-features/');\n await expect(page).toHaveTitle('Deprecated Features | Guides 📚 Qwik Documentation');\n});\n" }, { "path": "e2e/docs-e2e/tests/Docs/searchBar.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('search bar with click results', async ({ page }) => {\n await page.goto('/');\n await page.getByRole('button', { name: 'Search' }).click();\n await page.getByPlaceholder('Search docs').fill('getting started qwikly');\n await page.waitForSelector('.DocSearch-Hit', { timeout: 5000 });\n const countOfSearchResults = await page.locator('.DocSearch-Hit').count();\n expect(countOfSearchResults).toBeGreaterThan(0);\n await page.getByRole('link', { name: 'Getting Started Qwikly', exact: true }).click();\n await expect(page).toHaveURL('docs/getting-started/#getting-started-qwikly');\n});\n\ntest('search with no results', async ({ page }) => {\n await page.goto('/');\n await page.getByRole('button', { name: 'Search' }).click();\n await page.getByPlaceholder('Search docs').fill('xyz123nonexistentquery');\n await page.waitForTimeout(1000);\n const noResults = page.locator('.DocSearch-NoResults, .DocSearch-EmptyState');\n await expect(noResults).toBeVisible();\n});\n\ntest('search bar opens and closes', async ({ page }) => {\n await page.goto('/');\n await page.getByRole('button', { name: 'Search' }).click();\n await expect(page.getByPlaceholder('Search docs')).toBeVisible();\n await page.keyboard.press('Escape');\n await expect(page.getByPlaceholder('Search docs')).not.toBeVisible();\n});\n" }, { "path": "e2e/docs-e2e/tests/Ecosystem/ecosystem-pages-load.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest('Ecosystem page loads', async ({ page }) => {\n await page.goto('/ecosystem//');\n await expect(page).toHaveTitle('Qwik Ecosystem 📚 Qwik Documentation');\n});\n\ntest('Ecosystem Media Blogs Page loads', async ({ page }) => {\n await page.goto('/media/');\n await expect(page).toHaveTitle(\n 'Qwik Presentations, Talks, Videos and Podcasts 📚 Qwik Documentation'\n );\n});\n" }, { "path": "e2e/docs-e2e/tests/Sandbox/autoComplete.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest.describe('Sandbox Auto-complete Example', () => {\n test.beforeEach(async ({ page }) => {\n await page.goto('/examples/reactivity/auto-complete/');\n });\n\n test('Sandbox Auto-complete page loads', async ({ page }) => {\n await expect(page).toHaveTitle('Auto-complete 📚 Qwik Documentation');\n const tabButtonsTop = page.getByText('app.tsxentry.server.tsxroot.');\n\n await expect(tabButtonsTop.getByRole('button')).toHaveCount(3);\n await expect(page.getByRole('button', { name: 'app.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'entry.server.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'root.tsx' })).toBeVisible();\n\n const tabButtonsBottom = page.getByText('AppHTMLSymbolsClient');\n await expect(tabButtonsBottom.getByRole('button')).toHaveCount(6);\n\n await expect(tabButtonsBottom.getByRole('button', { name: 'App' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'HTML' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Symbols' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Client Bundles' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'SSR Module' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Diagnostics' })).toBeVisible();\n\n const consoleTabBottom = page.getByText('ConsoleOptions');\n await expect(consoleTabBottom.getByRole('button')).toHaveCount(2);\n await expect(consoleTabBottom.getByRole('button', { name: 'Console' })).toBeVisible();\n await expect(consoleTabBottom.getByRole('button', { name: 'Options' })).toBeVisible();\n });\n\n test('Auto-complete app.tsx loads', async ({ page }) => {\n const replInputAppTsx = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: 'export default component$' })\n .nth(4);\n await expect(replInputAppTsx).toBeVisible();\n const serverEntryButton = page.getByRole('button', { name: 'entry.server.tsx' });\n serverEntryButton.click();\n await expect(replInputAppTsx).not.toBeVisible();\n const appTsxButton = page.getByRole('button', { name: 'app.tsx' });\n appTsxButton.click();\n await expect(replInputAppTsx).toBeVisible();\n });\n\n test('Auto-complete entry.server.tsx loads', async ({ page }) => {\n const root = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import { Root } from './root';\" })\n .nth(4);\n\n await expect(root).not.toBeVisible();\n const button = page.getByRole('button', { name: 'entry.server.tsx' });\n button.click();\n await expect(root).toBeVisible();\n });\n\n test('Auto-complete root.tsx loads', async ({ page }) => {\n const importStatement = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import App from './app';\" })\n .nth(4);\n await expect(importStatement).not.toBeVisible();\n const button = page.getByRole('button', { name: 'root.tsx' });\n await button.click();\n await expect(importStatement).toBeVisible();\n });\n\n test('Auto-complete HTML Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const button = page.getByRole('button', { name: 'HTML' });\n await button.click();\n const htmlCode = page.locator('code.language-html');\n await expect(htmlCode).toBeVisible();\n await expect(htmlCode).toContainText('');\n });\n\n test('Auto-complete Symbols Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Symbols' });\n await expect(button).toBeVisible();\n await button.click();\n\n const symbolsText = page.getByText('import { _jsxQ } from').first();\n await expect(symbolsText).toBeVisible();\n });\n\n test('Auto-complete Client Bundles Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Client Bundles' });\n await expect(button).toBeVisible();\n await button.click();\n const bundles = page.locator('#file-modules-client-modules').getByText('build/app.js');\n await expect(bundles).toBeVisible();\n });\n\n test('Auto-complete SSR Module Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'SSR Module' });\n await expect(button).toBeVisible();\n await button.click();\n const module = page.locator('#file-modules-client-modules').getByText('entry.server.js');\n await expect(module).toBeVisible();\n });\n\n test('Auto-complete Diagnostics Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Diagnostics' });\n await expect(button).toBeVisible();\n await button.click();\n const diagnostics = page.locator('.output-result.output-diagnostics');\n await expect(diagnostics).toBeVisible();\n await expect(diagnostics).toHaveText('- No Reported Diagnostics -');\n });\n\n test('Auto-complete Options Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Options' });\n const serverConsoleText = page.getByText('🔴 Paused in server');\n await expect(serverConsoleText).toBeVisible();\n await expect(button).toBeVisible();\n await button.click();\n await expect(serverConsoleText).not.toBeVisible();\n const DebugCheckBox = page.locator('label').filter({ hasText: 'Debug' });\n await expect(DebugCheckBox).toBeVisible();\n await expect(DebugCheckBox).not.toBeChecked();\n const consoleButton = page.getByRole('button', { name: 'Console' });\n consoleButton.click();\n await expect(serverConsoleText).toBeVisible();\n });\n});\n" }, { "path": "e2e/docs-e2e/tests/Sandbox/clockVisible.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest.describe('Sandbox Clock Example', () => {\n test.beforeEach(async ({ page }) => {\n await page.goto('/examples/visibility/clock/');\n });\n\n test('Sandbox Clock page loads', async ({ page }) => {\n await expect(page).toHaveTitle('Below the fold Clock 📚 Qwik Documentation');\n const tabButtonsTop = page.getByText('app.tsxclock.cssentry.server.');\n\n await expect(tabButtonsTop.getByRole('button')).toHaveCount(4);\n await expect(page.getByRole('button', { name: 'app.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'clock.css' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'entry.server.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'root.tsx' })).toBeVisible();\n\n const tabButtonsBottom = page.getByText('AppHTMLSymbolsClient');\n await expect(tabButtonsBottom.getByRole('button')).toHaveCount(6);\n\n await expect(tabButtonsBottom.getByRole('button', { name: 'App' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'HTML' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Symbols' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Client Bundles' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'SSR Module' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Diagnostics' })).toBeVisible();\n\n const consoleTabBottom = page.getByText('ConsoleOptions');\n await expect(consoleTabBottom.getByRole('button')).toHaveCount(2);\n await expect(consoleTabBottom.getByRole('button', { name: 'Console' })).toBeVisible();\n await expect(consoleTabBottom.getByRole('button', { name: 'Options' })).toBeVisible();\n });\n\n test('Clock app.tsx loads', async ({ page }) => {\n const replInputAppTsx = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: 'export default component$' })\n .nth(4);\n await expect(replInputAppTsx).toBeVisible();\n const serverEntryButton = page.getByRole('button', { name: 'entry.server.tsx' });\n serverEntryButton.click();\n await expect(replInputAppTsx).not.toBeVisible();\n const appTsxButton = page.getByRole('button', { name: 'app.tsx' });\n appTsxButton.click();\n await expect(replInputAppTsx).toBeVisible();\n });\n\n test('Clock Clock.css loads', async ({ page }) => {\n const clockCSS = page.getByText('background: #fff;');\n const button = page.getByRole('button', { name: 'clock.css' });\n await expect(clockCSS).not.toBeVisible();\n button.click();\n await expect(clockCSS).toBeVisible();\n });\n\n test('Clock entry.server.tsx loads', async ({ page }) => {\n const root = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import { Root } from './root';\" })\n .nth(4);\n\n await expect(root).not.toBeVisible();\n const button = page.getByRole('button', { name: 'entry.server.tsx' });\n button.click();\n await expect(root).toBeVisible();\n });\n\n test('Clock root.tsx loads', async ({ page }) => {\n const importStatement = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import App from './app';\" })\n .nth(4);\n await expect(importStatement).not.toBeVisible();\n const button = page.getByRole('button', { name: 'root.tsx' });\n await button.click();\n await expect(importStatement).toBeVisible();\n });\n\n test('Clock HTML Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const button = page.getByRole('button', { name: 'HTML' });\n await button.click();\n const htmlCode = page.locator('code.language-html');\n await expect(htmlCode).toBeVisible();\n await expect(htmlCode).toContainText('');\n });\n\n test('Clock Symbols Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Symbols' });\n await expect(button).toBeVisible();\n await button.click();\n\n const symbolsText = page.getByText('import { _jsxQ } from').first();\n await expect(symbolsText).toBeVisible();\n });\n\n test('Clock Client Bundles Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Client Bundles' });\n await expect(button).toBeVisible();\n await button.click();\n const bundles = page.locator('#file-modules-client-modules').getByText('build/app.js');\n await expect(bundles).toBeVisible();\n });\n\n test('Clock SSR Module Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'SSR Module' });\n await expect(button).toBeVisible();\n await button.click();\n const module = page.locator('#file-modules-client-modules').getByText('entry.server.js');\n await expect(module).toBeVisible();\n });\n\n test('Clock Diagnostics Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Diagnostics' });\n await expect(button).toBeVisible();\n await button.click();\n const diagnostics = page.locator('.output-result.output-diagnostics');\n await expect(diagnostics).toBeVisible();\n await expect(diagnostics).toHaveText('- No Reported Diagnostics -');\n });\n\n test('Clock Options Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Options' });\n const serverConsoleText = page.getByText('🔴 Paused in server');\n await expect(serverConsoleText).toBeVisible();\n await expect(button).toBeVisible();\n await button.click();\n await expect(serverConsoleText).not.toBeVisible();\n const DebugCheckBox = page.locator('label').filter({ hasText: 'Debug' });\n await expect(DebugCheckBox).toBeVisible();\n await expect(DebugCheckBox).not.toBeChecked();\n const consoleButton = page.getByRole('button', { name: 'Console' });\n consoleButton.click();\n await expect(serverConsoleText).toBeVisible();\n });\n\n test('Clock Visible Task ', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const resumed = page.getByText('🟢 Resumed in client');\n\n await expect(resumed).not.toBeVisible();\n const outerFrame = await page.locator('iframe').elementHandle();\n const outerFrameContent = await outerFrame?.contentFrame();\n const innerFrameHandle = await outerFrameContent?.locator('iframe').elementHandle();\n const innerFrame = await innerFrameHandle?.contentFrame();\n\n await innerFrame?.evaluate(() => {\n window.scrollTo(0, document.body.scrollHeight);\n });\n\n await expect(resumed).toBeVisible();\n });\n});\n" }, { "path": "e2e/docs-e2e/tests/Sandbox/counter.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest.describe('Sandbox Counter Example', () => {\n test.beforeEach(async ({ page }) => {\n await page.goto('/examples/reactivity/counter/');\n });\n\n test('Sandbox Counter page loads', async ({ page }) => {\n await expect(page).toHaveTitle('Counter 📚 Qwik Documentation');\n const tabButtonsTop = page.getByText('app.tsxentry.server.tsxroot.');\n\n await expect(tabButtonsTop.getByRole('button')).toHaveCount(3);\n await expect(page.getByRole('button', { name: 'app.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'entry.server.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'root.tsx' })).toBeVisible();\n\n const tabButtonsBottom = page.getByText('AppHTMLSymbolsClient');\n await expect(tabButtonsBottom.getByRole('button')).toHaveCount(6);\n\n await expect(tabButtonsBottom.getByRole('button', { name: 'App' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'HTML' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Symbols' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Client Bundles' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'SSR Module' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Diagnostics' })).toBeVisible();\n\n const consoleTabBottom = page.getByText('ConsoleOptions');\n await expect(consoleTabBottom.getByRole('button')).toHaveCount(2);\n await expect(consoleTabBottom.getByRole('button', { name: 'Console' })).toBeVisible();\n await expect(consoleTabBottom.getByRole('button', { name: 'Options' })).toBeVisible();\n });\n\n test('Counter app.tsx loads', async ({ page }) => {\n const replInputAppTsx = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: 'export default component$' })\n .nth(4);\n await expect(replInputAppTsx).toBeVisible();\n const serverEntryButton = page.getByRole('button', { name: 'entry.server.tsx' });\n serverEntryButton.click();\n await expect(replInputAppTsx).not.toBeVisible();\n const appTsxButton = page.getByRole('button', { name: 'app.tsx' });\n appTsxButton.click();\n await expect(replInputAppTsx).toBeVisible();\n });\n\n test('Counter entry.server.tsx loads', async ({ page }) => {\n const root = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import { Root } from './root';\" })\n .nth(4);\n\n await expect(root).not.toBeVisible();\n const button = page.getByRole('button', { name: 'entry.server.tsx' });\n button.click();\n await expect(root).toBeVisible();\n });\n\n test('Counter root.tsx loads', async ({ page }) => {\n const importStatement = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import App from './app';\" })\n .nth(4);\n await expect(importStatement).not.toBeVisible();\n const button = page.getByRole('button', { name: 'root.tsx' });\n await button.click();\n await expect(importStatement).toBeVisible();\n });\n\n test('Counter Click Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const countValue = page\n .locator('iframe')\n .contentFrame()\n .locator('iframe')\n .contentFrame()\n .locator('main>p')\n .first();\n const button = page\n .locator('iframe')\n .contentFrame()\n .locator('iframe')\n .contentFrame()\n .getByRole('button', { name: 'Click' });\n const resumed = page.getByText('🟢 Resumed in client');\n await expect(resumed).not.toBeVisible();\n await expect(countValue).toHaveText('Count: 0');\n await button.click();\n\n await expect(countValue).toHaveText('Count: 1');\n await expect(resumed).toBeVisible();\n });\n\n test('Counter HTML Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const button = page.getByRole('button', { name: 'HTML' });\n await button.click();\n const htmlCode = page.locator('code.language-html');\n await expect(htmlCode).toBeVisible();\n await expect(htmlCode).toContainText('');\n });\n\n test('Counter Symbols Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Symbols' });\n await expect(button).toBeVisible();\n await button.click();\n\n const symbolsText = page.getByText('import { _jsxQ } from');\n await expect(symbolsText).toBeVisible();\n });\n\n test('Counter Client Bundles Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Client Bundles' });\n await expect(button).toBeVisible();\n await button.click();\n const bundles = page.locator('#file-modules-client-modules').getByText('build/app.js');\n await expect(bundles).toBeVisible();\n });\n\n test('Counter SSR Module Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'SSR Module' });\n await expect(button).toBeVisible();\n await button.click();\n const module = page.locator('#file-modules-client-modules').getByText('entry.server.js');\n await expect(module).toBeVisible();\n });\n\n test('Counter Diagnostics Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Diagnostics' });\n await expect(button).toBeVisible();\n await button.click();\n const diagnostics = page.locator('.output-result.output-diagnostics');\n await expect(diagnostics).toBeVisible();\n await expect(diagnostics).toHaveText('- No Reported Diagnostics -');\n });\n\n test('Counter Options Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Options' });\n const serverConsoleText = page.getByText('🔴 Paused in server');\n await expect(serverConsoleText).toBeVisible();\n await expect(button).toBeVisible();\n await button.click();\n await expect(serverConsoleText).not.toBeVisible();\n const DebugCheckBox = page.locator('label').filter({ hasText: 'Debug' });\n await expect(DebugCheckBox).toBeVisible();\n await expect(DebugCheckBox).not.toBeChecked();\n const consoleButton = page.getByRole('button', { name: 'Console' });\n consoleButton.click();\n await expect(serverConsoleText).toBeVisible();\n });\n});\n" }, { "path": "e2e/docs-e2e/tests/Sandbox/partial.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest.describe('Sandbox Partials HackerNews Example', () => {\n test.beforeEach(async ({ page }) => {\n await page.goto('/examples/partial/hackernews-index/');\n });\n\n test('Partial HackerNews page loads', async ({ page }) => {\n await expect(page).toHaveTitle('HackerNews 📚 Qwik Documentation');\n const tabButtonsTop = page.getByText('app.tsxentry.server.tsxhacker');\n\n await expect(tabButtonsTop.getByRole('button')).toHaveCount(4);\n await expect(page.getByRole('button', { name: 'app.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'hacker-news.css' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'entry.server.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'root.tsx' })).toBeVisible();\n\n const tabButtonsBottom = page.getByText('AppHTMLSymbolsClient');\n await expect(tabButtonsBottom.getByRole('button')).toHaveCount(6);\n\n await expect(tabButtonsBottom.getByRole('button', { name: 'App' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'HTML' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Symbols' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Client Bundles' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'SSR Module' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Diagnostics' })).toBeVisible();\n\n const consoleTabBottom = page.getByText('ConsoleOptions');\n await expect(consoleTabBottom.getByRole('button')).toHaveCount(2);\n await expect(consoleTabBottom.getByRole('button', { name: 'Console' })).toBeVisible();\n await expect(consoleTabBottom.getByRole('button', { name: 'Options' })).toBeVisible();\n });\n\n test('Partial HackerNews app.tsx loads', async ({ page }) => {\n const replInputAppTsx = page\n .getByRole('code')\n .getByText('export const HackerNews = component$');\n await expect(replInputAppTsx).toBeVisible();\n const serverEntryButton = page.getByRole('button', { name: 'entry.server.tsx' });\n serverEntryButton.click();\n await expect(replInputAppTsx).not.toBeVisible();\n const appTsxButton = page.getByRole('button', { name: 'app.tsx' });\n appTsxButton.click();\n await expect(replInputAppTsx).toBeVisible();\n });\n\n test('Partial HackerNews entry.server.tsx loads', async ({ page }) => {\n const root = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import { Root } from './root';\" })\n .nth(4);\n\n await expect(root).not.toBeVisible();\n const button = page.getByRole('button', { name: 'entry.server.tsx' });\n button.click();\n await expect(root).toBeVisible();\n });\n\n test('Partial HackerNews root.tsx loads', async ({ page }) => {\n const importStatement = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import { HackerNews } from './app';\" })\n .nth(4);\n await expect(importStatement).not.toBeVisible();\n const button = page.getByRole('button', { name: 'root.tsx' });\n await button.click();\n await expect(importStatement).toBeVisible();\n });\n\n test('Partial HackerNews hacker-news.css loads', async ({ page }) => {\n const clockCSS = page.getByText('background-color: #f2f3f5;');\n const button = page.getByRole('button', { name: 'hacker-news.css' });\n await expect(clockCSS).not.toBeVisible();\n button.click();\n await expect(clockCSS).toBeVisible();\n });\n\n test('Partial HackerNews fetchRequest Loads', async ({ page }) => {\n const linkToNextPage = page\n .locator('iframe')\n .contentFrame()\n .locator('iframe')\n .contentFrame()\n .getByRole('link', { name: 'Next Page' });\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n await expect(linkToNextPage).toBeVisible();\n });\n\n test('Partial HackerNews HTML Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const button = page.getByRole('button', { name: 'HTML' });\n await button.click();\n const htmlCode = page.locator('code.language-html');\n await expect(htmlCode).toBeVisible();\n await expect(htmlCode).toContainText('');\n });\n\n test('Partial HackerNews Symbols Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Symbols' });\n await expect(button).toBeVisible();\n await button.click();\n\n const symbolsText = page.getByText('import { _jsxQ } from').first();\n await expect(symbolsText).toBeVisible();\n });\n\n test('Partial HackerNews Client Bundles Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Client Bundles' });\n await expect(button).toBeVisible();\n await button.click();\n const bundles = page.locator('#file-modules-client-modules').getByText('build/app.js');\n await expect(bundles).toBeVisible();\n });\n\n test('Partial HackerNews SSR Module Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'SSR Module' });\n await expect(button).toBeVisible();\n await button.click();\n const module = page.locator('#file-modules-client-modules').getByText('entry.server.js');\n await expect(module).toBeVisible();\n });\n\n test('Partial HackerNews Diagnostics Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Diagnostics' });\n await expect(button).toBeVisible();\n await button.click();\n const diagnostics = page.locator('.output-result.output-diagnostics');\n await expect(diagnostics).toBeVisible();\n await expect(diagnostics).toHaveText('- No Reported Diagnostics -');\n });\n\n test('Clock Options Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Options' });\n const serverConsoleText = page.getByText('🔴 Paused in server');\n await expect(serverConsoleText).toBeVisible();\n await expect(button).toBeVisible();\n await button.click();\n await expect(serverConsoleText).not.toBeVisible();\n const DebugCheckBox = page.locator('label').filter({ hasText: 'Debug' });\n await expect(DebugCheckBox).toBeVisible();\n await expect(DebugCheckBox).not.toBeChecked();\n const consoleButton = page.getByRole('button', { name: 'Console' });\n consoleButton.click();\n await expect(serverConsoleText).toBeVisible();\n });\n});\n" }, { "path": "e2e/docs-e2e/tests/Sandbox/routing.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest.describe('Sandbox Routing ', () => {\n test.beforeEach(async ({ page }) => {\n await page.goto('/examples/introduction/hello-world/');\n const Links = page.locator('.examples-menu a');\n const linkCount = await Links.count();\n expect(linkCount).toBe(8);\n });\n\n test.afterEach(async ({ page }) => {\n const link = page.getByRole('link', { name: '🌎 Hello World The simplest' });\n await expect(link).toBeVisible();\n await link.click();\n await expect(page).toHaveTitle('Hello World - Qwik');\n });\n\n test('Routing runtime-less link test', async ({ page }) => {\n const link = page.getByRole('link', { name: '🪶 Runtime-less' });\n await expect(link).toBeVisible();\n await link.click();\n await page.waitForLoadState('networkidle');\n expect(page.url()).toContain('/examples/introduction/runtime-less');\n });\n\n test('Routing useTask() link test', async ({ page }) => {\n const link = page.getByRole('link', { name: '👀 Simple useTask()' });\n await expect(link).toBeVisible();\n await link.click();\n await page.waitForLoadState('networkidle');\n expect(page.url()).toContain('/examples/reactivity/task/');\n });\n\n test('Routing Counter link test', async ({ page }) => {\n const link = page.getByRole('link', { name: '⏲ Counter' });\n await expect(link).toBeVisible();\n await link.click();\n await page.waitForLoadState('networkidle');\n expect(page.url()).toContain('/examples/reactivity/counter/');\n });\n\n test('Routing Auto Complete link test', async ({ page }) => {\n const link = page.getByRole('link', { name: '🎬 Auto-complete' });\n await expect(link).toBeVisible();\n await link.click();\n await page.waitForLoadState('networkidle');\n expect(page.url()).toContain('/examples/reactivity/auto-complete/');\n });\n\n test('Routing Below the fold Clock link test', async ({ page }) => {\n const link = page.getByRole('link', { name: '⏰ Below the fold Clock' });\n await expect(link).toBeVisible();\n await link.click();\n await page.waitForLoadState('networkidle');\n expect(page.url()).toContain('/examples/visibility/clock/');\n });\n test('Routing Partials HN link test', async ({ page }) => {\n const link = page.getByRole('link', { name: '📰 HackerNews HackerNews' });\n await expect(link).toBeVisible();\n await link.click();\n await page.waitForLoadState('networkidle');\n expect(page.url()).toContain('/examples/partial/hackernews-index/');\n });\n});\n" }, { "path": "e2e/docs-e2e/tests/Sandbox/sandbox.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest.describe('Sandbox Hello World Example', () => {\n test.beforeEach(async ({ page }) => {\n await page.goto('/examples/introduction/hello-world/');\n });\n\n test('Sandbox page loads', async ({ page }) => {\n await expect(page).toHaveTitle('Hello World 📚 Qwik Documentation');\n const tabButtonsTop = page.getByText('app.tsxentry.server.tsxroot.');\n\n await expect(tabButtonsTop.getByRole('button')).toHaveCount(3);\n await expect(page.getByRole('button', { name: 'app.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'entry.server.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'root.tsx' })).toBeVisible();\n\n const tabButtonsBottom = page.getByText('AppHTMLSymbolsClient');\n await expect(tabButtonsBottom.getByRole('button')).toHaveCount(6);\n await expect(tabButtonsBottom.getByRole('button', { name: 'App' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'HTML' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Symbols' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Client Bundles' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'SSR Module' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Diagnostics' })).toBeVisible();\n\n const consoleTabBottom = page.getByText('ConsoleOptions');\n await expect(consoleTabBottom.getByRole('button')).toHaveCount(2);\n await expect(consoleTabBottom.getByRole('button', { name: 'Console' })).toBeVisible();\n await expect(consoleTabBottom.getByRole('button', { name: 'Options' })).toBeVisible();\n });\n\n test('Hello world app loads', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const appText = page\n .getByRole('main')\n .locator('iframe')\n .contentFrame()\n .locator('iframe')\n .contentFrame()\n .getByText('Hello Qwik');\n await expect(appText).toBeVisible();\n });\n\n test('Hello World app.tsx loads', async ({ page }) => {\n const text = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: 'return

Hello Qwik

;' })\n .nth(4);\n await expect(text).toBeVisible();\n });\n\n test('Hello World update p tag', async ({ page }) => {\n const text = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: 'return

Hello Qwik

;' })\n .nth(4);\n await expect(text).toBeVisible();\n await text.click();\n await page.keyboard.press('Home');\n await page.keyboard.press('Shift+End');\n\n await page.keyboard.type('return

Hello Test 1234

;');\n await expect(text).not.toBeVisible();\n\n const appText = page\n .getByRole('main')\n .locator('iframe')\n .first()\n .contentFrame()\n .locator('iframe')\n .first()\n .contentFrame()\n .getByText('Hello Test 1234');\n await expect(appText).toBeVisible();\n });\n\n test('Hello World entry.server.tsx tab works', async ({ page }) => {\n const button = page.getByRole('button', { name: 'entry.server.tsx' });\n await expect(button).toBeVisible();\n await button.click();\n\n const root = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import { Root } from './root';\" })\n .nth(4);\n await expect(root).toBeVisible();\n });\n\n test('Hello World root.tsx tab works', async ({ page }) => {\n const button = page.getByRole('button', { name: 'root.tsx' });\n await expect(button).toBeVisible();\n await button.click();\n const app = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import App from './app';\" })\n .nth(4);\n await expect(app).toBeVisible();\n });\n\n test('Hello world HTML Button', async ({ page }) => {\n const htmlButton = page.getByRole('button', { name: 'HTML' });\n await expect(htmlButton).toBeVisible();\n await htmlButton.click();\n const htmlCode = page.locator('code.language-html');\n await expect(htmlCode).toBeVisible();\n await expect(htmlCode).toContainText('');\n });\n\n test('Hello world Symbols Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Symbols' });\n await expect(button).toBeVisible();\n await button.click();\n\n const symbolsText = page.getByText('import { _jsxQ } from');\n await expect(symbolsText).toBeVisible();\n });\n\n test('Hello world Client Bundles Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Client Bundles' });\n await expect(button).toBeVisible();\n await button.click();\n const bundles = page.locator('#file-modules-client-modules').getByText('build/app.js');\n await expect(bundles).toBeVisible();\n });\n\n test('Hello world SSR Module Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'SSR Module' });\n await expect(button).toBeVisible();\n await button.click();\n const module = page.locator('#file-modules-client-modules').getByText('entry.server.js');\n await expect(module).toBeVisible();\n });\n\n test('Hello world Diagnostics Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Diagnostics' });\n await expect(button).toBeVisible();\n await button.click();\n const diagnostics = page.locator('.output-result.output-diagnostics');\n await expect(diagnostics).toBeVisible();\n await expect(diagnostics).toHaveText('- No Reported Diagnostics -');\n });\n\n test('Hello world Console', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Console' });\n await expect(button).toBeVisible();\n const serverConsoleText = page.getByText('🔴 Paused in server');\n await expect(serverConsoleText).toBeVisible();\n });\n\n test('Hello world Options Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Options' });\n await expect(button).toBeVisible();\n await button.click();\n const serverConsoleText = page.getByText('🔴 Paused in server');\n await expect(serverConsoleText).not.toBeVisible();\n const DebugCheckBox = page.locator('label').filter({ hasText: 'Debug' });\n await expect(DebugCheckBox).toBeVisible();\n await expect(DebugCheckBox).not.toBeChecked();\n });\n});\n\ntest.describe('Sandbox Runtime-less Example', () => {\n test.beforeEach(async ({ page }) => {\n await page.goto('/examples/introduction/runtime-less/');\n });\n test('Sandbox Runtime-less page loads', async ({ page }) => {\n await expect(page).toHaveTitle('Runtime-less 📚 Qwik Documentation');\n const tabButtonsTop = page.getByText('app.tsxentry.server.tsxroot.');\n\n await expect(tabButtonsTop.getByRole('button')).toHaveCount(3);\n await expect(page.getByRole('button', { name: 'app.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'entry.server.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'root.tsx' })).toBeVisible();\n\n const tabButtonsBottom = page.getByText('AppHTMLSymbolsClient');\n await expect(tabButtonsBottom.getByRole('button')).toHaveCount(6);\n\n await expect(tabButtonsBottom.getByRole('button', { name: 'App' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'HTML' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Symbols' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Client Bundles' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'SSR Module' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Diagnostics' })).toBeVisible();\n\n const consoleTabBottom = page.getByText('ConsoleOptions');\n await expect(consoleTabBottom.getByRole('button')).toHaveCount(2);\n await expect(consoleTabBottom.getByRole('button', { name: 'Console' })).toBeVisible();\n await expect(consoleTabBottom.getByRole('button', { name: 'Options' })).toBeVisible();\n\n const consoleLogSSR = page.getByText('ssr render ');\n await expect(consoleLogSSR).toHaveCount(1);\n await expect(consoleLogSSR).toBeVisible();\n });\n\n test('Runtime-less APP.tsx loads', async ({ page }) => {\n const replInputAppTsx = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"console.log('render ');\" })\n .nth(4);\n await expect(replInputAppTsx).toBeVisible();\n const serverEntryButton = page.getByRole('button', { name: 'entry.server.tsx' });\n serverEntryButton.click();\n await expect(replInputAppTsx).not.toBeVisible();\n const appTsxButton = page.getByRole('button', { name: 'app.tsx' });\n appTsxButton.click();\n await expect(replInputAppTsx).toBeVisible();\n });\n\n test('Runtime-less entry.server.tsx loads', async ({ page }) => {\n const root = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import { Root } from './root';\" })\n .nth(4);\n\n await expect(root).not.toBeVisible();\n const button = page.getByRole('button', { name: 'entry.server.tsx' });\n button.click();\n await expect(root).toBeVisible();\n });\n\n test('Runtime-less root.tsx loads', async ({ page }) => {\n const importStatement = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import App from './app';\" })\n .nth(4);\n await expect(importStatement).not.toBeVisible();\n const button = page.getByRole('button', { name: 'root.tsx' });\n await button.click();\n await expect(importStatement).toBeVisible();\n });\n\n test('Runtime-less Action Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const button = page\n .locator('iframe')\n .contentFrame()\n .locator('iframe')\n .contentFrame()\n .getByRole('button', { name: 'Action' });\n await button.click();\n const clicked = page.getByText('client click');\n await expect(clicked).toHaveCount(1);\n await button.click();\n await expect(clicked).toHaveCount(2);\n });\n test('Runtime-less HTML Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const button = page.getByRole('button', { name: 'HTML' });\n await button.click();\n const htmlCode = page.locator('code.language-html');\n await expect(htmlCode).toBeVisible();\n await expect(htmlCode).toContainText('');\n });\n\n test('Runtime-less Symbols Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Symbols' });\n await expect(button).toBeVisible();\n await button.click();\n\n const symbolsText = page.getByText('import { _jsxQ } from');\n await expect(symbolsText).toBeVisible();\n });\n\n test('Runtime-less Client Bundles Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Client Bundles' });\n await expect(button).toBeVisible();\n await button.click();\n const bundles = page.locator('#file-modules-client-modules').getByText('build/app.js');\n await expect(bundles).toBeVisible();\n });\n\n test('Runtime-less SSR Module Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'SSR Module' });\n await expect(button).toBeVisible();\n await button.click();\n const module = page.locator('#file-modules-client-modules').getByText('entry.server.js');\n await expect(module).toBeVisible();\n });\n\n test('Runtime-less Diagnostics Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Diagnostics' });\n await expect(button).toBeVisible();\n await button.click();\n const diagnostics = page.locator('.output-result.output-diagnostics');\n await expect(diagnostics).toBeVisible();\n await expect(diagnostics).toHaveText('- No Reported Diagnostics -');\n });\n\n test('Runtime-less Options Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Options' });\n const serverConsoleText = page.getByText('🔴 Paused in server');\n await expect(serverConsoleText).toBeVisible();\n await expect(button).toBeVisible();\n await button.click();\n await expect(serverConsoleText).not.toBeVisible();\n const DebugCheckBox = page.locator('label').filter({ hasText: 'Debug' });\n await expect(DebugCheckBox).toBeVisible();\n await expect(DebugCheckBox).not.toBeChecked();\n const consoleButton = page.getByRole('button', { name: 'Console' });\n consoleButton.click();\n await expect(serverConsoleText).toBeVisible();\n });\n});\n" }, { "path": "e2e/docs-e2e/tests/Sandbox/usetask.spec.ts", "content": "import { test, expect } from '@playwright/test';\n\ntest.describe('Sandbox useTask', () => {\n test.beforeEach(async ({ page }) => {\n await page.goto('/examples/reactivity/task/');\n });\n\n test('useTask page loads', async ({ page }) => {\n await expect(page).toHaveTitle('Simple useTask() 📚 Qwik Documentation');\n const tabButtonsTop = page.getByText('app.tsxentry.server.tsxroot.');\n\n await expect(tabButtonsTop.getByRole('button')).toHaveCount(3);\n await expect(page.getByRole('button', { name: 'app.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'entry.server.tsx' })).toBeVisible();\n await expect(page.getByRole('button', { name: 'root.tsx' })).toBeVisible();\n\n const tabButtonsBottom = page.getByText('AppHTMLSymbolsClient');\n await expect(tabButtonsBottom.getByRole('button')).toHaveCount(6);\n await expect(tabButtonsBottom.getByRole('button', { name: 'App' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'HTML' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Symbols' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Client Bundles' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'SSR Module' })).toBeVisible();\n await expect(tabButtonsBottom.getByRole('button', { name: 'Diagnostics' })).toBeVisible();\n\n const consoleTabBottom = page.getByText('ConsoleOptions');\n await expect(consoleTabBottom.getByRole('button')).toHaveCount(2);\n await expect(consoleTabBottom.getByRole('button', { name: 'Console' })).toBeVisible();\n await expect(consoleTabBottom.getByRole('button', { name: 'Options' })).toBeVisible();\n });\n\n test('useTask app.tsx loads', async ({ page }) => {\n const appTsxButton = page.getByRole('button', { name: 'app.tsx' });\n const replInputAppTsx = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: 'export default component$' })\n .nth(4);\n await expect(replInputAppTsx).toBeVisible();\n const serverEntryButton = page.getByRole('button', { name: 'entry.server.tsx' });\n serverEntryButton.click();\n await expect(replInputAppTsx).not.toBeVisible();\n\n appTsxButton.click();\n await expect(replInputAppTsx).toBeVisible();\n });\n\n test('useTask entry.server.tsx loads', async ({ page }) => {\n const root = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import { Root } from './root';\" })\n .nth(4);\n\n await expect(root).not.toBeVisible();\n const button = page.getByRole('button', { name: 'entry.server.tsx' });\n button.click();\n await expect(root).toBeVisible();\n });\n\n test('useTask root.tsx loads', async ({ page }) => {\n const importStatement = page\n .getByRole('code')\n .locator('div')\n .filter({ hasText: \"import App from './app';\" })\n .nth(4);\n await expect(importStatement).not.toBeVisible();\n const button = page.getByRole('button', { name: 'root.tsx' });\n await button.click();\n await expect(importStatement).toBeVisible();\n });\n\n test('useTask Debounced Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const button = page\n .locator('iframe')\n .contentFrame()\n .locator('iframe')\n .contentFrame()\n .getByRole('button', { name: '+' });\n const childValue = page\n .locator('iframe')\n .contentFrame()\n .locator('iframe')\n .contentFrame()\n .locator('#child');\n const consoleUpdate = page.getByText('client count changed');\n const resumed = page.getByText('🟢 Resumed in client');\n\n const debouncedSelector = page\n .locator('iframe')\n .contentFrame()\n .locator('iframe')\n .contentFrame()\n .locator('#debounced');\n await expect(debouncedSelector).toHaveText('Debounced: 0');\n await expect(childValue).toHaveText('0');\n await expect(resumed).not.toBeVisible();\n await expect(consoleUpdate).not.toBeVisible();\n\n button.click();\n\n await expect(consoleUpdate).toHaveCount(1);\n await expect(consoleUpdate).toBeVisible();\n await expect(resumed).toBeVisible();\n await expect(debouncedSelector).toHaveText('Debounced: 1');\n await expect(childValue).toHaveText('1');\n });\n\n test('useTask HTML Button', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n const button = page.getByRole('button', { name: 'HTML' });\n await button.click();\n const htmlCode = page.locator('code.language-html');\n await expect(htmlCode).toBeVisible();\n await expect(htmlCode).toContainText('');\n });\n\n test('useTask Symbols Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Symbols' });\n await expect(button).toBeVisible();\n await button.click();\n\n const symbolsText = page.getByText('import { useLexicalScope } ').first();\n await expect(symbolsText).toBeVisible();\n });\n\n test('useTask Client Bundles Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Client Bundles' });\n await expect(button).toBeVisible();\n await button.click();\n const bundles = page.locator('#file-modules-client-modules').getByText('build/app.js');\n await expect(bundles).toBeVisible();\n });\n\n test('useTask SSR Module Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'SSR Module' });\n await expect(button).toBeVisible();\n await button.click();\n const module = page.locator('#file-modules-client-modules').getByText('entry.server.js');\n await expect(module).toBeVisible();\n });\n\n test('useTask Diagnostics Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Diagnostics' });\n await expect(button).toBeVisible();\n await button.click();\n const diagnostics = page.locator('.output-result.output-diagnostics');\n await expect(diagnostics).toBeVisible();\n await expect(diagnostics).toHaveText('- No Reported Diagnostics -');\n });\n\n test('useTask Options Button', async ({ page }) => {\n const button = page.getByRole('button', { name: 'Options' });\n const serverConsoleText = page.getByText('🔴 Paused in server');\n await expect(serverConsoleText).toBeVisible();\n await expect(button).toBeVisible();\n await button.click();\n await expect(serverConsoleText).not.toBeVisible();\n const DebugCheckBox = page.locator('label').filter({ hasText: 'Debug' });\n await expect(DebugCheckBox).toBeVisible();\n await expect(DebugCheckBox).not.toBeChecked();\n const consoleButton = page.getByRole('button', { name: 'Console' });\n consoleButton.click();\n await expect(serverConsoleText).toBeVisible();\n });\n\n test('useTask server console loads', async ({ page }) => {\n const spinner = page.locator('.repl-spinner');\n await expect(spinner).toBeVisible();\n await expect(spinner).not.toBeVisible();\n\n const ssrPageCount = page.getByText('ssr count changed');\n const ssrAppRenders = page.getByText('ssr renders');\n const ssrChildRenders = page.getByText('ssr render');\n const ssrGrandChildRenders = page.getByText('ssr render');\n const pausedInServer = page.getByText('🔴 Paused in server');\n\n await expect(ssrPageCount).toBeVisible();\n await expect(ssrAppRenders).toBeVisible();\n await expect(ssrChildRenders).toBeVisible();\n await expect(ssrGrandChildRenders).toBeVisible();\n await expect(pausedInServer).toBeVisible();\n });\n});\n" }, { "path": "e2e/qwik-cli-e2e/README.md", "content": "# CLI E2E tests for the Qwik Framework\n\nThis package provides isolated E2E tests by generating a new application with local packages and then running tests again that code by executing it and verifying expected behavior.\n\n## Description\n\nTests can be invoked by running `pnpm run test.e2e.cli`.\n\n**Note that running E2E tests requires the workspace projects to be prebuilt manually!**\n\nE2E project does the following internally:\n\n0. Vitest is configured to run a setup function once **PRIOR TO ALL** tests. During the setup `@builder.io/qwik`, `@builder.io/qwik-city` and `eslint-plugin-qwik` packages will be packed with `pnpm pack` Those will be used at a step 2 for every test. Tarballs are located in `temp/tarballs` folder within this repo. It is assumed that packages are built before E2E is executed.\n\n1. Simulates `npm create qwik` locally using direct command `node packages/create-qwik/create-qwik.cjs playground {outputDir}`\n - By default `outputDir` is an auto-generated one using `tmp` npm package. The application that is created here will be removed after the test is executed\n - It is possible to install into custom folder using environment variable `TEMP_E2E_PATH`. Here's how the command would look like in this case:\n - with absolute path `TEMP_E2E_PATH=/Users/name/projects/tests pnpm run test.e2e.cli`\n - with path relative to the qwik workspace `TEMP_E2E_PATH=temp/e2e-folder pnpm run test.e2e.cli`\n\n Note that provided folder should exist. If custom path is used, generated application will not be removed after the test completes, which is helpful for debugging.\n\n2. Uses packed `@builder.io/qwik`, `@builder.io/qwik-city` and `eslint-plugin-qwik` packages to update package.json file of the generated application with `file:path-to-package.tgz`.\n\n3. Runs actual tests. Please pay attention at the `beforeAll` hook in the spec file\n\n```typescript\nbeforeAll(() => {\n const config = scaffoldQwikProject();\n global.tmpDir = config.tmpDir;\n\n return async () => {\n await killAllRegisteredProcesses();\n config.cleanupFn();\n };\n});\n```\n\nNotice that `beforeAll` returns a function, which will be executed after the test completes either with success or failure.\n\nBoth `config.cleanupFn();` and `killAllRegisteredProcesses` there are extremely important:\n\n- `config.cleanupFn()` is used in order to remove temporary folder with generated project after the test is executed (again, it's not being removed if `TEMP_E2E_PATH` is provided).\n- `killAllRegisteredProcesses` should be used to remove any active ports as we are serving the app during the test execution.\n Processes are being registered internally when `runCommandUntil` is executed. If you're executing something manually, you can use `registerExecutedChildProcess` utility to register the process.\n Despite `killAllRegisteredProcesses` will kill all processes when test exists, it is also a good practice to kill the process manually within the `it` statement using `await promisifiedTreeKill(yourChildProcess.pId, 'SIGKILL')`\n\n## Adding new tests\n\nRight now we have only one test file within this project. This means only one test application will be created and used, which is good from the execution time standpoint. If more files are added, it shouldn't potentially be a problem as we have `fileParallelism: false` set in the `vite.config.ts`, which means only one test will be executed at a time. This obviously slows down the execution time, but is safer, because we're working with a real file system.\n" }, { "path": "e2e/qwik-cli-e2e/package.json", "content": "{\n \"name\": \"qwik-cli-e2e\",\n \"version\": \"0.0.0\",\n \"dependencies\": {\n \"kleur\": \"4.1.5\"\n },\n \"private\": true,\n \"scripts\": {\n \"e2e\": \"vitest run --config=vite.config.ts\",\n \"e2e.watch\": \"vitest watch --config=vite.config.ts\"\n }\n}\n" }, { "path": "e2e/qwik-cli-e2e/tests/serve.spec.ts", "content": "/* eslint-disable no-console */\nimport { existsSync, readFileSync, writeFileSync } from 'fs';\nimport { join } from 'path';\nimport { assert, beforeAll, beforeEach, describe, expect, test } from 'vitest';\nimport {\n assertHostUnused,\n DEFAULT_TIMEOUT,\n getPageHtml,\n killAllRegisteredProcesses,\n log,\n promisifiedTreeKill,\n runCommandUntil,\n scaffoldQwikProject,\n type QwikProjectType,\n} from '../utils';\n\nlet SERVE_PORT = 3535;\nbeforeEach(() => {\n // the port doesn't clear immediately after the previous test\n SERVE_PORT++;\n});\nfor (const type of ['empty', 'playground'] as QwikProjectType[]) {\n describe(`template: ${type}`, () => {\n beforeAll(() => {\n console.log('================================================ scaffolding', type);\n const config = scaffoldQwikProject(type);\n global.tmpDir = config.tmpDir;\n\n return async () => {\n try {\n await killAllRegisteredProcesses();\n } catch (e) {\n log(`Error during process cleanup: ${e.message}`);\n }\n config.cleanupFn();\n };\n });\n\n if (type === 'playground') {\n test(\n 'Should serve the app in dev mode and update the content on hot reload',\n { timeout: DEFAULT_TIMEOUT },\n async () => {\n const host = `http://localhost:${SERVE_PORT}/`;\n await assertHostUnused(host);\n const p = await runCommandUntil(\n `npm run dev -- --port ${SERVE_PORT}`,\n global.tmpDir,\n (output) => {\n return output.includes(host);\n }\n );\n assert.equal(existsSync(global.tmpDir), true);\n\n await expectHtmlOnARootPage(host);\n\n // Don't let process termination errors fail the test\n try {\n await promisifiedTreeKill(p.pid!, 'SIGKILL');\n } catch (e) {\n log(`Error terminating dev server: ${e.message}`);\n }\n }\n );\n }\n\n test('Should preview the app', { timeout: DEFAULT_TIMEOUT }, async () => {\n const host = `http://localhost:${SERVE_PORT}/`;\n await assertHostUnused(host);\n\n // First build the app\n const buildProcess = await runCommandUntil(`npm run build`, global.tmpDir, (output) => {\n return output.includes('dist/build') || output.includes('built in');\n });\n\n try {\n await promisifiedTreeKill(buildProcess.pid!, 'SIGKILL');\n } catch (e) {\n log(`Error terminating build process: ${e.message}`);\n }\n\n // Now run the preview\n const p = await runCommandUntil(\n `npm run preview -- --no-open --port ${SERVE_PORT}`,\n global.tmpDir,\n (output) => {\n return output.includes(host);\n }\n );\n\n assert.equal(existsSync(global.tmpDir), true);\n\n // Wait a bit for the server to fully start\n await new Promise((resolve) => setTimeout(resolve, 2000));\n\n const res = await fetch(host, { headers: { accept: 'text/html' } }).then((r) => r.text());\n console.log('** res', res);\n\n // Check for the appropriate content based on template type\n if (type === 'playground') {\n expect(res).toContain('fantastic');\n } else if (type === 'empty') {\n expect(res).toContain('Hi');\n expect(res).toContain('qwik');\n }\n\n try {\n await promisifiedTreeKill(p.pid!, 'SIGKILL');\n } catch (e) {\n log(`Error terminating preview server: ${e.message}`);\n }\n });\n });\n}\n\nasync function expectHtmlOnARootPage(host: string) {\n expect((await getPageHtml(host)).querySelector('.container h1')?.textContent).toBe(\n `So fantasticto have you here`\n );\n const heroComponentPath = join(global.tmpDir, `src/components/starter/hero/hero.tsx`);\n const heroComponentTextContent = readFileSync(heroComponentPath, 'utf-8');\n writeFileSync(\n heroComponentPath,\n heroComponentTextContent.replace(\n `to have you here`,\n `to have e2e tests here`\n )\n );\n // wait for the arbitrary amount of time before the app is reloaded\n await new Promise((r) => setTimeout(r, 2000));\n expect((await getPageHtml(host)).querySelector('.container h1')?.textContent).toBe(\n `So fantasticto have e2e tests here`\n );\n}\n" }, { "path": "e2e/qwik-cli-e2e/tsconfig.json", "content": "{\n \"compilerOptions\": {\n \"types\": [\"vitest/globals\"],\n \"esModuleInterop\": true\n },\n \"include\": [\"utils\", \"tests\"]\n}\n" }, { "path": "e2e/qwik-cli-e2e/utils/index.ts", "content": "import { ChildProcess, exec, execSync } from 'child_process';\nimport { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'fs';\nimport { yellow } from 'kleur/colors';\nimport { dirname, join, resolve } from 'path';\nimport { dirSync } from 'tmp';\nimport treeKill from 'tree-kill';\nimport { promisify } from 'util';\nimport { createDocument } from '../../../packages/qwik/src/testing/document';\n\nexport type QwikProjectType = 'playground' | 'library' | 'empty';\nexport function scaffoldQwikProject(type: QwikProjectType): {\n tmpDir: string;\n cleanupFn: () => void;\n} {\n const tmpHostDirData = getTmpDirSync(\n process.env.TEMP_E2E_PATH ? `${process.env.TEMP_E2E_PATH}/${type}` : undefined\n );\n const cleanupFn = () => {\n if (!tmpHostDirData.overridden) {\n cleanup(tmpHostDirData.path);\n } else {\n log('Custom E2E test path was used, skipping the removal of test folder');\n }\n };\n try {\n const tmpDir = runCreateQwikCommand(tmpHostDirData.path, type);\n log(`Created test application at \"${tmpDir}\"`);\n replacePackagesWithLocalOnes(tmpDir);\n return { cleanupFn, tmpDir };\n } catch (error) {\n cleanupFn();\n throw error;\n }\n}\n\nfunction cleanup(tmpDir: string) {\n log(`Removing tmp dir \"${tmpDir}\"`);\n rmSync(tmpDir, { recursive: true });\n}\n\nfunction getTmpDirSync(tmpDirOverride?: string) {\n if (tmpDirOverride) {\n tmpDirOverride = resolve(workspaceRoot, tmpDirOverride);\n }\n\n if (tmpDirOverride && !existsSync(tmpDirOverride)) {\n throw new Error(`\"${tmpDirOverride}\" does not exist.`);\n }\n if (tmpDirOverride) {\n const p = join(tmpDirOverride, 'qwik_e2e');\n if (existsSync(p)) {\n log(`Removing project folder \"${p}\" (will be recreated).`);\n rmSync(p, { recursive: true });\n }\n mkdirSync(p);\n return { path: p, overridden: true };\n }\n return { path: dirSync({ prefix: 'qwik_e2e' }).name, overridden: false };\n}\n\nfunction runCreateQwikCommand(tmpDir: string, type: 'playground' | 'library' | 'empty'): string {\n const appDir = 'e2e-app';\n execSync(\n `node \"${workspaceRoot}/packages/create-qwik/create-qwik.cjs\" ${type} \"${join(tmpDir, appDir)}\"`\n );\n return join(tmpDir, appDir);\n}\n\nfunction replacePackagesWithLocalOnes(tmpDir: string) {\n const tarballConfig = JSON.parse(\n readFileSync(join(workspaceRoot, 'temp/tarballs/paths.json'), 'utf-8')\n );\n for (const { name, absolutePath } of tarballConfig) {\n patchPackageJsonForPlugin(tmpDir, name, absolutePath);\n }\n execSync('pnpm i', {\n cwd: tmpDir,\n // only output errors\n stdio: ['ignore', 'inherit', 'inherit'],\n });\n}\n\nfunction patchPackageJsonForPlugin(tmpDirName: string, npmPackageName: string, distPath: string) {\n const path = join(tmpDirName, 'package.json');\n const json = JSON.parse(readFileSync(path, 'utf-8'));\n json.devDependencies[npmPackageName] = `file:${distPath}`;\n writeFileSync(path, JSON.stringify(json));\n}\n\nexport function registerExecutedChildProcess(process: ChildProcess) {\n if (typeof global !== 'undefined') {\n (global.pIds ??= []).push(process.pid);\n log(`Registered a process with id \"${process.pid}\"`);\n } else {\n throw new Error('\"global\" is not defined');\n }\n}\n\nexport function runCommandUntil(\n command: string,\n tmpDir: string,\n criteria: (output: string) => boolean\n): Promise {\n const p = exec(command, {\n cwd: tmpDir,\n encoding: 'utf-8',\n });\n registerExecutedChildProcess(p);\n return new Promise((res, rej) => {\n let output = '';\n let complete = false;\n\n function checkCriteria(c: any) {\n output += c.toString();\n console.warn(output);\n if (criteria(stripConsoleColors(output)) && !complete) {\n complete = true;\n res(p);\n }\n }\n\n p.stdout?.on('data', checkCriteria);\n p.stderr?.on('data', checkCriteria);\n p.on('exit', (code) => {\n if (!complete) {\n rej(`Exited with ${code}`);\n } else {\n res(p);\n }\n });\n });\n}\n\nfunction stripConsoleColors(log: string): string {\n return log.replace(\n // eslint-disable-next-line no-control-regex\n /[\\u001b\\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g,\n ''\n );\n}\n\nexport async function getPageHtml(pageUrl: string): Promise {\n const res = await fetch(pageUrl, { headers: { accept: 'text/html' } }).then((r) => r.text());\n return createDocument({ html: res });\n}\n\nexport async function assertHostUnused(host: string): Promise {\n try {\n const response = await fetch(host, { headers: { accept: 'text/html' } });\n } catch (error) {\n // TODO: test this in different environments\n if (error.cause.code === 'ECONNREFUSED') {\n return;\n }\n }\n throw new Error(`Host ${host} is already in use!`);\n}\n\n// promisify fails to get the proper type overload, so manually enforcing the type\nconst _promisifiedTreeKill = promisify(treeKill) as (pid: number, signal: string) => Promise;\n\nexport const promisifiedTreeKill = async (pid: number, signal: string) => {\n try {\n return await _promisifiedTreeKill(pid, signal);\n } catch (error) {\n // Don't treat process termination failures as test failures\n // This is especially important on Windows where processes may already be gone\n // or may not be properly terminated with tree-kill\n log(`Process ${pid} could not be killed, but continuing: ${error.message}`);\n return Promise.resolve();\n }\n};\n\nexport async function killAllRegisteredProcesses() {\n const pIds = (global?.pIds as number[]) ?? [];\n const result = await Promise.allSettled(pIds.map((pId) => promisifiedTreeKill(pId, 'SIGKILL')));\n const stringifiedResult = JSON.stringify(\n result.map((v, i) => ({\n pId: pIds[i],\n status: v.status === 'fulfilled' ? 'success' : 'failure',\n }))\n );\n log('Cleaned up processes invoked by e2e test: ' + stringifiedResult);\n}\n\nexport const workspaceRoot = _computeWorkspaceRoot(process.cwd());\n\nfunction _computeWorkspaceRoot(cwd: string) {\n if (dirname(cwd) === cwd) {\n return process.cwd();\n }\n\n const packageJsonAtCwd = join(cwd, 'package.json');\n if (existsSync(packageJsonAtCwd)) {\n const content = JSON.parse(readFileSync(packageJsonAtCwd, 'utf-8'));\n if (content.name === 'qwik-monorepo') {\n return cwd;\n }\n }\n return _computeWorkspaceRoot(dirname(cwd));\n}\n\nexport function log(text: string) {\n // eslint-disable-next-line no-console\n console.log(yellow('E2E: ' + text));\n}\n\nexport const DEFAULT_TIMEOUT = process.env.CI ? 120000 : 30000;\n" }, { "path": "e2e/qwik-cli-e2e/utils/setup.ts", "content": "import { execSync } from 'child_process';\nimport { join } from 'path';\nimport { workspaceRoot } from '.';\nimport { existsSync, writeFileSync } from 'fs';\n\nconst packageCfg = {\n '@builder.io/qwik': {\n packagePath: 'packages/qwik',\n distPath: 'packages/qwik/dist',\n },\n '@builder.io/qwik-city': {\n packagePath: 'packages/qwik-city',\n distPath: 'packages/qwik-city/lib',\n },\n 'eslint-plugin-qwik': {\n packagePath: 'packages/eslint-plugin-qwik',\n distPath: 'packages/eslint-plugin-qwik/dist',\n },\n};\nfunction ensurePackageBuilt() {\n for (const [name, cfg] of Object.entries(packageCfg)) {\n if (!existsSync(join(workspaceRoot, cfg.distPath))) {\n throw new Error(`Looks like package \"${name}\" has not been built yet.`);\n }\n }\n}\nfunction packPackages() {\n const tarballPaths: { name: string; absolutePath: string }[] = [];\n const tarballOutDir = join(workspaceRoot, 'temp', 'tarballs');\n for (const [name, cfg] of Object.entries(packageCfg)) {\n const out = execSync(`pnpm pack --json --pack-destination=${tarballOutDir}`, {\n cwd: join(workspaceRoot, cfg.packagePath),\n encoding: 'utf-8',\n });\n const json = JSON.parse(out);\n tarballPaths.push({ name, absolutePath: json.filename });\n }\n writeFileSync(join(tarballOutDir, 'paths.json'), JSON.stringify(tarballPaths));\n}\n\nensurePackageBuilt();\npackPackages();\n" }, { "path": "e2e/qwik-cli-e2e/vite.config.ts", "content": "import { existsSync, mkdirSync } from 'fs';\nimport { resolve } from 'path';\nimport tsconfigPaths from 'vite-tsconfig-paths';\nimport { defineConfig } from 'vitest/config';\n\n// if we're running in github CI\nif (process.env.CI) {\n // Workaround for npm/pnpm crashing in scaffoldQwikProject because \"name is too long\"\n const testPath = resolve(process.cwd(), 'e2e-test-tmp');\n\n // Create base directory if it doesn't exist\n if (!existsSync(testPath)) {\n mkdirSync(testPath);\n }\n\n // Create subdirectories for each template type\n const templateTypes = ['empty', 'playground'];\n for (const type of templateTypes) {\n const templatePath = resolve(testPath, type);\n if (!existsSync(templatePath)) {\n mkdirSync(templatePath);\n }\n }\n\n process.env.TEMP_E2E_PATH = testPath;\n}\n\nexport default defineConfig({\n plugins: [tsconfigPaths({ root: '../../' })],\n test: {\n include: ['./tests/*.spec.?(c|m)[jt]s?(x)'],\n setupFiles: ['./utils/setup.ts'],\n // Run only one test at a time to avoid potential conflicts.\n // These tests interact directly with the filesystem and/or run processes on localhost,\n // which can lead to issues if multiple tests are executed simultaneously\n fileParallelism: false,\n },\n});\n" }, { "path": "e2e/qwik-react-e2e/.gitignore", "content": "playwright-report\ndist\nlogs\nserver\ntmp" }, { "path": "e2e/qwik-react-e2e/adapters/express/vite.config.ts", "content": "import { nodeServerAdapter } from '@builder.io/qwik-city/adapters/node-server/vite';\nimport { extendConfig } from '@builder.io/qwik-city/vite';\nimport baseConfig from '../../vite.config';\n\nexport default extendConfig(baseConfig, () => {\n return {\n build: {\n ssr: true,\n rollupOptions: {\n input: ['src/entry.express.tsx', '@qwik-city-plan'],\n },\n },\n plugins: [nodeServerAdapter({ name: 'express' })],\n };\n});\n" }, { "path": "e2e/qwik-react-e2e/package.json", "content": "{\n \"name\": \"qwik-react-test-app\",\n \"description\": \"Qwik react test app\",\n \"engines\": {\n \"node\": \"^18.17.0 || ^20.3.0 || >=21.0.0\"\n },\n \"private\": true,\n \"devDependencies\": {\n \"@builder.io/qwik-react\": \"workspace:^\",\n \"@types/react\": \"18.3.3\",\n \"@types/react-dom\": \"18.3.0\",\n \"react\": \"18.3.1\",\n \"react-dom\": \"18.3.1\"\n },\n \"scripts\": {\n \"build\": \"qwik build\",\n \"build.client\": \"vite build\",\n \"build.preview\": \"vite build --ssr src/entry.preview.tsx\",\n \"build.server\": \"vite build -c adapters/express/vite.config.ts\",\n \"build.types\": \"tsc --incremental --noEmit\",\n \"deploy\": \"vercel deploy\",\n \"dev\": \"vite --mode ssr\",\n \"dev.debug\": \"node --inspect-brk ./node_modules/vite/bin/vite.js --mode ssr --force\",\n \"express\": \"pnpm build && pnpm serve\",\n \"fmt\": \"prettier --write .\",\n \"fmt.check\": \"prettier --check .\",\n \"lint\": \"eslint \\\"src/**/*.ts*\\\"\",\n \"preview\": \"qwik build preview && vite preview --open\",\n \"qwik\": \"qwik\",\n \"serve\": \"node server/entry.express\",\n \"start\": \"vite --open --mode ssr\",\n \"test\": \"playwright test\",\n \"test.debug\": \"playwright test --debug\",\n \"test.ui\": \"playwright test --ui\"\n },\n \"type\": \"module\"\n}\n" }, { "path": "e2e/qwik-react-e2e/playwright.config.ts", "content": "import { defineConfig, devices } from '@playwright/test';\n\n/** See https://playwright.dev/docs/test-configuration. */\nexport default defineConfig({\n testDir: './tests',\n fullyParallel: true,\n forbidOnly: !!process.env.CI,\n retries: process.env.CI ? 2 : 0,\n workers: process.env.CI ? 1 : undefined,\n reporter: 'line',\n\n use: {\n baseURL: 'http://localhost:3000',\n // trace: 'on-first-retry',\n // screenshot: 'only-on-failure',\n\n // Increase timeouts for service worker operations\n actionTimeout: 10000,\n navigationTimeout: 10000,\n },\n\n // Increase global timeout for service worker tests\n timeout: process.env.CI ? 120000 : 30000,\n\n projects: [\n {\n name: 'chromium',\n use: {\n ...devices['Desktop Chrome'],\n },\n },\n // {\n // name: 'firefox',\n // use: { ...devices['Desktop Firefox'] },\n // },\n {\n name: 'webkit',\n use: { ...devices['Desktop Safari'] },\n },\n ],\n\n webServer: {\n command: 'npm run express',\n port: 3000,\n stdout: 'pipe',\n reuseExistingServer: !process.env.CI,\n timeout: process.env.CI ? 120000 : 30000,\n },\n});\n" }, { "path": "e2e/qwik-react-e2e/src/components/counter/index.tsx", "content": "/** @jsxImportSource react */\nimport { useEffect, useState } from 'react';\nimport { qwikify$ } from '@builder.io/qwik-react';\n\ninterface IProps {\n onMount(): void;\n onUnmount(): void;\n}\n\nfunction Counter({ onMount, onUnmount }: IProps) {\n const [count, setCount] = useState(0);\n\n useEffect(() => {\n onMount();\n return () => onUnmount();\n }, []);\n\n return (\n
\n count {count}\n \n
\n );\n}\n\nexport const QCounter = qwikify$(Counter, { eagerness: 'hover' });\n" }, { "path": "e2e/qwik-react-e2e/src/components/router-head/router-head.tsx", "content": "import { component$ } from '@builder.io/qwik';\nimport { useDocumentHead, useLocation } from '@builder.io/qwik-city';\n\nexport const RouterHead = component$(() => {\n const head = useDocumentHead();\n const loc = useLocation();\n\n return (\n <>\n {head.title}\n\n \n \n\n {head.meta.map((m) => (\n \n ))}\n\n {head.links.map((l) => (\n \n ))}\n \n );\n});\n" }, { "path": "e2e/qwik-react-e2e/src/entry.dev.tsx", "content": "/*\n * WHAT IS THIS FILE?\n *\n * Development entry point using only client-side modules:\n * - Do not use this mode in production!\n * - No SSR\n * - No portion of the application is pre-rendered on the server.\n * - All of the application is running eagerly in the browser.\n * - More code is transferred to the browser than in SSR mode.\n * - Optimizer/Serialization/Deserialization code is not exercised!\n */\nimport { render, type RenderOptions } from '@builder.io/qwik';\nimport Root from './root';\n\nexport default function (opts: RenderOptions) {\n return render(document, , opts);\n}\n" }, { "path": "e2e/qwik-react-e2e/src/entry.express.tsx", "content": "/*\n * WHAT IS THIS FILE?\n *\n * It's the entry point for the Express HTTP server when building for production.\n *\n * Learn more about Node.js server integrations here:\n * - https://qwik.dev/docs/deployments/node/\n *\n */\nimport { createQwikCity, type PlatformNode } from '@builder.io/qwik-city/middleware/node';\nimport 'dotenv/config';\nimport qwikCityPlan from '@qwik-city-plan';\nimport { manifest } from '@qwik-client-manifest';\nimport render from './entry.ssr';\nimport express from 'express';\nimport { fileURLToPath } from 'node:url';\nimport { join } from 'node:path';\n\ndeclare global {\n type QwikCityPlatform = PlatformNode;\n}\n\n// Directories where the static assets are located\nconst distDir = join(fileURLToPath(import.meta.url), '..', '..', 'dist');\nconst buildDir = join(distDir, 'build');\n\n// Allow for dynamic port\nconst PORT = process.env.PORT ?? 3000;\n\n// Create the Qwik City Node middleware\nconst { router, notFound } = createQwikCity({\n render,\n qwikCityPlan,\n manifest,\n // getOrigin(req) {\n // // If deploying under a proxy, you may need to build the origin from the request headers\n // // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Proto\n // const protocol = req.headers[\"x-forwarded-proto\"] ?? \"http\";\n // // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host\n // const host = req.headers[\"x-forwarded-host\"] ?? req.headers.host;\n // return `${protocol}://${host}`;\n // }\n});\n\n// Create the express server\n// https://expressjs.com/\nconst app = express();\n\n// Enable gzip compression\n// app.use(compression());\n\n// Static asset handlers\n// https://expressjs.com/en/starter/static-files.html\napp.use(`/build`, express.static(buildDir, { immutable: true, maxAge: '1y' }));\napp.use(express.static(distDir, { redirect: false }));\n\n// Use Qwik City's page and endpoint request handler\napp.use(router);\n\n// Use Qwik City's 404 handler\napp.use(notFound);\n\n// Start the express server\napp.listen(PORT, () => {\n /* eslint-disable */\n console.log(`Server started: http://localhost:${PORT}/`);\n});\n" }, { "path": "e2e/qwik-react-e2e/src/entry.preview.tsx", "content": "/*\n * WHAT IS THIS FILE?\n *\n * It's the bundle entry point for `npm run preview`.\n * That is, serving your app built in production mode.\n *\n * Feel free to modify this file, but don't remove it!\n *\n * Learn more about Vite's preview command:\n * - https://vitejs.dev/config/preview-options.html#preview-options\n *\n */\nimport { createQwikCity } from '@builder.io/qwik-city/middleware/node';\nimport qwikCityPlan from '@qwik-city-plan';\n// make sure qwikCityPlan is imported before entry\nimport render from './entry.ssr';\n\n/** The default export is the QwikCity adapter used by Vite preview. */\nexport default createQwikCity({ render, qwikCityPlan });\n" }, { "path": "e2e/qwik-react-e2e/src/entry.ssr.tsx", "content": "/**\n * WHAT IS THIS FILE?\n *\n * SSR entry point, in all cases the application is rendered outside the browser, this entry point\n * will be the common one.\n *\n * - Server (express, cloudflare...)\n * - Npm run start\n * - Npm run preview\n * - Npm run build\n */\nimport { renderToStream, type RenderToStreamOptions } from '@builder.io/qwik/server';\nimport { manifest } from '@qwik-client-manifest';\nimport Root from './root';\n\nexport default function (opts: RenderToStreamOptions) {\n return renderToStream(, {\n manifest,\n ...opts,\n // Use container attributes to set attributes on the html tag.\n containerAttributes: {\n lang: 'en-us',\n ...opts.containerAttributes,\n },\n // prefetchStrategy: {\n // implementation: {\n // linkInsert: \"html-append\",\n // linkRel: \"modulepreload\",\n // },\n // },\n serverData: {\n ...opts.serverData,\n },\n });\n}\n" }, { "path": "e2e/qwik-react-e2e/src/root.tsx", "content": "import { component$ } from '@builder.io/qwik';\nimport { QwikCityProvider, RouterOutlet, ServiceWorkerRegister } from '@builder.io/qwik-city';\nimport { RouterHead } from './components/router-head/router-head';\n\nexport default component$(() => {\n /**\n * The root of a QwikCity site always start with the component, immediately\n * followed by the document's and .\n *\n * Don't remove the `` and `` elements.\n */\n\n return (\n \n \n \n \n {/* \n */}\n \n \n \n \n \n \n );\n});\n" }, { "path": "e2e/qwik-react-e2e/src/routes/index.tsx", "content": "import { component$ } from '@builder.io/qwik';\nimport { type DocumentHead } from '@builder.io/qwik-city';\n\nexport default component$(() => {\n return <>render qwik;\n});\n\nexport const head: DocumentHead = {\n title: 'Welcome to Qwik',\n meta: [\n {\n name: 'description',\n content: 'Qwik site description',\n },\n ],\n};\n" }, { "path": "e2e/qwik-react-e2e/src/routes/layout.tsx", "content": "import { component$, Slot } from '@builder.io/qwik';\nimport { Link } from '@builder.io/qwik-city';\n\nexport default component$(() => {\n return (\n <>\n \n qwik\n \n \n react\n \n
\n
\n \n
\n \n );\n});\n" }, { "path": "e2e/qwik-react-e2e/src/routes/react/index.tsx", "content": "/* eslint-disable no-console */\nimport { component$ } from '@builder.io/qwik';\nimport { type DocumentHead } from '@builder.io/qwik-city';\nimport { QCounter } from '~/components/counter';\n\nexport default component$(() => {\n return (\n console.log('@@@@ Mount')}\n onUnmount$={() => console.log('@@@@ Unmount')}\n />\n );\n});\n\nexport const head: DocumentHead = {\n title: 'Welcome to React Qwik',\n meta: [\n {\n name: 'description',\n content: 'React Qwik site description',\n },\n ],\n};\n" }, { "path": "e2e/qwik-react-e2e/tests/express.spec.ts", "content": "import { expect, test } from '@playwright/test';\n\ntest.describe('[SSR]', () => {\n test('should NOT call unmount callback for non hydrated component', async ({ page }) => {\n page.on('console', () => {\n throw new Error(\"React component shouldn't hydrate\");\n });\n\n await page.goto('/react');\n\n expect(await page.getByTestId('count').innerText()).toBe('count 0');\n\n // unmount\n await page.getByTestId('qwik-link').click();\n await page.waitForURL('/', { waitUntil: 'networkidle' });\n\n expect(await page.textContent('main')).toBe('render qwik');\n });\n\n test('should call unmount callback for hydrated component', async ({ page }) => {\n await page.goto('/react');\n\n expect(await page.getByTestId('count').innerText()).toBe('count 0');\n\n // hydrate\n const mountConsole = page.waitForEvent('console');\n await page.getByTestId('test-component').hover();\n\n // check if hydrated and called useEffect\n const mountMsg = await mountConsole;\n expect(await mountMsg.args()[0].jsonValue()).toBe('@@@@ Mount');\n\n // check if react works\n await page.getByTestId('inc-btn').click();\n expect(await page.getByTestId('count').innerText()).toBe('count 1');\n\n // unmount\n const unmountConsole = page.waitForEvent('console');\n await page.getByTestId('qwik-link').click();\n\n const unmountMsg = await unmountConsole;\n expect(await unmountMsg.args()[0].jsonValue()).toBe('@@@@ Unmount');\n });\n});\n\ntest.describe('[CSR]', () => {\n test('should call unmount callback', async ({ page }) => {\n await page.goto('/');\n\n // csr\n const mountConsole = page.waitForEvent('console');\n await page.getByTestId('react-link').click();\n await page.waitForURL('/react/', { waitUntil: 'networkidle' });\n\n expect(await page.getByTestId('count').innerText()).toBe('count 0');\n\n // check if called useEffect\n const mountMsg = await mountConsole;\n expect(await mountMsg.args()[0].jsonValue()).toBe('@@@@ Mount');\n\n // check if react works\n await page.getByTestId('inc-btn').click();\n expect(await page.getByTestId('count').innerText()).toBe('count 1');\n\n // unmount\n const unmountConsole = page.waitForEvent('console');\n await page.getByTestId('qwik-link').click();\n await page.waitForURL('/', { waitUntil: 'networkidle' });\n\n const unmountMsg = await unmountConsole;\n expect(await unmountMsg.args()[0].jsonValue()).toBe('@@@@ Unmount');\n });\n});\n" }, { "path": "e2e/qwik-react-e2e/tsconfig.json", "content": "{\n \"compilerOptions\": {\n \"baseUrl\": \".\",\n \"allowJs\": true,\n \"target\": \"ES2020\",\n \"module\": \"ES2022\",\n \"lib\": [\"es2022\", \"DOM\", \"WebWorker\", \"DOM.Iterable\"],\n \"jsx\": \"react-jsx\",\n \"jsxImportSource\": \"@builder.io/qwik\",\n \"strict\": true,\n \"forceConsistentCasingInFileNames\": true,\n \"resolveJsonModule\": true,\n \"moduleResolution\": \"Bundler\",\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"incremental\": true,\n \"isolatedModules\": true,\n \"outDir\": \"tmp\",\n \"noEmit\": true,\n \"paths\": {\n \"~/*\": [\"./src/*\"]\n }\n },\n\n \"include\": [\"src\", \"./*.d.ts\", \"./*.config.ts\"]\n}\n" }, { "path": "e2e/qwik-react-e2e/vite.config.ts", "content": "/**\n * This is the base config for vite. When building, the adapter config is used which loads this file\n * and extends it.\n */\nimport { qwikCity } from '@builder.io/qwik-city/vite';\nimport { qwikVite } from '@builder.io/qwik/optimizer';\nimport { qwikReact } from '@builder.io/qwik-react/vite';\nimport { defineConfig, type UserConfig } from 'vite';\nimport tsconfigPaths from 'vite-tsconfig-paths';\nimport pkg from './package.json';\n\ntype PkgDep = Record;\nconst { dependencies = {}, devDependencies = {} } = pkg as any as {\n dependencies: PkgDep;\n devDependencies: PkgDep;\n [key: string]: unknown;\n};\nerrorOnDuplicatesPkgDeps(devDependencies, dependencies);\n\n/**\n * Note that Vite normally starts from `index.html` but the qwikCity plugin makes start at\n * `src/entry.ssr.tsx` instead.\n */\nexport default defineConfig((): UserConfig => {\n return {\n plugins: [qwikCity(), qwikVite(), tsconfigPaths({ root: '.' }), qwikReact()],\n // This tells Vite which dependencies to pre-build in dev mode.\n optimizeDeps: {\n // Put problematic deps that break bundling here, mostly those with binaries.\n // For example ['better-sqlite3'] if you use that in server functions.\n exclude: [],\n },\n\n /**\n * This is an advanced setting. It improves the bundling of your server code. To use it, make\n * sure you understand when your consumed packages are dependencies or dev dependencies.\n * (otherwise things will break in production)\n */\n // ssr:\n // command === \"build\" && mode === \"production\"\n // ? {\n // // All dev dependencies should be bundled in the server build\n // noExternal: Object.keys(devDependencies),\n // // Anything marked as a dependency will not be bundled\n // // These should only be production binary deps (including deps of deps), CLI deps, and their module graph\n // // If a dep-of-dep needs to be external, add it here\n // // For example, if something uses `bcrypt` but you don't have it as a dep, you can write\n // // external: [...Object.keys(dependencies), 'bcrypt']\n // external: Object.keys(dependencies),\n // }\n // : undefined,\n\n server: {\n headers: {\n // Don't cache the server response in dev mode\n 'Cache-Control': 'public, max-age=0',\n },\n },\n preview: {\n headers: {\n // Do cache the server response in preview (non-adapter production build)\n 'Cache-Control': 'public, max-age=360',\n },\n },\n };\n});\n\n// *** utils ***\n\n/**\n * Function to identify duplicate dependencies and throw an error\n *\n * @param {Object} devDependencies - List of development dependencies\n * @param {Object} dependencies - List of production dependencies\n */\nfunction errorOnDuplicatesPkgDeps(devDependencies: PkgDep, dependencies: PkgDep) {\n let msg = '';\n // Create an array 'duplicateDeps' by filtering devDependencies.\n // If a dependency also exists in dependencies, it is considered a duplicate.\n const duplicateDeps = Object.keys(devDependencies).filter((dep) => dependencies[dep]);\n\n // include any known qwik packages\n const qwikPkg = Object.keys(dependencies).filter((value) => /qwik/i.test(value));\n\n // any errors for missing \"qwik-city-plan\"\n // [PLUGIN_ERROR]: Invalid module \"@qwik-city-plan\" is not a valid package\n msg = `Move qwik packages ${qwikPkg.join(', ')} to devDependencies`;\n\n if (qwikPkg.length > 0) {\n throw new Error(msg);\n }\n\n // Format the error message with the duplicates list.\n // The `join` function is used to represent the elements of the 'duplicateDeps' array as a comma-separated string.\n msg = `\n Warning: The dependency \"${duplicateDeps.join(', ')}\" is listed in both \"devDependencies\" and \"dependencies\".\n Please move the duplicated dependencies to \"devDependencies\" only and remove it from \"dependencies\"\n `;\n\n // Throw an error with the constructed message.\n if (duplicateDeps.length > 0) {\n throw new Error(msg);\n }\n}\n" }, { "path": "eslint.config.js", "content": "import globals from 'globals';\nimport js from '@eslint/js';\nimport tseslint from 'typescript-eslint';\nimport noOnlyTests from 'eslint-plugin-no-only-tests';\nimport { globalIgnores } from 'eslint/config';\n// import { qwikEslint9Plugin } from 'eslint-plugin-qwik';\n\nconst ignores = [\n '**/.history',\n '**/.vscode',\n '**/dist',\n '**/dist-dev',\n '**/lib',\n '**/node_modules',\n '**/tsc-out',\n '**/external',\n '**/*.',\n '**/*.log',\n '**/etc',\n '**/target',\n '**/temp',\n '**/tsdoc-metadata.json',\n '**/.DS_Store',\n '**/*.mp4',\n 'scripts',\n '**/server/**/*.js',\n '**/*.tsbuildinfo',\n 'packages/docs/api',\n 'packages/docs/public/repl/repl-sw.js*',\n 'packages/docs/src/routes/examples/apps',\n 'packages/docs/src/routes/playground/app',\n 'packages/docs/src/routes/tutorial',\n 'packages/qwik/src/optimizer/core/src/fixtures',\n 'packages/qwik/bindings',\n 'packages/qwik-labs/lib',\n 'packages/qwik-labs/lib-types',\n 'packages/qwik-labs/vite',\n 'packages/insights/drizzle.config.ts',\n 'packages/insights/panda.config.ts',\n 'packages/qwik/src/napi',\n 'starters/apps/base',\n 'starters/apps/library',\n 'starters/templates',\n '**/vite.config.ts',\n // packages with eslint.config.mjs\n 'packages/qwik-labs',\n 'packages/insights',\n // eslint.config.*\n '**/eslint.config.mjs',\n '**/eslint.config.js',\n '.changeset',\n 'packages/docs/public/builder',\n];\n\nexport default tseslint.config(\n globalIgnores(ignores),\n js.configs.recommended,\n tseslint.configs.recommended,\n // qwikEslint9Plugin.configs.recommended,\n {\n languageOptions: {\n globals: {\n ...globals.browser,\n ...globals.node,\n ...globals.es2021,\n },\n parserOptions: {\n // Needed when using the qwik plugin\n // projectService: true,\n // tsconfigRootDir: import.meta.dirname,\n },\n },\n },\n {\n plugins: {\n 'no-only-tests': noOnlyTests,\n },\n rules: {\n 'no-only-tests/no-only-tests': 'error',\n },\n name: 'no-only-tests',\n },\n {\n rules: {\n '@typescript-eslint/no-explicit-any': 'off',\n '@typescript-eslint/explicit-module-boundary-types': 'off',\n '@typescript-eslint/no-inferrable-types': 'off',\n '@typescript-eslint/no-non-null-assertion': 'off',\n '@typescript-eslint/no-empty-interface': 'off',\n '@typescript-eslint/no-namespace': 'off',\n '@typescript-eslint/no-empty-function': 'off',\n '@typescript-eslint/no-this-alias': 'off',\n '@typescript-eslint/ban-types': 'off',\n '@typescript-eslint/ban-ts-comment': 'off',\n 'prefer-spread': 'off',\n 'no-case-declarations': 'off',\n 'no-console': ['error', { allow: ['warn', 'error'] }],\n 'no-only-tests/no-only-tests': 'error',\n '@typescript-eslint/no-unused-vars': 'off',\n '@typescript-eslint/no-var-requires': 'off',\n curly: 'error',\n 'no-new-func': 'error',\n '@typescript-eslint/no-empty-object-type': 'off',\n '@typescript-eslint/no-unused-expressions': 'off',\n '@typescript-eslint/no-unsafe-function-type': 'off',\n '@typescript-eslint/no-require-imports': 'off',\n '@typescript-eslint/no-wrapper-object-types': 'off',\n },\n },\n {\n files: ['packages/docs/**/*.{ts,tsx}'],\n rules: {\n 'no-console': 'off',\n },\n }\n);\n" }, { "path": "flake.nix", "content": "# This is a Nix configuration file. It is used to define the environment\n# for the project. It is a declarative way to define the dependencies.\n# It is used by the `nix develop` command to create a development environment\n# with all the dependencies needed for the project.\n\n# To update the dependencies, run `nix flake update`.\n\n# Note: keep the playwright version in package.json syncpack the same as the nix version\n# We don't need to have the latest playwright all the time so not having to download\n# all the browsers on every version bump is a good thing.\n{\n inputs = {\n nixpkgs.url = \"github:NixOS/nixpkgs/nixos-unstable\";\n rust-overlay.url = \"github:oxalica/rust-overlay\";\n };\n\n outputs = { self, rust-overlay, nixpkgs }:\n let\n b = builtins;\n devShell = system: _pkgs:\n let\n overlays = [ (import rust-overlay) ];\n pkgs = import nixpkgs {\n inherit system overlays;\n };\n in\n {\n default = pkgs.mkShell {\n nativeBuildInputs = with pkgs; [\n bashInteractive\n gitMinimal\n\n nodejs_22\n corepack_22\n\n # Playwright for the end-to-end tests\n playwright-driver.browsers\n\n # Qwik optimizer deps\n wasm-pack\n # Provides rustc and cargo\n ((rust-bin.fromRustupToolchainFile\n ./rust-toolchain).override {\n # For rust-analyzer\n extensions = [ \"rust-src\" ];\n # For building wasm\n targets = [ \"wasm32-unknown-unknown\" ];\n })\n ];\n # https://github.com/microsoft/playwright/issues/5501\n shellHook = ''\n export PATH=$PWD/node_modules/.bin:$PATH\n export PLAYWRIGHT_BROWSERS_PATH=${pkgs.playwright-driver.browsers}\n export PLAYWRIGHT_SKIP_VALIDATE_HOST_REQUIREMENTS=true\n pwNixVersion=${pkgs.playwright-driver.version}\n pwNpmVersion=$(${pkgs.jq}/bin/jq -r .version node_modules/@playwright/test/package.json 2>/dev/null)\n if [ -n \"$pwNpmVersion\" ] && [ \"$pwNpmVersion\" != \"$pwNixVersion\" ]; then\n echo \"!!! Playwright version mismatch: $pwNpmVersion (nodejs) != $pwNixVersion (nix). Please fix.\" >&2\n fi\n '';\n };\n };\n in\n {\n devShells = b.mapAttrs (devShell) nixpkgs.legacyPackages;\n };\n}\n" }, { "path": "package.json", "content": "{\n \"name\": \"qwik-monorepo\",\n \"version\": \"0.0.0-read-qwik-package-json\",\n \"comments\": {\n \"01\": \"devDependencies includes reference to @builder.io/qwik: workspace: *. This is needed or e2e tests will fail\",\n \"02\": \" It would be nice to be able to remove this dependency and fix the test.\",\n \"03\": \"devDependencies can't include reference to @builder.io/qwik-city or e2e test will fail.\"\n },\n \"config\": {\n \"syncpack\": {\n \"versionGroups\": [\n {\n \"label\": \"Be lenient in vite versions for prod. v4 is broken, v5 is good\",\n \"dependencyTypes\": [\n \"prod\",\n \"peer\"\n ],\n \"dependencies\": [\n \"vite\"\n ],\n \"pinVersion\": \">=5 <8\"\n },\n {\n \"label\": \"use workspace protocol for local packages and allow patch versions (used in e.g. qwik-react)\",\n \"dependencies\": [\n \"$LOCAL\"\n ],\n \"dependencyTypes\": [\n \"!local\",\n \"!dev\"\n ],\n \"pinVersion\": \"workspace:^\"\n },\n {\n \"label\": \"dev: use workspace protocol for local packages - split from prod and peer version group\",\n \"dependencies\": [\n \"$LOCAL\"\n ],\n \"dependencyTypes\": [\n \"dev\"\n ],\n \"pinVersion\": \"workspace:^\"\n },\n {\n \"label\": \"Separate prod deps from dev deps\",\n \"dependencyTypes\": [\n \"prod\",\n \"peer\"\n ]\n },\n {\n \"label\": \"Playwright should have the same version as in flake.nix\",\n \"dependencies\": [\n \"@playwright/test\"\n ],\n \"dependencyTypes\": [\n \"dev\"\n ],\n \"pinVersion\": \"1.54.1\"\n }\n ],\n \"semverGroups\": [\n {\n \"label\": \"Undici should always be * until we remove it\",\n \"dependencies\": [\n \"undici\"\n ],\n \"range\": \"*\"\n },\n {\n \"label\": \"use exact version numbers for devDependencies\",\n \"dependencyTypes\": [\n \"dev\"\n ],\n \"range\": \"\"\n }\n ]\n }\n },\n \"contributors\": [\n {\n \"name\": \"Miško Hevery\",\n \"email\": \"misko@hevery.com\",\n \"url\": \"https://twitter.com/mhevery\"\n },\n {\n \"name\": \"Adam Bradley\",\n \"email\": \"adam@builder.io\",\n \"url\": \"https://twitter.com/adamdbradley\"\n },\n {\n \"name\": \"Manu Mtz.-Almeida\",\n \"email\": \"manu@builder.io\",\n \"url\": \"https://twitter.com/manucorporat\"\n }\n ],\n \"dependencies\": {\n \"esbuild-plugin-raw\": \"^0.2.0\"\n },\n \"devDependencies\": {\n \"@builder.io/qwik\": \"workspace:^\",\n \"@builder.io/qwik-city\": \"workspace:^\",\n \"@changesets/cli\": \"2.29.5\",\n \"@changesets/get-github-info\": \"0.6.0\",\n \"@changesets/types\": \"6.1.0\",\n \"@clack/prompts\": \"0.7.0\",\n \"@eslint/js\": \"9.32.0\",\n \"@mdx-js/mdx\": \"3.1.1\",\n \"@microsoft/api-documenter\": \"7.26.31\",\n \"@microsoft/api-extractor\": \"7.52.10\",\n \"@napi-rs/cli\": \"2.18.4\",\n \"@napi-rs/triples\": \"1.2.0\",\n \"@node-rs/helper\": \"1.6.0\",\n \"@octokit/action\": \"6.1.0\",\n \"@playwright/test\": \"1.54.1\",\n \"@qwik.dev/partytown\": \"0.11.2\",\n \"@types/brotli\": \"1.3.4\",\n \"@types/bun\": \"1.2.19\",\n \"@types/cross-spawn\": \"6.0.6\",\n \"@types/express\": \"4.17.21\",\n \"@types/node\": \"20.19.0\",\n \"@types/path-browserify\": \"1.0.3\",\n \"@types/prompts\": \"2.4.9\",\n \"@types/react\": \"18.3.3\",\n \"@types/semver\": \"7.7.0\",\n \"@types/tmp\": \"0.2.6\",\n \"@types/which-pm-runs\": \"1.0.2\",\n \"@vitejs/plugin-basic-ssl\": \"2.1.0\",\n \"all-contributors-cli\": \"6.26.1\",\n \"brotli\": \"1.3.3\",\n \"create-qwik\": \"workspace:^\",\n \"cross-spawn\": \"7.0.6\",\n \"csstype\": \"3.1.3\",\n \"dotenv\": \"16.5.0\",\n \"esbuild\": \"0.25.10\",\n \"eslint\": \"9.32.0\",\n \"eslint-plugin-no-only-tests\": \"3.3.0\",\n \"eslint-plugin-qwik\": \"workspace:^\",\n \"execa\": \"9.6.0\",\n \"express\": \"4.22.0\",\n \"globals\": \"16.4.0\",\n \"install\": \"0.13.0\",\n \"memfs\": \"4.49.0\",\n \"monaco-editor\": \"0.45.0\",\n \"mri\": \"1.2.0\",\n \"path-browserify\": \"1.0.1\",\n \"prettier\": \"3.6.2\",\n \"prettier-plugin-jsdoc\": \"1.3.3\",\n \"prettier-plugin-tailwindcss\": \"0.6.14\",\n \"pretty-quick\": \"4.2.2\",\n \"prompts\": \"2.4.2\",\n \"rollup\": \"4.59.0\",\n \"semver\": \"7.7.2\",\n \"simple-git-hooks\": \"2.13.1\",\n \"snoop\": \"1.0.4\",\n \"source-map\": \"0.7.6\",\n \"svgo\": \"3.3.3\",\n \"syncpack\": \"12.3.3\",\n \"terser\": \"5.44.0\",\n \"tmp\": \"0.2.5\",\n \"tree-kill\": \"1.2.2\",\n \"typescript\": \"5.4.5\",\n \"typescript-eslint\": \"8.38.0\",\n \"undici\": \"*\",\n \"vfile\": \"6.0.3\",\n \"vite\": \"7.3.1\",\n \"vite-imagetools\": \"9.0.0\",\n \"vite-plugin-dts\": \"3.9.1\",\n \"vite-tsconfig-paths\": \"5.1.4\",\n \"vitest\": \"3.2.4\",\n \"watchlist\": \"0.3.1\",\n \"which-pm-runs\": \"1.1.0\",\n \"zod\": \"3.25.48\"\n },\n \"engines\": {\n \"node\": \">=22.18.0\",\n \"npm\": \"please-use-pnpm\",\n \"yarn\": \"please-use-pnpm\",\n \"pnpm\": \">=10.14.0\"\n },\n \"packageManager\": \"pnpm@10.14.0\",\n \"private\": true,\n \"scripts\": {\n \"api.update\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --api --dev\",\n \"build\": \"node --require ./scripts/runBefore.ts scripts/index.ts\",\n \"build.changelog-formatter\": \"tsc .changeset/changelog-github-custom.ts && mv .changeset/changelog-github-custom.js .changeset/changelog-github-custom.cjs\",\n \"build.clean\": \"node ./scripts/build-clean.ts\",\n \"build.cli\": \"node --require ./scripts/runBefore.ts scripts/index.ts --cli --dev\",\n \"build.cli.prod\": \"node --require ./scripts/runBefore.ts scripts/index.ts --cli\",\n \"build.core\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --build --qwikcity --api --platform-binding\",\n \"build.eslint\": \"node --require ./scripts/runBefore.ts scripts/index.ts --eslint\",\n \"build.full\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --tsc-docs --build --supabaseauthhelpers --api --eslint --qwikcity --qwikworker --qwiklabs --qwikreact --qwikauth --cli --platform-binding --wasm\",\n \"build.local\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --tsc-docs --build --supabaseauthhelpers --api --eslint --qwikcity --qwikworker --qwiklabs --qwikreact --qwikauth --cli --platform-binding-wasm-copy\",\n \"build.only_javascript\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --build --api\",\n \"build.packages.docs\": \"pnpm -C ./packages/docs/ run build\",\n \"build.packages.insights\": \"pnpm -C ./packages/insights/ run build\",\n \"build.platform\": \"node --require ./scripts/runBefore.ts scripts/index.ts --platform-binding\",\n \"build.platform.copy\": \"node --require ./scripts/runBefore.ts scripts/index.ts --platform-binding-wasm-copy\",\n \"build.qwik-city\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --qwikcity\",\n \"build.qwik-react\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --qwikreact\",\n \"build.validate\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --build --api --eslint --qwikcity --platform-binding --wasm --validate\",\n \"build.vite\": \"node --require ./scripts/runBefore.ts scripts/index.ts --tsc --build --api --qwikcity --eslint --platform-binding-wasm-copy\",\n \"build.wasm\": \"node --require ./scripts/runBefore.ts scripts/index.ts --wasm\",\n \"build.watch\": \"node --require ./scripts/runBefore.ts scripts/index.ts --build --qwikcity --watch --dev --platform-binding\",\n \"change\": \"changeset\",\n \"cli\": \"pnpm build.cli && node packages/create-qwik/create-qwik.cjs && node --require ./scripts/runBefore.ts scripts/validate-cli.ts --copy-local-qwik-dist\",\n \"cli.qwik\": \"pnpm build.cli && node packages/qwik/qwik-cli.cjs\",\n \"cli.validate\": \"node --require ./scripts/runBefore.ts scripts/validate-cli.ts\",\n \"deps\": \"corepack pnpm upgrade -i -r --latest && syncpack fix-mismatches && corepack pnpm dedupe\",\n \"docs.dev\": \"pnpm -C packages/docs build.repl-sw && pnpm -C packages/docs dev\",\n \"docs.preview\": \"pnpm -C packages/docs preview\",\n \"docs.sync\": \"node --require ./scripts/runBefore.ts scripts/docs_sync/index.ts && pnpm fmt\",\n \"docs.showcase\": \"pnpm -C packages/docs run build.showcase\",\n \"eslint.update\": \"node --require ./scripts/runBefore.ts scripts/eslint-docs.ts\",\n \"fmt\": \"pnpm prettier.fix && pnpm syncpack format\",\n \"fmt.staged\": \"pretty-quick --staged\",\n \"link.dist\": \"cd packages/qwik && pnpm link --global && cd ../qwik-city && pnpm link --global && cd ../eslint-plugin-qwik && pnpm link --global && cd ../qwik-react && pnpm link --global\",\n \"link.dist.npm\": \"cd packages/qwik && npm link && cd ../qwik-city && npm link && cd ../eslint-plugin-qwik && npm link && cd ../qwik-react && npm link\",\n \"link.dist.yarn\": \"cd packages/qwik && yarn link && cd ../qwik-city && yarn link && cd ../eslint-plugin-qwik && yarn link && cd ../qwik-react && yarn link\",\n \"lint\": \"pnpm lint.eslint && pnpm lint.prettier && pnpm lint.rust\",\n \"lint.eslint\": \"eslint --cache \\\"**/*.ts*\\\" && pnpm -r --parallel lint\",\n \"lint.fix\": \"eslint --fix \\\"**/*.ts*\\\" && pnpm -r --parallel lint.fix && pnpm prettier.fix\",\n \"lint.prettier\": \"prettier --cache --check .\",\n \"lint.rust\": \"make lint\",\n \"lint.syncpack\": \"syncpack list-mismatches\",\n \"preinstall\": \"npx only-allow pnpm\",\n \"prepare\": \"simple-git-hooks\",\n \"prettier.fix\": \"prettier --cache --write .\",\n \"qwik-push-build-repos\": \"node --require ./scripts/runBefore.ts ./scripts/qwik-push-build-repos.ts\",\n \"release\": \"changeset publish\",\n \"release.fixup-package-json\": \"syncpack fix-mismatches --config syncpack-release-conf.json\",\n \"release.pkg-pr-new\": \"pnpm dlx pkg-pr-new@^0.0.9 publish --compact --pnpm ./packages/qwik ./packages/qwik-city ./packages/eslint-plugin-qwik ./packages/create-qwik\",\n \"release.prepare\": \"pnpm build --prepare-release\",\n \"serve\": \"node --require ./scripts/runBefore.ts --inspect --conditions=development starters/dev-server.ts 3300\",\n \"serve.debug\": \"node --require ./scripts/runBefore.ts --inspect-brk --conditions=development starters/dev-server.ts 3300\",\n \"start\": \"pnpm run --stream \\\"/.*\\\\.watch/\\\"\",\n \"test\": \"pnpm build.full && pnpm test.unit && pnpm test.e2e\",\n \"test.e2e\": \"pnpm test.e2e.chromium && pnpm test.e2e.webkit && test.e2e.integrations\",\n \"test.e2e.chromium\": \"playwright test starters --browser=chromium --config starters/playwright.config.ts\",\n \"test.e2e.chromium.debug\": \"PWDEBUG=1 playwright test starters --browser=chromium --config starters/playwright.config.ts\",\n \"test.e2e.city\": \"playwright test starters/e2e/qwikcity --browser=chromium --config starters/playwright.config.ts\",\n \"test.e2e.cli\": \"pnpm --filter qwik-cli-e2e e2e\",\n \"test.e2e.firefox\": \"playwright test starters --browser=firefox --config starters/playwright.config.ts\",\n \"test.e2e.integrations.chromium\": \"playwright test e2e/adapters-e2e/tests --project=chromium --config e2e/adapters-e2e/playwright.config.ts\",\n \"test.e2e.integrations.webkit\": \"playwright test e2e/adapters-e2e/tests --project=webkit --config e2e/adapters-e2e/playwright.config.ts\",\n \"test.e2e.webkit\": \"playwright test starters --browser=webkit --config starters/playwright.config.ts\",\n \"test.e2e.qwik-react.chromium\": \"playwright test e2e/qwik-react-e2e/tests --project=chromium --config e2e/qwik-react-e2e/playwright.config.ts\",\n \"test.e2e.qwik-react.webkit\": \"playwright test e2e/qwik-react-e2e/tests --project=webkit --config e2e/qwik-react-e2e/playwright.config.ts\",\n \"test.rust\": \"make test\",\n \"test.rust.update\": \"make test-update\",\n \"test.unit\": \"vitest packages\",\n \"test.unit.debug\": \"vitest --inspect-brk packages\",\n \"test.vite\": \"playwright test starters/e2e/qwikcity --browser=chromium --config starters/playwright.config.ts\",\n \"tsc.check\": \"tsc --noEmit\",\n \"tsc.trace\": \"tsc -p tsconfig.json --traceResolution > tsc.log\",\n \"tsc.watch\": \"tsc --noEmit --watch --preserveWatchOutput\",\n \"update.qwik.builds\": \"node --require ./scripts/runBefore.ts scripts/update-qwik-builds.ts packages/docs && node scripts/update-qwik-builds.ts packages/insights; pnpm install\",\n \"vitest\": \"vitest\"\n },\n \"simple-git-hooks\": {\n \"pre-commit\": \"pnpm pretty-quick --staged\"\n },\n \"type\": \"module\"\n}\n" }, { "path": "packages/create-qwik/.npmignore", "content": "src\n" }, { "path": "packages/create-qwik/CHANGELOG.md", "content": "# create-qwik\n\n## 1.19.0\n\n### Patch Changes\n\n- ✨ cloudflare workers deployment adapter (by [@LazyClicks](https://github.com/LazyClicks) in [#8214](https://github.com/QwikDev/qwik/pull/8214))\n\n## 1.18.0\n\n### Patch Changes\n\n- execute cleanup cb for all component tree while calling dispose.cleanup method returned by render fn (by [@sashkashishka](https://github.com/sashkashishka) in [#8164](https://github.com/QwikDev/qwik/pull/8164))\n\n## 1.17.2\n\n## 1.17.1\n\n## 1.17.0\n\n## 1.16.1\n\n### Patch Changes\n\n- 🐞🩹 set sideEffects: false to the lib template, otherwise there might be some side effects imports when building a consumer project. (by [@gioboa](https://github.com/gioboa) in [#7855](https://github.com/QwikDev/qwik/pull/7855))\n\n- 🐞🩹 fix up vscode settings merge. Use JSON5 to parse settings.json to prevent parsing errors. (by [@gioboa](https://github.com/gioboa) in [#7858](https://github.com/QwikDev/qwik/pull/7858))\n\n- 🛠 use the new version of @croct/json5-parser to merge JSON5 and preserve comments (by [@gioboa](https://github.com/gioboa) in [#7884](https://github.com/QwikDev/qwik/pull/7884))\n\n## 1.16.0\n\n### Minor Changes\n\n- ✨ bump Vite to v7 (by [@gioboa](https://github.com/gioboa) in [#7762](https://github.com/QwikDev/qwik/pull/7762))\n\n### Patch Changes\n\n- 🐞🩹 fix up TypeScript compatibility in the localize starter (by [@FDiskas](https://github.com/FDiskas) in [#7617](https://github.com/QwikDev/qwik/pull/7617))\n\n## 1.15.0\n\n### Patch Changes\n\n- 🐞🩹 fix up vercel starter config (by [@cmbartschat](https://github.com/cmbartschat) in [#7663](https://github.com/QwikDev/qwik/pull/7663))\n\n- 🛠 update devDependencies and configurations (by [@JerryWu1234](https://github.com/JerryWu1234) in [#7695](https://github.com/QwikDev/qwik/pull/7695))\n\n## 1.14.1\n\n### Patch Changes\n\n- 🐞🩹 starter app missing package and added preview cli test (by [@wmertens](https://github.com/wmertens) in [#7626](https://github.com/QwikDev/qwik/pull/7626))\n\n## 1.14.0\n\n### Patch Changes\n\n- 🐞🩹 create-qwik logAppCreated.ts now displays correct next steps for deno. (by [@LogProphet](https://github.com/LogProphet) in [#7566](https://github.com/QwikDev/qwik/pull/7566))\n\n After using the create-qwik command, the logAppCreated.ts file was not displaying the correct next steps for deno. Prior to this fix it would display \"deno start\" instead of \"deno task start\". This would cause a failure to run, as deno requires the 'task' keyword. This fixes bug 7520\n\n- 🐞🩹 linting errors which were previously being ignored across the monorepo. (by [@better-salmon](https://github.com/better-salmon) in [#7418](https://github.com/QwikDev/qwik/pull/7418))\n\n## 1.13.0\n\n## 1.12.1\n\n## 1.12.0\n\n## 1.11.0\n\n## 1.10.0\n\n### Patch Changes\n\n- INFRA: migration from tsm to tsx (by [@JerryWu1234](https://github.com/JerryWu1234) in [#6877](https://github.com/QwikDev/qwik/pull/6877))\n\n## 1.9.1\n\n## 1.9.0\n\n### Patch Changes\n\n- ✨ tailwind starter dependencies upgraded to latest (by [@thejackshelton](https://github.com/thejackshelton) in [#6783](https://github.com/QwikDev/qwik/pull/6783))\n\n- ✨ added `preserveModules` to library starters to improve library bundling / tree-shaking (by [@thejackshelton](https://github.com/thejackshelton) in [#6773](https://github.com/QwikDev/qwik/pull/6773))\n\n## 1.8.0\n\n### Patch Changes\n\n- 🐞🩹 wrong version when creating a library (by [@shairez](https://github.com/shairez) in [#6757](https://github.com/QwikDev/qwik/pull/6757))\n\n## 1.7.3\n\n### Patch Changes\n\n- 🐞🩹 get the right version number in starter apps (by [@shairez](https://github.com/shairez) in [#6742](https://github.com/QwikDev/qwik/pull/6742))\n\n## 1.7.2\n\n### Patch Changes\n\n- - built files are now under dist/ or lib/. All tools that respect package export maps should just work. (by [@wmertens](https://github.com/wmertens) in [#6715](https://github.com/QwikDev/qwik/pull/6715))\n If you have trouble with Typescript, ensure that you use `moduleResolution: \"Bundler\"` in your `tsconfig.json`.\n - `@builder.io/qwik` no longer depends on `undici`\n" }, { "path": "packages/create-qwik/README.md", "content": "# Create Qwik ⚡️\n\n## Interactive mode\n\n```\nnpm create qwik@latest\n```\n\n## Command mode\n\n```\nnpm create qwik@latest \n```\n\n## API\n\n```javascript\nconst { createApp } = require('create-qwik');\n\nconst opts = {\n projectName: 'my-project',\n starterId: 'todo',\n outDir: '/path/to/output/dir',\n};\n\nconst result = await createApp(opts);\nconsole.log(result);\n```\n\n## Community\n\n- Ping us at [@QwikDev](https://twitter.com/QwikDev)\n- Join our [Discord](https://qwik.dev/chat) community\n\n## Related\n\n- [Qwik](https://qwik.dev/)\n- [Partytown](https://partytown.qwik.dev)\n- [Mitosis](https://github.com/BuilderIO/mitosis)\n- [Builder.io](https://github.com/BuilderIO/)\n" }, { "path": "packages/create-qwik/create-qwik.cjs", "content": "#!/usr/bin/env node\nconst createQwik = require('./dist/index.cjs');\ncreateQwik.runCli();\n" }, { "path": "packages/create-qwik/index.ts", "content": "import { runCreateCli } from './src/run-create-cli';\nimport { runCreateInteractiveCli } from './src/run-create-interactive-cli';\nimport { panic, printHeader } from '../qwik/src/cli/utils/utils';\nimport { red, yellow } from 'kleur/colors';\nimport { createAppFacade } from './src/create-app-facade';\n\nexport async function runCli() {\n printHeader();\n\n checkNodeVersion();\n\n try {\n const args = process.argv.slice(2);\n\n if (args.length > 0) {\n await runCreateCli(...args);\n } else {\n // npm create qwik\n await runCreateInteractiveCli();\n }\n } catch (e: any) {\n panic(e.message || e);\n }\n}\n\nfunction checkNodeVersion() {\n const version = process.version;\n const [majorVersion, minorVersion] = version.replace('v', '').split('.');\n if (Number(majorVersion) < 16) {\n console.error(\n red(`Qwik requires Node.js 16.8 or higher. You are currently running Node.js ${version}.`)\n );\n process.exit(1);\n } else if (Number(majorVersion) === 16) {\n if (Number(minorVersion) < 8) {\n console.warn(\n yellow(\n `Node.js 16.8 or higher is recommended. You are currently running Node.js ${version}.`\n )\n );\n }\n } else if (Number(majorVersion) === 18) {\n if (Number(minorVersion) < 11) {\n console.error(\n red(\n `Node.js 18.11 or higher is REQUIRED. From Node 18.0.0 to 18.11.0, there is a bug preventing correct behavior of Qwik. You are currently running Node.js ${version}. https://github.com/QwikDev/qwik/issues/3035`\n )\n );\n }\n }\n}\n\nexport { createAppFacade as createApp, runCreateCli, runCreateInteractiveCli };\n" }, { "path": "packages/create-qwik/package.json", "content": "{\n \"name\": \"create-qwik\",\n \"description\": \"Interactive CLI for create Qwik projects and adding features.\",\n \"version\": \"1.19.0\",\n \"author\": \"Builder.io Team\",\n \"bin\": \"./create-qwik.cjs\",\n \"bugs\": \"https://github.com/QwikDev/qwik/issues\",\n \"devDependencies\": {\n \"@clack/prompts\": \"0.7.0\",\n \"@types/yargs\": \"17.0.33\",\n \"kleur\": \"4.1.5\",\n \"yargs\": \"17.7.2\"\n },\n \"engines\": {\n \"node\": \"^18.17.0 || ^20.3.0 || >=21.0.0\",\n \"npm\": \">=10.0.0\",\n \"pnpm\": \">=8.0.0\",\n \"yarn\": \">=3.0.0\"\n },\n \"engines-annotation\": \"Mostly required by sharp which needs a Node-API v9 compatible runtime\",\n \"files\": [\n \"README.md\",\n \"create-qwik.cjs\",\n \"dist\"\n ],\n \"homepage\": \"https://qwik.dev/\",\n \"keywords\": [\n \"builder.io\",\n \"generator\",\n \"qwik\",\n \"starters\",\n \"template\"\n ],\n \"license\": \"MIT\",\n \"main\": \"./dist/index.cjs\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/QwikDev/qwik.git\",\n \"directory\": \"packages/create-qwik\"\n }\n}\n" }, { "path": "packages/create-qwik/src/create-app-facade.ts", "content": "import type { CreateAppOptions, CreateAppResult } from '../../qwik/src/cli/types';\n\nimport { createApp } from './create-app';\nimport { getPackageManager } from '../../qwik/src/cli/utils/utils';\nimport { makeTemplateManager } from './helpers/templateManager';\n\nexport async function createAppFacade(opts: CreateAppOptions): Promise {\n const pkgManager = getPackageManager();\n\n const templateManager = await makeTemplateManager('app');\n\n return await createApp({\n appId: opts.starterId,\n templateManager,\n outDir: opts.outDir,\n pkgManager,\n });\n}\n" }, { "path": "packages/create-qwik/src/create-app.ts", "content": "import type { CreateAppResult, IntegrationData } from '../../qwik/src/cli/types';\nimport fs from 'node:fs';\nimport { isAbsolute, join } from 'node:path';\nimport { cleanPackageJson, writePackageJson } from '../../qwik/src/cli/utils/utils';\nimport { updateApp } from '../../qwik/src/cli/add/update-app';\nimport { type TemplateManager } from './helpers/templateManager';\n\ntype Options = {\n appId: string;\n templateManager: TemplateManager;\n outDir: string;\n pkgManager: string;\n};\n\ntype CreateFromStarterOptions = {\n pkgManager: string;\n baseApp: IntegrationData;\n starterApp?: IntegrationData;\n outDir: string;\n};\n\nfunction isValidOption(value: any) {\n return typeof value === 'string' && value.trim().length > 0;\n}\n\nfunction validateOptions(opts: Options) {\n if (!isValidOption(opts.outDir)) {\n throw new Error(`Missing outDir`);\n }\n\n if (!isAbsolute(opts.outDir)) {\n throw new Error(`outDir must be an absolute path`);\n }\n}\n\nexport async function createApp(opts: Options): Promise {\n const { appId, outDir, pkgManager, templateManager } = opts;\n\n const { baseApp, starterApp } = templateManager.getBootstrapApps(appId);\n\n validateOptions(opts);\n\n if (!fs.existsSync(outDir)) {\n fs.mkdirSync(decodeURIComponent(outDir), { recursive: true });\n }\n\n const docs = await createFromStarter({ baseApp, starterApp, pkgManager, outDir });\n\n return { starterId: opts.appId, outDir, pkgManager, docs };\n}\n\nasync function createFromStarter({\n baseApp,\n starterApp,\n outDir,\n pkgManager,\n}: CreateFromStarterOptions): Promise {\n const docs = [...baseApp.docs];\n\n const appInfo = starterApp ?? baseApp;\n\n const appPkgJson = cleanPackageJson({\n ...baseApp.pkgJson,\n name: `my-${appInfo.pkgJson.name}`,\n description: appInfo.pkgJson.description,\n scripts: undefined,\n dependencies: undefined,\n devDependencies: undefined,\n });\n\n await writePackageJson(outDir, appPkgJson);\n\n const readmePath = join(outDir, 'README.md');\n await fs.promises.writeFile(readmePath, '');\n\n const baseUpdate = await updateApp(pkgManager, {\n rootDir: outDir,\n integration: baseApp.id,\n installDeps: false,\n });\n\n await baseUpdate.commit(false);\n\n if (starterApp) {\n docs.push(...starterApp.docs);\n\n const starterUpdate = await updateApp(pkgManager, {\n rootDir: outDir,\n integration: starterApp.id,\n installDeps: false,\n });\n\n await starterUpdate.commit(false);\n }\n\n return docs;\n}\n" }, { "path": "packages/create-qwik/src/helpers/clearDir.ts", "content": "import fs from 'node:fs';\nimport { join } from 'node:path';\n\nexport const clearDir = async (dir: string) => {\n const files = await fs.promises.readdir(dir);\n\n return await Promise.all(\n files.map((pathToFile) => fs.promises.rm(join(dir, pathToFile), { recursive: true }))\n );\n};\n" }, { "path": "packages/create-qwik/src/helpers/installDepsCli.ts", "content": "import type { spinner } from '@clack/prompts';\n\ntype Sinner = ReturnType;\n\ntype Params = {\n spinner: Sinner;\n pkgManager: string;\n};\n\nexport async function installDepsCli(fn: () => Promise, { pkgManager, spinner }: Params) {\n spinner.start(`Installing ${pkgManager} dependencies...`);\n\n const success = await fn();\n\n spinner.stop(`${success ? 'Installed' : 'Failed to install'} ${pkgManager} dependencies 📋`);\n\n return success;\n}\n" }, { "path": "packages/create-qwik/src/helpers/jokes.json", "content": "[\n [\"What's the best thing about a Boolean?\", \"Even if you're wrong, you're only off by a bit.\"],\n [\"Why did the developer stay at home?\", \"Because he couldn't find his keys.\"],\n [\"How many programmers does it take to change a lightbulb?\", \"None that's a hardware problem\"],\n [\"A user interface is like a joke.\", \"If you have to explain it then it is not that good.\"],\n [\"['hip', 'hip']\", \"(hip hip array)\"],\n [\"A SQL query goes into a bar, walks up to two tables and asks:\", \"'Can I JOIN you?'\"],\n [\"Why did the developer go to therapy?\", \"He had too many unresolved issues.\"],\n [\n \"Why do C# and Java developers keep breaking their keyboards?\",\n \"Because they use a strongly typed language.\"\n ],\n [\"What's the object-oriented way to become wealthy?\", \"Inheritance\"],\n [\"Where do programmers like to hangout?\", \"The Foo Bar.\"],\n [\"Why do Java programmers wear glasses?\", \"Because they don't C#\"],\n [\"To understand what recursion is...\", \"You must first understand what recursion is\"],\n [\"The punchline often arrives before the set-up.\", \"Do you know the problem with UDP jokes?\"],\n [\"Why did the programmer quit his job?\", \"Because he didn't get arrays.\"],\n [\"Why was the computer tired when it got home?\", \"It had a hard drive.\"],\n [\n \"There are 10 types of people in this world...\",\n \"Those who understand binary and those who don't\"\n ],\n [\"Why do programmers always mix up Halloween and Christmas?\", \"Because Oct 31 == Dec 25\"],\n [\"I was gonna tell you a joke about UDP...\", \"...but you might not get it.\"],\n [\"Normal People: give me just a second\", \"Developers: give me 1000 milliseconds!\"],\n [\"Why do programmers prefer dark mode?\", \"Because light attracts bugs.\"],\n [\"Why don't programmers like nature?\", \"It has too many bugs.\"],\n [\"Why was the computer freezing?\", \"It left its Windows open!\"],\n [\"What did the Java code say to the C code?\", \"You've got no class.\"],\n [\"Why do programmers prefer the outdoors?\", \"Because it's free of bugs.\"],\n [\"Why do programmers love movies?\", \"Because they can 'script' the ending.\"],\n [\"why do desert animals hate Qwik?\", \"Because there's no hydration....\"],\n [\"What can you do if you cannot push your git changes?\", \"Use the --force, Luke\"],\n [\"How did the developer announce he's getting married?\", \"'She returned true!'\"],\n [\"How many Prolog programmers does it take to change a lightbulb?\", \"Yes.\"],\n [\"Why did the developer ground their kid?\", \"They weren't telling the truthy\"],\n [\"!false\", \"It's funny 'cause it's true.\"],\n [\"Where did the parallel function wash its hands?\", \"Async\"],\n [\"How do functions break up?\", \"They stop calling each other\"],\n [\"Why did the functions stop calling each other?\", \"Because they had constant arguments.\"],\n [\"What's the second movie about a database engineer called?\", \"The SQL.\"],\n [\"What did the computer do at lunchtime?\", \"NoSQL.\"],\n [\"Why doesn't Hollywood make more Big Data movies?\", \"Had a byte!\"],\n [\"What does a baby computer call his father?\", \"Data!\"],\n [\"I never tell the same joke twice\", \"I have a DRY sense of humor.\"],\n [\"How do programming pirates pass method parameters?\", \"ARRRRRGS.\"],\n [\"Why don't bachelors like Git?\", \"Because they are afraid to commit.\"],\n [\"Why do astronauts use Linux?\", \"They can't open Windows in space!\"],\n [\"How do front end devs like their brownies?\", \"GUI\"],\n [\"What do hackers do on a boat?\", \"Phishing.\"],\n [\"Why couldn't the HTML list be trusted?\", \"There were LI's everywhere\"],\n [\"To the person who invented zero:\", \"Thank's for nothing!\"],\n [\"What do you call a bee that lives in America?\", \"A USB\"],\n [\"want about to a race conditions hear joke?\", \"\"],\n [\"What is a Package Managers favorite holiday?\", \"Dependency Day\"],\n [\"Where do we get all of these dad jokes from?\", \"A dad-a-base!\"],\n [\"What advice do you give to a JS developer who has never played baseball?\", \"Try catch.\"],\n [\"We don't have any DNS jokes, know why?\", \"Because it may take 24 hours to get them\"],\n [\"Why do Front-End Developers eat lunch alone?\", \"Because they don't know how to join tables.\"],\n [\"How do you help JS errors?\", \"You `console` them!\"],\n [\"When do front end developers go out to eat?\", \"On their lunch
.\"],\n [\"What do you call optimistic front-end developers?\", \"Stack half-full developers.\"]\n]\n" }, { "path": "packages/create-qwik/src/helpers/jokes.ts", "content": "import jokes from './jokes.json';\n\nexport function getRandomJoke() {\n const index = Math.floor(Math.random() * jokes.length);\n return jokes[index]!;\n}\n" }, { "path": "packages/create-qwik/src/helpers/logAppCreated.ts", "content": "import { bgMagenta, bold, cyan, magenta } from 'kleur/colors';\n\nimport type { CreateAppResult } from '../../../qwik/src/cli/types';\nimport { logSuccessFooter } from '../../../qwik/src/cli/utils/log';\nimport { note } from '../../../qwik/src/cli/utils/utils';\nimport { outro } from '@clack/prompts';\nimport { relative } from 'node:path';\n\nexport function logAppCreated(pkgManager: string, result: CreateAppResult, ranInstall: boolean) {\n const isCwdDir = process.cwd() === result.outDir;\n const relativeProjectPath = relative(process.cwd(), result.outDir);\n const outString = [];\n\n if (isCwdDir) {\n outString.push(`🦄 ${bgMagenta(' Success! ')}`);\n } else {\n outString.push(\n `🦄 ${bgMagenta(' Success! ')} ${cyan(`Project created in`)} ${bold(\n magenta(relativeProjectPath)\n )} ${cyan(`directory`)}`\n );\n }\n outString.push(``);\n\n const qwikAdd = pkgManager !== 'npm' ? `${pkgManager} qwik add` : `npm run qwik add`;\n outString.push(`🤍 ${cyan('Integrations? Add Netlify, Cloudflare, Tailwind...')}`);\n outString.push(` ${qwikAdd}`);\n outString.push(``);\n\n outString.push(logSuccessFooter(result.docs));\n\n outString.push(`👀 ${cyan('Presentations, Podcasts and Videos:')}`);\n outString.push(` https://qwik.dev/media/`);\n outString.push(``);\n\n outString.push(`🐰 ${cyan(`Next steps:`)}`);\n if (!isCwdDir) {\n outString.push(` cd ${relativeProjectPath}`);\n }\n if (!ranInstall) {\n outString.push(` ${pkgManager} install`);\n }\n if (pkgManager === 'deno') {\n outString.push(` deno task start`);\n } else {\n outString.push(` ${pkgManager} start`);\n }\n outString.push(``);\n\n note(outString.join('\\n'), 'Result');\n\n outro('Happy coding! 🎉');\n}\n" }, { "path": "packages/create-qwik/src/helpers/resolveRelativeDir.ts", "content": "import { resolve } from 'path';\nimport os from 'node:os';\n\nexport function resolveRelativeDir(dir: string) {\n // check if the outDir start with home ~\n if (dir.startsWith('~/')) {\n return resolve(os.homedir(), dir);\n } else {\n return resolve(process.cwd(), dir);\n }\n}\n" }, { "path": "packages/create-qwik/src/helpers/templateManager.ts", "content": "import type { IntegrationData, IntegrationType } from 'packages/qwik/src/cli/types';\n\nimport { loadIntegrations } from 'packages/qwik/src/cli/utils/integrations';\n\nlet integrations: IntegrationData[] | undefined = undefined;\n\nconst LIBRARY_ID = 'library';\nconst BASE_ID = 'base';\n\nclass AppNotFoundError extends Error {\n constructor(id: string, templates: IntegrationData[]) {\n super();\n\n this.message = `Invalid app id \"${id}\". It can only be one of${templates.map(\n (app) => ` \"${app.id}\"`\n )}.`;\n }\n}\n\nexport const makeTemplateManager = async (type: IntegrationType) => {\n if (!integrations) {\n integrations = await loadIntegrations();\n }\n\n const templates = integrations.filter((i) => i.type === type);\n const standaloneTemplates = templates.filter((i) => i.id !== BASE_ID);\n\n function getAppById(\n id: string,\n isStandaloneInstallable: boolean = true\n ): IntegrationData | undefined {\n if (isStandaloneInstallable) {\n return standaloneTemplates.find((t) => t.id === id);\n }\n return templates.find((t) => t.id === id);\n }\n\n function getBaseApp(): IntegrationData | undefined {\n return getAppById(BASE_ID, false);\n }\n\n function getBootstrapApps(id: string): {\n baseApp: IntegrationData;\n starterApp?: IntegrationData;\n } {\n const isLibrary = id === LIBRARY_ID;\n\n if (isLibrary) {\n const libApp = getAppById(id);\n\n if (!libApp) {\n throw new AppNotFoundError(id, standaloneTemplates);\n }\n\n return { baseApp: libApp };\n }\n\n const baseApp = getAppById(BASE_ID, false);\n const starterApp = getAppById(id);\n\n if (!baseApp) {\n throw new AppNotFoundError(BASE_ID, standaloneTemplates);\n }\n\n if (!starterApp) {\n throw new AppNotFoundError(id, standaloneTemplates);\n }\n\n return { baseApp, starterApp };\n }\n\n return {\n templates,\n standaloneTemplates,\n getAppById,\n getBootstrapApps,\n getBaseApp,\n };\n};\n\nexport type TemplateManager = Awaited>;\n" }, { "path": "packages/create-qwik/src/run-create-cli.ts", "content": "import { cancel, intro, log, spinner as spinnerPrompt } from '@clack/prompts';\n\nimport type { CreateAppResult } from 'packages/qwik/src/cli/types';\nimport { bgBlue } from 'kleur/colors';\nimport { clearDir } from './helpers/clearDir';\nimport { createApp } from './create-app';\nimport fs from 'node:fs';\nimport { getPackageManager } from '../../qwik/src/cli/utils/utils';\nimport { installDepsCli } from './helpers/installDepsCli';\nimport { installDeps as installDepsFn } from 'packages/qwik/src/cli/utils/install-deps';\nimport { logAppCreated } from './helpers/logAppCreated';\nimport { makeTemplateManager } from './helpers/templateManager';\nimport { resolveRelativeDir } from './helpers/resolveRelativeDir';\nimport yargs from 'yargs';\n\ntype Args = {\n outDir: string;\n template: string;\n installDeps: boolean;\n force: boolean;\n};\n\nfunction parseArgs(args: string[], templates: string[]) {\n const parsedArgs = yargs(args)\n .strict()\n .command('*