@spring-systems/core 0.8.4 → 0.8.7

package/dist/chunk-PT4DIYUK.js

@@ -1,78 +0,0 @@
-// src/errors/errors.ts
-var SpringError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "SpringError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var SpringConfigError = class extends SpringError {
-  constructor(message) {
-    super(message, "CONFIG_ERROR");
-    this.name = "SpringConfigError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var SpringValidationError = class extends SpringError {
-  constructor(message, field) {
-    super(message, "VALIDATION_ERROR");
-    this.field = field;
-    this.name = "SpringValidationError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var SpringSlotError = class extends SpringError {
-  slotName;
-  constructor(slotName, message) {
-    super(`Slot "${slotName}": ${message}`, "SLOT_ERROR");
-    this.name = "SpringSlotError";
-    this.slotName = slotName;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var SpringApiError = class extends SpringError {
-  constructor(message, statusCode, endpoint, code = "API_ERROR") {
-    super(message, code);
-    this.statusCode = statusCode;
-    this.endpoint = endpoint;
-    this.name = "SpringApiError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var SpringPluginError = class extends SpringError {
-  constructor(message, pluginName, code = "PLUGIN_ERROR") {
-    super(message, code);
-    this.pluginName = pluginName;
-    this.name = "SpringPluginError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var SpringAdapterError = class extends SpringError {
-  constructor(message, adapterName, code = "ADAPTER_ERROR") {
-    super(message, code);
-    this.adapterName = adapterName;
-    this.name = "SpringAdapterError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var SpringMiddlewareError = class extends SpringError {
-  constructor(message, slot, code = "MIDDLEWARE_ERROR") {
-    super(message, code);
-    this.slot = slot;
-    this.name = "SpringMiddlewareError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-
-export {
-  SpringError,
-  SpringConfigError,
-  SpringValidationError,
-  SpringSlotError,
-  SpringApiError,
-  SpringPluginError,
-  SpringAdapterError,
-  SpringMiddlewareError
-};
-//# sourceMappingURL=chunk-PT4DIYUK.js.map

package/dist/chunk-PT4DIYUK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/errors/errors.ts"],"sourcesContent":["/**\n * Custom error classes for the SPRING framework.\n * Provides structured, typed errors for better error handling by consumers.\n * @module errors\n */\n\nexport class SpringError extends Error {\n    constructor(\n        message: string,\n        public readonly code: string,\n    ) {\n        super(message);\n        this.name = \"SpringError\";\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\nexport class SpringConfigError extends SpringError {\n    constructor(message: string) {\n        super(message, \"CONFIG_ERROR\");\n        this.name = \"SpringConfigError\";\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\nexport class SpringValidationError extends SpringError {\n    constructor(\n        message: string,\n        public readonly field?: string,\n    ) {\n        super(message, \"VALIDATION_ERROR\");\n        this.name = \"SpringValidationError\";\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\nexport class SpringSlotError extends SpringError {\n    public readonly slotName: string;\n\n    constructor(slotName: string, message: string) {\n        super(`Slot \"${slotName}\": ${message}`, \"SLOT_ERROR\");\n        this.name = \"SpringSlotError\";\n        this.slotName = slotName;\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\nexport class SpringApiError extends SpringError {\n    constructor(\n        message: string,\n        public readonly statusCode: number,\n        public readonly endpoint: string,\n        code = \"API_ERROR\" as const,\n    ) {\n        super(message, code);\n        this.name = \"SpringApiError\";\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\nexport class SpringPluginError extends SpringError {\n    constructor(\n        message: string,\n        public readonly pluginName: string,\n        code = \"PLUGIN_ERROR\" as const,\n    ) {\n        super(message, code);\n        this.name = \"SpringPluginError\";\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\nexport class SpringAdapterError extends SpringError {\n    constructor(\n        message: string,\n        public readonly adapterName: string,\n        code = \"ADAPTER_ERROR\" as const,\n    ) {\n        super(message, code);\n        this.name = \"SpringAdapterError\";\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\nexport class SpringMiddlewareError extends SpringError {\n    constructor(\n        message: string,\n        public readonly slot: string,\n        code = \"MIDDLEWARE_ERROR\" as const,\n    ) {\n        super(message, code);\n        this.name = \"SpringMiddlewareError\";\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n"],"mappings":";AAMO,IAAM,cAAN,cAA0B,MAAM;AAAA,EACnC,YACI,SACgB,MAClB;AACE,UAAM,OAAO;AAFG;AAGhB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AACJ;AAEO,IAAM,oBAAN,cAAgC,YAAY;AAAA,EAC/C,YAAY,SAAiB;AACzB,UAAM,SAAS,cAAc;AAC7B,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AACJ;AAEO,IAAM,wBAAN,cAAoC,YAAY;AAAA,EACnD,YACI,SACgB,OAClB;AACE,UAAM,SAAS,kBAAkB;AAFjB;AAGhB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AACJ;AAEO,IAAM,kBAAN,cAA8B,YAAY;AAAA,EAC7B;AAAA,EAEhB,YAAY,UAAkB,SAAiB;AAC3C,UAAM,SAAS,QAAQ,MAAM,OAAO,IAAI,YAAY;AACpD,SAAK,OAAO;AACZ,SAAK,WAAW;AAChB,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AACJ;AAEO,IAAM,iBAAN,cAA6B,YAAY;AAAA,EAC5C,YACI,SACgB,YACA,UAChB,OAAO,aACT;AACE,UAAM,SAAS,IAAI;AAJH;AACA;AAIhB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AACJ;AAEO,IAAM,oBAAN,cAAgC,YAAY;AAAA,EAC/C,YACI,SACgB,YAChB,OAAO,gBACT;AACE,UAAM,SAAS,IAAI;AAHH;AAIhB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AACJ;AAEO,IAAM,qBAAN,cAAiC,YAAY;AAAA,EAChD,YACI,SACgB,aAChB,OAAO,iBACT;AACE,UAAM,SAAS,IAAI;AAHH;AAIhB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AACJ;AAEO,IAAM,wBAAN,cAAoC,YAAY;AAAA,EACnD,YACI,SACgB,MAChB,OAAO,oBACT;AACE,UAAM,SAAS,IAAI;AAHH;AAIhB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AACJ;","names":[]}

package/dist/chunk-QAVWXARR.js

@@ -1,51 +0,0 @@
-// src/types/form-types.ts
-function getIdentifiableId(obj, key) {
-  if (typeof obj !== "object" || obj === null || Array.isArray(obj) || obj instanceof Date) return void 0;
-  const o = obj;
-  if (key) {
-    const val = o[key];
-    if (val !== void 0 && val !== null && (typeof val === "string" || typeof val === "number")) return val;
-  }
-  if (o.id_public !== void 0 && o.id_public !== null) return o.id_public;
-  if (o.id !== void 0 && o.id !== null) return o.id;
-  return void 0;
-}
-function storeBoundary(value) {
-  return value;
-}
-function toFormDataValue(value) {
-  return value;
-}
-function isFormFieldRuntime(val) {
-  return val !== null && typeof val === "object" && !Array.isArray(val) && !(val instanceof Date) && "value" in val && "title" in val;
-}
-function getField(state, key) {
-  if (!state) return void 0;
-  const val = state[key];
-  if (val && typeof val === "object" && !Array.isArray(val) && !(val instanceof Date)) {
-    return val;
-  }
-  return void 0;
-}
-function getSubState(state, key) {
-  if (!state) return void 0;
-  const val = state[key];
-  if (val && typeof val === "object" && !Array.isArray(val) && !(val instanceof Date)) {
-    return val;
-  }
-  return void 0;
-}
-function getStoreValue(state, key) {
-  return state[key];
-}
-
-export {
-  getIdentifiableId,
-  storeBoundary,
-  toFormDataValue,
-  isFormFieldRuntime,
-  getField,
-  getSubState,
-  getStoreValue
-};
-//# sourceMappingURL=chunk-QAVWXARR.js.map

package/dist/chunk-QAVWXARR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/form-types.ts"],"sourcesContent":["/**\n * Types for FormManager - runtime shapes of fields, details, and store API.\n * @module form-types\n */\n\nimport type { Permission } from \"./grid-types\";\n\n/** Concrete union type for form field values (JSON-like data from API) */\nexport type FormDataValue =\n    | string\n    | number\n    | boolean\n    | Date\n    | null\n    | undefined\n    | FormDataValue[]\n    | { [key: string]: FormDataValue };\n\n/**\n * Form field value — at runtime includes: string, number, boolean, Date, null, undefined,\n * arrays, plain objects (JSON data from API). TS interface limitation: cannot be expressed as a union\n * without losing compatibility with TS interfaces (they lack implicit index signatures).\n */\nexport type FormFieldValue = unknown;\n\n/** Zustand store state — top-level keys (detail, list, ...) */\nexport interface FormStoreState {\n    [key: string]: FormFieldValue;\n}\n\n/** Indexable object with FormDataValue entries — concrete type for dynamic field access in utilities */\nexport interface IndexedFormData {\n    [key: string]: FormDataValue;\n}\n\n/** Indexable object — concrete type for generic object traversal (deepCopy, tree access) */\nexport interface Indexable {\n    [key: string]: FormDataValue;\n}\n\n/** Plain object of a collection item — with known meta keys */\nexport interface FormCollectionItem {\n    __cid?: string;\n    id_public?: string;\n    [key: string]: FormDataValue;\n}\n\n/** Map of form fields — fieldName -> FormFieldRuntime */\nexport interface FormDetailFields {\n    [key: string]: FormFieldRuntime;\n}\n\n/** Structure definition for a nested object/collection */\nexport interface FormStructureDef {\n    [key: string]: FormFieldDefinitionRuntime;\n}\n\n/** Forward declaration for FormManagerImpl - avoids circular dependency */\nexport interface FormManagerRef {\n    handleForm: <_T>(\n        setState: (updater: (state: FormStoreState) => FormStoreState) => void,\n        collectionKeys?: string[] | string,\n        isFilter?: boolean,\n    ) => FormCollectionActions;\n}\n\n/** Runtime shape of a field definition in structure (metadata without value) */\nexport interface FormFieldDefinitionRuntime {\n    value?: FormDataValue;\n    title?: string | ((item: FormCollectionItem) => string);\n    resourceKey?: string;\n    validation?: string | ((value: FormDataValue, structure: FormDetailFields) => string);\n    required?: (structure: FormDetailFields) => boolean;\n    skipValidation?: boolean;\n    skipField?: boolean;\n    help?: string;\n    dataSource?: FormDataValue[];\n    visible?: (structure: FormDetailFields) => boolean;\n    disabled?: (structure: FormDetailFields) => boolean;\n    onChange?: (value: FormDataValue, formManager: FormManagerRef) => void;\n    [key: string]: FormFieldValue;\n}\n\n/** Core field identity and value. */\nexport interface FormFieldCore {\n    value?: FormDataValue;\n    items?: FormCollectionItem[];\n    structure?: FormStructureDef;\n    title?: string | ((item: FormCollectionItem) => string);\n    resourceKey?: string;\n    key?: string;\n    help?: string;\n    dataSource?: FormDataValue[];\n}\n\n/** Validation facet of a form field. */\nexport interface FormFieldValidation {\n    validation?: string | ((value: FormDataValue, structure: FormDetailFields) => string);\n    required?: (structure: FormDetailFields) => boolean;\n    skipValidation?: boolean;\n    skipField?: boolean;\n    serverError?: string;\n    forceDefault?: boolean;\n}\n\n/** Mutation methods for form fields. */\nexport interface FormFieldMutation {\n    set?: (newValue: FormDataValue, index?: number, fieldName?: string) => void;\n    add?: (parent: FormCollectionItem | null, defaultValue?: FormCollectionItem) => void;\n    remove?: (item: FormCollectionItem) => void;\n}\n\n/** Lifecycle hooks for form fields (collection items, change events). */\nexport interface FormFieldLifecycle {\n    onChange?: (value: FormDataValue, formManager: FormManagerRef) => void;\n    onBeforeAdd?: (newItem: FormCollectionItem) => FormCollectionItem | undefined;\n    onAfterAdd?: (addedItem: FormCollectionItem, allItems: FormCollectionItem[]) => void;\n    onBeforeRemove?: (item: FormCollectionItem) => boolean | void;\n    onAfterRemove?: (removedItem: FormCollectionItem) => void;\n}\n\n/** Visibility facet of a form field. */\nexport interface FormFieldVisibility {\n    visible?: (structure: FormDetailFields) => boolean;\n    disabled?: (structure: FormDetailFields) => boolean;\n}\n\n/** Runtime shape of a single form field — intersection of all facets. 100% backward-compatible. */\nexport interface FormFieldRuntime\n    extends FormFieldCore, FormFieldValidation, FormFieldMutation, FormFieldLifecycle, FormFieldVisibility {\n    [key: string]: FormFieldValue;\n}\n\nexport type FormChangedPath = string;\n\nexport interface FormChangesSnapshot {\n    isChanged: boolean;\n    changedPaths: FormChangedPath[];\n    lastChangedPath?: FormChangedPath;\n}\n\nexport interface FormChangesApi {\n    get(): FormChangesSnapshot;\n    isChanged(path: FormChangedPath): boolean;\n    markClean(): void;\n    touch(path: FormChangedPath, previousValue: FormDataValue, currentValue: FormDataValue): void;\n    setChanged(path: FormChangedPath, changed: boolean): void;\n    exportBaseline?: () => FormStoreState;\n    importBaseline?: (baseline: FormStoreState) => void;\n}\n\n/** Runtime state of the entire form detail - access to fields via string index, specific runtime keys */\nexport interface FormDetailRuntime extends FormStoreState {\n    isEdited?: boolean;\n    isValidated?: boolean;\n    changes?: FormChangesApi;\n    formManager?: FormManagerRef;\n    form?: (collectionKeys?: string | string[]) => FormCollectionActions;\n}\n\n/** Minimal interface for createForm return value — Zustand store instance. */\nexport interface FormStoreInstance {\n    getState: () => object;\n}\n\n/** Type for the Zustand-like store used by FormManager */\nexport interface FormStoreApi {\n    getState: () => FormStoreState;\n    setState: (updater: (s: FormStoreState) => FormStoreState) => void;\n    getInitialState: () => FormStoreState;\n}\n\n/** Actions for manipulating collections in the form (add/remove/set) */\nexport interface FormCollectionActions {\n    add: (parent: FormCollectionItem | null, newItem: FormCollectionItem) => void;\n    remove: (itemToRemove: FormCollectionItem) => void;\n    set: (newValue: FormFieldValue, key: string, item: FormCollectionItem) => void;\n}\n\n/** Non-generic version of FormManager for contexts where invariant M is not needed. */\nexport interface FormManagerBase {\n    clearFields(): void;\n    getFields(): (FormStoreState & { id_public?: string }) | null;\n    setFields(value: FormStoreState, opts?: { markClean?: boolean }): void;\n    get(key: string): FormFieldValue;\n    set(key: string, value: FormFieldValue): void;\n    getReadOnly(): boolean;\n    setReadOnly(value: boolean): void;\n    setIdPublic(value: string): void;\n    validate(): boolean;\n    save(\n        url: string,\n        fields: FormStoreState & { id_public?: string },\n        validations?: boolean,\n    ): Promise<FormStoreState | false>;\n    load<T extends FormStoreState>(\n        route: string,\n        id_public?: string,\n        detailData?: T,\n        copyFrom?: string,\n    ): Promise<T | undefined>;\n    getPermissions(): Permission | undefined;\n    setPermissions(permissions: Permission | undefined): void;\n    transformDs(items: FormCollectionItem[], structure?: FormStructureDef): FormCollectionItem[];\n    handleForm<_T>(\n        setState: (updater: (state: FormStoreState) => FormStoreState) => void,\n        collectionKeys?: string[] | string,\n        isFilter?: boolean,\n    ): FormCollectionActions;\n}\n\n/** Minimal interface for ListManager — covers .load() called from Detail/Context. */\nexport interface ListManagerLoadable {\n    load(allowLoad?: boolean): Promise<object | null | undefined | void>;\n    highlightRow(id_public: string): void;\n}\n\n/** Form readOnly state — minimal interface for the readOnly field in FormPageForm */\nexport interface ReadOnlyField {\n    value?: boolean;\n    set?: (newValue: boolean) => void;\n}\n\nexport interface Identifiable {\n    id_public?: string | number;\n    id?: string | number;\n    [key: string]: FormFieldValue;\n}\n\n/** Extracts ID from an object — looks for `key`, `id_public`, `id` (in that order). */\nexport function getIdentifiableId(obj: unknown, key?: string): string | number | undefined {\n    if (typeof obj !== \"object\" || obj === null || Array.isArray(obj) || obj instanceof Date) return undefined;\n    const o = obj as Identifiable;\n    if (key) {\n        const val = o[key];\n        if (val !== undefined && val !== null && (typeof val === \"string\" || typeof val === \"number\")) return val;\n    }\n    if (o.id_public !== undefined && o.id_public !== null) return o.id_public;\n    if (o.id !== undefined && o.id !== null) return o.id;\n    return undefined;\n}\n\n/** Zustand boundary cast — encapsulates `as unknown as T` for Store type invariance. */\nexport function storeBoundary<T>(value: FormFieldValue): T {\n    return value as T;\n}\n\n/** Boundary function: narrows FormFieldValue (=unknown) to FormDataValue at the unknown→typed boundary. */\nexport function toFormDataValue(value: FormFieldValue): FormDataValue {\n    return value as FormDataValue;\n}\n\n/** Type guard: checks if an unknown value is a FormFieldRuntime-like object (has `value` key and is not a Date/Array). */\nexport function isFormFieldRuntime(val: unknown): val is FormFieldRuntime {\n    return (\n        val !== null &&\n        typeof val === \"object\" &&\n        !Array.isArray(val) &&\n        !(val instanceof Date) &&\n        \"value\" in val &&\n        \"title\" in val\n    );\n}\n\n/** Typed accessor: returns FormFieldRuntime from FormStoreState[key] with a runtime type check. */\nexport function getField(state: FormStoreState | null | undefined, key: string): FormFieldRuntime | undefined {\n    if (!state) return undefined;\n    const val = state[key];\n    if (val && typeof val === \"object\" && !Array.isArray(val) && !(val instanceof Date)) {\n        return val as FormFieldRuntime;\n    }\n    return undefined;\n}\n\n/** Typed accessor: returns nested FormStoreState from FormStoreState[key] with a runtime check. */\nexport function getSubState(state: FormStoreState | null | undefined, key: string): FormStoreState | undefined {\n    if (!state) return undefined;\n    const val = state[key];\n    if (val && typeof val === \"object\" && !Array.isArray(val) && !(val instanceof Date)) {\n        return val as FormStoreState;\n    }\n    return undefined;\n}\n\n/** Typed accessor: returns a value from Zustand store state under the given key. */\nexport function getStoreValue<T>(state: object, key: string): T {\n    return (state as FormStoreState)[key] as T;\n}\n\n/** Filter value in the TreeList/List filter system — includes lookup objects */\nexport type FilterFieldValue =\n    | string\n    | number\n    | boolean\n    | Date\n    | null\n    | undefined\n    | { id_public?: string | number; value?: string | number; [key: string]: FilterFieldValue | undefined }\n    | FilterFieldValue[];\n\n/** Shape of an error object from API/Axios */\nexport interface ApiErrorLike {\n    code?: string;\n    name?: string;\n    message?: string;\n    status?: number;\n    data?: unknown;\n}\n\n/** Comparison function for the validation engine */\nexport type ComparisonFunction = (a: FormDataValue, b: FormDataValue) => boolean;\n\n/** Named validator function — registered via registerValidator, resolved at validation time. */\nexport type ValidatorFn = (value: FormDataValue, structure: FormDetailFields) => string;\n\nexport interface FormLifecycle<T = FormStoreState> {\n    onBeforeLoad?: (id: string) => void | Promise<void>;\n    onAfterLoad?: (data: FormStoreState) => void;\n    onBeforeSave?: (fields: T) => T;\n    onAfterSave?: (result: FormStoreState) => void;\n}\n"],"mappings":";AAsOO,SAAS,kBAAkB,KAAc,KAA2C;AACvF,MAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,MAAM,QAAQ,GAAG,KAAK,eAAe,KAAM,QAAO;AACjG,QAAM,IAAI;AACV,MAAI,KAAK;AACL,UAAM,MAAM,EAAE,GAAG;AACjB,QAAI,QAAQ,UAAa,QAAQ,SAAS,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAAW,QAAO;AAAA,EAC1G;AACA,MAAI,EAAE,cAAc,UAAa,EAAE,cAAc,KAAM,QAAO,EAAE;AAChE,MAAI,EAAE,OAAO,UAAa,EAAE,OAAO,KAAM,QAAO,EAAE;AAClD,SAAO;AACX;AAGO,SAAS,cAAiB,OAA0B;AACvD,SAAO;AACX;AAGO,SAAS,gBAAgB,OAAsC;AAClE,SAAO;AACX;AAGO,SAAS,mBAAmB,KAAuC;AACtE,SACI,QAAQ,QACR,OAAO,QAAQ,YACf,CAAC,MAAM,QAAQ,GAAG,KAClB,EAAE,eAAe,SACjB,WAAW,OACX,WAAW;AAEnB;AAGO,SAAS,SAAS,OAA0C,KAA2C;AAC1G,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,MAAM,MAAM,GAAG;AACrB,MAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,eAAe,OAAO;AACjF,WAAO;AAAA,EACX;AACA,SAAO;AACX;AAGO,SAAS,YAAY,OAA0C,KAAyC;AAC3G,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,MAAM,MAAM,GAAG;AACrB,MAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,eAAe,OAAO;AACjF,WAAO;AAAA,EACX;AACA,SAAO;AACX;AAGO,SAAS,cAAiB,OAAe,KAAgB;AAC5D,SAAQ,MAAyB,GAAG;AACxC;","names":[]}

package/dist/chunk-RRWKDFAB.js

@@ -1,143 +0,0 @@
-import {
-  getField
-} from "./chunk-QAVWXARR.js";
-import {
-  getContentRes
-} from "./chunk-NQQIVCLX.js";
-import {
-  registerFallbackMigration
-} from "./chunk-RUCXSQEY.js";
-import {
-  logError
-} from "./chunk-KX32MU3I.js";
-import {
-  tryGetSpringInstance
-} from "./chunk-EFUBAQCV.js";
-
-// src/validation/validations.ts
-var fallbackRegistry = /* @__PURE__ */ new Map();
-registerFallbackMigration((instance) => {
-  if (fallbackRegistry.size === 0) return;
-  const target = instance.core.validatorRegistry;
-  for (const [name, validator] of fallbackRegistry) {
-    if (!target.has(name)) {
-      target.set(name, validator);
-    }
-  }
-});
-function getRegistry() {
-  const instance = tryGetSpringInstance();
-  return instance ? instance.core.validatorRegistry : fallbackRegistry;
-}
-function registerValidator(name, fn) {
-  getRegistry().set(name, fn);
-}
-function getValidator(name) {
-  return getRegistry().get(name);
-}
-function getRegisteredValidators() {
-  return Array.from(getRegistry().keys());
-}
-function clearValidators() {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    instance.core.validatorRegistry.clear();
-  }
-  fallbackRegistry.clear();
-}
-var comparisonOps = {
-  "===": (a, b) => a === b,
-  "!==": (a, b) => a !== b,
-  ">=": (a, b) => Number(a) >= Number(b),
-  "<=": (a, b) => Number(a) <= Number(b),
-  ">": (a, b) => Number(a) > Number(b),
-  "<": (a, b) => Number(a) < Number(b)
-};
-function findOperatorOutsideQuotes(str) {
-  const ops = ["===", "!==", ">=", "<=", ">", "<"];
-  let inQuote = null;
-  let escaped = false;
-  for (let i = 0; i < str.length; i++) {
-    const ch = str[i];
-    if (escaped) {
-      escaped = false;
-      continue;
-    }
-    if (ch === "\\") {
-      escaped = true;
-      continue;
-    }
-    if (inQuote) {
-      if (ch === inQuote) inQuote = null;
-      continue;
-    }
-    if (ch === '"' || ch === "'") {
-      inQuote = ch;
-      continue;
-    }
-    for (const op of ops) {
-      if (str.startsWith(op, i)) {
-        return { op, index: i };
-      }
-    }
-  }
-  return null;
-}
-function parseValue(raw) {
-  const trimmed = raw.trim();
-  if (trimmed === "undefined") return void 0;
-  if (trimmed === "null") return null;
-  if (trimmed === "true") return true;
-  if (trimmed === "false") return false;
-  if (/^".*"$/.test(trimmed) || /^'.*'$/.test(trimmed)) return trimmed.slice(1, -1);
-  const num = Number(trimmed);
-  if (!isNaN(num) && trimmed !== "") return num;
-  return trimmed;
-}
-function resolveToken(token, structure) {
-  const trimmed = token.trim();
-  const fieldMatch = trimmed.match(/^\{(\w+)\}$/);
-  const fieldName = fieldMatch?.[1];
-  if (fieldName) {
-    const field = getField(structure, fieldName);
-    return field?.value ?? void 0;
-  }
-  return parseValue(trimmed);
-}
-function interpretValidation(structure, validationString) {
-  if (!structure || !validationString) return void 0;
-  try {
-    if (/&&|\|\|/.test(validationString)) {
-      logError(
-        "Validation.interpret",
-        `Compound expressions are not supported: "${validationString}". Use simple comparisons.`
-      );
-      return false;
-    }
-    const opInfo = findOperatorOutsideQuotes(validationString);
-    if (!opInfo) {
-      return resolveToken(validationString, structure);
-    }
-    const { op, index: opIndex } = opInfo;
-    const left = resolveToken(validationString.slice(0, opIndex), structure);
-    const right = resolveToken(validationString.slice(opIndex + op.length), structure);
-    const fn = op in comparisonOps ? comparisonOps[op] : void 0;
-    if (!fn) {
-      logError("Validation.interpret", `Unknown operator "${op}" in: "${validationString}"`);
-      return false;
-    }
-    return fn(left, right);
-  } catch (error) {
-    logError("Validation.interpret", error);
-    return getContentRes("admin-validation-error");
-  }
-}
-
-export {
-  registerValidator,
-  getValidator,
-  getRegisteredValidators,
-  clearValidators,
-  interpretValidation
-};
-//# sourceMappingURL=chunk-RRWKDFAB.js.map

package/dist/chunk-RRWKDFAB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/validation/validations.ts"],"sourcesContent":["import { getContentRes } from \"../adapters/content-adapter\";\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\nimport { logError } from \"../logger/logger\";\nimport type { ComparisonFunction, FormDataValue, FormDetailRuntime, ValidatorFn } from \"../types/form-types\";\nimport { getField } from \"../types/form-types\";\n\nexport type { ValidatorFn } from \"../types/form-types\";\n\n// Fallback for code that runs before SpringInstance is created\nconst fallbackRegistry = new Map<string, ValidatorFn>();\n\n// Migrate pre-mount validators so they remain available after instance initialization.\nregisterFallbackMigration((instance) => {\n    if (fallbackRegistry.size === 0) return;\n\n    const target = instance.core.validatorRegistry;\n    for (const [name, validator] of fallbackRegistry) {\n        if (!target.has(name)) {\n            target.set(name, validator);\n        }\n    }\n});\n\nfunction getRegistry(): Map<string, ValidatorFn> {\n    const instance = tryGetSpringInstance();\n    return instance ? instance.core.validatorRegistry : fallbackRegistry;\n}\n\n/** Register a named validator (projects can add custom validators) */\nexport function registerValidator(name: string, fn: ValidatorFn): void {\n    getRegistry().set(name, fn);\n}\n\n/** Get a registered validator by name */\nexport function getValidator(name: string): ValidatorFn | undefined {\n    return getRegistry().get(name);\n}\n\n/** Get names of all registered validators. Useful for debugging and introspection. */\nexport function getRegisteredValidators(): string[] {\n    return Array.from(getRegistry().keys());\n}\n\n/** Remove all registered validators from both instance and fallback stores. */\nexport function clearValidators(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.core.validatorRegistry.clear();\n    }\n    fallbackRegistry.clear();\n}\n\ntype ComparisonOperator = \"===\" | \"!==\" | \">=\" | \"<=\" | \">\" | \"<\";\n\nconst comparisonOps = {\n    \"===\": (a, b) => a === b,\n    \"!==\": (a, b) => a !== b,\n    \">=\": (a, b) => Number(a) >= Number(b),\n    \"<=\": (a, b) => Number(a) <= Number(b),\n    \">\": (a, b) => Number(a) > Number(b),\n    \"<\": (a, b) => Number(a) < Number(b),\n} satisfies Record<ComparisonOperator, ComparisonFunction>;\n\n/** Finds the first comparison operator outside quotes */\nfunction findOperatorOutsideQuotes(str: string): { op: string; index: number } | null {\n    const ops = [\"===\", \"!==\", \">=\", \"<=\", \">\", \"<\"];\n    let inQuote: string | null = null;\n    let escaped = false;\n\n    for (let i = 0; i < str.length; i++) {\n        const ch = str[i];\n\n        if (escaped) {\n            escaped = false;\n            continue;\n        }\n\n        if (ch === \"\\\\\") {\n            escaped = true;\n            continue;\n        }\n\n        if (inQuote) {\n            if (ch === inQuote) inQuote = null;\n            continue;\n        }\n\n        if (ch === '\"' || ch === \"'\") {\n            inQuote = ch;\n            continue;\n        }\n\n        for (const op of ops) {\n            if (str.startsWith(op, i)) {\n                return { op, index: i };\n            }\n        }\n    }\n\n    return null;\n}\n\nfunction parseValue(raw: string) {\n    const trimmed = raw.trim();\n    if (trimmed === \"undefined\") return undefined;\n    if (trimmed === \"null\") return null;\n    if (trimmed === \"true\") return true;\n    if (trimmed === \"false\") return false;\n    if (/^\".*\"$/.test(trimmed) || /^'.*'$/.test(trimmed)) return trimmed.slice(1, -1);\n    const num = Number(trimmed);\n    if (!isNaN(num) && trimmed !== \"\") return num;\n    return trimmed;\n}\n\n/**\n * Resolve a token in a validation expression.\n * Tokens are either field references `{fieldName}` or literal values.\n * Field values are returned directly (no string interpolation) to prevent injection.\n */\nfunction resolveToken(token: string, structure: FormDetailRuntime): FormDataValue {\n    const trimmed = token.trim();\n    // Field reference: {fieldName}\n    const fieldMatch = trimmed.match(/^\\{(\\w+)\\}$/);\n    const fieldName = fieldMatch?.[1];\n    if (fieldName) {\n        const field = getField(structure, fieldName);\n        return field?.value ?? undefined;\n    }\n    return parseValue(trimmed);\n}\n\n/** Interprets dynamic validation from string — safe against injection. */\nexport function interpretValidation(structure: FormDetailRuntime, validationString: string) {\n    if (!structure || !validationString) return undefined;\n    try {\n        if (/&&|\\|\\|/.test(validationString)) {\n            logError(\n                \"Validation.interpret\",\n                `Compound expressions are not supported: \"${validationString}\". Use simple comparisons.`,\n            );\n            return false;\n        }\n\n        const opInfo = findOperatorOutsideQuotes(validationString);\n        if (!opInfo) {\n            // No operator — resolve as single token\n            return resolveToken(validationString, structure);\n        }\n\n        const { op, index: opIndex } = opInfo;\n        const left = resolveToken(validationString.slice(0, opIndex), structure);\n        const right = resolveToken(validationString.slice(opIndex + op.length), structure);\n        const fn = op in comparisonOps ? comparisonOps[op as ComparisonOperator] : undefined;\n        if (!fn) {\n            logError(\"Validation.interpret\", `Unknown operator \"${op}\" in: \"${validationString}\"`);\n            return false;\n        }\n        return fn(left, right);\n    } catch (error: unknown) {\n        logError(\"Validation.interpret\", error);\n        return getContentRes(\"admin-validation-error\");\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-RUCXSQEY.js

@@ -1,42 +0,0 @@
-import {
-  logError
-} from "./chunk-KX32MU3I.js";
-
-// src/instance/fallback-bridge.ts
-function applyAllFallbacks(instance) {
-  const sorted = [...fallbackMigrations.values()].sort((a, b) => {
-    if (b.priority !== a.priority) return b.priority - a.priority;
-    return a.order - b.order;
-  });
-  for (const entry of sorted) {
-    try {
-      entry.migration(instance);
-    } catch (e) {
-      logError("FallbackBridge.migration", e);
-    }
-  }
-}
-var fallbackMigrations = /* @__PURE__ */ new Map();
-var registrationOrder = 0;
-function registerFallbackMigration(migration, priority = 0) {
-  const existing = fallbackMigrations.get(migration);
-  if (existing) {
-    existing.priority = priority;
-    return;
-  }
-  fallbackMigrations.set(migration, {
-    migration,
-    priority,
-    order: registrationOrder++
-  });
-}
-function clearFallbackMigrations() {
-  fallbackMigrations.clear();
-}
-
-export {
-  applyAllFallbacks,
-  registerFallbackMigration,
-  clearFallbackMigrations
-};
-//# sourceMappingURL=chunk-RUCXSQEY.js.map

package/dist/chunk-RUCXSQEY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/instance/fallback-bridge.ts"],"sourcesContent":["/**\n * Centralized fallback bridge — migrates pre-mount state to a SpringInstance.\n *\n * Before SpringProvider mounts, various modules (config, adapters, event bus,\n * middleware) store state in module-level fallback variables. When SpringProvider\n * creates and sets the SpringInstance, this function migrates all fallback state\n * to the instance in a single call.\n *\n * This replaces the previous pattern where each module independently checked\n * tryGetSpringInstance() and maintained its own fallback state.\n *\n * @module fallback-bridge\n */\n\nimport { logError } from \"../logger/logger\";\nimport type { SpringInstance } from \"./spring-instance\";\n\n/**\n * Migrate all pre-mount fallback state into the given SpringInstance.\n * Called once by SpringProvider after instance creation.\n *\n * Modules register their fallback migration via registerFallbackMigration().\n * This allows packages (ui, api) to register their own migrations\n * without core needing to know about them.\n */\nexport function applyAllFallbacks(instance: SpringInstance): void {\n    // Run all registered migrations from other modules in deterministic order.\n    // Higher priority runs first; same priority preserves registration order.\n    const sorted = [...fallbackMigrations.values()].sort((a, b) => {\n        if (b.priority !== a.priority) return b.priority - a.priority;\n        return a.order - b.order;\n    });\n    for (const entry of sorted) {\n        try {\n            entry.migration(instance);\n        } catch (e) {\n            logError(\"FallbackBridge.migration\", e);\n        }\n    }\n}\n\ntype FallbackMigration = (instance: SpringInstance) => void;\ninterface FallbackMigrationEntry {\n    migration: FallbackMigration;\n    priority: number;\n    order: number;\n}\nconst fallbackMigrations = new Map<FallbackMigration, FallbackMigrationEntry>();\nlet registrationOrder = 0;\n\n/**\n * Register a fallback migration function.\n * Called by modules that maintain pre-mount fallback state (adapters, event bus, etc.)\n * to ensure their state is migrated when SpringProvider mounts.\n */\nexport function registerFallbackMigration(migration: FallbackMigration, priority = 0): void {\n    const existing = fallbackMigrations.get(migration);\n    if (existing) {\n        existing.priority = priority;\n        return;\n    }\n    fallbackMigrations.set(migration, {\n        migration,\n        priority,\n        order: registrationOrder++,\n    });\n}\n\n/** Clear all registered migrations. For testing only. */\nexport function clearFallbackMigrations(): void {\n    fallbackMigrations.clear();\n}\n"],"mappings":";;;;;AAyBO,SAAS,kBAAkB,UAAgC;AAG9D,QAAM,SAAS,CAAC,GAAG,mBAAmB,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM;AAC3D,QAAI,EAAE,aAAa,EAAE,SAAU,QAAO,EAAE,WAAW,EAAE;AACrD,WAAO,EAAE,QAAQ,EAAE;AAAA,EACvB,CAAC;AACD,aAAW,SAAS,QAAQ;AACxB,QAAI;AACA,YAAM,UAAU,QAAQ;AAAA,IAC5B,SAAS,GAAG;AACR,eAAS,4BAA4B,CAAC;AAAA,IAC1C;AAAA,EACJ;AACJ;AAQA,IAAM,qBAAqB,oBAAI,IAA+C;AAC9E,IAAI,oBAAoB;AAOjB,SAAS,0BAA0B,WAA8B,WAAW,GAAS;AACxF,QAAM,WAAW,mBAAmB,IAAI,SAAS;AACjD,MAAI,UAAU;AACV,aAAS,WAAW;AACpB;AAAA,EACJ;AACA,qBAAmB,IAAI,WAAW;AAAA,IAC9B;AAAA,IACA;AAAA,IACA,OAAO;AAAA,EACX,CAAC;AACL;AAGO,SAAS,0BAAgC;AAC5C,qBAAmB,MAAM;AAC7B;","names":[]}

package/dist/chunk-S6RPCN5H.js

@@ -1,64 +0,0 @@
-import {
-  registerFallbackMigration
-} from "./chunk-RUCXSQEY.js";
-import {
-  tryGetSpringInstance
-} from "./chunk-EFUBAQCV.js";
-
-// src/adapters/telemetry-adapter.ts
-var noopAdapter = {
-  trackEvent: () => {
-  },
-  trackError: () => {
-  },
-  trackTiming: () => {
-  }
-};
-var fallbackAdapter = noopAdapter;
-var UI_KEY = /* @__PURE__ */ Symbol.for("spring:telemetryAdapter");
-registerFallbackMigration((instance) => {
-  if (fallbackAdapter !== noopAdapter) {
-    instance.ui[UI_KEY] = fallbackAdapter;
-  }
-});
-function setTelemetryAdapter(adapter) {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    instance.ui[UI_KEY] = adapter;
-  } else {
-    fallbackAdapter = adapter;
-  }
-}
-function getTelemetryAdapter() {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    return instance.ui[UI_KEY] ?? noopAdapter;
-  }
-  return fallbackAdapter;
-}
-function clearTelemetryAdapter() {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    delete instance.ui[UI_KEY];
-  }
-  fallbackAdapter = noopAdapter;
-}
-function trackEvent(name, data) {
-  getTelemetryAdapter().trackEvent(name, data);
-}
-function trackError(error, context) {
-  getTelemetryAdapter().trackError(error, context);
-}
-function trackTiming(metric, durationMs, data) {
-  getTelemetryAdapter().trackTiming(metric, durationMs, data);
-}
-
-export {
-  setTelemetryAdapter,
-  getTelemetryAdapter,
-  clearTelemetryAdapter,
-  trackEvent,
-  trackError,
-  trackTiming
-};
-//# sourceMappingURL=chunk-S6RPCN5H.js.map

