@excom/nucleus-quark-highlighter 0.1.0

package/.rush/temp/chunked-rush-logs/nucleus-quark-highlighter.apply-exports.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: cd \"$RUSH_PROJECT_FOLDER\" && node ../heft-rig/scripts/apply-exports.mjs \n"}

package/.rush/temp/chunked-rush-logs/nucleus-quark-highlighter.build_package-metas.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs \n"}

package/.rush/temp/operation/apply-exports/all.log

@@ -0,0 +1 @@
+Invoking: cd "$RUSH_PROJECT_FOLDER" && node ../heft-rig/scripts/apply-exports.mjs 

package/.rush/temp/operation/apply-exports/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: cd \"$RUSH_PROJECT_FOLDER\" && node ../heft-rig/scripts/apply-exports.mjs \n"}

package/.rush/temp/operation/apply-exports/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 35.49799699999994
+}

package/.rush/temp/operation/build_package-metas/all.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs 

package/.rush/temp/operation/build_package-metas/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs \n"}

package/.rush/temp/operation/build_package-metas/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 88.42872399999987
+}

package/.rush/temp/shrinkwrap-deps.json

@@ -0,0 +1,31 @@
+{
+  "../../packages/nucleus-quark-highlighter": "../../packages/nucleus-quark-highlighter:CLYavdzNRF0GlQqRRtZ4IpHQhBTGSmS0qSnBNkdp3Ig=:",
+  "@esbuild/aix-ppc64@0.28.2": "@esbuild/aix-ppc64@0.28.2:EMM/YcOSZm2KdqOI7JV/ZBP/kfIUAGRs+ac2MTNUNSU=:",
+  "@esbuild/android-arm64@0.28.2": "@esbuild/android-arm64@0.28.2:DKCxOLbsLt7L1pN/jQYTCxJsXY+p9WYFTXJHMXGA5WM=:",
+  "@esbuild/android-arm@0.28.2": "@esbuild/android-arm@0.28.2:xUNq1+kXskMVzUzPRI5ms9M5CgClbWEq/P/0sQHsSP0=:",
+  "@esbuild/android-x64@0.28.2": "@esbuild/android-x64@0.28.2:8o3ADYLKarKfGViyaXcHE2iBvjL0og5LegLkZATRKVo=:",
+  "@esbuild/darwin-arm64@0.28.2": "@esbuild/darwin-arm64@0.28.2:PzMv5Mh7G2N0ZVnohry0Sqomu1rCGtEaxiI4dJTewb0=:",
+  "@esbuild/darwin-x64@0.28.2": "@esbuild/darwin-x64@0.28.2:MLT/aDcfGo8xCB6u+zMlF3oe/6A1/doCvbK0NU8OUJ4=:",
+  "@esbuild/freebsd-arm64@0.28.2": "@esbuild/freebsd-arm64@0.28.2:MQuX8jRJondQ1hY1NH8LvojklPEO2B7JisMEGgoEp90=:",
+  "@esbuild/freebsd-x64@0.28.2": "@esbuild/freebsd-x64@0.28.2:0agX9W6LfLvw7bOXCyDX+qeEEx+O9wGSQejQPWM2xIs=:",
+  "@esbuild/linux-arm64@0.28.2": "@esbuild/linux-arm64@0.28.2:FAEI/lSwtrUNBYeEeyhO5OaalMLRDiZ8LBfva3jcn1k=:",
+  "@esbuild/linux-arm@0.28.2": "@esbuild/linux-arm@0.28.2:OrkKPAD0/M/VjvKFMh/wk2+uxtFwQ2igfNFYfk36TNA=:",
+  "@esbuild/linux-ia32@0.28.2": "@esbuild/linux-ia32@0.28.2:qYSnA4fleBEpkOE4rp1qAZSxfodl4WJBB8aEB+1H01s=:",
+  "@esbuild/linux-loong64@0.28.2": "@esbuild/linux-loong64@0.28.2:eUrxoVuWCtWEKPTUtIGxnpG1/Y4JWPVTSu42POLdjG8=:",
+  "@esbuild/linux-mips64el@0.28.2": "@esbuild/linux-mips64el@0.28.2:5YctABnidMC7/9x/B6F65tX2gTC6u2LzcHlmwNhoeKc=:",
+  "@esbuild/linux-ppc64@0.28.2": "@esbuild/linux-ppc64@0.28.2:wG07FlZEkA9Hpnka22RzHHDuhyVpnPkux9C8WksOitg=:",
+  "@esbuild/linux-riscv64@0.28.2": "@esbuild/linux-riscv64@0.28.2:5wv+bG8qZIjVhBPkiKPZdxu7wyXx89vJcgxUrlXaFLw=:",
+  "@esbuild/linux-s390x@0.28.2": "@esbuild/linux-s390x@0.28.2:/PdqhxC2KwhZFhKR2V5GTm+9uK5KlFA53a+8w6zzCOE=:",
+  "@esbuild/linux-x64@0.28.2": "@esbuild/linux-x64@0.28.2:9jqLdOKXRimXSyn7OQAFunA+5M53I8vVJWkuPJuvFIQ=:",
+  "@esbuild/netbsd-arm64@0.28.2": "@esbuild/netbsd-arm64@0.28.2:jvv5D2pK1VyBSfnuCSn1xblQMMh2gkXSHtdobw4kVWk=:",
+  "@esbuild/netbsd-x64@0.28.2": "@esbuild/netbsd-x64@0.28.2:GL2RDD5qQTPyVx1FfDZWMr7zRbSfDAswyqLJ2naKnhw=:",
+  "@esbuild/openbsd-arm64@0.28.2": "@esbuild/openbsd-arm64@0.28.2:y/GYc5NhweVkDCFFbfaDAYiN7zk1T5T89s3XtXzR5GQ=:",
+  "@esbuild/openbsd-x64@0.28.2": "@esbuild/openbsd-x64@0.28.2:qj4Y/W0eEQ4FQEpOUGErKfvy080WenSnsFj9HR5ncwY=:",
+  "@esbuild/openharmony-arm64@0.28.2": "@esbuild/openharmony-arm64@0.28.2:wvBkvEBZtcp+QFIHtbRQCCx5ARkfTcdZROh5SdPMIKU=:",
+  "@esbuild/sunos-x64@0.28.2": "@esbuild/sunos-x64@0.28.2:JZYYva4FUv7TuFqaW9G4plR0W70/a0v5eTpPfbeLZx0=:",
+  "@esbuild/win32-arm64@0.28.2": "@esbuild/win32-arm64@0.28.2:4TUBnHrLd6stf27wjAc6Ypzo09zt/9anox28AHQWQiQ=:",
+  "@esbuild/win32-ia32@0.28.2": "@esbuild/win32-ia32@0.28.2:53jfVpnP+jcPi1yW8zoaRdwGg+UC01hojZMwSoUlO3E=:",
+  "@esbuild/win32-x64@0.28.2": "@esbuild/win32-x64@0.28.2:FnuXaWDAODGYCui3N7LVyh+KCYwrNrxGNAPgq3K+fuw=:",
+  "@types/vscode@1.125.0": "@types/vscode@1.125.0:89oVF6ckf++rv0MytcdWOUaiKFrXPBF48C4ufd059Zo=:",
+  "esbuild@0.28.2": "esbuild@0.28.2:ifYVvs8wKiOsrhcIJX/fCHaoTrpM3PMruwKOWmgb/iQ=:"
+}

