@lssm/lib.contracts 1.11.0 → 1.41.0

package/dist/experiments/evaluator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"evaluator.js","names":[],"sources":["../../src/experiments/evaluator.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport type { PolicyRef } from '../policy/spec';\nimport type {\n  ExperimentRegistry,\n  ExperimentSpec,\n  ExperimentVariant,\n  TargetingRule,\n} from './spec';\n\nexport interface ExperimentContext {\n  experiment: string;\n  version?: number;\n  userId?: string | null;\n  organizationId?: string | null;\n  sessionId?: string | null;\n  attributes?: Record<string, unknown>;\n  flags?: string[];\n}\n\nexport interface ExperimentEvaluation {\n  variant: ExperimentVariant;\n  reason: 'control' | 'random' | 'sticky' | 'targeted';\n}\n\nexport interface ExperimentEvaluatorConfig {\n  registry: ExperimentRegistry;\n  policyChecker?: (\n    policy: PolicyRef,\n    context: ExperimentContext\n  ) => Promise<boolean> | boolean;\n  expressionEvaluator?: (\n    expression: string,\n    context: ExperimentContext\n  ) => boolean;\n}\n\nexport class ExperimentEvaluator {\n  private readonly registry: ExperimentRegistry;\n  private readonly policyChecker?: ExperimentEvaluatorConfig['policyChecker'];\n  private readonly expressionEvaluator?: ExperimentEvaluatorConfig['expressionEvaluator'];\n\n  constructor(config: ExperimentEvaluatorConfig) {\n    this.registry = config.registry;\n    this.policyChecker = config.policyChecker;\n    this.expressionEvaluator = config.expressionEvaluator;\n  }\n\n  async chooseVariant(\n    context: ExperimentContext\n  ): Promise<ExperimentEvaluation | null> {\n    const experiment = this.registry.get(context.experiment, context.version);\n    if (!experiment) return null;\n\n    const control = experiment.variants.find(\n      (variant) => variant.id === experiment.controlVariant\n    );\n    if (!control)\n      throw new Error(\n        `Experiment ${experiment.meta.name} missing control variant ${experiment.controlVariant}`\n      );\n\n    switch (experiment.allocation.type) {\n      case 'random':\n        return {\n          variant: this.pickByWeight(\n            experiment,\n            this.randomSeed(context, experiment.allocation.salt)\n          ),\n          reason: 'random',\n        };\n      case 'sticky':\n        return {\n          variant: this.pickByWeight(\n            experiment,\n            this.stickySeed(\n              context,\n              experiment.allocation.attribute,\n              experiment.allocation.salt\n            )\n          ),\n          reason: 'sticky',\n        };\n      case 'targeted': {\n        const targeted = await this.evaluateTargeting(\n          experiment,\n          context,\n          experiment.allocation.rules\n        );\n        if (targeted) {\n          return {\n            variant: targeted,\n            reason: 'targeted',\n          };\n        }\n        if (experiment.allocation.fallback === 'random') {\n          return {\n            variant: this.pickByWeight(experiment, this.randomSeed(context)),\n            reason: 'random',\n          };\n        }\n        return {\n          variant: control,\n          reason: 'control',\n        };\n      }\n      default:\n        return {\n          variant: control,\n          reason: 'control',\n        };\n    }\n  }\n\n  private pickByWeight(\n    experiment: ExperimentSpec,\n    seed: number\n  ): ExperimentVariant {\n    const variants = experiment.variants;\n    const totalWeight = variants.reduce(\n      (sum, variant) => sum + (variant.weight ?? 1),\n      0\n    );\n    const target = seed * totalWeight;\n    let cumulative = 0;\n    for (const variant of variants) {\n      cumulative += variant.weight ?? 1;\n      if (target <= cumulative) {\n        return variant;\n      }\n    }\n    return variants[variants.length - 1]!;\n  }\n\n  private randomSeed(context: ExperimentContext, salt = ''): number {\n    const base =\n      context.sessionId ??\n      context.userId ??\n      context.organizationId ??\n      `${Date.now()}-${Math.random()}`;\n    return this.hashToUnitInterval(base + salt);\n  }\n\n  private stickySeed(\n    context: ExperimentContext,\n    attribute: 'userId' | 'organizationId' | 'sessionId',\n    salt = ''\n  ): number {\n    const value = context[attribute];\n    if (!value) return this.randomSeed(context, salt);\n    return this.hashToUnitInterval(`${value}-${salt}`);\n  }\n\n  private hashToUnitInterval(value: string): number {\n    const hash = createHash('sha256').update(value).digest('hex').slice(0, 15);\n    const intValue = parseInt(hash, 16);\n    return (intValue % 1_000_000) / 1_000_000;\n  }\n\n  private async evaluateTargeting(\n    experiment: ExperimentSpec,\n    context: ExperimentContext,\n    rules: TargetingRule[]\n  ): Promise<ExperimentVariant | null> {\n    for (const rule of rules) {\n      if (!(await this.matchesRule(rule, context))) continue;\n      const variant = experiment.variants.find((v) => v.id === rule.variantId);\n      if (!variant) continue;\n      if (typeof rule.percentage === 'number') {\n        const seed = this.randomSeed(context, `rule-${rule.variantId}`);\n        if (seed > rule.percentage) {\n          continue;\n        }\n      }\n      return variant;\n    }\n    return null;\n  }\n\n  private async matchesRule(\n    rule: TargetingRule,\n    context: ExperimentContext\n  ): Promise<boolean> {\n    if (rule.policy && this.policyChecker) {\n      const allowed = await this.policyChecker(rule.policy, context);\n      if (!allowed) return false;\n    }\n    if (rule.expression) {\n      if (this.expressionEvaluator) {\n        return Boolean(this.expressionEvaluator(rule.expression, context));\n      }\n      try {\n        const fn = new Function('context', `return (${rule.expression});`);\n        return Boolean(fn(context));\n      } catch (_error) {\n        return false;\n      }\n    }\n    return true;\n  }\n}\n"],"mappings":"yCAoCA,IAAa,EAAb,KAAiC,CAC/B,SACA,cACA,oBAEA,YAAY,EAAmC,CAC7C,KAAK,SAAW,EAAO,SACvB,KAAK,cAAgB,EAAO,cAC5B,KAAK,oBAAsB,EAAO,oBAGpC,MAAM,cACJ,EACsC,CACtC,IAAM,EAAa,KAAK,SAAS,IAAI,EAAQ,WAAY,EAAQ,QAAQ,CACzE,GAAI,CAAC,EAAY,OAAO,KAExB,IAAM,EAAU,EAAW,SAAS,KACjC,GAAY,EAAQ,KAAO,EAAW,eACxC,CACD,GAAI,CAAC,EACH,MAAU,MACR,cAAc,EAAW,KAAK,KAAK,2BAA2B,EAAW,iBAC1E,CAEH,OAAQ,EAAW,WAAW,KAA9B,CACE,IAAK,SACH,MAAO,CACL,QAAS,KAAK,aACZ,EACA,KAAK,WAAW,EAAS,EAAW,WAAW,KAAK,CACrD,CACD,OAAQ,SACT,CACH,IAAK,SACH,MAAO,CACL,QAAS,KAAK,aACZ,EACA,KAAK,WACH,EACA,EAAW,WAAW,UACtB,EAAW,WAAW,KACvB,CACF,CACD,OAAQ,SACT,CACH,IAAK,WAAY,CACf,IAAM,EAAW,MAAM,KAAK,kBAC1B,EACA,EACA,EAAW,WAAW,MACvB,CAaD,OAZI,EACK,CACL,QAAS,EACT,OAAQ,WACT,CAEC,EAAW,WAAW,WAAa,SAC9B,CACL,QAAS,KAAK,aAAa,EAAY,KAAK,WAAW,EAAQ,CAAC,CAChE,OAAQ,SACT,CAEI,CACL,QAAS,EACT,OAAQ,UACT,CAEH,QACE,MAAO,CACL,QAAS,EACT,OAAQ,UACT,EAIP,aACE,EACA,EACmB,CACnB,IAAM,EAAW,EAAW,SAKtB,EAAS,EAJK,EAAS,QAC1B,EAAK,IAAY,GAAO,EAAQ,QAAU,GAC3C,EACD,CAEG,EAAa,EACjB,IAAK,IAAM,KAAW,EAEpB,GADA,GAAc,EAAQ,QAAU,EAC5B,GAAU,EACZ,OAAO,EAGX,OAAO,EAAS,EAAS,OAAS,GAGpC,WAAmB,EAA4B,EAAO,GAAY,CAChE,IAAM,EACJ,EAAQ,WACR,EAAQ,QACR,EAAQ,gBACR,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,GAChC,OAAO,KAAK,mBAAmB,EAAO,EAAK,CAG7C,WACE,EACA,EACA,EAAO,GACC,CACR,IAAM,EAAQ,EAAQ,GAEtB,OADK,EACE,KAAK,mBAAmB,GAAG,EAAM,GAAG,IAAO,CAD/B,KAAK,WAAW,EAAS,EAAK,CAInD,mBAA2B,EAAuB,CAChD,IAAM,EAAO,EAAW,SAAS,CAAC,OAAO,EAAM,CAAC,OAAO,MAAM,CAAC,MAAM,EAAG,GAAG,CAE1E,OADiB,SAAS,EAAM,GAAG,CAChB,IAAa,IAGlC,MAAc,kBACZ,EACA,EACA,EACmC,CACnC,IAAK,IAAM,KAAQ,EAAO,CACxB,GAAI,CAAE,MAAM,KAAK,YAAY,EAAM,EAAQ,CAAG,SAC9C,IAAM,EAAU,EAAW,SAAS,KAAM,GAAM,EAAE,KAAO,EAAK,UAAU,CACnE,QACD,OAAO,EAAK,YAAe,UAChB,KAAK,WAAW,EAAS,QAAQ,EAAK,YAAY,CACpD,EAAK,YAIlB,OAAO,EAET,OAAO,KAGT,MAAc,YACZ,EACA,EACkB,CAClB,GAAI,EAAK,QAAU,KAAK,eAElB,CADY,MAAM,KAAK,cAAc,EAAK,OAAQ,EAAQ,CAChD,MAAO,GAEvB,GAAI,EAAK,WAAY,CACnB,GAAI,KAAK,oBACP,MAAO,EAAQ,KAAK,oBAAoB,EAAK,WAAY,EAAQ,CAEnE,GAAI,CAEF,MAAO,EADQ,SAAS,UAAW,WAAW,EAAK,WAAW,IAAI,CAChD,EAAQ,MACX,CACf,MAAO,IAGX,MAAO"}

