@custardui/custardui 1.0.0

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

@@ -0,0 +1,7 @@
+import '$lib/registry';
+/**
+ * Initialize CustardUI from script tag attributes and config file
+ * This runs automatically when the script is loaded.
+ */
+export declare function initializeFromScript(): void;
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/src/lib/app/ui-manager.d.ts

@@ -0,0 +1,55 @@
+import type { AppRuntime } from '../runtime.svelte';
+import type { ConfigFile } from '$lib/types/index';
+import type { WidgetSettings, WidgetCalloutConfig, WidgetIconConfig } from '$features/settings/types';
+/**
+ * Callbacks that the UI layer needs from the runtime.
+ * This keeps the UI decoupled from the AppRuntime class.
+ */
+export interface RuntimeCallbacks {
+    resetToDefault: () => void;
+    getIconPosition: () => number | null;
+    saveIconPosition: (offset: number) => void;
+    clearIconPosition: () => void;
+    isIntroSeen: () => boolean;
+    markIntroSeen: () => void;
+}
+export interface UIManagerOptions extends Omit<WidgetSettings, 'enabled'> {
+    /** Callbacks from the runtime for persistence and reset */
+    callbacks: RuntimeCallbacks;
+    /** Container element where the settings widget should be rendered */
+    container?: HTMLElement;
+    /** Whether the settings feature (icon/modal) is enabled */
+    settingsEnabled?: boolean;
+}
+export type ResolvedUIManagerOptions = Omit<UIManagerOptions, 'container' | 'panel' | 'callout' | 'icon'> & {
+    container: HTMLElement;
+    settingsEnabled: boolean;
+    theme: 'light' | 'dark';
+    callout: Required<Pick<WidgetCalloutConfig, 'show' | 'message' | 'enablePulse'>> & {
+        backgroundColor?: string | undefined;
+        textColor?: string | undefined;
+    };
+    icon: Required<Pick<WidgetIconConfig, 'position' | 'scale' | 'show'>> & {
+        color?: string | undefined;
+        backgroundColor?: string | undefined;
+        opacity?: number | undefined;
+    };
+};
+export declare class CustardUIManager {
+    private app;
+    private options;
+    constructor(options: UIManagerOptions);
+    /**
+     * Render the settings widget
+     */
+    render(): void;
+    /**
+     * Remove the settings widget from DOM
+     */
+    destroy(): void;
+}
+/**
+ * Initializes the UI manager (settings and share UI) using the provided config.
+ */
+export declare function initUIManager(runtime: AppRuntime, config: ConfigFile): CustardUIManager | undefined;
+//# sourceMappingURL=ui-manager.d.ts.map

package/dist/types/src/lib/app/ui-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-manager.d.ts","sourceRoot":"","sources":["../../../../../src/lib/app/ui-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEtG;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC;IACvE,2DAA2D;IAC3D,SAAS,EAAE,gBAAgB,CAAC;IAE5B,qEAAqE;IACrE,SAAS,CAAC,EAAE,WAAW,CAAC;IAExB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,gBAAgB,EAChB,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAC3C,GAAG;IACF,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC,GAAG;QACjF,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,CAAC;IACF,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG;QACtE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;CACH,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAyC;IACpD,OAAO,CAAC,OAAO,CAA2B;gBAE9B,OAAO,EAAE,gBAAgB;IAyBrC;;OAEG;IACI,MAAM,IAAI,IAAI;IAerB;;OAEG;IACI,OAAO,IAAI,IAAI;CAMvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,UAAU,GACjB,gBAAgB,GAAG,SAAS,CAmB9B"}

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