package/.vscodeignore

@@ -0,0 +1,10 @@
+.rush/**
+src/**
+scripts/**
+support/**
+node_modules/**
+rush-logs/**
+config/**
+shiki.mjs
+tsconfig.json
+*.vsix

package/LICENSE.md

@@ -0,0 +1 @@
+MIT

package/icons/marketplace-icon.svg

@@ -0,0 +1,6 @@
+<svg width="128" height="128" viewBox="0 0 128 128" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="128" height="128" rx="24" fill="#1F2430"/>
+<g transform="translate(29 16)">
+<path d="M14.7974 2.75049C16.3162 0.120058 19.6795 -0.780888 22.3101 0.737793L51.7554 17.7378C68.2561 27.2647 73.9097 48.3639 64.3833 64.8647C59.8431 72.7287 52.6732 78.1266 44.6265 80.5942L52.1997 84.9673C54.8301 86.4861 55.732 89.8494 54.2134 92.48C52.6946 95.1105 49.3303 96.0113 46.6997 94.4927L17.2554 77.4927C0.75456 67.9658 -4.89914 46.8667 4.62744 30.3657C9.16746 22.5023 16.3361 17.103 24.3823 14.6353L16.8101 10.2632C14.1798 8.74427 13.2787 5.38094 14.7974 2.75049ZM46.2554 27.2642C35.0155 20.7748 20.6432 24.626 14.1538 35.8657C7.76615 46.9299 11.3978 61.029 22.2339 67.6567L22.7554 67.9673L23.2847 68.2632C34.4426 74.3336 48.469 70.429 54.8569 59.3647C61.3458 48.125 57.4948 33.7535 46.2554 27.2642ZM23.8979 37.0083C29.7558 31.1505 39.254 31.1505 45.1118 37.0083C50.9696 42.8661 50.9696 52.3643 45.1118 58.2222C39.254 64.08 29.7558 64.08 23.8979 58.2222C18.0401 52.3643 18.0401 42.8662 23.8979 37.0083Z" fill="#4FC9B0"/>
+</g>
+</svg>

package/icons/quark-file.svg

@@ -0,0 +1,3 @@
+<svg width="128" height="128" viewBox="-29 -16 128 128" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M14.7974 2.75049C16.3162 0.120058 19.6795 -0.780888 22.3101 0.737793L51.7554 17.7378C68.2561 27.2647 73.9097 48.3639 64.3833 64.8647C59.8431 72.7287 52.6732 78.1266 44.6265 80.5942L52.1997 84.9673C54.8301 86.4861 55.732 89.8494 54.2134 92.48C52.6946 95.1105 49.3303 96.0113 46.6997 94.4927L17.2554 77.4927C0.75456 67.9658 -4.89914 46.8667 4.62744 30.3657C9.16746 22.5023 16.3361 17.103 24.3823 14.6353L16.8101 10.2632C14.1798 8.74427 13.2787 5.38094 14.7974 2.75049ZM46.2554 27.2642C35.0155 20.7748 20.6432 24.626 14.1538 35.8657C7.76615 46.9299 11.3978 61.029 22.2339 67.6567L22.7554 67.9673L23.2847 68.2632C34.4426 74.3336 48.469 70.429 54.8569 59.3647C61.3458 48.125 57.4948 33.7535 46.2554 27.2642ZM23.8979 37.0083C29.7558 31.1505 39.254 31.1505 45.1118 37.0083C50.9696 42.8661 50.9696 52.3643 45.1118 58.2222C39.254 64.08 29.7558 64.08 23.8979 58.2222C18.0401 52.3643 18.0401 42.8662 23.8979 37.0083Z" fill="#4FC9B0"/>
+</svg>

package/package.json

@@ -0,0 +1,127 @@
+{
+  "name": "@excom/nucleus-quark-highlighter",
+  "version": "0.1.0",
+  "displayName": "Nucleus & Quark Syntax Highlighter",
+  "description": "VS Code syntax highlighting for Quark sheets and Nucleus-style HTML",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.13.0",
+    "vscode": "^1.74.0"
+  },
+  "type": "module",
+  "dependencies": {},
+  "peerDependencies": {},
+  "devDependencies": {
+    "@types/vscode": "^1.74.0",
+    "esbuild": "^0.28.2",
+    "@excom/heft-rig": "^0.1.0",
+    "@excom/quark-formatter": "^0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/excom-dev/nucleus.git",
+    "directory": "packages/nucleus-quark-highlighter"
+  },
+  "homepage": "https://github.com/excom-dev/nucleus/tree/main/packages/nucleus-quark-highlighter/support/docs/README.md",
+  "bugs": "https://github.com/excom-dev/nucleus/issues",
+  "keywords": [
+    "nucleus-quark-highlighter",
+    "tool",
+    "nucleus",
+    "quark",
+    "nucleus-syntax-highlighting",
+    "quark-syntax-highlighting",
+    "syntax-highlighting",
+    "vscode-extension"
+  ],
+  "excom": {
+    "packageType": "tool"
+  },
+  "activationEvents": [
+    "onLanguage:quark"
+  ],
+  "categories": [
+    "Programming Languages",
+    "Formatters"
+  ],
+  "contributes": {
+    "languages": [
+      {
+        "id": "quark",
+        "aliases": [
+          "Quark",
+          "quark"
+        ],
+        "extensions": [
+          ".quark"
+        ],
+        "configuration": "./quark.configuration.json",
+        "icon": {
+          "light": "./icons/quark-file.svg",
+          "dark": "./icons/quark-file.svg"
+        }
+      }
+    ],
+    "commands": [
+      {
+        "command": "quark.formatSheets",
+        "title": "Quark: Format <quark-sheet> blocks"
+      }
+    ],
+    "keybindings": [
+      {
+        "command": "editor.action.commentLine",
+        "key": "ctrl+/",
+        "mac": "cmd+/",
+        "when": "editorTextFocus && editorLangId == 'quark'"
+      },
+      {
+        "command": "editor.action.blockComment",
+        "key": "shift+alt+a",
+        "mac": "shift+alt+a",
+        "when": "editorTextFocus && editorLangId == 'quark'"
+      },
+      {
+        "command": "editor.action.formatDocument",
+        "key": "shift+alt+f",
+        "mac": "shift+alt+f",
+        "when": "editorTextFocus && editorLangId == 'quark'"
+      }
+    ],
+    "grammars": [
+      {
+        "scopeName": "injection.html.custom-elements",
+        "path": "./syntaxes/html-custom-elements.tmLanguage.json",
+        "injectTo": [
+          "text.html.derivative",
+          "text.html.basic"
+        ]
+      },
+      {
+        "language": "quark",
+        "scopeName": "source.quark",
+        "path": "./syntaxes/quark.tmLanguage.json"
+      }
+    ]
+  },
+  "exports": {
+    "./shiki": "./shiki.mjs",
+    "./syntaxes/*": "./syntaxes/*"
+  },
+  "icon": "icons/marketplace-icon.png",
+  "main": "./dist/extension.cjs",
+  "publisher": "excom-dev",
+  "scripts": {
+    "build": "node scripts/build-extension.mjs",
+    "build:watch": "node -e \"console.log('nucleus-quark-highlighter: no build watch')",
+    "format": "node -e \"console.log('nucleus-quark-highlighter: no format')\"",
+    "test": "node -e \"console.log('nucleus-quark-highlighter: no tests')\"",
+    "coverage": "node -e \"console.log('nucleus-quark-highlighter: no tests')\"",
+    "retest": "node -e \"console.log('nucleus-quark-highlighter: no retests')\"",
+    "recoverage": "node -e \"console.log('nucleus-quark-highlighter: no recoverage')\"",
+    "reformat": "node -e \"console.log('nucleus-quark-highlighter: no reformat')\"",
+    "build:package-metas": "node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs",
+    "package:vsix": "node scripts/package-vsix.mjs",
+    "publish:vsix": "node scripts/package-vsix.mjs --publish"
+  }
+}

package/quark.configuration.json

@@ -0,0 +1,35 @@
+{
+  "comments": {
+    "blockComment": ["/*", "*/"]
+  },
+  "brackets": [
+    ["{", "}"],
+    ["[", "]"],
+    ["(", ")"]
+  ],
+  "autoClosingPairs": [
+    { "open": "{", "close": "}", "notIn": ["string", "comment"] },
+    { "open": "[", "close": "]", "notIn": ["string", "comment"] },
+    { "open": "(", "close": ")", "notIn": ["string", "comment"] },
+    { "open": "\"", "close": "\"", "notIn": ["string", "comment"] },
+    { "open": "'", "close": "'", "notIn": ["string", "comment"] }
+  ],
+  "surroundingPairs": [
+    ["{", "}"],
+    ["[", "]"],
+    ["(", ")"],
+    ["\"", "\""],
+    ["'", "'"]
+  ],
+  "folding": {
+    "markers": {
+      "start": "^\\s*\\/\\*\\s*#region\\b\\s*(.*?)\\s*\\*\\/",
+      "end": "^\\s*\\/\\*\\s*#endregion\\b.*\\*\\/"
+    }
+  },
+  "indentationRules": {
+    "increaseIndentPattern": "(^.*\\{[^}]*$)",
+    "decreaseIndentPattern": "^\\s*\\}"
+  },
+  "wordPattern": "(#?-?\\d*\\.\\d\\w*%?)|(::?[\\w-]*(?=[^,{;]*[,{]))|(([@$#.])?[\\w-?]+%?|[@#$.])"
+}

