@ankhorage/zora 20.0.2 → 20.1.1

package/dist/features/tree-view/utils/toggleExpandedIds.js

@@ -0,0 +1,7 @@
+/*** Toggle one tree node id while preserving immutable expansion state. */
+export function toggleExpandedIds(expandedIds, id) {
+    return expandedIds.includes(id)
+        ? expandedIds.filter((expandedId) => expandedId !== id)
+        : [...expandedIds, id];
+}
+//# sourceMappingURL=toggleExpandedIds.js.map

package/dist/features/tree-view/utils/toggleExpandedIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleExpandedIds.js","sourceRoot":"","sources":["../../../../src/features/tree-view/utils/toggleExpandedIds.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAC/B,WAA2B,EAC3B,EAAO;IAEP,OAAO,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC;QACvD,CAAC,CAAC,CAAC,GAAG,WAAW,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["/*** Toggle one tree node id while preserving immutable expansion state. */\nexport function toggleExpandedIds<TId extends string>(\n  expandedIds: readonly TId[],\n  id: TId,\n): readonly TId[] {\n  return expandedIds.includes(id)\n    ? expandedIds.filter((expandedId) => expandedId !== id)\n    : [...expandedIds, id];\n}\n"]}

package/dist/features/web-component-artifact/adapters/outbound/node/createNodeWebComponentArtifactFileSystem.d.ts

@@ -0,0 +1,4 @@
+import type { WebComponentArtifactFileSystemPort } from '../../../application/ports/outbound/WebComponentArtifactFileSystemPort';
+/*** Create the Node filesystem adapter used by ZORA web-component materialization. */
+export declare function createNodeWebComponentArtifactFileSystem(): WebComponentArtifactFileSystemPort;
+//# sourceMappingURL=createNodeWebComponentArtifactFileSystem.d.ts.map

package/dist/features/web-component-artifact/adapters/outbound/node/createNodeWebComponentArtifactFileSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNodeWebComponentArtifactFileSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/features/web-component-artifact/adapters/outbound/node/createNodeWebComponentArtifactFileSystem.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,wEAAwE,CAAC;AAEjI,sFAAsF;AACtF,wBAAgB,wCAAwC,IAAI,kCAAkC,CAe7F"}

package/dist/features/web-component-artifact/adapters/outbound/node/createNodeWebComponentArtifactFileSystem.js

@@ -0,0 +1,20 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/*** Create the Node filesystem adapter used by ZORA web-component materialization. */
+export function createNodeWebComponentArtifactFileSystem() {
+    return {
+        joinPath(...parts) {
+            return join(...parts);
+        },
+        async ensureDirectoryAsync(path) {
+            await mkdir(path, { recursive: true });
+        },
+        async readTextFileAsync(path) {
+            return await readFile(path, 'utf8');
+        },
+        async writeTextFileAsync(path, content) {
+            await writeFile(path, content, 'utf8');
+        },
+    };
+}
+//# sourceMappingURL=createNodeWebComponentArtifactFileSystem.js.map

package/dist/features/web-component-artifact/adapters/outbound/node/createNodeWebComponentArtifactFileSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNodeWebComponentArtifactFileSystem.js","sourceRoot":"","sources":["../../../../../../src/features/web-component-artifact/adapters/outbound/node/createNodeWebComponentArtifactFileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,sFAAsF;AACtF,MAAM,UAAU,wCAAwC;IACtD,OAAO;QACL,QAAQ,CAAC,GAAG,KAAK;YACf,OAAO,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,oBAAoB,CAAC,IAAI;YAC7B,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,iBAAiB,CAAC,IAAI;YAC1B,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO;YACpC,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport type { WebComponentArtifactFileSystemPort } from '../../../application/ports/outbound/WebComponentArtifactFileSystemPort';\n\n/*** Create the Node filesystem adapter used by ZORA web-component materialization. */\nexport function createNodeWebComponentArtifactFileSystem(): WebComponentArtifactFileSystemPort {\n  return {\n    joinPath(...parts) {\n      return join(...parts);\n    },\n    async ensureDirectoryAsync(path) {\n      await mkdir(path, { recursive: true });\n    },\n    async readTextFileAsync(path) {\n      return await readFile(path, 'utf8');\n    },\n    async writeTextFileAsync(path, content) {\n      await writeFile(path, content, 'utf8');\n    },\n  };\n}\n"]}