@@ -0,0 +1,54 @@
+import type { AdaptationConfig } from './types';
+/**
+ * Manages the lifecycle of site adaptations (multi-tenancy variants).
+ * Handles fetching, persisting, and applying adaptation configs.
+ */
+export declare class AdaptationManager {
+    private static readonly QUERY_PARAM;
+    private static readonly HASH_PREFIX;
+    /**
+     * Initializes adaptation from the URL parameter or localStorage.
+     * Must be called before AppRuntime is instantiated so that:
+     * - Theme CSS is injected early (FOUC prevention)
+     * - ?adapt= param is cleaned before URLStateManager.parseURL() runs
+     *
+     * Adaptation JSON files are resolved relative to the site's baseUrl:
+     *   `{baseUrl}/{id}/{id}.json`
+     * e.g. baseUrl="/customviews", id="ntu" → "/customviews/ntu/ntu.json"
+     *
+     * @param baseUrl The site's base URL (from data-base-url, default: '')
+     * @param storageKey The project's unique storageKey prefix to use for saving preferences
+     * @returns The loaded AdaptationConfig, or null if no adaptation is active
+     */
+    static init(baseUrl?: string, storageKey?: string): Promise<AdaptationConfig | null>;
+    /**
+     * Adds a visual indicator to the URL bar showing the active adaptation.
+     *
+     * - Hash free     → append `#/{id}` (clean, no query-string noise)
+     * - Hash occupied → set `?adapt={id}` so the indicator survives refreshes;
+     *                   init() re-reads and re-applies it each load, and
+     *                   rewriteUrlIndicator re-adds it, keeping it stable.
+     *
+     * Uses replaceState so history is not polluted.
+     *
+     * @param adaptationId The adaptation namespace/id
+     */
+    static rewriteUrlIndicator(adaptationId: string): void;
+    /**
+     * Injects CSS variables and/or a stylesheet link for the adaptation theme.
+     * Idempotent: will not add a second <link> tag for the same adaptation.
+     */
+    private static applyTheme;
+    private static clearStoredId;
+    private static hasHashAdaptationId;
+    private static getHashAdaptationId;
+    private static getHashUrlIndicator;
+    /**
+     * Meta tag is in the form <meta name="cv-adapt" content="{id}">
+     */
+    private static getMetaAdaptationId;
+    private static stripQueryParamFromUrl;
+    private static stripHashFromUrl;
+    private static loadAdaptationConfig;
+}
+//# sourceMappingURL=adaptation-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adaptation-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/adaptation/adaptation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAKhD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAW;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAE3C;;;;;;;;;;;;;OAaG;WACU,IAAI,CAAC,OAAO,SAAK,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA2DtF;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAiBtD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IA0BzB,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAIlC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAUlC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAIlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAIlC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAKrC,OAAO,CAAC,MAAM,CAAC,gBAAgB;mBAKV,oBAAoB;CA4C1C"}

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

@@ -0,0 +1,11 @@
+import type { AdaptationConfig } from '../types';
+declare class AdaptationStore {
+    activeConfig: AdaptationConfig | null;
+    /**
+     * Called from AppRuntime constructor after stores are initialized.
+     */
+    init(config: AdaptationConfig | null): void;
+}
+export declare const adaptationStore: AdaptationStore;
+export {};
+//# sourceMappingURL=adaptation-store.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adaptation-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/adaptation/stores/adaptation-store.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,cAAM,eAAe;IACnB,YAAY,0BAAyC;IAErD;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;CAG5C;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

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

