@xemahq/contracts 0.78.0 → 0.79.0

package/dist/setting/lib/setting-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-duration.js","sourceRoot":"","sources":["../../../src/setting/lib/setting-duration.ts"],"names":[],"mappings":";;AAWA,0DAmBC;AAGD,4DAkBC;AA9CD,MAAM,YAAY,GAAG,wDAAwD,CAAC;AAE9E,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,SAAgB,uBAAuB,CAAC,GAAW;IACjD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,IAAI,GAAG,2FAA2F,CACnG,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3D,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CACtC,CAAC;IACF,MAAM,KAAK,GACT,IAAK,GAAG,eAAe;QACvB,KAAM,GAAG,gBAAgB;QACzB,OAAQ,GAAG,kBAAkB;QAC7B,OAAQ,CAAC;IACX,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,oBAAoB,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAGD,SAAgB,wBAAwB,CAAC,YAAoB;IAC3D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,GAAG,YAAY,iDAAiD,CACjE,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,eAAe,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,eAAe,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CACxB,CAAC,YAAY,GAAG,gBAAgB,CAAC,GAAG,kBAAkB,CACvD,CAAC;IACF,MAAM,OAAO,GAAG,YAAY,GAAG,kBAAkB,CAAC;IAClD,MAAM,IAAI,GACR,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9B,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrC,OAAO,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AAC1E,CAAC"}

package/dist/setting/lib/setting-enums.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { type SpaceKindSubset } from "../../space";
+export declare enum SettingValueType {
+    Boolean = "boolean",
+    Integer = "integer",
+    Duration = "duration",
+    Enum = "enum"
+}
+export declare const SettingValueTypeSchema: z.ZodEnum<typeof SettingValueType>;
+export declare enum SettingMerge {
+    Nearest = "nearest",
+    Tighten = "tighten"
+}
+export declare const SettingMergeSchema: z.ZodEnum<typeof SettingMerge>;
+export declare enum SettingTighterDirection {
+    Lower = "lower",
+    Higher = "higher"
+}
+export declare const SettingTighterDirectionSchema: z.ZodEnum<typeof SettingTighterDirection>;
+export declare const SETTING_SPACE_KINDS: SpaceKindSubset;
+export declare const SETTING_REGISTRY = "The scoped-setting registry";
+export declare enum SettingOwnership {
+    OrgOnly = "org-only",
+    ProjectOverridable = "project-overridable",
+    ProjectOnly = "project-only"
+}
+//# sourceMappingURL=setting-enums.d.ts.map

package/dist/setting/lib/setting-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-enums.d.ts","sourceRoot":"","sources":["../../../src/setting/lib/setting-enums.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAS/E,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,OAAO,YAAY;IAEnB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AACD,eAAO,MAAM,sBAAsB,oCAAiC,CAAC;AASrE,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AACD,eAAO,MAAM,kBAAkB,gCAA6B,CAAC;AAG7D,oBAAY,uBAAuB;IACjC,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AACD,eAAO,MAAM,6BAA6B,2CAEzC,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,eAGjC,CAAC;AAGF,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAG9D,oBAAY,gBAAgB;IAC1B,OAAO,aAAa;IACpB,kBAAkB,wBAAwB;IAC1C,WAAW,iBAAiB;CAC7B"}

package/dist/setting/lib/setting-enums.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingOwnership = exports.SETTING_REGISTRY = exports.SETTING_SPACE_KINDS = exports.SettingTighterDirectionSchema = exports.SettingTighterDirection = exports.SettingMergeSchema = exports.SettingMerge = exports.SettingValueTypeSchema = exports.SettingValueType = void 0;
+const zod_1 = require("zod");
+const space_1 = require("../../space");
+var SettingValueType;
+(function (SettingValueType) {
+    SettingValueType["Boolean"] = "boolean";
+    SettingValueType["Integer"] = "integer";
+    SettingValueType["Duration"] = "duration";
+    SettingValueType["Enum"] = "enum";
+})(SettingValueType || (exports.SettingValueType = SettingValueType = {}));
+exports.SettingValueTypeSchema = zod_1.z.nativeEnum(SettingValueType);
+var SettingMerge;
+(function (SettingMerge) {
+    SettingMerge["Nearest"] = "nearest";
+    SettingMerge["Tighten"] = "tighten";
+})(SettingMerge || (exports.SettingMerge = SettingMerge = {}));
+exports.SettingMergeSchema = zod_1.z.nativeEnum(SettingMerge);
+var SettingTighterDirection;
+(function (SettingTighterDirection) {
+    SettingTighterDirection["Lower"] = "lower";
+    SettingTighterDirection["Higher"] = "higher";
+})(SettingTighterDirection || (exports.SettingTighterDirection = SettingTighterDirection = {}));
+exports.SettingTighterDirectionSchema = zod_1.z.nativeEnum(SettingTighterDirection);
+exports.SETTING_SPACE_KINDS = (0, space_1.spaceKindSubset)(space_1.SpaceKind.Org, space_1.SpaceKind.Project);
+exports.SETTING_REGISTRY = "The scoped-setting registry";
+var SettingOwnership;
+(function (SettingOwnership) {
+    SettingOwnership["OrgOnly"] = "org-only";
+    SettingOwnership["ProjectOverridable"] = "project-overridable";
+    SettingOwnership["ProjectOnly"] = "project-only";
+})(SettingOwnership || (exports.SettingOwnership = SettingOwnership = {}));
+//# sourceMappingURL=setting-enums.js.map