package/dist/experiments/spec-resolver.d.ts

@@ -1,17 +0,0 @@
-import { ResourceRefDescriptor } from "../resources.js";
-import { ContractSpec, OpKind } from "../spec.js";
-import { HandlerCtx } from "../types.js";
-import { AnySchemaModel } from "@lssm/lib.schema";
-
-//#region src/experiments/spec-resolver.d.ts
-type RuntimeContract = ContractSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>;
-interface SpecVariantResolver {
-  resolve(operation: {
-    name: string;
-    version: number;
-    kind: OpKind;
-  }, ctx: HandlerCtx): Promise<RuntimeContract | undefined> | RuntimeContract | undefined;
-}
-//#endregion
-export { RuntimeContract, SpecVariantResolver };
-//# sourceMappingURL=spec-resolver.d.ts.map

package/dist/experiments/spec-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-resolver.d.ts","names":[],"sources":["../../src/experiments/spec-resolver.ts"],"sourcesContent":[],"mappings":";;;;;;KAKY,eAAA,GAAkB,aAC5B,gBACA,iBAAiB;UAGF,mBAAA;EALL,OAAA,CAAA,SAAA,EAAe;IACzB,IAAA,EAAA,MAAA;IACA,OAAA,EAAA,MAAA;IAAiB,IAAA,EAKmC,MALnC;EAFW,CAAA,EAAA,GAAA,EAQrB,UARqB,CAAA,EASzB,OATyB,CASjB,eATiB,GAAA,SAAA,CAAA,GASc,eATd,GAAA,SAAA"}

package/dist/experiments/spec.d.ts

@@ -1,90 +0,0 @@
-import { OwnerShipMeta } from "../ownership.js";
-import { PolicyRef } from "../policy/spec.js";
-import { TelemetryEventDef } from "../telemetry/spec.js";
-
-//#region src/experiments/spec.d.ts
-interface ExperimentMeta extends OwnerShipMeta {
-  /** Fully-qualified experiment name (e.g., "sigil.onboarding.variant"). */
-  name: string;
-  /** Version of the experiment; bump when allocation or variants change materially. */
-  version: number;
-  /** Domain/bounded context (e.g., "onboarding"). */
-  domain: string;
-}
-interface ExperimentRef {
-  name: string;
-  version?: number;
-}
-type ExperimentOverrideType = 'dataView' | 'workflow' | 'theme' | 'policy' | 'presentation';
-interface ExperimentOverride {
-  type: ExperimentOverrideType;
-  /** Target spec meta name (e.g., DataViewSpec.meta.name). */
-  target: string;
-  /** Target version. Optional; evaluator may choose latest when omitted. */
-  version?: number;
-  /** Optional configuration applied when this variant is active. */
-  config?: Record<string, unknown>;
-}
-interface ExperimentVariant {
-  id: string;
-  name: string;
-  description?: string;
-  /** Relative weight for random allocation (defaults to 1). */
-  weight?: number;
-  overrides?: ExperimentOverride[];
-  /** Optional metadata for downstream analytics/UI. */
-  metadata?: Record<string, unknown>;
-}
-interface TargetingRule {
-  /** Variant to assign when rule matches. */
-  variantId: string;
-  /** Optional percentage of matching traffic (0-1). If omitted, 100%. */
-  percentage?: number;
-  /** Policies that must allow the assignment. */
-  policy?: PolicyRef;
-  /** Expression evaluated against context (see evaluator for details). */
-  expression?: string;
-}
-type AllocationStrategy = {
-  type: 'random';
-  /** Optional salt for deterministic hashing. */
-  salt?: string;
-} | {
-  type: 'sticky';
-  /** Which attribute to hash for sticky assignment. */
-  attribute: 'userId' | 'organizationId' | 'sessionId';
-  salt?: string;
-} | {
-  type: 'targeted';
-  rules: TargetingRule[];
-  fallback?: 'control' | 'random';
-};
-type MetricAggregation = 'count' | 'avg' | 'p75' | 'p90' | 'p95' | 'p99';
-interface SuccessMetric {
-  name: string;
-  telemetryEvent: {
-    name: TelemetryEventDef['name'];
-    version: number;
-  };
-  aggregation: MetricAggregation;
-  target?: number;
-}
-interface ExperimentSpec {
-  meta: ExperimentMeta;
-  /** Identifier of the control variant (must exist in variants array). */
-  controlVariant: string;
-  variants: ExperimentVariant[];
-  allocation: AllocationStrategy;
-  successMetrics?: SuccessMetric[];
-  tags?: string[];
-}
-declare class ExperimentRegistry {
-  private readonly items;
-  register(spec: ExperimentSpec): this;
-  list(): ExperimentSpec[];
-  get(name: string, version?: number): ExperimentSpec | undefined;
-}
-declare function makeExperimentKey(meta: ExperimentMeta): string;
-//#endregion
-export { AllocationStrategy, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, MetricAggregation, SuccessMetric, TargetingRule, makeExperimentKey };
-//# sourceMappingURL=spec.d.ts.map

