@cellarnode/ui 0.16.9 → 0.17.3

package/dist/opportunities/opportunities-table.test.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect, vi } from "vitest";
+import { fireEvent, render, screen } from "@testing-library/react";
+import { OpportunitiesTable, } from "./opportunities-table";
+// ─── Invariants under test ──────────────────────────────────────────────────
+//
+// 1. Empty state renders the configured empty message when `data=[]`.
+// 2. Loading state renders skeletons and hides the row count / empty message.
+// 3. Custom emptyMessage overrides the default.
+// 4. The search input filters rows by name.
+// 5. Row expand toggle flips aria-expanded and reveals the detail grid.
+// 6. When `getRowHref` + `renderLink` are provided, the name is wrapped by
+//    the link renderer (consumer-provided routing).
+//
+// We do NOT test date formatting (date-fns / time-sensitive) or every flag
+// mapping — those are cosmetic and would thrash with locale/data changes.
+const rows = [
+    {
+        id: "opp-1",
+        name: "Nordic Beer Tender 2026",
+        marketIdentifier: "SYS-2026-001",
+        beverageType: "Beer",
+        countryOfOrigin: "Sweden",
+        status: "open",
+        submissionDeadline: new Date(Date.now() + 14 * 24 * 60 * 60 * 1000).toISOString(),
+        createdAt: new Date().toISOString(),
+    },
+    {
+        id: "opp-2",
+        name: "French Wine RFP",
+        marketIdentifier: "SYS-2026-002",
+        beverageType: "Wine",
+        countryOfOrigin: "France",
+        status: "closed",
+        submissionDeadline: new Date(Date.now() - 5 * 24 * 60 * 60 * 1000).toISOString(),
+        createdAt: new Date().toISOString(),
+    },
+];
+describe("OpportunitiesTable", () => {
+    it("renders the default empty-state message when data is empty", () => {
+        render(_jsx(OpportunitiesTable, { data: [] }));
+        expect(screen.getByText(/no opportunities found/i)).toBeInTheDocument();
+    });
+    it("renders a custom emptyMessage when provided", () => {
+        render(_jsx(OpportunitiesTable, { data: [], emptyMessage: "Nothing matches your filters." }));
+        expect(screen.getByText(/nothing matches your filters/i)).toBeInTheDocument();
+    });
+    it("renders loading skeletons and hides the row count when isLoading", () => {
+        const { container } = render(_jsx(OpportunitiesTable, { data: [], isLoading: true }));
+        // Skeleton list items — there should be the 5 placeholder <li> entries.
+        const listItems = container.querySelectorAll("ul > li");
+        expect(listItems.length).toBe(5);
+        // The "N opportunities" count chip is suppressed while loading.
+        expect(screen.queryByText(/opportunit(y|ies)$/i)).not.toBeInTheDocument();
+    });
+    it("renders a row per data item with its name and market identifier", () => {
+        render(_jsx(OpportunitiesTable, { data: rows }));
+        expect(screen.getByText(/nordic beer tender 2026/i)).toBeInTheDocument();
+        expect(screen.getByText(/french wine rfp/i)).toBeInTheDocument();
+        expect(screen.getByText(/SYS-2026-001/)).toBeInTheDocument();
+    });
+    it("filters rows via the search input (global filter)", () => {
+        render(_jsx(OpportunitiesTable, { data: rows }));
+        const search = screen.getByPlaceholderText(/search name/i);
+        fireEvent.change(search, { target: { value: "wine" } });
+        expect(screen.queryByText(/nordic beer tender/i)).not.toBeInTheDocument();
+        expect(screen.getByText(/french wine rfp/i)).toBeInTheDocument();
+    });
+    it("flips aria-expanded when the row expand toggle is clicked", () => {
+        render(_jsx(OpportunitiesTable, { data: [rows[0]] }));
+        const toggle = screen.getByRole("button", { name: /expand details/i });
+        expect(toggle).toHaveAttribute("aria-expanded", "false");
+        fireEvent.click(toggle);
+        // After clicking, aria flips to true and the aria-label rotates.
+        expect(screen.getByRole("button", { name: /collapse details/i })).toHaveAttribute("aria-expanded", "true");
+    });
+    it("uses renderLink + getRowHref to wrap row names when provided", () => {
+        const renderLink = vi.fn((href, children) => (_jsx("a", { href: href, "data-testid": "stub-link", children: children })));
+        render(_jsx(OpportunitiesTable, { data: rows, renderLink: renderLink, getRowHref: (row) => `/ops/${row.id}` }));
+        // Consumer link renderer was invoked for each row
+        expect(renderLink).toHaveBeenCalled();
+        const links = screen.getAllByTestId("stub-link");
+        expect(links.length).toBe(rows.length);
+        expect(links[0]).toHaveAttribute("href", "/ops/opp-1");
+    });
+});
+//# sourceMappingURL=opportunities-table.test.js.map