package/rush-logs/nucleus-quark-highlighter.apply-exports.cache.log

@@ -0,0 +1 @@
+Project does not have a rush-project.json configuration file, or one provided by a rig, so it does not support caching.

package/rush-logs/nucleus-quark-highlighter.apply-exports.log

@@ -0,0 +1 @@
+Invoking: cd "$RUSH_PROJECT_FOLDER" && node ../heft-rig/scripts/apply-exports.mjs 

package/rush-logs/nucleus-quark-highlighter.build_package-metas.cache.log

@@ -0,0 +1 @@
+Project does not have a rush-project.json configuration file, or one provided by a rig, so it does not support caching.

package/rush-logs/nucleus-quark-highlighter.build_package-metas.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs 

package/scripts/build-extension.mjs

@@ -0,0 +1,24 @@
+import { build } from "esbuild";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const pkgRoot = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  "..",
+);
+
+/* Bundle the extension entry (plus `@excom/quark-formatter` and its
+   parser) into one self-contained CJS file so the .vsix has no runtime
+   node_modules. */
+await build({
+  entryPoints: [path.join(pkgRoot, "src/extension.ts")],
+  bundle: true,
+  platform: "node",
+  format: "cjs",
+  target: "node16",
+  external: ["vscode"],
+  outfile: path.join(pkgRoot, "dist/extension.cjs"),
+  minify: true,
+});
+
+console.log("nucleus-quark-highlighter: built dist/extension.cjs");

