@cellarnode/ui 0.16.8 → 0.17.1

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,78 @@
+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("wraps children in role=status with aria-live=polite and aria-busy=true", () => {
+        render(_jsx(SkeletonProvider, { label: "Loading dashboard", 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();
+    });
+});
+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,13 @@
+import * as React from "react";
+import { type SkeletonTier } from "./stagger";
+export interface SkeletonProviderProps {
+    tier?: SkeletonTier;
+    stagger?: number;
+    label?: string;
+    children: React.ReactNode;
+}
+export declare function SkeletonProvider({ tier, stagger, label, 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,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAa,EACb,OAAa,EACb,KAAiB,EACjB,QAAQ,GACT,EAAE,qBAAqB,2CAwBvB;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", 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: _jsx("div", { role: "status", "aria-live": "polite", "aria-busy": "true", "aria-label": label, 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;AASnB,MAAM,UAAU,gBAAgB,CAAC,EAC/B,IAAI,GAAG,MAAM,EACb,OAAO,GAAG,GAAG,EACb,KAAK,GAAG,SAAS,EACjB,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,YAC3B,cAAK,IAAI,EAAC,QAAQ,eAAW,QAAQ,eAAW,MAAM,gBAAa,KAAK,YACrE,QAAQ,GACL,GACU,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.8",
+  "version": "0.17.1",
   "type": "module",
   "private": false,
   "description": "Shared UI components, theme tokens, and chat/offer primitives for CellarNode dashboards.",

package/src/theme/tokens.css

@@ -61,6 +61,12 @@
   --color-sidebar-border: var(--sidebar-border);
   --color-sidebar-ring: var(--sidebar-ring);
 
+  /* Skeleton tokens (Phase 0: orchestrated loading system) */
+  --color-skeleton-base: var(--color-muted);
+  --color-skeleton-shimmer: var(--color-muted);
+  --color-skeleton-shimmer-peak: color-mix(in oklch, var(--color-muted), white 35%);
+  --color-skeleton-accent: color-mix(in oklch, var(--color-primary) 40%, transparent);
+
   --radius-sm: calc(var(--radius) - 6px);
   --radius-md: calc(var(--radius) - 3px);
   --radius-lg: var(--radius);
@@ -516,6 +522,76 @@
   }
 }
 
+@keyframes skeleton-pulse {
+  0%, 100% { opacity: 0.65; }
+  50%      { opacity: 0.30; }
+}
+
+@keyframes skeleton-shimmer {
+  0%   { background-position: 150% 0; }
+  100% { background-position: -50% 0; }
+}
+
+@keyframes skeleton-cascade-enter {
+  from { opacity: 0; transform: translateY(6px); }
+  to   { opacity: 1; transform: translateY(0); }
+}
+
+@keyframes skeleton-refetch-pulse {
+  0%, 100% { opacity: 1; }
+  50%      { opacity: 0.7; }
+}
+
+/* ============================================================
+   Skeleton motion rules (Phase 0)
+   Selectors match data-attrs emitted by ui/src/skeleton primitives.
+   ============================================================ */
+
+[data-skeleton] {
+  border-radius: var(--radius-sm);
+  background: var(--color-skeleton-base);
+}
+
+[data-skeleton][data-tier="inline"] {
+  animation: skeleton-pulse 1.8s ease-in-out infinite;
+}
+
+[data-skeleton][data-tier="data"] {
+  background: linear-gradient(
+    100deg,
+    var(--color-skeleton-shimmer) 25%,
+    var(--color-skeleton-shimmer-peak) 50%,
+    var(--color-skeleton-shimmer) 75%
+  );
+  background-size: 200% 100%;
+  animation: skeleton-shimmer 1.5s ease-in-out infinite;
+}
+
+[data-skeleton][data-tier="hero"] {
+  background: linear-gradient(
+    100deg,
+    var(--color-skeleton-shimmer) 25%,
+    var(--color-skeleton-shimmer-peak) 48%,
+    var(--color-skeleton-accent) 52%,
+    var(--color-skeleton-shimmer) 75%
+  );
+  background-size: 200% 100%;
+  animation: skeleton-shimmer 1.8s ease-in-out infinite;
+  animation-delay: var(--skeleton-delay, 0ms);
+}
+
+[data-skeleton-card][data-tier="hero"] {
+  opacity: 0;
+  transform: translateY(6px);
+  animation: skeleton-cascade-enter 500ms ease-out forwards;
+  animation-delay: var(--skeleton-delay, 0ms);
+  isolation: isolate;
+}
+
+[data-refetch-pulse] {
+  animation: skeleton-refetch-pulse 1.5s ease-in-out infinite;
+}
+
 @media (prefers-reduced-motion: reduce) {
   *,
   *::before,
@@ -525,4 +601,21 @@
     transition-duration: 0.01ms !important;
     scroll-behavior: auto !important;
   }
+
+  [data-skeleton] {
+    animation: none !important;
+    background: var(--color-muted) !important;
+    opacity: 0.7;
+  }
+
+  [data-skeleton-card] {
+    animation: none !important;
+    opacity: 1 !important;
+    transform: none !important;
+  }
+
+  [data-refetch-pulse] {
+    animation: none !important;
+    opacity: 1 !important;
+  }
 }