@ankhorage/devtools 2.0.11 → 2.0.12

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/devtools
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v2.0.11](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v2.0.12](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 
 Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects
 

package/dist/tools/skills/assets/zora-designer/SKILL.md

@@ -46,8 +46,9 @@ types, ZORA elements, events, recipes, and version provenance. Never copy owner
 schemas, token inventories, color algorithms, action types, or manifest implementations into this
 skill.
 
-The inspection composes metadata-only descriptors from every installed `@ankhorage/zora-*` plugin;
-use those plugin elements exactly like ZORA core elements and keep their package provenance.
+The inspection reads the canonical component and authoring metadata directly from released
+`@ankhorage/zora`. Chess, Game, and Tabletop are core ZORA capabilities; do not discover or load
+standalone `@ankhorage/zora-*` packages.
 
 For supplied-screen reconstruction, continue through `recognize` and treat the local analyzer's
 `ScreenSpec`, visual graph, confidence, alternatives, and unresolved diagnostics as the structural

package/dist/tools/skills/assets/zora-designer/references/screen-analysis.md

@@ -16,9 +16,9 @@ bun .agents/skills/zora-designer/scripts/owner-api.ts inspect
 bun .agents/skills/zora-designer/scripts/analyze-screen.ts screen-analysis-input.json
 ```
 
-The analyzer uses the current composed ZORA metadata, including every installed
-`@ankhorage/zora-*` plugin, and delegates image processing to released
-`@ankhorage/utility/image`:
+The analyzer uses the current canonical core ZORA metadata from released `@ankhorage/zora` and
+delegates image processing to released `@ankhorage/utility/image`. It does not discover or compose
+standalone ZORA plugin packages:
 
 ```text
 supplied image
@@ -88,7 +88,7 @@ The analyzer returns:
 - aggregate confidence;
 - ranked component candidates by region;
 - unresolved diagnostics;
-- the exact composed component names and owner/plugin version provenance used for the pass.
+- the exact core component names and owner version provenance used for the pass.
 
 Use the generated `ScreenSpec` as the structural baseline. Do not discard a high-confidence exact
 metadata match merely because another component looks visually similar.

package/dist/tools/skills/assets/zora-designer/references/workflow.md

@@ -18,8 +18,8 @@ navigator types, ZORA elements, or events. Resolve explicit user input before pr
 existing brief values, category recommendations, and global defaults. Record the origin of every
 resolved decision.
 
-Installed `@ankhorage/zora-*` packages contribute their metadata-only plugin descriptors to this
-same composed element catalog; do not maintain a second plugin list in the skill.
+Use the component catalog reported directly by released core `@ankhorage/zora`. Do not discover,
+compose, or maintain a second catalog from standalone `@ankhorage/zora-*` packages.
 
 ## 2. Ask in dependency order
 

package/dist/tools/skills/assets/zora-designer/scripts/owner-api.ts

@@ -84,10 +84,6 @@ interface RecipeMetadata extends Record<string, unknown> {
 }
 
 interface ZoraMetadataApi extends Record<string, unknown> {
-  composeZoraPluginMetadata: (plugins: readonly Record<string, unknown>[]) => {
-    componentMeta: Record<string, ComponentMetadata | undefined>;
-  };
-  ZORA_CORE_PLUGIN_METADATA: Record<string, unknown>;
   ZORA_COMPONENT_META: Record<string, ComponentMetadata | undefined>;
   ZORA_THEME_RECIPE_META: Record<string, RecipeMetadata | undefined>;
 }
@@ -122,8 +118,8 @@ interface LoadedOwnerModule {
 const OWNER_RELEASES = {
   colorTheory: { packageName: '@ankhorage/color-theory', minimumVersion: '0.3.1' },
   contracts: { packageName: '@ankhorage/contracts', minimumVersion: '22.0.2' },
-  templates: { packageName: '@ankhorage/templates', minimumVersion: '12.0.0' },
-  zora: { packageName: '@ankhorage/zora', minimumVersion: '20.0.1' },
+  templates: { packageName: '@ankhorage/templates', minimumVersion: '12.0.3' },
+  zora: { packageName: '@ankhorage/zora', minimumVersion: '21.1.0' },
 };
 
 const OWNER_REQUIREMENTS = {
@@ -159,12 +155,7 @@ const OWNER_REQUIREMENTS = {
   zoraMetadata: {
     ...OWNER_RELEASES.zora,
     specifier: '@ankhorage/zora/metadata',
-    exports: [
-      'composeZoraPluginMetadata',
-      'ZORA_COMPONENT_META',
-      'ZORA_CORE_PLUGIN_METADATA',
-      'ZORA_THEME_RECIPE_META',
-    ],
+    exports: ['ZORA_COMPONENT_META', 'ZORA_THEME_RECIPE_META'],
   },
 };
 
@@ -180,112 +171,27 @@ export async function loadOwnerApis(targetDirectory = process.cwd()) {
   const templates = await loadOwnerModule(targetDirectory, OWNER_REQUIREMENTS.templates);
   const zoraTheme = await loadOwnerModule(targetDirectory, OWNER_REQUIREMENTS.zoraTheme);
   const zoraMetadata = await loadOwnerModule(targetDirectory, OWNER_REQUIREMENTS.zoraMetadata);
-  const installedPluginMetadata = await loadInstalledZoraPluginMetadata(targetDirectory);
   assertColorTheoryApi(colorTheory.module);
   assertContractsApi(contracts.module);
   assertTemplatesApi(templates.module);
   assertZoraThemeApi(zoraTheme.module);
   assertZoraMetadataApi(zoraMetadata.module);
-  const composedZoraMetadata = zoraMetadata.module.composeZoraPluginMetadata([
-    zoraMetadata.module.ZORA_CORE_PLUGIN_METADATA,
-    ...installedPluginMetadata.map((entry) => entry.metadata),
-  ]);
-  assertRecord(composedZoraMetadata, 'composed ZORA plugin metadata');
-  assertRecord(composedZoraMetadata.componentMeta, 'composed ZORA component metadata');
 
   return {
     colorTheory: colorTheory.module,
     contracts: contracts.module,
     templates: templates.module,
     zoraTheme: zoraTheme.module,
-    zoraMetadata: {
-      ...zoraMetadata.module,
-      ZORA_COMPONENT_META: composedZoraMetadata.componentMeta,
-    },
+    zoraMetadata: zoraMetadata.module,
     versions: {
       colorTheory: colorTheory.version,
       contracts: contracts.version,
       templates: templates.version,
       zora: zoraTheme.version,
-      plugins: Object.fromEntries(
-        installedPluginMetadata.map((entry) => [entry.packageName, entry.version]),
-      ),
     },
   };
 }
 
-/*** Load metadata-only descriptors for every installed ZORA plugin declared by the target package. */
-async function loadInstalledZoraPluginMetadata(
-  targetDirectory: string,
-): Promise<{ metadata: Record<string, unknown>; packageName: string; version: string }[]> {
-  const targetManifestPath = join(resolve(targetDirectory), 'package.json');
-  const targetManifest: unknown = JSON.parse(await readFile(targetManifestPath, 'utf8'));
-  assertRecord(targetManifest, 'Target package manifest');
-  const packageNames = new Set<string>();
-  if (typeof targetManifest.name === 'string') packageNames.add(targetManifest.name);
-  for (const field of ['dependencies', 'devDependencies', 'peerDependencies']) {
-    const dependencies = targetManifest[field];
-    if (!isRecord(dependencies)) continue;
-    for (const packageName of Object.keys(dependencies)) packageNames.add(packageName);
-  }
-
-  const loaded: { metadata: Record<string, unknown>; packageName: string; version: string }[] = [];
-  for (const packageName of [...packageNames].filter(isZoraPluginPackage).sort()) {
-    const minimumVersion = resolvePluginMinimumVersion(targetManifest, packageName);
-    const requirement: OwnerRequirement = {
-      packageName,
-      minimumVersion,
-      specifier: `${packageName}/metadata`,
-      exports: ['ZORA_PLUGIN_METADATA'],
-    };
-    const plugin = await loadOwnerModule(targetDirectory, requirement);
-    const metadata = plugin.module.ZORA_PLUGIN_METADATA;
-    assertRecord(metadata, `${packageName} ZORA plugin metadata`);
-    loaded.push({ metadata, packageName, version: plugin.version });
-  }
-  return loaded;
-}
-
-function isZoraPluginPackage(packageName: string): boolean {
-  return packageName.startsWith('@ankhorage/zora-') && packageName !== '@ankhorage/zora';
-}
-
-/*** Resolve one ZORA plugin minimum version from the target package declaration or owner package itself. */
-function resolvePluginMinimumVersion(
-  targetManifest: Record<string, unknown>,
-  packageName: string,
-): string {
-  if (targetManifest.name === packageName) {
-    const { version } = targetManifest;
-    if (typeof version === 'string' && parseVersion(version)[0] >= 0) return version;
-    throw new Error(`ZORA plugin owner package ${packageName} must declare a semantic version.`);
-  }
-
-  for (const field of ['dependencies', 'devDependencies', 'peerDependencies']) {
-    const dependencies = targetManifest[field];
-    if (!isRecord(dependencies)) continue;
-    const specifier = dependencies[packageName];
-    if (typeof specifier === 'string') {
-      return readPluginMinimumVersion(packageName, specifier);
-    }
-  }
-
-  throw new Error(`ZORA plugin ${packageName} must be declared by the target package.`);
-}
-
-/*** Read the semantic lower bound from one supported published dependency specifier. */
-function readPluginMinimumVersion(packageName: string, specifier: string): string {
-  const normalized = specifier.trim().replace(/^workspace:/u, '');
-  const match = /^(?:\^|~|>=)?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)$/u.exec(normalized);
-  const minimumVersion = match?.[1];
-  if (minimumVersion === undefined) {
-    throw new Error(
-      `ZORA plugin ${packageName} must use an exact, caret, tilde, or >= semantic dependency range; found ${specifier}.`,
-    );
-  }
-  return minimumVersion;
-}
-
 /*** Load only Contracts for tooling that runs before another owner package has been built. */
 export async function loadContractsApi(targetDirectory = process.cwd()): Promise<ContractsApi> {
   const loaded = await loadOwnerModule(targetDirectory, OWNER_REQUIREMENTS.contracts);
@@ -754,10 +660,6 @@ function assertZoraThemeApi(value: Record<string, unknown>): asserts value is Zo
 
 /*** Narrow released ZORA metadata into only the fields the orchestration needs. */
 function assertZoraMetadataApi(value: Record<string, unknown>): asserts value is ZoraMetadataApi {
-  if (typeof value.composeZoraPluginMetadata !== 'function') {
-    throw new Error('composeZoraPluginMetadata must be a function.');
-  }
-  assertRecord(value.ZORA_CORE_PLUGIN_METADATA, 'ZORA_CORE_PLUGIN_METADATA');
   assertRecord(value.ZORA_COMPONENT_META, 'ZORA_COMPONENT_META');
   for (const [name, metadata] of Object.entries(value.ZORA_COMPONENT_META)) {
     assertComponentMetadata(metadata, name);

package/dist/tools/skills/zoraDesignerOwnerFixtures.d.ts

@@ -3,4 +3,4 @@ export declare const TEMPLATES_FIXTURE_SOURCE: string;
 export declare const COLOR_THEORY_FIXTURE_SOURCE = "\nexport const COLOR_HARMONIES = ['monochromatic', 'complementary'];\nexport const COLOR_HARMONY_CATALOG = [\n  { id: 'monochromatic', label: 'Monochromatic', description: 'One hue.' },\n  { id: 'complementary', label: 'Complementary', description: 'Opposing hues.' },\n];\n";
 export declare const CONTRACTS_FIXTURE_SOURCE = "\nexport const APP_CATEGORIES = ['business_productivity'];\nexport const NAVIGATOR_TYPES = ['stack', 'tabs', 'drawer'];\n";
 export declare const ZORA_THEME_FIXTURE_SOURCE = "\nexport const compileZoraTheme = (themeConfig) => ({\n  themeConfig,\n  light: { surfaceTheme: { mode: 'light' }, diagnostics: [] },\n  dark: { surfaceTheme: { mode: 'dark' }, diagnostics: [] },\n  diagnostics: [],\n});\n";
-export declare const ZORA_METADATA_FIXTURE_SOURCE = "\nexport const ZORA_COMPONENT_META = {\n  Screen: {\n    name: 'Screen',\n    category: 'layout',\n    description: 'Screen layout root',\n    directManifestNode: true,\n    allowedChildren: ['View', 'Box', 'Text', 'MissingElement'],\n    props: {},\n  },\n  View: {\n    name: 'View',\n    category: 'layout',\n    directManifestNode: true,\n    allowedChildren: ['Text', 'Box'],\n    props: {},\n  },\n  Box: {\n    name: 'Box',\n    category: 'foundation',\n    directManifestNode: true,\n    allowedChildren: [],\n    props: {},\n  },\n  Text: {\n    name: 'Text',\n    category: 'component',\n    directManifestNode: true,\n    allowedChildren: [],\n    props: { text: { type: 'string' } },\n    events: {\n      press: {\n        eventType: 'text.press',\n        label: 'Press',\n        description: 'Text was pressed.',\n      },\n    },\n  },\n  MissingElement: {\n    name: 'MissingElement',\n    category: 'pattern',\n    directManifestNode: true,\n    allowedChildren: [],\n    manifestPolicy: { kind: 'unresolved-element', availability: 'draft-only', releaseGate: 'blocked' },\n    blueprint: { defaultProps: { requestedCapability: 'Unresolved', reason: 'No exact element.' } },\n    props: {\n      requestedCapability: { type: 'string' },\n      reason: { type: 'string' },\n      evidenceId: { type: 'string' },\n    },\n  },\n};\nexport const ZORA_CORE_PLUGIN_METADATA = {\n  packageName: '@ankhorage/zora',\n  componentMeta: ZORA_COMPONENT_META,\n  extensionHosts: ['Screen', 'View', 'Box'],\n};\nexport const composeZoraPluginMetadata = (plugins) => {\n  const componentMeta = {};\n  const extensionHosts = new Set();\n  for (const plugin of [...plugins].sort((left, right) => left.packageName.localeCompare(right.packageName))) {\n    Object.assign(componentMeta, plugin.componentMeta);\n    for (const host of plugin.extensionHosts ?? []) extensionHosts.add(host);\n  }\n  for (const plugin of plugins) {\n    for (const placement of plugin.placements ?? []) {\n      for (const parent of placement.parents) {\n        if (!extensionHosts.has(parent)) throw new Error('Invalid extension host');\n        componentMeta[parent] = {\n          ...componentMeta[parent],\n          allowedChildren: [...componentMeta[parent].allowedChildren, placement.child],\n        };\n      }\n    }\n  }\n  return { componentMeta };\n};\nexport const ZORA_THEME_RECIPE_META = {\n  Card: {\n    name: 'Card',\n    kind: 'component',\n    fields: { variant: { type: 'choice', options: ['filled', 'outlined'] } },\n  },\n};\n";
+export declare const ZORA_METADATA_FIXTURE_SOURCE = "\nexport const ZORA_COMPONENT_META = {\n  Screen: {\n    name: 'Screen',\n    category: 'layout',\n    description: 'Screen layout root',\n    directManifestNode: true,\n    allowedChildren: ['View', 'Box', 'Text', 'MissingElement'],\n    props: {},\n  },\n  View: {\n    name: 'View',\n    category: 'layout',\n    directManifestNode: true,\n    allowedChildren: ['Text', 'Box'],\n    props: {},\n  },\n  Box: {\n    name: 'Box',\n    category: 'foundation',\n    directManifestNode: true,\n    allowedChildren: [],\n    props: {},\n  },\n  Text: {\n    name: 'Text',\n    category: 'component',\n    directManifestNode: true,\n    allowedChildren: [],\n    props: { text: { type: 'string' } },\n    events: {\n      press: {\n        eventType: 'text.press',\n        label: 'Press',\n        description: 'Text was pressed.',\n      },\n    },\n  },\n  MissingElement: {\n    name: 'MissingElement',\n    category: 'pattern',\n    directManifestNode: true,\n    allowedChildren: [],\n    manifestPolicy: { kind: 'unresolved-element', availability: 'draft-only', releaseGate: 'blocked' },\n    blueprint: { defaultProps: { requestedCapability: 'Unresolved', reason: 'No exact element.' } },\n    props: {\n      requestedCapability: { type: 'string' },\n      reason: { type: 'string' },\n      evidenceId: { type: 'string' },\n    },\n  },\n  ChessBoard: {\n    name: 'ChessBoard',\n    category: 'component',\n    directManifestNode: true,\n    allowedChildren: [],\n    props: {},\n  },\n  GameField: {\n    name: 'GameField',\n    category: 'component',\n    directManifestNode: true,\n    allowedChildren: [],\n    props: {},\n  },\n  TabletopTable: {\n    name: 'TabletopTable',\n    category: 'component',\n    directManifestNode: true,\n    allowedChildren: [],\n    props: {},\n  },\n};\nexport const ZORA_THEME_RECIPE_META = {\n  Card: {\n    name: 'Card',\n    kind: 'component',\n    fields: { variant: { type: 'choice', options: ['filled', 'outlined'] } },\n  },\n};\n";

package/dist/tools/skills/zoraDesignerOwnerFixtures.js

@@ -130,31 +130,27 @@ export const ZORA_COMPONENT_META = {
       evidenceId: { type: 'string' },
     },
   },
-};
-export const ZORA_CORE_PLUGIN_METADATA = {
-  packageName: '@ankhorage/zora',
-  componentMeta: ZORA_COMPONENT_META,
-  extensionHosts: ['Screen', 'View', 'Box'],
-};
-export const composeZoraPluginMetadata = (plugins) => {
-  const componentMeta = {};
-  const extensionHosts = new Set();
-  for (const plugin of [...plugins].sort((left, right) => left.packageName.localeCompare(right.packageName))) {
-    Object.assign(componentMeta, plugin.componentMeta);
-    for (const host of plugin.extensionHosts ?? []) extensionHosts.add(host);
-  }
-  for (const plugin of plugins) {
-    for (const placement of plugin.placements ?? []) {
-      for (const parent of placement.parents) {
-        if (!extensionHosts.has(parent)) throw new Error('Invalid extension host');
-        componentMeta[parent] = {
-          ...componentMeta[parent],
-          allowedChildren: [...componentMeta[parent].allowedChildren, placement.child],
-        };
-      }
-    }
-  }
-  return { componentMeta };
+  ChessBoard: {
+    name: 'ChessBoard',
+    category: 'component',
+    directManifestNode: true,
+    allowedChildren: [],
+    props: {},
+  },
+  GameField: {
+    name: 'GameField',
+    category: 'component',
+    directManifestNode: true,
+    allowedChildren: [],
+    props: {},
+  },
+  TabletopTable: {
+    name: 'TabletopTable',
+    category: 'component',
+    directManifestNode: true,
+    allowedChildren: [],
+    props: {},
+  },
 };
 export const ZORA_THEME_RECIPE_META = {
   Card: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "2.0.11",
+  "version": "2.0.12",
   "description": "Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",