package/dist/experiments/spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/experiments/spec.ts"],"sourcesContent":[],"mappings":";;;;;UAIiB,cAAA,SAAuB;;EAAvB,IAAA,EAAA,MAAA;EASA;EAKL,OAAA,EAAA,MAAA;EAOK;EAUA,MAAA,EAAA,MAAA;AAWjB;AAWY,UA5CK,aAAA,CA4Ca;EAkBlB,IAAA,EAAA,MAAA;EAEK,OAAA,CAAA,EAAA,MAAa;AAO9B;AACQ,KAnEI,sBAAA,GAmEJ,UAAA,GAAA,UAAA,GAAA,OAAA,GAAA,QAAA,GAAA,cAAA;AAGI,UA/DK,kBAAA,CA+DL;EACE,IAAA,EA/DN,sBA+DM;EACK;EAAa,MAAA,EAAA,MAAA;EAMnB;EAGI,OAAA,CAAA,EAAA,MAAA;EASP;EAI6B,MAAA,CAAA,EAhF5B,MAgF4B,CAAA,MAAA,EAAA,OAAA,CAAA;;AAiBvB,UA9FC,iBAAA,CA8FgB;;;;;;cAxFnB;;aAED;;UAGI,aAAA;;;;;;WAMN;;;;KAKC,kBAAA;;;;;;;;;;;SAcC;;;KAID,iBAAA;UAEK,aAAA;;;UAES;;;eACX;;;UAIE,cAAA;QACT;;;YAGI;cACE;mBACK;;;cAMN,kBAAA;;iBAGI;UASP;uCAI6B;;iBAiBvB,iBAAA,OAAwB"}

package/dist/experiments/spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec.js","names":["latest: ExperimentSpec | undefined"],"sources":["../../src/experiments/spec.ts"],"sourcesContent":["import type { OwnerShipMeta } from '../ownership';\nimport type { PolicyRef } from '../policy/spec';\nimport type { TelemetryEventDef } from '../telemetry/spec';\n\nexport interface ExperimentMeta extends OwnerShipMeta {\n  /** Fully-qualified experiment name (e.g., \"sigil.onboarding.variant\"). */\n  name: string;\n  /** Version of the experiment; bump when allocation or variants change materially. */\n  version: number;\n  /** Domain/bounded context (e.g., \"onboarding\"). */\n  domain: string;\n}\n\nexport interface ExperimentRef {\n  name: string;\n  version?: number;\n}\n\nexport type ExperimentOverrideType =\n  | 'dataView'\n  | 'workflow'\n  | 'theme'\n  | 'policy'\n  | 'presentation';\n\nexport interface ExperimentOverride {\n  type: ExperimentOverrideType;\n  /** Target spec meta name (e.g., DataViewSpec.meta.name). */\n  target: string;\n  /** Target version. Optional; evaluator may choose latest when omitted. */\n  version?: number;\n  /** Optional configuration applied when this variant is active. */\n  config?: Record<string, unknown>;\n}\n\nexport interface ExperimentVariant {\n  id: string;\n  name: string;\n  description?: string;\n  /** Relative weight for random allocation (defaults to 1). */\n  weight?: number;\n  overrides?: ExperimentOverride[];\n  /** Optional metadata for downstream analytics/UI. */\n  metadata?: Record<string, unknown>;\n}\n\nexport interface TargetingRule {\n  /** Variant to assign when rule matches. */\n  variantId: string;\n  /** Optional percentage of matching traffic (0-1). If omitted, 100%. */\n  percentage?: number;\n  /** Policies that must allow the assignment. */\n  policy?: PolicyRef;\n  /** Expression evaluated against context (see evaluator for details). */\n  expression?: string;\n}\n\nexport type AllocationStrategy =\n  | {\n      type: 'random';\n      /** Optional salt for deterministic hashing. */\n      salt?: string;\n    }\n  | {\n      type: 'sticky';\n      /** Which attribute to hash for sticky assignment. */\n      attribute: 'userId' | 'organizationId' | 'sessionId';\n      salt?: string;\n    }\n  | {\n      type: 'targeted';\n      rules: TargetingRule[];\n      fallback?: 'control' | 'random';\n    };\n\nexport type MetricAggregation = 'count' | 'avg' | 'p75' | 'p90' | 'p95' | 'p99';\n\nexport interface SuccessMetric {\n  name: string;\n  telemetryEvent: { name: TelemetryEventDef['name']; version: number };\n  aggregation: MetricAggregation;\n  target?: number;\n}\n\nexport interface ExperimentSpec {\n  meta: ExperimentMeta;\n  /** Identifier of the control variant (must exist in variants array). */\n  controlVariant: string;\n  variants: ExperimentVariant[];\n  allocation: AllocationStrategy;\n  successMetrics?: SuccessMetric[];\n  tags?: string[];\n}\n\nconst experimentKey = (meta: ExperimentMeta) => `${meta.name}.v${meta.version}`;\n\nexport class ExperimentRegistry {\n  private readonly items = new Map<string, ExperimentSpec>();\n\n  register(spec: ExperimentSpec): this {\n    const key = experimentKey(spec.meta);\n    if (this.items.has(key)) {\n      throw new Error(`Duplicate experiment ${key}`);\n    }\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): ExperimentSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): ExperimentSpec | undefined {\n    if (version != null) {\n      return this.items.get(`${name}.v${version}`);\n    }\n    let latest: ExperimentSpec | undefined;\n    let maxVersion = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > maxVersion) {\n        maxVersion = spec.meta.version;\n        latest = spec;\n      }\n    }\n    return latest;\n  }\n}\n\nexport function makeExperimentKey(meta: ExperimentMeta) {\n  return experimentKey(meta);\n}\n"],"mappings":"AA8FA,MAAM,EAAiB,GAAyB,GAAG,EAAK,KAAK,IAAI,EAAK,UAEtE,IAAa,EAAb,KAAgC,CAC9B,MAAyB,IAAI,IAE7B,SAAS,EAA4B,CACnC,IAAM,EAAM,EAAc,EAAK,KAAK,CACpC,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,wBAAwB,IAAM,CAGhD,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAAyB,CACvB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAA8C,CAC9D,GAAI,GAAW,KACb,OAAO,KAAK,MAAM,IAAI,GAAG,EAAK,IAAI,IAAU,CAE9C,IAAIA,EACA,EAAa,KACjB,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAa,EAAK,KAAK,QACvB,EAAS,GAGb,OAAO,IAIX,SAAgB,EAAkB,EAAsB,CACtD,OAAO,EAAc,EAAK"}

package/dist/features.d.ts