package/scripts/package-vsix.mjs

@@ -0,0 +1,53 @@
+import { execFileSync } from "node:child_process";
+import { readFile, writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const pkgRoot = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  "..",
+);
+const manifestPath = path.join(pkgRoot, "package.json");
+const publish = process.argv.includes("--publish");
+
+/* vsce rejects npm-scoped names; rush requires them. Unscope the
+   manifest for packaging, then restore it. The .vsix already carries
+   the unscoped name, so publish from the file needs no second rewrite. */
+const original = await readFile(manifestPath, "utf8");
+const manifest = JSON.parse(original);
+manifest.name = manifest.name.replace(/^@[^/]+\//, "");
+const vsixFile = `${manifest.name}-${manifest.version}.vsix`;
+
+const npx = (args) =>
+  execFileSync("npx", ["--yes", ...args], { cwd: pkgRoot, stdio: "inherit" });
+
+try {
+  execFileSync("node", [path.join(pkgRoot, "scripts/build-extension.mjs")], {
+    cwd: pkgRoot,
+    stdio: "inherit",
+  });
+  await writeFile(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+  npx([
+    "@vscode/vsce",
+    "package",
+    "--allow-missing-repository",
+    "--skip-license",
+    "--out",
+    vsixFile,
+  ]);
+} finally {
+  await writeFile(manifestPath, original);
+}
+
+if (publish) {
+  // Marketplace (VS Code) needs `VSCE_PAT`; Open VSX (Cursor, VSCodium,
+  // Windsurf, ...) needs `OVSX_PAT`. Both tools read those env vars.
+  const missing = ["VSCE_PAT", "OVSX_PAT"].filter((k) => !process.env[k]);
+  if (missing.length) {
+    console.error(`package-vsix: set ${missing.join(" and ")} to publish`);
+    process.exit(1);
+  }
+  npx(["@vscode/vsce", "publish", "--packagePath", vsixFile]);
+  npx(["ovsx", "publish", vsixFile]);
+  console.log(`nucleus-quark-highlighter: published ${vsixFile}`);
+}

package/shiki.mjs

@@ -0,0 +1,35 @@
+/**
+ * Shiki `LanguageRegistration` wrappers for the TextMate grammars here.
+ * Pass to `createHighlighter({ langs: [...shikiLangs] })`.
+ */
+// Keep each grammar import on one line with no trailing comma inside the
+// attribute clause: es-module-lexer (used by Vite dev) does not recognise
+// `with { type: "json", }` as import attributes, so Vite leaves the clause
+// in place while serving the JSON as a JS module, and the browser then
+// rejects the mismatched MIME type (breaking every `@use "/shell"` sheet).
+// prettier-ignore
+import quarkGrammar from "./syntaxes/quark.tmLanguage.json" with { type: "json" };
+// prettier-ignore
+import htmlCustomElementsGrammar from "./syntaxes/html-custom-elements.tmLanguage.json" with { type: "json" };
+
+/** Standalone Quark (`.quark` / `quark` fences). */
+export const quark = {
+  ...quarkGrammar,
+  name: "quark",
+  displayName: "Quark",
+  embeddedLangs: ["css"],
+};
+
+/**
+ * Injection for Nucleus-style HTML: kebab custom elements / attrs, plus
+ * Quark inside `<quark-sheet>`. Applied when `html` / `html-derivative`
+ * is highlighted.
+ */
+export const htmlCustomElements = {
+  ...htmlCustomElementsGrammar,
+  name: "html-custom-elements",
+  injectTo: ["text.html.basic", "text.html.derivative"],
+  embeddedLangs: ["quark"],
+};
+
+export const shikiLangs = [quark, htmlCustomElements];

package/src/extension.ts

@@ -0,0 +1,107 @@
+import * as vscode from "vscode";
+import { format } from "@excom/quark-formatter";
+
+const SHEET_PATTERN = /(<quark-sheet\b[^>]*>)([\s\S]*?)(?=<\/quark-sheet>)/gi;
+
+export function activate(context: vscode.ExtensionContext): void {
+  context.subscriptions.push(
+    vscode.languages.registerDocumentFormattingEditProvider("quark", {
+      provideDocumentFormattingEdits(document, options) {
+        const source = document.getText();
+        try {
+          const formatted = format(source, {
+            indent: indentUnit(options),
+          });
+          if (formatted === source) return [];
+          const fullRange = new vscode.Range(
+            document.positionAt(0),
+            document.positionAt(source.length),
+          );
+          return [vscode.TextEdit.replace(fullRange, formatted)];
+        } catch (error) {
+          // Parse error: leave the document alone rather than mangle it.
+          vscode.window.setStatusBarMessage(
+            `Quark: cannot format (${errorMessage(error)})`,
+            5000,
+          );
+          return [];
+        }
+      },
+    }),
+    vscode.commands.registerCommand(
+      "quark.formatSheets",
+      formatQuarkSheetBlocks,
+    ),
+  );
+}
+
+function indentUnit(options: vscode.FormattingOptions): string {
+  return options.insertSpaces ? " ".repeat(options.tabSize) : "\t";
+}
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}
+
+/**
+ * Format every inline `<quark-sheet>` in the active HTML editor,
+ * indented one level past the tag.
+ */
+async function formatQuarkSheetBlocks(): Promise<void> {
+  const editor = vscode.window.activeTextEditor;
+  if (!editor) return;
+  const { document } = editor;
+  const tabSize = Number(editor.options.tabSize) || 2;
+  const indent =
+    editor.options.insertSpaces === false ? "\t" : " ".repeat(tabSize);
+
+  const text = document.getText();
+  const edits: Array<{ start: number; end: number; text: string }> = [];
+  const failures: string[] = [];
+
+  for (const match of text.matchAll(SHEET_PATTERN)) {
+    const inner = match[2];
+    if (!inner.trim()) continue;
+    const innerStart = match.index + match[1].length;
+    // Indentation of the line the opening tag sits on.
+    const lineStart = text.lastIndexOf("\n", match.index) + 1;
+    const baseIndent = /^[ \t]*/.exec(text.slice(lineStart, match.index))![0];
+    try {
+      const body = format(inner, { indent })
+        .trimEnd()
+        .split("\n")
+        .map((line) => (line ? baseIndent + indent + line : line))
+        .join("\n");
+      const replacement = `\n${body}\n${baseIndent}`;
+      if (replacement !== inner) {
+        edits.push({
+          start: innerStart,
+          end: innerStart + inner.length,
+          text: replacement,
+        });
+      }
+    } catch (error) {
+      failures.push(errorMessage(error));
+    }
+  }
+
+  if (edits.length) {
+    await editor.edit((builder) => {
+      for (const edit of edits) {
+        builder.replace(
+          new vscode.Range(
+            document.positionAt(edit.start),
+            document.positionAt(edit.end),
+          ),
+          edit.text,
+        );
+      }
+    });
+  }
+  const summary = failures.length
+    ? `Quark: formatted ${edits.length} sheet(s), ${failures.length} failed (${failures[0]})`
+    : `Quark: formatted ${edits.length} sheet(s)`;
+  vscode.window.setStatusBarMessage(summary, 5000);
+}
+
+export function deactivate(): void {}

package/support/docs/README.md

@@ -0,0 +1,76 @@
+# nucleus-quark-highlighter
+
+Quark sheets and Nucleus-style HTML, highlighted and formatted in VS Code / Cursor — the same grammar that colors every code block on this site.
+
+The **Nucleus & Quark Syntax Highlighter** extension adds a Quark language for `.quark` files, highlights Quark inside `<quark-sheet>` in HTML, and gives custom elements and dashed attributes their own color so Adapters and their state stand apart from native markup. Tags, custom tags, attributes and custom attributes share one palette in both grammars, so a sheet and the markup it orchestrates read the same way.
+
+```html
+<provider-fetch src-url="/api/todos" should-fetch>
+  <ul></ul>
+  <quark-sheet>
+    provider-fetch[is-success] {
+      $todos: prop("provision").body;
+      ul { content: iterate($todos); }
+    }
+  </quark-sheet>
+</provider-fetch>
+```
+
+## Features
+
+- **Quark language** `.quark` files with CSS-familiar highlighting, folding, bracket matching and `/* */` comments; Quark's at-rules — `@use`, `@scope`, `@on` with its event list, `@dispatch` / `@command`, `@view-transition`, `@delay`, `@warn` / `@debug` / `@error` — color their names, options groups, durations, messages and blocks
+- **Quark's language, nothing else** Quark is not SCSS and not a CSS superset: every other at-rule (`@media`, `@mixin`, `@if`, `@keyframes`, …) and `%placeholder` selectors are colored as errors, because Quark's parser rejects them
+- **Inline sheets** Quark inside `<quark-sheet>` in HTML is highlighted as Quark
+- **Custom elements stand out** Dashed tags / dashed attributes get their own color in HTML and in Quark selectors; a dashed tag keeps that color wherever it appears in a selector — attribute-qualified, inside `:is()` / `:not()` / `:has()`, or before a pseudo-class or pseudo-element
+- **Format Document** `.quark` files format with `@excom/quark-formatter` (`Shift+Alt+F`)
+- **Format inline sheets** `Quark: Format <quark-sheet> blocks` formats every sheet in the open HTML file
+- **File icon** `.quark` files carry the Quark icon in the explorer and tabs
+- **Shiki grammar** `@excom/nucleus-quark-highlighter/shiki` highlights Quark / Nucleus HTML in docs and static sites
+
+## Installation
+
+Install **Nucleus & Quark Syntax Highlighter** from the editor's Extensions view, or from the registries directly:
+
+- **VS Code** — [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=excom-dev.nucleus-quark-highlighter), or `ext install excom-dev.nucleus-quark-highlighter` in Quick Open
+- **Cursor / VSCodium / Windsurf** — [Open VSX](https://open-vsx.org/extension/excom-dev/nucleus-quark-highlighter)
+
+To install a build by hand, download `nucleus-quark-highlighter-<version>.vsix` from the [GitHub releases](https://github.com/excom-dev/nucleus/releases) and run `code --install-extension <file>` (`cursor --install-extension` in Cursor).
+
+For docs sites and build tooling the grammar is also on npm:
+
+```bash
+npm install @excom/nucleus-quark-highlighter
+```
+
+## Usage
+
+Open a `.quark` file and the language mode is **Quark**. Open any HTML file and `<quark-sheet>` bodies, custom elements and dashed attributes are colored without further setup.
+
+### Formatting
+
+- **`.quark` files** — Format Document (`Shift+Alt+F`, or format-on-save) reformats the whole file
+- **Inline sheets in HTML** — run **Quark: Format `<quark-sheet>` blocks** from the Command Palette; every sheet body in the active file is formatted and re-indented one level past its tag
+
+Inline sheets need the command because VS Code's HTML formatter only formats the `<style>` / `<script>` bodies it knows about and offers no hook for custom tags. A sheet that does not parse is left untouched and the reason appears in the status bar.
+
+### Shortcuts
+
+`Cmd+/` (`Ctrl+/`) and `Shift+Alt+A` both toggle `/* */` comments — Quark has no `//` line comments, so a sheet stays tokenizable by a CSS engine.
+
+### Highlighting with Shiki
+
+The extension's TextMate grammars are exported for [Shiki](https://shiki.style):
+
+```js
+import { createHighlighter } from "shiki";
+import { shikiLangs } from "@excom/nucleus-quark-highlighter/shiki";
+
+const highlighter = await createHighlighter({
+  themes: ["github-light", "github-dark"],
+  langs: ["html", "css", ...shikiLangs],
+});
+
+highlighter.codeToHtml(source, { lang: "quark", theme: "github-dark" });
+```
+
+`quark` highlights standalone sheets. `html-custom-elements` is an injection: once registered, every `html` block gets custom-element / dashed-attribute coloring and Quark highlighting inside `<quark-sheet>`. Load `css` alongside them; the Quark grammar embeds it.