@ankhorage/contracts 22.1.1 → 22.2.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/contracts
 
+## 22.2.0
+
+### Minor Changes
+
+- af50e7e: Publish generated structural evidence for canonical ScreenSpec metadata authoring.
+
+## 22.1.2
+
+### Patch Changes
+
+- bc6d757: Make the structure runtime subpath loadable directly under Node ESM by emitting explicit JavaScript module specifiers.
+
 ## 22.1.1
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/contracts
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v22.1.1](././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) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v22.2.0](././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) ![docs: paradox](././paradox/badges/docs.svg)
 
 Serializable app, action, theme, auth, and secret-store contracts for Ankhorage.
 

package/dist/cli/index.d.ts

@@ -20,9 +20,18 @@ export interface AnkhCommandProviderManifest {
     readonly capabilities: readonly AnkhCapabilityId[];
     readonly commands: readonly AnkhCommandDescriptor[];
 }
+export interface AnkhStructureRootMetadata {
+    readonly source: string;
+    readonly export: string;
+}
+export interface AnkhStructureMetadata {
+    readonly output: string;
+    readonly roots: Readonly<Record<string, AnkhStructureRootMetadata>>;
+}
 export interface AnkhPackageMetadata {
     readonly category: AnkhCommandCategory;
     readonly provider: AnkhProviderReference | null;
     readonly capabilities: readonly AnkhCapabilityId[];
+    readonly structure?: AnkhStructureMetadata;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAAG,KAAK,MAAM,EAAE,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAAG,KAAK,MAAM,EAAE,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;CAC5C"}

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"","sourcesContent":["export type AnkhCommandCategory = string;\n\nexport type AnkhProviderReference = `./${string}`;\n\nexport type AnkhCapabilityId = `${string}.${string}`;\n\nexport interface AnkhCommandDescriptor {\n  /**\n   * Command path relative to the provider category.\n   *\n   * An empty path declares the command at the category root.\n   */\n  readonly path: readonly string[];\n  readonly summary: string;\n  readonly capability: AnkhCapabilityId;\n  readonly aliases?: readonly string[];\n  readonly examples?: readonly string[];\n}\n\nexport interface AnkhCommandProviderManifest {\n  readonly id: string;\n  readonly category: AnkhCommandCategory;\n  readonly version: string;\n  readonly capabilities: readonly AnkhCapabilityId[];\n  readonly commands: readonly AnkhCommandDescriptor[];\n}\n\nexport interface AnkhPackageMetadata {\n  readonly category: AnkhCommandCategory;\n  readonly provider: AnkhProviderReference | null;\n  readonly capabilities: readonly AnkhCapabilityId[];\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"","sourcesContent":["export type AnkhCommandCategory = string;\n\nexport type AnkhProviderReference = `./${string}`;\n\nexport type AnkhCapabilityId = `${string}.${string}`;\n\nexport interface AnkhCommandDescriptor {\n  /**\n   * Command path relative to the provider category.\n   *\n   * An empty path declares the command at the category root.\n   */\n  readonly path: readonly string[];\n  readonly summary: string;\n  readonly capability: AnkhCapabilityId;\n  readonly aliases?: readonly string[];\n  readonly examples?: readonly string[];\n}\n\nexport interface AnkhCommandProviderManifest {\n  readonly id: string;\n  readonly category: AnkhCommandCategory;\n  readonly version: string;\n  readonly capabilities: readonly AnkhCapabilityId[];\n  readonly commands: readonly AnkhCommandDescriptor[];\n}\n\nexport interface AnkhStructureRootMetadata {\n  readonly source: string;\n  readonly export: string;\n}\n\nexport interface AnkhStructureMetadata {\n  readonly output: string;\n  readonly roots: Readonly<Record<string, AnkhStructureRootMetadata>>;\n}\n\nexport interface AnkhPackageMetadata {\n  readonly category: AnkhCommandCategory;\n  readonly provider: AnkhProviderReference | null;\n  readonly capabilities: readonly AnkhCapabilityId[];\n  readonly structure?: AnkhStructureMetadata;\n}\n"]}

package/dist/structure/generated.d.ts

@@ -0,0 +1,47 @@
+export declare const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = "6.0.3";
+export declare const STRUCTURE_DESCRIPTOR_FINGERPRINT = "sha256:be044f4aeb00c3790561556c7688623084944d3d85d860daedc7989ab5989cf6";
+export declare const STRUCTURE_DESCRIPTOR: {
+    readonly protocolVersion: 1;
+    readonly packageName: "@ankhorage/contracts";
+    readonly packageVersion: "22.1.2";
+    readonly roots: {
+        readonly "screen-metadata": "ScreenMetadataSpec";
+    };
+    readonly descriptors: {
+        readonly ScreenMetadataSpec: {
+            readonly id: "ScreenMetadataSpec";
+            readonly descriptor: {
+                readonly kind: "object";
+                readonly fields: {
+                    readonly description: {
+                        readonly value: {
+                            readonly kind: "scalar";
+                            readonly type: "string";
+                        };
+                        readonly optional: true;
+                    };
+                    readonly id: {
+                        readonly value: {
+                            readonly kind: "scalar";
+                            readonly type: "string";
+                        };
+                    };
+                    readonly name: {
+                        readonly value: {
+                            readonly kind: "scalar";
+                            readonly type: "string";
+                        };
+                    };
+                    readonly title: {
+                        readonly value: {
+                            readonly kind: "scalar";
+                            readonly type: "string";
+                        };
+                        readonly optional: true;
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=generated.d.ts.map

package/dist/structure/generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../src/structure/generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qCAAqC,UAAU,CAAC;AAC7D,eAAO,MAAM,gCAAgC,4EAA4E,CAAC;AAE1H,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2Ce,CAAC"}

package/dist/structure/generated.js

@@ -0,0 +1,47 @@
+export const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';
+export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:be044f4aeb00c3790561556c7688623084944d3d85d860daedc7989ab5989cf6';
+export const STRUCTURE_DESCRIPTOR = {
+    "protocolVersion": 1,
+    "packageName": "@ankhorage/contracts",
+    "packageVersion": "22.1.2",
+    "roots": {
+        "screen-metadata": "ScreenMetadataSpec"
+    },
+    "descriptors": {
+        "ScreenMetadataSpec": {
+            "id": "ScreenMetadataSpec",
+            "descriptor": {
+                "kind": "object",
+                "fields": {
+                    "description": {
+                        "value": {
+                            "kind": "scalar",
+                            "type": "string"
+                        },
+                        "optional": true
+                    },
+                    "id": {
+                        "value": {
+                            "kind": "scalar",
+                            "type": "string"
+                        }
+                    },
+                    "name": {
+                        "value": {
+                            "kind": "scalar",
+                            "type": "string"
+                        }
+                    },
+                    "title": {
+                        "value": {
+                            "kind": "scalar",
+                            "type": "string"
+                        },
+                        "optional": true
+                    }
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=generated.js.map

package/dist/structure/generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated.js","sourceRoot":"","sources":["../../src/structure/generated.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qCAAqC,GAAG,OAAO,CAAC;AAC7D,MAAM,CAAC,MAAM,gCAAgC,GAAG,yEAAyE,CAAC;AAE1H,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iBAAiB,EAAE,CAAC;IACpB,aAAa,EAAE,sBAAsB;IACrC,gBAAgB,EAAE,QAAQ;IAC1B,OAAO,EAAE;QACP,iBAAiB,EAAE,oBAAoB;KACxC;IACD,aAAa,EAAE;QACb,oBAAoB,EAAE;YACpB,IAAI,EAAE,oBAAoB;YAC1B,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,aAAa,EAAE;wBACb,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,IAAI,EAAE;wBACJ,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBACD,MAAM,EAAE;wBACN,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBACD,OAAO,EAAE;wBACP,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;KACF;CAC6C,CAAC","sourcesContent":["/* This file is generated by @ankhorage/devtools. Do not edit manually. */\nimport type { StructureDescriptorDocument } from '@ankhorage/contracts/structure';\n\nexport const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';\nexport const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:be044f4aeb00c3790561556c7688623084944d3d85d860daedc7989ab5989cf6';\n\nexport const STRUCTURE_DESCRIPTOR = {\n  \"protocolVersion\": 1,\n  \"packageName\": \"@ankhorage/contracts\",\n  \"packageVersion\": \"22.1.2\",\n  \"roots\": {\n    \"screen-metadata\": \"ScreenMetadataSpec\"\n  },\n  \"descriptors\": {\n    \"ScreenMetadataSpec\": {\n      \"id\": \"ScreenMetadataSpec\",\n      \"descriptor\": {\n        \"kind\": \"object\",\n        \"fields\": {\n          \"description\": {\n            \"value\": {\n              \"kind\": \"scalar\",\n              \"type\": \"string\"\n            },\n            \"optional\": true\n          },\n          \"id\": {\n            \"value\": {\n              \"kind\": \"scalar\",\n              \"type\": \"string\"\n            }\n          },\n          \"name\": {\n            \"value\": {\n              \"kind\": \"scalar\",\n              \"type\": \"string\"\n            }\n          },\n          \"title\": {\n            \"value\": {\n              \"kind\": \"scalar\",\n              \"type\": \"string\"\n            },\n            \"optional\": true\n          }\n        }\n      }\n    }\n  }\n} as const satisfies StructureDescriptorDocument;\n"]}

package/dist/structure/index.d.ts

@@ -1,5 +1,6 @@
 export type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
-export { isStructureDescriptor } from './isStructureDescriptor';
-export { isStructureDescriptorDocument } from './isStructureDescriptorDocument';
-export type { StructureDescriptor, StructureDescriptorDefinition, StructureDescriptorDocument, StructureDescriptorId, StructureDescriptorRegistry, StructureEntityRegistryDescriptor, StructureEnumDescriptor, StructureLiteralValue, StructureObjectDescriptor, StructureObjectField, StructureOrderedListDescriptor, StructureReferenceDescriptor, StructureScalarDescriptor, StructureScalarType, StructureSetDescriptor, StructureUnionDescriptor, StructureValueMapDescriptor, } from './types';
+export { STRUCTURE_DESCRIPTOR, STRUCTURE_DESCRIPTOR_COMPILER_VERSION, STRUCTURE_DESCRIPTOR_FINGERPRINT, } from './generated.js';
+export { isStructureDescriptor } from './isStructureDescriptor.js';
+export { isStructureDescriptorDocument } from './isStructureDescriptorDocument.js';
+export type { StructureDescriptor, StructureDescriptorDefinition, StructureDescriptorDocument, StructureDescriptorId, StructureDescriptorRegistry, StructureEntityRegistryDescriptor, StructureEnumDescriptor, StructureLiteralValue, StructureObjectDescriptor, StructureObjectField, StructureOrderedListDescriptor, StructureReferenceDescriptor, StructureScalarDescriptor, StructureScalarType, StructureSetDescriptor, StructureUnionDescriptor, StructureValueMapDescriptor, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/structure/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/structure/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,2BAA2B,EAC3B,iCAAiC,EACjC,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/structure/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EACL,oBAAoB,EACpB,qCAAqC,EACrC,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,2BAA2B,EAC3B,iCAAiC,EACjC,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}

package/dist/structure/index.js

@@ -1,3 +1,4 @@
-export { isStructureDescriptor } from './isStructureDescriptor';
-export { isStructureDescriptorDocument } from './isStructureDescriptorDocument';
+export { STRUCTURE_DESCRIPTOR, STRUCTURE_DESCRIPTOR_COMPILER_VERSION, STRUCTURE_DESCRIPTOR_FINGERPRINT, } from './generated.js';
+export { isStructureDescriptor } from './isStructureDescriptor.js';
+export { isStructureDescriptorDocument } from './isStructureDescriptorDocument.js';
 //# sourceMappingURL=index.js.map

package/dist/structure/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structure/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC","sourcesContent":["export type { EntityRegistry, SerializableSet, ValueMap } from '../collections';\nexport { isStructureDescriptor } from './isStructureDescriptor';\nexport { isStructureDescriptorDocument } from './isStructureDescriptorDocument';\nexport type {\n  StructureDescriptor,\n  StructureDescriptorDefinition,\n  StructureDescriptorDocument,\n  StructureDescriptorId,\n  StructureDescriptorRegistry,\n  StructureEntityRegistryDescriptor,\n  StructureEnumDescriptor,\n  StructureLiteralValue,\n  StructureObjectDescriptor,\n  StructureObjectField,\n  StructureOrderedListDescriptor,\n  StructureReferenceDescriptor,\n  StructureScalarDescriptor,\n  StructureScalarType,\n  StructureSetDescriptor,\n  StructureUnionDescriptor,\n  StructureValueMapDescriptor,\n} from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structure/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,qCAAqC,EACrC,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC","sourcesContent":["export type { EntityRegistry, SerializableSet, ValueMap } from '../collections';\nexport {\n  STRUCTURE_DESCRIPTOR,\n  STRUCTURE_DESCRIPTOR_COMPILER_VERSION,\n  STRUCTURE_DESCRIPTOR_FINGERPRINT,\n} from './generated.js';\nexport { isStructureDescriptor } from './isStructureDescriptor.js';\nexport { isStructureDescriptorDocument } from './isStructureDescriptorDocument.js';\nexport type {\n  StructureDescriptor,\n  StructureDescriptorDefinition,\n  StructureDescriptorDocument,\n  StructureDescriptorId,\n  StructureDescriptorRegistry,\n  StructureEntityRegistryDescriptor,\n  StructureEnumDescriptor,\n  StructureLiteralValue,\n  StructureObjectDescriptor,\n  StructureObjectField,\n  StructureOrderedListDescriptor,\n  StructureReferenceDescriptor,\n  StructureScalarDescriptor,\n  StructureScalarType,\n  StructureSetDescriptor,\n  StructureUnionDescriptor,\n  StructureValueMapDescriptor,\n} from './types.js';\n"]}

package/dist/structure/isStructureDescriptorDocument.d.ts

@@ -1,4 +1,4 @@
-import type { StructureDescriptorDocument } from './types';
+import type { StructureDescriptorDocument } from './types.js';
 /*** Validate a complete package structural-descriptor document and all resolvable references. */
 export declare function isStructureDescriptorDocument(value: unknown): value is StructureDescriptorDocument;
 //# sourceMappingURL=isStructureDescriptorDocument.d.ts.map

package/dist/structure/isStructureDescriptorDocument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isStructureDescriptorDocument.d.ts","sourceRoot":"","sources":["../../src/structure/isStructureDescriptorDocument.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,2BAA2B,EAG5B,MAAM,SAAS,CAAC;AAEjB,iGAAiG;AACjG,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CA2BtC"}
+{"version":3,"file":"isStructureDescriptorDocument.d.ts","sourceRoot":"","sources":["../../src/structure/isStructureDescriptorDocument.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,2BAA2B,EAG5B,MAAM,YAAY,CAAC;AAEpB,iGAAiG;AACjG,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CA2BtC"}

package/dist/structure/isStructureDescriptorDocument.js

@@ -1,6 +1,6 @@
 import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
 import { isNonEmptyString } from '@ankhorage/utility/string';
-import { isStructureDescriptor } from './isStructureDescriptor';
+import { isStructureDescriptor } from './isStructureDescriptor.js';
 /*** Validate a complete package structural-descriptor document and all resolvable references. */
 export function isStructureDescriptorDocument(value) {
     if (!isRecord(value) ||

package/dist/structure/isStructureDescriptorDocument.js.map

@@ -1 +1 @@
-{"version":3,"file":"isStructureDescriptorDocument.js","sourceRoot":"","sources":["../../src/structure/isStructureDescriptorDocument.ts"],"names":[],"mappings":"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","sourcesContent":["import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';\nimport { isNonEmptyString } from '@ankhorage/utility/string';\n\nimport { isStructureDescriptor } from './isStructureDescriptor';\nimport type {\n  StructureDescriptor,\n  StructureDescriptorDefinition,\n  StructureDescriptorDocument,\n  StructureDescriptorId,\n  StructureDescriptorRegistry,\n} from './types';\n\n/*** Validate a complete package structural-descriptor document and all resolvable references. */\nexport function isStructureDescriptorDocument(\n  value: unknown,\n): value is StructureDescriptorDocument {\n  if (\n    !isRecord(value) ||\n    !hasOnlyKeys(value, [\n      'protocolVersion',\n      'packageName',\n      'packageVersion',\n      'roots',\n      'descriptors',\n    ]) ||\n    value.protocolVersion !== 1 ||\n    !isNonEmptyString(value.packageName) ||\n    !isNonEmptyString(value.packageVersion) ||\n    !isRootMap(value.roots) ||\n    !isDescriptorRegistry(value.descriptors)\n  ) {\n    return false;\n  }\n\n  const document: StructureDescriptorDocument = {\n    protocolVersion: 1,\n    packageName: value.packageName,\n    packageVersion: value.packageVersion,\n    roots: value.roots,\n    descriptors: value.descriptors,\n  };\n  return hasResolvableRoots(document) && isDescriptorGraphValid(document);\n}\n\n/*** Validate the root-name to local-descriptor-ID map. */\nfunction isRootMap(value: unknown): value is Readonly<Record<string, StructureDescriptorId>> {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.entries(value).every(\n      ([name, descriptorId]) => isNonEmptyString(name) && isNonEmptyString(descriptorId),\n    )\n  );\n}\n\n/*** Validate descriptor definitions and enforce record-key to definition-ID identity. */\nfunction isDescriptorRegistry(value: unknown): value is StructureDescriptorRegistry {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.entries(value).every(([descriptorId, definition]) =>\n      isDefinition(definition, descriptorId),\n    )\n  );\n}\n\n/*** Validate one descriptor definition against its stable registry key. */\nfunction isDefinition(\n  value: unknown,\n  descriptorId: string,\n): value is StructureDescriptorDefinition {\n  return (\n    isRecord(value) &&\n    hasOnlyKeys(value, ['id', 'descriptor']) &&\n    value.id === descriptorId &&\n    isNonEmptyString(value.id) &&\n    isStructureDescriptor(value.descriptor)\n  );\n}\n\n/*** Require every document root to resolve to one local descriptor definition. */\nfunction hasResolvableRoots(document: StructureDescriptorDocument): boolean {\n  const descriptors = new Map(Object.entries(document.descriptors));\n  return Object.values(document.roots).every((descriptorId) => descriptors.has(descriptorId));\n}\n\n/*** Validate local references, recursive graphs, and string-only collection key/member descriptors. */\nfunction isDescriptorGraphValid(document: StructureDescriptorDocument): boolean {\n  const definitions = new Map(Object.entries(document.descriptors));\n  return Array.from(definitions.values()).every((definition) =>\n    validateGraphNode(definition.descriptor, document, new Set()),\n  );\n}\n\n/*** Validate one graph node while treating revisited local refs as a valid recursive cycle. */\nfunction validateGraphNode(\n  descriptor: StructureDescriptor,\n  document: StructureDescriptorDocument,\n  visitedRefs: Set<string>,\n): boolean {\n  switch (descriptor.kind) {\n    case 'object':\n      return Object.values(descriptor.fields).every((field) =>\n        validateGraphNode(field.value, document, new Set(visitedRefs)),\n      );\n    case 'entity-registry':\n    case 'value-map':\n      return (\n        isStringCompatible(descriptor.key, document, new Set()) &&\n        validateGraphNode(descriptor.value, document, new Set(visitedRefs))\n      );\n    case 'set':\n      return isStringCompatible(descriptor.member, document, new Set());\n    case 'ordered-list':\n      return validateGraphNode(descriptor.item, document, new Set(visitedRefs));\n    case 'union':\n      return descriptor.variants.every((variant) =>\n        validateGraphNode(variant, document, new Set(visitedRefs)),\n      );\n    case 'ref':\n      return validateReference(descriptor, document, visitedRefs);\n    default:\n      return true;\n  }\n}\n\n/*** Resolve and validate one local reference while deferring package-qualified refs to composition. */\nfunction validateReference(\n  descriptor: Extract<StructureDescriptor, { readonly kind: 'ref' }>,\n  document: StructureDescriptorDocument,\n  visitedRefs: Set<string>,\n): boolean {\n  if (descriptor.packageName && descriptor.packageName !== document.packageName) return true;\n  if (visitedRefs.has(descriptor.id)) return true;\n\n  const definition = new Map(Object.entries(document.descriptors)).get(descriptor.id);\n  if (!definition) return false;\n\n  const nextRefs = new Set(visitedRefs);\n  nextRefs.add(descriptor.id);\n  return validateGraphNode(definition.descriptor, document, nextRefs);\n}\n\n/*** Prove that a collection key/member descriptor is string-valued when locally resolvable. */\nfunction isStringCompatible(\n  descriptor: StructureDescriptor,\n  document: StructureDescriptorDocument,\n  visitedRefs: Set<string>,\n): boolean {\n  if (descriptor.kind === 'scalar') return descriptor.type === 'string';\n  if (descriptor.kind === 'enum') {\n    return descriptor.values.every((value) => typeof value === 'string');\n  }\n  if (descriptor.kind !== 'ref') return false;\n  if (descriptor.packageName && descriptor.packageName !== document.packageName) return true;\n  if (visitedRefs.has(descriptor.id)) return false;\n\n  const definition = new Map(Object.entries(document.descriptors)).get(descriptor.id);\n  if (!definition) return false;\n\n  const nextRefs = new Set(visitedRefs);\n  nextRefs.add(descriptor.id);\n  return isStringCompatible(definition.descriptor, document, nextRefs);\n}\n"]}
+{"version":3,"file":"isStructureDescriptorDocument.js","sourceRoot":"","sources":["../../src/structure/isStructureDescriptorDocument.ts"],"names":[],"mappings":"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","sourcesContent":["import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';\nimport { isNonEmptyString } from '@ankhorage/utility/string';\n\nimport { isStructureDescriptor } from './isStructureDescriptor.js';\nimport type {\n  StructureDescriptor,\n  StructureDescriptorDefinition,\n  StructureDescriptorDocument,\n  StructureDescriptorId,\n  StructureDescriptorRegistry,\n} from './types.js';\n\n/*** Validate a complete package structural-descriptor document and all resolvable references. */\nexport function isStructureDescriptorDocument(\n  value: unknown,\n): value is StructureDescriptorDocument {\n  if (\n    !isRecord(value) ||\n    !hasOnlyKeys(value, [\n      'protocolVersion',\n      'packageName',\n      'packageVersion',\n      'roots',\n      'descriptors',\n    ]) ||\n    value.protocolVersion !== 1 ||\n    !isNonEmptyString(value.packageName) ||\n    !isNonEmptyString(value.packageVersion) ||\n    !isRootMap(value.roots) ||\n    !isDescriptorRegistry(value.descriptors)\n  ) {\n    return false;\n  }\n\n  const document: StructureDescriptorDocument = {\n    protocolVersion: 1,\n    packageName: value.packageName,\n    packageVersion: value.packageVersion,\n    roots: value.roots,\n    descriptors: value.descriptors,\n  };\n  return hasResolvableRoots(document) && isDescriptorGraphValid(document);\n}\n\n/*** Validate the root-name to local-descriptor-ID map. */\nfunction isRootMap(value: unknown): value is Readonly<Record<string, StructureDescriptorId>> {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.entries(value).every(\n      ([name, descriptorId]) => isNonEmptyString(name) && isNonEmptyString(descriptorId),\n    )\n  );\n}\n\n/*** Validate descriptor definitions and enforce record-key to definition-ID identity. */\nfunction isDescriptorRegistry(value: unknown): value is StructureDescriptorRegistry {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.entries(value).every(([descriptorId, definition]) =>\n      isDefinition(definition, descriptorId),\n    )\n  );\n}\n\n/*** Validate one descriptor definition against its stable registry key. */\nfunction isDefinition(\n  value: unknown,\n  descriptorId: string,\n): value is StructureDescriptorDefinition {\n  return (\n    isRecord(value) &&\n    hasOnlyKeys(value, ['id', 'descriptor']) &&\n    value.id === descriptorId &&\n    isNonEmptyString(value.id) &&\n    isStructureDescriptor(value.descriptor)\n  );\n}\n\n/*** Require every document root to resolve to one local descriptor definition. */\nfunction hasResolvableRoots(document: StructureDescriptorDocument): boolean {\n  const descriptors = new Map(Object.entries(document.descriptors));\n  return Object.values(document.roots).every((descriptorId) => descriptors.has(descriptorId));\n}\n\n/*** Validate local references, recursive graphs, and string-only collection key/member descriptors. */\nfunction isDescriptorGraphValid(document: StructureDescriptorDocument): boolean {\n  const definitions = new Map(Object.entries(document.descriptors));\n  return Array.from(definitions.values()).every((definition) =>\n    validateGraphNode(definition.descriptor, document, new Set()),\n  );\n}\n\n/*** Validate one graph node while treating revisited local refs as a valid recursive cycle. */\nfunction validateGraphNode(\n  descriptor: StructureDescriptor,\n  document: StructureDescriptorDocument,\n  visitedRefs: Set<string>,\n): boolean {\n  switch (descriptor.kind) {\n    case 'object':\n      return Object.values(descriptor.fields).every((field) =>\n        validateGraphNode(field.value, document, new Set(visitedRefs)),\n      );\n    case 'entity-registry':\n    case 'value-map':\n      return (\n        isStringCompatible(descriptor.key, document, new Set()) &&\n        validateGraphNode(descriptor.value, document, new Set(visitedRefs))\n      );\n    case 'set':\n      return isStringCompatible(descriptor.member, document, new Set());\n    case 'ordered-list':\n      return validateGraphNode(descriptor.item, document, new Set(visitedRefs));\n    case 'union':\n      return descriptor.variants.every((variant) =>\n        validateGraphNode(variant, document, new Set(visitedRefs)),\n      );\n    case 'ref':\n      return validateReference(descriptor, document, visitedRefs);\n    default:\n      return true;\n  }\n}\n\n/*** Resolve and validate one local reference while deferring package-qualified refs to composition. */\nfunction validateReference(\n  descriptor: Extract<StructureDescriptor, { readonly kind: 'ref' }>,\n  document: StructureDescriptorDocument,\n  visitedRefs: Set<string>,\n): boolean {\n  if (descriptor.packageName && descriptor.packageName !== document.packageName) return true;\n  if (visitedRefs.has(descriptor.id)) return true;\n\n  const definition = new Map(Object.entries(document.descriptors)).get(descriptor.id);\n  if (!definition) return false;\n\n  const nextRefs = new Set(visitedRefs);\n  nextRefs.add(descriptor.id);\n  return validateGraphNode(definition.descriptor, document, nextRefs);\n}\n\n/*** Prove that a collection key/member descriptor is string-valued when locally resolvable. */\nfunction isStringCompatible(\n  descriptor: StructureDescriptor,\n  document: StructureDescriptorDocument,\n  visitedRefs: Set<string>,\n): boolean {\n  if (descriptor.kind === 'scalar') return descriptor.type === 'string';\n  if (descriptor.kind === 'enum') {\n    return descriptor.values.every((value) => typeof value === 'string');\n  }\n  if (descriptor.kind !== 'ref') return false;\n  if (descriptor.packageName && descriptor.packageName !== document.packageName) return true;\n  if (visitedRefs.has(descriptor.id)) return false;\n\n  const definition = new Map(Object.entries(document.descriptors)).get(descriptor.id);\n  if (!definition) return false;\n\n  const nextRefs = new Set(visitedRefs);\n  nextRefs.add(descriptor.id);\n  return isStringCompatible(definition.descriptor, document, nextRefs);\n}\n"]}

package/dist/types.d.ts

@@ -138,11 +138,13 @@ export interface UiNode {
     style?: Record<string, number | string>;
     repeat?: UiNodeRepeatSpec;
 }
-export interface ScreenSpec {
+export interface ScreenMetadataSpec {
     id: string;
     name: string;
     title?: string;
     description?: string;
+}
+export interface ScreenSpec extends ScreenMetadataSpec {
     root: UiNode;
     dataLoaders?: readonly ScreenDataLoaderDefinition[];
     requires?: ScreenRequirements;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA6IA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,eAAe;IACf,uBAAuB;IACvB,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,eAAe;IACf,YAAY;IACZ,OAAO;IACP,iBAAiB;IACjB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,SAAS;IACT,aAAa;IACb,mBAAmB;IACnB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,mBAAmB;IACnB,kBAAkB;IAClB,QAAQ;IACR,iBAAiB;IACjB,SAAS;CACD,CAAC;AAGX,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAGrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAGhF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,qBAAqB,CAAU,CAAC;AAGpF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,wBAAwB;IAC3B,WAAW;IACX,UAAU;IACV,aAAa;IACb,WAAW;CACH,CAAC;AAIX,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,YAAY,CAAU,CAAC;AAG3E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAGjF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC","sourcesContent":["import type { ColorHarmony } from '@ankhorage/color-theory';\n\nimport type { SplashScreenSpec } from './appManifest/splashScreen';\nimport type { AuthIdentifierKind, AuthSignUpField } from './auth';\nimport type {\n  BindingValueSource,\n  ComponentDataBindingRegistry,\n  ScreenDataLoaderDefinition,\n} from './bindings';\nimport type { EntityRegistry } from './collections';\nimport type { DataSourceRegistry } from './data';\nimport type { AppDeployManifest } from './deploy';\nimport type { InfraManifest } from './infra';\nimport type { MediaAssetReference, MediaManifest } from './media';\nimport type { AppNavigatorManifest } from './navigator';\nimport type { RepositoryManifest } from './repository';\nimport type { ScreenRequirements } from './requirements';\nimport type { SerializableValue } from './serializable';\nimport type { AppStateSpec } from './state';\nimport type { ThemeGlobalTokenOverrides, ThemeRecipeOverrides } from './theme';\n\nexport interface ThemeModeConfig {\n  primaryColor: string;\n  harmony: ColorHarmony;\n}\n\nexport type ThemeId = string;\n\nexport interface ThemeConfig {\n  id: ThemeId;\n  name: string;\n  light: ThemeModeConfig;\n  dark: ThemeModeConfig;\n  /** Theme-global authored token overrides shared by light and dark mode. */\n  tokens?: ThemeGlobalTokenOverrides;\n  /** Component/pattern recipe override values; recipe schemas remain package-owned metadata. */\n  recipes?: ThemeRecipeOverrides;\n}\n\nexport type ThemeRegistry = EntityRegistry<ThemeId, ThemeConfig, 'id'>;\n\nexport type ActionType =\n  'navigate' | 'alert' | 'console' | 'toggleDarkMode' | 'setLanguage' | 'search' | 'filter';\n\nexport interface NavigateAction {\n  type: 'navigate';\n  payload: {\n    route: string;\n    params?: Record<string, number | string>;\n  };\n}\n\nexport interface AlertAction {\n  type: 'alert';\n  payload?: {\n    message?: string;\n  };\n}\n\nexport interface ConsoleAction {\n  type: 'console';\n  payload?: Record<string, unknown>;\n}\n\nexport interface ToggleDarkModeAction {\n  type: 'toggleDarkMode';\n  payload?: never;\n}\n\nexport interface SetLanguageAction {\n  type: 'setLanguage';\n  payload: {\n    locale: string;\n  };\n}\n\nexport interface SearchAction {\n  type: 'search';\n  payload: {\n    query: string;\n    scope?: string;\n  };\n}\n\nexport interface FilterAction {\n  type: 'filter';\n  payload: {\n    filterKey: string;\n    filterValue: string;\n  };\n}\n\nexport type Action =\n  | AlertAction\n  | ConsoleAction\n  | FilterAction\n  | NavigateAction\n  | SearchAction\n  | SetLanguageAction\n  | ToggleDarkModeAction;\n\nexport type ManifestValue = SerializableValue;\n\nexport type ComponentEventPayloadValue = ManifestValue;\n\nexport interface ComponentEventDto<\n  TType extends string = string,\n  TPayload extends object = Record<string, ComponentEventPayloadValue>,\n> {\n  readonly type: TType;\n  readonly sourceNodeId: string;\n  readonly payload: TPayload;\n}\n\nexport type FormSubmitValues = Record<string, ComponentEventPayloadValue>;\n\nexport type FormSubmitEventDto = ComponentEventDto<\n  'form.submit',\n  {\n    readonly values: FormSubmitValues;\n  }\n>;\n\nexport type ButtonPressEventDto = ComponentEventDto<'button.press', Record<string, never>>;\n\nexport interface CollectionItemPressPayload {\n  readonly itemId: string | number;\n  readonly item: Record<string, ComponentEventPayloadValue>;\n}\n\nexport type CollectionItemPressEventDto = ComponentEventDto<\n  'collection.itemPress',\n  CollectionItemPressPayload\n>;\n\nexport type ComponentEventDtoKind =\n  ButtonPressEventDto['type'] | CollectionItemPressEventDto['type'] | FormSubmitEventDto['type'];\n\nexport type KnownComponentEventDto =\n  ButtonPressEventDto | CollectionItemPressEventDto | FormSubmitEventDto;\n\nexport const APP_CATEGORIES = [\n  'books_reading',\n  'business_productivity',\n  'developer_tools',\n  'education_learning',\n  'entertainment_media',\n  'finance_money',\n  'food_drink',\n  'games',\n  'graphics_design',\n  'health_fitness',\n  'kids_family',\n  'lifestyle',\n  'medical',\n  'music_audio',\n  'navigation_travel',\n  'news_magazines',\n  'photo_video',\n  'reference',\n  'shopping_commerce',\n  'social_community',\n  'sports',\n  'utilities_tools',\n  'weather',\n] as const;\nexport type AppCategory = (typeof APP_CATEGORIES)[number];\n\nexport const AUTH_SCOPES = ['global', 'none', 'integrated'] as const;\nexport type AuthScope = (typeof AUTH_SCOPES)[number];\n\nexport const AUTH_SIGN_IN_IDENTIFIERS = ['email', 'username', 'phone'] as const;\nexport type AuthSignInIdentifier = AuthIdentifierKind;\n\nexport const AUTH_SIGN_UP_POLICIES = ['autoSignIn', 'requireVerification'] as const;\nexport type AuthSignUpPolicy = (typeof AUTH_SIGN_UP_POLICIES)[number];\n\nexport const AUTH_PROFILE_FIELDS = [\n  ...AUTH_SIGN_IN_IDENTIFIERS,\n  'firstName',\n  'lastName',\n  'displayName',\n  'avatarUrl',\n] as const;\nexport type KnownAuthProfileField = (typeof AUTH_PROFILE_FIELDS)[number];\nexport type AuthProfileField = KnownAuthProfileField | (string & {});\n\nexport const AUTH_PROFILE_PRIMARY_KEY_STRATEGIES = ['authUserId'] as const;\nexport type AuthProfilePrimaryKeyStrategy = (typeof AUTH_PROFILE_PRIMARY_KEY_STRATEGIES)[number];\n\nexport const AUTH_PROFILE_CREATE_STRATEGIES = ['trigger', 'api', 'app'] as const;\nexport type AuthProfileCreateStrategy = (typeof AUTH_PROFILE_CREATE_STRATEGIES)[number];\n\nexport const AUTH_PROFILE_UPDATE_STRATEGIES = ['api', 'app'] as const;\nexport type AuthProfileUpdateStrategy = (typeof AUTH_PROFILE_UPDATE_STRATEGIES)[number];\n\ninterface IconPresentationSpec {\n  size?: number | string;\n  color?: string;\n}\n\nexport interface NamedIconSpec extends IconPresentationSpec {\n  name: string;\n  provider?: string;\n  source?: never;\n}\n\nexport interface SvgIconSpec extends IconPresentationSpec {\n  source: MediaAssetReference;\n  name?: never;\n  provider?: never;\n}\n\nexport type IconSpec = NamedIconSpec | SvgIconSpec;\n\nexport interface UiNodeRepeatSpec {\n  source: BindingValueSource;\n  itemAlias?: string;\n  keyPath?: string;\n  empty?: readonly UiNode[];\n}\n\nexport interface UiNode {\n  id: string;\n  type: string;\n  alias?: string;\n  props?: Record<string, unknown>;\n  children?: UiNode[];\n  style?: Record<string, number | string>;\n  repeat?: UiNodeRepeatSpec;\n}\n\nexport interface ScreenSpec {\n  id: string;\n  name: string;\n  title?: string;\n  description?: string;\n  root: UiNode;\n  dataLoaders?: readonly ScreenDataLoaderDefinition[];\n  requires?: ScreenRequirements;\n}\n\nexport interface AuthSignInSpec {\n  identifiers: AuthSignInIdentifier[];\n}\n\nexport interface AuthSignUpSpec {\n  requiredFields: AuthSignUpField[];\n  optionalFields?: AuthSignUpField[];\n  signUpPolicy?: AuthSignUpPolicy;\n}\n\nexport interface AuthProfileSpec {\n  fields: AuthProfileField[];\n  table?: string;\n  primaryKey?: AuthProfilePrimaryKeyStrategy;\n  createStrategy?: AuthProfileCreateStrategy;\n  updateStrategy?: AuthProfileUpdateStrategy;\n}\n\nexport interface AppSettings {\n  localization: {\n    defaultLocale: string;\n    locales: string[];\n  };\n}\n\nexport interface AppManifest {\n  metadata: {\n    name: string;\n    slug: string;\n    version: string;\n    category: AppCategory;\n    themeId: ThemeId;\n    created?: string;\n    updated?: string;\n  };\n  themes: ThemeRegistry;\n  activeThemeId: ThemeId;\n  activeThemeMode?: 'dark' | 'light';\n  splashScreen?: SplashScreenSpec;\n  /** Studio-managed authoring media. Runtime/user uploads are intentionally separate. */\n  media?: MediaManifest;\n  /** App distribution desired state, separate from environment-specific infrastructure. */\n  deploy?: AppDeployManifest;\n  /** Application runtime state is not provisioned by Infra. */\n  state?: AppStateSpec;\n  infra: InfraManifest;\n  navigator: AppNavigatorManifest;\n  screens: EntityRegistry<string, ScreenSpec, 'id'>;\n  dataSources?: DataSourceRegistry;\n  dataBindings?: ComponentDataBindingRegistry;\n  repository?: RepositoryManifest;\n  settings: AppSettings;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA6IA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,eAAe;IACf,uBAAuB;IACvB,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,eAAe;IACf,YAAY;IACZ,OAAO;IACP,iBAAiB;IACjB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,SAAS;IACT,aAAa;IACb,mBAAmB;IACnB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,mBAAmB;IACnB,kBAAkB;IAClB,QAAQ;IACR,iBAAiB;IACjB,SAAS;CACD,CAAC;AAGX,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAGrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAGhF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,qBAAqB,CAAU,CAAC;AAGpF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,wBAAwB;IAC3B,WAAW;IACX,UAAU;IACV,aAAa;IACb,WAAW;CACH,CAAC;AAIX,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,YAAY,CAAU,CAAC;AAG3E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAGjF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC","sourcesContent":["import type { ColorHarmony } from '@ankhorage/color-theory';\n\nimport type { SplashScreenSpec } from './appManifest/splashScreen';\nimport type { AuthIdentifierKind, AuthSignUpField } from './auth';\nimport type {\n  BindingValueSource,\n  ComponentDataBindingRegistry,\n  ScreenDataLoaderDefinition,\n} from './bindings';\nimport type { EntityRegistry } from './collections';\nimport type { DataSourceRegistry } from './data';\nimport type { AppDeployManifest } from './deploy';\nimport type { InfraManifest } from './infra';\nimport type { MediaAssetReference, MediaManifest } from './media';\nimport type { AppNavigatorManifest } from './navigator';\nimport type { RepositoryManifest } from './repository';\nimport type { ScreenRequirements } from './requirements';\nimport type { SerializableValue } from './serializable';\nimport type { AppStateSpec } from './state';\nimport type { ThemeGlobalTokenOverrides, ThemeRecipeOverrides } from './theme';\n\nexport interface ThemeModeConfig {\n  primaryColor: string;\n  harmony: ColorHarmony;\n}\n\nexport type ThemeId = string;\n\nexport interface ThemeConfig {\n  id: ThemeId;\n  name: string;\n  light: ThemeModeConfig;\n  dark: ThemeModeConfig;\n  /** Theme-global authored token overrides shared by light and dark mode. */\n  tokens?: ThemeGlobalTokenOverrides;\n  /** Component/pattern recipe override values; recipe schemas remain package-owned metadata. */\n  recipes?: ThemeRecipeOverrides;\n}\n\nexport type ThemeRegistry = EntityRegistry<ThemeId, ThemeConfig, 'id'>;\n\nexport type ActionType =\n  'navigate' | 'alert' | 'console' | 'toggleDarkMode' | 'setLanguage' | 'search' | 'filter';\n\nexport interface NavigateAction {\n  type: 'navigate';\n  payload: {\n    route: string;\n    params?: Record<string, number | string>;\n  };\n}\n\nexport interface AlertAction {\n  type: 'alert';\n  payload?: {\n    message?: string;\n  };\n}\n\nexport interface ConsoleAction {\n  type: 'console';\n  payload?: Record<string, unknown>;\n}\n\nexport interface ToggleDarkModeAction {\n  type: 'toggleDarkMode';\n  payload?: never;\n}\n\nexport interface SetLanguageAction {\n  type: 'setLanguage';\n  payload: {\n    locale: string;\n  };\n}\n\nexport interface SearchAction {\n  type: 'search';\n  payload: {\n    query: string;\n    scope?: string;\n  };\n}\n\nexport interface FilterAction {\n  type: 'filter';\n  payload: {\n    filterKey: string;\n    filterValue: string;\n  };\n}\n\nexport type Action =\n  | AlertAction\n  | ConsoleAction\n  | FilterAction\n  | NavigateAction\n  | SearchAction\n  | SetLanguageAction\n  | ToggleDarkModeAction;\n\nexport type ManifestValue = SerializableValue;\n\nexport type ComponentEventPayloadValue = ManifestValue;\n\nexport interface ComponentEventDto<\n  TType extends string = string,\n  TPayload extends object = Record<string, ComponentEventPayloadValue>,\n> {\n  readonly type: TType;\n  readonly sourceNodeId: string;\n  readonly payload: TPayload;\n}\n\nexport type FormSubmitValues = Record<string, ComponentEventPayloadValue>;\n\nexport type FormSubmitEventDto = ComponentEventDto<\n  'form.submit',\n  {\n    readonly values: FormSubmitValues;\n  }\n>;\n\nexport type ButtonPressEventDto = ComponentEventDto<'button.press', Record<string, never>>;\n\nexport interface CollectionItemPressPayload {\n  readonly itemId: string | number;\n  readonly item: Record<string, ComponentEventPayloadValue>;\n}\n\nexport type CollectionItemPressEventDto = ComponentEventDto<\n  'collection.itemPress',\n  CollectionItemPressPayload\n>;\n\nexport type ComponentEventDtoKind =\n  ButtonPressEventDto['type'] | CollectionItemPressEventDto['type'] | FormSubmitEventDto['type'];\n\nexport type KnownComponentEventDto =\n  ButtonPressEventDto | CollectionItemPressEventDto | FormSubmitEventDto;\n\nexport const APP_CATEGORIES = [\n  'books_reading',\n  'business_productivity',\n  'developer_tools',\n  'education_learning',\n  'entertainment_media',\n  'finance_money',\n  'food_drink',\n  'games',\n  'graphics_design',\n  'health_fitness',\n  'kids_family',\n  'lifestyle',\n  'medical',\n  'music_audio',\n  'navigation_travel',\n  'news_magazines',\n  'photo_video',\n  'reference',\n  'shopping_commerce',\n  'social_community',\n  'sports',\n  'utilities_tools',\n  'weather',\n] as const;\nexport type AppCategory = (typeof APP_CATEGORIES)[number];\n\nexport const AUTH_SCOPES = ['global', 'none', 'integrated'] as const;\nexport type AuthScope = (typeof AUTH_SCOPES)[number];\n\nexport const AUTH_SIGN_IN_IDENTIFIERS = ['email', 'username', 'phone'] as const;\nexport type AuthSignInIdentifier = AuthIdentifierKind;\n\nexport const AUTH_SIGN_UP_POLICIES = ['autoSignIn', 'requireVerification'] as const;\nexport type AuthSignUpPolicy = (typeof AUTH_SIGN_UP_POLICIES)[number];\n\nexport const AUTH_PROFILE_FIELDS = [\n  ...AUTH_SIGN_IN_IDENTIFIERS,\n  'firstName',\n  'lastName',\n  'displayName',\n  'avatarUrl',\n] as const;\nexport type KnownAuthProfileField = (typeof AUTH_PROFILE_FIELDS)[number];\nexport type AuthProfileField = KnownAuthProfileField | (string & {});\n\nexport const AUTH_PROFILE_PRIMARY_KEY_STRATEGIES = ['authUserId'] as const;\nexport type AuthProfilePrimaryKeyStrategy = (typeof AUTH_PROFILE_PRIMARY_KEY_STRATEGIES)[number];\n\nexport const AUTH_PROFILE_CREATE_STRATEGIES = ['trigger', 'api', 'app'] as const;\nexport type AuthProfileCreateStrategy = (typeof AUTH_PROFILE_CREATE_STRATEGIES)[number];\n\nexport const AUTH_PROFILE_UPDATE_STRATEGIES = ['api', 'app'] as const;\nexport type AuthProfileUpdateStrategy = (typeof AUTH_PROFILE_UPDATE_STRATEGIES)[number];\n\ninterface IconPresentationSpec {\n  size?: number | string;\n  color?: string;\n}\n\nexport interface NamedIconSpec extends IconPresentationSpec {\n  name: string;\n  provider?: string;\n  source?: never;\n}\n\nexport interface SvgIconSpec extends IconPresentationSpec {\n  source: MediaAssetReference;\n  name?: never;\n  provider?: never;\n}\n\nexport type IconSpec = NamedIconSpec | SvgIconSpec;\n\nexport interface UiNodeRepeatSpec {\n  source: BindingValueSource;\n  itemAlias?: string;\n  keyPath?: string;\n  empty?: readonly UiNode[];\n}\n\nexport interface UiNode {\n  id: string;\n  type: string;\n  alias?: string;\n  props?: Record<string, unknown>;\n  children?: UiNode[];\n  style?: Record<string, number | string>;\n  repeat?: UiNodeRepeatSpec;\n}\n\nexport interface ScreenMetadataSpec {\n  id: string;\n  name: string;\n  title?: string;\n  description?: string;\n}\n\nexport interface ScreenSpec extends ScreenMetadataSpec {\n  root: UiNode;\n  dataLoaders?: readonly ScreenDataLoaderDefinition[];\n  requires?: ScreenRequirements;\n}\n\nexport interface AuthSignInSpec {\n  identifiers: AuthSignInIdentifier[];\n}\n\nexport interface AuthSignUpSpec {\n  requiredFields: AuthSignUpField[];\n  optionalFields?: AuthSignUpField[];\n  signUpPolicy?: AuthSignUpPolicy;\n}\n\nexport interface AuthProfileSpec {\n  fields: AuthProfileField[];\n  table?: string;\n  primaryKey?: AuthProfilePrimaryKeyStrategy;\n  createStrategy?: AuthProfileCreateStrategy;\n  updateStrategy?: AuthProfileUpdateStrategy;\n}\n\nexport interface AppSettings {\n  localization: {\n    defaultLocale: string;\n    locales: string[];\n  };\n}\n\nexport interface AppManifest {\n  metadata: {\n    name: string;\n    slug: string;\n    version: string;\n    category: AppCategory;\n    themeId: ThemeId;\n    created?: string;\n    updated?: string;\n  };\n  themes: ThemeRegistry;\n  activeThemeId: ThemeId;\n  activeThemeMode?: 'dark' | 'light';\n  splashScreen?: SplashScreenSpec;\n  /** Studio-managed authoring media. Runtime/user uploads are intentionally separate. */\n  media?: MediaManifest;\n  /** App distribution desired state, separate from environment-specific infrastructure. */\n  deploy?: AppDeployManifest;\n  /** Application runtime state is not provisioned by Infra. */\n  state?: AppStateSpec;\n  infra: InfraManifest;\n  navigator: AppNavigatorManifest;\n  screens: EntityRegistry<string, ScreenSpec, 'id'>;\n  dataSources?: DataSourceRegistry;\n  dataBindings?: ComponentDataBindingRegistry;\n  repository?: RepositoryManifest;\n  settings: AppSettings;\n}\n"]}

package/package.json

@@ -1,20 +1,29 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "22.1.1",
+  "version": "22.2.0",
   "main": "./dist/index.js",
   "ankh": {
     "category": "contracts",
     "provider": null,
     "capabilities": [
       "contracts.cli"
-    ]
+    ],
+    "structure": {
+      "output": "src/structure/generated.ts",
+      "roots": {
+        "screen-metadata": {
+          "source": "src/types.ts",
+          "export": "ScreenMetadataSpec"
+        }
+      }
+    }
   },
   "dependencies": {
     "@ankhorage/color-theory": "^0.3.1",
     "@ankhorage/utility": "^1.4.0"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^1.17.2",
+    "@ankhorage/devtools": "^1.18.4",
     "@ankhorage/paradox": "^0.1.26",
     "@types/bun": "^1.4.1",
     "@types/node": "^25.2.3",
@@ -141,9 +150,10 @@
     "format": "ankhorage-prettier --write .",
     "format:check": "ankhorage-prettier --check .",
     "test": "bun test src",
-    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.infra-tests.json && bun run build && tsc --noEmit -p tsconfig.deploy-provider-consumer.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.infra-tests.json && bun run build && tsc --noEmit -p tsconfig.deploy-provider-consumer.json && bun run structure:check",
     "version-packages": "ankhorage-changeset version",
-    "knip:check": "ankhorage-knip"
+    "knip:check": "ankhorage-knip",
+    "structure:check": "ankhorage-structure check ."
   },
   "sideEffects": false,
   "type": "module",

package/src/cli/index.ts

@@ -25,8 +25,19 @@ export interface AnkhCommandProviderManifest {
   readonly commands: readonly AnkhCommandDescriptor[];
 }
 
+export interface AnkhStructureRootMetadata {
+  readonly source: string;
+  readonly export: string;
+}
+
+export interface AnkhStructureMetadata {
+  readonly output: string;
+  readonly roots: Readonly<Record<string, AnkhStructureRootMetadata>>;
+}
+
 export interface AnkhPackageMetadata {
   readonly category: AnkhCommandCategory;
   readonly provider: AnkhProviderReference | null;
   readonly capabilities: readonly AnkhCapabilityId[];
+  readonly structure?: AnkhStructureMetadata;
 }

package/src/contracts.test.ts

@@ -59,6 +59,15 @@ describe('contracts', () => {
       category: 'contracts',
       provider: null,
       capabilities: ['contracts.cli'],
+      structure: {
+        output: 'src/structure/generated.ts',
+        roots: {
+          'screen-metadata': {
+            source: 'src/types.ts',
+            export: 'ScreenMetadataSpec',
+          },
+        },
+      },
     } as const satisfies AnkhPackageMetadata;
 
     const packageJson = JSON.parse(await readFile(join(process.cwd(), 'package.json'), 'utf8')) as {

package/src/structure/generated.ts

@@ -0,0 +1,50 @@
+/* This file is generated by @ankhorage/devtools. Do not edit manually. */
+import type { StructureDescriptorDocument } from '@ankhorage/contracts/structure';
+
+export const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';
+export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:b0afb6c562efc3e866bcb65467aaa4ba673cd631f09fdbe9cb94f3324e852e66';
+
+export const STRUCTURE_DESCRIPTOR = {
+  "protocolVersion": 1,
+  "packageName": "@ankhorage/contracts",
+  "packageVersion": "22.2.0",
+  "roots": {
+    "screen-metadata": "ScreenMetadataSpec"
+  },
+  "descriptors": {
+    "ScreenMetadataSpec": {
+      "id": "ScreenMetadataSpec",
+      "descriptor": {
+        "kind": "object",
+        "fields": {
+          "description": {
+            "value": {
+              "kind": "scalar",
+              "type": "string"
+            },
+            "optional": true
+          },
+          "id": {
+            "value": {
+              "kind": "scalar",
+              "type": "string"
+            }
+          },
+          "name": {
+            "value": {
+              "kind": "scalar",
+              "type": "string"
+            }
+          },
+          "title": {
+            "value": {
+              "kind": "scalar",
+              "type": "string"
+            },
+            "optional": true
+          }
+        }
+      }
+    }
+  }
+} as const satisfies StructureDescriptorDocument;

package/src/structure/index.ts

@@ -1,6 +1,11 @@
 export type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
-export { isStructureDescriptor } from './isStructureDescriptor';
-export { isStructureDescriptorDocument } from './isStructureDescriptorDocument';
+export {
+  STRUCTURE_DESCRIPTOR,
+  STRUCTURE_DESCRIPTOR_COMPILER_VERSION,
+  STRUCTURE_DESCRIPTOR_FINGERPRINT,
+} from './generated.js';
+export { isStructureDescriptor } from './isStructureDescriptor.js';
+export { isStructureDescriptorDocument } from './isStructureDescriptorDocument.js';
 export type {
   StructureDescriptor,
   StructureDescriptorDefinition,
@@ -19,4 +24,4 @@ export type {
   StructureSetDescriptor,
   StructureUnionDescriptor,
   StructureValueMapDescriptor,
-} from './types';
+} from './types.js';

package/src/structure/isStructureDescriptorDocument.ts

@@ -1,14 +1,14 @@
 import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
 import { isNonEmptyString } from '@ankhorage/utility/string';
 
-import { isStructureDescriptor } from './isStructureDescriptor';
+import { isStructureDescriptor } from './isStructureDescriptor.js';
 import type {
   StructureDescriptor,
   StructureDescriptorDefinition,
   StructureDescriptorDocument,
   StructureDescriptorId,
   StructureDescriptorRegistry,
-} from './types';
+} from './types.js';
 
 /*** Validate a complete package structural-descriptor document and all resolvable references. */
 export function isStructureDescriptorDocument(

package/src/types.ts

@@ -230,11 +230,14 @@ export interface UiNode {
   repeat?: UiNodeRepeatSpec;
 }
 
-export interface ScreenSpec {
+export interface ScreenMetadataSpec {
   id: string;
   name: string;
   title?: string;
   description?: string;
+}
+
+export interface ScreenSpec extends ScreenMetadataSpec {
   root: UiNode;
   dataLoaders?: readonly ScreenDataLoaderDefinition[];
   requires?: ScreenRequirements;