package/dist/features/web-component-artifact/application/ports/outbound/WebComponentArtifactFileSystemPort.d.ts

@@ -0,0 +1,7 @@
+export interface WebComponentArtifactFileSystemPort {
+    joinPath(...parts: readonly string[]): string;
+    ensureDirectoryAsync(path: string): Promise<void>;
+    readTextFileAsync(path: string): Promise<string>;
+    writeTextFileAsync(path: string, content: string): Promise<void>;
+}
+//# sourceMappingURL=WebComponentArtifactFileSystemPort.d.ts.map

package/dist/features/web-component-artifact/application/ports/outbound/WebComponentArtifactFileSystemPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebComponentArtifactFileSystemPort.d.ts","sourceRoot":"","sources":["../../../../../../src/features/web-component-artifact/application/ports/outbound/WebComponentArtifactFileSystemPort.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC;IAC9C,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE"}

package/dist/features/web-component-artifact/application/ports/outbound/WebComponentArtifactFileSystemPort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WebComponentArtifactFileSystemPort.js.map

package/dist/features/web-component-artifact/application/ports/outbound/WebComponentArtifactFileSystemPort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebComponentArtifactFileSystemPort.js","sourceRoot":"","sources":["../../../../../../src/features/web-component-artifact/application/ports/outbound/WebComponentArtifactFileSystemPort.ts"],"names":[],"mappings":"","sourcesContent":["export interface WebComponentArtifactFileSystemPort {\n  joinPath(...parts: readonly string[]): string;\n  ensureDirectoryAsync(path: string): Promise<void>;\n  readTextFileAsync(path: string): Promise<string>;\n  writeTextFileAsync(path: string, content: string): Promise<void>;\n}\n"]}

package/dist/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.d.ts

@@ -0,0 +1,16 @@
+import type { WebComponentArtifactFileSystemPort } from '../ports/outbound/WebComponentArtifactFileSystemPort';
+export interface MaterializeWebComponentArtifactInput {
+    readonly component: string;
+    readonly outputDirectory: string;
+    readonly packageRoot: string;
+    readonly packageVersion: string;
+}
+export interface MaterializeWebComponentArtifactResult {
+    readonly component: string;
+    readonly createdFiles: readonly string[];
+    readonly outputDirectory: string;
+    readonly platform: 'web';
+}
+/*** Materialize one replaceable web-only component artifact from the published ZORA build. */
+export declare function materializeWebComponentArtifactAsync(input: MaterializeWebComponentArtifactInput, fileSystem: WebComponentArtifactFileSystemPort): Promise<MaterializeWebComponentArtifactResult>;
+//# sourceMappingURL=materializeWebComponentArtifactAsync.d.ts.map

package/dist/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeWebComponentArtifactAsync.d.ts","sourceRoot":"","sources":["../../../../../src/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,sDAAsD,CAAC;AAE/G,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B;AAED,8FAA8F;AAC9F,wBAAsB,oCAAoC,CACxD,KAAK,EAAE,oCAAoC,EAC3C,UAAU,EAAE,kCAAkC,GAC7C,OAAO,CAAC,qCAAqC,CAAC,CAwChD"}

package/dist/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.js

