@customviews-js/customviews 1.4.1-beta.1 → 1.4.1-beta.3

package/dist/types/types/config.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Configuration for a single tab within a tab group
+ */
+export interface TabConfig {
+    /** Tab identifier */
+    tabId: string;
+    /** Display label for the tab */
+    label?: string;
+}
+/**
+ * Configuration for a tab group
+ */
+export interface TabGroupConfig {
+    /** Group identifier (stable across the page) */
+    groupId: string;
+    /** Display name for widget/nav */
+    label?: string;
+    /** Available tabs in this group */
+    tabs: TabConfig[];
+    /** Determines if the tab group is only shown on pages where it's used. */
+    isLocal?: boolean;
+    /** Optional description to display below label */
+    description?: string;
+    /** Default tab ID to select */
+    default?: string;
+}
+/**
+ * Configuration for a single toggle.
+ */
+export interface ToggleConfig {
+    /** Toggle identifier */
+    toggleId: string;
+    /** Display label for the toggle */
+    label?: string;
+    /** Determines if the toggle is only shown on pages where it's used. */
+    isLocal?: boolean;
+    /** Optional description to display below functionality */
+    description?: string;
+    /** Default state for this toggle: 'show', 'hide', or 'peek' */
+    default?: 'show' | 'hide' | 'peek';
+}
+/**
+ * Configuration for the site, has default state and list of toggles
+ */
+export interface ShareExclusions {
+    tags?: string[];
+    ids?: string[];
+}
+/**
+ * Configuration for the site, has default state and list of toggles
+ */
+export interface Config {
+    /** All available toggle categories */
+    toggles?: ToggleConfig[];
+    /** Optional tab group configurations */
+    tabGroups?: TabGroupConfig[];
+    /** Excluded tags and IDs for Share/Focus modes */
+    shareExclusions?: ShareExclusions;
+}
+/**
+ * Represents the configuration file structure for CustomViews auto-initialization.
+ */
+export interface ConfigFile {
+    /** Core configuration object with toggles and defaultState */
+    config?: Config;
+    /** Path to the assets JSON file */
+    assetsJsonPath?: string;
+    /** Base URL for all paths */
+    baseUrl?: string;
+    /** Whether to keep the `view` state parameter visible in the browser URL bar */
+    showUrl?: boolean;
+    /** Widget configuration options */
+    settings?: {
+        /** Whether the settings widget is enabled */
+        enabled?: boolean;
+        /** Settings panel configuration */
+        panel?: {
+            /** Widget title */
+            title?: string;
+            /** Widget description text */
+            description?: string;
+            /** Whether to show tab groups section in widget (default: true) */
+            showTabGroups?: boolean;
+            /** Whether to show reset button */
+            showReset?: boolean;
+            /** Widget theme */
+            theme?: 'light' | 'dark';
+        };
+        /** Callout configuration options */
+        callout?: {
+            /** Whether to show the callout (default: false) */
+            show?: boolean;
+            /** Message to display in the callout */
+            message?: string;
+            /** Whether to enable pulse animation */
+            enablePulse?: boolean;
+            /** Custom background color */
+            backgroundColor?: string;
+            /** Custom text color */
+            textColor?: string;
+        };
+        /** Custom icon styling options */
+        icon?: {
+            /** Widget position */
+            position?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'middle-left' | 'middle-right';
+            /** Custom icon color */
+            color?: string;
+            /** Custom background color */
+            backgroundColor?: string;
+            /** Custom opacity (0-1) */
+            opacity?: number;
+            /** Custom scale factor */
+            scale?: number;
+        };
+    };
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/types/config.ts"],"names":[],"mappings":"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"}

package/dist/types/types/elements.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Interface for the <cv-tabgroup> custom element.
+ * Has both HTMLElement and the Svelte component props.
+ */
+export interface TabGroupElement extends HTMLElement {
+    activeTabId?: string;
+    isTabGroupNavHeadingVisible?: boolean;
+    pinnedTabId?: string;
+    hasTab: (tabId: string) => boolean;
+    _listenersAttached?: boolean;
+}
+//# sourceMappingURL=elements.d.ts.map

package/dist/types/types/elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../../src/types/elements.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAGnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/dist/types/types/state.d.ts

@@ -0,0 +1,16 @@
+export type ToggleId = string;
+/**
+ * Represents a specific state of a custom view.
+ * States contain the list of toggle categories that should be displayed in this state.
+ */
+export interface State {
+    /** List of toggle categories that should be fully displayed ("Show" state) */
+    shownToggles?: ToggleId[];
+    /** List of toggle categories that should be in preview mode ("Peek" state) */
+    peekToggles?: ToggleId[];
+    /** Optional tab selections: groupId -> tabId */
+    tabs?: Record<string, string>;
+    /** Optional focus selections: array of element IDs */
+    focus?: string[];
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/types/types/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/types/state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC1B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC;IACzB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/types/types/types.d.ts

@@ -1,130 +1,6 @@
-/**
- * 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;
-}
-/**
- * Represents a specific state of a custom view.
- * States contain the list of toggle categories that should be displayed in this state.
- */
-export interface State {
-    /** List of toggle categories that should be fully displayed ("Show" state) */
-    shownToggles?: ToggleId[];
-    /** List of toggle categories that should be in preview mode ("Peek" state) */
-    peekToggles?: ToggleId[];
-    /** Optional tab selections: groupId -> tabId */
-    tabs?: Record<string, string>;
-    /** Optional focus selections: array of element IDs */
-    focus?: string[];
-}
-export type ToggleId = string;
-/**
- * Configuration for a single tab within a tab group
- */
-export interface TabConfig {
-    /** Tab identifier */
-    id: string;
-    /** Display label for the tab */
-    label?: string;
-}
-/**
- * Configuration for a tab group
- */
-export interface TabGroupConfig {
-    /** Group identifier (stable across the page) */
-    id: string;
-    /** Display name for widget/nav */
-    label?: string;
-    /** Available tabs in this group */
-    tabs: TabConfig[];
-    /** Determines if the tab group is only shown on pages where it's used. */
-    isLocal?: boolean;
-}
-/**
- * Configuration for a single toggle.
- */
-export interface ToggleConfig {
-    /** Toggle identifier */
-    id: string;
-    /** Display label for the toggle */
-    label?: string;
-    /** Determines if the toggle is only shown on pages where it's used. */
-    isLocal?: boolean;
-}
-/**
- * Configuration for the site, has default state and list of toggles
- */
-export interface Config {
-    /** All available toggle categories */
-    toggles?: ToggleConfig[];
-    /** Default state for the site */
-    defaultState?: State;
-    /** Optional tab group configurations */
-    tabGroups?: TabGroupConfig[];
-    /** Excluded tags and IDs for Share/Focus modes */
-    shareExclusions?: {
-        tags?: string[];
-        ids?: string[];
-    };
-}
-/**
- * Represents the configuration file structure for CustomViews auto-initialization.
- */
-export interface ConfigFile {
-    /** Core configuration object with toggles and defaultState */
-    config?: Config;
-    /** Path to the assets JSON file */
-    assetsJsonPath?: string;
-    /** Base URL for all paths */
-    baseUrl?: string;
-    /** Whether to keep the `view` state parameter visible in the browser URL bar */
-    showUrl?: boolean;
-    /** Widget configuration options */
-    widget?: {
-        /** Whether the widget is enabled */
-        enabled?: boolean;
-        /** Widget position */
-        position?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'middle-left' | 'middle-right';
-        /** Widget theme */
-        theme?: 'light' | 'dark';
-        /** Whether to show reset button */
-        showReset?: boolean;
-        /** Widget title */
-        title?: string;
-        /** Widget description text */
-        description?: string;
-        /** Whether to show welcome modal on first visit */
-        showWelcome?: boolean;
-        /** Welcome modal message */
-        welcomeMessage?: string;
-        /** Whether to show tab groups section in widget (default: true) */
-        showTabGroups?: boolean;
-    };
-}
-/**
- * Global window interface augmentation for CustomViews
- */
-declare global {
-    interface Window {
-        CustomViews: any;
-        CustomViewsWidget: any;
-        customViewsInstance?: {
-            core: any;
-            widget?: any;
-        };
-    }
-}
+export * from './assets';
+export * from './state';
+export * from './config';
+export * from './elements';
+export * from './global';
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types/types.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/types/utils/icons.d.ts

@@ -1,5 +1,5 @@
 /**
- * Icon utilities for CustomViews widget
+ * Icon utilities for CustomViews settings
  * Centralized SVG icons for better maintainability and reusability
  */
 /**

package/dist/types/utils/init-utils.d.ts

@@ -0,0 +1,24 @@
+import type { ConfigFile } from "../types/types";
+import { CustomViewsSettings } from "../core/settings";
+import type { CustomViewsCore } from "../core/core.svelte";
+/**
+ * structure for script attributes
+ */
+export interface ScriptAttributes {
+    baseURL: string;
+    configPath: string;
+}
+/**
+ * Finds the script tag that loaded the library and extracts configuration attributes.
+ * Looks for `data-base-url` and `data-config-path`.
+ */
+export declare function getScriptAttributes(): ScriptAttributes;
+/**
+ * Fetches and parses the configuration file.
+ */
+export declare function fetchConfig(configPath: string, baseURL: string): Promise<ConfigFile>;
+/**
+ * Initializes the settings if enabled in the config.
+ */
+export declare function initializeWidget(core: CustomViewsCore, config: ConfigFile): CustomViewsSettings | undefined;
+//# sourceMappingURL=init-utils.d.ts.map

package/dist/types/utils/init-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/init-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CA4BtD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAyB1F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAa3G"}

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

@@ -0,0 +1,26 @@
+/**
+ * Calculates the height of a fixed or sticky header, if present.
+ * This is used to offset scroll positions so content isn't hidden behind the header.
+ */
+export declare function getHeaderOffset(): 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.
+ */
+export declare function findHighestVisibleElement(selector: string): HTMLElement | null;
+/**
+ * Scrolls the page to align the element to the top of the viewport,
+ * accounting for fixed/sticky headers and adding some padding.
+ * @param element The element to scroll to.
+ */
+export declare function scrollToElement(element: HTMLElement): void;
+/**
+ * Adjusts the scroll position to keep a specific element in the same visual location.
+ * Useful when content additions/removals above might cause jumps.
+ */
+export declare function handleScrollAnchor(scrollAnchor: {
+    element: HTMLElement;
+    top: number;
+}): void;
+//# sourceMappingURL=scroll-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/scroll-utils.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAmC9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAY1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB5F"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@customviews-js/customviews",
-  "version": "1.4.1-beta.1",
+  "version": "1.4.1-beta.3",
   "description": "A JavaScript dynamic custom views Library.",
   "type": "module",
   "types": "dist/index.d.ts",
   "main": "dist/custom-views.min.js",
-  "module": "dist/custom-views.core.esm.js",
+  "module": "dist/custom-views.esm.js",
   "browser": "dist/custom-views.min.js",
   "unpkg": "dist/custom-views.min.js",
   "jsdelivr": "dist/custom-views.min.js",
@@ -19,13 +19,13 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/custom-views.min.js",
+      "import": "./dist/custom-views.esm.js",
       "require": "./dist/custom-views.min.js",
       "browser": "./dist/custom-views.min.js"
     },
     "./core": {
-      "import": "./dist/custom-views.core.esm.js",
-      "require": "./dist/custom-views.core.cjs.js"
+      "import": "./dist/custom-views.esm.js",
+      "require": "./dist/custom-views.cjs.js"
     }
   },
   "scripts": {
@@ -51,13 +51,18 @@
   "author": "Chan Ger Teck",
   "license": "MIT",
   "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.4",
+    "@tsconfig/svelte": "^5.0.6",
     "@types/jsdom": "^27.0.0",
     "@types/node": "^24.3.1",
     "jsdom": "^27.0.0",
     "rimraf": "^6.0.1",
     "rollup": "^4.46.2",
+    "rollup-plugin-svelte": "^7.2.3",
+    "svelte": "^5.46.1",
+    "svelte-preprocess": "^6.0.3",
     "tslib": "^2.8.1",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"