package/dist/setting/lib/setting-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-enums.js","sourceRoot":"","sources":["../../../src/setting/lib/setting-enums.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,uCAA+E;AAS/E,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,uCAAmB,CAAA;IACnB,uCAAmB,CAAA;IAEnB,yCAAqB,CAAA;IACrB,iCAAa,CAAA;AACf,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AACY,QAAA,sBAAsB,GAAG,OAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AASrE,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;AACrB,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AACY,QAAA,kBAAkB,GAAG,OAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAG7D,IAAY,uBAGX;AAHD,WAAY,uBAAuB;IACjC,0CAAe,CAAA;IACf,4CAAiB,CAAA;AACnB,CAAC,EAHW,uBAAuB,uCAAvB,uBAAuB,QAGlC;AACY,QAAA,6BAA6B,GAAG,OAAC,CAAC,UAAU,CACvD,uBAAuB,CACxB,CAAC;AAGW,QAAA,mBAAmB,GAAoB,IAAA,uBAAe,EACjE,iBAAS,CAAC,GAAG,EACb,iBAAS,CAAC,OAAO,CAClB,CAAC;AAGW,QAAA,gBAAgB,GAAG,6BAA6B,CAAC;AAG9D,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,wCAAoB,CAAA;IACpB,8DAA0C,CAAA;IAC1C,gDAA4B,CAAA;AAC9B,CAAC,EAJW,gBAAgB,gCAAhB,gBAAgB,QAI3B"}

package/dist/setting/lib/setting-key.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export declare const SETTING_NAME_PATTERN: RegExp;
+export declare const SETTING_NAME_MAX_LENGTH = 96;
+export declare const SETTING_KEY_NAMESPACE_SEPARATOR = ":";
+export declare const SETTING_KEY_MAJOR_SEPARATOR = "@";
+export declare const SettingNameSchema: z.ZodString;
+export declare const SettingMajorSchema: z.ZodNumber;
+export declare const SettingNamespaceSchema: z.ZodString;
+export interface SettingKeyParts {
+    readonly namespace: string;
+    readonly name: string;
+    readonly major: number;
+}
+export declare const SettingKeyPartsSchema: z.ZodType<SettingKeyParts>;
+export declare function formatSettingKey(parts: SettingKeyParts): string;
+export declare function parseSettingKey(raw: string): SettingKeyParts;
+export declare const SettingKeySchema: z.ZodString;
+export declare function assertSettingDeclaredBy(key: string, declaringBiomeId: string): SettingKeyParts;
+//# sourceMappingURL=setting-key.d.ts.map

package/dist/setting/lib/setting-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-key.d.ts","sourceRoot":"","sources":["../../../src/setting/lib/setting-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,oBAAoB,QAA6C,CAAC;AAC/E,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,+BAA+B,MAAM,CAAC;AACnD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,eAAO,MAAM,iBAAiB,aAM3B,CAAC;AAEJ,eAAO,MAAM,kBAAkB,aAA0B,CAAC;AAE1D,eAAO,MAAM,sBAAsB,aAE2C,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAMlD,CAAC;AAEZ,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAG/D;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAoB5D;AAED,eAAO,MAAM,gBAAgB,aAS3B,CAAC;AAMH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,GACvB,eAAe,CAUjB"}