@@ -0,0 +1,13 @@
+export interface AdaptationConfig {
+    id: string;
+    name?: string;
+    theme?: {
+        cssVariables?: Record<string, string>;
+        cssFile?: string;
+    };
+    defaults?: {
+        toggles?: Record<string, 'show' | 'hide' | 'peek'>;
+        placeholders?: Record<string, string>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/src/lib/features/focus/focus-logic.d.ts

@@ -0,0 +1,31 @@
+import { SvelteSet } from 'svelte/reactivity';
+/**
+ * Determines which siblings of the target path elements should be hidden.
+ *
+ * @param targets The list of elements that are focused (and their ancestors up to root).
+ * @param root The root element where focus mode applies (usually document.body or a main wrapper).
+ * @param isExcluded Callback to determine if an element should be excluded from hiding (e.g. fixed position elements, overlays).
+ */
+export declare function determineHiddenElements(targets: HTMLElement[], root: HTMLElement, isExcluded: (el: HTMLElement) => boolean): SvelteSet<HTMLElement>;
+export interface ExclusionOptions {
+    hiddenElements: Set<HTMLElement>;
+    excludedTags: Set<string>;
+    excludedIds: Set<string>;
+}
+/**
+ * Checks if an element should be excluded from hiding logic.
+ *
+ * TODO: Check how to commonize this between focus and share
+ */
+export declare function isElementExcluded(el: HTMLElement, options: ExclusionOptions): boolean;
+export interface DividerGroup {
+    insertBefore: HTMLElement | null;
+    startNode: HTMLElement;
+    count: number;
+}
+/**
+ * Scans a list of children and groups consecutive hidden elements.
+ * Returns a list of groups where dividers should be inserted.
+ */
+export declare function calculateDividerGroups(children: HTMLElement[], isHidden: (el: HTMLElement) => boolean): DividerGroup[];
+//# sourceMappingURL=focus-logic.d.ts.map

package/dist/types/src/lib/features/focus/focus-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-logic.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/focus/focus-logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,WAAW,EAAE,EACtB,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,GACvC,SAAS,CAAC,WAAW,CAAC,CAwDxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACjC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAiBrF;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,WAAW,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,GACrC,YAAY,EAAE,CAkChB"}

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

@@ -0,0 +1,37 @@
+import type { ShareExclusions } from '$features/share/types';
+export interface FocusServiceOptions {
+    shareExclusions?: ShareExclusions;
+}
+export declare class FocusService {
+    private rootEl;
+    private hiddenElements;
+    private dividers;
+    private excludedTags;
+    private excludedIds;
+    private unsubscribe;
+    private highlightService;
+    constructor(rootEl: HTMLElement, options: FocusServiceOptions);
+    /**
+     * Re-evaluate the URL when the browser's history changes
+     */
+    private handlePopState;
+    /**
+     * Reads the current URL and applies the appropriate focus/highlight mode
+     */
+    private applyModesFromUrl;
+    /**
+     * Applies focus mode to the specified descriptors.
+     * @param encodedDescriptors - The encoded descriptors to apply.
+     */
+    applyShowMode(encodedDescriptors: string): void;
+    applyHideMode(encodedDescriptors: string): void;
+    applyHighlightMode(encodedDescriptors: string): void;
+    private renderHiddenView;
+    private renderShowView;
+    private insertDividersForContainer;
+    private createDivider;
+    private expandContext;
+    exitShowMode(updateUrl?: boolean): void;
+    destroy(): void;
+}
+//# sourceMappingURL=focus-service.svelte.d.ts.map

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

@@ -0,0 +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;IAuBzB;;;OAGG;IACI,aAAa,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAwC/C,aAAa,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAoC/C,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/focus/stores/focus-store.svelte.d.ts

@@ -0,0 +1,14 @@
+export declare class FocusStore {
+    isActive: boolean;
+    /**
+     * Sets the active state of the focus mode.
+     */
+    setIsActive(isActive: boolean): void;
+    /**
+     * Signals intent to exit focus mode.
+     * Logic is handled by the service observing this state.
+     */
+    exit(): void;
+}
+export declare const focusStore: FocusStore;
+//# sourceMappingURL=focus-store.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focus-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/focus/stores/focus-store.svelte.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACrB,QAAQ,UAAiB;IAEzB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO;IAI7B;;;OAGG;IACH,IAAI;CAGL;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/types/src/lib/features/highlight/highlight-logic.d.ts

@@ -0,0 +1,29 @@
+import { SvelteMap } from 'svelte/reactivity';
+import { type RectData } from './services/highlight-types';
+/**
+ * Groups elements by their parent.
+ * Returns a Map where keys are parent elements and values are lists of child elements.
+ */
+export declare function groupSiblings(elements: HTMLElement[]): SvelteMap<HTMLElement, HTMLElement[]>;
+/**
+ * Interface representing basic rectangle properties needed for calculation.
+ */
+export interface SimpleRect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+/**
+ * Calculates merged rectangles for highlighting from groups of sibling elements.
+ *
+ * @param groups Map of parent elements to their child elements that need highlighting.
+ * @param getRect Callback to retrieve the bounding client rect of an element.
+ *                Abstracted to allow testing without real DOM/layout.
+ * @param getScroll Callback to retrieve current scroll position {scrollTop, scrollLeft}.
+ */
+export declare function calculateMergedRects(groups: SvelteMap<HTMLElement, HTMLElement[]>, getRect: (el: HTMLElement) => SimpleRect, getScroll: () => {
+    scrollTop: number;
+    scrollLeft: number;
+}): RectData[];
+//# sourceMappingURL=highlight-logic.d.ts.map

package/dist/types/src/lib/features/highlight/highlight-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight-logic.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/highlight/highlight-logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,CAY5F;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,EAC7C,OAAO,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,UAAU,EACxC,SAAS,EAAE,MAAM;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzD,QAAQ,EAAE,CAwCZ"}

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

@@ -0,0 +1,20 @@
+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 {
+    rects: RectData[];
+}
+export declare class HighlightService {
+    private rootEl;
+    private overlayApp;
+    private state;
+    private resizeObserver;
+    private activeTargets;
+    private onWindowResize;
+    constructor(rootEl: HTMLElement);
+    apply(encodedDescriptors: string): void;
+    exit(): void;
+    private renderHighlightOverlay;
+    private updatePositions;
+}
+//# sourceMappingURL=highlight-service.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"highlight-service.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/highlight/services/highlight-service.svelte.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAGxD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,qBAAa,cAAc;IACzB,KAAK,aAA0B;CAChC;AAED,qBAAa,gBAAgB;IAOf,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,cAAc,CAAgC;gBAElC,MAAM,EAAE,WAAW;IAMhC,KAAK,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAgDvC,IAAI,IAAI,IAAI;IAgBnB,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,eAAe;CAmBxB"}

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

@@ -0,0 +1,10 @@
+export type RectData = {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+    right: number;
+    bottom: number;
+    element: HTMLElement;
+};
+//# sourceMappingURL=highlight-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"highlight-types.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/highlight/services/highlight-types.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC"}

package/dist/types/src/lib/features/notifications/stores/toast-store.svelte.d.ts

@@ -0,0 +1,15 @@
+export declare const TOAST_CLASS = "cv-toast-notification";
+export interface ToastConfig {
+    message: string;
+    duration?: number;
+    id?: number;
+}
+export declare class ToastStore {
+    items: ToastConfig[];
+    nextId: number;
+    show(message: string, duration?: number): void;
+    dismiss(id: number): void;
+}
+export declare const toast: ToastStore;
+export declare function showToast(message: string, duration?: number): void;
+//# sourceMappingURL=toast-store.svelte.d.ts.map

package/dist/types/src/lib/features/notifications/stores/toast-store.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/notifications/stores/toast-store.svelte.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,0BAA0B,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,UAAU;IACrB,KAAK,gBAA6B;IAClC,MAAM,SAAK;IAEX,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAO;IAYrC,OAAO,CAAC,EAAE,EAAE,MAAM;CAGnB;AAED,eAAO,MAAM,KAAK,YAAmB,CAAC;AAEtC,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,QAE3D"}

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

@@ -0,0 +1,64 @@
+/**
+ * DOM Scanner for Variable Interpolation
+ *
+ * Scans the DOM for [[ variable_name ]] patterns and replaces them with
+ * reactive spans that update when the variable store changes.
+ */
+export declare const VAR_REGEX: RegExp;
+export declare class PlaceholderBinder {
+    /**
+     * Scans the root element for text nodes containing variable placeholders.
+     * Also scans for elements with .cv-bind or [data-cv-bind] to setup attribute bindings.
+     */
+    static scanAndHydrate(root: HTMLElement): void;
+    /**
+     * Updates attribute bindings for all elements participating in placeholder binding.
+     * Specifically updates attributes on elements with [data-cv-attr-templates].
+     * Text content is updated separately via <cv-placeholder> component reactivity.
+     */
+    static updateAll(values: Record<string, string>): void;
+    private static scanTextNodes;
+    private static scanAttributeBindings;
+    private static processTextNode;
+    private static processElementAttributes;
+    private static updateAttributeBindings;
+    /**
+     * Checks if a value is a full URL with protocol
+     * (e.g., http://, https://, ftp://, data:, mailto:)
+     */
+    private static isFullUrl;
+    /**
+     * Checks if a value is a relative URL path (e.g., /, ./, ../)
+     */
+    private static isRelativeUrl;
+    /**
+     * Resolves value for a placeholder by checking and using sources in order of:
+     * 1. user-set value, 2. registry default value, 3. inline fallback value
+     *
+     * Empty strings are treated as "not set" and will fall through to the next priority level.
+     *
+     * @param name - The placeholder name to resolve
+     * @param fallback - Optional inline fallback value from the usage syntax (e.g., `[[ name : fallback ]]`)
+     * @param values - Record of user-set placeholder values
+     * @returns The resolved value, or undefined if no value is available from any source
+     */
+    private static resolveValue;
+    /**
+     * Interpolates placeholder patterns in a template string with their resolved values.
+     *
+     * Replaces all `[[ name ]]` or `[[ name : fallback ]]` patterns with their resolved values.
+     * Escaped patterns (e.g., `\[[ name ]]`) are preserved as literal text.
+     *
+     * For `href` and `src` attributes, applies context-aware URL encoding:
+     * - Full URLs (http://, https://, mailto:, data:, etc.) are preserved as-is
+     * - Relative URLs (/, ./, ../) are preserved as-is
+     * - URL components (query parameters, path segments) are encoded with encodeURIComponent
+     *
+     * @param template - The template string containing placeholder patterns
+     * @param values - Record of user-set placeholder values
+     * @param attrName - Optional attribute name (enables URL encoding for 'href' and 'src')
+     * @returns The interpolated string with all placeholders replaced
+     */
+    private static interpolateString;
+}
+//# sourceMappingURL=placeholder-binder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-binder.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/placeholder/placeholder-binder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,SAAS,QAA0D,CAAC;AAOjF,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW;IAKvC;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ/C,OAAO,CAAC,MAAM,CAAC,aAAa;IA4B5B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAUpC,OAAO,CAAC,MAAM,CAAC,eAAe;IAiD9B,OAAO,CAAC,MAAM,CAAC,wBAAwB;IA2CvC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAqBtC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAMxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAqB3B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAsBjC"}

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

@@ -0,0 +1,38 @@
+import type { Config } from '$lib/types/index';
+export declare class PlaceholderManager {
+    /**
+     * Registers global placeholders defined in the configuration.
+     * Source is marked as 'config'.
+     */
+    registerConfigPlaceholders(config: Config): void;
+    /**
+     * Registers placeholders defined implicitly via Tab Groups.
+     * Source is marked as 'tabgroup'.
+     *
+     * Should be called AFTER registerConfigPlaceholders to ensure config precedence.
+     */
+    registerTabGroupPlaceholders(config: Config): void;
+    /**
+     * Calculates the placeholder value based on the active tab selection in a group.
+     *
+     * @param tabgroupId The ID of the tab group
+     * @param tabId The ID of the currently active tab
+     * @param config The full application configuration
+     * @returns An object containing the placeholder key and value, or null if nothing to update.
+     */
+    calculatePlaceholderFromTabSelected(tabgroupId: string, tabId: string, config: Config): {
+        key: string;
+        value: string;
+    } | null;
+    /**
+     * Filters a record of incoming placeholders to only those registered in the registry.
+     * Warns and skips unregistered keys to prevent arbitrary key injection.
+     *
+     * @param placeholders Raw key-value record to validate (e.g. from a URL delta or persistence).
+     * @returns A filtered record containing only registered placeholder keys.
+     */
+    filterValidPlaceholders(placeholders?: Record<string, string>): Record<string, string>;
+    private registerPlaceholderFromTabGroup;
+}
+export declare const placeholderManager: PlaceholderManager;
+//# sourceMappingURL=placeholder-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/placeholder/placeholder-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAE/D,qBAAa,kBAAkB;IAC7B;;;OAGG;IACH,0BAA0B,CAAC,MAAM,EAAE,MAAM;IAWzC;;;;;OAKG;IACH,4BAA4B,CAAC,MAAM,EAAE,MAAM;IAQ3C;;;;;;;OAOG;IACH,mCAAmC,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAe7H;;;;;;OAMG;IACH,uBAAuB,CAAC,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAe1F,OAAO,CAAC,+BAA+B;CAqCxC;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/types/src/lib/features/placeholder/stores/placeholder-registry-store.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { PlaceholderDefinition } from '../types';
+/**
+ * Registry store tracks existence and properties of placeholders,
+ * but not the values of the placeholders.
+ */
+export declare class PlaceholderRegistryStore {
+    private _definitions;
+    get definitions(): PlaceholderDefinition[];
+    register(def: PlaceholderDefinition): void;
+    get(name: string): PlaceholderDefinition | undefined;
+    has(name: string): boolean;
+    private updateExisting;
+    private addNew;
+    private hasChanged;
+}
+export declare const placeholderRegistryStore: PlaceholderRegistryStore;
+//# sourceMappingURL=placeholder-registry-store.svelte.d.ts.map

package/dist/types/src/lib/features/placeholder/stores/placeholder-registry-store.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-registry-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/placeholder/stores/placeholder-registry-store.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD;;;GAGG;AACH,qBAAa,wBAAwB;IAEnC,OAAO,CAAC,YAAY,CAAkD;IAGtE,IAAI,WAAW,IAAI,qBAAqB,EAAE,CAEzC;IAED,QAAQ,CAAC,GAAG,EAAE,qBAAqB;IAQnC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAIpD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,UAAU;CASnB;AAED,eAAO,MAAM,wBAAwB,0BAAiC,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Definition for a placeholder variable.
+ * Placeholders allow dynamic value substitution in the UI/Logic.
+ */
+export interface PlaceholderDefinition {
+    name: string;
+    settingsLabel?: string | undefined;
+    settingsHint?: string | undefined;
+    defaultValue?: string | undefined;
+    hiddenFromSettings?: boolean | undefined;
+    /** If true, this placeholder is only shown in settings if detected on the page */
+    isLocal?: 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 */
+    ownerTabGroupId?: string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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,+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/render/assets.d.ts

@@ -0,0 +1,12 @@
+import type { CustomViewAsset } from './types';
+export declare class AssetsManager {
+    assets: Record<string, CustomViewAsset>;
+    private baseURL;
+    constructor(assets: Record<string, CustomViewAsset>, baseURL?: string);
+    validate(): boolean;
+    get(assetId: string): CustomViewAsset | undefined;
+    private prependBaseURL;
+    loadFromJSON(json: Record<string, CustomViewAsset>): void;
+    loadAdditionalAssets(additionalAssets: Record<string, CustomViewAsset>): void;
+}
+//# sourceMappingURL=assets.d.ts.map

package/dist/types/src/lib/features/render/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/render/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,qBAAa,aAAa;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,GAAE,MAAW;IASzE,QAAQ,IAAI,OAAO;IAInB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAgBjD,OAAO,CAAC,cAAc;IAatB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAIlD,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;CAGvE"}

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

@@ -0,0 +1,3 @@
+import type { AssetsManager } from './assets';
+export declare function renderAssetInto(el: HTMLElement, assetId: string, assetsManager: AssetsManager): void;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/render/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAoE9C,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,QAoB7F"}

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

@@ -0,0 +1,19 @@
+/**
+ * Represents an individual asset that can be rendered in a custom view.
+ */
+export interface CustomViewAsset {
+    /** Optional type. If not provided, auto-detected from src/content. */
+    type?: 'image' | 'text' | 'html' | string;
+    /** Image source URL */
+    src?: string;
+    /** Alt text for images */
+    alt?: string;
+    /** Text or HTML content */
+    content?: string;
+    /** CSS class name(s) to apply */
+    className?: string;
+    /** Inline CSS styles to apply */
+    style?: string;
+    [key: string]: any;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/render/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,uBAAuB;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

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

@@ -0,0 +1,30 @@
+import type { UIManagerOptions } from '$lib/app/ui-manager';
+export interface IntroPersistence {
+    isIntroSeen: () => boolean;
+    markIntroSeen: () => void;
+}
+/**
+ * IntroManager
+ *
+ * Responsibilities:
+ * - Manages the visibility state of the introductory callout component.
+ * - Handles the logic for when to show the callout (delay, checks if already shown).
+ * - Manages the "pulse" effect state on the settings icon.
+ * - Persists the "shown" state to localStorage to prevent showing it repeatedly.
+ */
+export declare class IntroManager {
+    showCallout: boolean;
+    showPulse: boolean;
+    private persistence;
+    private getOptions;
+    private hasChecked;
+    constructor(persistence: IntroPersistence, 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.
+     */
+    init(hasPageElements: boolean, settingsEnabled: boolean): void;
+    private checkAndShow;
+    dismiss(): void;
+}
+//# sourceMappingURL=intro-manager.svelte.d.ts.map

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

@@ -0,0 +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,qBAAqB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAEvB,WAAW,UAAiB;IAC5B,SAAS,UAAiB;IAE1B,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,UAAU,CAAS;gBAGzB,WAAW,EAAE,gBAAgB,EAC7B,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"}