@@ -0,0 +1,42 @@
+/*** Materialize one replaceable web-only component artifact from the published ZORA build. */
+export async function materializeWebComponentArtifactAsync(input, fileSystem) {
+    const artifact = resolveWebArtifact(input.component);
+    const sourceDirectory = fileSystem.joinPath(input.packageRoot, 'web-dist', artifact.directory);
+    await fileSystem.ensureDirectoryAsync(input.outputDirectory);
+    const createdFiles = await Promise.all(artifact.files.map(async (fileName) => {
+        const sourcePath = fileSystem.joinPath(sourceDirectory, fileName);
+        const targetPath = fileSystem.joinPath(input.outputDirectory, fileName);
+        const source = await fileSystem.readTextFileAsync(sourcePath);
+        await fileSystem.writeTextFileAsync(targetPath, createGeneratedSource(input.packageVersion, source));
+        return targetPath;
+    }));
+    const metadataPath = fileSystem.joinPath(input.outputDirectory, 'zora-artifact.json');
+    await fileSystem.writeTextFileAsync(metadataPath, `${JSON.stringify({
+        generated: true,
+        owner: '@ankhorage/zora',
+        version: input.packageVersion,
+        component: input.component,
+        platform: 'web',
+    }, null, 2)}\n`);
+    return {
+        component: input.component,
+        createdFiles: [...createdFiles, metadataPath],
+        outputDirectory: input.outputDirectory,
+        platform: 'web',
+    };
+}
+/*** Resolve the canonical packaged web artifact for a requested component. */
+function resolveWebArtifact(component) {
+    if (component === 'tree-view') {
+        return {
+            directory: 'tree-view',
+            files: ['TreeView.js', 'TreeView.d.ts'],
+        };
+    }
+    throw new Error(`Unsupported ZORA web component: ${component}`);
+}
+/*** Add a generated-file marker without changing the compiled artifact semantics. */
+function createGeneratedSource(packageVersion, source) {
+    return `// Generated by @ankhorage/zora v${packageVersion}. Do not edit manually.\n${source}`;
+}
+//# sourceMappingURL=materializeWebComponentArtifactAsync.js.map

package/dist/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeWebComponentArtifactAsync.js","sourceRoot":"","sources":["../../../../../src/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.ts"],"names":[],"mappings":"AAgBA,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,KAA2C,EAC3C,UAA8C;IAE9C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/F,MAAM,UAAU,CAAC,oBAAoB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAE7D,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACpC,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9D,MAAM,UAAU,CAAC,kBAAkB,CACjC,UAAU,EACV,qBAAqB,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,CACpD,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;IACtF,MAAM,UAAU,CAAC,kBAAkB,CACjC,YAAY,EACZ,GAAG,IAAI,CAAC,SAAS,CACf;QACE,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE,KAAK,CAAC,cAAc;QAC7B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK;KAChB,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CACN,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,CAAC,GAAG,YAAY,EAAE,YAAY,CAAC;QAC7C,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAOD,8EAA8E;AAC9E,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO;YACL,SAAS,EAAE,WAAW;YACtB,KAAK,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;SACxC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,qFAAqF;AACrF,SAAS,qBAAqB,CAAC,cAAsB,EAAE,MAAc;IACnE,OAAO,oCAAoC,cAAc,4BAA4B,MAAM,EAAE,CAAC;AAChG,CAAC","sourcesContent":["import type { WebComponentArtifactFileSystemPort } from '../ports/outbound/WebComponentArtifactFileSystemPort';\n\nexport interface MaterializeWebComponentArtifactInput {\n  readonly component: string;\n  readonly outputDirectory: string;\n  readonly packageRoot: string;\n  readonly packageVersion: string;\n}\n\nexport interface MaterializeWebComponentArtifactResult {\n  readonly component: string;\n  readonly createdFiles: readonly string[];\n  readonly outputDirectory: string;\n  readonly platform: 'web';\n}\n\n/*** Materialize one replaceable web-only component artifact from the published ZORA build. */\nexport async function materializeWebComponentArtifactAsync(\n  input: MaterializeWebComponentArtifactInput,\n  fileSystem: WebComponentArtifactFileSystemPort,\n): Promise<MaterializeWebComponentArtifactResult> {\n  const artifact = resolveWebArtifact(input.component);\n  const sourceDirectory = fileSystem.joinPath(input.packageRoot, 'web-dist', artifact.directory);\n  await fileSystem.ensureDirectoryAsync(input.outputDirectory);\n\n  const createdFiles = await Promise.all(\n    artifact.files.map(async (fileName) => {\n      const sourcePath = fileSystem.joinPath(sourceDirectory, fileName);\n      const targetPath = fileSystem.joinPath(input.outputDirectory, fileName);\n      const source = await fileSystem.readTextFileAsync(sourcePath);\n      await fileSystem.writeTextFileAsync(\n        targetPath,\n        createGeneratedSource(input.packageVersion, source),\n      );\n      return targetPath;\n    }),\n  );\n\n  const metadataPath = fileSystem.joinPath(input.outputDirectory, 'zora-artifact.json');\n  await fileSystem.writeTextFileAsync(\n    metadataPath,\n    `${JSON.stringify(\n      {\n        generated: true,\n        owner: '@ankhorage/zora',\n        version: input.packageVersion,\n        component: input.component,\n        platform: 'web',\n      },\n      null,\n      2,\n    )}\\n`,\n  );\n\n  return {\n    component: input.component,\n    createdFiles: [...createdFiles, metadataPath],\n    outputDirectory: input.outputDirectory,\n    platform: 'web',\n  };\n}\n\ninterface WebArtifactDefinition {\n  readonly directory: string;\n  readonly files: readonly string[];\n}\n\n/*** Resolve the canonical packaged web artifact for a requested component. */\nfunction resolveWebArtifact(component: string): WebArtifactDefinition {\n  if (component === 'tree-view') {\n    return {\n      directory: 'tree-view',\n      files: ['TreeView.js', 'TreeView.d.ts'],\n    };\n  }\n\n  throw new Error(`Unsupported ZORA web component: ${component}`);\n}\n\n/*** Add a generated-file marker without changing the compiled artifact semantics. */\nfunction createGeneratedSource(packageVersion: string, source: string): string {\n  return `// Generated by @ankhorage/zora v${packageVersion}. Do not edit manually.\\n${source}`;\n}\n"]}