@@ -1,88 +0,0 @@
-import { OwnerShipMeta } from "./ownership.js";
-import { CapabilityRef, CapabilityRegistry, CapabilityRequirement } from "./capabilities.js";
-import { PresentationRegistry } from "./presentations.js";
-import { PresentationDescriptorV2, PresentationTarget } from "./presentations.v2.js";
-import { ExperimentRef } from "./experiments/spec.js";
-import { SpecRegistry } from "./registry.js";
-
-//#region src/features.d.ts
-/** Minimal metadata to identify and categorize a feature module. */
-interface FeatureModuleMeta extends OwnerShipMeta {
-  /** Stable slug key used to identify this feature (e.g., "weekly_pulse"). */
-  key: string;
-}
-interface OpRef {
-  /** Operation name (ContractSpec.meta.name). */
-  name: string;
-  /** Operation version (ContractSpec.meta.version). */
-  version: number;
-}
-interface EventRef {
-  /** Event name. */
-  name: string;
-  /** Event version. */
-  version: number;
-}
-interface PresentationRef {
-  /** Presentation name. */
-  name: string;
-  /** Presentation version. */
-  version: number;
-}
-/** Group operations/events/presentations into an installable feature. */
-interface FeatureModuleSpec {
-  meta: FeatureModuleMeta;
-  /** Contract operations included in this feature. */
-  operations?: OpRef[];
-  /** Events declared/emitted by this feature. */
-  events?: EventRef[];
-  /** Presentations associated to this feature. */
-  presentations?: PresentationRef[];
-  /** Experiments related to this feature. */
-  experiments?: ExperimentRef[];
-  /** Capability bindings exposed/required by this feature. */
-  capabilities?: {
-    provides?: CapabilityRef[];
-    requires?: CapabilityRequirement[];
-  };
-  /** Optional: link ops to presentations for traceability (e.g., ui for op) */
-  opToPresentation?: {
-    op: OpRef;
-    pres: PresentationRef;
-  }[];
-  /** Optional: declare per-presentation target requirements (V2 descriptors) */
-  presentationsTargets?: {
-    /** Presentation name. */
-    name: string;
-    /** Presentation version. */
-    version: number;
-    /** Required targets that must be supported by the descriptor. */
-    targets: PresentationTarget[];
-  }[];
-}
-interface FeatureRef {
-  key: string;
-}
-/** In-memory registry for FeatureModuleSpec. */
-declare class FeatureRegistry {
-  private items;
-  /** Register a feature module. Throws when the key already exists. */
-  register(f: FeatureModuleSpec): this;
-  /** List all registered feature modules. */
-  list(): FeatureModuleSpec[];
-  /** Get a feature by its key (slug). */
-  get(key: string): FeatureModuleSpec | undefined;
-}
-/** Validate and register a feature against optional registries/descriptors. */
-declare function installFeature(feature: FeatureModuleSpec, deps: {
-  features: FeatureRegistry;
-  ops?: SpecRegistry;
-  presentations?: PresentationRegistry;
-  descriptorsV2?: PresentationDescriptorV2[];
-  capabilities?: CapabilityRegistry;
-}): FeatureRegistry;
-/** Ensure declared target requirements exist on the provided descriptors. */
-declare function validateFeatureTargetsV2(feature: FeatureModuleSpec, descriptors: PresentationDescriptorV2[]): boolean;
-//#endregion
-export { EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, OpRef, PresentationRef, installFeature, validateFeatureTargetsV2 };
-//# sourceMappingURL=features.d.ts.map

package/dist/features.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"features.d.ts","names":[],"sources":["../src/features.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAaiB,iBAAA,SAA0B;;;AAA3C;AAKiB,UAAA,KAAA,CAAK;EAOL;EAOA,IAAA,EAAA,MAAA;EAQA;EACT,OAAA,EAAA,MAAA;;AAIG,UApBM,QAAA,CAoBN;EAEO;EAEF,IAAA,EAAA,MAAA;EAGD;EACA,OAAA,EAAA,MAAA;;AAGyB,UAxBvB,eAAA,CAwBuB;EAQ3B;EAAkB,IAAA,EAAA,MAAA;EAId;EASJ,OAAA,EAAA,MAAA;;;AAiBO,UAtDH,iBAAA,CAsDG;EAAiB,IAAA,EArD7B,iBAqD6B;EAMrB;EACL,UAAA,CAAA,EA1DI,KA0DJ,EAAA;EAEG;EAAe,MAAA,CAAA,EA1DlB,QA0DkB,EAAA;EACc;EAEvB,aAAA,CAAA,EA3DF,eA2DE,EAAA;EACD;EAChB,WAAA,CAAA,EA3Da,aA2Db,EAAA;EAAA;EAwFa,YAAA,CAAA,EAAA;eAhJD;eACA;;;;QAGY;UAAa;;;;;;;;;aAQ3B;;;UAII,UAAA;;;;cASJ,eAAA;;;cAIC;;UAQJ;;oBAKU;;;iBAMJ,cAAA,UACL;YAEG;QAAe;kBACc;kBAEvB;iBACD;IAChB;;iBAwFa,wBAAA,UACL,gCACI"}

