@xemahq/contracts 0.78.0 → 0.80.0

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

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingDefinitionSchema = void 0;
+exports.stampSettingDefinition = stampSettingDefinition;
+exports.settingDefaultValue = settingDefaultValue;
+exports.mayDeclareAt = mayDeclareAt;
+exports.settingOwnership = settingOwnership;
+const zod_1 = require("zod");
+const space_1 = require("../../space");
+const setting_constraints_1 = require("./setting-constraints");
+const setting_enums_1 = require("./setting-enums");
+const setting_key_1 = require("./setting-key");
+const setting_value_1 = require("./setting-value");
+const common = {
+    name: setting_key_1.SettingNameSchema,
+    major: setting_key_1.SettingMajorSchema,
+    title: zod_1.z.string().min(1).max(120),
+    description: zod_1.z.string().min(1).max(2000),
+    unit: zod_1.z.string().min(1).max(32).optional(),
+    declarableAt: zod_1.z.array(space_1.SpaceKindSchema).min(1),
+    merge: setting_enums_1.SettingMergeSchema,
+};
+const BooleanArm = zod_1.z
+    .object({
+    ...common,
+    valueType: zod_1.z.literal(setting_enums_1.SettingValueType.Boolean),
+    default: zod_1.z.boolean(),
+    tighter: zod_1.z.boolean().optional(),
+})
+    .strict();
+const IntegerArm = zod_1.z
+    .object({
+    ...common,
+    valueType: zod_1.z.literal(setting_enums_1.SettingValueType.Integer),
+    constraints: setting_constraints_1.IntegerConstraintsSchema,
+    default: zod_1.z.number(),
+    tighter: setting_enums_1.SettingTighterDirectionSchema.optional(),
+})
+    .strict();
+const DurationArm = zod_1.z
+    .object({
+    ...common,
+    valueType: zod_1.z.literal(setting_enums_1.SettingValueType.Duration),
+    constraints: setting_constraints_1.DurationConstraintsSchema,
+    default: zod_1.z.string(),
+    tighter: setting_enums_1.SettingTighterDirectionSchema.optional(),
+})
+    .strict();
+const EnumArm = zod_1.z
+    .object({
+    ...common,
+    valueType: zod_1.z.literal(setting_enums_1.SettingValueType.Enum),
+    constraints: setting_constraints_1.EnumConstraintsSchema,
+    default: zod_1.z.string(),
+    tighter: zod_1.z.never().optional(),
+})
+    .strict();
+exports.SettingDefinitionSchema = zod_1.z
+    .discriminatedUnion("valueType", [
+    BooleanArm,
+    IntegerArm,
+    DurationArm,
+    EnumArm,
+])
+    .superRefine((def, ctx) => {
+    try {
+        for (const kind of def.declarableAt) {
+            (0, space_1.assertSpaceKindAdmissible)(setting_enums_1.SETTING_REGISTRY, kind, setting_enums_1.SETTING_SPACE_KINDS);
+        }
+    }
+    catch (error) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["declarableAt"],
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+    if (new Set(def.declarableAt).size !== def.declarableAt.length) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["declarableAt"],
+            message: "A tier may appear at most once in `declarableAt`.",
+        });
+    }
+    const needsTighter = def.merge === setting_enums_1.SettingMerge.Tighten &&
+        def.valueType !== setting_enums_1.SettingValueType.Enum;
+    if (needsTighter && def.tighter === undefined) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["tighter"],
+            message: "A `tighten` setting must declare which end is tighter.",
+        });
+    }
+    if (!needsTighter && def.tighter !== undefined) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["tighter"],
+            message: "`tighter` is only declared by a `tighten` boolean, integer or duration setting.",
+        });
+    }
+    if (def.valueType === setting_enums_1.SettingValueType.Boolean ||
+        def.valueType === setting_enums_1.SettingValueType.Enum ||
+        def.valueType === setting_enums_1.SettingValueType.Integer ||
+        def.valueType === setting_enums_1.SettingValueType.Duration) {
+        const checked = (0, setting_value_1.settingValueSchema)(def).safeParse(def.default);
+        if (!checked.success) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["default"],
+                message: `The default must satisfy the constraints: ${checked.error.issues
+                    .map((issue) => issue.message)
+                    .join("; ")}`,
+            });
+        }
+    }
+});
+function stampSettingDefinition(authored, declaringBiomeId) {
+    const def = exports.SettingDefinitionSchema.parse(authored);
+    const namespace = setting_key_1.SettingNamespaceSchema.parse(declaringBiomeId);
+    return {
+        ...def,
+        namespace,
+        key: (0, setting_key_1.formatSettingKey)({ namespace, name: def.name, major: def.major }),
+    };
+}
+function settingDefaultValue(def) {
+    return (0, setting_value_1.settingValueSchema)(def).parse(def.default);
+}
+function mayDeclareAt(def, tier) {
+    return def.declarableAt.includes(tier);
+}
+function settingOwnership(def) {
+    const tiers = new Set(def.declarableAt);
+    const org = tiers.has(space_1.SpaceKind.Org);
+    const project = tiers.has(space_1.SpaceKind.Project);
+    if (org && project)
+        return setting_enums_1.SettingOwnership.ProjectOverridable;
+    if (project)
+        return setting_enums_1.SettingOwnership.ProjectOnly;
+    if (org)
+        return setting_enums_1.SettingOwnership.OrgOnly;
+    throw new Error("A setting must be declarable at the Org or Project tier.");
+}
+//# sourceMappingURL=setting-definition.js.map

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

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

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