package/dist/setting/lib/setting-key.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingKeySchema = exports.SettingKeyPartsSchema = exports.SettingNamespaceSchema = exports.SettingMajorSchema = exports.SettingNameSchema = exports.SETTING_KEY_MAJOR_SEPARATOR = exports.SETTING_KEY_NAMESPACE_SEPARATOR = exports.SETTING_NAME_MAX_LENGTH = exports.SETTING_NAME_PATTERN = void 0;
+exports.formatSettingKey = formatSettingKey;
+exports.parseSettingKey = parseSettingKey;
+exports.assertSettingDeclaredBy = assertSettingDeclaredBy;
+const zod_1 = require("zod");
+const contribution_1 = require("../../contribution");
+exports.SETTING_NAME_PATTERN = /^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)*$/u;
+exports.SETTING_NAME_MAX_LENGTH = 96;
+exports.SETTING_KEY_NAMESPACE_SEPARATOR = ":";
+exports.SETTING_KEY_MAJOR_SEPARATOR = "@";
+exports.SettingNameSchema = zod_1.z
+    .string()
+    .max(exports.SETTING_NAME_MAX_LENGTH)
+    .regex(exports.SETTING_NAME_PATTERN, 'A setting name is lower-kebab segments joined by dots, e.g. "self-answer-allowed"; it never carries a namespace or a major.');
+exports.SettingMajorSchema = zod_1.z.number().int().min(1);
+exports.SettingNamespaceSchema = zod_1.z
+    .string()
+    .regex(contribution_1.CONTRIBUTION_NAMESPACE_PATTERN, "A setting namespace is a biome id.");
+exports.SettingKeyPartsSchema = zod_1.z
+    .object({
+    namespace: exports.SettingNamespaceSchema,
+    name: exports.SettingNameSchema,
+    major: exports.SettingMajorSchema,
+})
+    .strict();
+function formatSettingKey(parts) {
+    const parsed = exports.SettingKeyPartsSchema.parse(parts);
+    return `${parsed.namespace}${exports.SETTING_KEY_NAMESPACE_SEPARATOR}${parsed.name}${exports.SETTING_KEY_MAJOR_SEPARATOR}${parsed.major}`;
+}
+const KEY_SHAPE = /^([^:@]+):([^:@]+)@(\d+)$/u;
+function parseSettingKey(raw) {
+    const match = KEY_SHAPE.exec(raw);
+    if (match === null) {
+        throw new Error(`"${raw}" is not a setting key; expected "<namespace>:<name>@<major>".`);
+    }
+    const parsed = exports.SettingKeyPartsSchema.safeParse({
+        namespace: match[1],
+        name: match[2],
+        major: Number(match[3]),
+    });
+    if (!parsed.success) {
+        throw new Error(`"${raw}" is not a legal setting key: ${parsed.error.issues
+            .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+            .join("; ")}`);
+    }
+    return parsed.data;
+}
+exports.SettingKeySchema = zod_1.z.string().superRefine((raw, ctx) => {
+    try {
+        parseSettingKey(raw);
+    }
+    catch (error) {
+        ctx.addIssue({
+            code: "custom",
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+});
+function assertSettingDeclaredBy(key, declaringBiomeId) {
+    const parts = parseSettingKey(key);
+    if (parts.namespace !== declaringBiomeId) {
+        throw new Error(`Setting "${key}" names namespace "${parts.namespace}", but it is declared by ` +
+            `"${declaringBiomeId}". The namespace is stamped from the contribution owner, ` +
+            `never authored.`);
+    }
+    return parts;
+}
+//# sourceMappingURL=setting-key.js.map

package/dist/setting/lib/setting-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-key.js","sourceRoot":"","sources":["../../../src/setting/lib/setting-key.ts"],"names":[],"mappings":";;;AA8CA,4CAGC;AAKD,0CAoBC;AAiBD,0DAaC;AAxGD,6BAAwB;AAExB,qDAAoE;AAWvD,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,uBAAuB,GAAG,EAAE,CAAC;AAC7B,QAAA,+BAA+B,GAAG,GAAG,CAAC;AACtC,QAAA,2BAA2B,GAAG,GAAG,CAAC;AAElC,QAAA,iBAAiB,GAAG,OAAC;KAC/B,MAAM,EAAE;KACR,GAAG,CAAC,+BAAuB,CAAC;KAC5B,KAAK,CACJ,4BAAoB,EACpB,6HAA6H,CAC9H,CAAC;AAES,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE7C,QAAA,sBAAsB,GAAG,OAAC;KACpC,MAAM,EAAE;KACR,KAAK,CAAC,6CAA8B,EAAE,oCAAoC,CAAC,CAAC;AAQlE,QAAA,qBAAqB,GAA+B,OAAC;KAC/D,MAAM,CAAC;IACN,SAAS,EAAE,8BAAsB;IACjC,IAAI,EAAE,yBAAiB;IACvB,KAAK,EAAE,0BAAkB;CAC1B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,SAAgB,gBAAgB,CAAC,KAAsB;IACrD,MAAM,MAAM,GAAG,6BAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,GAAG,MAAM,CAAC,SAAS,GAAG,uCAA+B,GAAG,MAAM,CAAC,IAAI,GAAG,mCAA2B,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;AAC5H,CAAC;AAED,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAG/C,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,IAAI,GAAG,gEAAgE,CACxE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,6BAAqB,CAAC,SAAS,CAAC;QAC7C,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACnB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACxB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,IAAI,GAAG,iCAAiC,MAAM,CAAC,KAAK,CAAC,MAAM;aACxD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAEY,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IAClE,IAAI,CAAC;QACH,eAAe,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAMH,SAAgB,uBAAuB,CACrC,GAAW,EACX,gBAAwB;IAExB,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,YAAY,GAAG,sBAAsB,KAAK,CAAC,SAAS,2BAA2B;YAC7E,IAAI,gBAAgB,2DAA2D;YAC/E,iBAAiB,CACpB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/setting/lib/setting-merge.d.ts

@@ -0,0 +1,7 @@
+import type { ParameterCombine } from "../../declared-parameter";
+import type { EffectiveValue } from "../../declared-parameter";
+import type { SettingValue } from "./setting-constraints";
+import type { SettingDefinition } from "./setting-definition";
+export declare function settingCombine(def: SettingDefinition): ParameterCombine<SettingValue> | undefined;
+export declare function tightenWith(def: SettingDefinition, effective: Pick<EffectiveValue<SettingValue>, "effectiveValue">, requested: SettingValue): SettingValue;
+//# sourceMappingURL=setting-merge.d.ts.map

package/dist/setting/lib/setting-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-merge.d.ts","sourceRoot":"","sources":["../../../src/setting/lib/setting-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAc9D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,iBAAiB,GACrB,gBAAgB,CAAC,YAAY,CAAC,GAAG,SAAS,CAqB5C;AAMD,wBAAgB,WAAW,CACzB,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,EAC/D,SAAS,EAAE,YAAY,GACtB,YAAY,CAYd"}

package/dist/setting/lib/setting-merge.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingCombine = settingCombine;
+exports.tightenWith = tightenWith;
+const setting_enums_1 = require("./setting-enums");
+const setting_value_1 = require("./setting-value");
+function settingCombine(def) {
+    if (def.merge === setting_enums_1.SettingMerge.Nearest)
+        return undefined;
+    switch (def.valueType) {
+        case setting_enums_1.SettingValueType.Boolean: {
+            const tighterIs = def.tighter;
+            return (a, b) => (a === tighterIs ? a : b);
+        }
+        case setting_enums_1.SettingValueType.Integer:
+        case setting_enums_1.SettingValueType.Duration: {
+            const lower = def.tighter === setting_enums_1.SettingTighterDirection.Lower;
+            return (a, b) => lower
+                ? Math.min(a, b)
+                : Math.max(a, b);
+        }
+        case setting_enums_1.SettingValueType.Enum: {
+            const order = def.constraints.values;
+            return (a, b) => order.indexOf(a) <= order.indexOf(b) ? a : b;
+        }
+    }
+}
+function tightenWith(def, effective, requested) {
+    const combine = settingCombine(def);
+    if (combine === undefined) {
+        throw new Error(`tightenWith applies to a "tighten" setting; this one is "${def.merge}".`);
+    }
+    const schema = (0, setting_value_1.settingAtRestValueSchema)(def);
+    return combine(schema.parse(effective.effectiveValue), schema.parse(requested));
+}
+//# sourceMappingURL=setting-merge.js.map

package/dist/setting/lib/setting-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-merge.js","sourceRoot":"","sources":["../../../src/setting/lib/setting-merge.ts"],"names":[],"mappings":";;AAiBA,wCAuBC;AAMD,kCAgBC;AA1DD,mDAIyB;AACzB,mDAA2D;AAQ3D,SAAgB,cAAc,CAC5B,GAAsB;IAEtB,IAAI,GAAG,CAAC,KAAK,KAAK,4BAAY,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACzD,QAAQ,GAAG,CAAC,SAAS,EAAE,CAAC;QACtB,KAAK,gCAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;YAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,gCAAgB,CAAC,OAAO,CAAC;QAC9B,KAAK,gCAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,KAAK,uCAAuB,CAAC,KAAK,CAAC;YAC5D,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACd,KAAK;gBACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAW,EAAE,CAAW,CAAC;gBACpC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAW,EAAE,CAAW,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,gCAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;YACrC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACd,KAAK,CAAC,OAAO,CAAC,CAAW,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAMD,SAAgB,WAAW,CACzB,GAAsB,EACtB,SAA+D,EAC/D,SAAuB;IAEvB,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,4DAA4D,GAAG,CAAC,KAAK,IAAI,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,wCAAwB,EAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,OAAO,CACZ,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,EACtC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CACxB,CAAC;AACJ,CAAC"}

package/dist/setting/lib/setting-resolve.d.ts

@@ -0,0 +1,11 @@
+import { type EffectiveValue, type ParameterScopeRef } from "../../declared-parameter";
+import { type SpaceKind } from "../../space";
+import type { SettingValue } from "./setting-constraints";
+import { type StampedSettingDefinition } from "./setting-definition";
+export interface SettingChainEntry {
+    readonly spaceKind: SpaceKind;
+    readonly scope: ParameterScopeRef;
+    readonly value?: SettingValue;
+}
+export declare function resolveSetting(def: StampedSettingDefinition, chain: readonly SettingChainEntry[]): EffectiveValue<SettingValue>;
+//# sourceMappingURL=setting-resolve.d.ts.map

package/dist/setting/lib/setting-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-resolve.d.ts","sourceRoot":"","sources":["../../../src/setting/lib/setting-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAM9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAQD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAClC,cAAc,CAAC,YAAY,CAAC,CAwC9B"}

package/dist/setting/lib/setting-resolve.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSetting = resolveSetting;
+const declared_parameter_1 = require("../../declared-parameter");
+const space_1 = require("../../space");
+const setting_definition_1 = require("./setting-definition");
+const setting_enums_1 = require("./setting-enums");
+const setting_merge_1 = require("./setting-merge");
+const setting_value_1 = require("./setting-value");
+function resolveSetting(def, chain) {
+    const schema = (0, setting_value_1.settingAtRestValueSchema)(def);
+    const seen = new Set();
+    const admitted = [];
+    for (const entry of chain) {
+        (0, space_1.spaceKindRank)(entry.spaceKind);
+        if (seen.has(entry.spaceKind)) {
+            throw new Error(`Setting "${def.key}" chain has two rungs at "${entry.spaceKind}".`);
+        }
+        seen.add(entry.spaceKind);
+        const admits = (0, setting_definition_1.mayDeclareAt)(def, entry.spaceKind);
+        if (entry.value === undefined && !admits)
+            continue;
+        (0, space_1.assertSpaceKindAdmissible)(setting_enums_1.SETTING_REGISTRY, entry.spaceKind, new Set(def.declarableAt));
+        if (entry.value !== undefined)
+            schema.parse(entry.value);
+        admitted.push(entry);
+    }
+    admitted.sort((a, b) => (0, space_1.spaceKindRank)(a.spaceKind) - (0, space_1.spaceKindRank)(b.spaceKind));
+    const parameterChain = admitted.map((entry) => entry.value === undefined
+        ? { scope: entry.scope }
+        : { scope: entry.scope, value: entry.value });
+    const combine = (0, setting_merge_1.settingCombine)(def);
+    return (0, declared_parameter_1.resolveDeclaredParameter)({
+        key: def.key,
+        platformDefault: (0, setting_definition_1.settingDefaultValue)(def),
+        ...(combine === undefined ? {} : { combine }),
+    }, parameterChain);
+}
+//# sourceMappingURL=setting-resolve.js.map

package/dist/setting/lib/setting-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-resolve.js","sourceRoot":"","sources":["../../../src/setting/lib/setting-resolve.ts"],"names":[],"mappings":";;AAkCA,wCA2CC;AA7ED,iEAKkC;AAClC,uCAIqB;AAErB,6DAI8B;AAC9B,mDAAmD;AACnD,mDAAiD;AACjD,mDAA2D;AAe3D,SAAgB,cAAc,CAC5B,GAA6B,EAC7B,KAAmC;IAEnC,MAAM,MAAM,GAAG,IAAA,wCAAwB,EAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAa,CAAC;IAClC,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAA,qBAAa,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,YAAY,GAAG,CAAC,GAAG,6BAA6B,KAAK,CAAC,SAAS,IAAI,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAA,iCAAY,EAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM;YAAE,SAAS;QACnD,IAAA,iCAAyB,EACvB,gCAAgB,EAChB,KAAK,CAAC,SAAS,EACf,IAAI,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAC1B,CAAC;QACF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,QAAQ,CAAC,IAAI,CACX,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAA,qBAAa,EAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAA,qBAAa,EAAC,CAAC,CAAC,SAAS,CAAC,CAClE,CAAC;IACF,MAAM,cAAc,GAAwC,QAAQ,CAAC,GAAG,CACtE,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,KAAK,KAAK,SAAS;QACvB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;QACxB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CACjD,CAAC;IACF,MAAM,OAAO,GAAG,IAAA,8BAAc,EAAC,GAAG,CAAC,CAAC;IACpC,OAAO,IAAA,6CAAwB,EAC7B;QACE,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,eAAe,EAAE,IAAA,wCAAmB,EAAC,GAAG,CAAC;QACzC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC9C,EACD,cAAc,CACf,CAAC;AACJ,CAAC"}

package/dist/setting/lib/setting-revision.d.ts

@@ -0,0 +1,5 @@
+import type { SettingDefinition } from "./setting-definition";
+export declare function settingRevisionIncompatibilities(prev: SettingDefinition, next: SettingDefinition): readonly string[];
+export declare function isCompatibleRevision(prev: SettingDefinition, next: SettingDefinition): boolean;
+export declare function assertCompatibleRevision(prev: SettingDefinition, next: SettingDefinition): void;
+//# sourceMappingURL=setting-revision.d.ts.map

package/dist/setting/lib/setting-revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-revision.d.ts","sourceRoot":"","sources":["../../../src/setting/lib/setting-revision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAS9D,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,iBAAiB,GACtB,SAAS,MAAM,EAAE,CAiDnB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAET;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAQN"}

package/dist/setting/lib/setting-revision.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingRevisionIncompatibilities = settingRevisionIncompatibilities;
+exports.isCompatibleRevision = isCompatibleRevision;
+exports.assertCompatibleRevision = assertCompatibleRevision;
+const setting_enums_1 = require("./setting-enums");
+function settingRevisionIncompatibilities(prev, next) {
+    if (prev.name !== next.name || prev.major !== next.major) {
+        return [
+            "name and major identify the definition; a different pair is a different setting",
+        ];
+    }
+    const out = [];
+    if (prev.valueType !== next.valueType)
+        out.push("valueType changed");
+    if (prev.merge !== next.merge)
+        out.push("merge changed");
+    if (prev.tighter !== next.tighter)
+        out.push("tighter changed");
+    const prevTiers = [...prev.declarableAt].sort().join(",");
+    const nextTiers = [...next.declarableAt].sort().join(",");
+    if (prevTiers !== nextTiers)
+        out.push("declarableAt changed");
+    if (out.length > 0)
+        return out;
+    switch (prev.valueType) {
+        case setting_enums_1.SettingValueType.Boolean:
+            break;
+        case setting_enums_1.SettingValueType.Integer:
+            if (next.valueType === setting_enums_1.SettingValueType.Integer) {
+                if (next.constraints.min > prev.constraints.min)
+                    out.push("min was raised");
+                if (next.constraints.max < prev.constraints.max)
+                    out.push("max was lowered");
+            }
+            break;
+        case setting_enums_1.SettingValueType.Duration:
+            if (next.valueType === setting_enums_1.SettingValueType.Duration) {
+                if (next.constraints.minSeconds > prev.constraints.minSeconds) {
+                    out.push("minSeconds was raised");
+                }
+                if (next.constraints.maxSeconds < prev.constraints.maxSeconds) {
+                    out.push("maxSeconds was lowered");
+                }
+            }
+            break;
+        case setting_enums_1.SettingValueType.Enum:
+            if (next.valueType === setting_enums_1.SettingValueType.Enum) {
+                const kept = prev.constraints.values.every((value, index) => next.constraints.values[index] === value);
+                if (!kept) {
+                    out.push("enum members may only be appended at the loose end, in order");
+                }
+            }
+            break;
+    }
+    return out;
+}
+function isCompatibleRevision(prev, next) {
+    return settingRevisionIncompatibilities(prev, next).length === 0;
+}
+function assertCompatibleRevision(prev, next) {
+    const problems = settingRevisionIncompatibilities(prev, next);
+    if (problems.length > 0) {
+        throw new Error(`Setting "${prev.name}@${prev.major}" revision is not additive: ${problems.join("; ")}. ` +
+            `Publish it as @${prev.major + 1}.`);
+    }
+}
+//# sourceMappingURL=setting-revision.js.map

package/dist/setting/lib/setting-revision.js.map

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

package/dist/setting/lib/setting-value.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import type { SettingValue, SettingValueShape } from "./setting-constraints";
+export declare function settingValueSchema(shape: SettingValueShape): z.ZodType<SettingValue, unknown>;
+export declare function settingAtRestValueSchema(shape: SettingValueShape): z.ZodType<SettingValue>;
+//# sourceMappingURL=setting-value.d.ts.map

package/dist/setting/lib/setting-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-value.d.ts","sourceRoot":"","sources":["../../../src/setting/lib/setting-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AA8B7E,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,GACvB,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAuBlC;AAGD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,GACvB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAEzB"}

package/dist/setting/lib/setting-value.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingValueSchema = settingValueSchema;
+exports.settingAtRestValueSchema = settingAtRestValueSchema;
+const zod_1 = require("zod");
+const setting_duration_1 = require("./setting-duration");
+const setting_enums_1 = require("./setting-enums");
+function atRestSchema(shape) {
+    switch (shape.valueType) {
+        case setting_enums_1.SettingValueType.Boolean:
+            return zod_1.z.boolean();
+        case setting_enums_1.SettingValueType.Integer:
+            return zod_1.z
+                .number()
+                .int()
+                .min(shape.constraints.min)
+                .max(shape.constraints.max);
+        case setting_enums_1.SettingValueType.Duration:
+            return zod_1.z
+                .number()
+                .int()
+                .min(shape.constraints.minSeconds)
+                .max(shape.constraints.maxSeconds);
+        case setting_enums_1.SettingValueType.Enum:
+            return zod_1.z.enum(shape.constraints.values);
+    }
+}
+function settingValueSchema(shape) {
+    const rest = atRestSchema(shape);
+    if (shape.valueType !== setting_enums_1.SettingValueType.Duration)
+        return rest;
+    return zod_1.z.string().transform((raw, ctx) => {
+        let seconds;
+        try {
+            seconds = (0, setting_duration_1.parseIsoDurationSeconds)(raw);
+        }
+        catch (error) {
+            ctx.addIssue({
+                code: "custom",
+                message: error instanceof Error ? error.message : String(error),
+            });
+            return zod_1.z.NEVER;
+        }
+        const checked = rest.safeParse(seconds);
+        if (!checked.success) {
+            for (const issue of checked.error.issues) {
+                ctx.addIssue({ code: "custom", message: issue.message });
+            }
+            return zod_1.z.NEVER;
+        }
+        return checked.data;
+    });
+}
+function settingAtRestValueSchema(shape) {
+    return atRestSchema(shape);
+}
+//# sourceMappingURL=setting-value.js.map

package/dist/setting/lib/setting-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-value.js","sourceRoot":"","sources":["../../../src/setting/lib/setting-value.ts"],"names":[],"mappings":";;AAgCA,gDAyBC;AAGD,4DAIC;AAhED,6BAAwB;AAGxB,yDAA6D;AAC7D,mDAAmD;AAEnD,SAAS,YAAY,CAAC,KAAwB;IAC5C,QAAQ,KAAK,CAAC,SAAS,EAAE,CAAC;QACxB,KAAK,gCAAgB,CAAC,OAAO;YAC3B,OAAO,OAAC,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,gCAAgB,CAAC,OAAO;YAC3B,OAAO,OAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC;iBAC1B,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,KAAK,gCAAgB,CAAC,QAAQ;YAC5B,OAAO,OAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC;iBACjC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACvC,KAAK,gCAAgB,CAAC,IAAI;YACxB,OAAO,OAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAA+B,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAOD,SAAgB,kBAAkB,CAChC,KAAwB;IAExB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,SAAS,KAAK,gCAAgB,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,OAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,GAAG,EAAgB,EAAE;QACrD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,IAAA,0CAAuB,EAAC,GAAG,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;YACH,OAAO,OAAC,CAAC,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACzC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,OAAC,CAAC,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAGD,SAAgB,wBAAwB,CACtC,KAAwB;IAExB,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/space/index.d.ts

@@ -2,7 +2,6 @@ export * from './lib/space';
 export * from './lib/space-classification';
 export * from './lib/space-kind-rank';
 export * from './lib/scoped-resolution';
-export * from './lib/scoped-setting';
 export * from './lib/space-promotion';
 export * from './lib/space-ref-parser';
 export * from './lib/space-traversal';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC"}

package/dist/space/index.js

@@ -18,7 +18,6 @@ __exportStar(require("./lib/space"), exports);
 __exportStar(require("./lib/space-classification"), exports);
 __exportStar(require("./lib/space-kind-rank"), exports);
 __exportStar(require("./lib/scoped-resolution"), exports);
-__exportStar(require("./lib/scoped-setting"), exports);
 __exportStar(require("./lib/space-promotion"), exports);
 __exportStar(require("./lib/space-ref-parser"), exports);
 __exportStar(require("./lib/space-traversal"), exports);

package/dist/space/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6DAA2C;AAC3C,wDAAsC;AACtC,0DAAwC;AACxC,uDAAqC;AACrC,wDAAsC;AACtC,yDAAuC;AACvC,wDAAsC;AACtC,wDAAsC;AACtC,+DAA6C;AAC7C,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6DAA2C;AAC3C,wDAAsC;AACtC,0DAAwC;AACxC,wDAAsC;AACtC,yDAAuC;AACvC,wDAAsC;AACtC,wDAAsC;AACtC,+DAA6C;AAC7C,+DAA6C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/contracts",
-  "version": "0.78.0",
+  "version": "0.79.0",
   "description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework deps; the one runtime dependency beside zod is the OpenFGA syntax transformer the authorization-module composer runs.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
@@ -57,6 +57,6 @@
     "test:authorization-models": "node scripts/run-authorization-model-tests.mjs"
   },
   "xemaRelease": {
-    "sourceDigest": "sha256:7c6b46b0b32470856b45199af7e3d110773a36d40704f75e1ce6c54354df3bb2"
+    "sourceDigest": "sha256:937e78c91eeff50e1986077333756cf056f1710de8c4fd9ffc5f76f1c965b082"
   }
 }

package/dist/space/lib/scoped-setting.d.ts

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-import { type ScopedResolution } from './scoped-resolution';
-import { SpaceKind } from './space';
-export declare const SCOPED_SETTING_KEY_PATTERN: RegExp;
-export declare const ScopedSettingKeySchema: z.ZodString;
-export declare enum ScopedSettingOwnership {
-    OrgOnly = "org-only",
-    ProjectOverridable = "project-overridable",
-    ProjectOnly = "project-only",
-    Other = "other"
-}
-export interface ScopedSettingDefinition<TValue = unknown> {
-    readonly key: string;
-    readonly schema: z.ZodType<TValue>;
-    readonly declarableAt: readonly SpaceKind[];
-}
-export declare const ScopedSettingDefinitionSchema: z.ZodObject<{
-    key: z.ZodString;
-    declarableAt: z.ZodArray<z.ZodEnum<typeof SpaceKind>>;
-}, z.core.$strict>;
-export declare function mayDeclareAt(definition: Pick<ScopedSettingDefinition, 'declarableAt'>, tier: SpaceKind): boolean;
-export declare function scopedSettingOwnership(definition: Pick<ScopedSettingDefinition, 'declarableAt'>): ScopedSettingOwnership;
-export interface ScopedSettingDeclaration<TValue = unknown> {
-    readonly ownerSpaceKind: SpaceKind;
-    readonly value: TValue;
-}
-export declare function resolveScopedSetting<TValue>(definition: Pick<ScopedSettingDefinition<TValue>, 'declarableAt'>, declarations: readonly ScopedSettingDeclaration<TValue>[]): ScopedResolution<TValue> | undefined;
-//# sourceMappingURL=scoped-setting.d.ts.map

package/dist/space/lib/scoped-setting.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scoped-setting.d.ts","sourceRoot":"","sources":["../../../src/space/lib/scoped-setting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAmB,MAAM,SAAS,CAAC;AA8DrD,eAAO,MAAM,0BAA0B,QACK,CAAC;AAE7C,eAAO,MAAM,sBAAsB,aAKhC,CAAC;AAGJ,oBAAY,sBAAsB;IAChC,OAAO,aAAa;IACpB,kBAAkB,wBAAwB;IAC1C,WAAW,iBAAiB;IAE5B,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,OAAO;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAKnC,QAAQ,CAAC,YAAY,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7C;AAED,eAAO,MAAM,6BAA6B;;;kBAW/B,CAAC;AASZ,wBAAgB,YAAY,CAC1B,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,cAAc,CAAC,EACzD,IAAI,EAAE,SAAS,GACd,OAAO,CAET;AASD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,cAAc,CAAC,GACxD,sBAAsB,CAUxB;AAGD,MAAM,WAAW,wBAAwB,CAAC,MAAM,GAAG,OAAO;IACxD,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAWD,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,UAAU,EAAE,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,EACjE,YAAY,EAAE,SAAS,wBAAwB,CAAC,MAAM,CAAC,EAAE,GACxD,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,CAuBtC"}

package/dist/space/lib/scoped-setting.js

@@ -1,60 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScopedSettingDefinitionSchema = exports.ScopedSettingOwnership = exports.ScopedSettingKeySchema = exports.SCOPED_SETTING_KEY_PATTERN = void 0;
-exports.mayDeclareAt = mayDeclareAt;
-exports.scopedSettingOwnership = scopedSettingOwnership;
-exports.resolveScopedSetting = resolveScopedSetting;
-const zod_1 = require("zod");
-const scoped_resolution_1 = require("./scoped-resolution");
-const space_1 = require("./space");
-const space_kind_rank_1 = require("./space-kind-rank");
-exports.SCOPED_SETTING_KEY_PATTERN = /^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)+$/u;
-exports.ScopedSettingKeySchema = zod_1.z
-    .string()
-    .regex(exports.SCOPED_SETTING_KEY_PATTERN, 'A setting key is dotted lower-kebab, e.g. "xema.llm.default-strategy".');
-var ScopedSettingOwnership;
-(function (ScopedSettingOwnership) {
-    ScopedSettingOwnership["OrgOnly"] = "org-only";
-    ScopedSettingOwnership["ProjectOverridable"] = "project-overridable";
-    ScopedSettingOwnership["ProjectOnly"] = "project-only";
-    ScopedSettingOwnership["Other"] = "other";
-})(ScopedSettingOwnership || (exports.ScopedSettingOwnership = ScopedSettingOwnership = {}));
-exports.ScopedSettingDefinitionSchema = zod_1.z
-    .object({
-    key: exports.ScopedSettingKeySchema,
-    declarableAt: zod_1.z
-        .array(space_1.SpaceKindSchema)
-        .min(1, 'A scoped setting must be declarable somewhere.')
-        .refine((kinds) => new Set(kinds).size === kinds.length, 'A tier may appear at most once in `declarableAt`.'),
-})
-    .strict();
-function mayDeclareAt(definition, tier) {
-    return definition.declarableAt.includes(tier);
-}
-function scopedSettingOwnership(definition) {
-    const tiers = new Set(definition.declarableAt);
-    const org = tiers.has(space_1.SpaceKind.Org);
-    const project = tiers.has(space_1.SpaceKind.Project);
-    if (tiers.size === 1 && org)
-        return ScopedSettingOwnership.OrgOnly;
-    if (tiers.size === 1 && project)
-        return ScopedSettingOwnership.ProjectOnly;
-    if (tiers.size === 2 && org && project) {
-        return ScopedSettingOwnership.ProjectOverridable;
-    }
-    return ScopedSettingOwnership.Other;
-}
-function resolveScopedSetting(definition, declarations) {
-    for (const declaration of declarations) {
-        if (!mayDeclareAt(definition, declaration.ownerSpaceKind)) {
-            throw new Error(`A value was declared at "${declaration.ownerSpaceKind}", which this ` +
-                `setting does not admit (declarable at: ${definition.declarableAt.join(', ')}).`);
-        }
-        (0, space_kind_rank_1.spaceKindRank)(declaration.ownerSpaceKind);
-    }
-    return (0, scoped_resolution_1.resolveScopedCandidate)(declarations.map((declaration) => ({
-        ownerSpaceKind: declaration.ownerSpaceKind,
-        value: declaration.value,
-    })), () => 0);
-}
-//# sourceMappingURL=scoped-setting.js.map