package/dist/features.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"features.js","names":[],"sources":["../src/features.ts"],"sourcesContent":["import type {\n  PresentationTarget,\n  PresentationDescriptorV2,\n} from './presentations.v2';\nimport type { OwnerShipMeta } from './ownership';\nimport type {\n  CapabilityRef,\n  CapabilityRequirement,\n  CapabilityRegistry,\n} from './capabilities';\nimport type { ExperimentRef } from './experiments/spec';\n\n/** Minimal metadata to identify and categorize a feature module. */\nexport interface FeatureModuleMeta extends OwnerShipMeta {\n  /** Stable slug key used to identify this feature (e.g., \"weekly_pulse\"). */\n  key: string;\n}\n\nexport interface OpRef {\n  /** Operation name (ContractSpec.meta.name). */\n  name: string;\n  /** Operation version (ContractSpec.meta.version). */\n  version: number;\n}\n\nexport interface EventRef {\n  /** Event name. */\n  name: string;\n  /** Event version. */\n  version: number;\n}\n\nexport interface PresentationRef {\n  /** Presentation name. */\n  name: string;\n  /** Presentation version. */\n  version: number;\n}\n\n/** Group operations/events/presentations into an installable feature. */\nexport interface FeatureModuleSpec {\n  meta: FeatureModuleMeta;\n  /** Contract operations included in this feature. */\n  operations?: OpRef[];\n  /** Events declared/emitted by this feature. */\n  events?: EventRef[];\n  /** Presentations associated to this feature. */\n  presentations?: PresentationRef[];\n  /** Experiments related to this feature. */\n  experiments?: ExperimentRef[];\n  /** Capability bindings exposed/required by this feature. */\n  capabilities?: {\n    provides?: CapabilityRef[];\n    requires?: CapabilityRequirement[];\n  };\n  /** Optional: link ops to presentations for traceability (e.g., ui for op) */\n  opToPresentation?: { op: OpRef; pres: PresentationRef }[];\n  /** Optional: declare per-presentation target requirements (V2 descriptors) */\n  presentationsTargets?: {\n    /** Presentation name. */\n    name: string;\n    /** Presentation version. */\n    version: number;\n    /** Required targets that must be supported by the descriptor. */\n    targets: PresentationTarget[];\n  }[];\n}\n\nexport interface FeatureRef {\n  key: string;\n}\n\nfunction keyOf(f: FeatureModuleSpec) {\n  return f.meta.key;\n}\n\n/** In-memory registry for FeatureModuleSpec. */\nexport class FeatureRegistry {\n  private items = new Map<string, FeatureModuleSpec>();\n\n  /** Register a feature module. Throws when the key already exists. */\n  register(f: FeatureModuleSpec): this {\n    const key = keyOf(f);\n    if (this.items.has(key)) throw new Error(`Duplicate feature ${key}`);\n    this.items.set(key, f);\n    return this;\n  }\n\n  /** List all registered feature modules. */\n  list(): FeatureModuleSpec[] {\n    return [...this.items.values()];\n  }\n\n  /** Get a feature by its key (slug). */\n  get(key: string): FeatureModuleSpec | undefined {\n    return this.items.get(key);\n  }\n}\n\n/** Validate and register a feature against optional registries/descriptors. */\nexport function installFeature(\n  feature: FeatureModuleSpec,\n  deps: {\n    features: FeatureRegistry;\n    ops?: import('./registry').SpecRegistry;\n    presentations?: import('./presentations').PresentationRegistry;\n    descriptorsV2?: PresentationDescriptorV2[];\n    capabilities?: CapabilityRegistry;\n  }\n) {\n  // Validate referenced ops exist if registry provided\n  if (deps.ops && feature.operations) {\n    for (const o of feature.operations) {\n      const s = deps.ops.getSpec(o.name, o.version);\n      if (!s)\n        throw new Error(\n          `installFeature: operation not found ${o.name}.v${o.version}`\n        );\n    }\n  }\n  // Validate referenced presentations exist if registry provided\n  if (deps.presentations && feature.presentations) {\n    for (const p of feature.presentations) {\n      const pres = deps.presentations.get(p.name, p.version);\n      if (!pres)\n        throw new Error(\n          `installFeature: presentation not found ${p.name}.v${p.version}`\n        );\n    }\n  }\n  // Validate V2 target requirements if provided\n  if (feature.presentationsTargets && deps.descriptorsV2) {\n    for (const req of feature.presentationsTargets) {\n      const d = deps.descriptorsV2.find(\n        (x) => x.meta.name === req.name && x.meta.version === req.version\n      );\n      if (!d)\n        throw new Error(\n          `installFeature: V2 descriptor not found ${req.name}.v${req.version}`\n        );\n      for (const t of req.targets) {\n        if (!d.targets.includes(t))\n          throw new Error(\n            `installFeature: descriptor ${req.name}.v${req.version} missing target ${t}`\n          );\n      }\n    }\n  }\n  // Validate op→presentation links\n  if (feature.opToPresentation && feature.opToPresentation.length > 0) {\n    for (const link of feature.opToPresentation) {\n      if (deps.ops) {\n        const s = deps.ops.getSpec(link.op.name, link.op.version);\n        if (!s)\n          throw new Error(\n            `installFeature: linked op not found ${link.op.name}.v${link.op.version}`\n          );\n      }\n      if (deps.presentations) {\n        const pres = deps.presentations.get(link.pres.name, link.pres.version);\n        if (!pres)\n          throw new Error(\n            `installFeature: linked presentation not found ${link.pres.name}.v${link.pres.version}`\n          );\n      }\n    }\n  }\n  // Validate capability bindings when registry provided\n  if (deps.capabilities && feature.capabilities?.provides) {\n    for (const cap of feature.capabilities.provides) {\n      const spec = deps.capabilities.get(cap.key, cap.version);\n      if (!spec)\n        throw new Error(\n          `installFeature: capability not registered ${cap.key}.v${cap.version}`\n        );\n    }\n  }\n  if (feature.capabilities?.requires?.length) {\n    if (!deps.capabilities)\n      throw new Error(\n        `installFeature: capability registry required to validate capability requirements for ${feature.meta.key}`\n      );\n    const provided = feature.capabilities.provides ?? [];\n    for (const req of feature.capabilities.requires) {\n      const satisfied = deps.capabilities.satisfies(req, provided);\n      if (!satisfied)\n        throw new Error(\n          `installFeature: capability requirement not satisfied ${req.key}${req.version ? `.v${req.version}` : ''}`\n        );\n    }\n  }\n  deps.features.register(feature);\n  return deps.features;\n}\n\n/** Ensure declared target requirements exist on the provided descriptors. */\nexport function validateFeatureTargetsV2(\n  feature: FeatureModuleSpec,\n  descriptors: PresentationDescriptorV2[]\n) {\n  if (\n    !feature.presentationsTargets ||\n    feature.presentationsTargets.length === 0\n  )\n    return true;\n  for (const req of feature.presentationsTargets) {\n    const d = descriptors.find(\n      (x) => x.meta.name === req.name && x.meta.version === req.version\n    );\n    if (!d)\n      throw new Error(`V2 descriptor not found ${req.name}.v${req.version}`);\n    for (const t of req.targets)\n      if (!d.targets.includes(t))\n        throw new Error(\n          `Descriptor ${req.name}.v${req.version} missing target ${t}`\n        );\n  }\n  return true;\n}\n"],"mappings":"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"}

package/dist/forms.d.ts

