@swiftuijs/twill-highlight 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Saiya and twill contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# Twill highlighting
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Portable TextMate grammars and a browser-compatible Shiki entry. The package imports no compiler, TypeScript engine, VS Code APIs or UI framework. The docs site and VSIX use the same grammar files.
+
+```sh
+pnpm add shiki @swiftuijs/twill-highlight
+```
+
+Create one highlighter, reuse it for code blocks and dispose it when its owner is destroyed:
+
+```ts
+import { createTwillHighlighter } from '@swiftuijs/twill-highlight/shiki';
+
+const highlighter = await createTwillHighlighter();
+const html = highlighter.codeToHtml('const active = users.filter { .active };', {
+  lang: 'twill', // use twillx for JSX
+  theme: 'github-dark', // or github-light
+});
+highlighter.dispose();
+```
+
+The helper loads only TS/TSX grammars and two themes, using Shiki's Oniguruma engine. Initial creation loads its WASM; tokenization is synchronous afterward. Shiki is an optional peer, separate from the grammar-only entry. Reuse the instance, and lazy-load the helper if highlighting is not needed on every page. Published archive size excludes Shiki and its WASM.
+
+## Existing Shiki integrations
+
+```ts
+import { createHighlighter } from 'shiki';
+import { twillLanguages } from '@swiftuijs/twill-highlight';
+
+const highlighter = await createHighlighter({
+  themes: ['nord'],
+  langs: ['typescript', 'tsx', ...twillLanguages],
+});
+```
+
+Both native base grammars are required. For VitePress, use `markdown.languages: twillLanguages`; its built-in grammars supply TS/TSX. Shiki 2.5, 3 and 4 are supported; the packaged consumer tests exercise the pinned versions. Custom themes, token output and transformers remain ordinary Shiki APIs.
+
+For other TextMate-compatible engines, use the JSON exports `@swiftuijs/twill-highlight/grammars/twill` and `/grammars/twillx`; load `source.ts` and `source.tsx` too. Prism and highlight.js use different grammar formats and cannot consume TextMate registrations directly.
+
+Shiki escapes code text in generated HTML. This does not sanitize arbitrary custom transformers, themes or surrounding markup. Highlighting is lexical; it supplies neither compiler diagnostics nor semantic completion. The editable playground continues to use CodeMirror for its incremental editing model.
+
+[Documentation](https://swiftuijs.github.io/twill/highlighting) · [Playground](https://swiftuijs.github.io/twill/playground) · [Issues](https://github.com/swiftuijs/twill/issues) · MIT licensed · Built by [forth.ink](https://forth.ink).

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/** The TextMate rule fields used by Twill, independent of an engine's types. */
+export interface TextMateRule {
+    name?: string;
+    include?: string;
+    match?: string;
+    begin?: string;
+    end?: string;
+    captures?: Record<string, TextMateRule>;
+    beginCaptures?: Record<string, TextMateRule>;
+    endCaptures?: Record<string, TextMateRule>;
+    patterns?: TextMateRule[];
+}
+export interface TwillGrammar {
+    name: string;
+    aliases: string[];
+    scopeName: string;
+    patterns: TextMateRule[];
+    repository: Record<string, TextMateRule>;
+    injections: Record<string, TextMateRule>;
+}
+/** Engine-independent TextMate grammars; load the TS/TSX base grammars too. */
+export declare const twill: TwillGrammar;
+export declare const twillx: TwillGrammar;
+export declare const twillLanguages: TwillGrammar[];

package/dist/index.js

@@ -0,0 +1,2 @@
+import { n as twillLanguages, r as twillx, t as twill } from "./src-B8qil4uJ.js";
+export { twill, twillLanguages, twillx };

package/dist/shiki.d.ts

@@ -0,0 +1,2 @@
+/** Create once and reuse. This entry loads only TS/TSX and two themes. */
+export declare function createTwillHighlighter(): Promise<import('shiki/core').HighlighterCore>;

package/dist/shiki.js

@@ -0,0 +1,24 @@
+import { n as twillLanguages } from "./src-B8qil4uJ.js";
+import { createHighlighterCore } from "shiki/core";
+import { createOnigurumaEngine } from "shiki/engine/oniguruma";
+import typescript from "shiki/langs/typescript.mjs";
+import tsx from "shiki/langs/tsx.mjs";
+import githubDark from "shiki/themes/github-dark.mjs";
+import githubLight from "shiki/themes/github-light.mjs";
+//#region src/shiki.ts
+/** Create once and reuse. This entry loads only TS/TSX and two themes. */
+function createTwillHighlighter() {
+	return createHighlighterCore({
+		langs: [
+			...typescript,
+			...tsx,
+			...twillLanguages
+		],
+		themes: [githubLight, githubDark],
+		engine: createOnigurumaEngine(import("shiki/wasm"))
+	});
+}
+//#endregion
+export { createTwillHighlighter };
+
+//# sourceMappingURL=shiki.js.map

package/dist/shiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shiki.js","names":[],"sources":["../src/shiki.ts"],"sourcesContent":["import { createHighlighterCore } from 'shiki/core';\nimport { createOnigurumaEngine } from 'shiki/engine/oniguruma';\nimport typescript from 'shiki/langs/typescript.mjs';\nimport tsx from 'shiki/langs/tsx.mjs';\nimport githubDark from 'shiki/themes/github-dark.mjs';\nimport githubLight from 'shiki/themes/github-light.mjs';\nimport { twillLanguages } from './index.js';\n\n/** Create once and reuse. This entry loads only TS/TSX and two themes. */\nexport function createTwillHighlighter() {\n  return createHighlighterCore({\n    langs: [...typescript, ...tsx, ...twillLanguages],\n    themes: [githubLight, githubDark],\n    engine: createOnigurumaEngine(import('shiki/wasm')),\n  });\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,yBAAyB;CACvC,OAAO,sBAAsB;EAC3B,OAAO;GAAC,GAAG;GAAY,GAAG;GAAK,GAAG;EAAc;EAChD,QAAQ,CAAC,aAAa,UAAU;EAChC,QAAQ,sBAAsB,OAAO,aAAa;CACpD,CAAC;AACH"}

package/dist/src-B8qil4uJ.js

@@ -0,0 +1,245 @@
+var twill_tmLanguage_default = {
+	name: "Twill ts",
+	scopeName: "source.twill.ts",
+	patterns: [
+		{ "include": "#implicit-member" },
+		{ "include": "#defer" },
+		{ "include": "#guard-binding" },
+		{ "include": "#guard" },
+		{ "include": "#switch-expression" },
+		{ "include": "#closure-header" },
+		{
+			"match": "(?<=\\})\\s*\\b([A-Za-z_$][\\w$]*)(\\s*:)(?=\\s*\\{)",
+			"captures": {
+				"1": { "name": "entity.name.function.twill" },
+				"2": { "name": "punctuation.separator.twill" }
+			}
+		},
+		{ "include": "source.ts" }
+	],
+	repository: {
+		"implicit-member": {
+			"match": "(?<![\\w$.)}\\]])(\\.)([A-Za-z_$][\\w$]*)",
+			"captures": {
+				"1": { "name": "punctuation.accessor.twill" },
+				"2": { "name": "variable.other.property.twill" }
+			}
+		},
+		"defer": {
+			"match": "(?<![\\w$.])\\bdefer\\b(?=(?:[^\\S\\r\\n]|/\\*[^\\r\\n]*?\\*/)*\\{)",
+			"name": "keyword.control.twill"
+		},
+		"guard": {
+			"match": "(?<![\\w$.])\\bguard\\b(?=\\s+(?:const\\b|[^\\s;=:]))",
+			"name": "keyword.control.twill"
+		},
+		"guard-binding": {
+			"name": "meta.guard.binding.twill",
+			"begin": "(?<![\\w$.])\\b(guard)\\s+(const)\\b",
+			"beginCaptures": {
+				"1": { "name": "keyword.control.twill" },
+				"2": { "name": "storage.type.ts" }
+			},
+			"end": "(?<![\\w$.])\\belse\\b(?=\\s*\\{)",
+			"endCaptures": { "0": { "name": "keyword.control.twill" } },
+			"patterns": [
+				{ "include": "source.ts#object-binding-pattern-const" },
+				{ "include": "source.ts#array-binding-pattern-const" },
+				{ "include": "source.ts" }
+			]
+		},
+		"switch-expression": {
+			"name": "meta.switch.expression.twill",
+			"begin": "(?<![\\w$.])(switch)\\b(?=\\s*\\()",
+			"beginCaptures": { "1": { "name": "keyword.control.twill" } },
+			"end": "\\}",
+			"endCaptures": { "0": { "name": "punctuation.section.block.end.twill" } },
+			"patterns": [
+				{ "include": "source.ts#comment" },
+				{
+					"begin": "\\(",
+					"end": "\\)",
+					"patterns": [{ "include": "source.ts#expression" }]
+				},
+				{
+					"begin": "\\{",
+					"end": "(?=\\})",
+					"patterns": [{
+						"begin": "(?<![\\w$.])(case|default)\\b",
+						"beginCaptures": { "1": { "name": "keyword.control.twill" } },
+						"end": "(?=:)",
+						"patterns": [{ "include": "source.ts#expression" }]
+					}, { "include": "source.ts#statements" }]
+				}
+			]
+		},
+		"closure-header": {
+			"begin": "(\\{)(?=\\s*(?:async\\s+)?(?:[A-Za-z_$][\\w$]*(?:\\s*,\\s*[A-Za-z_$][\\w$]*)*|\\((?:[^;()]|\\([^()]*\\))*\\)(?:\\s*:[^;{}]*?)?)\\s+in\\b)",
+			"beginCaptures": { "1": { "name": "punctuation.section.block.begin.twill" } },
+			"end": "\\}",
+			"endCaptures": { "0": { "name": "punctuation.section.block.end.twill" } },
+			"name": "meta.trailing.closure.twill",
+			"patterns": [{
+				"begin": "(?<=\\{)",
+				"end": "\\bin\\b",
+				"endCaptures": { "0": { "name": "keyword.control.twill" } },
+				"patterns": [
+					{ "include": "source.ts#comment" },
+					{
+						"match": "\\basync\\b",
+						"name": "storage.modifier.ts"
+					},
+					{ "include": "source.ts#function-parameters" },
+					{
+						"begin": ":",
+						"end": "(?=\\bin\\b)",
+						"patterns": [{ "include": "source.ts#type" }]
+					},
+					{ "include": "source.ts#parameter-name" }
+				]
+			}, { "include": "source.ts#statements" }]
+		}
+	},
+	injections: { "L:source.twill.ts -comment -string, L:source.twill.ts meta.template.expression -comment -(meta.template.expression string)": { "patterns": [
+		{ "include": "#implicit-member" },
+		{ "include": "#defer" },
+		{ "include": "#guard-binding" },
+		{ "include": "#guard" },
+		{ "include": "#switch-expression" },
+		{ "include": "#closure-header" }
+	] } }
+};
+var twillx_tmLanguage_default = {
+	name: "Twill tsx",
+	scopeName: "source.twill.tsx",
+	patterns: [
+		{ "include": "#implicit-member" },
+		{ "include": "#defer" },
+		{ "include": "#guard-binding" },
+		{ "include": "#guard" },
+		{ "include": "#switch-expression" },
+		{ "include": "#closure-header" },
+		{
+			"match": "(?<=\\})\\s*\\b([A-Za-z_$][\\w$]*)(\\s*:)(?=\\s*\\{)",
+			"captures": {
+				"1": { "name": "entity.name.function.twill" },
+				"2": { "name": "punctuation.separator.twill" }
+			}
+		},
+		{ "include": "source.tsx" }
+	],
+	repository: {
+		"implicit-member": {
+			"match": "(?<![\\w$.)}\\]])(\\.)([A-Za-z_$][\\w$]*)",
+			"captures": {
+				"1": { "name": "punctuation.accessor.twill" },
+				"2": { "name": "variable.other.property.twill" }
+			}
+		},
+		"defer": {
+			"match": "(?<![\\w$.])\\bdefer\\b(?=(?:[^\\S\\r\\n]|/\\*[^\\r\\n]*?\\*/)*\\{)",
+			"name": "keyword.control.twill"
+		},
+		"guard": {
+			"match": "(?<![\\w$.])\\bguard\\b(?=\\s+(?:const\\b|[^\\s;=:]))",
+			"name": "keyword.control.twill"
+		},
+		"guard-binding": {
+			"name": "meta.guard.binding.twill",
+			"begin": "(?<![\\w$.])\\b(guard)\\s+(const)\\b",
+			"beginCaptures": {
+				"1": { "name": "keyword.control.twill" },
+				"2": { "name": "storage.type.tsx" }
+			},
+			"end": "(?<![\\w$.])\\belse\\b(?=\\s*\\{)",
+			"endCaptures": { "0": { "name": "keyword.control.twill" } },
+			"patterns": [
+				{ "include": "source.tsx#object-binding-pattern-const" },
+				{ "include": "source.tsx#array-binding-pattern-const" },
+				{ "include": "source.tsx" }
+			]
+		},
+		"switch-expression": {
+			"name": "meta.switch.expression.twill",
+			"begin": "(?<![\\w$.])(switch)\\b(?=\\s*\\()",
+			"beginCaptures": { "1": { "name": "keyword.control.twill" } },
+			"end": "\\}",
+			"endCaptures": { "0": { "name": "punctuation.section.block.end.twill" } },
+			"patterns": [
+				{ "include": "source.tsx#comment" },
+				{
+					"begin": "\\(",
+					"end": "\\)",
+					"patterns": [{ "include": "source.tsx#expression" }]
+				},
+				{
+					"begin": "\\{",
+					"end": "(?=\\})",
+					"patterns": [{
+						"begin": "(?<![\\w$.])(case|default)\\b",
+						"beginCaptures": { "1": { "name": "keyword.control.twill" } },
+						"end": "(?=:)",
+						"patterns": [{ "include": "source.tsx#expression" }]
+					}, { "include": "source.tsx#statements" }]
+				}
+			]
+		},
+		"closure-header": {
+			"begin": "(\\{)(?=\\s*(?:async\\s+)?(?:[A-Za-z_$][\\w$]*(?:\\s*,\\s*[A-Za-z_$][\\w$]*)*|\\((?:[^;()]|\\([^()]*\\))*\\)(?:\\s*:[^;{}]*?)?)\\s+in\\b)",
+			"beginCaptures": { "1": { "name": "punctuation.section.block.begin.twill" } },
+			"end": "\\}",
+			"endCaptures": { "0": { "name": "punctuation.section.block.end.twill" } },
+			"name": "meta.trailing.closure.twill",
+			"patterns": [
+				{
+					"begin": "(?<=\\{)",
+					"end": "\\bin\\b",
+					"endCaptures": { "0": { "name": "keyword.control.twill" } },
+					"patterns": [
+						{ "include": "source.tsx#comment" },
+						{
+							"match": "\\basync\\b",
+							"name": "storage.modifier.tsx"
+						},
+						{ "include": "source.tsx#function-parameters" },
+						{
+							"begin": ":",
+							"end": "(?=\\bin\\b)",
+							"patterns": [{ "include": "source.tsx#type" }]
+						},
+						{ "include": "source.tsx#parameter-name" }
+					]
+				},
+				{ "include": "source.tsx#jsx-tag-without-attributes" },
+				{ "include": "source.tsx#jsx-tag" },
+				{ "include": "source.tsx#statements" }
+			]
+		}
+	},
+	injections: { "L:source.twill.tsx -comment -string, L:source.twill.tsx meta.template.expression -comment -(meta.template.expression string)": { "patterns": [
+		{ "include": "#implicit-member" },
+		{ "include": "#defer" },
+		{ "include": "#guard-binding" },
+		{ "include": "#guard" },
+		{ "include": "#switch-expression" },
+		{ "include": "#closure-header" }
+	] } }
+};
+//#endregion
+//#region src/index.ts
+/** Engine-independent TextMate grammars; load the TS/TSX base grammars too. */
+var twill = {
+	...twill_tmLanguage_default,
+	name: "twill",
+	aliases: ["Twill"]
+};
+var twillx = {
+	...twillx_tmLanguage_default,
+	name: "twillx",
+	aliases: ["TwillX"]
+};
+var twillLanguages = [twill, twillx];
+//#endregion
+export { twillLanguages as n, twillx as r, twill as t };
+
+//# sourceMappingURL=src-B8qil4uJ.js.map

package/dist/src-B8qil4uJ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-B8qil4uJ.js","names":["name","scopeName","patterns","repository","injections","ts","tsx"],"sources":["../grammars/twill.tmLanguage.json","../grammars/twillx.tmLanguage.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"Twill ts\",\n  \"scopeName\": \"source.twill.ts\",\n  \"patterns\": [\n    {\n      \"include\": \"#implicit-member\"\n    },\n    {\n      \"include\": \"#defer\"\n    },\n    {\n      \"include\": \"#guard-binding\"\n    },\n    {\n      \"include\": \"#guard\"\n    },\n    {\n      \"include\": \"#switch-expression\"\n    },\n    {\n      \"include\": \"#closure-header\"\n    },\n    {\n      \"match\": \"(?<=\\\\})\\\\s*\\\\b([A-Za-z_$][\\\\w$]*)(\\\\s*:)(?=\\\\s*\\\\{)\",\n      \"captures\": {\n        \"1\": {\n          \"name\": \"entity.name.function.twill\"\n        },\n        \"2\": {\n          \"name\": \"punctuation.separator.twill\"\n        }\n      }\n    },\n    {\n      \"include\": \"source.ts\"\n    }\n  ],\n  \"repository\": {\n    \"implicit-member\": {\n      \"match\": \"(?<![\\\\w$.)}\\\\]])(\\\\.)([A-Za-z_$][\\\\w$]*)\",\n      \"captures\": {\n        \"1\": {\n          \"name\": \"punctuation.accessor.twill\"\n        },\n        \"2\": {\n          \"name\": \"variable.other.property.twill\"\n        }\n      }\n    },\n    \"defer\": {\n      \"match\": \"(?<![\\\\w$.])\\\\bdefer\\\\b(?=(?:[^\\\\S\\\\r\\\\n]|/\\\\*[^\\\\r\\\\n]*?\\\\*/)*\\\\{)\",\n      \"name\": \"keyword.control.twill\"\n    },\n    \"guard\": {\n      \"match\": \"(?<![\\\\w$.])\\\\bguard\\\\b(?=\\\\s+(?:const\\\\b|[^\\\\s;=:]))\",\n      \"name\": \"keyword.control.twill\"\n    },\n    \"guard-binding\": {\n      \"name\": \"meta.guard.binding.twill\",\n      \"begin\": \"(?<![\\\\w$.])\\\\b(guard)\\\\s+(const)\\\\b\",\n      \"beginCaptures\": {\n        \"1\": {\n          \"name\": \"keyword.control.twill\"\n        },\n        \"2\": {\n          \"name\": \"storage.type.ts\"\n        }\n      },\n      \"end\": \"(?<![\\\\w$.])\\\\belse\\\\b(?=\\\\s*\\\\{)\",\n      \"endCaptures\": {\n        \"0\": {\n          \"name\": \"keyword.control.twill\"\n        }\n      },\n      \"patterns\": [\n        {\n          \"include\": \"source.ts#object-binding-pattern-const\"\n        },\n        {\n          \"include\": \"source.ts#array-binding-pattern-const\"\n        },\n        {\n          \"include\": \"source.ts\"\n        }\n      ]\n    },\n    \"switch-expression\": {\n      \"name\": \"meta.switch.expression.twill\",\n      \"begin\": \"(?<![\\\\w$.])(switch)\\\\b(?=\\\\s*\\\\()\",\n      \"beginCaptures\": {\n        \"1\": {\n          \"name\": \"keyword.control.twill\"\n        }\n      },\n      \"end\": \"\\\\}\",\n      \"endCaptures\": {\n        \"0\": {\n          \"name\": \"punctuation.section.block.end.twill\"\n        }\n      },\n      \"patterns\": [\n        {\n          \"include\": \"source.ts#comment\"\n        },\n        {\n          \"begin\": \"\\\\(\",\n          \"end\": \"\\\\)\",\n          \"patterns\": [\n            {\n              \"include\": \"source.ts#expression\"\n            }\n          ]\n        },\n        {\n          \"begin\": \"\\\\{\",\n          \"end\": \"(?=\\\\})\",\n          \"patterns\": [\n            {\n              \"begin\": \"(?<![\\\\w$.])(case|default)\\\\b\",\n              \"beginCaptures\": {\n                \"1\": {\n                  \"name\": \"keyword.control.twill\"\n                }\n              },\n              \"end\": \"(?=:)\",\n              \"patterns\": [\n                {\n                  \"include\": \"source.ts#expression\"\n                }\n              ]\n            },\n            {\n              \"include\": \"source.ts#statements\"\n            }\n          ]\n        }\n      ]\n    },\n    \"closure-header\": {\n      \"begin\": \"(\\\\{)(?=\\\\s*(?:async\\\\s+)?(?:[A-Za-z_$][\\\\w$]*(?:\\\\s*,\\\\s*[A-Za-z_$][\\\\w$]*)*|\\\\((?:[^;()]|\\\\([^()]*\\\\))*\\\\)(?:\\\\s*:[^;{}]*?)?)\\\\s+in\\\\b)\",\n      \"beginCaptures\": {\n        \"1\": {\n          \"name\": \"punctuation.section.block.begin.twill\"\n        }\n      },\n      \"end\": \"\\\\}\",\n      \"endCaptures\": {\n        \"0\": {\n          \"name\": \"punctuation.section.block.end.twill\"\n        }\n      },\n      \"name\": \"meta.trailing.closure.twill\",\n      \"patterns\": [\n        {\n          \"begin\": \"(?<=\\\\{)\",\n          \"end\": \"\\\\bin\\\\b\",\n          \"endCaptures\": {\n            \"0\": {\n              \"name\": \"keyword.control.twill\"\n            }\n          },\n          \"patterns\": [\n            {\n              \"include\": \"source.ts#comment\"\n            },\n            {\n              \"match\": \"\\\\basync\\\\b\",\n              \"name\": \"storage.modifier.ts\"\n            },\n            {\n              \"include\": \"source.ts#function-parameters\"\n            },\n            {\n              \"begin\": \":\",\n              \"end\": \"(?=\\\\bin\\\\b)\",\n              \"patterns\": [\n                {\n                  \"include\": \"source.ts#type\"\n                }\n              ]\n            },\n            {\n              \"include\": \"source.ts#parameter-name\"\n            }\n          ]\n        },\n        {\n          \"include\": \"source.ts#statements\"\n        }\n      ]\n    }\n  },\n  \"injections\": {\n    \"L:source.twill.ts -comment -string, L:source.twill.ts meta.template.expression -comment -(meta.template.expression string)\": {\n      \"patterns\": [\n        {\n          \"include\": \"#implicit-member\"\n        },\n        {\n          \"include\": \"#defer\"\n        },\n        {\n          \"include\": \"#guard-binding\"\n        },\n        {\n          \"include\": \"#guard\"\n        },\n        {\n          \"include\": \"#switch-expression\"\n        },\n        {\n          \"include\": \"#closure-header\"\n        }\n      ]\n    }\n  }\n}\n","{\n  \"name\": \"Twill tsx\",\n  \"scopeName\": \"source.twill.tsx\",\n  \"patterns\": [\n    {\n      \"include\": \"#implicit-member\"\n    },\n    {\n      \"include\": \"#defer\"\n    },\n    {\n      \"include\": \"#guard-binding\"\n    },\n    {\n      \"include\": \"#guard\"\n    },\n    {\n      \"include\": \"#switch-expression\"\n    },\n    {\n      \"include\": \"#closure-header\"\n    },\n    {\n      \"match\": \"(?<=\\\\})\\\\s*\\\\b([A-Za-z_$][\\\\w$]*)(\\\\s*:)(?=\\\\s*\\\\{)\",\n      \"captures\": {\n        \"1\": {\n          \"name\": \"entity.name.function.twill\"\n        },\n        \"2\": {\n          \"name\": \"punctuation.separator.twill\"\n        }\n      }\n    },\n    {\n      \"include\": \"source.tsx\"\n    }\n  ],\n  \"repository\": {\n    \"implicit-member\": {\n      \"match\": \"(?<![\\\\w$.)}\\\\]])(\\\\.)([A-Za-z_$][\\\\w$]*)\",\n      \"captures\": {\n        \"1\": {\n          \"name\": \"punctuation.accessor.twill\"\n        },\n        \"2\": {\n          \"name\": \"variable.other.property.twill\"\n        }\n      }\n    },\n    \"defer\": {\n      \"match\": \"(?<![\\\\w$.])\\\\bdefer\\\\b(?=(?:[^\\\\S\\\\r\\\\n]|/\\\\*[^\\\\r\\\\n]*?\\\\*/)*\\\\{)\",\n      \"name\": \"keyword.control.twill\"\n    },\n    \"guard\": {\n      \"match\": \"(?<![\\\\w$.])\\\\bguard\\\\b(?=\\\\s+(?:const\\\\b|[^\\\\s;=:]))\",\n      \"name\": \"keyword.control.twill\"\n    },\n    \"guard-binding\": {\n      \"name\": \"meta.guard.binding.twill\",\n      \"begin\": \"(?<![\\\\w$.])\\\\b(guard)\\\\s+(const)\\\\b\",\n      \"beginCaptures\": {\n        \"1\": {\n          \"name\": \"keyword.control.twill\"\n        },\n        \"2\": {\n          \"name\": \"storage.type.tsx\"\n        }\n      },\n      \"end\": \"(?<![\\\\w$.])\\\\belse\\\\b(?=\\\\s*\\\\{)\",\n      \"endCaptures\": {\n        \"0\": {\n          \"name\": \"keyword.control.twill\"\n        }\n      },\n      \"patterns\": [\n        {\n          \"include\": \"source.tsx#object-binding-pattern-const\"\n        },\n        {\n          \"include\": \"source.tsx#array-binding-pattern-const\"\n        },\n        {\n          \"include\": \"source.tsx\"\n        }\n      ]\n    },\n    \"switch-expression\": {\n      \"name\": \"meta.switch.expression.twill\",\n      \"begin\": \"(?<![\\\\w$.])(switch)\\\\b(?=\\\\s*\\\\()\",\n      \"beginCaptures\": {\n        \"1\": {\n          \"name\": \"keyword.control.twill\"\n        }\n      },\n      \"end\": \"\\\\}\",\n      \"endCaptures\": {\n        \"0\": {\n          \"name\": \"punctuation.section.block.end.twill\"\n        }\n      },\n      \"patterns\": [\n        {\n          \"include\": \"source.tsx#comment\"\n        },\n        {\n          \"begin\": \"\\\\(\",\n          \"end\": \"\\\\)\",\n          \"patterns\": [\n            {\n              \"include\": \"source.tsx#expression\"\n            }\n          ]\n        },\n        {\n          \"begin\": \"\\\\{\",\n          \"end\": \"(?=\\\\})\",\n          \"patterns\": [\n            {\n              \"begin\": \"(?<![\\\\w$.])(case|default)\\\\b\",\n              \"beginCaptures\": {\n                \"1\": {\n                  \"name\": \"keyword.control.twill\"\n                }\n              },\n              \"end\": \"(?=:)\",\n              \"patterns\": [\n                {\n                  \"include\": \"source.tsx#expression\"\n                }\n              ]\n            },\n            {\n              \"include\": \"source.tsx#statements\"\n            }\n          ]\n        }\n      ]\n    },\n    \"closure-header\": {\n      \"begin\": \"(\\\\{)(?=\\\\s*(?:async\\\\s+)?(?:[A-Za-z_$][\\\\w$]*(?:\\\\s*,\\\\s*[A-Za-z_$][\\\\w$]*)*|\\\\((?:[^;()]|\\\\([^()]*\\\\))*\\\\)(?:\\\\s*:[^;{}]*?)?)\\\\s+in\\\\b)\",\n      \"beginCaptures\": {\n        \"1\": {\n          \"name\": \"punctuation.section.block.begin.twill\"\n        }\n      },\n      \"end\": \"\\\\}\",\n      \"endCaptures\": {\n        \"0\": {\n          \"name\": \"punctuation.section.block.end.twill\"\n        }\n      },\n      \"name\": \"meta.trailing.closure.twill\",\n      \"patterns\": [\n        {\n          \"begin\": \"(?<=\\\\{)\",\n          \"end\": \"\\\\bin\\\\b\",\n          \"endCaptures\": {\n            \"0\": {\n              \"name\": \"keyword.control.twill\"\n            }\n          },\n          \"patterns\": [\n            {\n              \"include\": \"source.tsx#comment\"\n            },\n            {\n              \"match\": \"\\\\basync\\\\b\",\n              \"name\": \"storage.modifier.tsx\"\n            },\n            {\n              \"include\": \"source.tsx#function-parameters\"\n            },\n            {\n              \"begin\": \":\",\n              \"end\": \"(?=\\\\bin\\\\b)\",\n              \"patterns\": [\n                {\n                  \"include\": \"source.tsx#type\"\n                }\n              ]\n            },\n            {\n              \"include\": \"source.tsx#parameter-name\"\n            }\n          ]\n        },\n        {\n          \"include\": \"source.tsx#jsx-tag-without-attributes\"\n        },\n        {\n          \"include\": \"source.tsx#jsx-tag\"\n        },\n        {\n          \"include\": \"source.tsx#statements\"\n        }\n      ]\n    }\n  },\n  \"injections\": {\n    \"L:source.twill.tsx -comment -string, L:source.twill.tsx meta.template.expression -comment -(meta.template.expression string)\": {\n      \"patterns\": [\n        {\n          \"include\": \"#implicit-member\"\n        },\n        {\n          \"include\": \"#defer\"\n        },\n        {\n          \"include\": \"#guard-binding\"\n        },\n        {\n          \"include\": \"#guard\"\n        },\n        {\n          \"include\": \"#switch-expression\"\n        },\n        {\n          \"include\": \"#closure-header\"\n        }\n      ]\n    }\n  }\n}\n","import ts from '../grammars/twill.tmLanguage.json';\nimport tsx from '../grammars/twillx.tmLanguage.json';\n\n/** The TextMate rule fields used by Twill, independent of an engine's types. */\nexport interface TextMateRule {\n  name?: string;\n  include?: string;\n  match?: string;\n  begin?: string;\n  end?: string;\n  captures?: Record<string, TextMateRule>;\n  beginCaptures?: Record<string, TextMateRule>;\n  endCaptures?: Record<string, TextMateRule>;\n  patterns?: TextMateRule[];\n}\n\nexport interface TwillGrammar {\n  name: string;\n  aliases: string[];\n  scopeName: string;\n  patterns: TextMateRule[];\n  repository: Record<string, TextMateRule>;\n  injections: Record<string, TextMateRule>;\n}\n\n/** Engine-independent TextMate grammars; load the TS/TSX base grammars too. */\nexport const twill: TwillGrammar = { ...ts, name: 'twill', aliases: ['Twill'] };\nexport const twillx: TwillGrammar = { ...tsx, name: 'twillx', aliases: ['TwillX'] };\nexport const twillLanguages = [twill, twillx];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AE0BA,IAAa,QAAsB;CAAE,GAAGK;CAAI,MAAM;CAAS,SAAS,CAAC,OAAO;AAAE;AAC9E,IAAa,SAAuB;CAAE,GAAGC;CAAK,MAAM;CAAU,SAAS,CAAC,QAAQ;AAAE;AAClF,IAAa,iBAAiB,CAAC,OAAO,MAAM"}

package/grammars/twill.tmLanguage.json

@@ -0,0 +1,217 @@
+{
+  "name": "Twill ts",
+  "scopeName": "source.twill.ts",
+  "patterns": [
+    {
+      "include": "#implicit-member"
+    },
+    {
+      "include": "#defer"
+    },
+    {
+      "include": "#guard-binding"
+    },
+    {
+      "include": "#guard"
+    },
+    {
+      "include": "#switch-expression"
+    },
+    {
+      "include": "#closure-header"
+    },
+    {
+      "match": "(?<=\\})\\s*\\b([A-Za-z_$][\\w$]*)(\\s*:)(?=\\s*\\{)",
+      "captures": {
+        "1": {
+          "name": "entity.name.function.twill"
+        },
+        "2": {
+          "name": "punctuation.separator.twill"
+        }
+      }
+    },
+    {
+      "include": "source.ts"
+    }
+  ],
+  "repository": {
+    "implicit-member": {
+      "match": "(?<![\\w$.)}\\]])(\\.)([A-Za-z_$][\\w$]*)",
+      "captures": {
+        "1": {
+          "name": "punctuation.accessor.twill"
+        },
+        "2": {
+          "name": "variable.other.property.twill"
+        }
+      }
+    },
+    "defer": {
+      "match": "(?<![\\w$.])\\bdefer\\b(?=(?:[^\\S\\r\\n]|/\\*[^\\r\\n]*?\\*/)*\\{)",
+      "name": "keyword.control.twill"
+    },
+    "guard": {
+      "match": "(?<![\\w$.])\\bguard\\b(?=\\s+(?:const\\b|[^\\s;=:]))",
+      "name": "keyword.control.twill"
+    },
+    "guard-binding": {
+      "name": "meta.guard.binding.twill",
+      "begin": "(?<![\\w$.])\\b(guard)\\s+(const)\\b",
+      "beginCaptures": {
+        "1": {
+          "name": "keyword.control.twill"
+        },
+        "2": {
+          "name": "storage.type.ts"
+        }
+      },
+      "end": "(?<![\\w$.])\\belse\\b(?=\\s*\\{)",
+      "endCaptures": {
+        "0": {
+          "name": "keyword.control.twill"
+        }
+      },
+      "patterns": [
+        {
+          "include": "source.ts#object-binding-pattern-const"
+        },
+        {
+          "include": "source.ts#array-binding-pattern-const"
+        },
+        {
+          "include": "source.ts"
+        }
+      ]
+    },
+    "switch-expression": {
+      "name": "meta.switch.expression.twill",
+      "begin": "(?<![\\w$.])(switch)\\b(?=\\s*\\()",
+      "beginCaptures": {
+        "1": {
+          "name": "keyword.control.twill"
+        }
+      },
+      "end": "\\}",
+      "endCaptures": {
+        "0": {
+          "name": "punctuation.section.block.end.twill"
+        }
+      },
+      "patterns": [
+        {
+          "include": "source.ts#comment"
+        },
+        {
+          "begin": "\\(",
+          "end": "\\)",
+          "patterns": [
+            {
+              "include": "source.ts#expression"
+            }
+          ]
+        },
+        {
+          "begin": "\\{",
+          "end": "(?=\\})",
+          "patterns": [
+            {
+              "begin": "(?<![\\w$.])(case|default)\\b",
+              "beginCaptures": {
+                "1": {
+                  "name": "keyword.control.twill"
+                }
+              },
+              "end": "(?=:)",
+              "patterns": [
+                {
+                  "include": "source.ts#expression"
+                }
+              ]
+            },
+            {
+              "include": "source.ts#statements"
+            }
+          ]
+        }
+      ]
+    },
+    "closure-header": {
+      "begin": "(\\{)(?=\\s*(?:async\\s+)?(?:[A-Za-z_$][\\w$]*(?:\\s*,\\s*[A-Za-z_$][\\w$]*)*|\\((?:[^;()]|\\([^()]*\\))*\\)(?:\\s*:[^;{}]*?)?)\\s+in\\b)",
+      "beginCaptures": {
+        "1": {
+          "name": "punctuation.section.block.begin.twill"
+        }
+      },
+      "end": "\\}",
+      "endCaptures": {
+        "0": {
+          "name": "punctuation.section.block.end.twill"
+        }
+      },
+      "name": "meta.trailing.closure.twill",
+      "patterns": [
+        {
+          "begin": "(?<=\\{)",
+          "end": "\\bin\\b",
+          "endCaptures": {
+            "0": {
+              "name": "keyword.control.twill"
+            }
+          },
+          "patterns": [
+            {
+              "include": "source.ts#comment"
+            },
+            {
+              "match": "\\basync\\b",
+              "name": "storage.modifier.ts"
+            },
+            {
+              "include": "source.ts#function-parameters"
+            },
+            {
+              "begin": ":",
+              "end": "(?=\\bin\\b)",
+              "patterns": [
+                {
+                  "include": "source.ts#type"
+                }
+              ]
+            },
+            {
+              "include": "source.ts#parameter-name"
+            }
+          ]
+        },
+        {
+          "include": "source.ts#statements"
+        }
+      ]
+    }
+  },
+  "injections": {
+    "L:source.twill.ts -comment -string, L:source.twill.ts meta.template.expression -comment -(meta.template.expression string)": {
+      "patterns": [
+        {
+          "include": "#implicit-member"
+        },
+        {
+          "include": "#defer"
+        },
+        {
+          "include": "#guard-binding"
+        },
+        {
+          "include": "#guard"
+        },
+        {
+          "include": "#switch-expression"
+        },
+        {
+          "include": "#closure-header"
+        }
+      ]
+    }
+  }
+}

package/grammars/twillx.tmLanguage.json

@@ -0,0 +1,223 @@
+{
+  "name": "Twill tsx",
+  "scopeName": "source.twill.tsx",
+  "patterns": [
+    {
+      "include": "#implicit-member"
+    },
+    {
+      "include": "#defer"
+    },
+    {
+      "include": "#guard-binding"
+    },
+    {
+      "include": "#guard"
+    },
+    {
+      "include": "#switch-expression"
+    },
+    {
+      "include": "#closure-header"
+    },
+    {
+      "match": "(?<=\\})\\s*\\b([A-Za-z_$][\\w$]*)(\\s*:)(?=\\s*\\{)",
+      "captures": {
+        "1": {
+          "name": "entity.name.function.twill"
+        },
+        "2": {
+          "name": "punctuation.separator.twill"
+        }
+      }
+    },
+    {
+      "include": "source.tsx"
+    }
+  ],
+  "repository": {
+    "implicit-member": {
+      "match": "(?<![\\w$.)}\\]])(\\.)([A-Za-z_$][\\w$]*)",
+      "captures": {
+        "1": {
+          "name": "punctuation.accessor.twill"
+        },
+        "2": {
+          "name": "variable.other.property.twill"
+        }
+      }
+    },
+    "defer": {
+      "match": "(?<![\\w$.])\\bdefer\\b(?=(?:[^\\S\\r\\n]|/\\*[^\\r\\n]*?\\*/)*\\{)",
+      "name": "keyword.control.twill"
+    },
+    "guard": {
+      "match": "(?<![\\w$.])\\bguard\\b(?=\\s+(?:const\\b|[^\\s;=:]))",
+      "name": "keyword.control.twill"
+    },
+    "guard-binding": {
+      "name": "meta.guard.binding.twill",
+      "begin": "(?<![\\w$.])\\b(guard)\\s+(const)\\b",
+      "beginCaptures": {
+        "1": {
+          "name": "keyword.control.twill"
+        },
+        "2": {
+          "name": "storage.type.tsx"
+        }
+      },
+      "end": "(?<![\\w$.])\\belse\\b(?=\\s*\\{)",
+      "endCaptures": {
+        "0": {
+          "name": "keyword.control.twill"
+        }
+      },
+      "patterns": [
+        {
+          "include": "source.tsx#object-binding-pattern-const"
+        },
+        {
+          "include": "source.tsx#array-binding-pattern-const"
+        },
+        {
+          "include": "source.tsx"
+        }
+      ]
+    },
+    "switch-expression": {
+      "name": "meta.switch.expression.twill",
+      "begin": "(?<![\\w$.])(switch)\\b(?=\\s*\\()",
+      "beginCaptures": {
+        "1": {
+          "name": "keyword.control.twill"
+        }
+      },
+      "end": "\\}",
+      "endCaptures": {
+        "0": {
+          "name": "punctuation.section.block.end.twill"
+        }
+      },
+      "patterns": [
+        {
+          "include": "source.tsx#comment"
+        },
+        {
+          "begin": "\\(",
+          "end": "\\)",
+          "patterns": [
+            {
+              "include": "source.tsx#expression"
+            }
+          ]
+        },
+        {
+          "begin": "\\{",
+          "end": "(?=\\})",
+          "patterns": [
+            {
+              "begin": "(?<![\\w$.])(case|default)\\b",
+              "beginCaptures": {
+                "1": {
+                  "name": "keyword.control.twill"
+                }
+              },
+              "end": "(?=:)",
+              "patterns": [
+                {
+                  "include": "source.tsx#expression"
+                }
+              ]
+            },
+            {
+              "include": "source.tsx#statements"
+            }
+          ]
+        }
+      ]
+    },
+    "closure-header": {
+      "begin": "(\\{)(?=\\s*(?:async\\s+)?(?:[A-Za-z_$][\\w$]*(?:\\s*,\\s*[A-Za-z_$][\\w$]*)*|\\((?:[^;()]|\\([^()]*\\))*\\)(?:\\s*:[^;{}]*?)?)\\s+in\\b)",
+      "beginCaptures": {
+        "1": {
+          "name": "punctuation.section.block.begin.twill"
+        }
+      },
+      "end": "\\}",
+      "endCaptures": {
+        "0": {
+          "name": "punctuation.section.block.end.twill"
+        }
+      },
+      "name": "meta.trailing.closure.twill",
+      "patterns": [
+        {
+          "begin": "(?<=\\{)",
+          "end": "\\bin\\b",
+          "endCaptures": {
+            "0": {
+              "name": "keyword.control.twill"
+            }
+          },
+          "patterns": [
+            {
+              "include": "source.tsx#comment"
+            },
+            {
+              "match": "\\basync\\b",
+              "name": "storage.modifier.tsx"
+            },
+            {
+              "include": "source.tsx#function-parameters"
+            },
+            {
+              "begin": ":",
+              "end": "(?=\\bin\\b)",
+              "patterns": [
+                {
+                  "include": "source.tsx#type"
+                }
+              ]
+            },
+            {
+              "include": "source.tsx#parameter-name"
+            }
+          ]
+        },
+        {
+          "include": "source.tsx#jsx-tag-without-attributes"
+        },
+        {
+          "include": "source.tsx#jsx-tag"
+        },
+        {
+          "include": "source.tsx#statements"
+        }
+      ]
+    }
+  },
+  "injections": {
+    "L:source.twill.tsx -comment -string, L:source.twill.tsx meta.template.expression -comment -(meta.template.expression string)": {
+      "patterns": [
+        {
+          "include": "#implicit-member"
+        },
+        {
+          "include": "#defer"
+        },
+        {
+          "include": "#guard-binding"
+        },
+        {
+          "include": "#guard"
+        },
+        {
+          "include": "#switch-expression"
+        },
+        {
+          "include": "#closure-header"
+        }
+      ]
+    }
+  }
+}

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@swiftuijs/twill-highlight",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Portable Twill and TwillX TextMate grammars and browser-compatible Shiki highlighting.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swiftuijs/twill.git",
+    "directory": "packages/highlight"
+  },
+  "homepage": "https://swiftuijs.github.io/twill/",
+  "bugs": {
+    "url": "https://github.com/swiftuijs/twill/issues"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "grammars",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./shiki": {
+      "types": "./dist/shiki.d.ts",
+      "import": "./dist/shiki.js"
+    },
+    "./grammars/twill": "./grammars/twill.tmLanguage.json",
+    "./grammars/twillx": "./grammars/twillx.tmLanguage.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "shiki": "^2.5.0 || ^3.0.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "shiki": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "shiki": "^4.5.0",
+    "typescript": "5.9.3",
+    "vite": "^8.3.2",
+    "vite-plugin-dts": "^5.1.2",
+    "@types/node": "^26.6.4",
+    "vitest": "^5.0.3",
+    "@vitest/coverage-v8": "^5.0.3",
+    "@playwright/test": "^1.63.0"
+  },
+  "author": {
+    "name": "forth.ink",
+    "url": "https://forth.ink"
+  },
+  "keywords": [
+    "twill",
+    "shiki",
+    "syntax-highlighting",
+    "textmate",
+    "typescript"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test:unit": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:package": "node tests/consumer.mjs",
+    "test:browser": "playwright test"
+  }
 }