@spring-systems/core 0.8.6 → 0.8.9

package/dist/middleware/index.js

@@ -1,23 +1 @@
-import {
-  createAuditMiddleware
-} from "../chunk-SQB4F3EF.js";
-import {
-  clearAllMiddleware,
-  composeMiddleware,
-  getMiddlewareRunner,
-  getRegisteredMiddlewareSlots,
-  registerMiddleware
-} from "../chunk-MEWPYTWC.js";
-import "../chunk-RUCXSQEY.js";
-import "../chunk-KX32MU3I.js";
-import "../chunk-EFUBAQCV.js";
-import "../chunk-PT4DIYUK.js";
-export {
-  clearAllMiddleware,
-  composeMiddleware,
-  createAuditMiddleware,
-  getMiddlewareRunner,
-  getRegisteredMiddlewareSlots,
-  registerMiddleware
-};
-//# sourceMappingURL=index.js.map
+import{a as f}from"../chunk-F3VXVDPQ.js";import{a,b,c,d,e}from"../chunk-3OMNT22N.js";import"../chunk-YMSSF2ZU.js";import"../chunk-EVDFSWPU.js";import"../chunk-JRHMAY5G.js";import"../chunk-OOVZTF74.js";export{e as clearAllMiddleware,a as composeMiddleware,f as createAuditMiddleware,c as getMiddlewareRunner,d as getRegisteredMiddlewareSlots,b as registerMiddleware};

package/dist/plugins/index.js

@@ -1,16 +1 @@
-import {
-  applyPlugins,
-  disposePlugins,
-  getLoadedPlugins
-} from "../chunk-GXU75LQX.js";
-import "../chunk-S7MKRNMI.js";
-import "../chunk-RUCXSQEY.js";
-import "../chunk-KX32MU3I.js";
-import "../chunk-EFUBAQCV.js";
-import "../chunk-PT4DIYUK.js";
-export {
-  applyPlugins,
-  disposePlugins,
-  getLoadedPlugins
-};
-//# sourceMappingURL=index.js.map
+import{a as n,b as e,c as i}from"../chunk-6J2VFOKL.js";import"../chunk-UT6X6RQM.js";import"../chunk-YMSSF2ZU.js";import"../chunk-EVDFSWPU.js";import"../chunk-JRHMAY5G.js";import"../chunk-OOVZTF74.js";export{n as applyPlugins,e as disposePlugins,i as getLoadedPlugins};

package/dist/testing/index.js

