halfcode-compiler.xnl 0.2.9 → 0.3.0

package/dist/kind-definition.d.ts

@@ -1,21 +1,129 @@
-import { a as ResourceDescriptor, c as ResourceKindContract } from "./index-CDIT65pI.js";
+import { B as KindSpecRevision, F as KindContractLockReader, G as ReaderProfile, H as KindWriterRegistration, I as KindReaderRegistration, J as ResourceResolutionReceipt, K as ReaderTarget, L as KindSemanticContract, M as JsonSchema, N as JsonSchemaValidator, P as KindContractLock, Pt as Sha256Digest, R as KindSourceContract, U as PortableSpec, V as KindSubjectOwner, W as PortableValue, Y as SpecResolutionDefinition, d as ResolvedResourceTree, f as ResourceDescriptor, h as ResourceKindContract, i as AuthoredResourceTree, j as CompatibilityPolicy, q as ResolvedSpec, tt as SpecVersion, z as KindSourceShape } from "./index-DboIOEr8.js";
+//#region ../kind-definition/src/versioned-contracts.d.ts
+declare class KindContractRegistry {
+  private readonly ownersByKind;
+  private readonly ownersBySubject;
+  private readonly revisionsBySubject;
+  registerOwner(input: KindSubjectOwner): this;
+  registerRevision(input: KindSpecRevision): this;
+  subject(kind: string): KindSubjectOwner;
+  owner(subjectFqn: string): KindSubjectOwner;
+  revision(subjectFqn: string, specVersion: SpecVersion): KindSpecRevision;
+  owners(): readonly KindSubjectOwner[];
+  revisions(subjectFqn?: string): readonly KindSpecRevision[];
+}
+declare class KindWriterRegistry {
+  readonly contracts: KindContractRegistry;
+  private readonly registrations;
+  constructor(contracts: KindContractRegistry);
+  register<Input>(input: KindWriterRegistration<Input>): this;
+  require(subjectFqn: string, writerSpecVersion: SpecVersion): KindWriterRegistration<any>;
+}
+declare class KindReaderRegistry {
+  private readonly registrations;
+  register<Output>(input: KindReaderRegistration<Output>): this;
+  require(target: ReaderTarget): KindReaderRegistration;
+  all(): readonly KindReaderRegistration[];
+}
+declare function createReaderProfile(profileId: string, targets: readonly ReaderTarget[]): ReaderProfile;
+declare class SpecResolutionRegistry {
+  readonly contracts: KindContractRegistry;
+  private readonly definitions;
+  private readonly ids;
+  constructor(contracts: KindContractRegistry);
+  register(input: SpecResolutionDefinition): this;
+  plan(subjectFqn: string, writerSpecVersion: SpecVersion, readerSpecVersion: SpecVersion): readonly SpecResolutionDefinition[];
+  validateGraph(subjectFqn?: string): void;
+  validateReaderCompatibility(registration: KindReaderRegistration): void;
+  all(): readonly SpecResolutionDefinition[];
+  private outgoing;
+}
+declare function resolveSpec<Output = unknown>(input: Readonly<{
+  resourceId: string;
+  kind: string;
+  writerSpecVersion: SpecVersion;
+  authoredSpec: PortableSpec;
+  sourceContentDigest: Sha256Digest;
+  readerProfile: ReaderProfile;
+  contracts: KindContractRegistry;
+  readers: KindReaderRegistry;
+  resolutions: SpecResolutionRegistry;
+  validator: JsonSchemaValidator;
+}>): ResolvedSpec<Output>;
+declare function createKindContractLock(input: Readonly<{
+  envelopeVersion: string;
+  envelopeFingerprint: Sha256Digest;
+  contracts: KindContractRegistry;
+  readerProfile: ReaderProfile;
+  readers: KindReaderRegistry;
+  resolutions: SpecResolutionRegistry;
+}>): KindContractLock;
+declare function exactSpecVersion(value: number): SpecVersion;
+declare function createKindSubjectOwner(input: Readonly<{
+  kind: string;
+  subjectFqn: string;
+  ownerPackageId: string;
+  ownerPackageFingerprint: Sha256Digest;
+  sourceShapes: readonly KindSourceShape[];
+  documentCardinality?: "one" | "many";
+  requiredFiles?: readonly string[];
+}>): KindSubjectOwner;
+declare function createKindSpecRevision(input: Readonly<{
+  kind: string;
+  subjectFqn: string;
+  specVersion: SpecVersion;
+  specSchema: JsonSchema;
+  semanticContract: KindSemanticContract;
+  sourceContractFingerprint: Sha256Digest;
+  stability: KindSpecRevision["stability"];
+}>): KindSpecRevision;
+//#endregion
+//#region ../kind-definition/src/resource-tree-resolution.d.ts
+interface ResolveResourceTreeInput {
+  readonly tree: AuthoredResourceTree;
+  readonly readerProfile: ReaderProfile;
+  readonly contracts: KindContractRegistry;
+  readonly readers: KindReaderRegistry;
+  readonly resolutions: SpecResolutionRegistry;
+  readonly validator: JsonSchemaValidator;
+}
+declare function resolveResourceTree(input: ResolveResourceTreeInput): ResolvedResourceTree;
+//#endregion
+//#region ../kind-definition/src/core-kind-contracts.d.ts
+declare const RESOURCE_PACKAGE_KIND_OWNER: KindSubjectOwner;
+declare const KIND_DEFINITION_KIND_OWNER: KindSubjectOwner;
+declare const RESOURCE_PACKAGE_SPEC_SCHEMA_V1: JsonSchema;
+declare const KIND_DEFINITION_SPEC_SCHEMA_V1: JsonSchema;
+declare const RESOURCE_PACKAGE_KIND_SPEC_REVISION_V1: KindSpecRevision;
+declare const KIND_DEFINITION_KIND_SPEC_REVISION_V1: KindSpecRevision;
+declare const CORE_KIND_SUBJECT_OWNERS: readonly [KindSubjectOwner, KindSubjectOwner];
+declare const CORE_KIND_SPEC_REVISIONS: readonly [KindSpecRevision, KindSpecRevision];
+declare const KIND_DEFINITION_KIND_READER_REGISTRATION_V1: KindReaderRegistration<PortableSpec>;
+declare const RESOURCE_PACKAGE_KIND_READER_REGISTRATION_V1: KindReaderRegistration<PortableSpec>;
+declare const CORE_KIND_READER_REGISTRATIONS: readonly [KindReaderRegistration<PortableSpec>, KindReaderRegistration<PortableSpec>];
+declare const CORE_RESOURCE_CONTRACT_REGISTRATIONS: Readonly<{
+  owners: readonly [KindSubjectOwner, KindSubjectOwner];
+  revisions: readonly [KindSpecRevision, KindSpecRevision];
+  readers: readonly [KindReaderRegistration<PortableSpec>, KindReaderRegistration<PortableSpec>];
+}>;
+//#endregion
 //#region ../kind-definition/src/index.d.ts
 interface KindDefinition extends ResourceDescriptor, ResourceKindContract {
   kind: "KindDefinition";
 }
