@dryvcode/author 0.0.1

package/dist/definitions/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/definitions/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC"}

package/dist/definitions/types/index.js

@@ -0,0 +1,4 @@
+export * from "./spec.js";
+export * from "./parameter.js";
+export * from "./expressions.js";
+//# sourceMappingURL=index.js.map

package/dist/definitions/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/definitions/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC"}

package/dist/definitions/types/parameter.d.ts

@@ -0,0 +1,9 @@
+import type { TypeParameterState } from "../../contracts/index.js";
+export declare class TypeParameter<const N extends string = string> {
+    readonly name: N;
+    readonly description?: string;
+    constructor(name: N, description?: string);
+    toState(): TypeParameterState;
+}
+export declare function typeParameter<const N extends string>(name: N, description?: string): TypeParameter<N>;
+//# sourceMappingURL=parameter.d.ts.map

package/dist/definitions/types/parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.d.ts","sourceRoot":"","sources":["../../../src/definitions/types/parameter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,qBAAa,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACxD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,YAAY,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,EAMxC;IAED,OAAO,IAAI,kBAAkB,CAO5B;CACF;AAED,wBAAgB,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAClD,IAAI,EAAE,CAAC,EACP,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CAAC,CAAC,CAAC,CAElB"}

package/dist/definitions/types/parameter.js

@@ -0,0 +1,24 @@
+export class TypeParameter {
+    name;
+    description;
+    constructor(name, description) {
+        if (!name.trim()) {
+            throw new TypeError("type parameter name must not be empty");
+        }
+        this.name = name;
+        if (description !== undefined)
+            this.description = description;
+    }
+    toState() {
+        return {
+            name: this.name,
+            ...(this.description === undefined
+                ? {}
+                : { description: this.description }),
+        };
+    }
+}
+export function typeParameter(name, description) {
+    return new TypeParameter(name, description);
+}
+//# sourceMappingURL=parameter.js.map

package/dist/definitions/types/parameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.js","sourceRoot":"","sources":["../../../src/definitions/types/parameter.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACf,IAAI,CAAI;IACR,WAAW,CAAU;IAE9B,YAAY,IAAO,EAAE,WAAoB;QACvC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChE,CAAC;IAED,OAAO;QACL,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;SACvC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAC3B,IAAO,EACP,WAAoB;IAEpB,OAAO,IAAI,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAC9C,CAAC"}

package/dist/definitions/types/spec.d.ts

@@ -0,0 +1,26 @@
+import type { CanonicalValue, LengthConstraintState, PresenceState, TypeExpressionState, ValueSpecState } from "../../contracts/index.js";
+export type SpecMap = Readonly<Record<string, TypeSpec<unknown>>>;
+export type InferSpec<T> = T extends TypeSpec<infer V> ? V : never;
+export type InferSpecMap<T extends SpecMap> = {
+    readonly [K in keyof T]: InferSpec<T[K]>;
+};
+export declare class TypeSpec<T> {
+    #private;
+    private readonly _presence;
+    private readonly _default;
+    readonly __type?: T;
+    constructor(type: TypeExpressionState, usage?: {
+        readonly presence?: PresenceState;
+        readonly default?: CanonicalValue;
+    });
+    toTypeState(): TypeExpressionState;
+    toState(): ValueSpecState;
+    required(): TypeSpec<Exclude<T, undefined>>;
+    optional(): TypeSpec<T | undefined>;
+    inheritPresence(): TypeSpec<T>;
+    nullable(): TypeSpec<T | null>;
+    array(length?: LengthConstraintState): TypeSpec<readonly T[]>;
+    default(value: CanonicalValue): TypeSpec<T>;
+}
+export declare function mapSpecs(values: SpecMap): Record<string, ReturnType<TypeSpec<unknown>["toState"]>>;
+//# sourceMappingURL=spec.d.ts.map