@@ -1,171 +1 @@
-import {
-  createSpringInstance
-} from "../chunk-F2SIMWZ5.js";
-import {
-  applyPlugins,
-  disposePlugins
-} from "../chunk-GXU75LQX.js";
-import {
-  eventBus
-} from "../chunk-OSSX443T.js";
-import {
-  clearAllMiddleware
-} from "../chunk-MEWPYTWC.js";
-import {
-  clearRuntimeEnvKeys
-} from "../chunk-UDT2RPX2.js";
-import {
-  clearCapabilities
-} from "../chunk-S7MKRNMI.js";
-import {
-  clearFrameworkConfig
-} from "../chunk-F7WUQJH7.js";
-import {
-  clearValidators
-} from "../chunk-RRWKDFAB.js";
-import "../chunk-QAVWXARR.js";
-import {
-  clearAuthState
-} from "../chunk-HFELOXDQ.js";
-import {
-  clearHttpAdapter,
-  clearLicenseAdapter,
-  clearNotificationAdapter
-} from "../chunk-GON7Q32Q.js";
-import {
-  clearTelemetryAdapter
-} from "../chunk-S6RPCN5H.js";
-import {
-  clearContentAdapter
-} from "../chunk-NQQIVCLX.js";
-import "../chunk-N2L4TUC4.js";
-import "../chunk-RUCXSQEY.js";
-import {
-  clearLogAdapter,
-  resetLogLevel
-} from "../chunk-KX32MU3I.js";
-import {
-  clearSpringInstance,
-  setSpringInstance
-} from "../chunk-EFUBAQCV.js";
-import "../chunk-PT4DIYUK.js";
-
-// src/testing/test-utils.ts
-function createTestInstance(options = {}) {
-  const instance = createSpringInstance(options.config);
-  if (options.contentAdapter) {
-    instance.core.contentAdapter = options.contentAdapter;
-  }
-  if (options.notificationAdapter) {
-    instance.core.notificationAdapter = options.notificationAdapter;
-  }
-  if (options.logAdapter) {
-    instance.core.logAdapter = options.logAdapter;
-  }
-  if (options.setGlobal !== false) {
-    setSpringInstance(instance);
-  }
-  if (options.plugins && options.plugins.length > 0) {
-    applyPlugins(instance, options.plugins);
-  }
-  const originalDispose = instance.dispose.bind(instance);
-  instance.dispose = () => {
-    disposePlugins(instance);
-    originalDispose();
-    if (options.setGlobal !== false) {
-      clearSpringInstance();
-    }
-  };
-  return instance;
-}
-var mockAdapters = {
-  /** Content adapter that returns the key itself (identity) */
-  content: () => ({
-    getRes: (key) => key
-  }),
-  /** Content adapter that returns a custom mapping */
-  contentWithMessages: (messages) => ({
-    getRes: (key) => messages[key] ?? `[${key}]`
-  }),
-  /** Notification adapter that collects all notifications for assertions */
-  notificationCollector: () => {
-    const calls = [];
-    return {
-      adapter: {
-        error: (msg) => calls.push({ type: "error", msg }),
-        success: (msg) => calls.push({ type: "success", msg }),
-        warning: (msg) => calls.push({ type: "warning", msg }),
-        info: (msg) => calls.push({ type: "info", msg })
-      },
-      calls,
-      clear: () => {
-        calls.length = 0;
-      }
-    };
-  },
-  /** Log adapter that collects all log entries for assertions */
-  logCollector: () => {
-    const errors = [];
-    const warnings = [];
-    const securityEvents = [];
-    return {
-      adapter: {
-        onError: (ctx, err) => errors.push({ context: ctx, error: err }),
-        onWarn: (ctx, msg) => warnings.push({ context: ctx, message: msg }),
-        onSecurityEvent: (evt, data) => securityEvents.push({ event: evt, data })
-      },
-      errors,
-      warnings,
-      securityEvents
-    };
-  },
-  /** Silent no-op adapters (suppress all output) */
-  silent: {
-    content: { getRes: (key) => key },
-    notification: {
-      error: (_msg) => {
-      },
-      success: (_msg) => {
-      },
-      warning: (_msg) => {
-      },
-      info: (_msg) => {
-      }
-    },
-    log: {}
-  }
-};
-function castTo(value) {
-  return value;
-}
-function assertDefined(val, msg) {
-  if (val === void 0 || val === null) {
-    throw new Error(msg ?? "Expected value to be defined, but got " + String(val));
-  }
-  return val;
-}
-function resetCoreRuntimeState() {
-  eventBus.clearAll();
-  clearAllMiddleware();
-  clearValidators();
-  clearCapabilities();
-  clearFrameworkConfig();
-  clearRuntimeEnvKeys();
-  clearAuthState();
-  clearContentAdapter();
-  clearNotificationAdapter();
-  clearHttpAdapter();
-  clearLicenseAdapter();
-  clearTelemetryAdapter();
-  clearLogAdapter();
-  resetLogLevel();
-  clearSpringInstance();
-}
-export {
-  assertDefined,
-  castTo,
-  createTestInstance,
-  mockAdapters,
-  resetCoreRuntimeState
-};
-//# sourceMappingURL=index.js.map
+import{a as x}from"../chunk-Y6DB43IE.js";import{a as S,b as T}from"../chunk-6J2VFOKL.js";import{a as d}from"../chunk-RKLYBW3O.js";import{e as u}from"../chunk-3OMNT22N.js";import{d as f}from"../chunk-PNDXLNCU.js";import{f as p}from"../chunk-UT6X6RQM.js";import{f as g}from"../chunk-RVQHSQYF.js";import{d as A}from"../chunk-AMXSATFF.js";import"../chunk-ICKHSEIX.js";import{e as y}from"../chunk-4KRUU6MS.js";import{c as I,f as w,l as C}from"../chunk-BMIRKMVX.js";import{c as l}from"../chunk-R3XYEEGR.js";import{c as m}from"../chunk-7P4BJDQR.js";import"../chunk-HUASNNWD.js";import"../chunk-YMSSF2ZU.js";import{f as a,g as c}from"../chunk-EVDFSWPU.js";import{e as o,h as s}from"../chunk-JRHMAY5G.js";import"../chunk-OOVZTF74.js";function h(t={}){let e=x(t.config);t.contentAdapter&&(e.core.contentAdapter=t.contentAdapter),t.notificationAdapter&&(e.core.notificationAdapter=t.notificationAdapter),t.logAdapter&&(e.core.logAdapter=t.logAdapter),t.setGlobal!==!1&&o(e),t.plugins&&t.plugins.length>0&&S(e,t.plugins);let i=e.dispose.bind(e);return e.dispose=()=>{T(e),i(),t.setGlobal!==!1&&s()},e}var L={content:()=>({getRes:t=>t}),contentWithMessages:t=>({getRes:e=>t[e]??`[${e}]`}),notificationCollector:()=>{let t=[];return{adapter:{error:e=>t.push({type:"error",msg:e}),success:e=>t.push({type:"success",msg:e}),warning:e=>t.push({type:"warning",msg:e}),info:e=>t.push({type:"info",msg:e})},calls:t,clear:()=>{t.length=0}}},logCollector:()=>{let t=[],e=[],i=[];return{adapter:{onError:(n,r)=>t.push({context:n,error:r}),onWarn:(n,r)=>e.push({context:n,message:r}),onSecurityEvent:(n,r)=>i.push({event:n,data:r})},errors:t,warnings:e,securityEvents:i}},silent:{content:{getRes:t=>t},notification:{error:t=>{},success:t=>{},warning:t=>{},info:t=>{}},log:{}}};function k(t){return t}function b(t,e){if(t==null)throw new Error(e??"Expected value to be defined, but got "+String(t));return t}function v(){d.clearAll(),u(),A(),p(),g(),f(),y(),m(),C(),I(),w(),l(),a(),c(),s()}export{b as assertDefined,k as castTo,h as createTestInstance,L as mockAdapters,v as resetCoreRuntimeState};

