@praxisjs/storybook 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/preset.test.d.ts

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

package/dist/__tests__/preset.test.d.ts.map

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

package/dist/__tests__/preset.test.js

@@ -0,0 +1,104 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+const mockPraxisPlugin = vi.hoisted(() => vi.fn(() => ({ name: "praxisjs" })));
+vi.mock("@praxisjs/vite-plugin", () => ({ default: mockPraxisPlugin }));
+const mockReadFileSync = vi.hoisted(() => vi.fn());
+vi.mock("node:fs", () => ({ readFileSync: mockReadFileSync }));
+import { viteFinal, core, managerEntries } from "../preset";
+beforeEach(() => {
+    vi.clearAllMocks();
+    mockPraxisPlugin.mockReturnValue({ name: "praxisjs" });
+});
+// ── viteFinal ─────────────────────────────────────────────────────────────────
+describe("viteFinal()", () => {
+    it("returns the config object", () => {
+        const config = {};
+        expect(viteFinal(config)).toBe(config);
+    });
+    it("adds the praxisjs vite plugin", () => {
+        const config = {};
+        viteFinal(config);
+        expect(mockPraxisPlugin).toHaveBeenCalledWith({ hmr: true });
+        const plugins = config.plugins;
+        expect(plugins.some((p) => p.name === "praxisjs")).toBe(true);
+    });
+    it("adds the story-source plugin", () => {
+        const config = {};
+        viteFinal(config);
+        const plugins = config.plugins;
+        expect(plugins.some((p) => p.name === "praxisjs-story-source")).toBe(true);
+    });
+    it("preserves existing plugins", () => {
+        const existing = { name: "existing" };
+        const config = { plugins: [existing] };
+        viteFinal(config);
+        const plugins = config.plugins;
+        expect(plugins[0]).toBe(existing);
+    });
+    it("handles missing plugins array gracefully", () => {
+        expect(() => viteFinal({})).not.toThrow();
+        expect(() => viteFinal({ plugins: null })).not.toThrow();
+    });
+});
+// ── core ──────────────────────────────────────────────────────────────────────
+describe("core", () => {
+    it("specifies @storybook/builder-vite as the builder", () => {
+        expect(core.builder).toBe("@storybook/builder-vite");
+    });
+});
+// ── managerEntries ────────────────────────────────────────────────────────────
+describe("managerEntries()", () => {
+    it("appends the manager entry to the default empty array", () => {
+        const result = managerEntries();
+        expect(result).toHaveLength(1);
+        expect(result[0]).toContain("manager.jsx");
+    });
+    it("prepends existing entries before the manager entry", () => {
+        const result = managerEntries(["/some/entry.js"]);
+        expect(result[0]).toBe("/some/entry.js");
+        expect(result[1]).toContain("manager.jsx");
+    });
+});
+// ── storySourcePlugin transform ───────────────────────────────────────────────
+describe("storySourcePlugin — transform()", () => {
+    function getTransform() {
+        const config = {};
+        viteFinal(config);
+        const plugins = config.plugins;
+        return plugins.find((p) => p.name === "praxisjs-story-source").transform;
+    }
+    it("returns null for non-story files", () => {
+        const transform = getTransform();
+        expect(transform("const x = 1;", "/src/app.ts")).toBeNull();
+        expect(transform("const x = 1;", "/src/component.tsx")).toBeNull();
+    });
+    it("returns null when readFileSync throws", () => {
+        mockReadFileSync.mockImplementation(() => { throw new Error("ENOENT"); });
+        const transform = getTransform();
+        const result = transform("code", "/src/foo.stories.tsx");
+        expect(result).toBeNull();
+    });
+    it("returns null when there is no `export default` statement", () => {
+        mockReadFileSync.mockReturnValue("const x = 1;");
+        const transform = getTransform();
+        const result = transform("const x = 1;", "/src/foo.stories.tsx");
+        expect(result).toBeNull();
+    });
+    it("injects storySource metadata for a valid story file", () => {
+        const source = "const MyStories = {};\nexport default MyStories;";
+        mockReadFileSync.mockReturnValue(source);
+        const transform = getTransform();
+        const result = transform(source, "/src/foo.stories.tsx");
+        expect(result).not.toBeNull();
+        expect(result.map).toBeNull();
+        expect(result.code).toContain("storySource");
+        expect(result.code).toContain("export default MyStories;");
+    });
+    it("matches story files with query strings (e.g. Vite HMR)", () => {
+        const source = "const S = {};\nexport default S;";
+        mockReadFileSync.mockReturnValue(source);
+        const transform = getTransform();
+        const result = transform(source, "/src/foo.stories.ts?t=123");
+        expect(result).not.toBeNull();
+    });
+});
+//# sourceMappingURL=preset.test.js.map