package/dist/definitions/types/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/definitions/types/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACnE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,IAAI;IAC5C,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC,CAAC;AAEF,qBAAa,QAAQ,CAAC,CAAC;;IAErB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,SAAiB,MAAM,CAAC,EAAE,CAAC,CAAC;IAE5B,YACE,IAAI,EAAE,mBAAmB,EACzB,KAAK,GAAE;QACL,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;QAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;KAC9B,EAKP;IAED,WAAW,IAAI,mBAAmB,CAOjC;IAED,OAAO,IAAI,cAAc,CAMxB;IAED,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAK1C;IAED,QAAQ,IAAI,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAKlC;IAED,eAAe,IAAI,QAAQ,CAAC,CAAC,CAAC,CAK7B;IAED,QAAQ,IAAI,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,CAW7B;IAED,KAAK,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAY5D;IAED,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,CAK1C;CACF;AAED,wBAAgB,QAAQ,CACtB,MAAM,EAAE,OAAO,GACd,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAM1D"}

package/dist/definitions/types/spec.js

@@ -0,0 +1,74 @@
+export class TypeSpec {
+    #type;
+    _presence;
+    _default;
+    constructor(type, usage = {}) {
+        this.#type = type;
+        this._presence = usage.presence ?? "required";
+        this._default = usage.default;
+    }
+    toTypeState() {
+        if (this._presence !== "required" || this._default !== undefined) {
+            throw new TypeError("value usage modifiers are not valid in a pure type position");
+        }
+        return this.#type;
+    }
+    toState() {
+        return {
+            type: this.#type,
+            presence: this._presence,
+            ...(this._default === undefined ? {} : { default: this._default }),
+        };
+    }
+    required() {
+        return new TypeSpec(this.#type, {
+            presence: "required",
+            ...(this._default === undefined ? {} : { default: this._default }),
+        });
+    }
+    optional() {
+        return new TypeSpec(this.#type, {
+            presence: "optional",
+            ...(this._default === undefined ? {} : { default: this._default }),
+        });
+    }
+    inheritPresence() {
+        return new TypeSpec(this.#type, {
+            presence: "inherit",
+            ...(this._default === undefined ? {} : { default: this._default }),
+        });
+    }
+    nullable() {
+        if (this.#type.kind === "nullable") {
+            return this;
+        }
+        return new TypeSpec({ kind: "nullable", value: this.#type }, {
+            presence: this._presence,
+            ...(this._default === undefined ? {} : { default: this._default }),
+        });
+    }
+    array(length) {
+        return new TypeSpec({
+            kind: "array",
+            items: this.#type,
+            ...(length === undefined ? {} : { length: { ...length } }),
+        }, {
+            presence: this._presence,
+            ...(this._default === undefined ? {} : { default: this._default }),
+        });
+    }
+    default(value) {
+        return new TypeSpec(this.#type, {
+            presence: this._presence,
+            default: value,
+        });
+    }
+}
+export function mapSpecs(values) {
+    const mapped = {};
+    for (const key of Object.keys(values).sort()) {
+        mapped[key] = values[key].toState();
+    }
+    return mapped;
+}
+//# sourceMappingURL=spec.js.map

package/dist/definitions/types/spec.js.map

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

package/dist/foundation/declaration.d.ts

@@ -0,0 +1,24 @@
+import type { AuthorSourceLocation, DeclarationKind, DeclarationRef } from "../contracts/index.js";
+import type { FeatureDeclaration } from "../composition/feature.js";
+import type { GroupDeclaration } from "./group.js";
+export declare abstract class Declaration<K extends DeclarationKind> {
+    readonly identity: symbol;
+    readonly kind: K;
+    protected _origin?: AuthorSourceLocation;
+    protected _group?: GroupDeclaration;
+    protected _feature?: FeatureDeclaration;
+    constructor(kind: K);
+    /** Internal identity reference used by registered refs and snapshot lowering. */
+    ref(): DeclarationRef<K>;
+    origin(location: AuthorSourceLocation): this;
+    /** @internal Group registration owns declaration membership. */
+    _registerGroup(value: GroupDeclaration): void;
+    /** @internal Feature registration names the owning Feature inside the owning Group. */
+    _registerFeature(value: FeatureDeclaration): void;
+    abstract toState(): {
+        readonly identity: symbol;
+        readonly kind: K;
+        readonly origin?: AuthorSourceLocation;
+    };
+}
+//# sourceMappingURL=declaration.d.ts.map