package/dist/space/lib/scoped-setting.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scoped-setting.js","sourceRoot":"","sources":["../../../src/space/lib/scoped-setting.ts"],"names":[],"mappings":";;;AAmHA,oCAKC;AASD,wDAYC;AAiBD,oDA0BC;AAxLD,6BAAwB;AAExB,2DAAoF;AACpF,mCAAqD;AACrD,uDAAkD;AA6DrC,QAAA,0BAA0B,GACrC,0CAA0C,CAAC;AAEhC,QAAA,sBAAsB,GAAG,OAAC;KACpC,MAAM,EAAE;KACR,KAAK,CACJ,kCAA0B,EAC1B,wEAAwE,CACzE,CAAC;AAGJ,IAAY,sBAMX;AAND,WAAY,sBAAsB;IAChC,8CAAoB,CAAA;IACpB,oEAA0C,CAAA;IAC1C,sDAA4B,CAAA;IAE5B,yCAAe,CAAA;AACjB,CAAC,EANW,sBAAsB,sCAAtB,sBAAsB,QAMjC;AAaY,QAAA,6BAA6B,GAAG,OAAC;KAC3C,MAAM,CAAC;IACN,GAAG,EAAE,8BAAsB;IAC3B,YAAY,EAAE,OAAC;SACZ,KAAK,CAAC,uBAAe,CAAC;SACtB,GAAG,CAAC,CAAC,EAAE,gDAAgD,CAAC;SACxD,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAC/C,mDAAmD,CACpD;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AASZ,SAAgB,YAAY,CAC1B,UAAyD,EACzD,IAAe;IAEf,OAAO,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AASD,SAAgB,sBAAsB,CACpC,UAAyD;IAEzD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,iBAAS,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,iBAAS,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG;QAAE,OAAO,sBAAsB,CAAC,OAAO,CAAC;IACnE,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,OAAO;QAAE,OAAO,sBAAsB,CAAC,WAAW,CAAC;IAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC,kBAAkB,CAAC;IACnD,CAAC;IACD,OAAO,sBAAsB,CAAC,KAAK,CAAC;AACtC,CAAC;AAiBD,SAAgB,oBAAoB,CAClC,UAAiE,EACjE,YAAyD;IAEzD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,4BAA4B,WAAW,CAAC,cAAc,gBAAgB;gBACpE,0CAA0C,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACnF,CAAC;QACJ,CAAC;QAGD,IAAA,+BAAa,EAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAA,0CAAsB,EAC3B,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACjC,cAAc,EAAE,WAAW,CAAC,cAAc;QAC1C,KAAK,EAAE,WAAW,CAAC,KAAK;KACzB,CAAC,CAAC,EAKH,GAAG,EAAE,CAAC,CAAC,CACR,CAAC;AACJ,CAAC"}