-interface ResourceMigrationDefinition<T> {
+interface ResourceSourceMigrationDefinition<T> {
   id: string;
-  resourceKind: string;
-  fromApiVersion: string;
-  toApiVersion: string;
+  subjectFqn: string;
+  fromWriterSpecVersion: number;
+  toWriterSpecVersion: number;
   migrate: (resource: T) => T;
 }
-declare class ResourceMigrationRegistry<T> {
+declare class ResourceSourceMigrationRegistry<T> {
   private readonly definitions;
   private readonly ids;
-  register(definition: ResourceMigrationDefinition<T>): this;
-  plan(resourceKind: string, fromApiVersion: string, toApiVersion: string): readonly ResourceMigrationDefinition<T>[];
-  migrate(resourceKind: string, fromApiVersion: string, toApiVersion: string, resource: T): T;
+  register(definition: ResourceSourceMigrationDefinition<T>): this;
+  plan(subjectFqn: string, fromWriterSpecVersion: number, toWriterSpecVersion: number): readonly ResourceSourceMigrationDefinition<T>[];
+  migrate(subjectFqn: string, fromWriterSpecVersion: number, toWriterSpecVersion: number, resource: T): T;
 }
 declare const kindDefinitionPackage: {
   readonly role: "framework";
@@ -23,4 +131,4 @@ declare const kindDefinitionPackage: {
   readonly owns: "resource kind validation authority";
 };
 //#endregion
-export { KindDefinition, ResourceMigrationDefinition, ResourceMigrationRegistry, kindDefinitionPackage };
+export { CORE_KIND_READER_REGISTRATIONS, CORE_KIND_SPEC_REVISIONS, CORE_KIND_SUBJECT_OWNERS, CORE_RESOURCE_CONTRACT_REGISTRATIONS, type CompatibilityPolicy, type JsonSchema, type JsonSchemaValidator, KIND_DEFINITION_KIND_OWNER, KIND_DEFINITION_KIND_READER_REGISTRATION_V1, KIND_DEFINITION_KIND_SPEC_REVISION_V1, KIND_DEFINITION_SPEC_SCHEMA_V1, type KindContractLock, type KindContractLockReader, KindContractRegistry, KindDefinition, type KindReaderRegistration, KindReaderRegistry, type KindSemanticContract, type KindSourceContract, type KindSourceShape, type KindSpecRevision, type KindSubjectOwner, type KindWriterRegistration, KindWriterRegistry, type PortableSpec, type PortableValue, RESOURCE_PACKAGE_KIND_OWNER, RESOURCE_PACKAGE_KIND_READER_REGISTRATION_V1, RESOURCE_PACKAGE_KIND_SPEC_REVISION_V1, RESOURCE_PACKAGE_SPEC_SCHEMA_V1, type ReaderProfile, type ReaderTarget, ResolveResourceTreeInput, type ResolvedSpec, type ResourceResolutionReceipt, ResourceSourceMigrationDefinition, ResourceSourceMigrationRegistry, type Sha256Digest, type SpecResolutionDefinition, SpecResolutionRegistry, type SpecVersion, createKindContractLock, createKindSpecRevision, createKindSubjectOwner, createReaderProfile, exactSpecVersion, kindDefinitionPackage, resolveResourceTree, resolveSpec };