package/dist/types/index.js

@@ -1,72 +1 @@
-import {
-  getField,
-  getIdentifiableId,
-  getStoreValue,
-  getSubState,
-  isFormFieldRuntime,
-  storeBoundary,
-  toFormDataValue
-} from "../chunk-QAVWXARR.js";
-
-// src/types/branded.ts
-function toGuid(value) {
-  return value;
-}
-function toIdPublic(value) {
-  return value;
-}
-function toResourceKey(value) {
-  return value;
-}
-function toApiRoute(value) {
-  return value;
-}
-
-// src/types/grid-types.ts
-function isFilterNode(val) {
-  if (typeof val !== "object" || val === null || Array.isArray(val)) return false;
-  return "logic" in val && "filters" in val || "field" in val && "operator" in val;
-}
-function isCombinedSettingData(val) {
-  if (typeof val !== "object" || val === null || Array.isArray(val)) return false;
-  return "user_filter" in val || "layout" in val;
-}
-function isPermission(val) {
-  if (typeof val !== "object" || val === null || Array.isArray(val)) return false;
-  const obj = val;
-  return typeof obj.read === "boolean" && typeof obj.list === "boolean" && typeof obj.delete === "boolean" && typeof obj.insert === "boolean" && typeof obj.update === "boolean";
-}
-function isColumnLayout(val) {
-  if (typeof val !== "object" || val === null || Array.isArray(val)) return false;
-  const obj = val;
-  return typeof obj.key === "string" && typeof obj.order === "number" && typeof obj.show === "boolean";
-}
-
-// src/types/list-types.ts
-var FormatType = {
-  Badge: 1,
-  Color: 2,
-  Background: 3,
-  RowBackground: 4,
-  Icon: 5,
-  Detail: 6
-};
-export {
-  FormatType,
-  getField,
-  getIdentifiableId,
-  getStoreValue,
-  getSubState,
-  isColumnLayout,
-  isCombinedSettingData,
-  isFilterNode,
-  isFormFieldRuntime,
-  isPermission,
-  storeBoundary,
-  toApiRoute,
-  toFormDataValue,
-  toGuid,
-  toIdPublic,
-  toResourceKey
-};
-//# sourceMappingURL=index.js.map
+import{a as o,b as r,c as n,d as i,e as a,f as s,g as u}from"../chunk-ICKHSEIX.js";function p(e){return e}function l(e){return e}function d(e){return e}function y(e){return e}function c(e){return typeof e!="object"||e===null||Array.isArray(e)?!1:"logic"in e&&"filters"in e||"field"in e&&"operator"in e}function m(e){return typeof e!="object"||e===null||Array.isArray(e)?!1:"user_filter"in e||"layout"in e}function g(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;let t=e;return typeof t.read=="boolean"&&typeof t.list=="boolean"&&typeof t.delete=="boolean"&&typeof t.insert=="boolean"&&typeof t.update=="boolean"}function b(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;let t=e;return typeof t.key=="string"&&typeof t.order=="number"&&typeof t.show=="boolean"}var _={Badge:1,Color:2,Background:3,RowBackground:4,Icon:5,Detail:6};export{_ as FormatType,a as getField,o as getIdentifiableId,u as getStoreValue,s as getSubState,b as isColumnLayout,m as isCombinedSettingData,c as isFilterNode,i as isFormFieldRuntime,g as isPermission,r as storeBoundary,y as toApiRoute,n as toFormDataValue,p as toGuid,l as toIdPublic,d as toResourceKey};