package/dist/features/web-component-artifact/composition/materializeWebComponentArtifactWithNodeAsync.d.ts

@@ -0,0 +1,4 @@
+import { type MaterializeWebComponentArtifactInput, type MaterializeWebComponentArtifactResult } from '../application/use-cases/materializeWebComponentArtifactAsync';
+/*** Compose the Node filesystem adapter with the web-component materialization use case. */
+export declare function materializeWebComponentArtifactWithNodeAsync(input: MaterializeWebComponentArtifactInput): Promise<MaterializeWebComponentArtifactResult>;
+//# sourceMappingURL=materializeWebComponentArtifactWithNodeAsync.d.ts.map

package/dist/features/web-component-artifact/composition/materializeWebComponentArtifactWithNodeAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeWebComponentArtifactWithNodeAsync.d.ts","sourceRoot":"","sources":["../../../../src/features/web-component-artifact/composition/materializeWebComponentArtifactWithNodeAsync.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oCAAoC,EACzC,KAAK,qCAAqC,EAC3C,MAAM,+DAA+D,CAAC;AAEvE,4FAA4F;AAC5F,wBAAsB,4CAA4C,CAChE,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,qCAAqC,CAAC,CAKhD"}

package/dist/features/web-component-artifact/composition/materializeWebComponentArtifactWithNodeAsync.js

@@ -0,0 +1,7 @@
+import { createNodeWebComponentArtifactFileSystem } from '../adapters/outbound/node/createNodeWebComponentArtifactFileSystem';
+import { materializeWebComponentArtifactAsync, } from '../application/use-cases/materializeWebComponentArtifactAsync';
+/*** Compose the Node filesystem adapter with the web-component materialization use case. */
+export async function materializeWebComponentArtifactWithNodeAsync(input) {
+    return await materializeWebComponentArtifactAsync(input, createNodeWebComponentArtifactFileSystem());
+}
+//# sourceMappingURL=materializeWebComponentArtifactWithNodeAsync.js.map

