@xemahq/contracts 0.6.0 → 0.7.0

package/dist/.source-stamp.json

@@ -1,5 +1,5 @@
 {
   "algorithm": "sha256/len-framed-v1",
-  "hash": "215a5086538b6716d986c0902e636d5df1c7db96d68ed3200185b4637ed0b4ff",
-  "fileCount": 515
+  "hash": "6dd1fc61af526dcbe627bbde3197d58bdbde23fffabebffb75e00a266bcda1c7",
+  "fileCount": 516
 }

package/dist/space/index.d.ts

@@ -2,6 +2,7 @@ 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,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,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"}

package/dist/space/index.js

@@ -18,6 +18,7 @@ __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,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,uDAAqC;AACrC,wDAAsC;AACtC,yDAAuC;AACvC,wDAAsC;AACtC,wDAAsC;AACtC,+DAA6C;AAC7C,+DAA6C"}

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

@@ -0,0 +1,28 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,60 @@
+"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

@@ -0,0 +1 @@
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/contracts",
-  "version": "0.6.0",
+  "version": "0.7.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/runtime deps.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",