package/dist/chunk-S6RPCN5H.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/adapters/telemetry-adapter.ts"],"sourcesContent":["/**\n * Telemetry adapter — provides hooks for observability, monitoring, and analytics.\n *\n * Enterprise deployments can integrate with APM tools (DataDog, New Relic, etc.)\n * by setting a custom telemetry adapter. The framework emits telemetry events\n * at key lifecycle points (form loads, API calls, errors, etc.)\n *\n * @example\n * ```ts\n * import { setTelemetryAdapter } from \"@spring-systems/core/adapters\";\n *\n * setTelemetryAdapter({\n *     trackEvent(name, data) {\n *         datadogRum.addAction(name, data);\n *     },\n *     trackError(error, context) {\n *         Sentry.captureException(error, { extra: context });\n *     },\n *     trackTiming(metric, durationMs, data) {\n *         performance.measure(metric, { duration: durationMs });\n *     },\n * });\n * ```\n *\n * @module telemetry-adapter\n */\n\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\n\nexport interface TelemetryAdapter {\n    /**\n     * Track a named event with optional structured data.\n     * Called on form save, list load, login, navigation, etc.\n     */\n    trackEvent(name: string, data?: Record<string, unknown>): void;\n\n    /**\n     * Track an error occurrence with optional context.\n     * Called on unhandled errors, API failures, middleware errors, etc.\n     */\n    trackError(error: Error | unknown, context?: Record<string, unknown>): void;\n\n    /**\n     * Track a timing measurement (e.g. API latency, form render time).\n     * @param metric - Metric name (e.g. \"api.response_time\", \"form.load_time\")\n     * @param durationMs - Duration in milliseconds\n     * @param data - Optional context data\n     */\n    trackTiming(metric: string, durationMs: number, data?: Record<string, unknown>): void;\n}\n\nconst noopAdapter = {\n    trackEvent: () => {},\n    trackError: () => {},\n    trackTiming: () => {},\n} satisfies TelemetryAdapter;\n\nlet fallbackAdapter: TelemetryAdapter = noopAdapter;\n\nconst UI_KEY = Symbol.for(\"spring:telemetryAdapter\");\n\n// Migrate fallback telemetry adapter to SpringInstance when SpringProvider mounts\nregisterFallbackMigration((instance) => {\n    if (fallbackAdapter !== noopAdapter) {\n        instance.ui[UI_KEY] = fallbackAdapter;\n    }\n});\n\nexport function setTelemetryAdapter(adapter: TelemetryAdapter): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.ui[UI_KEY] = adapter;\n    } else {\n        fallbackAdapter = adapter;\n    }\n}\n\nexport function getTelemetryAdapter(): TelemetryAdapter {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        return (instance.ui[UI_KEY] as TelemetryAdapter) ?? noopAdapter;\n    }\n    return fallbackAdapter;\n}\n\n/** Reset telemetry adapter to no-op defaults. For testing/integration teardown only. */\nexport function clearTelemetryAdapter(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        delete instance.ui[UI_KEY];\n    }\n    fallbackAdapter = noopAdapter;\n}\n\n/**\n * Convenience helper to track an event via the configured telemetry adapter.\n * Safe to call even if no adapter is configured (no-op).\n */\nexport function trackEvent(name: string, data?: Record<string, unknown>): void {\n    getTelemetryAdapter().trackEvent(name, data);\n}\n\n/**\n * Convenience helper to track an error via the configured telemetry adapter.\n */\nexport function trackError(error: Error | unknown, context?: Record<string, unknown>): void {\n    getTelemetryAdapter().trackError(error, context);\n}\n\n/**\n * Convenience helper to track timing via the configured telemetry adapter.\n */\nexport function trackTiming(metric: string, durationMs: number, data?: Record<string, unknown>): void {\n    getTelemetryAdapter().trackTiming(metric, durationMs, data);\n}\n"],"mappings":";;;;;;;;AAoDA,IAAM,cAAc;AAAA,EAChB,YAAY,MAAM;AAAA,EAAC;AAAA,EACnB,YAAY,MAAM;AAAA,EAAC;AAAA,EACnB,aAAa,MAAM;AAAA,EAAC;AACxB;AAEA,IAAI,kBAAoC;AAExC,IAAM,SAAS,uBAAO,IAAI,yBAAyB;AAGnD,0BAA0B,CAAC,aAAa;AACpC,MAAI,oBAAoB,aAAa;AACjC,aAAS,GAAG,MAAM,IAAI;AAAA,EAC1B;AACJ,CAAC;AAEM,SAAS,oBAAoB,SAAiC;AACjE,QAAM,WAAW,qBAAqB;AACtC,MAAI,UAAU;AACV,aAAS,GAAG,MAAM,IAAI;AAAA,EAC1B,OAAO;AACH,sBAAkB;AAAA,EACtB;AACJ;AAEO,SAAS,sBAAwC;AACpD,QAAM,WAAW,qBAAqB;AACtC,MAAI,UAAU;AACV,WAAQ,SAAS,GAAG,MAAM,KAA0B;AAAA,EACxD;AACA,SAAO;AACX;AAGO,SAAS,wBAA8B;AAC1C,QAAM,WAAW,qBAAqB;AACtC,MAAI,UAAU;AACV,WAAO,SAAS,GAAG,MAAM;AAAA,EAC7B;AACA,oBAAkB;AACtB;AAMO,SAAS,WAAW,MAAc,MAAsC;AAC3E,sBAAoB,EAAE,WAAW,MAAM,IAAI;AAC/C;AAKO,SAAS,WAAW,OAAwB,SAAyC;AACxF,sBAAoB,EAAE,WAAW,OAAO,OAAO;AACnD;AAKO,SAAS,YAAY,QAAgB,YAAoB,MAAsC;AAClG,sBAAoB,EAAE,YAAY,QAAQ,YAAY,IAAI;AAC9D;","names":[]}