package/dist/__tests__/preset.test.js.map

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

package/dist/__tests__/render.test.d.ts

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

package/dist/__tests__/render.test.d.ts.map

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

package/dist/__tests__/render.test.js

@@ -0,0 +1,73 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach } from "vitest";
+vi.mock("@praxisjs/runtime", () => ({
+    render: vi.fn(() => vi.fn()), // returns a no-op cleanup
+}));
+import { render as praxisRender } from "@praxisjs/runtime";
+import { renderToCanvas } from "../render";
+const mockRender = vi.mocked(praxisRender);
+function makeContext(overrides = {}) {
+    return {
+        storyFn: vi.fn(() => document.createTextNode("story")),
+        showMain: vi.fn(),
+        forceRemount: false,
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    vi.clearAllMocks();
+    mockRender.mockReturnValue(vi.fn());
+});
+describe("renderToCanvas()", () => {
+    it("calls showMain()", async () => {
+        const ctx = makeContext();
+        const el = document.createElement("div");
+        await renderToCanvas(ctx, el);
+        expect(ctx.showMain).toHaveBeenCalledOnce();
+    });
+    it("calls praxisRender with a thunk and the canvas element", async () => {
+        const ctx = makeContext();
+        const el = document.createElement("div");
+        await renderToCanvas(ctx, el);
+        expect(mockRender).toHaveBeenCalledOnce();
+        expect(mockRender).toHaveBeenCalledWith(expect.any(Function), el);
+    });
+    it("the thunk passed to praxisRender invokes storyFn", async () => {
+        const ctx = makeContext();
+        const el = document.createElement("div");
+        await renderToCanvas(ctx, el);
+        const thunk = mockRender.mock.calls[0][0];
+        thunk();
+        expect(ctx.storyFn).toHaveBeenCalledOnce();
+    });
+    it("returns a resolved Promise", async () => {
+        const ctx = makeContext();
+        const el = document.createElement("div");
+        const result = renderToCanvas(ctx, el);
+        expect(result).toBeInstanceOf(Promise);
+        await expect(result).resolves.toBeUndefined();
+    });
+    it("forceRemount=false does not call the previous cleanup", async () => {
+        const cleanup = vi.fn();
+        mockRender.mockReturnValue(cleanup);
+        const el = document.createElement("div");
+        await renderToCanvas(makeContext({ forceRemount: false }), el);
+        await renderToCanvas(makeContext({ forceRemount: false }), el);
+        expect(cleanup).not.toHaveBeenCalled();
+    });
+    it("forceRemount=true calls and clears the previous cleanup", async () => {
+        const cleanup = vi.fn();
+        mockRender.mockReturnValue(cleanup);
+        const el = document.createElement("div");
+        // First render — establishes a cleanup
+        await renderToCanvas(makeContext({ forceRemount: false }), el);
+        // Second render with forceRemount — should call the previous cleanup
+        await renderToCanvas(makeContext({ forceRemount: true }), el);
+        expect(cleanup).toHaveBeenCalledOnce();
+    });
+    it("forceRemount=true with no prior cleanup does not throw", async () => {
+        const el = document.createElement("div");
+        await expect(renderToCanvas(makeContext({ forceRemount: true }), el)).resolves.toBeUndefined();
+    });
+});
+//# sourceMappingURL=render.test.js.map

