@nikala-ui/folio 0.13.0

package/dist/config.js.map

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

package/dist/core/content-scanner.d.ts

@@ -0,0 +1,10 @@
+import type { PageData, TocItem } from "../types.js";
+export declare function slugify(text: string): string;
+export declare function extractToc(content: string): TocItem[];
+export declare function extractTitle(content: string, fallback: string): string;
+export declare function filePathToUrl(relativeFilePath: string): string;
+export declare function formatTitleFromFilename(filename: string): string;
+export declare function parseMdxFile(filePath: string, contentDir: string): Promise<PageData>;
+export declare function scanContent(contentDir: string): Promise<PageData[]>;
+export declare function scanContentDirectories(contentDir: string): Promise<string[]>;
+//# sourceMappingURL=content-scanner.d.ts.map

package/dist/core/content-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-scanner.d.ts","sourceRoot":"","sources":["../../src/core/content-scanner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAe,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAclE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe5C;AAkDD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAwCrD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBtE;AAED,wBAAgB,aAAa,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAa9D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoB1F;AAED,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA8BzE;AAED,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAelF"}

package/dist/core/content-scanner.js

@@ -0,0 +1,218 @@
+// packages/docs/src/core/content-scanner.ts
+import path from "node:path";
+import fs from "fs-extra";
+import matter from "gray-matter";
+function isWhitespace(character) {
+    if (!character)
+        return false;
+    const code = character.charCodeAt(0);
+    return code === 9 || code === 10 || code === 11 || code === 12 || code === 13 || code === 32;
+}
+function isSlugCharacter(character) {
+    if (!character)
+        return false;
+    const code = character.charCodeAt(0);
+    return (code >= 48 && code <= 57) || (code >= 65 && code <= 90) || (code >= 97 && code <= 122) || character === "_" || character === "-";
+}
+export function slugify(text) {
+    let result = "";
+    for (const character of text.toLowerCase()) {
+        if (isWhitespace(character)) {
+            result += "-";
+        }
+        else if (isSlugCharacter(character)) {
+            result += character;
+        }
+    }
+    let start = 0;
+    let end = result.length;
+    while (start < end && result[start] === "-")
+        start += 1;
+    while (end > start && result[end - 1] === "-")
+        end -= 1;
+    return result.slice(start, end);
+}
+function parseHeading(line, minLevel, maxLevel) {
+    const trimmed = line.trim();
+    let level = 0;
+    while (level < trimmed.length && trimmed[level] === "#")
+        level += 1;
+    if (level < minLevel || level > maxLevel || !isWhitespace(trimmed[level]))
+        return undefined;
+    let start = level;
+    while (start < trimmed.length && isWhitespace(trimmed[start]))
+        start += 1;
+    if (start === trimmed.length)
+        return undefined;
+    return { level, text: trimmed.slice(start).trim() };
+}
+function stripMarkdownLinks(text) {
+    let result = "";
+    let index = 0;
+    while (index < text.length) {
+        if (text[index] !== "[") {
+            result += text[index++];
+            continue;
+        }
+        const labelEnd = text.indexOf("]", index + 1);
+        const linkStart = labelEnd + 1;
+        if (labelEnd < 0 || text[linkStart] !== "(") {
+            result += text[index++];
+            continue;
+        }
+        const linkEnd = text.indexOf(")", linkStart + 1);
+        if (linkEnd < 0) {
+            result += text[index++];
+            continue;
+        }
+        result += text.slice(index + 1, labelEnd);
+        index = linkEnd + 1;
+    }
+    return result;
+}
+function stripMarkdownDecorators(text) {
+    let result = "";
+    for (const character of text) {
+        if (character !== "*" && character !== "_" && character !== "`")
+            result += character;
+    }
+    return result;
+}
+export function extractToc(content) {
+    const headings = [];
+    const slugCounts = new Map();
+    const lines = content.split("\n");
+    let inCodeBlock = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("```")) {
+            inCodeBlock = !inCodeBlock;
+            continue;
+        }
+        if (inCodeBlock)
+            continue;
+        // Match H2 and H3 headings: ## Title or ### Title
+        const match = parseHeading(trimmed, 2, 3);
+        if (match) {
+            const level = match.level;
+            let text = match.text;
+            // Clean inline markdown links, bold, code wrappers
+            text = stripMarkdownDecorators(stripMarkdownLinks(text));
+            const baseId = slugify(text);
+            if (baseId) {
+                const occurrence = slugCounts.get(baseId) ?? 0;
+                const id = occurrence === 0 ? baseId : `${baseId}-${occurrence}`;
+                slugCounts.set(baseId, occurrence + 1);
+                headings.push({
+                    id,
+                    text,
+                    depth: level,
+                });
+            }
+        }
+    }
+    return headings;
+}
+export function extractTitle(content, fallback) {
+    const lines = content.split("\n");
+    let inCodeBlock = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("```")) {
+            inCodeBlock = !inCodeBlock;
+            continue;
+        }
+        if (inCodeBlock)
+            continue;
+        const match = parseHeading(trimmed, 1, 1);
+        if (match) {
+            return stripMarkdownDecorators(match.text);
+        }
+    }
+    return fallback;
+}
+export function filePathToUrl(relativeFilePath) {
+    let cleanPath = relativeFilePath.replace(/\\/g, "/");
+    cleanPath = cleanPath.replace(/\.(mdx?)$/, "");
+    if (cleanPath === "index" || cleanPath === "") {
+        return "/";
+    }
+    if (cleanPath.endsWith("/index")) {
+        cleanPath = cleanPath.slice(0, -6);
+    }
+    return cleanPath.startsWith("/") ? cleanPath : `/${cleanPath}`;
+}
+export function formatTitleFromFilename(filename) {
+    const base = path.basename(filename, path.extname(filename));
+    if (base === "index")
+        return "Overview";
+    return base
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+export async function parseMdxFile(filePath, contentDir) {
+    const raw = await fs.readFile(filePath, "utf-8");
+    const parsed = matter(raw);
+    const frontmatter = (parsed.data || {});
+    const relativePath = path.relative(contentDir, filePath);
+    const url = filePathToUrl(relativePath);
+    const fallbackTitle = formatTitleFromFilename(filePath);
+    const title = frontmatter.title || extractTitle(parsed.content, fallbackTitle);
+    const toc = extractToc(parsed.content);
+    return {
+        slug: url === "/" ? "index" : url.slice(1).replace(/\//g, "-"),
+        url,
+        filePath,
+        sourcePath: relativePath.replace(/\\/g, "/"),
+        frontmatter,
+        toc,
+        title,
+        description: frontmatter.description,
+    };
+}
+export async function scanContent(contentDir) {
+    if (!(await fs.pathExists(contentDir))) {
+        return [];
+    }
+    const results = [];
+    async function walk(dir) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile() && /\.(md|mdx)$/.test(entry.name)) {
+                const page = await parseMdxFile(fullPath, contentDir);
+                results.push(page);
+            }
+        }
+    }
+    await walk(contentDir);
+    // Sort by URL depth and alphabetical order
+    return results.sort((a, b) => {
+        if (a.url === "/")
+            return -1;
+        if (b.url === "/")
+            return 1;
+        return a.url.localeCompare(b.url);
+    });
+}
+export async function scanContentDirectories(contentDir) {
+    if (!(await fs.pathExists(contentDir)))
+        return [];
+    const directories = new Set();
+    async function walk(dir) {
+        for (const entry of await fs.readdir(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const fullPath = path.join(dir, entry.name);
+            directories.add(path.relative(contentDir, fullPath).replace(/\\/g, "/"));
+            await walk(fullPath);
+        }
+    }
+    await walk(contentDir);
+    return [...directories].sort();
+}
+//# sourceMappingURL=content-scanner.js.map

package/dist/core/content-scanner.js.map

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

package/dist/core/route-tree.d.ts

@@ -0,0 +1,24 @@
+import type { PageData, SidebarItem } from "../types.js";
+export { flattenSidebarItems } from "../navigation/sidebar-tree.js";
+export declare function formatGroupName(segment: string): string;
+export declare function buildSidebarTree(pages: PageData[], directories?: string[]): SidebarItem[];
+/**
+ * Build a sidebar from an explicit configuration while validating every page
+ * link against the scanned documentation routes.
+ */
+export declare function buildConfiguredSidebarTree(items: SidebarItem[], pages: PageData[]): SidebarItem[];
+export declare function buildPagination(pages: PageData[], currentUrl: string): {
+    prev?: {
+        title: string;
+        href: string;
+    };
+    next?: {
+        title: string;
+        href: string;
+    };
+};
+export declare function buildBreadcrumbs(url: string, pages: PageData[]): Array<{
+    title: string;
+    href?: string;
+}>;
+//# sourceMappingURL=route-tree.d.ts.map

package/dist/core/route-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-tree.d.ts","sourceRoot":"","sources":["../../src/core/route-tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,WAAW,EAAE,CAkJ7F;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAmBjG;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAmCpF;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,QAAQ,EAAE,GAChB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BzC"}

package/dist/core/route-tree.js

@@ -0,0 +1,221 @@
+import { formatTitleFromFilename } from "./content-scanner.js";
+import { flattenSidebarItems } from "../navigation/sidebar-tree.js";
+export { flattenSidebarItems } from "../navigation/sidebar-tree.js";
+export function formatGroupName(segment) {
+    return segment
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+export function buildSidebarTree(pages, directories = []) {
+    const rootPages = [];
+    const categoryMap = new Map();
+    for (const directory of directories) {
+        const category = directory.split("/")[0];
+        if (category && !categoryMap.has(category))
+            categoryMap.set(category, []);
+    }
+    // Derive categories from pages as well. Tests and programmatic consumers
+    // may provide pages without a separately scanned directory list.
+    for (const page of pages) {
+        const segments = page.url.slice(1).split("/");
+        if (segments.length > 1 && !categoryMap.has(segments[0])) {
+            categoryMap.set(segments[0], []);
+        }
+    }
+    for (const page of pages) {
+        if (page.url === "/") {
+            // The home page is the site entry point, not a documentation item.
+            // Keep it out of the sidebar so it is not duplicated as "Introduction".
+            continue;
+        }
+        const segments = page.url.slice(1).split("/");
+        const isCategoryIndex = segments.length === 1 && categoryMap.has(segments[0]);
+        // A directory index is the overview page for its category. Keep it in
+        // the category instead of rendering it as a second root-level item.
+        if (isCategoryIndex) {
+            const cat = segments[0];
+            if (!categoryMap.has(cat))
+                categoryMap.set(cat, []);
+            categoryMap.get(cat).push(page);
+            continue;
+        }
+        if (segments.length === 1) {
+            rootPages.push(page);
+        }
+        else {
+            const cat = segments[0];
+            if (!categoryMap.has(cat)) {
+                categoryMap.set(cat, []);
+            }
+            categoryMap.get(cat).push(page);
+        }
+    }
+    // Sort root pages by order, then title.
+    rootPages.sort((a, b) => {
+        const orderA = a.frontmatter.order ?? 9999;
+        const orderB = b.frontmatter.order ?? 9999;
+        if (orderA !== orderB)
+            return orderA - orderB;
+        return a.title.localeCompare(b.title);
+    });
+    const rootItems = rootPages.map((page) => ({
+        title: page.title || "Overview",
+        href: page.url,
+        badge: page.frontmatter.badge,
+        addedAt: page.frontmatter.addedAt,
+        icon: page.frontmatter.icon,
+    }));
+    // Determine order of categories
+    const categories = Array.from(categoryMap.entries()).map(([cat, catPages]) => {
+        const minCategoryOrder = Math.min(...catPages.map((p) => {
+            const catOrder = typeof p.frontmatter.categoryOrder === "number" ? p.frontmatter.categoryOrder : undefined;
+            return catOrder ?? 9999;
+        }));
+        const minPageOrder = Math.min(...catPages.map((p) => p.frontmatter.order ?? 9999));
+        return { cat, catPages, minCategoryOrder, minPageOrder };
+    });
+    categories.sort((a, b) => {
+        if (a.minCategoryOrder !== b.minCategoryOrder) {
+            return a.minCategoryOrder - b.minCategoryOrder;
+        }
+        if (a.minPageOrder !== b.minPageOrder) {
+            return a.minPageOrder - b.minPageOrder;
+        }
+        return a.cat.localeCompare(b.cat);
+    });
+    for (const { cat, catPages } of categories) {
+        const categoryIndex = catPages.find((page) => page.url === `/${cat}`);
+        const group = {
+            title: formatGroupName(cat),
+            href: categoryIndex?.url,
+            icon: categoryIndex?.frontmatter.icon,
+            items: [],
+        };
+        // Sort pages in this category by order, then title. The category index
+        // owns the category URL but is not rendered as a duplicate sidebar item.
+        catPages.sort((a, b) => {
+            const orderA = a.frontmatter.order ?? 9999;
+            const orderB = b.frontmatter.order ?? 9999;
+            if (orderA !== orderB)
+                return orderA - orderB;
+            return a.title.localeCompare(b.title);
+        });
+        for (const page of catPages) {
+            const segments = page.url.slice(1).split("/");
+            const isCategoryIndex = segments.length === 1;
+            if (isCategoryIndex) {
+                continue;
+            }
+            else if (segments.length === 2) {
+                group.items?.push({
+                    title: page.title,
+                    href: page.url,
+                    badge: page.frontmatter.badge,
+                    addedAt: page.frontmatter.addedAt,
+                    icon: page.frontmatter.icon,
+                });
+            }
+            else {
+                const subCategory = segments[1];
+                let subGroup = group.items?.find((item) => item.title === formatGroupName(subCategory) && item.items);
+                if (!subGroup) {
+                    subGroup = {
+                        title: formatGroupName(subCategory),
+                        items: [],
+                    };
+                    group.items?.push(subGroup);
+                }
+                subGroup.items?.push({
+                    title: page.title,
+                    href: page.url,
+                    badge: page.frontmatter.badge,
+                    addedAt: page.frontmatter.addedAt,
+                    icon: page.frontmatter.icon,
+                });
+            }
+        }
+        rootItems.push(group);
+    }
+    return rootItems;
+}
+/**
+ * Build a sidebar from an explicit configuration while validating every page
+ * link against the scanned documentation routes.
+ */
+export function buildConfiguredSidebarTree(items, pages) {
+    const pageUrls = new Set(pages.map((page) => page.url));
+    const visit = (entries, parentPath) => entries.map((item, index) => {
+        const location = parentPath ? `${parentPath}.${index}` : `${index}`;
+        const href = item.href?.trim();
+        if (href && (!href.startsWith("/") || !pageUrls.has(href))) {
+            throw new Error(`Invalid sidebar link at sidebar[${location}]: ${item.href}`);
+        }
+        const children = item.items ? visit(item.items, `${location}.items`) : undefined;
+        return {
+            ...item,
+            href: href || undefined,
+            items: children,
+        };
+    });
+    return visit(items, "");
+}
+export function buildPagination(pages, currentUrl) {
+    const currentPage = pages.find((p) => p.url === currentUrl);
+    const navigationPages = pages.filter((page) => page.url !== "/");
+    const sidebar = buildSidebarTree(navigationPages);
+    const flattened = flattenSidebarItems(sidebar);
+    const currentIndex = flattened.findIndex((item) => item.href === currentUrl);
+    if (currentIndex === -1) {
+        return {};
+    }
+    let prev = currentIndex > 0 ? flattened[currentIndex - 1] : undefined;
+    let next = currentIndex < flattened.length - 1 ? flattened[currentIndex + 1] : undefined;
+    // Custom frontmatter overrides
+    if (currentPage?.frontmatter.prev === false || currentPage?.frontmatter.prev === null) {
+        prev = undefined;
+    }
+    else if (typeof currentPage?.frontmatter.prev === "string") {
+        const target = pages.find((p) => p.url === currentPage.frontmatter.prev);
+        if (target)
+            prev = { title: target.title, href: target.url };
+    }
+    else if (typeof currentPage?.frontmatter.prev === "object" && currentPage.frontmatter.prev !== null) {
+        prev = currentPage.frontmatter.prev;
+    }
+    if (currentPage?.frontmatter.next === false || currentPage?.frontmatter.next === null) {
+        next = undefined;
+    }
+    else if (typeof currentPage?.frontmatter.next === "string") {
+        const target = pages.find((p) => p.url === currentPage.frontmatter.next);
+        if (target)
+            next = { title: target.title, href: target.url };
+    }
+    else if (typeof currentPage?.frontmatter.next === "object" && currentPage.frontmatter.next !== null) {
+        next = currentPage.frontmatter.next;
+    }
+    return { prev, next };
+}
+export function buildBreadcrumbs(url, pages) {
+    const breadcrumbs = [
+        { title: "Docs", href: "/" },
+    ];
+    if (url === "/") {
+        return breadcrumbs;
+    }
+    const segments = url.slice(1).split("/");
+    let accumulatedPath = "";
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        accumulatedPath += `/${seg}`;
+        const isLast = i === segments.length - 1;
+        const matchingPage = pages.find((p) => p.url === accumulatedPath);
+        const title = matchingPage?.title || formatTitleFromFilename(seg);
+        breadcrumbs.push({
+            title,
+            href: isLast ? undefined : accumulatedPath,
+        });
+    }
+    return breadcrumbs;
+}
+//# sourceMappingURL=route-tree.js.map

package/dist/core/route-tree.js.map

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

package/dist/hooks/create-click-outside.d.ts

@@ -0,0 +1,18 @@
+import { type Accessor } from "solid-js";
+export interface CreateClickOutsideOptions {
+    /** Target HTML element or accessor returning the container element */
+    target: HTMLElement | Accessor<HTMLElement | undefined> | (HTMLElement | Accessor<HTMLElement | undefined>)[];
+    /** Callback fired when a click/pointer event occurs outside the target element(s) */
+    onInteractOutside: (event: MouseEvent | PointerEvent | TouchEvent) => void;
+    /** Whether the listener is active. Defaults to true. */
+    enabled?: boolean | Accessor<boolean>;
+    /** Optional element or accessor to ignore when checking outside clicks (e.g. trigger button) */
+    ignore?: HTMLElement | Accessor<HTMLElement | undefined> | (HTMLElement | Accessor<HTMLElement | undefined>)[];
+}
+/**
+ * SolidJS reactive primitive for detecting user interactions outside specified element(s).
+ *
+ * @param options Configuration options including target element(s), callback, and optional ignore elements.
+ */
+export declare function createClickOutside(options: CreateClickOutsideOptions): void;
+//# sourceMappingURL=create-click-outside.d.ts.map

package/dist/hooks/create-click-outside.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-click-outside.d.ts","sourceRoot":"","sources":["../../src/hooks/create-click-outside.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,MAAM,EACF,WAAW,GACX,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,GACjC,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC;IACxD,qFAAqF;IACrF,iBAAiB,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,GAAG,UAAU,KAAK,IAAI,CAAC;IAC3E,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtC,gGAAgG;IAChG,MAAM,CAAC,EACH,WAAW,GACX,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,GACjC,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC;CACzD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAyD3E"}

package/dist/hooks/create-click-outside.js

@@ -0,0 +1,55 @@
+import { onMount, onCleanup } from "solid-js";
+/**
+ * SolidJS reactive primitive for detecting user interactions outside specified element(s).
+ *
+ * @param options Configuration options including target element(s), callback, and optional ignore elements.
+ */
+export function createClickOutside(options) {
+    const isEnabled = () => {
+        if (typeof options.enabled === "function") {
+            return options.enabled();
+        }
+        return options.enabled ?? true;
+    };
+    const getElement = (el) => {
+        if (!el)
+            return undefined;
+        if (typeof el === "function") {
+            return el();
+        }
+        return el;
+    };
+    const getElements = (targets) => {
+        if (!targets)
+            return [];
+        const list = Array.isArray(targets) ? targets : [targets];
+        return list.map(getElement).filter((e) => e !== undefined);
+    };
+    const handlePointerDown = (event) => {
+        if (!isEnabled())
+            return;
+        const targetNode = event.target;
+        if (!targetNode)
+            return;
+        const mainElements = getElements(options.target);
+        if (mainElements.length === 0)
+            return;
+        const isInsideTarget = mainElements.some((el) => el.contains(targetNode));
+        if (isInsideTarget)
+            return;
+        const ignoreElements = getElements(options.ignore);
+        const isInsideIgnore = ignoreElements.some((el) => el.contains(targetNode));
+        if (isInsideIgnore)
+            return;
+        options.onInteractOutside(event);
+    };
+    onMount(() => {
+        if (typeof window === "undefined")
+            return;
+        window.addEventListener("pointerdown", handlePointerDown, true);
+        onCleanup(() => {
+            window.removeEventListener("pointerdown", handlePointerDown, true);
+        });
+    });
+}
+//# sourceMappingURL=create-click-outside.js.map

package/dist/hooks/create-click-outside.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-click-outside.js","sourceRoot":"","sources":["../../src/hooks/create-click-outside.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAiB,MAAM,UAAU,CAAC;AAmB7D;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACjC,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CACjB,EAA+D,EACtC,EAAE;QAC3B,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAC1B,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAQ,EAAwC,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAClB,OAIa,EACE,EAAE;QACjB,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAC/E,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,CAAC,KAA6C,EAAE,EAAE;QAC1E,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QAEzB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAqB,CAAC;QAC/C,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEtC,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1E,IAAI,cAAc;YAAE,OAAO;QAE3B,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5E,IAAI,cAAc;YAAE,OAAO;QAE3B,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,OAAO,CAAC,GAAG,EAAE;QACX,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAE1C,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAChE,SAAS,CAAC,GAAG,EAAE;YACb,MAAM,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/hooks/create-clipboard.d.ts

@@ -0,0 +1,20 @@
+import { type Accessor } from "solid-js";
+export interface CreateClipboardOptions {
+    /** Time in milliseconds to maintain the copied state before resetting. Defaults to 2000ms. */
+    timeout?: number;
+}
+export interface CreateClipboardReturn {
+    /** Signal accessor indicating if content was recently copied */
+    copied: Accessor<boolean>;
+    /** Function to copy text to clipboard */
+    copy: (text: string) => Promise<boolean>;
+    /** Error state if clipboard write fails */
+    error: Accessor<Error | undefined>;
+}
+/**
+ * SolidJS reactive primitive for copying text to clipboard with automatic reset state.
+ *
+ * @param options Configuration options including copied status reset timeout duration.
+ */
+export declare function createClipboard(options?: CreateClipboardOptions): CreateClipboardReturn;
+//# sourceMappingURL=create-clipboard.d.ts.map

package/dist/hooks/create-clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-clipboard.d.ts","sourceRoot":"","sources":["../../src/hooks/create-clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1B,yCAAyC;IACzC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,2CAA2C;IAC3C,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CA+C3F"}