package/dist/features/web-component-artifact/composition/materializeWebComponentArtifactWithNodeAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeWebComponentArtifactWithNodeAsync.js","sourceRoot":"","sources":["../../../../src/features/web-component-artifact/composition/materializeWebComponentArtifactWithNodeAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,MAAM,oEAAoE,CAAC;AAC9H,OAAO,EACL,oCAAoC,GAGrC,MAAM,+DAA+D,CAAC;AAEvE,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,4CAA4C,CAChE,KAA2C;IAE3C,OAAO,MAAM,oCAAoC,CAC/C,KAAK,EACL,wCAAwC,EAAE,CAC3C,CAAC;AACJ,CAAC","sourcesContent":["import { createNodeWebComponentArtifactFileSystem } from '../adapters/outbound/node/createNodeWebComponentArtifactFileSystem';\nimport {\n  materializeWebComponentArtifactAsync,\n  type MaterializeWebComponentArtifactInput,\n  type MaterializeWebComponentArtifactResult,\n} from '../application/use-cases/materializeWebComponentArtifactAsync';\n\n/*** Compose the Node filesystem adapter with the web-component materialization use case. */\nexport async function materializeWebComponentArtifactWithNodeAsync(\n  input: MaterializeWebComponentArtifactInput,\n): Promise<MaterializeWebComponentArtifactResult> {\n  return await materializeWebComponentArtifactAsync(\n    input,\n    createNodeWebComponentArtifactFileSystem(),\n  );\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "20.0.2",
+  "version": "20.1.1",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -49,6 +49,7 @@
   },
   "files": [
     "dist",
+    "web-dist",
     "src",
     "package.json",
     "README.md",
@@ -92,13 +93,18 @@
       "import": "./dist/features/theme/public.js",
       "default": "./dist/features/theme/public.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js",
+      "default": "./dist/cli/index.js"
+    }
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "rm -rf dist tsconfig.tsbuildinfo && bun x tsc -p tsconfig.json",
+    "build": "rm -rf dist web-dist tsconfig.tsbuildinfo && bun x tsc -p tsconfig.json && bun scripts/build-web-components.ts",
     "changeset": "ankhorage-changeset",
     "changeset:status": "ankhorage-changeset status --since=origin/main",
     "docs": "paradox",
@@ -115,7 +121,7 @@
     "version-packages": "ankhorage-changeset version"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^1.13.0",
+    "@ankhorage/devtools": "^1.17.0",
     "@ankhorage/paradox": "^0.1.26",
     "@react-native-vector-icons/fontawesome": "^13.1.3",
     "@react-native-vector-icons/fontawesome5": "^13.1.3",
@@ -138,5 +144,12 @@
     "react-native-worklets": "0.10.1",
     "typescript": "~6.0.3"
   },
-  "packageManager": "bun@1.4.2"
+  "packageManager": "bun@1.4.2",
+  "ankh": {
+    "category": "zora",
+    "provider": "./dist/cli/index.js",
+    "capabilities": [
+      "zora.create"
+    ]
+  }
 }

package/src/cli/commands/create.ts

@@ -0,0 +1,96 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { materializeWebComponentArtifactWithNodeAsync } from '../../features/web-component-artifact/composition/materializeWebComponentArtifactWithNodeAsync';
+
+interface ZoraCreateCommandRequest {
+  readonly argv: readonly string[];
+  readonly context: {
+    readonly cwd: string;
+    writeStderr(text: string): void;
+    writeStdout(text: string): void;
+  };
+}
+
+/*** Materialize a canonical ZORA component for a platform-specific consumer. */
+export async function create(
+  request: ZoraCreateCommandRequest,
+): Promise<{ readonly exitCode: number }> {
+  try {
+    const options = parseCreateArguments(request.argv);
+    const packageJsonPath = resolve(
+      dirname(fileURLToPath(import.meta.url)),
+      '../../../package.json',
+    );
+    const packageRoot = dirname(packageJsonPath);
+    const packageVersion = await readPackageVersionAsync(packageJsonPath);
+    const outputDirectory =
+      options.outputDirectory === undefined
+        ? resolve(request.context.cwd, 'src', 'generated', 'zora', options.component)
+        : resolve(request.context.cwd, options.outputDirectory);
+
+    const result = await materializeWebComponentArtifactWithNodeAsync({
+      component: options.component,
+      outputDirectory,
+      packageRoot,
+      packageVersion,
+    });
+
+    request.context.writeStdout(
+      [
+        `Created ZORA ${result.component} for ${result.platform} at ${result.outputDirectory}`,
+        ...result.createdFiles.map((filePath) => `  ${filePath}`),
+        '',
+      ].join('\n'),
+    );
+    return { exitCode: 0 };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    request.context.writeStderr(`ZORA create failed: ${message}\n`);
+    return { exitCode: 1 };
+  }
+}
+
+interface CreateOptions {
+  readonly component: string;
+  readonly outputDirectory?: string;
+}
+
+/*** Parse the intentionally small first web-materialization command surface. */
+function parseCreateArguments(argv: readonly string[]): CreateOptions {
+  const [component, platformFlag, outputFlag, outputDirectory] = argv;
+  const hasDefaultOutput = argv.length === 2 && platformFlag === '--web';
+  const hasCustomOutput =
+    argv.length === 4 &&
+    platformFlag === '--web' &&
+    outputFlag === '--out' &&
+    outputDirectory !== undefined &&
+    outputDirectory.trim() !== '';
+
+  if (
+    component === undefined ||
+    component.trim() === '' ||
+    (!hasDefaultOutput && !hasCustomOutput)
+  ) {
+    throw new Error('Usage: ankh zora create <component> --web [--out <directory>]');
+  }
+
+  return {
+    component,
+    ...(hasCustomOutput ? { outputDirectory } : {}),
+  };
+}
+
+/*** Read the installed package version used to stamp generated artifacts. */
+async function readPackageVersionAsync(packageJsonPath: string): Promise<string> {
+  const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8')) as {
+    readonly version?: unknown;
+  };
+
+  if (typeof packageJson.version !== 'string' || packageJson.version.trim() === '') {
+    throw new Error('ZORA package.json must define a non-empty version.');
+  }
+
+  return packageJson.version;
+}

