@ankhorage/contracts 22.0.3 → 22.1.0

package/dist/types/infraManifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"infraManifest.js","sourceRoot":"","sources":["../../src/types/infraManifest.ts"],"names":[],"mappings":"","sourcesContent":["import type { AuthFlowConfig, AuthOAuthConfig } from '../auth';\nimport type { SerializableSet } from '../collections';\nimport type { ApiDefinitionRegistry, DataContractValue } from '../data';\nimport type { AppEnvironmentId } from '../environments';\nimport type { INFRA_ADAPTER_CATALOG, INFRA_RUNTIME_COMPATIBILITY } from '../infra/constants';\nimport type { AuthProfileSpec, AuthScope, AuthSignInSpec, AuthSignUpSpec } from '../types';\nimport type { InfraControlPlaneCredentialRef } from './infraSecrets';\nimport type { InfraWorkloadRegistry } from './infraWorkload';\n\nexport type InfraAdapterId = keyof typeof INFRA_ADAPTER_CATALOG;\nexport type InfraCapability =\n  (typeof INFRA_ADAPTER_CATALOG)[InfraAdapterId]['capabilities'][number];\nexport type InfraProviderFor<C extends InfraCapability> = {\n  [P in InfraAdapterId]: C extends (typeof INFRA_ADAPTER_CATALOG)[P]['capabilities'][number]\n    ? P\n    : never;\n}[InfraAdapterId];\nexport type InfraComputeProviderId = InfraProviderFor<'compute'>;\nexport type InfraRuntimeProviderId = keyof typeof INFRA_RUNTIME_COMPATIBILITY;\n\n/** Non-secret provider configuration; credentials are resolved only at the execution boundary. */\nexport interface InfraComputeConfigMap {\n  readonly local: { readonly workingDirectory?: string };\n  readonly hetzner: {\n    readonly location: string;\n    readonly serverType?: string;\n    readonly image?: string;\n    readonly credentials?: InfraControlPlaneCredentialRef;\n    readonly ssh?: {\n      readonly user?: string;\n      readonly port?: number;\n      readonly credentials?: InfraControlPlaneCredentialRef;\n    };\n  };\n}\n\nexport interface InfraRuntimeConfigMap {\n  readonly minikube: {\n    readonly profile?: string;\n    readonly driver?: 'docker' | 'podman';\n    readonly cpus?: number;\n    readonly memoryMiB?: number;\n  };\n  readonly k3s: {\n    readonly version?: string;\n    readonly topology?: { readonly servers: number; readonly agents: number };\n  };\n  readonly 'docker-compose': { readonly projectName?: string };\n}\n\nexport type InfraComputeSelection<P extends InfraComputeProviderId = InfraComputeProviderId> = {\n  [K in P]: { readonly provider: K } & InfraComputeConfigMap[K];\n}[P];\nexport type InfraRuntimeSelection<P extends InfraRuntimeProviderId = InfraRuntimeProviderId> = {\n  [K in P]: { readonly provider: K } & InfraRuntimeConfigMap[K];\n}[P];\n\n/** A discriminated union derived from the runtime catalog, never a Cartesian product. */\nexport type InfraDeploymentSpec = {\n  [R in InfraRuntimeProviderId]: {\n    readonly compute: InfraComputeSelection<(typeof INFRA_RUNTIME_COMPATIBILITY)[R][number]>;\n    readonly runtime: InfraRuntimeSelection<R>;\n  };\n}[InfraRuntimeProviderId];\n\n/** Portable S3-compatible persistence target; privileged values stay behind one credential ref. */\nexport interface InfraS3PersistenceTarget {\n  readonly endpoint: string;\n  readonly region: string;\n  readonly bucket: string;\n  readonly credentials: InfraControlPlaneCredentialRef;\n  readonly forcePathStyle?: boolean;\n}\n\n/** Scheduled database protection intent; the selected database provider owns its concrete engine. */\nexport interface InfraScheduledDatabaseBackupSpec {\n  readonly mode: 'scheduled';\n  readonly target: InfraS3PersistenceTarget;\n  readonly intervalHours?: number;\n}\n\nexport interface InfraDatabaseConfigMap {\n  readonly supabase: {\n    readonly tier?: 'dev' | 'prod';\n    readonly backup?: InfraScheduledDatabaseBackupSpec;\n  };\n}\nexport interface InfraObjectStorageConfigMap {\n  readonly supabase: {\n    readonly buckets?: SerializableSet;\n    readonly backend?: InfraS3PersistenceTarget;\n  };\n  readonly r2: {\n    readonly buckets?: SerializableSet;\n    readonly accountId?: string;\n    readonly credentials?: InfraControlPlaneCredentialRef;\n  };\n}\nexport interface InfraAuthConfigMap {\n  readonly supabase: {\n    readonly scope?: AuthScope;\n    readonly flow?: AuthFlowConfig;\n    readonly signIn?: AuthSignInSpec;\n    readonly signUp?: AuthSignUpSpec;\n    readonly oauth?: AuthOAuthConfig;\n    readonly profile?: AuthProfileSpec;\n  };\n}\nexport interface InfraAuthzConfigMap {\n  readonly cerbos: {\n    readonly kind: 'RBAC' | 'ABAC';\n    readonly policies?: Readonly<Record<string, string>>;\n  };\n}\nexport interface InfraSecretStoreConfigMap {\n  readonly 'supabase-vault': { readonly schema?: string };\n}\n\nexport type InfraDatabaseSpec = {\n  [P in InfraProviderFor<'database'>]: { readonly provider: P } & InfraDatabaseConfigMap[P];\n}[InfraProviderFor<'database'>];\nexport type InfraObjectStorageSpec = {\n  [P in InfraProviderFor<'objectStorage'>]: {\n    readonly provider: P;\n  } & InfraObjectStorageConfigMap[P];\n}[InfraProviderFor<'objectStorage'>];\nexport type InfraAuthSpec = {\n  [P in InfraProviderFor<'auth'>]: { readonly provider: P } & InfraAuthConfigMap[P];\n}[InfraProviderFor<'auth'>];\nexport type InfraAuthzSpec = {\n  [P in InfraProviderFor<'authz'>]: { readonly provider: P } & InfraAuthzConfigMap[P];\n}[InfraProviderFor<'authz'>];\nexport type InfraSecretStoreSpec = {\n  [P in InfraProviderFor<'secretStore'>]: { readonly provider: P } & InfraSecretStoreConfigMap[P];\n}[InfraProviderFor<'secretStore'>];\n\nexport interface InfraNetworkingTlsSpec {\n  /** First production slice: runtime-managed ACME using the HTTP-01 challenge. */\n  readonly mode: 'acme-http-01';\n  /** ACME registration and expiry-notification contact. */\n  readonly contactEmail: string;\n}\n\nexport interface InfraNetworkingSpec {\n  /** Public DNS name intent, not automatic DNS/CDN vendor provisioning. */\n  readonly domain?: string;\n  /** Absolute HTTP(S) origin used by workloads that must know their external URL at startup. */\n  readonly publicBaseUrl?: string;\n  /** Runtime-neutral automatic TLS intent; the selected runtime owns concrete ingress configuration. */\n  readonly tls?: InfraNetworkingTlsSpec;\n}\n\nexport interface InfraEnvironmentSpec {\n  readonly deployment: InfraDeploymentSpec;\n  readonly database?: InfraDatabaseSpec;\n  readonly objectStorage?: InfraObjectStorageSpec;\n  readonly auth?: InfraAuthSpec;\n  readonly authz?: InfraAuthzSpec;\n  readonly secretStore?: InfraSecretStoreSpec;\n  readonly networking?: InfraNetworkingSpec;\n  readonly workloads?: InfraWorkloadRegistry;\n}\n\nexport type InfraModuleId = string;\n\nexport interface InfraModuleSpec {\n  readonly config?: DataContractValue;\n}\n\nexport type InfraModuleRegistry = Readonly<Record<InfraModuleId, InfraModuleSpec>>;\n\nexport interface InfraManifest {\n  readonly environments: Readonly<\n    Record<'local', InfraEnvironmentSpec> &\n      Partial<Record<Exclude<AppEnvironmentId, 'local'>, InfraEnvironmentSpec>>\n  >;\n  readonly apis?: ApiDefinitionRegistry;\n  readonly modules: InfraModuleRegistry;\n}\n"]}
+{"version":3,"file":"infraManifest.js","sourceRoot":"","sources":["../../src/types/infraManifest.ts"],"names":[],"mappings":"","sourcesContent":["import type { AuthFlowConfig, AuthOAuthConfig } from '../auth';\nimport type { EntityRegistry, SerializableSet, ValueMap } from '../collections';\nimport type { ApiDefinitionRegistry, DataContractValue } from '../data';\nimport type { AppEnvironmentId } from '../environments';\nimport type { INFRA_ADAPTER_CATALOG, INFRA_RUNTIME_COMPATIBILITY } from '../infra/constants';\nimport type { AuthProfileSpec, AuthScope, AuthSignInSpec, AuthSignUpSpec } from '../types';\nimport type { InfraControlPlaneCredentialRef } from './infraSecrets';\nimport type { InfraWorkloadRegistry } from './infraWorkload';\n\nexport type InfraAdapterId = keyof typeof INFRA_ADAPTER_CATALOG;\nexport type InfraCapability =\n  (typeof INFRA_ADAPTER_CATALOG)[InfraAdapterId]['capabilities'][number];\nexport type InfraProviderFor<C extends InfraCapability> = {\n  [P in InfraAdapterId]: C extends (typeof INFRA_ADAPTER_CATALOG)[P]['capabilities'][number]\n    ? P\n    : never;\n}[InfraAdapterId];\nexport type InfraComputeProviderId = InfraProviderFor<'compute'>;\nexport type InfraRuntimeProviderId = keyof typeof INFRA_RUNTIME_COMPATIBILITY;\n\n/** Non-secret provider configuration; credentials are resolved only at the execution boundary. */\nexport interface InfraComputeConfigMap {\n  readonly local: { readonly workingDirectory?: string };\n  readonly hetzner: {\n    readonly location: string;\n    readonly serverType?: string;\n    readonly image?: string;\n    readonly credentials?: InfraControlPlaneCredentialRef;\n    readonly ssh?: {\n      readonly user?: string;\n      readonly port?: number;\n      readonly credentials?: InfraControlPlaneCredentialRef;\n    };\n  };\n}\n\nexport interface InfraRuntimeConfigMap {\n  readonly minikube: {\n    readonly profile?: string;\n    readonly driver?: 'docker' | 'podman';\n    readonly cpus?: number;\n    readonly memoryMiB?: number;\n  };\n  readonly k3s: {\n    readonly version?: string;\n    readonly topology?: { readonly servers: number; readonly agents: number };\n  };\n  readonly 'docker-compose': { readonly projectName?: string };\n}\n\nexport type InfraComputeSelection<P extends InfraComputeProviderId = InfraComputeProviderId> = {\n  [K in P]: { readonly provider: K } & InfraComputeConfigMap[K];\n}[P];\nexport type InfraRuntimeSelection<P extends InfraRuntimeProviderId = InfraRuntimeProviderId> = {\n  [K in P]: { readonly provider: K } & InfraRuntimeConfigMap[K];\n}[P];\n\n/** A discriminated union derived from the runtime catalog, never a Cartesian product. */\nexport type InfraDeploymentSpec = {\n  [R in InfraRuntimeProviderId]: {\n    readonly compute: InfraComputeSelection<(typeof INFRA_RUNTIME_COMPATIBILITY)[R][number]>;\n    readonly runtime: InfraRuntimeSelection<R>;\n  };\n}[InfraRuntimeProviderId];\n\n/** Portable S3-compatible persistence target; privileged values stay behind one credential ref. */\nexport interface InfraS3PersistenceTarget {\n  readonly endpoint: string;\n  readonly region: string;\n  readonly bucket: string;\n  readonly credentials: InfraControlPlaneCredentialRef;\n  readonly forcePathStyle?: boolean;\n}\n\n/** Scheduled database protection intent; the selected database provider owns its concrete engine. */\nexport interface InfraScheduledDatabaseBackupSpec {\n  readonly mode: 'scheduled';\n  readonly target: InfraS3PersistenceTarget;\n  readonly intervalHours?: number;\n}\n\nexport interface InfraDatabaseConfigMap {\n  readonly supabase: {\n    readonly tier?: 'dev' | 'prod';\n    readonly backup?: InfraScheduledDatabaseBackupSpec;\n  };\n}\nexport interface InfraObjectStorageConfigMap {\n  readonly supabase: {\n    readonly buckets?: SerializableSet;\n    readonly backend?: InfraS3PersistenceTarget;\n  };\n  readonly r2: {\n    readonly buckets?: SerializableSet;\n    readonly accountId?: string;\n    readonly credentials?: InfraControlPlaneCredentialRef;\n  };\n}\nexport interface InfraAuthConfigMap {\n  readonly supabase: {\n    readonly scope?: AuthScope;\n    readonly flow?: AuthFlowConfig;\n    readonly signIn?: AuthSignInSpec;\n    readonly signUp?: AuthSignUpSpec;\n    readonly oauth?: AuthOAuthConfig;\n    readonly profile?: AuthProfileSpec;\n  };\n}\nexport interface InfraAuthzConfigMap {\n  readonly cerbos: {\n    readonly kind: 'RBAC' | 'ABAC';\n    readonly policies?: ValueMap<string, string>;\n  };\n}\nexport interface InfraSecretStoreConfigMap {\n  readonly 'supabase-vault': { readonly schema?: string };\n}\n\nexport type InfraDatabaseSpec = {\n  [P in InfraProviderFor<'database'>]: { readonly provider: P } & InfraDatabaseConfigMap[P];\n}[InfraProviderFor<'database'>];\nexport type InfraObjectStorageSpec = {\n  [P in InfraProviderFor<'objectStorage'>]: {\n    readonly provider: P;\n  } & InfraObjectStorageConfigMap[P];\n}[InfraProviderFor<'objectStorage'>];\nexport type InfraAuthSpec = {\n  [P in InfraProviderFor<'auth'>]: { readonly provider: P } & InfraAuthConfigMap[P];\n}[InfraProviderFor<'auth'>];\nexport type InfraAuthzSpec = {\n  [P in InfraProviderFor<'authz'>]: { readonly provider: P } & InfraAuthzConfigMap[P];\n}[InfraProviderFor<'authz'>];\nexport type InfraSecretStoreSpec = {\n  [P in InfraProviderFor<'secretStore'>]: { readonly provider: P } & InfraSecretStoreConfigMap[P];\n}[InfraProviderFor<'secretStore'>];\n\nexport interface InfraNetworkingTlsSpec {\n  /** First production slice: runtime-managed ACME using the HTTP-01 challenge. */\n  readonly mode: 'acme-http-01';\n  /** ACME registration and expiry-notification contact. */\n  readonly contactEmail: string;\n}\n\nexport interface InfraNetworkingSpec {\n  /** Public DNS name intent, not automatic DNS/CDN vendor provisioning. */\n  readonly domain?: string;\n  /** Absolute HTTP(S) origin used by workloads that must know their external URL at startup. */\n  readonly publicBaseUrl?: string;\n  /** Runtime-neutral automatic TLS intent; the selected runtime owns concrete ingress configuration. */\n  readonly tls?: InfraNetworkingTlsSpec;\n}\n\nexport interface InfraEnvironmentSpec {\n  readonly deployment: InfraDeploymentSpec;\n  readonly database?: InfraDatabaseSpec;\n  readonly objectStorage?: InfraObjectStorageSpec;\n  readonly auth?: InfraAuthSpec;\n  readonly authz?: InfraAuthzSpec;\n  readonly secretStore?: InfraSecretStoreSpec;\n  readonly networking?: InfraNetworkingSpec;\n  readonly workloads?: InfraWorkloadRegistry;\n}\n\nexport type InfraModuleId = string;\n\nexport interface InfraModuleSpec {\n  readonly config?: DataContractValue;\n}\n\nexport type InfraModuleRegistry = EntityRegistry<InfraModuleId, InfraModuleSpec>;\n\nexport interface InfraManifest {\n  readonly environments: Readonly<\n    Record<'local', InfraEnvironmentSpec> &\n      Partial<Record<Exclude<AppEnvironmentId, 'local'>, InfraEnvironmentSpec>>\n  >;\n  readonly apis?: ApiDefinitionRegistry;\n  readonly modules: InfraModuleRegistry;\n}\n"]}