package/dist/opportunities/opportunities-table.test.js.map

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

package/dist/skeleton/__tests__/loader.test.d.ts

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

package/dist/skeleton/__tests__/loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.d.ts","sourceRoot":"","sources":["../../../src/skeleton/__tests__/loader.test.tsx"],"names":[],"mappings":""}

package/dist/skeleton/__tests__/loader.test.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { Loader } from "../loader";
+describe("<Loader>", () => {
+    it("renders fallback when isLoading is true (initial load)", () => {
+        render(_jsx(Loader, { query: { data: undefined, isLoading: true, isFetching: true }, fallback: _jsx("div", { "data-testid": "fb", children: "loading" }), children: (d) => _jsx("div", { "data-testid": "children", children: String(d) }) }));
+        expect(screen.getByTestId("fb")).toBeInTheDocument();
+        expect(screen.queryByTestId("children")).not.toBeInTheDocument();
+    });
+    it("renders children with data-refetch-pulse when isFetching and data present", () => {
+        render(_jsx(Loader, { query: { data: "DATA", isLoading: false, isFetching: true }, fallback: _jsx("div", { "data-testid": "fb", children: "loading" }), children: (d) => _jsx("div", { "data-testid": "children", children: d }) }));
+        expect(screen.queryByTestId("fb")).not.toBeInTheDocument();
+        expect(screen.getByTestId("children").textContent).toBe("DATA");
+        const wrapper = screen.getByTestId("children").parentElement;
+        expect(wrapper).toHaveAttribute("data-refetch-pulse");
+    });
+    it("renders children without pulse when data ready and not fetching", () => {
+        render(_jsx(Loader, { query: { data: "OK", isLoading: false, isFetching: false }, fallback: _jsx("div", { "data-testid": "fb", children: "loading" }), children: (d) => _jsx("div", { "data-testid": "children", children: d }) }));
+        expect(screen.getByTestId("children").textContent).toBe("OK");
+        const wrapper = screen.getByTestId("children").parentElement;
+        expect(wrapper).not.toHaveAttribute("data-refetch-pulse");
+    });
+    it("renders default error card when error is present and no errorFallback provided", () => {
+        render(_jsx(Loader, { query: { data: undefined, isLoading: false, isFetching: false, error: new Error("boom") }, fallback: _jsx("div", { children: "loading" }), children: () => _jsx("div", { children: "ok" }) }));
+        expect(screen.getByRole("alert")).toHaveTextContent("boom");
+    });
+    it("invokes errorFallback when provided", () => {
+        render(_jsx(Loader, { query: { data: undefined, isLoading: false, isFetching: false, error: new Error("boom") }, fallback: _jsx("div", { children: "loading" }), errorFallback: (err) => _jsx("div", { "data-testid": "err", children: err.message.toUpperCase() }), children: () => _jsx("div", { children: "ok" }) }));
+        expect(screen.getByTestId("err").textContent).toBe("BOOM");
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/skeleton/__tests__/loader.test.js.map

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

package/dist/skeleton/__tests__/primitive.test.d.ts

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

package/dist/skeleton/__tests__/primitive.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.test.d.ts","sourceRoot":"","sources":["../../../src/skeleton/__tests__/primitive.test.tsx"],"names":[],"mappings":""}

package/dist/skeleton/__tests__/primitive.test.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { Skeleton } from "../../components/skeleton";
+import { SkeletonProvider } from "../provider";
+describe("Skeleton primitive", () => {
+    it("renders with data-skeleton and default data-tier='inline' when used bare", () => {
+        render(_jsx(Skeleton, { "data-testid": "bone" }));
+        const bone = screen.getByTestId("bone");
+        expect(bone).toHaveAttribute("data-skeleton");
+        expect(bone).toHaveAttribute("data-tier", "inline");
+    });
+    it("honours explicit tier prop", () => {
+        render(_jsx(Skeleton, { tier: "hero", "data-testid": "bone" }));
+        expect(screen.getByTestId("bone")).toHaveAttribute("data-tier", "hero");
+    });
+    it("adopts provider tier when nested, without explicit prop", () => {
+        render(_jsx(SkeletonProvider, { tier: "data", children: _jsx(Skeleton, { "data-testid": "bone" }) }));
+        expect(screen.getByTestId("bone")).toHaveAttribute("data-tier", "data");
+    });
+    it("explicit tier prop wins over provider tier", () => {
+        render(_jsx(SkeletonProvider, { tier: "hero", children: _jsx(Skeleton, { tier: "inline", "data-testid": "bone" }) }));
+        expect(screen.getByTestId("bone")).toHaveAttribute("data-tier", "inline");
+    });
+    it("is aria-hidden by default (decorative)", () => {
+        render(_jsx(Skeleton, { "data-testid": "bone" }));
+        expect(screen.getByTestId("bone")).toHaveAttribute("aria-hidden", "true");
+    });
+    it("forwards className and merges with defaults", () => {
+        render(_jsx(Skeleton, { className: "h-6 w-32", "data-testid": "bone" }));
+        const bone = screen.getByTestId("bone");
+        expect(bone.className).toContain("h-6");
+        expect(bone.className).toContain("w-32");
+    });
+});
+//# sourceMappingURL=primitive.test.js.map

package/dist/skeleton/__tests__/primitive.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.test.js","sourceRoot":"","sources":["../../../src/skeleton/__tests__/primitive.test.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,CAAC,KAAC,QAAQ,mBAAa,MAAM,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,KAAC,QAAQ,IAAC,IAAI,EAAC,MAAM,iBAAa,MAAM,GAAG,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CACJ,KAAC,gBAAgB,IAAC,IAAI,EAAC,MAAM,YAC3B,KAAC,QAAQ,mBAAa,MAAM,GAAG,GACd,CACpB,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CACJ,KAAC,gBAAgB,IAAC,IAAI,EAAC,MAAM,YAC3B,KAAC,QAAQ,IAAC,IAAI,EAAC,QAAQ,iBAAa,MAAM,GAAG,GAC5B,CACpB,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,KAAC,QAAQ,mBAAa,MAAM,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,iBAAa,MAAM,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/skeleton/__tests__/provider.test.d.ts

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

package/dist/skeleton/__tests__/provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.d.ts","sourceRoot":"","sources":["../../../src/skeleton/__tests__/provider.test.tsx"],"names":[],"mappings":""}

package/dist/skeleton/__tests__/provider.test.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { describe, it, expect } from "vitest";
+import { render, screen } from "@testing-library/react";
+import * as React from "react";
+import { SkeletonProvider, SkeletonGroup } from "../provider";
+import { useCascadeIndex, useSkeletonContext } from "../stagger";
+function IndexProbe({ testid }) {
+    const i = useCascadeIndex();
+    return _jsx("div", { "data-testid": testid, children: i });
+}
+function TierProbe() {
+    const ctx = useSkeletonContext();
+    return _jsx("div", { "data-testid": "tier", children: ctx.tier });
+}
+function ContextValuesProbe() {
+    const ctx = useSkeletonContext();
+    return (_jsxs(_Fragment, { children: [_jsx("div", { "data-testid": "ctx-tier", children: ctx.tier }), _jsx("div", { "data-testid": "ctx-stagger", children: ctx.stagger }), _jsx("div", { "data-testid": "ctx-label", children: ctx.label })] }));
+}
+function HasProviderProbe() {
+    const ctx = useSkeletonContext();
+    return _jsx("div", { "data-testid": "has-provider", children: String(ctx.hasProvider) });
+}
+describe("useCascadeIndex", () => {
+    it("returns 0 when used without a provider", () => {
+        render(_jsx(IndexProbe, { testid: "i" }));
+        expect(screen.getByTestId("i").textContent).toBe("0");
+    });
+    it("increments per mounted probe inside a provider", () => {
+        render(_jsxs(SkeletonProvider, { children: [_jsx(IndexProbe, { testid: "a" }), _jsx(IndexProbe, { testid: "b" }), _jsx(IndexProbe, { testid: "c" })] }));
+        expect(screen.getByTestId("a").textContent).toBe("0");
+        expect(screen.getByTestId("b").textContent).toBe("1");
+        expect(screen.getByTestId("c").textContent).toBe("2");
+    });
+    it("allocates exactly one index per mount, even in StrictMode", () => {
+        render(_jsx(React.StrictMode, { children: _jsxs(SkeletonProvider, { children: [_jsx(IndexProbe, { testid: "a" }), _jsx(IndexProbe, { testid: "b" }), _jsx(IndexProbe, { testid: "c" })] }) }));
+        expect(screen.getByTestId("a").textContent).toBe("0");
+        expect(screen.getByTestId("b").textContent).toBe("1");
+        expect(screen.getByTestId("c").textContent).toBe("2");
+    });
+    it("resets the counter inside a nested SkeletonGroup", () => {
+        render(_jsxs(SkeletonProvider, { children: [_jsx(IndexProbe, { testid: "outer-a" }), _jsx(IndexProbe, { testid: "outer-b" }), _jsxs(SkeletonGroup, { children: [_jsx(IndexProbe, { testid: "inner-a" }), _jsx(IndexProbe, { testid: "inner-b" })] })] }));
+        expect(screen.getByTestId("outer-a").textContent).toBe("0");
+        expect(screen.getByTestId("outer-b").textContent).toBe("1");
+        expect(screen.getByTestId("inner-a").textContent).toBe("0");
+        expect(screen.getByTestId("inner-b").textContent).toBe("1");
+    });
+});
+describe("SkeletonProvider", () => {
+    it("exposes default tier 'hero' and stagger 120", () => {
+        render(_jsx(SkeletonProvider, { children: _jsx(ContextValuesProbe, {}) }));
+        expect(screen.getByTestId("ctx-tier").textContent).toBe("hero");
+        expect(screen.getByTestId("ctx-stagger").textContent).toBe("120");
+        expect(screen.getByTestId("ctx-label").textContent).toBe("Loading");
+    });
+    it("respects overridden tier, stagger, and label", () => {
+        render(_jsx(SkeletonProvider, { tier: "data", stagger: 60, label: "Loading dashboard", children: _jsx(TierProbe, {}) }));
+        expect(screen.getByTestId("tier").textContent).toBe("data");
+    });
+    it("does NOT emit an aria-live region by default (isBusy unset)", () => {
+        render(_jsx(SkeletonProvider, { label: "Loading dashboard", children: _jsx("div", { "data-testid": "inner", children: "content" }) }));
+        expect(screen.queryByRole("status")).not.toBeInTheDocument();
+        expect(screen.getByTestId("inner")).toBeInTheDocument();
+    });
+    it("emits role=status + aria-live=polite + aria-busy=true when isBusy={true}", () => {
+        render(_jsx(SkeletonProvider, { label: "Loading dashboard", isBusy: true, children: _jsx("div", { "data-testid": "inner", children: "content" }) }));
+        const region = screen.getByRole("status");
+        expect(region).toHaveAttribute("aria-live", "polite");
+        expect(region).toHaveAttribute("aria-busy", "true");
+        expect(region).toHaveAttribute("aria-label", "Loading dashboard");
+        expect(screen.getByTestId("inner")).toBeInTheDocument();
+    });
+    it("does NOT emit an aria-live region when isBusy={false}", () => {
+        render(_jsx(SkeletonProvider, { isBusy: false, children: _jsx("div", { "data-testid": "inner", children: "content" }) }));
+        expect(screen.queryByRole("status")).not.toBeInTheDocument();
+        expect(screen.getByTestId("inner")).toBeInTheDocument();
+    });
+});
+describe("useSkeletonContext", () => {
+    it("reports hasProvider: false without a provider", () => {
+        render(_jsx(HasProviderProbe, {}));
+        expect(screen.getByTestId("has-provider").textContent).toBe("false");
+    });
+    it("reports hasProvider: true inside a provider", () => {
+        render(_jsx(SkeletonProvider, { children: _jsx(HasProviderProbe, {}) }));
+        expect(screen.getByTestId("has-provider").textContent).toBe("true");
+    });
+});
+//# sourceMappingURL=provider.test.js.map

package/dist/skeleton/__tests__/provider.test.js.map

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

package/dist/skeleton/index.d.ts

@@ -0,0 +1,5 @@
+export { Skeleton, type SkeletonProps } from "../components/skeleton";
+export { SkeletonProvider, SkeletonGroup, type SkeletonProviderProps } from "./provider";
+export { useCascadeIndex, useSkeletonContext, SkeletonContext, type SkeletonTier, type SkeletonContextValue, } from "./stagger";
+export { Loader, type LoaderProps, type LoaderQueryLike } from "./loader";
+//# sourceMappingURL=index.d.ts.map

package/dist/skeleton/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skeleton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/skeleton/index.js

@@ -0,0 +1,5 @@
+export { Skeleton } from "../components/skeleton";
+export { SkeletonProvider, SkeletonGroup } from "./provider";
+export { useCascadeIndex, useSkeletonContext, SkeletonContext, } from "./stagger";
+export { Loader } from "./loader";
+//# sourceMappingURL=index.js.map

package/dist/skeleton/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skeleton/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsB,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAA8B,MAAM,YAAY,CAAC;AACzF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,eAAe,GAGhB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAA0C,MAAM,UAAU,CAAC"}

package/dist/skeleton/loader.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+export interface LoaderQueryLike<T> {
+    data?: T;
+    isLoading: boolean;
+    isFetching: boolean;
+    error?: unknown;
+}
+export interface LoaderProps<T> {
+    query: LoaderQueryLike<T>;
+    fallback: React.ReactNode;
+    errorFallback?: (error: unknown) => React.ReactNode;
+    children: (data: T) => React.ReactNode;
+}
+export declare function Loader<T>({ query, fallback, errorFallback, children }: LoaderProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=loader.d.ts.map

package/dist/skeleton/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skeleton/loader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAC;IACpD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;CACxC;AAWD,wBAAgB,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,2CAarF"}

package/dist/skeleton/loader.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { SkeletonGroup } from "./provider";
+function DefaultErrorCard({ error }) {
+    const message = error instanceof Error ? error.message : String(error);
+    return (_jsx("div", { role: "alert", className: "rounded-md border border-destructive/40 bg-destructive/5 p-4 text-sm text-destructive", children: message }));
+}
+export function Loader({ query, fallback, errorFallback, children }) {
+    if (query.isLoading) {
+        return _jsx(SkeletonGroup, { children: fallback });
+    }
+    if (query.error) {
+        return _jsx(_Fragment, { children: errorFallback ? errorFallback(query.error) : _jsx(DefaultErrorCard, { error: query.error }) });
+    }
+    const isRefetch = query.isFetching && !query.isLoading;
+    const content = children(query.data);
+    if (isRefetch) {
+        return _jsx("div", { "data-refetch-pulse": "", children: content });
+    }
+    return _jsx(_Fragment, { children: content });
+}
+//# sourceMappingURL=loader.js.map

package/dist/skeleton/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/skeleton/loader.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgB3C,SAAS,gBAAgB,CAAC,EAAE,KAAK,EAAsB;IACrD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CACL,cAAK,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,uFAAuF,YAChH,OAAO,GACJ,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAkB;IACpF,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,KAAC,aAAa,cAAE,QAAQ,GAAiB,CAAC;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,4BAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAC,gBAAgB,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAI,GAAI,CAAC;IACtG,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IACvD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAS,CAAC,CAAC;IAC1C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,oCAAwB,EAAE,YAAE,OAAO,GAAO,CAAC;IACpD,CAAC;IACD,OAAO,4BAAG,OAAO,GAAI,CAAC;AACxB,CAAC"}

package/dist/skeleton/loader.stories.d.ts

@@ -0,0 +1,16 @@
+import type { StoryObj } from "@storybook/react-vite";
+declare const meta: {
+    title: string;
+    component: import("react").FC<Record<string, never>>;
+    tags: string[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const InitialLoading: Story;
+export declare const Refetching: Story;
+export declare const Ready: Story;
+export declare const Errored: Story;
+//# sourceMappingURL=loader.stories.d.ts.map

package/dist/skeleton/loader.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.stories.d.ts","sourceRoot":"","sources":["../../src/skeleton/loader.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,QAAA,MAAM,IAAI;;;;;;;CAK0B,CAAC;AAErC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAUnC,eAAO,MAAM,cAAc,EAAE,KAS5B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAcxB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAcnB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KASrB,CAAC"}

package/dist/skeleton/loader.stories.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Loader } from "./loader";
+import { Skeleton } from "../components/skeleton";
+// Storybook cannot infer generic component props directly.
+// Cast to a no-arg function component so stories don't require `args`.
+const LoaderStory = Loader;
+const meta = {
+    title: "Skeleton/Loader",
+    component: LoaderStory,
+    tags: ["autodocs"],
+    parameters: { layout: "centered" },
+};
+export default meta;
+const fallback = (_jsxs("div", { className: "flex w-64 flex-col gap-2", children: [_jsx(Skeleton, { tier: "data", className: "h-4 w-full" }), _jsx(Skeleton, { tier: "data", className: "h-4 w-3/4" }), _jsx(Skeleton, { tier: "data", className: "h-4 w-1/2" })] }));
+export const InitialLoading = {
+    render: () => (_jsx(Loader, { query: { data: undefined, isLoading: true, isFetching: true }, fallback: fallback, children: () => _jsx("div", { children: "never shown" }) })),
+};
+export const Refetching = {
+    render: () => (_jsx(Loader, { query: { data: { total: 42 }, isLoading: false, isFetching: true }, fallback: fallback, children: (d) => (_jsxs("div", { className: "rounded-md border bg-card p-4", children: [_jsx("div", { className: "text-xs font-semibold uppercase text-muted-foreground", children: "Total" }), _jsx("div", { className: "text-2xl font-bold", children: d.total })] })) })),
+};
+export const Ready = {
+    render: () => (_jsx(Loader, { query: { data: { total: 42 }, isLoading: false, isFetching: false }, fallback: fallback, children: (d) => (_jsxs("div", { className: "rounded-md border bg-card p-4", children: [_jsx("div", { className: "text-xs font-semibold uppercase text-muted-foreground", children: "Total" }), _jsx("div", { className: "text-2xl font-bold", children: d.total })] })) })),
+};
+export const Errored = {
+    render: () => (_jsx(Loader, { query: { data: undefined, isLoading: false, isFetching: false, error: new Error("Failed to fetch stats") }, fallback: fallback, children: () => _jsx("div", { children: "never shown" }) })),
+};
+//# sourceMappingURL=loader.stories.js.map

package/dist/skeleton/loader.stories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.stories.js","sourceRoot":"","sources":["../../src/skeleton/loader.stories.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,2DAA2D;AAC3D,uEAAuE;AACvE,MAAM,WAAW,GAAG,MAAoD,CAAC;AAEzE,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,iBAAiB;IACxB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;CACA,CAAC;AAErC,eAAe,IAAI,CAAC;AAGpB,MAAM,QAAQ,GAAG,CACf,eAAK,SAAS,EAAC,0BAA0B,aACvC,KAAC,QAAQ,IAAC,IAAI,EAAC,MAAM,EAAC,SAAS,EAAC,YAAY,GAAG,EAC/C,KAAC,QAAQ,IAAC,IAAI,EAAC,MAAM,EAAC,SAAS,EAAC,WAAW,GAAG,EAC9C,KAAC,QAAQ,IAAC,IAAI,EAAC,MAAM,EAAC,SAAS,EAAC,WAAW,GAAG,IAC1C,CACP,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAU;IACnC,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,MAAM,IACL,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAC7D,QAAQ,EAAE,QAAQ,YAEjB,GAAG,EAAE,CAAC,wCAAsB,GACtB,CACV;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAU;IAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,MAAM,IACL,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAClE,QAAQ,EAAE,QAAQ,YAEjB,CAAC,CAAC,EAAE,EAAE,CAAC,CACN,eAAK,SAAS,EAAC,+BAA+B,aAC5C,cAAK,SAAS,EAAC,uDAAuD,sBAAY,EAClF,cAAK,SAAS,EAAC,oBAAoB,YAAE,CAAC,CAAC,KAAK,GAAO,IAC/C,CACP,GACM,CACV;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAU;IAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,MAAM,IACL,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EACnE,QAAQ,EAAE,QAAQ,YAEjB,CAAC,CAAC,EAAE,EAAE,CAAC,CACN,eAAK,SAAS,EAAC,+BAA+B,aAC5C,cAAK,SAAS,EAAC,uDAAuD,sBAAY,EAClF,cAAK,SAAS,EAAC,oBAAoB,YAAE,CAAC,CAAC,KAAK,GAAO,IAC/C,CACP,GACM,CACV;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAU;IAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,MAAM,IACL,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,uBAAuB,CAAC,EAAE,EAC1G,QAAQ,EAAE,QAAQ,YAEjB,GAAG,EAAE,CAAC,wCAAsB,GACtB,CACV;CACF,CAAC"}

package/dist/skeleton/provider.d.ts

@@ -0,0 +1,23 @@
+import * as React from "react";
+import { type SkeletonTier } from "./stagger";
+export interface SkeletonProviderProps {
+    tier?: SkeletonTier;
+    stagger?: number;
+    label?: string;
+    /**
+     * Whether this provider's wrapper should announce itself as a busy `role="status"`
+     * aria-live region. Default: `false` so wrapping a long-lived route in
+     * `<SkeletonProvider>` does not cause screen readers to announce "Loading" forever.
+     *
+     * Pass `isBusy={query.isLoading}` (or similar) to scope the announcement to the
+     * actual loading window. Pass `isBusy` statically as `true` only when the provider's
+     * scope is itself lifecycled with the loading state.
+     */
+    isBusy?: boolean;
+    children: React.ReactNode;
+}
+export declare function SkeletonProvider({ tier, stagger, label, isBusy, children, }: SkeletonProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function SkeletonGroup({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=provider.d.ts.map

package/dist/skeleton/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/skeleton/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAa,EACb,OAAa,EACb,KAAiB,EACjB,MAAc,EACd,QAAQ,GACT,EAAE,qBAAqB,2CA4BvB;AAED,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAaxE"}

package/dist/skeleton/provider.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { SkeletonContext, } from "./stagger";
+export function SkeletonProvider({ tier = "hero", stagger = 120, label = "Loading", isBusy = false, children, }) {
+    // useState with a lazy initializer yields a stable object reference for the
+    // lifetime of the provider without reading a ref's `.current` during render.
+    const [counterRef] = React.useState(() => ({ current: 0 }));
+    const value = React.useMemo(() => ({
+        tier,
+        stagger,
+        cascadeDisabled: false,
+        counterRef,
+        label,
+        hasProvider: true,
+    }), [tier, stagger, label, counterRef]);
+    return (_jsx(SkeletonContext, { value: value, children: isBusy ? (_jsx("div", { role: "status", "aria-live": "polite", "aria-busy": "true", "aria-label": label, children: children })) : (_jsx("div", { children: children })) }));
+}
+export function SkeletonGroup({ children }) {
+    const parent = React.use(SkeletonContext);
+    const [counterRef] = React.useState(() => ({ current: 0 }));
+    const value = React.useMemo(() => ({
+        ...parent,
+        counterRef,
+    }), [parent, counterRef]);
+    return _jsx(SkeletonContext, { value: value, children: children });
+}
+//# sourceMappingURL=provider.js.map

package/dist/skeleton/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/skeleton/provider.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EACL,eAAe,GAGhB,MAAM,WAAW,CAAC;AAmBnB,MAAM,UAAU,gBAAgB,CAAC,EAC/B,IAAI,GAAG,MAAM,EACb,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,SAAS,EACjB,MAAM,GAAG,KAAK,EACd,QAAQ,GACc;IACtB,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CACzB,GAAG,EAAE,CAAC,CAAC;QACL,IAAI;QACJ,OAAO;QACP,eAAe,EAAE,KAAK;QACtB,UAAU;QACV,KAAK;QACL,WAAW,EAAE,IAAI;KAClB,CAAC,EACF,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CACnC,CAAC;IAEF,OAAO,CACL,KAAC,eAAe,IAAC,KAAK,EAAE,KAAK,YAC1B,MAAM,CAAC,CAAC,CAAC,CACR,cAAK,IAAI,EAAC,QAAQ,eAAW,QAAQ,eAAW,MAAM,gBAAa,KAAK,YACrE,QAAQ,GACL,CACP,CAAC,CAAC,CAAC,CACF,wBAAM,QAAQ,GAAO,CACtB,GACe,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAiC;IACvE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1C,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CACzB,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,MAAM;QACT,UAAU;KACX,CAAC,EACF,CAAC,MAAM,EAAE,UAAU,CAAC,CACrB,CAAC;IAEF,OAAO,KAAC,eAAe,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAmB,CAAC;AACrE,CAAC"}

package/dist/skeleton/stagger.d.ts

@@ -0,0 +1,30 @@
+import * as React from "react";
+export type SkeletonTier = "hero" | "data" | "inline";
+export interface SkeletonContextValue {
+    tier: SkeletonTier;
+    stagger: number;
+    cascadeDisabled: boolean;
+    counterRef: {
+        current: number;
+    };
+    label: string;
+    hasProvider: boolean;
+}
+export declare const SkeletonContext: React.Context<SkeletonContextValue>;
+export declare function useSkeletonContext(): SkeletonContextValue;
+/**
+ * Allocates a stable cascade index for the calling component, bumping the
+ * surrounding provider's counter exactly once per mounted instance.
+ *
+ * Implementation note: uses `useRef` rather than `useState` lazy initializer
+ * because React 18+ StrictMode invokes `useState` initializers twice in dev,
+ * which would double-bump the provider counter and produce indices
+ * 0, 2, 4, 6, ... for three sibling probes. A ref persists across the paired
+ * dev invocations, so the first-render guard (`ref.current === undefined`)
+ * ensures the counter increments exactly once per component.
+ *
+ * This hook intentionally reads/writes refs during render to coordinate
+ * sibling ordering — verified by tests in ./__tests__/provider.test.tsx.
+ */
+export declare function useCascadeIndex(): number;
+//# sourceMappingURL=stagger.d.ts.map

package/dist/skeleton/stagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagger.d.ts","sourceRoot":"","sources":["../../src/skeleton/stagger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACtB;AAWD,eAAO,MAAM,eAAe,qCAC+B,CAAC;AAE5D,wBAAgB,kBAAkB,IAAI,oBAAoB,CAEzD;AAED;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,eAAe,IAAI,MAAM,CAaxC"}

package/dist/skeleton/stagger.js

@@ -0,0 +1,45 @@
+import * as React from "react";
+const defaultContext = {
+    tier: "inline",
+    stagger: 0,
+    cascadeDisabled: true,
+    counterRef: { current: 0 },
+    label: "Loading",
+    hasProvider: false,
+};
+export const SkeletonContext = React.createContext(defaultContext);
+export function useSkeletonContext() {
+    return React.use(SkeletonContext);
+}
+/**
+ * Allocates a stable cascade index for the calling component, bumping the
+ * surrounding provider's counter exactly once per mounted instance.
+ *
+ * Implementation note: uses `useRef` rather than `useState` lazy initializer
+ * because React 18+ StrictMode invokes `useState` initializers twice in dev,
+ * which would double-bump the provider counter and produce indices
+ * 0, 2, 4, 6, ... for three sibling probes. A ref persists across the paired
+ * dev invocations, so the first-render guard (`ref.current === undefined`)
+ * ensures the counter increments exactly once per component.
+ *
+ * This hook intentionally reads/writes refs during render to coordinate
+ * sibling ordering — verified by tests in ./__tests__/provider.test.tsx.
+ */
+/* eslint-disable react-hooks/refs */
+export function useCascadeIndex() {
+    const ctx = React.use(SkeletonContext);
+    const { counterRef } = ctx;
+    const ref = React.useRef(undefined);
+    if (ref.current === undefined) {
+        if (!ctx.hasProvider || ctx.cascadeDisabled) {
+            ref.current = 0;
+        }
+        else {
+            ref.current = counterRef.current;
+            counterRef.current += 1;
+        }
+    }
+    return ref.current;
+}
+/* eslint-enable react-hooks/refs */
+//# sourceMappingURL=stagger.js.map

package/dist/skeleton/stagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagger.js","sourceRoot":"","sources":["../../src/skeleton/stagger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,MAAM,cAAc,GAAyB;IAC3C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,IAAI;IACrB,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;IAC1B,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAC1B,KAAK,CAAC,aAAa,CAAuB,cAAc,CAAC,CAAC;AAE5D,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,qCAAqC;AACrC,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;IAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAqB,SAAS,CAAC,CAAC;IACxD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;YAC5C,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;YACjC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AACD,oCAAoC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cellarnode/ui",
-  "version": "0.16.9",
+  "version": "0.17.3",
   "type": "module",
   "private": false,
   "description": "Shared UI components, theme tokens, and chat/offer primitives for CellarNode dashboards.",