package/dist/__tests__/render.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.test.js","sourceRoot":"","sources":["../../src/__tests__/render.test.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,0BAA0B;CACzD,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,UAAU,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAE3C,SAAS,WAAW,CAAC,YAIhB,EAAE;IACL,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACtD,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;QACjB,YAAY,EAAE,KAAK;QACnB,GAAG,SAAS;KAC2B,CAAC;AAC5C,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACnB,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAChC,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,cAAc,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,cAAc,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,cAAc,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAkB,CAAC;QAC3D,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEpC,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,cAAc,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,cAAc,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEpC,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,uCAAuC;QACvC,MAAM,cAAc,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAE/D,qEAAqE;QACrE,MAAM,cAAc,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAE9D,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,MAAM,CACV,cAAc,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACxD,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { renderToCanvas } from "./render";
+export type { PraxisRenderer, Meta, StoryObj, StorybookConfig } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { renderToCanvas } from "./render";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/preset.d.ts

@@ -0,0 +1,6 @@
+export declare function viteFinal(config: Record<string, any>): Record<string, any>;
+export declare const core: {
+    builder: string;
+};
+export declare function managerEntries(entries?: string[]): string[];
+//# sourceMappingURL=preset.d.ts.map

package/dist/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AA+BA,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAO1E;AAED,eAAO,MAAM,IAAI;;CAEhB,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAE/D"}

package/dist/preset.js