package/dist/chunk-S7MKRNMI.js

@@ -1,153 +0,0 @@
-import {
-  registerFallbackMigration
-} from "./chunk-RUCXSQEY.js";
-import {
-  tryGetSpringInstance
-} from "./chunk-EFUBAQCV.js";
-
-// src/config/capabilities.ts
-var UI_KEY = /* @__PURE__ */ Symbol.for("spring:capabilities");
-function cloneValue(value, seen = /* @__PURE__ */ new WeakMap()) {
-  if (value === null || typeof value !== "object") {
-    return value;
-  }
-  const obj = value;
-  if (seen.has(obj)) return seen.get(obj);
-  if (value instanceof Date) {
-    return new Date(value.getTime());
-  }
-  if (value instanceof RegExp) {
-    return new RegExp(value.source, value.flags);
-  }
-  if (value instanceof Map) {
-    const cloned = /* @__PURE__ */ new Map();
-    seen.set(obj, cloned);
-    for (const [k, v] of value.entries()) {
-      cloned.set(cloneValue(k, seen), cloneValue(v, seen));
-    }
-    return cloned;
-  }
-  if (value instanceof Set) {
-    const cloned = /* @__PURE__ */ new Set();
-    seen.set(obj, cloned);
-    for (const item of value.values()) {
-      cloned.add(cloneValue(item, seen));
-    }
-    return cloned;
-  }
-  if (Array.isArray(value)) {
-    const cloned = [];
-    seen.set(obj, cloned);
-    for (const item of value) {
-      cloned.push(cloneValue(item, seen));
-    }
-    return cloned;
-  }
-  const proto = Object.getPrototypeOf(value);
-  const clonedObj = Object.create(proto);
-  seen.set(obj, clonedObj);
-  for (const key of Reflect.ownKeys(value)) {
-    const descriptor = Object.getOwnPropertyDescriptor(value, key);
-    if (!descriptor) continue;
-    if ("value" in descriptor) {
-      descriptor.value = cloneValue(descriptor.value, seen);
-    }
-    Object.defineProperty(clonedObj, key, descriptor);
-  }
-  return clonedObj;
-}
-function deepFreeze(value, seen = /* @__PURE__ */ new WeakSet()) {
-  if (value !== null && typeof value === "object") {
-    const obj = value;
-    if (seen.has(obj)) return value;
-    seen.add(obj);
-    if (value instanceof Map) {
-      for (const [k, v] of value.entries()) {
-        deepFreeze(k, seen);
-        deepFreeze(v, seen);
-      }
-      Object.freeze(value);
-      return value;
-    }
-    if (value instanceof Set) {
-      for (const item of value.values()) {
-        deepFreeze(item, seen);
-      }
-      Object.freeze(value);
-      return value;
-    }
-    for (const key of Reflect.ownKeys(value)) {
-      const descriptor = Object.getOwnPropertyDescriptor(value, key);
-      if (!descriptor || !("value" in descriptor)) continue;
-      deepFreeze(descriptor.value, seen);
-    }
-    Object.freeze(value);
-  }
-  return value;
-}
-function getStore() {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    if (!instance.ui[UI_KEY]) {
-      const emptyStore = {};
-      instance.ui[UI_KEY] = emptyStore;
-    }
-    return instance.ui[UI_KEY];
-  }
-  return fallbackStore;
-}
-var fallbackStore = {};
-registerFallbackMigration((instance) => {
-  if (Object.keys(fallbackStore).length === 0) return;
-  const existing = instance.ui[UI_KEY];
-  if (!existing || typeof existing !== "object") {
-    instance.ui[UI_KEY] = { ...fallbackStore };
-    return;
-  }
-  const instanceStore = existing;
-  for (const [key, value] of Object.entries(fallbackStore)) {
-    if (!(key in instanceStore)) {
-      instanceStore[key] = value;
-    }
-  }
-});
-function configureCapabilities(capabilities) {
-  const store = getStore();
-  Object.assign(store, capabilities);
-}
-function hasCapability(name) {
-  const store = getStore();
-  const value = store[name];
-  if (value === void 0 || value === null) return false;
-  if (typeof value === "boolean") return value;
-  if (typeof value === "object" && value !== null && "enabled" in value) {
-    return !!value.enabled;
-  }
-  return !!value;
-}
-function getCapability(name) {
-  return getStore()[name];
-}
-function getCapabilities() {
-  return deepFreeze(cloneValue(getStore()));
-}
-function getRegisteredCapabilityNames() {
-  return Object.keys(getStore());
-}
-function clearCapabilities() {
-  const instance = tryGetSpringInstance();
-  if (instance) {
-    instance.ui[UI_KEY] = {};
-  }
-  fallbackStore = {};
-}
-
-export {
-  configureCapabilities,
-  hasCapability,
-  getCapability,
-  getCapabilities,
-  getRegisteredCapabilityNames,
-  clearCapabilities
-};
-//# sourceMappingURL=chunk-S7MKRNMI.js.map

