@custardui/custardui 2.0.0 → 2.0.1-beta.0

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

@@ -14,7 +14,7 @@ export declare class AdaptationManager {
      *
      * 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"
+     * e.g. baseUrl="/base", id="nus" → "/base/nus/nus.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

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

@@ -1 +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"}
+{"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;IAiEtF;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAqBtD;;;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/anchor/descriptor.d.ts

@@ -0,0 +1,6 @@
+import { type AnchorDescriptor } from './types';
+/**
+ * Creates an AnchorDescriptor for a given DOM element.
+ */
+export declare function createDescriptor(el: HTMLElement): AnchorDescriptor;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/types/src/lib/features/anchor/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/anchor/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,GAAG,gBAAgB,CAiClE"}

package/dist/types/src/lib/features/anchor/index.d.ts

@@ -0,0 +1,5 @@
+export type { AnchorDescriptor } from './types';
+export { createDescriptor } from './descriptor';
+export { serialize, deserialize } from './serializer';
+export { resolve } from './resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/lib/features/anchor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/anchor/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/src/lib/features/anchor/resolver.d.ts

@@ -0,0 +1,8 @@
+import { type AnchorDescriptor } from './types';
+/**
+ * Finds the best DOM element match(es) for a descriptor.
+ * Returns an array of elements. For specific descriptors, usually contains 0 or 1 element.
+ * For ID-only descriptors (tag='ANY'), may return multiple if duplicates exist.
+ */
+export declare function resolve(root: HTMLElement, descriptor: AnchorDescriptor): HTMLElement[];
+//# sourceMappingURL=resolver.d.ts.map

package/dist/types/src/lib/features/anchor/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/anchor/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAShD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,GAAG,WAAW,EAAE,CAoFtF"}

package/dist/types/src/lib/features/anchor/serializer.d.ts

@@ -0,0 +1,21 @@
+import { type AnchorDescriptor } from './types';
+/**
+ * Serializes a list of AnchorDescriptors into a URL-safe string.
+ */
+export declare function serialize(descriptors: AnchorDescriptor[]): string;
+/**
+ * Deserializes a URL-safe string back into a list of AnchorDescriptors.
+ */
+export declare function deserialize(encoded: string): AnchorDescriptor[];
+/**
+ * Parses a space-separated, plus-separated, or comma-separated list of IDs into a list of AnchorDescriptors.
+ * Supports:
+ *   "id"                        — ID only
+ *   "id:color"                  — with color
+ *   "id:color:corner"           — color + corner, no note
+ *   "id::corner"                — corner only, no color, no note
+ *   "id:color:corner:note"      — with color + annotation (note is percent-encoded)
+ *   "id::corner:note"           — annotation, no color
+ */
+export declare function parseIds(encoded: string): AnchorDescriptor[];
+//# sourceMappingURL=serializer.d.ts.map

package/dist/types/src/lib/features/anchor/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/anchor/serializer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAKhD;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAoDjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqD/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAsD5D"}

package/dist/types/src/lib/features/anchor/stable-text.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Generates a simple hash code for a string.
+ */
+export declare function hashCode(str: string): number;
+/**
+ * Matches raw (un-hydrated) placeholder tokens in text content, including
+ * escaped forms like \[[ name ]]:
+ *   [[ name ]], [[ name : fallback ]], [[ name ? truthy : falsy ]], \[[ name ]]
+ * Captures the placeholder name in group 1. Used to normalize tokens before hashing.
+ *
+ * The optional `(?:\\)?` prefix intentionally consumes the leading backslash so that
+ * \[[ name ]] normalizes to [[name]] — the same canonical form that PlaceholderBinder
+ * emits for escaped tokens ([[ name ]] literal text). This keeps the hash stable
+ * across raw and hydrated DOM states.
+ */
+export declare const RAW_PLACEHOLDER_RE: RegExp;
+/**
+ * Recursively walks `node`, appending stable placeholder-canonical text to `parts`.
+ * - Text nodes: raw [[ ... ]] tokens are normalized to [[name]] before appending.
+ * - <cv-placeholder> elements: appends [[name]] from the `name` attribute; skips children
+ *   (children hold the live resolved value, not the canonical template form).
+ * - All other elements: recurse into children.
+ */
+export declare function collectStableText(node: Node, parts: string[]): void;
+/**
+ * Returns the text content of an element with all <cv-placeholder> custom elements
+ * replaced by their canonical [[name]] template form.
+ *
+ * This produces a stable string regardless of the placeholder's current resolved value
+ * or whether it has been hydrated yet — enabling consistent hashing across share and load time.
+ *
+ * Without this, an element containing [[username]] resolved to "alice" would hash as
+ * "Hello alice!" at share-time but "Hello [[username]]!" at load-time, causing resolution to fail.
+ */
+export declare function getStableTextContent(el: HTMLElement): string;
+/**
+ * Combines getStableTextContent and normalizeText into a single call.
+ * Used wherever element text is computed for hashing or comparison.
+ */
+export declare function getStableNormalizedText(el: HTMLElement): string;
+//# sourceMappingURL=stable-text.d.ts.map

package/dist/types/src/lib/features/anchor/stable-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-text.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/anchor/stable-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS5C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,QAA8C,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAcnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAsB5D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAE/D"}

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

@@ -0,0 +1,17 @@
+import { type HighlightColorKey } from '$features/highlight/services/highlight-colors';
+import { type AnnotationCorner } from '$features/highlight/services/highlight-annotations';
+/**
+ * Descriptor for an anchor that represents a DOM element.
+ */
+export interface AnchorDescriptor {
+    tag: string;
+    index: number;
+    parentId?: string;
+    textSnippet: string;
+    textHash: number;
+    elementId?: string;
+    color?: HighlightColorKey;
+    annotation?: string;
+    annotationCorner?: AnnotationCorner;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/features/anchor/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC"}

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

@@ -1 +1 @@
-{"version":3,"file":"highlight-colors.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/highlight/services/highlight-colors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;EAMnB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;AAC9E,eAAO,MAAM,iBAAiB,EAAE,iBAA4B,CAAC"}
+{"version":3,"file":"highlight-colors.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/highlight/services/highlight-colors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;EAMnB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;AAC9E,eAAO,MAAM,iBAAiB,EAAE,iBAAyB,CAAC"}

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

@@ -15,7 +15,7 @@ export declare class HighlightService {
     private onWindowResize;
     constructor(rootEl: HTMLElement);
     resolveTargets(encodedDescriptors: string): HTMLElement[];
-    apply(encodedDescriptors: string): void;
+    applyEncodedHighlights(encodedDescriptors: string): void;
     exit(): void;
     private renderHighlightOverlay;
     private scrollToTarget;

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,KAAK,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAuDvC,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,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"}

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

@@ -1 +1 @@
-{"version":3,"file":"share-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/share/stores/share-store.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,KAAK,gBAAgB,EAAyB,MAAM,oDAAoD,CAAC;AAalH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AAE1D,qBAAa,UAAU;IACrB,QAAQ,UAAiB;IACzB,aAAa,gBAAiC;IAC9C,gBAAgB,yBAAgE;IAChF,kBAAkB,qBAAoC;IACtD,eAAe,4CAAmD;IAClE,oBAAoB;cAAsC,MAAM;gBAAU,gBAAgB;OAAM;IAEhG,UAAU,SAAwC;IAElD,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO;IAuB7B,gBAAgB,CAAC,IAAI,EAAE,aAAa;IAgBpC,eAAe;IASf,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAczC,sBAAsB,CAAC,EAAE,EAAE,WAAW;IA0BtC,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE;IAO9C,kBAAkB;IAOlB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB;IAYrE,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB;IAI3D,qBAAqB,CAAC,KAAK,EAAE,iBAAiB;IAM9C,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,qBAAqB;IAI7B,YAAY;IA0CZ,WAAW;IA0BX,OAAO,CAAC,iBAAiB;CAe1B;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}
+{"version":3,"file":"share-store.svelte.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/features/share/stores/share-store.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,KAAK,gBAAgB,EAAoD,MAAM,oDAAoD,CAAC;AAa7I,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AAE1D,qBAAa,UAAU;IACrB,QAAQ,UAAiB;IACzB,aAAa,gBAAsC;IACnD,gBAAgB,yBAAgE;IAChF,kBAAkB,qBAAoC;IACtD,eAAe,4CAAmD;IAClE,oBAAoB;cAAsC,MAAM;gBAAU,gBAAgB;OAAM;IAEhG,UAAU,SAAwC;IAElD,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO;IAuB7B,gBAAgB,CAAC,IAAI,EAAE,aAAa;IAgBpC,eAAe;IASf,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAczC,sBAAsB,CAAC,EAAE,EAAE,WAAW;IA0BtC,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE;IAO9C,kBAAkB;IAOlB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB;IAgBrE,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB;IAI3D,qBAAqB,CAAC,KAAK,EAAE,iBAAiB;IAM9C,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,qBAAqB;IAI7B,YAAY;IA0CZ,WAAW;IA0BX,OAAO,CAAC,iBAAiB;CAe1B;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

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

@@ -18,7 +18,7 @@ export declare class ActiveStateStore {
     configSectionOrder: ("toggles" | "tabGroups" | "placeholders")[];
     /**
      * Mutable application state representing user choices.
-     * Use actions like `setPinnedTab` or `setToggles` to modify this.
+     * Use actions like `setMarkedTab` or `setToggles` to modify this.
      */
     state: State;
     constructor(initialConfig?: Config);
@@ -27,12 +27,12 @@ export declare class ActiveStateStore {
      */
     init(config: Config): void;
     /**
-     * Set the pinned tab for a specific tab group.
+     * Set the marked tab for a specific tab group.
      * This syncs across all tab groups with the same ID.
      * @param groupId The ID of the tab group.
-     * @param tabId The ID of the tab to pin.
+     * @param tabId The ID of the tab to mark.
      */
-    setPinnedTab(groupId: string, tabId: string): void;
+    setMarkedTab(groupId: string, tabId: string): void;
     /**
      * Update the visibility of toggles.
      * @param shown List of IDs for toggles in "Show" state.

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;IAqDnC;;;;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,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"}

package/dist/types/src/lib/utils/scroll-utils.d.ts

@@ -1,21 +1,53 @@
+/**
+ * A captured scroll anchor — a snapshot of an element's viewport position before
+ * a layout-shifting operation. Pass to `restoreScrollAnchor` afterwards to compensate.
+ */
+export interface ScrollAnchor {
+    element: HTMLElement;
+    /** The element's `getBoundingClientRect().top` at capture time. */
+    top: number;
+}
+/**
+ * Captures the current viewport-relative position of a given element.
+ * Call this *before* a layout-shifting operation, then pass the result to `restoreScrollAnchor`.
+ *
+ * @param element The element to anchor to.
+ * @returns A `ScrollAnchor` snapshot.
+ */
+export declare function captureScrollAnchor(element: HTMLElement): ScrollAnchor;
 /**
  * Calculates the total height of fixed or sticky elements at the top of the viewport.
- * This includes the standard site header and any custom elements marked with [data-cv-scroll-offset].
- * Used to offset scroll positions so content isn't hidden behind these fixed elements.
+ * This includes the standard site header and any custom elements marked with
+ * `[data-cv-scroll-offset]`. Used to offset scroll positions so content isn't
+ * hidden behind these fixed elements.
  */
 export declare function getScrollTopOffset(): number;
 /**
- * Finds the highest element matching the selector that is currently in the viewport.
- * @param selector The CSS selector to match elements against.
- * @returns The HTMLElement of the highest visible element, or null if none are found.
+ * Returns the highest element matching a CSS selector that is visible in the
+ * current viewport (below any fixed/sticky header).
+ *
+ * @param selector CSS selector to match elements.
+ * @returns The highest visible matching element, or `null` if none found.
  */
 export declare function findHighestVisibleElement(selector: string): HTMLElement | null;
+/** Function signature for requestAnimationFrame-like schedulers. */
+export type FrameScheduler = (callback: FrameRequestCallback) => number;
 /**
- * Adjusts the scroll position to keep a specific element in the same visual location.
- * Useful when content additions/removals above might cause jumps.
+ * Allows tests to override the frame scheduler used by `restoreScrollAnchor`.
+ * Pass `null` to reset to the default implementation.
  */
-export declare function handleScrollAnchor(scrollAnchor: {
-    element: HTMLElement;
-    top: number;
-}): void;
+export declare function setFrameScheduler(scheduler: FrameScheduler | null): void;
+/**
+ * Restores the visual scroll position after a layout-shifting operation.
+ *
+ * Pass a `ScrollAnchor` captured *before* the layout change.
+ * Uses two `requestAnimationFrame` ticks to ensure the browser has fully
+ * reflowed the page before measuring and correcting.
+ *
+ * Note: When calling from a Svelte component, prefer using `tick()` before
+ * calling this function so Svelte's DOM updates are applied first.
+ *
+ * @param anchor A `ScrollAnchor` captured before the layout change.
+ */
+export declare function restoreScrollAnchor(anchor: ScrollAnchor): void;
 //# sourceMappingURL=scroll-utils.d.ts.map

package/dist/types/src/lib/utils/scroll-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-utils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/scroll-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA0B3C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAmC9E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB5F"}
+{"version":3,"file":"scroll-utils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/scroll-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAoB3C;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuB9E;AAED,oEAAoE;AACpE,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,oBAAoB,KAAK,MAAM,CAAC;AAmBxE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAExE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAc9D"}

package/dist/types/tests/lib/features/anchor/anchor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=anchor.test.d.ts.map

package/dist/types/tests/lib/features/anchor/anchor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.test.d.ts","sourceRoot":"","sources":["../../../../../../tests/lib/features/anchor/anchor.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@custardui/custardui",
-  "version": "2.0.0",
+  "version": "2.0.1-beta.0",
   "description": "A JavaScript dynamic custom views Library.",
   "type": "module",
   "main": "dist/custardui.min.js",
@@ -26,7 +26,7 @@
     "bump:patch": "npm version patch",
     "bump:minor": "npm version minor",
     "bump:major": "npm version major",
-    "deploydocs:stable": "cd docs && markbind deploy -s stable-site.json",
+    "deploydocs:prod": "cd docs && markbind deploy -s prod-site.json",
     "deploydocs": "cd docs && markbind deploy -s site.json",
     "dev": "rollup -c -w",
     "watch": "rollup -c -w",

package/dist/types/src/lib/utils/dom-element-locator.d.ts

@@ -1,35 +0,0 @@
-import { type HighlightColorKey } from '$features/highlight/services/highlight-colors';
-import { type AnnotationCorner } from '$features/highlight/services/highlight-annotations';
-/**
- * Descriptor for an anchor that represents a DOM element.
- */
-export interface AnchorDescriptor {
-    tag: string;
-    index: number;
-    parentId?: string;
-    textSnippet: string;
-    textHash: number;
-    elementId?: string;
-    color?: HighlightColorKey;
-    annotation?: string;
-    annotationCorner?: AnnotationCorner;
-}
-/**
- * Creates an AnchorDescriptor for a given DOM element.
- */
-export declare function createDescriptor(el: HTMLElement): AnchorDescriptor;
-/**
- * Serializes a list of AnchorDescriptors into a URL-safe string.
- */
-export declare function serialize(descriptors: AnchorDescriptor[]): string;
-/**
- * Deserializes a URL-safe string back into a list of AnchorDescriptors.
- */
-export declare function deserialize(encoded: string): AnchorDescriptor[];
-/**
- * Finds the best DOM element match(es) for a descriptor.
- * Returns an array of elements. For specific descriptors, usually contains 0 or 1 element.
- * For ID-only descriptors (tag='ANY'), may return multiple if duplicates exist.
- */
-export declare function resolve(root: HTMLElement, descriptor: AnchorDescriptor): HTMLElement[];
-//# sourceMappingURL=dom-element-locator.d.ts.map

package/dist/types/src/lib/utils/dom-element-locator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom-element-locator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/dom-element-locator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAuC,MAAM,+CAA+C,CAAC;AAC5H,OAAO,EAAE,KAAK,gBAAgB,EAAiD,MAAM,oDAAoD,CAAC;AAE1I;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAuBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,GAAG,gBAAgB,CAkClE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAiDjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmD/D;AAsED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,GAAG,WAAW,EAAE,CA+EtF"}

package/dist/types/tests/lib/utils/dom-element-locator.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=dom-element-locator.test.d.ts.map

package/dist/types/tests/lib/utils/dom-element-locator.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom-element-locator.test.d.ts","sourceRoot":"","sources":["../../../../../tests/lib/utils/dom-element-locator.test.ts"],"names":[],"mappings":""}