package/src/cli/index.test.ts

@@ -0,0 +1,18 @@
+import { expect, test } from 'bun:test';
+
+import provider from './index';
+
+test('publishes the ZORA create command through the Ankh provider', () => {
+  expect(provider.id).toBe('@ankhorage/zora');
+  expect(provider.category).toBe('zora');
+  expect(provider.capabilities).toEqual(['zora.create']);
+  expect(provider.commands).toEqual([
+    {
+      path: ['create'],
+      capability: 'zora.create',
+      summary: 'Materialize a canonical ZORA component for a target platform.',
+    },
+  ]);
+  expect(provider.handlers).toHaveLength(1);
+  expect(provider.handlers[0]?.path).toEqual(['create']);
+});

package/src/cli/index.ts

@@ -0,0 +1,50 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import type { AnkhCapabilityId, AnkhCommandProviderManifest } from '@ankhorage/contracts/cli';
+
+import { create } from './commands/create';
+
+const CREATE_CAPABILITY = 'zora.create' satisfies AnkhCapabilityId;
+const CREATE_COMMAND = {
+  path: ['create'],
+  capability: CREATE_CAPABILITY,
+  summary: 'Materialize a canonical ZORA component for a target platform.',
+} as const;
+
+interface ZoraRuntimeProvider extends AnkhCommandProviderManifest {
+  readonly handlers: readonly {
+    readonly path: readonly string[];
+    readonly handler: typeof create;
+  }[];
+}
+
+const provider = {
+  id: '@ankhorage/zora',
+  category: 'zora',
+  version: readPackageVersion(),
+  capabilities: [CREATE_CAPABILITY],
+  commands: [CREATE_COMMAND],
+  handlers: [
+    {
+      path: CREATE_COMMAND.path,
+      handler: create,
+    },
+  ],
+} satisfies ZoraRuntimeProvider;
+
+export default provider;
+
+/*** Read the installed ZORA version for the Ankh provider manifest. */
+function readPackageVersion(): string {
+  const packageJson = JSON.parse(
+    readFileSync(resolve(dirname(fileURLToPath(import.meta.url)), '../../package.json'), 'utf8'),
+  ) as { readonly version?: unknown };
+
+  if (typeof packageJson.version !== 'string' || packageJson.version.trim() === '') {
+    throw new Error('ZORA package.json must define a non-empty version.');
+  }
+
+  return packageJson.version;
+}

package/src/features/tree-view/adapters/inbound/TreeItem.tsx

@@ -3,6 +3,7 @@ import React from 'react';
 import type { ZoraBaseProps } from '../../../../types/base';
 import type { TreeItemNode, TreeItemRenderProps } from '../../../../types/tree-view';
 import { IconButton } from '../../../button/public';
+import { Icon } from '../../../icon/public';
 import { View } from '../../../layout/public';
 import { ListItem } from '../../../list/public';
 import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