package/dist/foundation/declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/foundation/declaration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,8BAAsB,WAAW,CAAC,CAAC,SAAS,eAAe;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,SAAS,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACzC,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAExC,YAAY,IAAI,EAAE,CAAC,EAGlB;IAED,iFAAiF;IACjF,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC,CAEvB;IAED,MAAM,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAY3C;IAED,gEAAgE;IAChE,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAK5C;IAED,uFAAuF;IACvF,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAOhD;IAED,QAAQ,CAAC,OAAO,IAAI;QAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;KACxC,CAAC;CACH"}

package/dist/foundation/declaration.js

@@ -0,0 +1,43 @@
+export class Declaration {
+    identity;
+    kind;
+    _origin;
+    _group;
+    _feature;
+    constructor(kind) {
+        this.kind = kind;
+        this.identity = Symbol(`dryv.${kind}`);
+    }
+    /** Internal identity reference used by registered refs and snapshot lowering. */
+    ref() {
+        return { kind: this.kind, identity: this.identity };
+    }
+    origin(location) {
+        if (!location.path.trim()) {
+            throw new TypeError("origin path must not be empty");
+        }
+        if (location.line !== undefined && location.line < 1) {
+            throw new TypeError("origin line must be >= 1");
+        }
+        if (location.column !== undefined && location.column < 1) {
+            throw new TypeError("origin column must be >= 1");
+        }
+        this._origin = { ...location };
+        return this;
+    }
+    /** @internal Group registration owns declaration membership. */
+    _registerGroup(value) {
+        if (this._group !== undefined && this._group !== value) {
+            throw new TypeError("declaration is already registered in another group");
+        }
+        this._group = value;
+    }
+    /** @internal Feature registration names the owning Feature inside the owning Group. */
+    _registerFeature(value) {
+        if (this._feature !== undefined && this._feature !== value) {
+            throw new TypeError("declaration is already registered in another feature");
+        }
+        this._feature = value;
+    }
+}
+//# sourceMappingURL=declaration.js.map

package/dist/foundation/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/foundation/declaration.ts"],"names":[],"mappings":"AASA,MAAM,OAAgB,WAAW;IACtB,QAAQ,CAAS;IACjB,IAAI,CAAI;IACP,OAAO,CAAwB;IAC/B,MAAM,CAAoB;IAC1B,QAAQ,CAAsB;IAExC,YAAY,IAAO;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,iFAAiF;IACjF,GAAG;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,QAA8B;QACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gEAAgE;IAChE,cAAc,CAAC,KAAuB;QACpC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACvD,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,uFAAuF;IACvF,gBAAgB,CAAC,KAAyB;QACxC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC3D,MAAM,IAAI,SAAS,CACjB,sDAAsD,CACvD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;CAOF"}

package/dist/foundation/group.d.ts