package/dist/types/infraWorkload.d.ts

@@ -1,4 +1,4 @@
-import type { SerializableSet } from '../collections';
+import type { EntityRegistry, SerializableSet, ValueMap } from '../collections';
 import type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets';
 export interface InfraWorkloadArtifact {
     readonly kind: 'image';
@@ -60,16 +60,16 @@ export interface InfraWorkloadVolumeSpec {
     readonly retention: 'retain' | 'delete-on-destroy';
 }
 export type InfraWorkloadId = string;
-export type InfraWorkloadPortRegistry = Readonly<Record<string, InfraWorkloadPort>>;
-export type InfraWorkloadFileMap = Readonly<Record<string, InfraWorkloadValue>>;
-export type InfraWorkloadVolumeRegistry = Readonly<Record<string, InfraWorkloadVolumeSpec>>;
+export type InfraWorkloadPortRegistry = EntityRegistry<string, InfraWorkloadPort>;
+export type InfraWorkloadFileMap = ValueMap<string, InfraWorkloadValue>;
+export type InfraWorkloadVolumeRegistry = EntityRegistry<string, InfraWorkloadVolumeSpec, 'id'>;
 export interface InfraWorkloadSpec {
     readonly id: InfraWorkloadId;
     readonly artifact: InfraWorkloadArtifact;
     readonly command?: readonly string[];
     readonly args?: readonly string[];
     readonly ports?: InfraWorkloadPortRegistry;
-    readonly environment?: Readonly<Record<string, InfraWorkloadValue>>;
+    readonly environment?: ValueMap<string, InfraWorkloadValue>;
     readonly files?: InfraWorkloadFileMap;
     readonly health?: InfraWorkloadHealthSpec;
     readonly resources?: InfraWorkloadResourceSpec;
@@ -79,5 +79,5 @@ export interface InfraWorkloadSpec {
     /** IDs in the composed desired-state graph; the orchestrator validates missing/cyclic edges. */
     readonly dependsOn?: SerializableSet;
 }
-export type InfraWorkloadRegistry = Readonly<Record<InfraWorkloadId, InfraWorkloadSpec>>;
+export type InfraWorkloadRegistry = EntityRegistry<InfraWorkloadId, InfraWorkloadSpec, 'id'>;
 //# sourceMappingURL=infraWorkload.d.ts.map

package/dist/types/infraWorkload.d.ts.map

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

package/dist/types/infraWorkload.js.map

@@ -1 +1 @@
-{"version":3,"file":"infraWorkload.js","sourceRoot":"","sources":["../../src/types/infraWorkload.ts"],"names":[],"mappings":"","sourcesContent":["import type { SerializableSet } from '../collections';\nimport type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets';\n\nexport interface InfraWorkloadArtifact {\n  readonly kind: 'image';\n  /** Prebuilt image, optionally pinned by digest. No registry/build provider requirement. */\n  readonly image: string;\n}\n\nexport type InfraWorkloadScalarValue =\n  | { readonly kind: 'literal'; readonly value: string }\n  | { readonly kind: 'secret'; readonly reference: InfraSecretReference }\n  | {\n      readonly kind: 'credential';\n      readonly reference: InfraControlPlaneCredentialRef;\n      readonly key: string;\n    }\n  | { readonly kind: 'output'; readonly resourceId: string; readonly output: string };\n\nexport type InfraWorkloadValue =\n  | InfraWorkloadScalarValue\n  | {\n      readonly kind: 'template';\n      /** Ordered scalar segments materialized into one value only at the runtime boundary. */\n      readonly segments: readonly InfraWorkloadScalarValue[];\n    };\n\nexport interface InfraWorkloadPort {\n  readonly port: number;\n  readonly protocol?: 'tcp' | 'udp';\n  /** Exact external listener port requested for a public single-replica workload. */\n  readonly publishedPort?: number;\n}\n\nexport type InfraWorkloadHealthSpec = {\n  readonly intervalSeconds?: number;\n  readonly timeoutSeconds?: number;\n  readonly failureThreshold?: number;\n} & (\n  | { readonly kind: 'http'; readonly port: number; readonly path: string }\n  | { readonly kind: 'tcp'; readonly port: number }\n  | { readonly kind: 'command'; readonly command: readonly string[] }\n);\n\nexport interface InfraWorkloadResourceSpec {\n  readonly cpuMillis?: number;\n  readonly memoryMiB?: number;\n}\n\nexport interface InfraWorkloadVolumeSpec {\n  readonly id: string;\n  readonly mountPath: string;\n  readonly sizeGiB: number;\n  /** Seed a newly created empty volume from the image contents at mountPath before workload start. */\n  readonly seed?: 'image';\n  /** Persistence survives down and is retained by default on destroy. */\n  readonly retention: 'retain' | 'delete-on-destroy';\n}\n\nexport type InfraWorkloadId = string;\nexport type InfraWorkloadPortRegistry = Readonly<Record<string, InfraWorkloadPort>>;\nexport type InfraWorkloadFileMap = Readonly<Record<string, InfraWorkloadValue>>;\nexport type InfraWorkloadVolumeRegistry = Readonly<Record<string, InfraWorkloadVolumeSpec>>;\n\nexport interface InfraWorkloadSpec {\n  readonly id: InfraWorkloadId;\n  readonly artifact: InfraWorkloadArtifact;\n  readonly command?: readonly string[];\n  readonly args?: readonly string[];\n  readonly ports?: InfraWorkloadPortRegistry;\n  readonly environment?: Readonly<Record<string, InfraWorkloadValue>>;\n  readonly files?: InfraWorkloadFileMap;\n  readonly health?: InfraWorkloadHealthSpec;\n  readonly resources?: InfraWorkloadResourceSpec;\n  readonly persistence?: InfraWorkloadVolumeRegistry;\n  readonly exposure?: 'internal' | 'public';\n  readonly replicas?: number;\n  /** IDs in the composed desired-state graph; the orchestrator validates missing/cyclic edges. */\n  readonly dependsOn?: SerializableSet;\n}\n\nexport type InfraWorkloadRegistry = Readonly<Record<InfraWorkloadId, InfraWorkloadSpec>>;\n"]}
+{"version":3,"file":"infraWorkload.js","sourceRoot":"","sources":["../../src/types/infraWorkload.ts"],"names":[],"mappings":"","sourcesContent":["import type { EntityRegistry, SerializableSet, ValueMap } from '../collections';\nimport type { InfraControlPlaneCredentialRef, InfraSecretReference } from './infraSecrets';\n\nexport interface InfraWorkloadArtifact {\n  readonly kind: 'image';\n  /** Prebuilt image, optionally pinned by digest. No registry/build provider requirement. */\n  readonly image: string;\n}\n\nexport type InfraWorkloadScalarValue =\n  | { readonly kind: 'literal'; readonly value: string }\n  | { readonly kind: 'secret'; readonly reference: InfraSecretReference }\n  | {\n      readonly kind: 'credential';\n      readonly reference: InfraControlPlaneCredentialRef;\n      readonly key: string;\n    }\n  | { readonly kind: 'output'; readonly resourceId: string; readonly output: string };\n\nexport type InfraWorkloadValue =\n  | InfraWorkloadScalarValue\n  | {\n      readonly kind: 'template';\n      /** Ordered scalar segments materialized into one value only at the runtime boundary. */\n      readonly segments: readonly InfraWorkloadScalarValue[];\n    };\n\nexport interface InfraWorkloadPort {\n  readonly port: number;\n  readonly protocol?: 'tcp' | 'udp';\n  /** Exact external listener port requested for a public single-replica workload. */\n  readonly publishedPort?: number;\n}\n\nexport type InfraWorkloadHealthSpec = {\n  readonly intervalSeconds?: number;\n  readonly timeoutSeconds?: number;\n  readonly failureThreshold?: number;\n} & (\n  | { readonly kind: 'http'; readonly port: number; readonly path: string }\n  | { readonly kind: 'tcp'; readonly port: number }\n  | { readonly kind: 'command'; readonly command: readonly string[] }\n);\n\nexport interface InfraWorkloadResourceSpec {\n  readonly cpuMillis?: number;\n  readonly memoryMiB?: number;\n}\n\nexport interface InfraWorkloadVolumeSpec {\n  readonly id: string;\n  readonly mountPath: string;\n  readonly sizeGiB: number;\n  /** Seed a newly created empty volume from the image contents at mountPath before workload start. */\n  readonly seed?: 'image';\n  /** Persistence survives down and is retained by default on destroy. */\n  readonly retention: 'retain' | 'delete-on-destroy';\n}\n\nexport type InfraWorkloadId = string;\nexport type InfraWorkloadPortRegistry = EntityRegistry<string, InfraWorkloadPort>;\nexport type InfraWorkloadFileMap = ValueMap<string, InfraWorkloadValue>;\nexport type InfraWorkloadVolumeRegistry = EntityRegistry<string, InfraWorkloadVolumeSpec, 'id'>;\n\nexport interface InfraWorkloadSpec {\n  readonly id: InfraWorkloadId;\n  readonly artifact: InfraWorkloadArtifact;\n  readonly command?: readonly string[];\n  readonly args?: readonly string[];\n  readonly ports?: InfraWorkloadPortRegistry;\n  readonly environment?: ValueMap<string, InfraWorkloadValue>;\n  readonly files?: InfraWorkloadFileMap;\n  readonly health?: InfraWorkloadHealthSpec;\n  readonly resources?: InfraWorkloadResourceSpec;\n  readonly persistence?: InfraWorkloadVolumeRegistry;\n  readonly exposure?: 'internal' | 'public';\n  readonly replicas?: number;\n  /** IDs in the composed desired-state graph; the orchestrator validates missing/cyclic edges. */\n  readonly dependsOn?: SerializableSet;\n}\n\nexport type InfraWorkloadRegistry = EntityRegistry<InfraWorkloadId, InfraWorkloadSpec, 'id'>;\n"]}

package/dist/types.d.ts

@@ -2,6 +2,7 @@ import type { ColorHarmony } from '@ankhorage/color-theory';
 import type { SplashScreenSpec } from './appManifest/splashScreen';
 import type { AuthIdentifierKind, AuthSignUpField } from './auth';
 import type { BindingValueSource, ComponentDataBindingRegistry, ScreenDataLoaderDefinition } from './bindings';
+import type { EntityRegistry } from './collections';
 import type { DataSourceRegistry } from './data';
 import type { AppDeployManifest } from './deploy';
 import type { InfraManifest } from './infra';
@@ -27,7 +28,7 @@ export interface ThemeConfig {
     /** Component/pattern recipe override values; recipe schemas remain package-owned metadata. */
     recipes?: ThemeRecipeOverrides;
 }
-export type ThemeRegistry = Readonly<Record<ThemeId, ThemeConfig>>;
+export type ThemeRegistry = EntityRegistry<ThemeId, ThemeConfig, 'id'>;
 export type ActionType = 'navigate' | 'alert' | 'console' | 'toggleDarkMode' | 'setLanguage' | 'search' | 'filter';
 export interface NavigateAction {
     type: 'navigate';
@@ -189,7 +190,7 @@ export interface AppManifest {
     state?: AppStateSpec;
     infra: InfraManifest;
     navigator: AppNavigatorManifest;
-    screens: Readonly<Record<string, ScreenSpec>>;
+    screens: EntityRegistry<string, ScreenSpec, 'id'>;
     dataSources?: DataSourceRegistry;
     dataBindings?: ComponentDataBindingRegistry;
     repository?: RepositoryManifest;

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":"AA4IA,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 { 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 = Readonly<Record<ThemeId, ThemeConfig>>;\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: Readonly<Record<string, ScreenSpec>>;\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 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "22.0.3",
+  "version": "22.1.0",
   "main": "./dist/index.js",
   "ankh": {
     "category": "contracts",
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@ankhorage/color-theory": "^0.3.1",
-    "@ankhorage/utility": "^1.2.0"
+    "@ankhorage/utility": "^1.4.0"
   },
   "devDependencies": {
     "@ankhorage/devtools": "^1.12.0",
@@ -92,6 +92,10 @@
     "./repository": {
       "types": "./dist/repository.d.ts",
       "default": "./dist/repository.js"
+    },
+    "./structure": {
+      "types": "./dist/structure/index.d.ts",
+      "default": "./dist/structure/index.js"
     }
   },
   "description": "Serializable app, action, theme, auth, and secret-store contracts for Ankhorage.",

package/src/auth.ts

@@ -1,3 +1,4 @@
+import type { ValueMap } from './collections';
 import type { AppDeployTargetId } from './deploy';
 import type { AppEnvironmentId } from './environments';
 import type { SecretRef } from './secrets';
@@ -301,7 +302,7 @@ export interface StartOAuthAuthorizationInput {
   provider: AuthOAuthProviderId;
   redirectUri: string;
   scopes?: readonly string[];
-  queryParams?: Readonly<Record<string, string>>;
+  queryParams?: ValueMap<string, string>;
 }
 
 export interface AuthOAuthAuthorizationRequest {

package/src/bindings.ts

@@ -1,3 +1,4 @@
+import type { EntityRegistry, ValueMap } from './collections';
 import type { ApiId, EndpointId, OperationId } from './data';
 import type { SerializableValue } from './serializable';
 
@@ -77,7 +78,7 @@ export type BindingInputValue =
     }
   | {
       readonly kind: 'object';
-      readonly fields: Readonly<Record<string, BindingInputValue>>;
+      readonly fields: ValueMap<string, BindingInputValue>;
     }
   | {
       readonly kind: 'source';
@@ -85,7 +86,7 @@ export type BindingInputValue =
       readonly transforms?: readonly BindingValueTransform[];
     };
 
-export type BindingInputMap = Readonly<Record<string, BindingInputValue>>;
+export type BindingInputMap = ValueMap<string, BindingInputValue>;
 
 export interface OperationScreenDataLoaderDefinition {
   readonly kind: 'operation';
@@ -123,10 +124,12 @@ export interface EventBinding {
 export interface ComponentDataBinding {
   readonly componentId: ComponentInstanceId;
   readonly componentType?: ComponentTypeId;
-  readonly props?: Readonly<Record<string, PropBinding>>;
-  readonly events?: Readonly<Record<string, readonly EventBinding[]>>;
+  readonly props?: ValueMap<string, PropBinding>;
+  readonly events?: ValueMap<string, readonly EventBinding[]>;
 }
 
-export type ComponentDataBindingRegistry = Readonly<
-  Record<ComponentInstanceId, ComponentDataBinding>
+export type ComponentDataBindingRegistry = EntityRegistry<
+  ComponentInstanceId,
+  ComponentDataBinding,
+  'componentId'
 >;

package/src/collections.ts

@@ -1,5 +1,15 @@
 import { isRecord } from '@ankhorage/utility/object';
 
+/** Stable keyed entities whose collection identity is carried by the record key. */
+export type EntityRegistry<
+  TKey extends string,
+  TValue,
+  TIdentityField extends Extract<keyof TValue, string> = never,
+> = Readonly<Record<TKey, TValue>> & Readonly<Record<never, TIdentityField>>;
+
+/** Keyed configuration/property values whose key is part of the value's meaning. */
+export type ValueMap<TKey extends string, TValue> = Readonly<Record<TKey, TValue>>;
+
 export type SerializableSet<T extends string = string> = Readonly<Partial<Record<T, true>>>;
 
 /*** Validate the canonical JSON-safe representation for unordered string membership. */

package/src/data/apis.ts

@@ -1,3 +1,4 @@
+import type { EntityRegistry } from '../collections';
 import type { DataEndpointRegistry } from './endpoints';
 import type { ApiId } from './ids';
 import type { CredentialRef } from './refs';
@@ -60,4 +61,4 @@ export interface InternalRestApiDefinition extends ApiBaseDefinition {
 export type ApiDefinition =
   ExternalGraphQlApiDefinition | ExternalRestApiDefinition | InternalRestApiDefinition;
 
-export type ApiDefinitionRegistry = Readonly<Record<ApiId, ApiDefinition>>;
+export type ApiDefinitionRegistry = EntityRegistry<ApiId, ApiDefinition, 'id'>;

package/src/data/endpoints.ts

@@ -1,5 +1,6 @@
-import type { EndpointId, OperationId } from './ids';
-import type { DataOperationConfig } from './operations';
+import type { EntityRegistry } from '../collections';
+import type { EndpointId } from './ids';
+import type { DataOperationRegistry } from './operations';
 import type { CredentialRef } from './refs';
 import type { DataContractValue } from './values';
 
@@ -13,8 +14,8 @@ export interface DataEndpointConfig {
   readonly baseUrl?: string;
   readonly path?: string;
   readonly credential?: CredentialRef;
-  readonly operations: Readonly<Record<OperationId, DataOperationConfig>>;
+  readonly operations: DataOperationRegistry;
   readonly metadata?: DataContractValue;
 }
 
-export type DataEndpointRegistry = Readonly<Record<EndpointId, DataEndpointConfig>>;
+export type DataEndpointRegistry = EntityRegistry<EndpointId, DataEndpointConfig, 'id'>;

package/src/data/operations.ts

@@ -1,3 +1,4 @@
+import type { EntityRegistry } from '../collections';
 import type { EndpointId, OperationId } from './ids';
 import type { CredentialRef } from './refs';
 import type { DataSchemaSlot } from './schemas';
@@ -56,4 +57,4 @@ export interface DataOperationConfig {
   readonly metadata?: DataContractValue;
 }
 
-export type DataOperationRegistry = Readonly<Record<OperationId, DataOperationConfig>>;
+export type DataOperationRegistry = EntityRegistry<OperationId, DataOperationConfig, 'id'>;

package/src/data/schemas.ts

@@ -1,3 +1,4 @@
+import type { ValueMap } from '../collections';
 import type { SchemaId } from './ids';
 import type { DataContractValue } from './values';
 
@@ -23,7 +24,7 @@ export interface DataSchema {
   readonly format?: string;
   readonly nullable?: boolean;
   readonly required?: readonly string[];
-  readonly properties?: Readonly<Record<string, DataSchema>>;
+  readonly properties?: ValueMap<string, DataSchema>;
   readonly additionalProperties?: boolean | DataSchema;
   readonly items?: DataSchema;
   readonly allOf?: readonly DataSchema[];
@@ -32,7 +33,7 @@ export interface DataSchema {
   readonly ref?: DataSchemaRef;
 }
 
-export type DataSchemaRegistry = Readonly<Record<SchemaId, DataSchema>>;
+export type DataSchemaRegistry = ValueMap<SchemaId, DataSchema>;
 
 export interface DataSchemaSlot {
   readonly schema?: DataSchema;

package/src/data/sources.ts

@@ -1,3 +1,4 @@
+import type { EntityRegistry } from '../collections';
 import type { DataEndpointRegistry } from './endpoints';
 import type { DataSourceId } from './ids';
 import type { CredentialRef, DatabaseAdapterRef } from './refs';
@@ -19,4 +20,4 @@ export interface DatabaseDataSourceConfig {
 }
 
 export type DataSourceConfig = DatabaseDataSourceConfig;
-export type DataSourceRegistry = Readonly<Record<DataSourceId, DataSourceConfig>>;
+export type DataSourceRegistry = EntityRegistry<DataSourceId, DataSourceConfig, 'id'>;

package/src/index.ts

@@ -18,6 +18,7 @@ export * from './secrets';
 export * from './serializable';
 export * from './state';
 export * from './storage';
+export * from './structure';
 export * from './theme';
 export * from './types';
 export * from './ui';

package/src/media.ts

@@ -1,6 +1,8 @@
 import { isRecord } from '@ankhorage/utility/object';
 import { isNonEmptyString } from '@ankhorage/utility/string';
 
+import type { EntityRegistry } from './collections';
+
 export const MEDIA_ASSET_KINDS = ['image', 'audio', 'video', 'font', 'file'] as const;
 
 export type MediaAssetKind = (typeof MEDIA_ASSET_KINDS)[number];
@@ -46,7 +48,7 @@ export interface MediaAsset {
   readonly metadata?: MediaAssetMetadata;
 }
 
-export type MediaAssetRegistry = Readonly<Record<string, MediaAsset>>;
+export type MediaAssetRegistry = EntityRegistry<string, MediaAsset, 'id'>;
 
 /*** App-authoring media pool. Runtime/user-generated uploads do not belong here. */
 export interface MediaManifest {

package/src/navigator.ts

@@ -1,3 +1,4 @@
+import type { ValueMap } from './collections';
 import type { IconSpec, ManifestValue } from './types';
 
 export { isAppNavigatorManifest } from './appManifest/navigator';
@@ -214,7 +215,7 @@ export interface SplitViewNavigatorNode extends NavigatorNodeBase {
 export interface CustomNavigatorNode extends NavigatorNodeBase {
   type: 'custom';
   navigatorId: string;
-  config?: Readonly<Record<string, ManifestValue>>;
+  config?: ValueMap<string, ManifestValue>;
 }
 
 export type NavigatorNode =

package/src/structure/index.ts

@@ -0,0 +1,21 @@
+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';

package/src/structure/isStructureDescriptor.ts

@@ -0,0 +1,163 @@
+import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
+import { isNonEmptyString } from '@ankhorage/utility/string';
+
+import type { StructureDescriptor, StructureLiteralValue, StructureScalarType } from './types';
+
+/*** Validate one standalone structural descriptor without resolving external/local references. */
+export function isStructureDescriptor(value: unknown): value is StructureDescriptor {
+  return isDescriptor(value, new Set());
+}
+
+/*** Validate one descriptor recursively while rejecting cyclic inline object graphs. */
+function isDescriptor(value: unknown, ancestors: Set<object>): value is StructureDescriptor {
+  if (!isRecord(value) || typeof value.kind !== 'string' || ancestors.has(value)) return false;
+  ancestors.add(value);
+  const valid = validateDescriptorKind(value, ancestors);
+  ancestors.delete(value);
+  return valid;
+}
+
+/*** Dispatch descriptor validation by its explicit structural kind. */
+function validateDescriptorKind(value: Record<string, unknown>, ancestors: Set<object>): boolean {
+  switch (value.kind) {
+    case 'scalar':
+      return isScalarDescriptor(value);
+    case 'enum':
+      return isEnumDescriptor(value);
+    case 'object':
+      return isObjectDescriptor(value, ancestors);
+    case 'entity-registry':
+      return isEntityRegistryDescriptor(value, ancestors);
+    case 'value-map':
+      return isValueMapDescriptor(value, ancestors);
+    case 'set':
+      return isSetDescriptor(value, ancestors);
+    case 'ordered-list':
+      return isOrderedListDescriptor(value, ancestors);
+    case 'union':
+      return isUnionDescriptor(value, ancestors);
+    case 'ref':
+      return isReferenceDescriptor(value);
+    default:
+      return false;
+  }
+}
+
+/*** Validate a scalar descriptor and its closed primitive vocabulary. */
+function isScalarDescriptor(value: Record<string, unknown>): boolean {
+  return (
+    hasOnlyKeys(value, ['kind', 'type']) &&
+    typeof value.type === 'string' &&
+    SCALAR_TYPES.has(value.type as StructureScalarType)
+  );
+}
+
+/*** Validate a non-empty finite scalar literal set without duplicate members. */
+function isEnumDescriptor(value: Record<string, unknown>): boolean {
+  if (!hasOnlyKeys(value, ['kind', 'values']) || !Array.isArray(value.values)) return false;
+  if (value.values.length === 0 || !value.values.every(isStructureLiteralValue)) return false;
+  const identities = value.values.map(structureLiteralIdentity);
+  return new Set(identities).size === identities.length;
+}
+
+/*** Validate a fixed-field object descriptor. */
+function isObjectDescriptor(value: Record<string, unknown>, ancestors: Set<object>): boolean {
+  return (
+    hasOnlyKeys(value, ['kind', 'fields']) &&
+    isRecord(value.fields) &&
+    Object.values(value.fields).every((field) => isObjectField(field, ancestors))
+  );
+}
+
+/*** Validate one object field and its optionality marker. */
+function isObjectField(value: unknown, ancestors: Set<object>): boolean {
+  return (
+    isRecord(value) &&
+    hasOnlyKeys(value, ['value', 'optional']) &&
+    (value.optional === undefined || typeof value.optional === 'boolean') &&
+    isDescriptor(value.value, ancestors)
+  );
+}
+
+/*** Validate a stable keyed entity collection descriptor. */
+function isEntityRegistryDescriptor(
+  value: Record<string, unknown>,
+  ancestors: Set<object>,
+): boolean {
+  return (
+    hasOnlyKeys(value, ['kind', 'key', 'value', 'identityField']) &&
+    isStringKeyDescriptor(value.key, ancestors) &&
+    isDescriptor(value.value, ancestors) &&
+    (value.identityField === undefined || isNonEmptyString(value.identityField))
+  );
+}
+
+/*** Validate a keyed property/configuration map descriptor. */
+function isValueMapDescriptor(value: Record<string, unknown>, ancestors: Set<object>): boolean {
+  return (
+    hasOnlyKeys(value, ['kind', 'key', 'value']) &&
+    isStringKeyDescriptor(value.key, ancestors) &&
+    isDescriptor(value.value, ancestors)
+  );
+}
+
+/*** Validate an unordered string-membership descriptor. */
+function isSetDescriptor(value: Record<string, unknown>, ancestors: Set<object>): boolean {
+  return hasOnlyKeys(value, ['kind', 'member']) && isStringKeyDescriptor(value.member, ancestors);
+}
+
+/*** Validate a semantically ordered list descriptor. */
+function isOrderedListDescriptor(value: Record<string, unknown>, ancestors: Set<object>): boolean {
+  return hasOnlyKeys(value, ['kind', 'item']) && isDescriptor(value.item, ancestors);
+}
+
+/*** Validate a union descriptor with at least two valid variants. */
+function isUnionDescriptor(value: Record<string, unknown>, ancestors: Set<object>): boolean {
+  return (
+    hasOnlyKeys(value, ['kind', 'variants', 'discriminator']) &&
+    Array.isArray(value.variants) &&
+    value.variants.length >= 2 &&
+    value.variants.every((variant) => isDescriptor(variant, ancestors)) &&
+    (value.discriminator === undefined || isNonEmptyString(value.discriminator))
+  );
+}
+
+/*** Validate a local or package-qualified descriptor reference. */
+function isReferenceDescriptor(value: Record<string, unknown>): boolean {
+  return (
+    hasOnlyKeys(value, ['kind', 'id', 'packageName']) &&
+    isNonEmptyString(value.id) &&
+    (value.packageName === undefined || isNonEmptyString(value.packageName))
+  );
+}
+
+/*** Validate a descriptor that can represent a JSON object key or set member string. */
+function isStringKeyDescriptor(value: unknown, ancestors: Set<object>): boolean {
+  if (!isDescriptor(value, ancestors)) return false;
+  if (value.kind === 'ref') return true;
+  if (value.kind === 'scalar') return value.type === 'string';
+  return value.kind === 'enum' && value.values.every((member) => typeof member === 'string');
+}
+
+/*** Validate one serializable scalar literal used by finite enum descriptors. */
+function isStructureLiteralValue(value: unknown): value is StructureLiteralValue {
+  return (
+    value === null ||
+    typeof value === 'boolean' ||
+    (typeof value === 'number' && Number.isFinite(value)) ||
+    typeof value === 'string'
+  );
+}
+
+/*** Produce an unambiguous identity for one scalar enum member. */
+function structureLiteralIdentity(value: StructureLiteralValue): string {
+  return value === null ? 'null' : `${typeof value}:${String(value)}`;
+}
+
+const SCALAR_TYPES = new Set<StructureScalarType>([
+  'boolean',
+  'integer',
+  'null',
+  'number',
+  'string',
+]);