@@ -1,259 +0,0 @@
-import { OwnerShipMeta } from "./ownership.js";
-import { AnySchemaModel, ZodSchemaModel } from "@lssm/lib.schema";
-
-//#region src/forms.d.ts
-type PredicateOp = 'equals' | 'notEquals' | 'in' | 'notIn' | 'gt' | 'gte' | 'lt' | 'lte' | 'truthy' | 'empty' | 'lengthGt' | 'lengthGte' | 'lengthLt' | 'lengthLte';
-interface WhenClause {
-  /** Dot path in form values; arrays may use `$index` within array context. */
-  path: string;
-  op?: PredicateOp;
-  value?: unknown;
-}
-interface Predicate {
-  when?: WhenClause;
-  all?: Predicate[];
-  any?: Predicate[];
-  not?: Predicate;
-}
-interface FormOption {
-  labelI18n: string;
-  value: string | number | boolean;
-  descriptionI18n?: string;
-  disabled?: boolean;
-}
-type OptionsSource = {
-  kind: 'static';
-  options: readonly FormOption[];
-} | {
-  kind: 'resolver';
-  resolverKey: string;
-  /** Dot paths in form values to watch */
-  deps: string[];
-  args?: Record<string, unknown>;
-};
-interface BaseFieldSpec {
-  /** Field kind discriminator. */
-  kind: 'text' | 'textarea' | 'select' | 'checkbox' | 'radio' | 'switch' | 'group' | 'array';
-  /** Field name (dot path relative to the form root or parent context). */
-  name?: string;
-  labelI18n?: string;
-  descriptionI18n?: string;
-  placeholderI18n?: string;
-  required?: boolean;
-  /** Conditional UI behavior */
-  visibleWhen?: Predicate;
-  enabledWhen?: Predicate;
-  requiredWhen?: Predicate;
-  /** UI hints */
-  uiKey?: string;
-  uiProps?: Record<string, unknown>;
-  wrapper?: {
-    orientation?: 'horizontal' | 'vertical';
-  };
-  /** HTML/Native autofill token (supports custom tokens) */
-  autoComplete?: string;
-  /** Keyboard/adaptation hints (web/native). Shape mirrors design-system KeyboardOptions but stays decoupled. */
-  keyboard?: {
-    kind?: string;
-    autoCapitalize?: 'none' | 'sentences' | 'words' | 'characters';
-    autoComplete?: string;
-    autoCorrect?: boolean;
-    enterKeyHint?: 'enter' | 'done' | 'go' | 'next' | 'search' | 'send';
-  };
-  /** Optional computed value hook, provided by host computations map */
-  computeFrom?: {
-    computeKey: string;
-    deps: string[];
-    mode?: 'change' | 'blur-xs' | 'submit';
-    readOnly?: boolean;
-  };
-}
-interface TextFieldSpec extends BaseFieldSpec {
-  kind: 'text';
-  name: string;
-  inputMode?: 'text' | 'email' | 'tel' | 'url' | 'numeric' | 'decimal' | 'search';
-  autoComplete?: string;
-  maxLength?: number;
-  minLength?: number;
-}
-interface TextareaFieldSpec extends BaseFieldSpec {
-  kind: 'textarea';
-  name: string;
-  rows?: number;
-  maxLength?: number;
-  minLength?: number;
-}
-interface SelectFieldSpec extends BaseFieldSpec {
-  kind: 'select';
-  name: string;
-  options: OptionsSource | readonly FormOption[];
-}
-interface CheckboxFieldSpec extends BaseFieldSpec {
-  kind: 'checkbox';
-  name: string;
-}
-interface RadioFieldSpec extends BaseFieldSpec {
-  kind: 'radio';
-  name: string;
-  options: OptionsSource | readonly FormOption[];
-}
-interface SwitchFieldSpec extends BaseFieldSpec {
-  kind: 'switch';
-  name: string;
-}
-interface GroupFieldSpec extends BaseFieldSpec {
-  kind: 'group';
-  /** Optional legend/label at group level */
-  labelI18n?: string;
-  fields: FieldSpec[];
-}
-interface ArrayFieldSpec extends BaseFieldSpec {
-  kind: 'array';
-  /** Root-level field that is an array in the model (e.g., "emails") */
-  name: string;
-  /** Child field spec for each item (e.g., address inside emails[i].address). */
-  of: Exclude<FieldSpec, ArrayFieldSpec | GroupFieldSpec>;
-  min?: number;
-  max?: number;
-}
-type FieldSpec = TextFieldSpec | TextareaFieldSpec | SelectFieldSpec | CheckboxFieldSpec | RadioFieldSpec | SwitchFieldSpec | GroupFieldSpec | ArrayFieldSpec;
-interface FormAction {
-  key: string;
-  labelI18n: string;
-  op?: {
-    name: string;
-    version: number;
-  };
-  success?: {
-    navigateTo?: string;
-    toastI18n?: string;
-  };
-}
-interface ConstraintDecl {
-  key: string;
-  messageI18n: string;
-  paths: string[];
-  args?: Record<string, unknown>;
-}
-type FormValuesFor<M extends AnySchemaModel> = ZodSchemaModel<M>;
-interface FormSpec<M extends AnySchemaModel = AnySchemaModel> {
-  meta: OwnerShipMeta & {
-    key: string;
-    version: number;
-  };
-  /** Canonical form data shape */
-  model: M;
-  /** Flat list or tree using groups/arrays */
-  fields: FieldSpec[];
-  policy?: {
-    flags?: string[];
-    pii?: string[];
-  };
-  actions?: FormAction[];
-  renderHints?: {
-    ui: 'shadcn' | 'custom';
-    form: 'react-hook-form';
-  };
-  constraints?: ConstraintDecl[];
-}
-declare class FormRegistry {
-  private items;
-  register(spec: FormSpec): this;
-  list(): FormSpec[];
-  get(key: string, version?: number): FormSpec<AnySchemaModel> | undefined;
-}
-declare function evalPredicate(values: unknown, pred?: Predicate): boolean;
-type ConstraintHandler = (values: Record<string, unknown>, paths: string[], args?: Record<string, unknown>) => {
-  ok: true;
-} | {
-  ok: false;
-  message?: string;
-  path?: string;
-};
-/**
- * Wrap the base zod schema with relation-driven refinements (requiredWhen, array min/max)
- * and optional custom constraints. Call this when wiring RHF resolver.
- */
-declare function buildZodWithRelations(spec: FormSpec, handlers?: Record<string, ConstraintHandler>): any;
-interface AnyFieldLike {
-  kind: string;
-  name?: string;
-  fields?: readonly AnyFieldLike[];
-  of?: AnyFieldLike;
-}
-type TopLevelNames<F extends readonly AnyFieldLike[]> = F[number] extends {
-  name: infer N extends string;
-} ? N : never;
-type ArrayChildren<F extends readonly AnyFieldLike[]> = F[number] extends {
-  kind: 'array';
-  name: infer N extends string;
-  of: infer C;
-} ? C extends {
-  name: infer CN extends string;
-} ? `${N}.$index.${CN}` : never : never;
-type GroupTopLevelNames<F extends readonly AnyFieldLike[]> = F[number] extends {
-  kind: 'group';
-  fields: infer G extends readonly AnyFieldLike[];
-} ? TopLevelNames<G> : never;
-type GroupArrayChildren<F extends readonly AnyFieldLike[]> = F[number] extends {
-  kind: 'group';
-  fields: infer G extends readonly AnyFieldLike[];
-} ? ArrayChildren<G> : never;
-type PathOfFields<F extends readonly AnyFieldLike[]> = TopLevelNames<F> | ArrayChildren<F> | GroupTopLevelNames<F> | GroupArrayChildren<F>;
-interface TypedWhenClause<P extends string> {
-  path: P;
-  op?: PredicateOp;
-  value?: unknown;
-}
-interface TypedPredicate<P extends string> {
-  when?: TypedWhenClause<P>;
-  all?: TypedPredicate<P>[];
-  any?: TypedPredicate<P>[];
-  not?: TypedPredicate<P>;
-}
-type TypedOptionsSource<P extends string> = {
-  kind: 'static';
-  options: readonly FormOption[];
-} | {
-  kind: 'resolver';
-  resolverKey: string;
-  deps: P[];
-  args?: Record<string, unknown>;
-};
-type EnhanceFields<F extends readonly AnyFieldLike[], P extends string> = { [K in keyof F]: F[K] & {
-  visibleWhen?: TypedPredicate<P>;
-  enabledWhen?: TypedPredicate<P>;
-  requiredWhen?: TypedPredicate<P>;
-} & (F[K] extends {
-  kind: 'select';
-} ? {
-  options: TypedOptionsSource<P> | readonly FormOption[];
-} : {}) & (F[K] extends {
-  kind: 'radio';
-} ? {
-  options: TypedOptionsSource<P> | readonly FormOption[];
-} : {}) & {
-  computeFrom?: {
-    computeKey: string;
-    deps: P[];
-    mode?: 'change' | 'blur-xs' | 'submit';
-    readOnly?: boolean;
-  };
-} };
-declare function defineFormSpec<M extends AnySchemaModel, F extends readonly AnyFieldLike[]>(spec: {
-  meta: FormSpec<M>['meta'];
-  model: M;
-  fields: EnhanceFields<F, PathOfFields<F>>;
-  policy?: FormSpec<M>['policy'];
-  actions?: FormSpec<M>['actions'];
-  renderHints?: FormSpec<M>['renderHints'];
-  constraints?: {
-    key: string;
-    messageI18n: string;
-    paths: PathOfFields<F>[];
-    args?: Record<string, unknown>;
-  }[];
-}): FormSpec<M>;
-//#endregion
-export { ArrayFieldSpec, BaseFieldSpec, CheckboxFieldSpec, ConstraintDecl, ConstraintHandler, EnhanceFields, FieldSpec, FormAction, FormOption, FormRegistry, FormSpec, FormValuesFor, GroupFieldSpec, OptionsSource, Predicate, PredicateOp, RadioFieldSpec, SelectFieldSpec, SwitchFieldSpec, TextFieldSpec, TextareaFieldSpec, TypedOptionsSource, TypedPredicate, TypedWhenClause, WhenClause, buildZodWithRelations, defineFormSpec, evalPredicate };
-//# sourceMappingURL=forms.d.ts.map

package/dist/forms.d.ts.map

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