package/dist/chunk-S7MKRNMI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config/capabilities.ts"],"sourcesContent":["/**\n * Feature capability system for enterprise SPRING deployments.\n *\n * Capabilities allow framework consumers to enable/disable features\n * per client deployment. Plugins can declare required capabilities\n * and the framework checks them at registration time.\n *\n * @example\n * ```ts\n * // In project-config.ts:\n * configureCapabilities({\n *     charts: true,\n *     advancedFiltering: true,\n *     bulkOperations: false,\n *     export: { enabled: true, formats: [\"xlsx\", \"pdf\"] },\n * });\n *\n * // In a plugin:\n * if (hasCapability(\"advancedFiltering\")) {\n *     registerMiddleware(\"list:beforeLoad\", advancedFilterMiddleware);\n * }\n *\n * // In a component:\n * const canExport = hasCapability(\"export\");\n * ```\n *\n * @module capabilities\n */\n\nimport { tryGetSpringInstance } from \"../instance/current-instance\";\nimport { registerFallbackMigration } from \"../instance/fallback-bridge\";\nimport type { CapabilityMap } from \"./capability-types\";\n\nexport type { CapabilityMap } from \"./capability-types\";\n\n/**\n * Extensible capability map. Consumers and plugins extend via declaration merging:\n *\n * @example\n * ```ts\n * declare module \"@spring-systems/core/config\" {\n *     interface CapabilityMap {\n *         \"myPlugin:feature\": boolean;\n *     }\n * }\n * ```\n */\nconst UI_KEY = Symbol.for(\"spring:capabilities\");\n\ntype CapabilityStore = Partial<CapabilityMap> & Record<string, unknown>;\n\nfunction cloneValue<T>(value: T, seen = new WeakMap<object, unknown>()): T {\n    if (value === null || typeof value !== \"object\") {\n        return value;\n    }\n\n    const obj = value as object;\n    if (seen.has(obj)) return seen.get(obj) as T;\n\n    if (value instanceof Date) {\n        return new Date(value.getTime()) as T;\n    }\n    if (value instanceof RegExp) {\n        return new RegExp(value.source, value.flags) as T;\n    }\n    if (value instanceof Map) {\n        const cloned = new Map<unknown, unknown>();\n        seen.set(obj, cloned);\n        for (const [k, v] of value.entries()) {\n            cloned.set(cloneValue(k, seen), cloneValue(v, seen));\n        }\n        return cloned as T;\n    }\n    if (value instanceof Set) {\n        const cloned = new Set<unknown>();\n        seen.set(obj, cloned);\n        for (const item of value.values()) {\n            cloned.add(cloneValue(item, seen));\n        }\n        return cloned as T;\n    }\n    if (Array.isArray(value)) {\n        const cloned: unknown[] = [];\n        seen.set(obj, cloned);\n        for (const item of value) {\n            cloned.push(cloneValue(item, seen));\n        }\n        return cloned as T;\n    }\n\n    const proto = Object.getPrototypeOf(value);\n    const clonedObj = Object.create(proto) as Record<PropertyKey, unknown>;\n    seen.set(obj, clonedObj);\n    for (const key of Reflect.ownKeys(value)) {\n        const descriptor = Object.getOwnPropertyDescriptor(value, key);\n        if (!descriptor) continue;\n        if (\"value\" in descriptor) {\n            descriptor.value = cloneValue(descriptor.value, seen);\n        }\n        Object.defineProperty(clonedObj, key, descriptor);\n    }\n    return clonedObj as T;\n}\n\nfunction deepFreeze<T>(value: T, seen = new WeakSet<object>()): T {\n    if (value !== null && typeof value === \"object\") {\n        const obj = value as object;\n        if (seen.has(obj)) return value;\n        seen.add(obj);\n\n        if (value instanceof Map) {\n            for (const [k, v] of value.entries()) {\n                deepFreeze(k, seen);\n                deepFreeze(v, seen);\n            }\n            Object.freeze(value);\n            return value;\n        }\n\n        if (value instanceof Set) {\n            for (const item of value.values()) {\n                deepFreeze(item, seen);\n            }\n            Object.freeze(value);\n            return value;\n        }\n\n        for (const key of Reflect.ownKeys(value)) {\n            const descriptor = Object.getOwnPropertyDescriptor(value, key);\n            if (!descriptor || !(\"value\" in descriptor)) continue;\n            deepFreeze(descriptor.value, seen);\n        }\n        Object.freeze(value);\n    }\n    return value;\n}\n\nfunction getStore(): CapabilityStore {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        if (!instance.ui[UI_KEY]) {\n            const emptyStore: CapabilityStore = {};\n            instance.ui[UI_KEY] = emptyStore;\n        }\n        return instance.ui[UI_KEY] as CapabilityStore;\n    }\n    return fallbackStore;\n}\n\nlet fallbackStore: CapabilityStore = {};\n\n// Migrate fallback capabilities to SpringInstance when SpringProvider mounts.\n// Merge is non-destructive: explicit instance values win over fallback values.\nregisterFallbackMigration((instance) => {\n    if (Object.keys(fallbackStore).length === 0) return;\n\n    const existing = instance.ui[UI_KEY];\n    if (!existing || typeof existing !== \"object\") {\n        instance.ui[UI_KEY] = { ...fallbackStore };\n        return;\n    }\n\n    const instanceStore = existing as CapabilityStore;\n    for (const [key, value] of Object.entries(fallbackStore)) {\n        if (!(key in instanceStore)) {\n            instanceStore[key] = value;\n        }\n    }\n});\n\n/**\n * Configure feature capabilities for this deployment.\n * Merges with existing capabilities (does not replace).\n */\nexport function configureCapabilities(capabilities: Partial<CapabilityMap> & Record<string, unknown>): void {\n    const store = getStore();\n    Object.assign(store, capabilities);\n}\n\n/**\n * Check if a capability is enabled.\n * Returns false for unknown/unconfigured capabilities.\n */\nexport function hasCapability<K extends keyof CapabilityMap>(name: K): boolean {\n    const store = getStore();\n    const value = store[name];\n    if (value === undefined || value === null) return false;\n    if (typeof value === \"boolean\") return value;\n    if (typeof value === \"object\" && value !== null && \"enabled\" in value) {\n        return !!(value as { enabled: boolean }).enabled;\n    }\n    return !!value;\n}\n\n/**\n * Get the full capability configuration for a feature.\n * Returns undefined if the capability is not configured.\n */\nexport function getCapability<K extends keyof CapabilityMap>(name: K): CapabilityMap[K] | undefined {\n    return getStore()[name] as CapabilityMap[K] | undefined;\n}\n\n/** Get all configured capabilities. */\nexport function getCapabilities(): Readonly<CapabilityStore> {\n    return deepFreeze(cloneValue(getStore()));\n}\n\n/**\n * Get the names of all currently registered (configured) capabilities.\n * Useful for introspection and for validating that plugin capability\n * references point to actually-configured features.\n */\nexport function getRegisteredCapabilityNames(): string[] {\n    return Object.keys(getStore());\n}\n\n/** Reset all capabilities. For testing only. */\nexport function clearCapabilities(): void {\n    const instance = tryGetSpringInstance();\n    if (instance) {\n        instance.ui[UI_KEY] = {};\n    }\n    fallbackStore = {};\n}\n"],"mappings":"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","names":[]}