@@ -0,0 +1,46 @@
+import { readFileSync } from "node:fs";
+import praxisjs from "@praxisjs/vite-plugin";
+function storySourcePlugin() {
+    return {
+        name: "praxisjs-story-source",
+        enforce: "post",
+        transform(code, id) {
+            if (!(/\.stories\.(tsx?|jsx?)($|\?)/.exec(id)))
+                return null;
+            const filePath = id.split("?")[0];
+            let originalSource;
+            try {
+                originalSource = readFileSync(filePath, "utf-8");
+            }
+            catch {
+                return null;
+            }
+            const source = JSON.stringify(originalSource);
+            const exportMatch = /export default (\w+);/.exec(code);
+            if (!exportMatch)
+                return null;
+            const metaVar = exportMatch[1];
+            const injection = `\n${metaVar}.parameters = {\n  ...${metaVar}.parameters,\n  storySource: { source: ${source} },\n};`;
+            return {
+                code: code.replace(`export default ${metaVar};`, `${injection}\nexport default ${metaVar};`),
+                map: null,
+            };
+        },
+    };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function viteFinal(config) {
+    config.plugins = [
+        ...(config.plugins ?? []),
+        praxisjs({ hmr: true }),
+        storySourcePlugin(),
+    ];
+    return config;
+}
+export const core = {
+    builder: "@storybook/builder-vite",
+};
+export function managerEntries(entries = []) {
+    return [...entries, new URL("../manager.jsx", import.meta.url).pathname];
+}
+//# sourceMappingURL=preset.js.map

package/dist/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,QAAQ,MAAM,uBAAuB,CAAC;AAE7C,SAAS,iBAAiB;IACxB,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,MAAe;QACxB,SAAS,CAAC,IAAY,EAAE,EAAU;YAChC,IAAI,CAAC,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5D,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,cAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,cAAc,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvD,IAAI,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAC;YAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,SAAS,GAAG,KAAK,OAAO,yBAAyB,OAAO,0CAA0C,MAAM,SAAS,CAAC;YACxH,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,OAAO,GAAG,EAAE,GAAG,SAAS,oBAAoB,OAAO,GAAG,CAAC;gBAC5F,GAAG,EAAE,IAAI;aACV,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,MAA2B;IACnD,MAAM,CAAC,OAAO,GAAG;QACf,GAAG,CAAE,MAAM,CAAC,OAAiC,IAAI,EAAE,CAAC;QACpD,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACvB,iBAAiB,EAAE;KACpB,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,OAAO,EAAE,yBAAyB;CACnC,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,UAAoB,EAAE;IACnD,OAAO,CAAC,GAAG,OAAO,EAAE,IAAI,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC3E,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,3 @@
+import type { RenderContext } from "@storybook/core/types";
+export declare function renderToCanvas({ storyFn, showMain, forceRemount }: RenderContext, canvasElement: HTMLElement): Promise<void>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D,wBAAgB,cAAc,CAC5B,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,aAAa,EAClD,aAAa,EAAE,WAAW,GACzB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/render.js

@@ -0,0 +1,12 @@
+import { render as praxisRender } from "@praxisjs/runtime";
+let cleanup;
+export function renderToCanvas({ storyFn, showMain, forceRemount }, canvasElement) {
+    if (forceRemount) {
+        cleanup?.();
+        cleanup = undefined;
+    }
+    showMain();
+    cleanup = praxisRender(() => storyFn(), canvasElement);
+    return Promise.resolve();
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAK3D,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,cAAc,CAC5B,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAiB,EAClD,aAA0B;IAE1B,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,GAAG,SAAS,CAAC;IACtB,CAAC;IAED,QAAQ,EAAE,CAAC;IAEX,OAAO,GAAG,YAAY,CACpB,GAAG,EAAE,CAAC,OAAO,EAAqB,EAClC,aAAa,CACd,CAAC;IAEF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+import type { ComponentAnnotations, StoryAnnotations } from "@storybook/core/csf";
+import type { WebRenderer } from "@storybook/core/types";
+export interface PraxisRenderer extends WebRenderer {
+    canvasElement: HTMLElement;
+    component: new (...args: any[]) => unknown;
+    storyResult: Node | Node[] | null | undefined;
+}
+export type Meta<T = any> = ComponentAnnotations<PraxisRenderer, T>;
+export type StoryObj<T = any> = StoryAnnotations<PraxisRenderer, T>;
+export interface StorybookConfig {
+    stories: string[];
+    addons?: string[];
+    framework: {
+        name: string;
+        options?: Record<string, unknown>;
+    };
+    docs?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,aAAa,EAAE,WAAW,CAAC;IAE3B,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IAC3C,WAAW,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CAC/C;AAGD,MAAM,MAAM,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,oBAAoB,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;AAGpE,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,GAAG,IAAI,gBAAgB,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/manager.jsx

@@ -0,0 +1,178 @@
+import React, { useEffect, useRef, useState } from "react";
+import { addons, types, useParameter } from "storybook/internal/manager-api";
+
+// ─── One Dark theme ──────────────────────────────────────────────────────────
+
+const CSS = `
+.prax-panel {
+  background: #282c34;
+  color: #abb2bf;
+  font-family: 'JetBrains Mono', 'Fira Code', Consolas, monospace;
+  font-size: 13px;
+  line-height: 1.65;
+  margin: 0;
+  padding: 20px 24px;
+  white-space: pre;
+  tab-size: 2;
+  box-sizing: border-box;
+}
+.prax-panel .kw { color: #c678dd; }
+.prax-panel .dc { color: #e5c07b; font-weight: 600; }
+.prax-panel .st { color: #98c379; }
+.prax-panel .cm { color: #5c6370; font-style: italic; }
+.prax-panel .nm { color: #e5c07b; }
+.prax-panel .fn { color: #61afef; }
+.prax-panel .nb { color: #d19a66; }
+.prax-panel .rx { color: #56b6c2; }
+.prax-panel .op { color: #abb2bf; }
+.prax-panel .no-src {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  color: #5c6370;
+  font-family: sans-serif;
+  font-size: 13px;
+}
+`;
+
+// ─── Tokenizer ────────────────────────────────────────────────────────────────
+
+const KEYWORDS = new Set([
+  "import","export","from","default","class","extends","implements",
+  "interface","type","enum","const","let","var","function","async","await",
+  "return","if","else","for","while","do","switch","case","break","continue",
+  "new","this","super","static","public","private","protected","readonly",
+  "abstract","declare","namespace","module","as","typeof","instanceof","in",
+  "of","null","undefined","true","false","void","never","any","unknown",
+  "string","number","boolean","object","infer","keyof","satisfies",
+]);
+
+const PATTERNS = [
+  // multi-line comment
+  { type: "cm", re: /^(\/\*[\s\S]*?\*\/)/ },
+  // single-line comment
+  { type: "cm", re: /^(\/\/[^\n]*)/ },
+  // template literal
+  { type: "st", re: /^(`(?:\\[\s\S]|[^`\\])*`)/ },
+  // string
+  { type: "st", re: /^((?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'))/ },
+  // decorator
+  { type: "dc", re: /^(@[A-Za-z_$][A-Za-z0-9_$]*)/ },
+  // identifier — classified below
+  { type: "id", re: /^([A-Za-z_$][A-Za-z0-9_$]*)/ },
+  // number
+  { type: "nb", re: /^(0x[\da-fA-F]+|\d+(?:\.\d+)?)/ },
+  // single char fallback
+  { type: null, re: /^([\s\S])/ },
+];
+
+function esc(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+function tokenize(code) {
+  let out = "";
+  let i = 0;
+  while (i < code.length) {
+    const slice = code.slice(i);
+    let matched = false;
+    for (const { type, re } of PATTERNS) {
+      const m = slice.match(re);
+      if (!m) continue;
+      const text = m[1];
+      i += text.length;
+      if (type === null) { out += esc(text); matched = true; break; }
+      if (type === "id") {
+        if (KEYWORDS.has(text)) {
+          out += `<span class="kw">${esc(text)}</span>`;
+        } else if (/^[A-Z]/.test(text)) {
+          out += `<span class="nm">${esc(text)}</span>`;
+        } else if (code[i] === "(") {
+          out += `<span class="fn">${esc(text)}</span>`;
+        } else {
+          out += esc(text);
+        }
+        matched = true;
+        break;
+      }
+      out += `<span class="${type}">${esc(text)}</span>`;
+      matched = true;
+      break;
+    }
+    if (!matched) { out += esc(code[i]); i++; }
+  }
+  return out;
+}
+
+// ─── Panel component ──────────────────────────────────────────────────────────
+
+const PANEL_ID = "praxisjs/source";
+
+function SourcePanel({ active }) {
+  const storySource = useParameter("storySource", {});
+  const source = storySource?.source ?? "";
+  const rootRef = useRef(null);
+  const [height, setHeight] = useState(0);
+
+  useEffect(() => {
+    if (document.getElementById("prax-panel-css")) return;
+    const el = document.createElement("style");
+    el.id = "prax-panel-css";
+    el.textContent = CSS;
+    document.head.appendChild(el);
+  }, []);
+
+  // Observe the parent panel container to get its height
+  useEffect(() => {
+    const el = rootRef.current;
+    if (!el) return;
+    const parent = el.parentElement;
+    if (!parent) return;
+    const ro = new ResizeObserver(([entry]) => {
+      setHeight(entry.contentRect.height);
+    });
+    ro.observe(parent);
+    setHeight(parent.getBoundingClientRect().height);
+    return () => ro.disconnect();
+  }, [active]);
+
+  if (!active) return null;
+
+  const wrapperStyle = {
+    width: "100%",
+    height: height || "auto",
+    overflow: "auto",
+  };
+
+  if (!source) {
+    return (
+      <div ref={rootRef} style={wrapperStyle}>
+        <pre className="prax-panel">
+          <span className="no-src">No source available for this story.</span>
+        </pre>
+      </div>
+    );
+  }
+
+  return (
+    <div ref={rootRef} style={wrapperStyle}>
+      <pre
+        className="prax-panel"
+        dangerouslySetInnerHTML={{ __html: tokenize(source) }}
+      />
+    </div>
+  );
+}
+
+// ─── Register ─────────────────────────────────────────────────────────────────
+
+addons.register(PANEL_ID, () => {
+  addons.add(`${PANEL_ID}/panel`, {
+    type: types.PANEL,
+    title: "Code",
+    render: ({ active }) => (
+      <SourcePanel key={PANEL_ID} active={active} />
+    ),
+  });
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@praxisjs/storybook",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Storybook framework adapter for PraxisJS",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./preset": {
+      "types": "./dist/preset.d.ts",
+      "import": "./dist/preset.js"
+    }
+  },
+  "files": [
+    "dist",
+    "manager.jsx"
+  ],
+  "dependencies": {
+    "@praxisjs/runtime": "0.2.16",
+    "@praxisjs/vite-plugin": "0.1.1"
+  },
+  "peerDependencies": {
+    "@storybook/builder-vite": ">=8.0.0",
+    "@storybook/core": ">=8.0.0",
+    "storybook": ">=8.0.0"
+  },
+  "devDependencies": {
+    "@storybook/builder-vite": "^10.4.0",
+    "@storybook/core": "^8.6.0",
+    "storybook": "^10.4.0",
+    "typescript": "^5.9.3",
+    "vite": "^6.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}