@@ -0,0 +1,55 @@
+import type { ExplanationKindState, GroupState } from "../contracts/index.js";
+import type { SchemaFieldMap } from "../definitions/schemas/field.js";
+import type { SchemaDeclaration } from "../definitions/schemas/schema.js";
+import { FeatureDeclaration } from "../composition/feature.js";
+import { Declaration } from "./declaration.js";
+import { PolicyRef, type RefMap } from "./ref.js";
+import { type ScopeFacetsInput } from "./scope.js";
+import { type GroupRegistryName, type RegistryMap, type RegistrySpec } from "../project/registry.js";
+type PropertyDeclaration = Declaration<"primitive"> | Declaration<"enum"> | Declaration<"composite"> | Declaration<"literal"> | Declaration<"union"> | Declaration<"record"> | Declaration<"tuple"> | Declaration<"generic"> | Declaration<"temporal">;
+/** Registries whose declarations a Feature may own (see decision 0011). */
+export type FeatureOwnedRegistry = "schemas" | "expressions" | "policies" | "failures" | "events" | "operations" | "views" | "workflows";
+export interface GroupOptions {
+    readonly name: string;
+}
+export declare class GroupDeclaration extends Declaration<"group"> {
+    #private;
+    private _parent?;
+    private _description?;
+    private _policies;
+    private _scopeFacets?;
+    private _tags;
+    private _explanations;
+    constructor(options: GroupOptions);
+    groupName(): string;
+    parent(value: GroupDeclaration): this;
+    description(value: string): this;
+    tags(...values: readonly string[]): this;
+    explain(kind: ExplanationKindState, text: string): this;
+    properties<T extends Readonly<Record<string, PropertyDeclaration>>>(values: T, owner?: FeatureDeclaration): RefMap<T>;
+    schemas<T extends Readonly<Record<string, SchemaDeclaration<SchemaFieldMap, SchemaFieldMap>>>>(values: T): RefMap<T>;
+    expressions<T extends RegistryMap<"expressions">>(values: T): RefMap<T>;
+    policies<T extends RegistryMap<"policies">>(values: T): RefMap<T>;
+    policies(...values: PolicyRef[]): this;
+    failures<T extends RegistryMap<"failures">>(values: T): RefMap<T>;
+    events<T extends RegistryMap<"events">>(values: T): RefMap<T>;
+    operations<T extends RegistryMap<"operations">>(values: T): RefMap<T>;
+    views<T extends RegistryMap<"views">>(values: T): RefMap<T>;
+    workflows<T extends RegistryMap<"workflows">>(values: T): RefMap<T>;
+    facets(value: ScopeFacetsInput): this;
+    surfaces<T extends RegistryMap<"surfaces">>(values: T): RefMap<T>;
+    features<T extends RegistryMap<"features">>(values: T): RefMap<T>;
+    /** Register one Feature in this Group and return it as a registration scope. */
+    feature(name: string): FeatureDeclaration;
+    /**
+     * @internal Register declarations owned by a Feature of this Group.
+     * Registration names stay group-scoped; the Feature is the declaration's owner.
+     */
+    _registerOwned<R extends FeatureOwnedRegistry, T extends RegistryMap<R>>(registry: R, values: T, owner: FeatureDeclaration): RefMap<T>;
+    applications<T extends RegistryMap<"applications">>(values: T): RefMap<T>;
+    _entries<R extends GroupRegistryName>(registry: R): readonly (readonly [string, RegistrySpec[R]])[];
+    toState(): GroupState;
+}
+export declare function group(options: GroupOptions): GroupDeclaration;
+export {};
+//# sourceMappingURL=group.d.ts.map

package/dist/foundation/group.d.ts.map

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

package/dist/foundation/group.js