@@ -17,6 +18,7 @@ interface TreeItemProps<TId extends string = string> extends ZoraBaseProps {
   renderItem?: (props: TreeItemRenderProps<TId>) => React.ReactNode;
 }
 
+/*** Render one recursive themed tree row and keep row selection separate from expansion controls. */
 function TreeItemInner<TId extends string = string>({
   themeId: _themeId,
   mode: _mode,
@@ -45,28 +47,36 @@ function TreeItemInner<TId extends string = string>({
       });
     }
 
-    return (
-      <ListItem
-        title={node.label}
-        action={
-          <View direction="row" gap="xs" align="center">
-            {node.actions}
-            {hasChildren ? (
-              <IconButton
-                icon={{ name: isExpanded ? 'chevron-down-outline' : 'chevron-forward-outline' }}
-                interactionPolicy={interactionPolicy}
-                label={isExpanded ? 'Collapse' : 'Expand'}
-                onPress={() => onToggleExpand(node.id)}
-                size="s"
-                variant="ghost"
-              />
-            ) : null}
-          </View>
-        }
-        meta={node.meta}
-        disabled={node.disabled}
-        selected={isSelected}
-      />
+    const trailing =
+      node.actions !== undefined || hasChildren ? (
+        <View direction="row" gap="xs" align="center">
+          {node.actions}
+          {hasChildren ? (
+            <IconButton
+              icon={{ name: isExpanded ? 'chevron-down-outline' : 'chevron-forward-outline' }}
+              interactionPolicy={interactionPolicy}
+              label={isExpanded ? 'Collapse' : 'Expand'}
+              onPress={() => onToggleExpand(node.id)}
+              size="s"
+              variant="ghost"
+            />
+          ) : null}
+        </View>
+      ) : undefined;
+
+    const listItemProps = {
+      title: node.label,
+      leading: node.icon === undefined ? undefined : <Icon {...node.icon} size="s" />,
+      meta: node.meta,
+      disabled: node.disabled,
+      selected: isSelected,
+      trailing,
+    };
+
+    return onSelect === undefined ? (
+      <ListItem {...listItemProps} />
+    ) : (
+      <ListItem {...listItemProps} onPress={() => onSelect(node.id)} />
     );
   };
 
@@ -94,9 +104,5 @@ function TreeItemInner<TId extends string = string>({
   );
 }
 
-/***
- * Single tree node row used within `TreeView`.
- *
- 
- */
+/*** Single tree node row used within `TreeView`. */
 export const TreeItem = withZoraThemeScope(TreeItemInner);

package/src/features/tree-view/adapters/inbound/TreeView.tsx

@@ -3,8 +3,10 @@ import React from 'react';
 import type { TreeViewProps } from '../../../../types/tree-view';
 import { View } from '../../../layout/public';
 import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { toggleExpandedIds } from '../../utils/toggleExpandedIds';
 import { TreeItem } from './TreeItem';
 
+/*** Render the themed TreeView while supporting controlled or internal expansion state. */
 function TreeViewInner<TId extends string = string>({
   themeId: _themeId,
   mode: _mode,
@@ -27,13 +29,12 @@ function TreeViewInner<TId extends string = string>({
 
   const handleToggleExpand = (id: TId) => {
     if (interactionPolicy === 'passive') return;
-    const isExpanded = expandedIds.includes(id);
-    const newIds = isExpanded ? expandedIds.filter((eid) => eid !== id) : [...expandedIds, id];
+    const nextExpandedIds = toggleExpandedIds(expandedIds, id);
 
     if (!isControlled) {
-      setInternalExpandedIds(newIds);
+      setInternalExpandedIds(nextExpandedIds);
     }
-    onExpandedChange?.(newIds);
+    onExpandedChange?.(nextExpandedIds);
   };
 
   return (
@@ -55,9 +56,5 @@ function TreeViewInner<TId extends string = string>({
   );
 }
 
-/***
- * Tree view pattern for hierarchical navigation and expandable lists.
- *
- 
- */
+/*** Tree view pattern for hierarchical navigation and expandable lists. */
 export const TreeView = withZoraThemeScope(TreeViewInner);