@spring-systems/core 0.8.0

package/dist/framework-config-types-DeUbx4bu.d.ts

@@ -0,0 +1,574 @@
+/**
+ * Shared capability type contract.
+ * This file is intentionally runtime-free to avoid circular dependencies.
+ * @module capability-types
+ */
+/**
+ * Extensible capability map. Consumers and plugins extend via declaration merging:
+ *
+ * @example
+ * ```ts
+ * declare module "@spring-systems/core/config" {
+ *     interface CapabilityMap {
+ *         "myPlugin:feature": boolean;
+ *     }
+ * }
+ * ```
+ */
+interface CapabilityMap {
+    /** Enable chart components (EChart, area, donut, line) */
+    charts: boolean;
+    /** Enable advanced filtering with custom operators */
+    advancedFiltering: boolean;
+    /** Enable bulk operations on lists (bulk delete, bulk edit) */
+    bulkOperations: boolean;
+    /** Enable data export functionality */
+    export: boolean | {
+        enabled: boolean;
+        formats: string[];
+    };
+    /** Enable drag-and-drop reordering in lists and trees */
+    dragAndDrop: boolean;
+    /** Enable real-time updates via SignalR */
+    realtime: boolean;
+}
+
+/** Empty GUID for new records */
+declare const emptyGuid = "00000000-0000-0000-0000-000000000000";
+/** Generic interface for select options */
+interface CodeList {
+    id_public: string;
+    name: string;
+    code?: string;
+    version?: number;
+}
+/** Interface for persons (full_name) */
+interface CodeListFullName {
+    id_public: string;
+    full_name: string;
+    first_name: string;
+    last_name?: string;
+}
+interface CodeListNumber {
+    id_public: number;
+    name: string;
+}
+type Operator = "=" | ">" | ">=" | "<" | "<=" | "!=" | "in" | "between";
+/** CSS selector for an open dialog (detection in shortcut hooks) */
+declare const DIALOG_CONTENT_SELECTOR = ".spring-dialog-content";
+/** DnD TouchSensor activation constraint (delay + tolerance) */
+declare const DND_TOUCH_CONSTRAINT: {
+    readonly delay: 200;
+    readonly tolerance: 5;
+};
+declare const STORAGE_KEYS: {
+    readonly LANGUAGE: "language";
+    readonly COLOR_THEME: "colorTheme";
+};
+/** Union type of all storage key values. */
+type StorageKey = (typeof STORAGE_KEYS)[keyof typeof STORAGE_KEYS];
+
+/**
+ * Theme variable contract for the SPRING framework.
+ * Projects override these via CSS `@theme` in their globals.css.
+ * @module theme
+ */
+/** Template literal type for SPRING CSS custom properties. */
+type SpringCssVariable = `--spring-${string}`;
+interface SpringThemeVariables {
+    colorPrimary: string;
+    colorPrimaryLight: string;
+    colorPrimaryDark: string;
+    colorSecondaryDark: string;
+    colorDanger: string;
+    colorSuccess: string;
+    colorSuccessLight: string;
+    colorBg: string;
+    colorBgLight: string;
+    colorPanel: string;
+    colorBorder: string;
+    colorActive: string;
+    colorDisabledBg: string;
+    colorText: string;
+    colorTextMuted: string;
+    colorTextDisabled: string;
+    colorTextSecondary: string;
+    colorPanelSecondary: string;
+    colorPanelDashboard: string;
+    colorPanelDashboardSecondary: string;
+    colorPanelAlt: string;
+    colorChartBg: string;
+    colorDarkLightSecondary: string;
+    fontSizeXxs: string;
+    fontSizeXs: string;
+    fontSizeSm: string;
+    fontSizeMd: string;
+    fontSizeLg: string;
+    fontSizeXl: string;
+    fontSize2xl: string;
+    radiusXs: string;
+    radiusSm: string;
+    radiusMd: string;
+    radiusLg: string;
+    radiusXl: string;
+    radiusDialog: string;
+    radiusPanel: string;
+    shadowXs: string;
+    shadowSm: string;
+    shadowMd: string;
+    shadowLg: string;
+    shadowPopup: string;
+    shadowNavbar: string;
+    shadowInset: string;
+    shadowBottom: string;
+    shadowDnd: string;
+    shadowDndLg: string;
+    shadowDragSm: string;
+    shadowSubtle: string;
+    shadowRingWhite: string;
+    transitionFast: string;
+    transitionNormal: string;
+    opacityGhost: string;
+    opacitySubtle: string;
+    opacityDisabled: string;
+    opacityMuted: string;
+    opacityOverlay: string;
+    opacityHover: string;
+    opacityHigh: string;
+    opacityNearOpaque: string;
+    sizeInputHeight: string;
+    fontFamilyBase: string;
+}
+declare const DEFAULT_THEME: {
+    readonly colorPrimary: "#2563EB";
+    readonly colorPrimaryLight: "#2563eb1f";
+    readonly colorPrimaryDark: "#1d4ed8";
+    readonly colorSecondaryDark: "#1e3a5f";
+    readonly colorDanger: "#b91c1c";
+    readonly colorSuccess: "#15803d";
+    readonly colorSuccessLight: "#e5f3ec";
+    readonly colorBg: "#dfebfb";
+    readonly colorBgLight: "#eff6ff";
+    readonly colorPanel: "white";
+    readonly colorBorder: "#a2a3b8";
+    readonly colorActive: "#ffbf49";
+    readonly colorDisabledBg: "#e4e4e4";
+    readonly colorText: "black";
+    readonly colorTextMuted: "#666666";
+    readonly colorTextDisabled: "#636363";
+    readonly colorTextSecondary: "white";
+    readonly colorPanelSecondary: "white";
+    readonly colorPanelDashboard: "#dfebfb";
+    readonly colorPanelDashboardSecondary: "#cbdbf2";
+    readonly colorPanelAlt: "#f9fafb";
+    readonly colorChartBg: "#201f25";
+    readonly colorDarkLightSecondary: "#eff6ff";
+    readonly fontSizeXxs: "10px";
+    readonly fontSizeXs: "11px";
+    readonly fontSizeSm: "12px";
+    readonly fontSizeMd: "13px";
+    readonly fontSizeLg: "14px";
+    readonly fontSizeXl: "16px";
+    readonly fontSize2xl: "22px";
+    readonly radiusXs: "1px";
+    readonly radiusSm: "3px";
+    readonly radiusMd: "6px";
+    readonly radiusLg: "12px";
+    readonly radiusXl: "16px";
+    readonly radiusDialog: "8px";
+    readonly radiusPanel: "10px";
+    readonly shadowXs: "0 1px 2px rgba(0, 0, 0, 0.06)";
+    readonly shadowSm: "0 2px 6px rgba(0, 0, 0, 0.06)";
+    readonly shadowMd: "0 4px 12px rgba(0, 0, 0, 0.15)";
+    readonly shadowLg: "0 4px 16px rgba(0, 0, 0, 0.12)";
+    readonly shadowPopup: "0 12px 32px rgba(0, 0, 0, 0.18), 0 6px 12px rgba(0, 0, 0, 0.12)";
+    readonly shadowNavbar: "0 2px 8px rgba(0, 0, 0, 0.08), 0 4px 16px rgba(0, 0, 0, 0.12)";
+    readonly shadowInset: "inset 0 2px 4px rgba(0, 0, 0, 0.04)";
+    readonly shadowBottom: "0 -2px 5px rgba(0, 0, 0, 0.2)";
+    readonly shadowDnd: "0 4px 12px rgba(0, 0, 0, 0.25)";
+    readonly shadowDndLg: "0 4px 12px rgba(0, 0, 0, 0.15), 0 8px 24px rgba(0, 0, 0, 0.2)";
+    readonly shadowDragSm: "0 2px 8px rgba(0, 0, 0, 0.2)";
+    readonly shadowSubtle: "0 2px 4px rgba(0, 0, 0, 0.15)";
+    readonly shadowRingWhite: "inset 0 0 0 2px rgba(255, 255, 255, 0.5)";
+    readonly transitionFast: "0.15s ease";
+    readonly transitionNormal: "0.3s ease";
+    readonly opacityGhost: "0.35";
+    readonly opacitySubtle: "0.4";
+    readonly opacityDisabled: "0.5";
+    readonly opacityMuted: "0.6";
+    readonly opacityOverlay: "0.7";
+    readonly opacityHover: "0.8";
+    readonly opacityHigh: "0.85";
+    readonly opacityNearOpaque: "0.9";
+    readonly sizeInputHeight: "27px";
+    readonly fontFamilyBase: "Verdana, Geneva, sans-serif";
+};
+declare const CAMEL_TO_CSS: {
+    readonly colorPrimary: "--spring-color-primary";
+    readonly colorPrimaryLight: "--spring-color-primary-light";
+    readonly colorPrimaryDark: "--spring-color-primary-dark";
+    readonly colorSecondaryDark: "--spring-color-secondary-dark";
+    readonly colorDanger: "--spring-color-danger";
+    readonly colorSuccess: "--spring-color-success";
+    readonly colorSuccessLight: "--spring-color-success-light";
+    readonly colorBg: "--spring-color-bg";
+    readonly colorBgLight: "--spring-color-bg-light";
+    readonly colorPanel: "--spring-color-panel";
+    readonly colorBorder: "--spring-color-border";
+    readonly colorActive: "--spring-color-active";
+    readonly colorDisabledBg: "--spring-color-disabled-bg";
+    readonly colorText: "--spring-color-text";
+    readonly colorTextMuted: "--spring-color-text-muted";
+    readonly colorTextDisabled: "--spring-color-text-disabled";
+    readonly colorTextSecondary: "--spring-color-text-secondary";
+    readonly colorPanelSecondary: "--spring-color-panel-secondary";
+    readonly colorPanelDashboard: "--spring-color-panel-dashboard";
+    readonly colorPanelDashboardSecondary: "--spring-color-panel-dashboard-secondary";
+    readonly colorPanelAlt: "--spring-color-panel-alt";
+    readonly colorChartBg: "--spring-color-chart-bg";
+    readonly colorDarkLightSecondary: "--spring-color-dark-light-secondary";
+    readonly fontSizeXxs: "--spring-font-size-xxs";
+    readonly fontSizeXs: "--spring-font-size-xs";
+    readonly fontSizeSm: "--spring-font-size-sm";
+    readonly fontSizeMd: "--spring-font-size-md";
+    readonly fontSizeLg: "--spring-font-size-lg";
+    readonly fontSizeXl: "--spring-font-size-xl";
+    readonly fontSize2xl: "--spring-font-size-2xl";
+    readonly radiusXs: "--spring-radius-xs";
+    readonly radiusSm: "--spring-radius-sm";
+    readonly radiusMd: "--spring-radius-md";
+    readonly radiusLg: "--spring-radius-lg";
+    readonly radiusXl: "--spring-radius-xl";
+    readonly radiusDialog: "--spring-radius-dialog";
+    readonly radiusPanel: "--spring-radius-panel";
+    readonly shadowXs: "--spring-shadow-xs";
+    readonly shadowSm: "--spring-shadow-sm";
+    readonly shadowMd: "--spring-shadow-md";
+    readonly shadowLg: "--spring-shadow-lg";
+    readonly shadowPopup: "--spring-shadow-popup";
+    readonly shadowNavbar: "--spring-shadow-navbar";
+    readonly shadowInset: "--spring-shadow-inset";
+    readonly shadowBottom: "--spring-shadow-bottom";
+    readonly shadowDnd: "--spring-shadow-dnd";
+    readonly shadowDndLg: "--spring-shadow-dnd-lg";
+    readonly shadowDragSm: "--spring-shadow-drag-sm";
+    readonly shadowSubtle: "--spring-shadow-subtle";
+    readonly shadowRingWhite: "--spring-shadow-ring-white";
+    readonly transitionFast: "--spring-transition-fast";
+    readonly transitionNormal: "--spring-transition-normal";
+    readonly opacityGhost: "--spring-opacity-ghost";
+    readonly opacitySubtle: "--spring-opacity-subtle";
+    readonly opacityDisabled: "--spring-opacity-disabled";
+    readonly opacityMuted: "--spring-opacity-muted";
+    readonly opacityOverlay: "--spring-opacity-overlay";
+    readonly opacityHover: "--spring-opacity-hover";
+    readonly opacityHigh: "--spring-opacity-high";
+    readonly opacityNearOpaque: "--spring-opacity-near-opaque";
+    readonly sizeInputHeight: "--spring-size-input-height";
+    readonly fontFamilyBase: "--spring-font-family-base";
+};
+/** Per-component theme tokens. Values can reference --spring-* variables. */
+interface SpringComponentTokens {
+    button?: {
+        borderRadius?: string;
+        paddingX?: string;
+        paddingY?: string;
+        fontSize?: string;
+        primaryBg?: string;
+        primaryColor?: string;
+        primaryHoverFilter?: string;
+        outlineBorderColor?: string;
+        ghostHoverBg?: string;
+        minWidth?: string;
+        /** Small size overrides */
+        smPaddingX?: string;
+        smPaddingY?: string;
+        smFontSize?: string;
+        smMinWidth?: string;
+        /** Large size overrides */
+        lgPaddingX?: string;
+        lgPaddingY?: string;
+        lgFontSize?: string;
+        lgMinWidth?: string;
+    };
+    list?: {
+        rowHeight?: string;
+        headerBg?: string;
+        headerColor?: string;
+        stripedBg?: string;
+        selectedBg?: string;
+        hoverBg?: string;
+        borderColor?: string;
+        fontSize?: string;
+    };
+    form?: {
+        fieldSpacing?: string;
+        labelColor?: string;
+        labelFontSize?: string;
+        inputHeight?: string;
+        inputBg?: string;
+        inputBorderColor?: string;
+        inputFocusBorderColor?: string;
+        inputFontSize?: string;
+        inputBorderRadius?: string;
+    };
+    dialog?: {
+        backdropColor?: string;
+        maxWidth?: string;
+        borderRadius?: string;
+        padding?: string;
+        shadowColor?: string;
+    };
+    page?: {
+        headerBg?: string;
+        headerBorderColor?: string;
+        navigationBg?: string;
+        navigationWidth?: string;
+        contentBg?: string;
+    };
+    panel?: {
+        bg?: string;
+        borderColor?: string;
+        borderRadius?: string;
+        padding?: string;
+    };
+}
+/**
+ * Default dark theme overrides.
+ * Only includes color tokens that change between light and dark modes.
+ * Non-color tokens (fonts, spacing, shadows) inherit from the light theme.
+ *
+ * @example
+ * ```ts
+ * // Generate dark mode CSS
+ * const css = themeToCSSDark(DEFAULT_DARK_THEME);
+ * // Produces @media (prefers-color-scheme: dark) { ... }
+ * // and [data-spring-theme="dark"] { ... }
+ * ```
+ */
+declare const DEFAULT_DARK_THEME: {
+    readonly colorPrimary: "#7c78d8";
+    readonly colorPrimaryLight: "#7c78d81f";
+    readonly colorPrimaryDark: "#9d9ae0";
+    readonly colorSecondaryDark: "#c8c6f0";
+    readonly colorDanger: "#ef4444";
+    readonly colorSuccess: "#22c55e";
+    readonly colorSuccessLight: "#1a3a2a";
+    readonly colorBg: "#1a1b2e";
+    readonly colorBgLight: "#222340";
+    readonly colorPanel: "#2a2b45";
+    readonly colorBorder: "#4a4b6a";
+    readonly colorActive: "#f59e0b";
+    readonly colorDisabledBg: "#3a3b55";
+    readonly colorText: "#e4e4f0";
+    readonly colorTextMuted: "#a0a0b8";
+    readonly colorTextDisabled: "#6a6a80";
+    readonly colorTextSecondary: "#f0f0ff";
+    readonly colorPanelSecondary: "#32334d";
+    readonly colorPanelDashboard: "#1e1f35";
+    readonly colorPanelDashboardSecondary: "#262742";
+    readonly colorPanelAlt: "#32334d";
+    readonly colorChartBg: "#1a1b2e";
+    readonly colorDarkLightSecondary: "#2e2f4a";
+    readonly shadowXs: "0 1px 2px rgba(0, 0, 0, 0.2)";
+    readonly shadowSm: "0 2px 6px rgba(0, 0, 0, 0.25)";
+    readonly shadowMd: "0 4px 12px rgba(0, 0, 0, 0.4)";
+    readonly shadowLg: "0 4px 16px rgba(0, 0, 0, 0.35)";
+    readonly shadowPopup: "0 12px 32px rgba(0, 0, 0, 0.5), 0 6px 12px rgba(0, 0, 0, 0.35)";
+    readonly shadowNavbar: "0 2px 8px rgba(0, 0, 0, 0.25), 0 4px 16px rgba(0, 0, 0, 0.3)";
+    readonly shadowInset: "inset 0 2px 4px rgba(0, 0, 0, 0.15)";
+    readonly shadowBottom: "0 -2px 5px rgba(0, 0, 0, 0.4)";
+    readonly shadowDnd: "0 4px 12px rgba(0, 0, 0, 0.5)";
+    readonly shadowDndLg: "0 4px 12px rgba(0, 0, 0, 0.35), 0 8px 24px rgba(0, 0, 0, 0.45)";
+    readonly shadowDragSm: "0 2px 8px rgba(0, 0, 0, 0.45)";
+    readonly shadowSubtle: "0 2px 4px rgba(0, 0, 0, 0.35)";
+    readonly shadowRingWhite: "inset 0 0 0 2px rgba(255, 255, 255, 0.3)";
+};
+declare function createTheme(overrides: Partial<SpringThemeVariables>): SpringThemeVariables;
+/**
+ * Read the resolved theme from the DOM (computed CSS variable values).
+ * Falls back to DEFAULT_THEME when running on the server or in tests.
+ */
+declare function getResolvedTheme(): SpringThemeVariables;
+declare function themeToCSS(theme: SpringThemeVariables, componentTokens?: SpringComponentTokens): string;
+/**
+ * Generate dark mode CSS. Uses [data-spring-theme="dark"] selector for programmatic toggling.
+ * Only includes variables that are explicitly set in the dark theme (partial overrides).
+ */
+declare function themeToCSSDark(darkOverrides: Partial<SpringThemeVariables>): string;
+declare function themeToCSSVariables(theme: SpringThemeVariables, componentTokens?: SpringComponentTokens): Record<string, string>;
+
+/**
+ * Framework configuration type definitions.
+ * Extracted into a standalone file with zero runtime imports to allow
+ * spring-instance.ts to reference FrameworkConfig without circular dependencies.
+ * @module framework-config-types
+ */
+
+interface DateFormatConfig {
+    date: string;
+    dateTime: string;
+    dateTimeSeconds: string;
+    time: string;
+}
+/** Supported layout variants for multi-layout architecture. */
+type LayoutVariant = "admin" | "website" | "minimal" | "custom";
+/** Configuration for a named layout. */
+interface LayoutConfig {
+    variant: LayoutVariant;
+    /** Navigation items for this layout. Falls back to navigation.items when not set. */
+    navigation?: NavigationMenuItem[];
+    /** Whether this layout requires authentication. Default: true for admin, false for others. */
+    requiresAuth?: boolean;
+    /** CSS class on the root layout element. */
+    className?: string;
+    /** Override logo for this layout. */
+    logo?: {
+        src: string;
+        alt: string;
+    };
+}
+/** A single navigation menu item for the main sidebar/navigation. */
+interface NavigationMenuItem {
+    /** Unique key identifying this menu item */
+    key: string;
+    /** Display label (can be a translation key) */
+    label: string;
+    /** Optional icon identifier (registered via ui/icons) */
+    icon?: string;
+    /** Route path this menu item navigates to */
+    route: string;
+    /** Nested child menu items (for hierarchical navigation) */
+    children?: NavigationMenuItem[];
+    /** Permission keys required to see this menu item */
+    permissions?: string[];
+    /** Capability key — item is hidden when the capability is disabled */
+    capability?: keyof CapabilityMap;
+}
+interface FrameworkConfig {
+    app: {
+        name: string;
+        defaultRoute: string;
+        htmlLang: string;
+        skipLinkText: string;
+        supportEmail: string;
+        logo: {
+            src: string;
+            alt: string;
+        };
+    };
+    auth: {
+        sessionCookiePrefix: string;
+        publicAuthPaths: readonly string[];
+        sessionExpiredCodes: readonly string[];
+        loginFormFieldPrefix: string;
+        /** Allows storing access token in JavaScript memory (default: true). Set false to enforce cookie-only auth. */
+        allowInMemoryTokenStorage?: boolean;
+        /** API path for login endpoint (default: "auth/login") */
+        loginPath?: string;
+        /** API path for logout endpoint (default: "auth/logout") */
+        logoutPath?: string;
+        /** API path for user info endpoint (default: "auth/info") */
+        infoPath?: string;
+        /** Field names in the login response JSON for token extraction */
+        tokenResponseFields?: {
+            accessToken: string;
+            refreshToken: string;
+        };
+        /** Field name for the username in the login request body (default: "username") */
+        loginUsernameField?: string;
+    };
+    proxy: {
+        corsAllowedHeaders: string;
+        maxProxyPathLength: number;
+        safeHashPattern: RegExp;
+        /** Path prefixes to block in production (return 404). Example: ["/test/", "/internal/"] */
+        blockedPathPrefixesInProd?: string[];
+    };
+    csp: {
+        thirdPartyScriptSources: readonly string[];
+        thirdPartyConnectSources: readonly string[];
+        thirdPartyImageSources: readonly string[];
+        thirdPartyFrameSources: readonly string[];
+    };
+    i18n: {
+        languages: readonly CodeList[];
+        defaultLanguageCode: string;
+        numberLocale: string;
+        dayjsLocale: string;
+        dateFormats: DateFormatConfig;
+    };
+    theme: Partial<SpringThemeVariables>;
+    darkTheme: Partial<SpringThemeVariables>;
+    componentTokens: SpringComponentTokens;
+    limits: {
+        maxFileSize: number;
+        autocompleteDebounceMs: number;
+        /** Maximum number of simultaneously opened page tabs in UI navigation. Default: 10 */
+        maxOpenedTabs?: number;
+        signalrIdleTimeoutMs: number;
+        /** SignalR server timeout in milliseconds (default: 30000) */
+        signalrServerTimeoutMs: number;
+        /** SignalR keep-alive ping interval in milliseconds (default: 10000) */
+        signalrKeepAliveIntervalMs: number;
+        /** SignalR reconnect delay sequence in milliseconds (default: [0, 1000, 2000, 5000, 10000, 15000]) */
+        signalrReconnectDelaysMs: readonly number[];
+        /** Idle session timeout in milliseconds — triggers logout after inactivity (default: 1800000 = 30 min) */
+        idleSessionTimeoutMs: number;
+    };
+    api?: {
+        /** URL pattern for list endpoints. Use ${route} and ${id} placeholders. Default: "${route}/list" */
+        listUrlPattern?: string;
+        /** URL pattern for detail endpoints with metadata. Default: "${route}/${id}" */
+        detailWithMetaPattern?: string;
+        /** URL pattern for entity detail. Default: "${route}/${id}" */
+        detailUrlPattern?: string;
+        /** Date string sentinel treated as null (default: "0001-01-01T00:00:00") */
+        nullDateSentinel?: string;
+        /** HTTP request timeout in milliseconds (default: 30000) */
+        timeoutMs?: number;
+        /** Maximum number of automatic retries for failed idempotent requests (default: 2) */
+        retryMaxAttempts?: number;
+        /** Base delay in milliseconds before first retry, doubles for each subsequent attempt (default: 1000) */
+        retryBaseDelayMs?: number;
+        /** Maximum total time in milliseconds allowed for all retry attempts (default: 60000) */
+        retryMaxTotalMs?: number;
+        /** HTTP status codes that trigger an automatic retry (default: [502, 503, 429]) */
+        retryableStatusCodes?: number[];
+        /** Default page size for list requests (default: 20) */
+        defaultPageSize?: number;
+        /** When true, API client throws extracted errors by default unless requestInit.throwOnError overrides it. */
+        defaultThrowOnError?: boolean;
+        /**
+         * When true, searchGet() throws on unexpected payload shape (non-array and non-{data: array}).
+         * Default false preserves legacy behavior (warn + return []).
+         */
+        searchGetStrictShape?: boolean;
+        /** Optional request adapter — transforms list request data before sending to the backend. Simpler alternative to list:beforeLoad middleware. */
+        requestAdapter?: (data: Record<string, unknown>) => Record<string, unknown>;
+    };
+    navigation?: {
+        /** Menu items for the main navigation. If empty, no navigation is rendered. */
+        items?: NavigationMenuItem[];
+    };
+    /** Named layout configurations for multi-layout architecture. */
+    layouts?: Record<string, LayoutConfig>;
+}
+interface FrameworkConfigOverrides {
+    app?: Partial<FrameworkConfig["app"]>;
+    auth?: Partial<FrameworkConfig["auth"]>;
+    proxy?: Partial<FrameworkConfig["proxy"]>;
+    csp?: Partial<FrameworkConfig["csp"]>;
+    i18n?: Partial<Omit<FrameworkConfig["i18n"], "dateFormats">> & {
+        dateFormats?: Partial<DateFormatConfig>;
+    };
+    theme?: Partial<SpringThemeVariables>;
+    darkTheme?: Partial<SpringThemeVariables>;
+    componentTokens?: SpringComponentTokens;
+    limits?: Partial<FrameworkConfig["limits"]>;
+    api?: Partial<NonNullable<FrameworkConfig["api"]>>;
+    navigation?: Partial<NonNullable<FrameworkConfig["navigation"]>>;
+    layouts?: Record<string, Pick<LayoutConfig, "variant"> & Partial<Omit<LayoutConfig, "variant">>>;
+}
+
+export { CAMEL_TO_CSS as C, DEFAULT_DARK_THEME as D, type FrameworkConfigOverrides as F, type LayoutVariant as L, type NavigationMenuItem as N, type Operator as O, STORAGE_KEYS as S, type FrameworkConfig as a, type LayoutConfig as b, type CapabilityMap as c, type CodeList as d, type CodeListFullName as e, type CodeListNumber as f, DEFAULT_THEME as g, DIALOG_CONTENT_SELECTOR as h, DND_TOUCH_CONSTRAINT as i, type DateFormatConfig as j, type SpringComponentTokens as k, type SpringCssVariable as l, type SpringThemeVariables as m, type StorageKey as n, createTheme as o, emptyGuid as p, getResolvedTheme as q, themeToCSSDark as r, themeToCSSVariables as s, themeToCSS as t };