@@ -0,0 +1,199 @@
+import { FeatureDeclaration } from "../composition/feature.js";
+import { Declaration } from "./declaration.js";
+import { createRef, PolicyRef } from "./ref.js";
+import { explanation, normalizeTags, optionalDescription, optionalOrigin, optionalSemanticMetadata, requireText, } from "./metadata.js";
+import { normalizeScopeFacets, } from "./scope.js";
+import { expectedKinds, requireScopedKey, } from "../project/registry.js";
+function propertyRegistry(kind) {
+    switch (kind) {
+        case "primitive":
+            return "primitives";
+        case "enum":
+            return "enums";
+        case "composite":
+            return "composites";
+        case "literal":
+            return "literals";
+        case "union":
+            return "unions";
+        case "record":
+            return "records";
+        case "tuple":
+            return "tuples";
+        case "generic":
+            return "generics";
+        case "temporal":
+            return "temporal";
+    }
+}
+export class GroupDeclaration extends Declaration {
+    #name;
+    _parent;
+    _description;
+    _policies = [];
+    _scopeFacets;
+    _tags = [];
+    _explanations = [];
+    #registries;
+    #identities = new Map();
+    constructor(options) {
+        super("group");
+        this.#name = requireScopedKey(options.name, "group name");
+        this.#registries = {
+            primitives: new Map(),
+            enums: new Map(),
+            composites: new Map(),
+            literals: new Map(),
+            unions: new Map(),
+            records: new Map(),
+            tuples: new Map(),
+            generics: new Map(),
+            temporal: new Map(),
+            schemas: new Map(),
+            expressions: new Map(),
+            policies: new Map(),
+            failures: new Map(),
+            events: new Map(),
+            operations: new Map(),
+            views: new Map(),
+            workflows: new Map(),
+            surfaces: new Map(),
+            features: new Map(),
+            applications: new Map(),
+        };
+    }
+    groupName() {
+        return this.#name;
+    }
+    parent(value) {
+        if (value === this)
+            throw new TypeError("group cannot be its own parent");
+        this._parent = value;
+        return this;
+    }
+    description(value) {
+        this._description = requireText(value, "group description");
+        return this;
+    }
+    tags(...values) {
+        this._tags = [...normalizeTags(values, "group tags")];
+        return this;
+    }
+    explain(kind, text) {
+        this._explanations.push(explanation(kind, text, "group explanation"));
+        return this;
+    }
+    #register(registry, values, owner) {
+        const expected = expectedKinds[registry];
+        const refs = {};
+        for (const [name, declaration] of Object.entries(values).sort(([a], [b]) => a.localeCompare(b))) {
+            requireScopedKey(name, `${registry} registration name`);
+            if (declaration.kind !== expected) {
+                throw new TypeError(`invalid ${registry} registration for ${name}: expected ${expected}, received ${declaration.kind}`);
+            }
+            if (this.#registries[registry].has(name)) {
+                throw new TypeError(`duplicate ${this.#name}.${registry} registration name: ${name}`);
+            }
+            const prior = this.#identities.get(declaration.identity);
+            if (prior !== undefined) {
+                throw new TypeError(`declaration already registered as ${this.#name}.${prior.registry}.${prior.name}; cannot also register as ${registry}.${name}`);
+            }
+            declaration._registerGroup(this);
+            if (owner !== undefined)
+                declaration._registerFeature(owner);
+            this.#registries[registry].set(name, declaration);
+            this.#identities.set(declaration.identity, { registry, name });
+            refs[name] = createRef(declaration);
+        }
+        return refs;
+    }
+    properties(values, owner) {
+        const refs = {};
+        for (const [name, declaration] of Object.entries(values).sort(([a], [b]) => a.localeCompare(b))) {
+            const registry = propertyRegistry(declaration.kind);
+            const registered = this.#register(registry, {
+                [name]: declaration,
+            }, owner);
+            refs[name] = registered[name];
+        }
+        return refs;
+    }
+    schemas(values) {
+        return this.#register("schemas", values);
+    }
+    expressions(values) {
+        return this.#register("expressions", values);
+    }
+    policies(first, ...rest) {
+        if (first === undefined || first instanceof PolicyRef) {
+            this._policies = first === undefined ? [] : [first, ...rest];
+            return this;
+        }
+        if (rest.length > 0) {
+            throw new TypeError("policy registration cannot include scope policy refs");
+        }
+        return this.#register("policies", first);
+    }
+    failures(values) {
+        return this.#register("failures", values);
+    }
+    events(values) {
+        return this.#register("events", values);
+    }
+    operations(values) {
+        return this.#register("operations", values);
+    }
+    views(values) {
+        return this.#register("views", values);
+    }
+    workflows(values) {
+        return this.#register("workflows", values);
+    }
+    facets(value) {
+        this._scopeFacets = normalizeScopeFacets(value);
+        return this;
+    }
+    surfaces(values) {
+        return this.#register("surfaces", values);
+    }
+    features(values) {
+        return this.#register("features", values);
+    }
+    /** Register one Feature in this Group and return it as a registration scope. */
+    feature(name) {
+        const declaration = new FeatureDeclaration();
+        this.#register("features", {
+            [name]: declaration,
+        });
+        return declaration;
+    }
+    /**
+     * @internal Register declarations owned by a Feature of this Group.
+     * Registration names stay group-scoped; the Feature is the declaration's owner.
+     */
+    _registerOwned(registry, values, owner) {
+        return this.#register(registry, values, owner);
+    }
+    applications(values) {
+        return this.#register("applications", values);
+    }
+    _entries(registry) {
+        return [...this.#registries[registry]].sort(([a], [b]) => a.localeCompare(b));
+    }
+    toState() {
+        return {
+            identity: this.identity,
+            kind: "group",
+            ...(this._parent === undefined ? {} : { parent: this._parent.ref() }),
+            policies: this._policies.map((value) => value.ref()),
+            ...(this._scopeFacets === undefined ? {} : { facets: this._scopeFacets }),
+            ...optionalDescription(this._description),
+            ...optionalSemanticMetadata(this._tags, this._explanations),
+            ...optionalOrigin(this._origin),
+        };
+    }
+}
+export function group(options) {
+    return new GroupDeclaration(options);
+}
+//# sourceMappingURL=group.js.map

package/dist/foundation/group.js.map

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

package/dist/foundation/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./declaration.js";
+export * from "./group.js";
+export * from "./metadata.js";
+export * from "./ref.js";
+export * from "./scope.js";
+export * from "./value-declaration.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundation/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC"}

package/dist/foundation/index.js

