@custardui/custardui 2.1.0 → 2.1.2-beta.0

package/dist/types/src/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser.ts"],"names":[],"mappings":"AAOA,OAAO,eAAe,CAAC;AAKvB;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAsE3C"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser.ts"],"names":[],"mappings":"AAIA,OAAO,eAAe,CAAC;AAKvB;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAoD3C"}

package/dist/types/src/lib/features/adaptation/types.d.ts

@@ -5,9 +5,14 @@ export interface AdaptationConfig {
         cssVariables?: Record<string, string>;
         cssFile?: string;
     };
-    defaults?: {
+    preset?: {
         toggles?: Record<string, 'show' | 'hide' | 'peek'>;
+        tabs?: Record<string, string>;
         placeholders?: Record<string, string>;
+        labels?: Record<string, {
+            value?: string;
+            color?: string;
+        }>;
     };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types/src/lib/features/adaptation/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/adaptation/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;QACnD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/adaptation/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7D,CAAC;CACH"}

package/dist/types/src/lib/features/focus/services/focus-service.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focus-service.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/focus/services/focus-service.svelte.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,qBAAa,YAAY;IAUrB,OAAO,CAAC,MAAM;IAThB,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAmB;gBAGjC,MAAM,EAAE,WAAW,EAC3B,OAAO,EAAE,mBAAmB;IAiC9B;;OAEG;IACH,OAAO,CAAC,cAAc,CAEpB;IAEF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgDzB;;;OAGG;IACI,aAAa,CAAC,kBAAkB,EAAE,MAAM,EAAE,WAAW,GAAE,WAAW,EAAO,GAAG,IAAI;IAyChF,aAAa,CAAC,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAE,WAAW,EAAO,GAAG,IAAI;IA0CnF,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAU3D,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAC,0BAA0B;IAYlC,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,aAAa;IAwBd,YAAY,CAAC,SAAS,UAAO,GAAG,IAAI;IA6CpC,OAAO;CAKf"}
+{"version":3,"file":"focus-service.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/focus/services/focus-service.svelte.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,qBAAa,YAAY;IAUrB,OAAO,CAAC,MAAM;IAThB,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAmB;gBAGjC,MAAM,EAAE,WAAW,EAC3B,OAAO,EAAE,mBAAmB;IAiC9B;;OAEG;IACH,OAAO,CAAC,cAAc,CAEpB;IAEF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgDzB;;;OAGG;IACI,aAAa,CAAC,kBAAkB,EAAE,MAAM,EAAE,WAAW,GAAE,WAAW,EAAO,GAAG,IAAI;IAyChF,aAAa,CAAC,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAE,WAAW,EAAO,GAAG,IAAI;IA0CnF,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAU3D,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAC,0BAA0B;IAYlC,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,aAAa;IAwBd,YAAY,CAAC,SAAS,UAAO,GAAG,IAAI;IA6CpC,OAAO;CAKf"}

package/dist/types/src/lib/features/highlight/services/highlight-service.svelte.d.ts

@@ -1,4 +1,3 @@
-export declare const HIGHLIGHT_PARAM = "cv-highlight";
 export declare const BODY_HIGHLIGHT_CLASS = "cv-highlight-mode";
 import { type RectData } from './highlight-types';
 export declare class HighlightState {

package/dist/types/src/lib/features/highlight/services/highlight-service.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"highlight-service.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/highlight/services/highlight-service.svelte.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAGxD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,qBAAa,cAAc;IACzB,KAAK,aAA0B;CAChC;AAED,qBAAa,gBAAgB;IASf,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAkD;IACtE,OAAO,CAAC,iBAAiB,CAA2E;IACpG,OAAO,CAAC,cAAc,CAAgC;gBAElC,MAAM,EAAE,WAAW;IAMhC,cAAc,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,EAAE;IAWzD,sBAAsB,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IA0DxD,IAAI,IAAI,IAAI;IAkBnB,OAAO,CAAC,sBAAsB;YAwBhB,cAAc;IAiC5B,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,eAAe;CAqBxB"}
+{"version":3,"file":"highlight-service.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/highlight/services/highlight-service.svelte.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAGxD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,qBAAa,cAAc;IACzB,KAAK,aAA0B;CAChC;AAED,qBAAa,gBAAgB;IASf,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAkD;IACtE,OAAO,CAAC,iBAAiB,CAA2E;IACpG,OAAO,CAAC,cAAc,CAAgC;gBAElC,MAAM,EAAE,WAAW;IAMhC,cAAc,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,EAAE;IAWzD,sBAAsB,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IA0DxD,IAAI,IAAI,IAAI;IAkBnB,OAAO,CAAC,sBAAsB;YAwBhB,cAAc;IAiC5B,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,eAAe;CAqBxB"}

package/dist/types/src/lib/features/labels/label-manager.d.ts

@@ -0,0 +1,19 @@
+import type { Config } from '$lib/types/index';
+/**
+ * Manages registration and adaptation overrides for label definitions.
+ */
+export declare const labelManager: {
+    /**
+     * Registers all labels from the config into the label registry store.
+     */
+    registerConfigLabels(config: Config): void;
+    /**
+     * Applies adaptation preset overrides to registered labels.
+     * Unknown label names produce a warning and are skipped.
+     */
+    applyAdaptationOverrides(overrides: Record<string, {
+        value?: string;
+        color?: string;
+    }>): void;
+};
+//# sourceMappingURL=label-manager.d.ts.map

package/dist/types/src/lib/features/labels/label-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/labels/label-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;iCAC0B,MAAM,GAAG,IAAI;IAM1C;;;OAGG;wCACiC,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;CAK9F,CAAC"}

package/dist/types/src/lib/features/labels/label-registry-store.svelte.d.ts

@@ -0,0 +1,27 @@
+import type { LabelConfig } from './types';
+/**
+ * Registry store for label definitions.
+ * Tracks config-defined labels and adaptation overrides.
+ * Labels are config-level (not user state) — no persistence or URL encoding.
+ */
+export declare class LabelRegistryStore {
+    private _labels;
+    /**
+     * Registers a label definition. Overwrites any existing entry with the same name.
+     */
+    register(def: LabelConfig): void;
+    /**
+     * Merges overrides onto an existing label entry.
+     * Warns and skips if the label name is not registered.
+     */
+    override(name: string, overrides: {
+        value?: string;
+        color?: string;
+    }): void;
+    /**
+     * Returns the label definition for the given name, or undefined if not registered.
+     */
+    get(name: string): LabelConfig | undefined;
+}
+export declare const labelRegistryStore: LabelRegistryStore;
+//# sourceMappingURL=label-registry-store.svelte.d.ts.map

package/dist/types/src/lib/features/labels/label-registry-store.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-registry-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/labels/label-registry-store.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAwC;IAEvD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAIhC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAS3E;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG3C;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/types/src/lib/features/labels/label-utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves a color value, expanding single-letter shorthands to hex.
+ * Pass `isDark=true` to get the dark-theme variant of a shorthand.
+ * Non-shorthand values are returned unchanged.
+ */
+export declare function resolveColor(color: string, isDark: boolean): string;
+/**
+ * Computes a contrasting text color (black or white) for a given background color.
+ * Supports #rrggbb and #rgb hex strings. Falls back to white for non-hex inputs.
+ */
+export declare function computeTextColor(bgColor: string): string;
+//# sourceMappingURL=label-utils.d.ts.map

package/dist/types/src/lib/features/labels/label-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-utils.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/labels/label-utils.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAKnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBxD"}

package/dist/types/src/lib/features/labels/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration for a single label (inline decorative pill badge).
+ */
+export interface LabelConfig {
+    /** Unique identifier used in `<cv-label name="...">` */
+    name: string;
+    /** Display text — any string, including unicode/emoji (e.g. "OPTIONAL", "★ KEY"). If omitted, the element's inner content is used. */
+    value?: string;
+    /** CSS background color (hex or named). Text color is auto-computed for contrast. Defaults to #6b7280. */
+    color?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/src/lib/features/labels/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/labels/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,sIAAsI;IACtI,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/src/lib/features/placeholder/placeholder-manager.d.ts

@@ -34,7 +34,7 @@ export declare class PlaceholderManager {
     filterValidPlaceholders(placeholders?: Record<string, string>): Record<string, string>;
     /**
      * Filters a record of incoming placeholders to only those that can be set by users.
-     * Extends filterValidPlaceholders() by also excluding adaptation-only placeholders.
+     * Extends filterValidPlaceholders() by also excluding siteManaged placeholders.
      * Use this for persistence loads and URL delta application.
      */
     filterUserSettablePlaceholders(placeholders?: Record<string, string>): Record<string, string>;

package/dist/types/src/lib/features/placeholder/types.d.ts

@@ -11,11 +11,11 @@ export interface PlaceholderDefinition {
     /** If true, this placeholder is only shown in settings if detected on the page */
     isLocal?: boolean | undefined;
     /**
-     * If true, this placeholder can only be set by adaptations or the config defaultValue.
+     * If true, this placeholder can only be set by the site (via adaptations or the config defaultValue).
      * It is hidden from settings and immune to user persistence / URL overrides.
      * Implies hiddenFromSettings: true.
      */
-    adaptationPlaceholder?: boolean | undefined;
+    siteManaged?: boolean | undefined;
     /** Internal tracking of where this definition came from to detect conflicts */
     source?: 'config' | 'tabgroup' | undefined;
     /** The ID of the component (e.g. TabGroup groupId) that registered this placeholder */

package/dist/types/src/lib/features/placeholder/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/placeholder/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,+EAA+E;IAC/E,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/placeholder/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC"}

package/dist/types/src/lib/features/settings/intro-manager.svelte.d.ts

@@ -18,9 +18,9 @@ export declare class IntroManager {
     constructor(persistence: PersistenceManager, options: UIManagerOptions['callout'] | (() => UIManagerOptions['callout']));
     /**
      * Initializes the manager. Should be called when the component is ready
-     * and we know there are elements on the page.
+     * and we know there are elements on the current page (toggles, tab groups, or placeholders).
      */
-    init(hasPageElements: boolean, settingsEnabled: boolean): void;
+    init(hasElementsOnCurrentPage: boolean, settingsEnabled: boolean): void;
     private checkAndShow;
     dismiss(): void;
 }

package/dist/types/src/lib/features/settings/intro-manager.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intro-manager.svelte.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/settings/intro-manager.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAEvB,WAAW,UAAiB;IAC5B,SAAS,UAAiB;IAE1B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,UAAU,CAAS;gBAGzB,WAAW,EAAE,kBAAkB,EAC/B,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAS5E;;;OAGG;IACI,IAAI,CAAC,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO;IAU9D,OAAO,CAAC,YAAY;IASb,OAAO;CAKf"}
+{"version":3,"file":"intro-manager.svelte.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/settings/intro-manager.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAEvB,WAAW,UAAiB;IAC5B,SAAS,UAAiB;IAE1B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,UAAU,CAAS;gBAGzB,WAAW,EAAE,kBAAkB,EAC/B,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAS5E;;;OAGG;IACI,IAAI,CAAC,wBAAwB,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO;IAUvE,OAAO,CAAC,YAAY;IASb,OAAO;CAKf"}

package/dist/types/src/lib/features/toggles/types.d.ts

@@ -12,5 +12,10 @@ export interface ToggleConfig {
     description?: string;
     /** Default state for this toggle: 'show', 'hide', or 'peek' */
     default?: 'show' | 'hide' | 'peek';
+    /**
+     * If true, this toggle's state is controlled by the site (via adaptations or config defaults).
+     * It will be hidden from the settings UI, excluded from shareable URLs, and immune to user persistence.
+     */
+    siteManaged?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types/src/lib/features/toggles/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/toggles/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/toggles/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/types/src/lib/features/url/url-constants.d.ts

@@ -0,0 +1,13 @@
+export declare const PARAM_SHOW_TOGGLE = "t-show";
+export declare const PARAM_PEEK_TOGGLE = "t-peek";
+export declare const PARAM_HIDE_TOGGLE = "t-hide";
+export declare const PARAM_TABS = "tabs";
+export declare const PARAM_PH = "ph";
+export declare const PARAM_CV_SHOW = "cv-show";
+export declare const PARAM_CV_HIDE = "cv-hide";
+export declare const PARAM_CV_HIGHLIGHT = "cv-highlight";
+/** Parameters owned by FocusService — never touched by URLStateManager */
+export declare const FOCUS_PARAMS: string[];
+/** Parameters owned by URLStateManager */
+export declare const MANAGED_PARAMS: string[];
+//# sourceMappingURL=url-constants.d.ts.map

package/dist/types/src/lib/features/url/url-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-constants.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/url/url-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,eAAO,MAAM,UAAU,SAAS,CAAC;AACjC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAE7B,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD,0EAA0E;AAC1E,eAAO,MAAM,YAAY,UAAqD,CAAC;AAC/E,0CAA0C;AAC1C,eAAO,MAAM,cAAc,UAAkF,CAAC"}

package/dist/types/src/lib/features/url/url-encoding-utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Encodes a list of IDs into a comma-separated query-safe string.
+ *
+ * Each ID is individually encoded with `encodeURIComponent` so that any commas
+ * or special characters *within* an ID are escaped (e.g. `%2C`).
+ */
+export declare function encodeList(items: string[]): string;
+/**
+ * Encodes key:value pairs into a comma-separated query-safe string.
+ *
+ * Keys and values are individually encoded so that the structural separators
+ * (`:` between key/value, `,` between pairs) remain unambiguous.
+ */
+export declare function encodePairs(obj: Record<string, string>): string;
+/**
+ * Extracts the raw (un-decoded) value of a query parameter from a search string.
+ *
+ * We avoid `URLSearchParams.get()` here because it decodes the entire value,
+ * converting our content-level `%2C` back into literal commas and making them
+ * indistinguishable from the structural commas that separate list items.
+ */
+export declare function getRawParam(search: string, paramName: string): string | null;
+/**
+ * Splits a raw query parameter value by structural commas and decodes each item.
+ *
+ * Because values were encoded with `encodeURIComponent` before joining with `,`,
+ * splitting on literal commas is safe — any commas inside values appear as `%2C`.
+ */
+export declare function splitAndDecode(search: string, paramName: string): string[];
+/**
+ * Parses `key:value` pairs from a raw comma-delimited list into a Record.
+ * Entries without a colon, or with empty keys, are silently dropped.
+ */
+export declare function decodePairs(search: string, paramName: string): Record<string, string>;
+//# sourceMappingURL=url-encoding-utils.d.ts.map

package/dist/types/src/lib/features/url/url-encoding-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-encoding-utils.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/url/url-encoding-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI/D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB1E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYrF"}

package/dist/types/src/lib/features/url/url-state-generator.d.ts

@@ -0,0 +1,17 @@
+import type { State } from '$lib/types/index';
+/**
+ * Builds the query string fragment for the managed URL parameters from a state object.
+ *
+ * We construct this string manually (instead of using `URLSearchParams.set()`)
+ * to avoid double-encoding. `URLSearchParams.set()` would encode our already-encoded
+ * values a second time (e.g. `%2C` → `%252C`), requiring a hacky decode step.
+ *
+ * By building the string directly, each value is encoded exactly once,
+ * and structural separators (`,` `:`) remain as literal characters in the URL.
+ */
+export declare function generateManagedQuery(state: State): string;
+/**
+ * Builds a full absolute URL string from the base URL and managed params.
+ */
+export declare function buildFullUrl(url: URL, managedQuery: string): string;
+//# sourceMappingURL=url-state-generator.d.ts.map

package/dist/types/src/lib/features/url/url-state-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-state-generator.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/url/url-state-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAoBzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAInE"}

package/dist/types/src/lib/features/url/url-state-manager.d.ts

@@ -1,20 +1,10 @@
-import type { State } from '$lib/types/index';
-/** Parameters owned by FocusService — never touched by URLStateManager */
-declare const FOCUS_PARAMS: string[];
-declare const MANAGED_PARAMS: string[];
-/**
- * Elements currently present and tracked on the page.
- */
-export interface PageElements {
-    toggles: Iterable<string>;
-    tabGroups: Iterable<string>;
-    placeholders: Iterable<string>;
-}
+import type { Config, State } from '$lib/types/index';
+import { type ElementsOnCurrentPage } from './url-state-shaper';
 /**
  * URL State Manager for CustardUI.
  * Handles encoding/decoding of view states as human-readable URL parameters.
  *
- * URL Schema:
+ * URL Schema (defined in url-constants.ts):
  *   ?t-show=A,B        — toggle IDs to explicitly show
  *   ?t-peek=C          — toggle IDs to explicitly peek
  *   ?t-hide=D          — toggle IDs to explicitly hide
@@ -41,21 +31,13 @@ export declare class URLStateManager {
      */
     static parseURL(): State | null;
     /**
-     * Generates a shareable URL that encodes the full current state.
-     *
-     * Encodes every toggle on the page explicitly (shown, peeked, or hidden)
-     * so the recipient sees the exact same view regardless of their local settings.
-     *
-     * Tab-group-derived placeholders are omitted from the URL — they are implied
-     * by the `?tabs=` parameter and will be re-derived by the recipient's store.
-     *
-     * Toggles, tabs, and placeholders NOT present on the current page are omitted,
-     * preventing cross-page state pollution.
+     * Generates a shareable URL that encodes the current state based on Config and State.
      *
      * @param currentState The full application state to encode.
-     * @param pageElements The active elements detected on the current page.
+     * @param config The application configuration.
+     * @param elementsOnCurrentPage The active elements detected on the current page.
      */
-    static generateShareableURL(currentState: State | null | undefined, pageElements?: PageElements): string;
+    static generateShareableURL(currentState: State | null | undefined, config: Config, elementsOnCurrentPage?: ElementsOnCurrentPage): string;
     /**
      * Clears all managed parameters from the current browser URL.
      * This is called after parsing so that shared configurations don't stick around in
@@ -63,5 +45,7 @@ export declare class URLStateManager {
      */
     static clearURL(): void;
 }
-export { FOCUS_PARAMS, MANAGED_PARAMS };
+export { FOCUS_PARAMS } from './url-constants';
+export { MANAGED_PARAMS } from './url-constants';
+export type { ElementsOnCurrentPage } from './url-state-shaper';
 //# sourceMappingURL=url-state-manager.d.ts.map

package/dist/types/src/lib/features/url/url-state-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-state-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/url/url-state-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAQ9C,0EAA0E;AAC1E,QAAA,MAAM,YAAY,UAAyC,CAAC;AAC5D,QAAA,MAAM,cAAc,UAAkF,CAAC;AAmLvG;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAChC;AA6ED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,eAAe;IAC1B;;;;OAIG;WACW,QAAQ,IAAI,KAAK,GAAG,IAAI;IAetC;;;;;;;;;;;;;;OAcG;WACW,oBAAoB,CAChC,YAAY,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,GAAE,YAA+D,GAC5E,MAAM;IAgBT;;;;OAIG;WACW,QAAQ,IAAI,IAAI;CAiB/B;AAGD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"url-state-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/url/url-state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAgC,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG9F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,eAAe;IAC1B;;;;OAIG;WACW,QAAQ,IAAI,KAAK,GAAG,IAAI;IAetC;;;;;;OAMG;WACW,oBAAoB,CAChC,YAAY,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EACtC,MAAM,EAAE,MAAM,EACd,qBAAqB,GAAE,qBAAwE,GAC9F,MAAM;IAgBT;;;;OAIG;WACW,QAAQ,IAAI,IAAI;CAiB/B;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types/src/lib/features/url/url-state-parser.d.ts

@@ -0,0 +1,17 @@
+import type { State } from '$lib/types/index';
+/**
+ * Parses toggle visibility state from the current URL search string.
+ * Returns partial state containing only the toggle fields that are present.
+ */
+export declare function parseTogglesFromURL(search: string): Pick<State, 'shownToggles' | 'peekToggles' | 'hiddenToggles'>;
+/**
+ * Parses tab group selections from the current URL search string.
+ * Returns partial state containing the `tabs` record, or empty object if absent.
+ */
+export declare function parseTabsFromURL(search: string): Pick<State, 'tabs'>;
+/**
+ * Parses placeholder values from the current URL search string.
+ * Returns partial state containing the `placeholders` record, or empty object if absent.
+ */
+export declare function parsePlaceholdersFromURL(search: string): Pick<State, 'placeholders'>;
+//# sourceMappingURL=url-state-parser.d.ts.map

package/dist/types/src/lib/features/url/url-state-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-state-parser.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/url/url-state-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,GAAG,eAAe,CAAC,CAajH;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAGpE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,CAGpF"}

package/dist/types/src/lib/features/url/url-state-shaper.d.ts

@@ -0,0 +1,49 @@
+import type { Config, State } from '$lib/types/index';
+/**
+ * Elements currently present and tracked on the page.
+ */
+export interface ElementsOnCurrentPage {
+    toggles: Iterable<string>;
+    tabGroups: Iterable<string>;
+    placeholders: Iterable<string>;
+}
+/**
+ * Strips placeholder entries that should not appear in shareable URLs:
+ * - Tab-group-derived placeholders (source: 'tabgroup') — implied by ?tabs=
+ * - Site-managed placeholders (siteManaged: true) — site-controlled, not shareable
+ */
+export declare function stripNonShareablePlaceholders(placeholders: Record<string, string>, config: Config): Record<string, string>;
+/**
+ * Filters the current toggle state (shown, peeked) and derives the explicit
+ * hidden list for the shareable URL.
+ */
+export declare function getShareableToggles(currentState: State, pageTogglesSet: Set<string>, config: Config): Pick<State, 'shownToggles' | 'peekToggles' | 'hiddenToggles'>;
+/**
+ * Filters the active tab selections for the shareable URL.
+ */
+export declare function getShareableTabs(currentState: State, pageTabGroupsSet: Set<string>, config: Config): Pick<State, 'tabs'>;
+/**
+ * Filters the custom placeholder values for the shareable URL.
+ */
+export declare function getShareablePlaceholders(currentState: State, pagePlaceholdersSet: Set<string>, config: Config): Pick<State, 'placeholders'>;
+/**
+ * Computes a shareable state object from the current state.
+ *
+ * Toggles, tabs, and placeholders marked as `isLocal: true` are only included
+ * if they are present on the current page.
+ *
+ * Global elements (not `isLocal`) are always included regardless of whether
+ * they are detected on the current page.
+ *
+ * Every toggle known to the page (or global) is explicitly encoded as shown,
+ * peeked, or hidden, so the recipient's view exactly matches the sender's
+ * regardless of their local settings.
+ *
+ * Tab-group-derived placeholders are omitted — the `?tabs=` param is their source of truth.
+ *
+ * @param currentState The current application state.
+ * @param elementsOnCurrentPage The active elements detected on the current page.
+ * @param config The application configuration.
+ */
+export declare function computeShareableSettingState(currentState: State, elementsOnCurrentPage: ElementsOnCurrentPage, config: Config): State;
+//# sourceMappingURL=url-state-shaper.d.ts.map

package/dist/types/src/lib/features/url/url-state-shaper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-state-shaper.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/url/url-state-shaper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAe1H;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,GAAG,eAAe,CAAC,CAoDnK;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAyBxH;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,CA0B3I;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,KAAK,EACnB,qBAAqB,EAAE,qBAAqB,EAC5C,MAAM,EAAE,MAAM,GACb,KAAK,CAUP"}

package/dist/types/src/lib/registry.d.ts

@@ -5,4 +5,5 @@ import '$features/tabs/components/TabHeader.svelte';
 import '$features/tabs/components/TabBody.svelte';
 import '$features/placeholder/Placeholder.svelte';
 import '$features/placeholder/PlaceholderInput.svelte';
+import '$features/labels/components/Label.svelte';
 //# sourceMappingURL=registry.d.ts.map

package/dist/types/src/lib/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/lib/registry.ts"],"names":[],"mappings":"AAAA,OAAO,4CAA4C,CAAC;AACpD,OAAO,sCAAsC,CAAC;AAC9C,OAAO,2CAA2C,CAAC;AACnD,OAAO,4CAA4C,CAAC;AACpD,OAAO,0CAA0C,CAAC;AAElD,OAAO,0CAA0C,CAAC;AAClD,OAAO,+CAA+C,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/lib/registry.ts"],"names":[],"mappings":"AAAA,OAAO,4CAA4C,CAAC;AACpD,OAAO,sCAAsC,CAAC;AAC9C,OAAO,2CAA2C,CAAC;AACnD,OAAO,4CAA4C,CAAC;AACpD,OAAO,0CAA0C,CAAC;AAElD,OAAO,0CAA0C,CAAC;AAClD,OAAO,+CAA+C,CAAC;AAEvD,OAAO,0CAA0C,CAAC"}

package/dist/types/src/lib/runtime.svelte.d.ts

@@ -1,10 +1,8 @@
 import type { ConfigFile } from '$lib/types/index';
-import type { AssetsManager } from '$features/render/assets';
 import type { AdaptationConfig } from '$features/adaptation/types';
 import { PersistenceManager } from './utils/persistence';
 import { IconSettingsStore } from '$features/settings/stores/icon-settings-store.svelte';
 export interface RuntimeOptions {
-    assetsManager: AssetsManager;
     configFile: ConfigFile;
     rootEl?: HTMLElement | undefined;
     storageKey?: string | undefined;
@@ -33,7 +31,7 @@ export declare class AppRuntime {
      * Resolves the starting application state by layering sources:
      *
      * 1. **Baseline**: `ActiveStateStore` initializes with defaults from the config file.
-     * 2. **Adaptation Defaults**: If an adaptation is active, its defaults are applied
+     * 2. **Adaptation Preset**: If an adaptation is active, its preset is applied
      *    on top of the config defaults (before persisted state, so user choices can win).
      * 3. **Persistence**: If local storage has a saved state, it replaces the baseline (`applyState`).
      * 4. **URL Overrides**: If the URL contains parameters (`?t-show=X`), these are applied

package/dist/types/src/lib/runtime.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AA4BzF,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IACrB,kBAAkB,EAAE,kBAAkB,CAAC;IAC9C,OAAO,CAAC,YAAY,CAAe;IAC5B,iBAAiB,EAAE,iBAAiB,CAAC;IAE5C,OAAO,CAAC,QAAQ,CAAC,CAAmB;IACpC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,YAAY,CAAC,CAAa;gBAEtB,GAAG,EAAE,cAAc;IAwB/B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAsBlB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;;;;OAKG;IACI,KAAK;IAQZ;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6BtB,cAAc;IAWd,OAAO;CAQf"}
+{"version":3,"file":"runtime.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AAwCzF,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IACrB,kBAAkB,EAAE,kBAAkB,CAAC;IAC9C,OAAO,CAAC,YAAY,CAAe;IAC5B,iBAAiB,EAAE,iBAAiB,CAAC;IAE5C,OAAO,CAAC,QAAQ,CAAC,CAAmB;IACpC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,YAAY,CAAC,CAAa;gBAEtB,GAAG,EAAE,cAAc;IAqB/B;;;OAGG;IACH,OAAO,CAAC,UAAU;IA8BlB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;;;;OAKG;IACI,KAAK;IAQZ;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6BtB,cAAc;IAWd,OAAO;CASf"}

package/dist/types/src/lib/stores/active-state-store.svelte.d.ts

@@ -81,12 +81,12 @@ export declare class ActiveStateStore {
      */
     applyDifferenceInState(deltaState: State): void;
     /**
-     * Applies adaptation defaults on top of the config defaults, before persisted state.
+     * Applies adaptation preset on top of the config defaults, before persisted state.
      * User choices applied later via applyState() will override these.
      *
-     * @param defaults The defaults section from the adaptation config
+     * @param preset The preset section from the adaptation config
      */
-    applyAdaptationDefaults(defaults: AdaptationConfig['defaults']): void;
+    applyAdaptationDefaults(preset: AdaptationConfig['preset']): void;
     /**
      * Resets the application state to the computed defaults.
      */
@@ -123,6 +123,11 @@ export declare class ActiveStateStore {
      * Explicit placeholder values override any tab-derived value (winning over syncPlaceholdersFromTabs).
      */
     private applyPlaceholdersDelta;
+    /**
+     * Removes toggle IDs belonging to siteManaged toggles.
+     * Used to prevent user-supplied state (URL, localStorage) from overriding site-controlled toggles.
+     */
+    private filterNonSiteManagedToggleIds;
     /**
      * Validates an incoming tab record against the configuration.
      * Drops any groupId that doesn't exist in `config.tabGroups`,

package/dist/types/src/lib/stores/active-state-store.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"active-state-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../src/lib/stores/active-state-store.svelte.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAoB,KAAK,EAAgB,MAAM,kBAAkB,CAAC;AAEtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,SAAsB;IAE5B;;OAEG;IACH,kBAAkB,+CAAkC;IAEpD;;;OAGG;IACH,KAAK,QAKF;gBAES,aAAa,GAAE,MAAW;IAQtC;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM;IAiBnB;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAU3C;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IAK1C;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAanE;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAOzC;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,QAAQ,EAAE,KAAK;IAqB1B;;;;;;;;;;;;;OAaG;IACH,sBAAsB,CAAC,UAAU,EAAE,KAAK;IAMxC;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,GAAG,IAAI;IAcrE;;OAEG;IACH,KAAK;IAKE,mBAAmB,IAAI,KAAK;IAuDnC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAwBtB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;CAwBjC;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}
+{"version":3,"file":"active-state-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../src/lib/stores/active-state-store.svelte.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAoB,KAAK,EAAgB,MAAM,kBAAkB,CAAC;AAEtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,SAAsB;IAE5B;;OAEG;IACH,kBAAkB,+CAAkC;IAEpD;;;OAGG;IACH,KAAK,QAKF;gBAES,aAAa,GAAE,MAAW;IAQtC;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM;IAiBnB;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAU3C;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IAK1C;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAanE;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAOzC;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,QAAQ,EAAE,KAAK;IAqB1B;;;;;;;;;;;;;OAaG;IACH,sBAAsB,CAAC,UAAU,EAAE,KAAK;IAMxC;;;;;OAKG;IACH,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,IAAI;IAoBjE;;OAEG;IACH,KAAK;IAKE,mBAAmB,IAAI,KAAK;IAuDnC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAwBtB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAOrC;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;CAwBjC;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/types/src/lib/stores/color-scheme-store.svelte.d.ts

@@ -0,0 +1,13 @@
+/**
+ * App-wide store for color scheme preference.
+ * Drives light/dark variant resolution for shorthand label colors and any other
+ * components that need to react to the site's color scheme setting.
+ */
+export declare class ColorSchemeStore {
+    #private;
+    isDark: boolean;
+    init(scheme?: 'light' | 'dark' | 'auto'): void;
+    destroy(): void;
+}
+export declare const colorSchemeStore: ColorSchemeStore;
+//# sourceMappingURL=color-scheme-store.svelte.d.ts.map

package/dist/types/src/lib/stores/color-scheme-store.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-scheme-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../src/lib/stores/color-scheme-store.svelte.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,gBAAgB;;IAC3B,MAAM,UAAiB;IAavB,IAAI,CAAC,MAAM,GAAE,OAAO,GAAG,MAAM,GAAG,MAAgB,GAAG,IAAI;IAyBvD,OAAO,IAAI,IAAI;CAGhB;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/types/src/lib/stores/derived-store.svelte.d.ts

@@ -1,17 +1,13 @@
-import type { AssetsManager } from '$features/render/assets';
 /**
  * Cross-cutting derived state that combines data from multiple sub-stores.
- * Holds only computed/derived values and assetsManager — no mutable application state.
+ * Holds only computed/derived values — no mutable application state.
  */
-declare class DerivedStateStore {
-    assetsManager: AssetsManager | undefined;
+export declare class DerivedStateStore {
     menuToggles: import("../types").ToggleConfig[];
     menuTabGroups: import("../types").TabGroupConfig[];
     hiddenToggleIds: string[];
     hasVisiblePlaceholders: boolean;
     hasMenuOptions: boolean;
-    setAssetsManager(manager: AssetsManager): void;
 }
 export declare const derivedStore: DerivedStateStore;
-export {};
 //# sourceMappingURL=derived-store.svelte.d.ts.map

package/dist/types/src/lib/stores/derived-store.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derived-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../src/lib/stores/derived-store.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK7D;;;GAGG;AACH,cAAM,iBAAiB;IACrB,aAAa,4BAAgD;IAI7D,WAAW,oCAKR;IAEH,aAAa,sCAKV;IAEH,eAAe,WAMZ;IAEH,sBAAsB,UAQnB;IAEH,cAAc,UAIZ;IAEF,gBAAgB,CAAC,OAAO,EAAE,aAAa;CAGxC;AAED,eAAO,MAAM,YAAY,mBAA0B,CAAC"}
+{"version":3,"file":"derived-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../src/lib/stores/derived-store.svelte.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,iBAAiB;IAG5B,WAAW,oCAKR;IAEH,aAAa,sCAKV;IAEH,eAAe,WAMZ;IAEH,sBAAsB,UAQnB;IAEH,cAAc,UAIZ;CAEH;AAED,eAAO,MAAM,YAAY,mBAA0B,CAAC"}

package/dist/types/src/lib/stores/element-store.svelte.d.ts

@@ -20,9 +20,9 @@ export declare class ElementStore {
      */
     detectedPlaceholders: SvelteSet<string>;
     /**
-     * Returns true if there are any active components (toggles or tab groups) actually present in the DOM.
+     * Returns true if there are any active components (toggles, tab groups, or placeholders) actually present in the DOM.
      */
-    hasPageElements: boolean;
+    hasElementsOnCurrentPage: boolean;
     /**
      * Registers a toggle as active on the current page.
      * @param id The ID of the toggle found in the DOM.

package/dist/types/src/lib/stores/element-store.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../src/lib/stores/element-store.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACH,eAAe,oBAA8C;IAE7D;;;OAGG;IACH,iBAAiB,oBAA8C;IAE/D;;;OAGG;IACH,oBAAoB,oBAA8C;IAElE;;OAEG;IACH,eAAe,UAA8E;IAI7F;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM;IAIzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM;IAI3B;;;OAGG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM;IAIhC;;;OAGG;IACH,aAAa;IAMb,yBAAyB;CAG1B;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}
+{"version":3,"file":"element-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../src/lib/stores/element-store.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACH,eAAe,oBAA8C;IAE7D;;;OAGG;IACH,iBAAiB,oBAA8C;IAE/D;;;OAGG;IACH,oBAAoB,oBAA8C;IAElE;;OAEG;IACH,wBAAwB,UAItB;IAIF;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM;IAIzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM;IAI3B;;;OAGG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM;IAIhC;;;OAGG;IACH,aAAa;IAMb,yBAAyB;CAG1B;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}