package/dist/i18n/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Built-in default messages for framework UI strings.
+ * These provide a working default so the framework operates out of the box
+ * without requiring a ContentAdapter for basic validation messages.
+ * Consumers can override via setContentAdapter() for full i18n.
+ * @module default-messages
+ */
+declare const DEFAULT_MESSAGES: {
+    readonly "admin-fill-value": "This field is required";
+    readonly "admin-invalid-phone-number-format": "Invalid phone number format";
+    readonly "admin-invalid-email-format": "Invalid email format";
+    readonly "admin-email-contains-multiple-addresses": "Field contains multiple email addresses";
+    readonly "admin-invalid-url-format": "Invalid URL format";
+    readonly "admin-password-min-length": "Password must be at least 8 characters";
+    readonly "admin-password-uppercase": "Password must contain an uppercase letter";
+    readonly "admin-password-lowercase": "Password must contain a lowercase letter";
+    readonly "admin-password-digit": "Password must contain a digit";
+    readonly "admin-password-special-char": "Password must contain a special character";
+    readonly "admin-yes": "Yes";
+    readonly "admin-no": "No";
+    readonly "admin-login-failed": "Login failed";
+    readonly "admin-session-expired": "Session expired. Please log in again.";
+    readonly "admin-fill-all-required-fields": "Please fill in all required fields";
+    readonly "admin-username": "Username";
+    readonly "admin-detail": "Detail";
+    readonly "admin-not-found": "Not found";
+    readonly "admin-unknown-error": "Unknown error";
+    readonly "admin-validation-error": "Validation error";
+    readonly "admin-sorted-ascending": "Sorted ascending";
+    readonly "admin-sorted-descending": "Sorted descending";
+    readonly "admin-sort-cleared": "Sort cleared";
+    readonly "admin-of": "of";
+    readonly "admin-rows-selected": "rows selected";
+    readonly "admin-tree": "Tree";
+};
+
+export { DEFAULT_MESSAGES };