package/dist/utils/index.d.ts

@@ -13,6 +13,47 @@ declare function getBrightness(r: number, g: number, b: number): number;
 declare function hexToRgb(hex: string): [number, number, number];
 declare function rgbToHex(rgb: string): string;
 declare function getContrastYIQ(hex: string): string;
+/**
+ * Background → text contrast pairs for automatic text color derivation.
+ *
+ * Only includes the sidebar menu — the one component where projects routinely
+ * override the background independently of `--spring-color-primary`.
+ *
+ * List headers and buttons are intentionally excluded: their text colors are
+ * derived from the CSS variable chain (`text-secondary` / `text-on-accent`)
+ * which already produces correct results for both light and dark modes.
+ * Auto-deriving them would override intentional design choices (e.g. white
+ * text on a medium-toned gold that the YIQ formula classifies as "light").
+ */
+declare const CONTRAST_PAIRS: ReadonlyArray<{
+    bg: string;
+    text: string;
+}>;
+/**
+ * Resolve a CSS custom property to a hex color value.
+ * Uses a probe element to force the browser to resolve `var()` chains
+ * and named colors (e.g. "white") to computed `rgb()` values.
+ *
+ * @returns Hex color string (e.g. "#2563eb") or null if unresolvable.
+ */
+declare function resolveColorVar(cssVar: string, root?: HTMLElement): string | null;
+/**
+ * Auto-derive text colors from background colors using YIQ contrast.
+ *
+ * For each pair: resolves the computed background color, determines if it is
+ * light or dark, and sets the text variable to `--spring-color-text` (for
+ * light backgrounds) or `#ffffff` (for dark backgrounds).
+ *
+ * Called automatically by the theme store after dark mode init and on
+ * theme changes. Projects can also call it after runtime CSS variable changes.
+ *
+ * @param pairs  — Override default pairs. Defaults to {@link CONTRAST_PAIRS}.
+ * @param root   — Override root element. Defaults to `document.documentElement`.
+ */
+declare function applyContrastColors(pairs?: ReadonlyArray<{
+    bg: string;
+    text: string;
+}>, root?: HTMLElement): void;
 
 declare function isValueNotEmpty(value: string | number | boolean | null | undefined | FormDataValue[]): boolean;
 /** Returns a deep copy of an object, removing unwanted references. */
@@ -72,6 +113,7 @@ declare const dateManager: {
 /**
  * Runtime deprecation warnings for the SPRING framework.
  * Warns once per session per deprecation to avoid console spam.
+ * Silent in production — warnings are only shown in development mode.
  * @module deprecation
  */
 declare function springDeprecate(name: string, alternative: string, removeVersion?: string): void;
@@ -139,4 +181,4 @@ declare function removeNode<T extends BaseTreeNode>(nodes: T[], id: string, chil
 declare function addNode<T extends BaseTreeNode>(nodes: T[], parentId: string | null, newNode: T, childrenField?: string): T[];
 declare function findParentId<T extends BaseTreeNode>(nodes: T[], id: string, childrenField?: string, parentId?: string | null): string | null;
 
-export { type BaseTreeNode, type ValueType, __DEV__, addNode, clearDeprecationWarnings, dateManager, deepCopy, deepEqual, deepMerge, devAssert, devThrow, devWarn, findNode, findParentId, generateGUID, getAllIds, getBrightness, getChildren, getContrastYIQ, getFilterFieldType, getValueByPath, getValueType, hexToRgb, isValueNotEmpty, normalizeString, normalizeSystemFilter, onKeyActivate, parseFilter, parseJSONSafely, prefersReducedMotion, removeNode, rgbToHex, sanitizeContent, sanitizeEditorContent, setColumnBodyType, setDateLocale, setDefaultStructure, springDeprecate, toNumber, truncateString, updateNode };
+export { type BaseTreeNode, CONTRAST_PAIRS, type ValueType, __DEV__, addNode, applyContrastColors, clearDeprecationWarnings, dateManager, deepCopy, deepEqual, deepMerge, devAssert, devThrow, devWarn, findNode, findParentId, generateGUID, getAllIds, getBrightness, getChildren, getContrastYIQ, getFilterFieldType, getValueByPath, getValueType, hexToRgb, isValueNotEmpty, normalizeString, normalizeSystemFilter, onKeyActivate, parseFilter, parseJSONSafely, prefersReducedMotion, removeNode, resolveColorVar, rgbToHex, sanitizeContent, sanitizeEditorContent, setColumnBodyType, setDateLocale, setDefaultStructure, springDeprecate, toNumber, truncateString, updateNode };