package/dist/forms.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"forms.js","names":["candidate: FormSpec | undefined","cur: any"],"sources":["../src/forms.ts"],"sourcesContent":["import type { AnySchemaModel, ZodSchemaModel } from '@lssm/lib.schema';\nimport type { OwnerShipMeta } from './ownership';\n\n// ---- Core types\n\nexport type PredicateOp =\n  | 'equals'\n  | 'notEquals'\n  | 'in'\n  | 'notIn'\n  | 'gt'\n  | 'gte'\n  | 'lt'\n  | 'lte'\n  | 'truthy'\n  | 'empty'\n  | 'lengthGt'\n  | 'lengthGte'\n  | 'lengthLt'\n  | 'lengthLte';\n\n// Author-time generic path helpers (computed from provided fields shape)\nexport interface WhenClause {\n  /** Dot path in form values; arrays may use `$index` within array context. */\n  path: string;\n  op?: PredicateOp;\n  value?: unknown;\n}\n\nexport interface Predicate {\n  when?: WhenClause;\n  all?: Predicate[];\n  any?: Predicate[];\n  not?: Predicate;\n}\n\nexport interface FormOption {\n  labelI18n: string;\n  value: string | number | boolean;\n  descriptionI18n?: string;\n  disabled?: boolean;\n}\n\nexport type OptionsSource =\n  | { kind: 'static'; options: readonly FormOption[] }\n  | {\n      kind: 'resolver';\n      resolverKey: string;\n      /** Dot paths in form values to watch */\n      deps: string[];\n      args?: Record<string, unknown>;\n    };\n\nexport interface BaseFieldSpec {\n  /** Field kind discriminator. */\n  kind:\n    | 'text'\n    | 'textarea'\n    | 'select'\n    | 'checkbox'\n    | 'radio'\n    | 'switch'\n    | 'group'\n    | 'array';\n  /** Field name (dot path relative to the form root or parent context). */\n  name?: string;\n  labelI18n?: string;\n  descriptionI18n?: string;\n  placeholderI18n?: string;\n  required?: boolean;\n  /** Conditional UI behavior */\n  visibleWhen?: Predicate;\n  enabledWhen?: Predicate;\n  requiredWhen?: Predicate;\n  /** UI hints */\n  uiKey?: string;\n  uiProps?: Record<string, unknown>;\n  wrapper?: { orientation?: 'horizontal' | 'vertical' };\n  /** HTML/Native autofill token (supports custom tokens) */\n  autoComplete?: string;\n  /** Keyboard/adaptation hints (web/native). Shape mirrors design-system KeyboardOptions but stays decoupled. */\n  keyboard?: {\n    kind?: string;\n    autoCapitalize?: 'none' | 'sentences' | 'words' | 'characters';\n    autoComplete?: string;\n    autoCorrect?: boolean;\n    enterKeyHint?: 'enter' | 'done' | 'go' | 'next' | 'search' | 'send';\n  };\n  /** Optional computed value hook, provided by host computations map */\n  computeFrom?: {\n    computeKey: string;\n    deps: string[];\n    mode?: 'change' | 'blur-xs' | 'submit';\n    readOnly?: boolean;\n  };\n}\n\nexport interface TextFieldSpec extends BaseFieldSpec {\n  kind: 'text';\n  name: string;\n  inputMode?:\n    | 'text'\n    | 'email'\n    | 'tel'\n    | 'url'\n    | 'numeric'\n    | 'decimal'\n    | 'search';\n  autoComplete?: string;\n  maxLength?: number;\n  minLength?: number;\n}\n\nexport interface TextareaFieldSpec extends BaseFieldSpec {\n  kind: 'textarea';\n  name: string;\n  rows?: number;\n  maxLength?: number;\n  minLength?: number;\n}\n\nexport interface SelectFieldSpec extends BaseFieldSpec {\n  kind: 'select';\n  name: string;\n  options: OptionsSource | readonly FormOption[]; // allow shorthand array\n}\n\nexport interface CheckboxFieldSpec extends BaseFieldSpec {\n  kind: 'checkbox';\n  name: string;\n}\n\nexport interface RadioFieldSpec extends BaseFieldSpec {\n  kind: 'radio';\n  name: string;\n  options: OptionsSource | readonly FormOption[];\n}\n\nexport interface SwitchFieldSpec extends BaseFieldSpec {\n  kind: 'switch';\n  name: string;\n}\n\nexport interface GroupFieldSpec extends BaseFieldSpec {\n  kind: 'group';\n  /** Optional legend/label at group level */\n  labelI18n?: string;\n  fields: FieldSpec[];\n}\n\nexport interface ArrayFieldSpec extends BaseFieldSpec {\n  kind: 'array';\n  /** Root-level field that is an array in the model (e.g., \"emails\") */\n  name: string;\n  /** Child field spec for each item (e.g., address inside emails[i].address). */\n  of: Exclude<FieldSpec, ArrayFieldSpec | GroupFieldSpec>;\n  min?: number;\n  max?: number;\n}\n\nexport type FieldSpec =\n  | TextFieldSpec\n  | TextareaFieldSpec\n  | SelectFieldSpec\n  | CheckboxFieldSpec\n  | RadioFieldSpec\n  | SwitchFieldSpec\n  | GroupFieldSpec\n  | ArrayFieldSpec;\n\nexport interface FormAction {\n  key: string;\n  labelI18n: string;\n  op?: { name: string; version: number };\n  success?: { navigateTo?: string; toastI18n?: string };\n}\n\nexport interface ConstraintDecl {\n  key: string; // host maps this to a function\n  messageI18n: string;\n  paths: string[]; // inputs for the constraint function\n  args?: Record<string, unknown>;\n}\n\nexport type FormValuesFor<M extends AnySchemaModel> = ZodSchemaModel<M>;\n\nexport interface FormSpec<M extends AnySchemaModel = AnySchemaModel> {\n  meta: OwnerShipMeta & { key: string; version: number };\n  /** Canonical form data shape */\n  model: M;\n  /** Flat list or tree using groups/arrays */\n  fields: FieldSpec[];\n  policy?: { flags?: string[]; pii?: string[] };\n  actions?: FormAction[];\n  renderHints?: { ui: 'shadcn' | 'custom'; form: 'react-hook-form' };\n  constraints?: ConstraintDecl[];\n}\n\n// ---- Registry\n\nfunction formKey(meta: FormSpec['meta']) {\n  return `${meta.key}.v${meta.version}`;\n}\n\nexport class FormRegistry {\n  private items = new Map<string, FormSpec>();\n\n  register(spec: FormSpec): this {\n    const key = formKey(spec.meta);\n    if (this.items.has(key)) throw new Error(`Duplicate form ${key}`);\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): FormSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(key: string, version?: number) {\n    if (version != null) return this.items.get(`${key}.v${version}`);\n    let candidate: FormSpec | undefined;\n    let max = -Infinity;\n    for (const [k, v] of this.items.entries()) {\n      if (!k.startsWith(`${key}.v`)) continue;\n      if (v.meta.version > max) {\n        max = v.meta.version;\n        candidate = v;\n      }\n    }\n    return candidate;\n  }\n}\n\n// ---- Relations helpers (runtime)\n\nfunction getAtPath(values: unknown, path: string): unknown {\n  if (!path) return undefined;\n  const segs = path\n    .replace(/\\[(\\d+)\\]/g, '.$1')\n    .split('.')\n    .filter(Boolean);\n  let cur: any = values as any;\n  for (const s of segs) {\n    if (cur == null) return undefined;\n    cur = cur[s as keyof typeof cur];\n  }\n  return cur;\n}\n\nexport function evalPredicate(values: unknown, pred?: Predicate): boolean {\n  if (!pred) return true;\n  if (pred.not) return !evalPredicate(values, pred.not);\n  if (pred.all && pred.all.length)\n    return pred.all.every((p) => evalPredicate(values, p));\n  if (pred.any && pred.any.length)\n    return pred.any.some((p) => evalPredicate(values, p));\n  if (pred.when) {\n    const { path, op = 'truthy', value } = pred.when;\n    const v = getAtPath(values, path);\n    switch (op) {\n      case 'equals':\n        return v === value;\n      case 'notEquals':\n        return v !== value;\n      case 'in':\n        return Array.isArray(value) && value.includes(v as never);\n      case 'notIn':\n        return Array.isArray(value) && !value.includes(v as never);\n      case 'gt':\n        return Number(v) > Number(value);\n      case 'gte':\n        return Number(v) >= Number(value);\n      case 'lt':\n        return Number(v) < Number(value);\n      case 'lte':\n        return Number(v) <= Number(value);\n      case 'empty':\n        return (\n          v == null ||\n          (Array.isArray(v) ? v.length === 0 : String(v).length === 0)\n        );\n      case 'lengthGt':\n        return (\n          (Array.isArray(v) || typeof v === 'string') &&\n          (v as any).length > Number(value ?? 0)\n        );\n      case 'lengthGte':\n        return (\n          (Array.isArray(v) || typeof v === 'string') &&\n          (v as any).length >= Number(value ?? 0)\n        );\n      case 'lengthLt':\n        return (\n          (Array.isArray(v) || typeof v === 'string') &&\n          (v as any).length < Number(value ?? 0)\n        );\n      case 'lengthLte':\n        return (\n          (Array.isArray(v) || typeof v === 'string') &&\n          (v as any).length <= Number(value ?? 0)\n        );\n      case 'truthy':\n      default:\n        return Boolean(v);\n    }\n  }\n  return true;\n}\n\nexport type ConstraintHandler = (\n  values: Record<string, unknown>,\n  paths: string[],\n  args?: Record<string, unknown>\n) => { ok: true } | { ok: false; message?: string; path?: string };\n\n/**\n * Wrap the base zod schema with relation-driven refinements (requiredWhen, array min/max)\n * and optional custom constraints. Call this when wiring RHF resolver.\n */\nexport function buildZodWithRelations(\n  spec: FormSpec,\n  handlers?: Record<string, ConstraintHandler>\n) {\n  const base = spec.model.getZod();\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return (base as any).superRefine(\n    (values: Record<string, unknown>, ctx: any) => {\n      const visit = (field: FieldSpec, parentPath?: string) => {\n        const path = field.name\n          ? parentPath\n            ? `${parentPath}.${field.name}`\n            : field.name\n          : (parentPath ?? '');\n\n        // requiredWhen enforcement (UI also shows required)\n        if (field.requiredWhen) {\n          const should = evalPredicate(values, field.requiredWhen);\n          if (should) {\n            const v = getAtPath(values, path);\n            const empty =\n              v == null ||\n              (typeof v === 'string' && v.trim().length === 0) ||\n              (Array.isArray(v) && v.length === 0);\n            if (empty)\n              ctx.addIssue({\n                code: 'custom',\n                path: path.split('.'),\n                message: 'required',\n              });\n          }\n        }\n\n        // arrays min/max\n        if (field.kind === 'array') {\n          const arr = getAtPath(values, path) as unknown[] | undefined;\n          if (\n            field.min != null &&\n            Array.isArray(arr) &&\n            arr.length < field.min\n          ) {\n            ctx.addIssue({\n              code: 'custom',\n              path: path.split('.'),\n              message: `min:${field.min}`,\n            });\n          }\n          if (\n            field.max != null &&\n            Array.isArray(arr) &&\n            arr.length > field.max\n          ) {\n            ctx.addIssue({\n              code: 'custom',\n              path: path.split('.'),\n              message: `max:${field.max}`,\n            });\n          }\n          // child\n          visit(field.of, path);\n        } else if (field.kind === 'group') {\n          for (const child of field.fields) visit(child, path);\n        }\n      };\n\n      for (const f of spec.fields) visit(f);\n\n      // custom constraints\n      if (spec.constraints && handlers) {\n        for (const c of spec.constraints) {\n          const fn = handlers[c.key];\n          if (!fn) continue;\n          const res = fn(values, c.paths, c.args);\n          if (!res.ok) {\n            ctx.addIssue({\n              code: 'custom',\n              path: (res.path ?? c.paths[0] ?? '').split('.').filter(Boolean),\n              message: res.message ?? c.messageI18n,\n            });\n          }\n        }\n      }\n    }\n  );\n}\n\n// ---- Authoring-time helper: enforce typed paths from fields (best-effort bounded)\n\ninterface AnyFieldLike {\n  kind: string;\n  name?: string;\n  fields?: readonly AnyFieldLike[];\n  of?: AnyFieldLike;\n}\n\ntype TopLevelNames<F extends readonly AnyFieldLike[]> = F[number] extends {\n  name: infer N extends string;\n}\n  ? N\n  : never;\n\ntype ArrayChildren<F extends readonly AnyFieldLike[]> = F[number] extends {\n  kind: 'array';\n  name: infer N extends string;\n  of: infer C;\n}\n  ? C extends { name: infer CN extends string }\n    ? `${N}.$index.${CN}`\n    : never\n  : never;\n\ntype GroupTopLevelNames<F extends readonly AnyFieldLike[]> = F[number] extends {\n  kind: 'group';\n  fields: infer G extends readonly AnyFieldLike[];\n}\n  ? TopLevelNames<G>\n  : never;\n\ntype GroupArrayChildren<F extends readonly AnyFieldLike[]> = F[number] extends {\n  kind: 'group';\n  fields: infer G extends readonly AnyFieldLike[];\n}\n  ? ArrayChildren<G>\n  : never;\n\ntype PathOfFields<F extends readonly AnyFieldLike[]> =\n  | TopLevelNames<F>\n  | ArrayChildren<F>\n  | GroupTopLevelNames<F>\n  | GroupArrayChildren<F>;\n\nexport interface TypedWhenClause<P extends string> {\n  path: P;\n  op?: PredicateOp;\n  value?: unknown;\n}\nexport interface TypedPredicate<P extends string> {\n  when?: TypedWhenClause<P>;\n  all?: TypedPredicate<P>[];\n  any?: TypedPredicate<P>[];\n  not?: TypedPredicate<P>;\n}\nexport type TypedOptionsSource<P extends string> =\n  | { kind: 'static'; options: readonly FormOption[] }\n  | {\n      kind: 'resolver';\n      resolverKey: string;\n      deps: P[];\n      args?: Record<string, unknown>;\n    };\n\nexport type EnhanceFields<\n  F extends readonly AnyFieldLike[],\n  P extends string,\n> = {\n  [K in keyof F]: F[K] & {\n    visibleWhen?: TypedPredicate<P>;\n    enabledWhen?: TypedPredicate<P>;\n    requiredWhen?: TypedPredicate<P>;\n  } & (F[K] extends { kind: 'select' }\n      ? { options: TypedOptionsSource<P> | readonly FormOption[] }\n      : {}) &\n    (F[K] extends { kind: 'radio' }\n      ? { options: TypedOptionsSource<P> | readonly FormOption[] }\n      : {}) & {\n      computeFrom?: {\n        computeKey: string;\n        deps: P[];\n        mode?: 'change' | 'blur-xs' | 'submit';\n        readOnly?: boolean;\n      };\n    };\n};\n\nexport function defineFormSpec<\n  M extends AnySchemaModel,\n  F extends readonly AnyFieldLike[],\n>(spec: {\n  meta: FormSpec<M>['meta'];\n  model: M;\n  fields: EnhanceFields<F, PathOfFields<F>>;\n  policy?: FormSpec<M>['policy'];\n  actions?: FormSpec<M>['actions'];\n  renderHints?: FormSpec<M>['renderHints'];\n  constraints?: {\n    key: string;\n    messageI18n: string;\n    paths: PathOfFields<F>[];\n    args?: Record<string, unknown>;\n  }[];\n}): FormSpec<M> {\n  return spec as unknown as FormSpec<M>;\n}\n"],"mappings":"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"}

package/dist/graphql-federation/dist/index.js

@@ -1,2 +0,0 @@
-import"@pothos/plugin-federation";import{printSubgraphSchema as e}from"@apollo/subgraph";function t(t){return e(t)}export{t};
-//# sourceMappingURL=index.js.map

package/dist/graphql-federation/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["e","t"],"sources":["../../../../graphql-federation/dist/index.js"],"sourcesContent":["import\"@pothos/core\";import\"@pothos/plugin-federation\";import{printSubgraphSchema as e}from\"@apollo/subgraph\";function t(t){return e(t)}function n(e,t,n,r,i){let a=e.objectRef(t);return a.implement({fields:r}),e.entity(t,{key:n.join(` `),resolveReference:i}),a}export{t as toSubgraphSDL,n as withEntityObject};\n//# sourceMappingURL=index.js.map"],"mappings":"yFAA8G,SAAS,EAAE,EAAE,CAAC,OAAOA,EAAEC,EAAE"}