@@ -0,0 +1,3 @@
+export declare function parseIsoDurationSeconds(raw: string): number;
+export declare function formatIsoDurationSeconds(totalSeconds: number): string;
+//# sourceMappingURL=setting-duration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setting-duration.d.ts","sourceRoot":"","sources":["../../../src/setting/lib/setting-duration.ts"],"names":[],"mappings":"AAWA,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB3D;AAGD,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAkBrE"}

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

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseIsoDurationSeconds = parseIsoDurationSeconds;
+exports.formatIsoDurationSeconds = formatIsoDurationSeconds;
+const ISO_DURATION = /^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/u;
+const SECONDS_PER_MINUTE = 60;
+const SECONDS_PER_HOUR = 3600;
+const SECONDS_PER_DAY = 86400;
+function parseIsoDurationSeconds(raw) {
+    const match = ISO_DURATION.exec(raw);
+    if (match === null || raw === "P" || raw.endsWith("T")) {
+        throw new Error(`"${raw}" is not an admitted ISO-8601 duration (days, hours, minutes, seconds only; e.g. "PT5M").`);
+    }
+    const [, days, hours, minutes, seconds] = match.map((part) => part === undefined ? 0 : Number(part));
+    const total = days * SECONDS_PER_DAY +
+        hours * SECONDS_PER_HOUR +
+        minutes * SECONDS_PER_MINUTE +
+        seconds;
+    if (!Number.isSafeInteger(total)) {
+        throw new Error(`Duration "${raw}" is out of range.`);
+    }
+    return total;
+}
+function formatIsoDurationSeconds(totalSeconds) {
+    if (!Number.isSafeInteger(totalSeconds) || totalSeconds < 0) {
+        throw new Error(`${totalSeconds} is not a whole non-negative number of seconds.`);
+    }
+    if (totalSeconds === 0)
+        return "PT0S";
+    const days = Math.floor(totalSeconds / SECONDS_PER_DAY);
+    const hours = Math.floor((totalSeconds % SECONDS_PER_DAY) / SECONDS_PER_HOUR);
+    const minutes = Math.floor((totalSeconds % SECONDS_PER_HOUR) / SECONDS_PER_MINUTE);
+    const seconds = totalSeconds % SECONDS_PER_MINUTE;
+    const time = (hours > 0 ? `${hours}H` : "") +
+        (minutes > 0 ? `${minutes}M` : "") +
+        (seconds > 0 ? `${seconds}S` : "");
+    return `P${days > 0 ? `${days}D` : ""}${time === "" ? "" : `T${time}`}`;
+}
+//# sourceMappingURL=setting-duration.js.map

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":"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"}

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":";;AASA,4EAoDC;AAED,oDAKC;AAED,4DAWC;AAhFD,mDAAmD;AAQnD,SAAgB,gCAAgC,CAC9C,IAAuB,EACvB,IAAuB;IAEvB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACzD,OAAO;YACL,iFAAiF;SAClF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;QAAE,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACrE,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;QAAE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACzD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;QAAE,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,SAAS,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC9D,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/B,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,gCAAgB,CAAC,OAAO;YAC3B,MAAM;QACR,KAAK,gCAAgB,CAAC,OAAO;YAC3B,IAAI,IAAI,CAAC,SAAS,KAAK,gCAAgB,CAAC,OAAO,EAAE,CAAC;gBAChD,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG;oBAC7C,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBAC7B,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG;oBAC7C,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAChC,CAAC;YACD,MAAM;QACR,KAAK,gCAAgB,CAAC,QAAQ;YAC5B,IAAI,IAAI,CAAC,SAAS,KAAK,gCAAgB,CAAC,QAAQ,EAAE,CAAC;gBACjD,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;oBAC9D,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;gBACpC,CAAC;gBACD,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;oBAC9D,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YACD,MAAM;QACR,KAAK,gCAAgB,CAAC,IAAI;YACxB,IAAI,IAAI,CAAC,SAAS,KAAK,gCAAgB,CAAC,IAAI,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CACxC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAC3D,CAAC;gBACF,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,GAAG,CAAC,IAAI,CACN,8DAA8D,CAC/D,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM;IACV,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,oBAAoB,CAClC,IAAuB,EACvB,IAAuB;IAEvB,OAAO,gCAAgC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,SAAgB,wBAAwB,CACtC,IAAuB,EACvB,IAAuB;IAEvB,MAAM,QAAQ,GAAG,gCAAgC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,YAAY,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,+BAA+B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACvF,kBAAkB,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,CACtC,CAAC;IACJ,CAAC;AACH,CAAC"}

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"}