package/dist/i18n/index.js

@@ -0,0 +1,7 @@
+import {
+  DEFAULT_MESSAGES
+} from "../chunk-N2L4TUC4.js";
+export {
+  DEFAULT_MESSAGES
+};
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { c as configureCapabilities, a as configureFramework, g as getCapabilities, b as getCapability, d as getFrameworkConfig, h as hasCapability } from './runtime-env-config-CajOEJCP.js';
+export { eventBus } from './events/index.js';
+export { g as getMiddlewareRunner, r as registerMiddleware } from './middleware-registry-DT002qRd.js';
+import './framework-config-types-DeUbx4bu.js';
+import './middleware-types-DVG9C1qJ.js';
+
+declare const SPRING_CORE_VERSION: string;
+
+export { SPRING_CORE_VERSION };

package/dist/index.js

@@ -0,0 +1,42 @@
+import "./chunk-SQB4F3EF.js";
+import {
+  eventBus
+} from "./chunk-OSSX443T.js";
+import {
+  getMiddlewareRunner,
+  registerMiddleware
+} from "./chunk-MEWPYTWC.js";
+import "./chunk-U5OH3GAI.js";
+import "./chunk-UDT2RPX2.js";
+import {
+  configureCapabilities,
+  getCapabilities,
+  getCapability,
+  hasCapability
+} from "./chunk-S7MKRNMI.js";
+import "./chunk-5D6XE7NJ.js";
+import {
+  configureFramework,
+  getFrameworkConfig
+} from "./chunk-F7WUQJH7.js";
+import "./chunk-S6RPCN5H.js";
+import "./chunk-RUCXSQEY.js";
+import "./chunk-KX32MU3I.js";
+import "./chunk-EFUBAQCV.js";
+import "./chunk-PT4DIYUK.js";
+
+// src/index.ts
+var SPRING_CORE_VERSION = true ? "0.8.0" : "0.0.0-dev";
+export {
+  SPRING_CORE_VERSION,
+  configureCapabilities,
+  configureFramework,
+  eventBus,
+  getCapabilities,
+  getCapability,
+  getFrameworkConfig,
+  getMiddlewareRunner,
+  hasCapability,
+  registerMiddleware
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @spring-systems/core\n// Core types, utilities, and configuration for Spring Systems SPRING.\n// Use sub-path imports for tree-shaking: @spring-systems/core/config, /utils, /types, etc.\n//\n// Convenience re-exports for the most commonly used APIs:\nexport {\n    configureCapabilities,\n    configureFramework,\n    getCapabilities,\n    getCapability,\n    getFrameworkConfig,\n    hasCapability,\n} from \"./config\";\nexport { eventBus } from \"./events/event-bus\";\nexport { getMiddlewareRunner, registerMiddleware } from \"./middleware\";\n\ndeclare const __VERSION__: string;\nexport const SPRING_CORE_VERSION: string = typeof __VERSION__ !== \"undefined\" ? __VERSION__ : \"0.0.0-dev\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBO,IAAM,sBAA8B,OAAqC,UAAc;","names":[]}