@@ -0,0 +1,7 @@
+export * from "./declaration.js";
+export * from "./group.js";
+export * from "./metadata.js";
+export * from "./ref.js";
+export * from "./scope.js";
+export * from "./value-declaration.js";
+//# sourceMappingURL=index.js.map

package/dist/foundation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundation/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC"}

package/dist/foundation/metadata.d.ts

@@ -0,0 +1,22 @@
+import type { AuthorSourceLocation, DeclarationRef, ExplanationKindState, ExplanationState, SemanticMetadataState } from "../contracts/index.js";
+import type { FeatureDeclaration } from "../composition/feature.js";
+import type { GroupDeclaration } from "./group.js";
+export declare function requireText(value: string, field: string): string;
+export declare function normalizeTags(values: readonly string[], field?: string): readonly string[];
+export declare function explanation(kind: ExplanationKindState, text: string, field?: string): ExplanationState;
+export declare function optionalSemanticMetadata(tags: readonly string[], explanations: readonly ExplanationState[]): SemanticMetadataState;
+export declare function optionalOrigin(value: AuthorSourceLocation | undefined): {
+    readonly origin?: AuthorSourceLocation;
+};
+export declare function optionalDescription(value: string | undefined): {
+    readonly description?: string;
+};
+/** Owner refs for feature-ownable declarations: required group plus optional feature. */
+export declare function optionalOwner(group: GroupDeclaration | undefined, feature: FeatureDeclaration | undefined): {
+    readonly group?: DeclarationRef<"group">;
+    readonly feature?: DeclarationRef<"feature">;
+};
+export declare function optionalGroup(value: GroupDeclaration | undefined): {
+    readonly group?: DeclarationRef<"group">;
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/foundation/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/foundation/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,SAAS,GACb,SAAS,MAAM,EAAE,CASnB;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,SAAgB,GACpB,gBAAgB,CAElB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,YAAY,EAAE,SAAS,gBAAgB,EAAE,GACxC,qBAAqB,CAOvB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,GAAG;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;CACxC,CAEA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,CAEA;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC;IACD,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CAC9C,CAKA;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CAC1C,CAEA"}

package/dist/foundation/metadata.js

@@ -0,0 +1,43 @@
+export function requireText(value, field) {
+    if (!value.trim())
+        throw new TypeError(`${field} must not be empty`);
+    return value;
+}
+export function normalizeTags(values, field = "tags") {
+    if (values.length === 0) {
+        throw new TypeError(`${field} requires at least one tag`);
+    }
+    const normalized = values.map((value) => requireText(value, field));
+    if (new Set(normalized).size !== normalized.length) {
+        throw new TypeError(`${field} must be unique`);
+    }
+    return [...normalized].sort();
+}
+export function explanation(kind, text, field = "explanation") {
+    return { kind, text: requireText(text, field) };
+}
+export function optionalSemanticMetadata(tags, explanations) {
+    return {
+        ...(tags.length === 0 ? {} : { tags: [...tags].sort() }),
+        ...(explanations.length === 0
+            ? {}
+            : { explanations: explanations.map((value) => ({ ...value })) }),
+    };
+}
+export function optionalOrigin(value) {
+    return value === undefined ? {} : { origin: value };
+}
+export function optionalDescription(value) {
+    return value === undefined ? {} : { description: value };
+}
+/** Owner refs for feature-ownable declarations: required group plus optional feature. */
+export function optionalOwner(group, feature) {
+    return {
+        ...(group === undefined ? {} : { group: group.ref() }),
+        ...(feature === undefined ? {} : { feature: feature.ref() }),
+    };
+}
+export function optionalGroup(value) {
+    return value === undefined ? {} : { group: value.ref() };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/foundation/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/foundation/metadata.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAyB,EACzB,KAAK,GAAG,MAAM;IAEd,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,4BAA4B,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACpE,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QACnD,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,IAA0B,EAC1B,IAAY,EACZ,KAAK,GAAG,aAAa;IAErB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAuB,EACvB,YAAyC;IAEzC,OAAO;QACL,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACxD,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAC3B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAuC;IAGpE,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAG3D,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAC3D,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAC3B,KAAmC,EACnC,OAAuC;IAKvC,OAAO;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAmC;IAG/D,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;AAC3D,CAAC"}