poveste 0.1.3 → 0.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/node/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,aAAa,EAEd,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAkB3C,wBAAgB,gBAAgB,IAAI,aAAa,CA2HhD;AAED,eAAO,MAAM,eAAe,UAU3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAexF;AAED,eAAO,MAAM,gBAAgB;;;;;;;;qIAK3B,CAAA;AAEF,eAAO,MAAM,WAAW;;;;;;;;qIA8DtB,CAAA;AAEF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAsB,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAa7H;AA2BD,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,iBAoE/C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,0BAE1D;AAED,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,UAAU;QAClB;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;QAChC;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;KAClC;CACF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/node/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,aAAa,EAEd,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAkB3C,wBAAgB,gBAAgB,IAAI,aAAa,CA4HhD;AAED,eAAO,MAAM,eAAe,UAU3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAexF;AAED,eAAO,MAAM,gBAAgB;;;;;;;;qIAK3B,CAAA;AAEF,eAAO,MAAM,WAAW;;;;;;;;qIA8DtB,CAAA;AAEF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAsB,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAa7H;AA2BD,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,iBAoE/C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,0BAE1D;AAED,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,UAAU;QAClB;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;QAChC;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;KAClC;CACF"}

package/dist/node/config.js

@@ -26,6 +26,7 @@ export function getDefaultConfig() {
             '**/dist/**',
         ],
         supportMatch: [],
+        isolateStyles: true,
         tree: {
             file: 'title',
             order: 'asc',

package/dist/node/context.js

@@ -1,6 +1,6 @@
 import { resolveConfig as resolveViteConfig } from 'vite';
 import { processConfig, resolveConfig } from './config.js';
-import { mergeHistoireViteConfig } from './vite.js';
+import { mergePovesteViteConfig } from './vite.js';
 export async function createContext(options) {
     const config = await resolveConfig(process.cwd(), options.mode, options.configFile);
     const command = options.mode === 'dev' ? 'serve' : 'build';
@@ -16,7 +16,7 @@ export async function createContext(options) {
         markdownFiles: [],
         registeredCommands: [],
     };
-    ctx.resolvedViteConfig = await mergeHistoireViteConfig(viteConfig, ctx);
+    ctx.resolvedViteConfig = await mergePovesteViteConfig(viteConfig, ctx);
     await processConfig(ctx);
     // List commands
     for (const plugin of ctx.config.plugins) {

package/dist/node/dom/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/node/dom/env.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY;;;EAqD3B"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/node/dom/env.ts"],"names":[],"mappings":"AA+BA,wBAAgB,YAAY;;;EAqD3B"}

package/dist/node/dom/env.js

@@ -1,11 +1,36 @@
 import { JSDOM, VirtualConsole, } from 'jsdom';
 import { populateGlobal } from './util.js';
+// jsdom error types — not exported by jsdom.
+const JSDOM_ERROR_CSS_PARSING = 'css-parsing';
+const JSDOM_ERROR_UNHANDLED_EXCEPTION = 'unhandled-exception';
+// Directives JSDOM's CSS parser doesn't know — Tailwind v4's `@theme` is the
+// common one — make it emit a jsdomError per stylesheet, so collecting stories
+// from a Tailwind app prints "Could not parse CSS stylesheet" over and over.
+// The parser recovers on its own and keeps the valid rules, so the message is
+// pure noise: drop css-parsing errors, mirror jsdom's default forwardTo for
+// the rest.
+function createVirtualConsole() {
+    if (!console || !globalThis.console)
+        return undefined;
+    const virtualConsole = new VirtualConsole().forwardTo(globalThis.console, { jsdomErrors: 'none' });
+    virtualConsole.on('jsdomError', (err) => {
+        if (err.type === JSDOM_ERROR_CSS_PARSING)
+            return;
+        if (err.type === JSDOM_ERROR_UNHANDLED_EXCEPTION) {
+            globalThis.console.error(err.cause?.stack ?? err.message);
+        }
+        else {
+            globalThis.console.error(err.message);
+        }
+    });
+    return virtualConsole;
+}
 export function createDomEnv() {
     const dom = new JSDOM('<!DOCTYPE html>', {
         pretendToBeVisual: true,
         runScripts: 'dangerously',
         url: 'http://localhost:3000',
-        virtualConsole: console && globalThis.console ? new VirtualConsole().forwardTo(globalThis.console) : undefined,
+        virtualConsole: createVirtualConsole(),
         includeNodeLocations: false,
         contentType: 'text/html',
     });

package/dist/node/markdown.js

@@ -27,7 +27,7 @@ export async function createMarkdownRenderer(ctx) {
         langs: Object.keys(bundledLanguages), // not ideal but markdown-it does not provide async highlight
     });
     const md = new MarkdownIt({
-        highlight: (code, lang) => `<div class="htw-relative htw-not-prose __poveste-code __histoire-code"><div class="htw-absolute htw-top-0 htw-right-0 htw-text-xs htw-text-white/40">${lang}</div>${highlighter.codeToHtml(code, { theme: 'github-dark', lang })}</div>`,
+        highlight: (code, lang) => `<div class="ptw-relative ptw-not-prose __poveste-code __histoire-code"><div class="ptw-absolute ptw-top-0 ptw-right-0 ptw-text-xs ptw-text-white/40">${lang}</div>${highlighter.codeToHtml(code, { theme: 'github-dark', lang })}</div>`,
         linkify: true,
         html: true,
         breaks: false,

package/dist/node/preview.d.ts

@@ -1,8 +1,14 @@
 import type { Context } from './context.js';
+export interface StartPreviewOptions {
+    port?: number;
+    host?: string | boolean;
+    open?: boolean;
+}
 interface ReturnPayload {
     baseUrl: string;
+    printUrls: () => void;
     close: () => Promise<void>;
 }
-export declare function startPreview(port: number | null, ctx: Context): Promise<ReturnPayload>;
+export declare function startPreview(options: StartPreviewOptions, ctx: Context): Promise<ReturnPayload>;
 export {};
 //# sourceMappingURL=preview.d.ts.map

package/dist/node/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/node/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK3C,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA8C5F"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/node/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBrG"}

package/dist/node/preview.js

@@ -1,41 +1,24 @@
-import http from 'node:http';
-import connect from 'connect';
-import sirv from 'sirv';
-export async function startPreview(port, ctx) {
-    const app = connect();
-    app.use(ctx.resolvedViteConfig.base, sirv(ctx.config.outDir, {
-        dev: true,
-        etag: true,
-        single: true,
-    }));
-    let finalPort = port ?? 6006;
-    const httpServer = http.createServer(app);
-    return new Promise((resolve, reject) => {
-        function onError(e) {
-            if (e.code === 'EADDRINUSE') {
-                httpServer.listen(++finalPort);
-            }
-            else {
-                reject(e);
-            }
-        }
-        httpServer.on('error', onError);
-        httpServer.listen(finalPort, () => {
-            httpServer.off('error', onError);
-            const baseUrl = `http://localhost:${finalPort}${ctx.resolvedViteConfig.base}`;
-            resolve({
-                baseUrl,
-                close: () => new Promise((resolve, reject) => {
-                    httpServer.close((err) => {
-                        if (err) {
-                            reject(err);
-                        }
-                        else {
-                            resolve();
-                        }
-                    });
-                }),
-            });
-        });
+import { preview } from 'vite';
+export async function startPreview(options, ctx) {
+    const port = options.port ?? 6006;
+    const server = await preview({
+        root: ctx.root,
+        base: ctx.resolvedViteConfig.base,
+        configFile: false,
+        build: {
+            outDir: ctx.config.outDir,
+        },
+        preview: {
+            port,
+            host: options.host,
+            open: options.open,
+            strictPort: false,
+        },
     });
+    const baseUrl = server.resolvedUrls?.local[0] ?? `http://localhost:${port}${ctx.resolvedViteConfig.base}`;
+    return {
+        baseUrl,
+        printUrls: () => server.printUrls(),
+        close: () => server.close(),
+    };
 }

package/dist/node/style-isolation/entry-css-merger.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin as VitePlugin } from 'vite';
+export interface EntryCssMergerOptions {
+    isolateStyles: boolean;
+    scopeRoot?: string;
+    mainEntryName?: string;
+}
+export declare function entryCssMergerPlugin(opts?: EntryCssMergerOptions): VitePlugin;
+export declare function wrapMarkedUserCss(css: string, scopeRoot: string): string;
+//# sourceMappingURL=entry-css-merger.d.ts.map

package/dist/node/style-isolation/entry-css-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-css-merger.d.ts","sourceRoot":"","sources":["../../../src/node/style-isolation/entry-css-merger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAKhD,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,qBAAgD,GAAG,UAAU,CA4FvG;AAMD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAsBxE"}

package/dist/node/style-isolation/entry-css-merger.js

@@ -0,0 +1,128 @@
+import { STORY_SCOPE_ROOT } from './selectors.js';
+import { wrapUserCss } from './transforms.js';
+import { USER_CSS_MARK_END, USER_CSS_MARK_START } from './vite-plugin.js';
+export function entryCssMergerPlugin(opts = { isolateStyles: false }) {
+    const scopeRoot = opts.scopeRoot ?? STORY_SCOPE_ROOT;
+    const mainEntryName = opts.mainEntryName ?? 'bundle-main';
+    return {
+        name: 'poveste:style-isolation:entry-css-merger',
+        apply: 'build',
+        enforce: 'post',
+        generateBundle(_options, bundle) {
+            function collectChunkCss(entryFileName, entryName, acc) {
+                const seen = new Set();
+                const queue = [entryFileName];
+                let head = 0;
+                while (head < queue.length) {
+                    const cur = queue[head++];
+                    if (seen.has(cur))
+                        continue;
+                    seen.add(cur);
+                    const c = bundle[cur];
+                    if (!c || c.type !== 'chunk')
+                        continue;
+                    const meta = c.viteMetadata;
+                    if (meta?.importedCss) {
+                        for (const cssName of meta.importedCss) {
+                            const list = acc.get(cssName) ?? [];
+                            if (!list.includes(entryName))
+                                list.push(entryName);
+                            acc.set(cssName, list);
+                        }
+                    }
+                    for (const imp of c.imports ?? [])
+                        queue.push(imp);
+                    for (const imp of c.dynamicImports ?? [])
+                        queue.push(imp);
+                }
+            }
+            const cssAssetUsedBy = new Map();
+            for (const [fileName, chunk] of Object.entries(bundle)) {
+                if (chunk.type !== 'chunk' || !chunk.isEntry)
+                    continue;
+                collectChunkCss(fileName, chunk.name, cssAssetUsedBy);
+            }
+            const mergedByEntry = new Map();
+            for (const [cssName, entries] of cssAssetUsedBy) {
+                const asset = bundle[cssName];
+                if (!asset || asset.type !== 'asset')
+                    continue;
+                const source = typeof asset.source === 'string'
+                    ? asset.source
+                    : new TextDecoder().decode(asset.source);
+                for (const entryName of entries) {
+                    const list = mergedByEntry.get(entryName) ?? [];
+                    list.push(source);
+                    mergedByEntry.set(entryName, list);
+                }
+                delete bundle[cssName];
+            }
+            for (const [entryName, sources] of mergedByEntry) {
+                const fileName = `${entryName}.css`;
+                const merged = sources.join('\n');
+                const finalSource = entryName === mainEntryName && opts.isolateStyles
+                    ? wrapMarkedUserCss(merged, scopeRoot)
+                    : stripMarkers(merged);
+                bundle[fileName] = {
+                    type: 'asset',
+                    fileName,
+                    name: fileName,
+                    source: finalSource,
+                    needsCodeReference: false,
+                };
+            }
+            // Re-point CSS metadata: entries claim their own merged file; non-entry
+            // chunks (vendor, route splits) drop their importedCss because the
+            // assets they referenced were merged into the entry's CSS and deleted.
+            // Without this, Vite's runtime preload helper 404s on the missing
+            // per-chunk CSS files.
+            const entryCssByEntryName = new Map();
+            for (const [, chunk] of Object.entries(bundle)) {
+                if (chunk.type !== 'chunk' || !chunk.isEntry)
+                    continue;
+                if (mergedByEntry.has(chunk.name)) {
+                    entryCssByEntryName.set(chunk.name, `${chunk.name}.css`);
+                }
+            }
+            for (const [, chunk] of Object.entries(bundle)) {
+                if (chunk.type !== 'chunk')
+                    continue;
+                const meta = chunk.viteMetadata;
+                if (!meta?.importedCss)
+                    continue;
+                if (chunk.isEntry && entryCssByEntryName.has(chunk.name)) {
+                    meta.importedCss = new Set([entryCssByEntryName.get(chunk.name)]);
+                }
+                else {
+                    meta.importedCss = new Set();
+                }
+            }
+        },
+    };
+}
+function stripMarkers(css) {
+    return css.split(USER_CSS_MARK_START).join('').split(USER_CSS_MARK_END).join('');
+}
+export function wrapMarkedUserCss(css, scopeRoot) {
+    let out = '';
+    let cursor = 0;
+    while (cursor < css.length) {
+        const start = css.indexOf(USER_CSS_MARK_START, cursor);
+        if (start === -1) {
+            out += css.slice(cursor);
+            break;
+        }
+        out += css.slice(cursor, start);
+        const end = css.indexOf(USER_CSS_MARK_END, start + USER_CSS_MARK_START.length);
+        if (end === -1) {
+            out += css.slice(start + USER_CSS_MARK_START.length);
+            break;
+        }
+        const inner = css.slice(start + USER_CSS_MARK_START.length, end).trim();
+        if (inner.length > 0) {
+            out += `${wrapUserCss(inner, { scopeRoot })}\n`;
+        }
+        cursor = end + USER_CSS_MARK_END.length;
+    }
+    return out;
+}

package/dist/node/style-isolation/global-styles.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin as VitePlugin } from 'vite';
+export interface GlobalStylesPluginOptions {
+    files: string[];
+    rootDir: string;
+}
+export declare function globalStylesPlugin(opts: GlobalStylesPluginOptions): VitePlugin;
+export declare function getGlobalStylesVirtualId(): string;
+//# sourceMappingURL=global-styles.d.ts.map

package/dist/node/style-isolation/global-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-styles.d.ts","sourceRoot":"","sources":["../../../src/node/style-isolation/global-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAOhD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,UAAU,CAoB9E;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD"}

package/dist/node/style-isolation/global-styles.js

@@ -0,0 +1,31 @@
+import { resolve } from 'pathe';
+import { GLOBAL_LAYER_QUERY, USER_GLOBALS_LAYER } from './selectors.js';
+const VIRTUAL_ID = 'virtual:$poveste-global-styles';
+const RESOLVED_ID = `\0${VIRTUAL_ID}`;
+export function globalStylesPlugin(opts) {
+    return {
+        name: 'poveste:style-isolation:global-styles',
+        resolveId(id) {
+            if (id === VIRTUAL_ID)
+                return RESOLVED_ID;
+        },
+        load(id) {
+            if (id !== RESOLVED_ID)
+                return null;
+            return opts.files
+                .map(f => `import ${JSON.stringify(`${resolve(opts.rootDir, f)}?${GLOBAL_LAYER_QUERY}`)}`)
+                .join('\n');
+        },
+        transform(code, id) {
+            if (!id.includes(`?${GLOBAL_LAYER_QUERY}`))
+                return null;
+            return {
+                code: `@layer ${USER_GLOBALS_LAYER} {\n${code}\n}\n`,
+                map: null,
+            };
+        },
+    };
+}
+export function getGlobalStylesVirtualId() {
+    return VIRTUAL_ID;
+}

package/dist/node/style-isolation/index.d.ts

@@ -0,0 +1,6 @@
+export * from './entry-css-merger.js';
+export * from './global-styles.js';
+export * from './scope-chrome.js';
+export * from './transforms.js';
+export * from './vite-plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/style-isolation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/style-isolation/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}

package/dist/node/style-isolation/index.js

@@ -0,0 +1,5 @@
+export * from './entry-css-merger.js';
+export * from './global-styles.js';
+export * from './scope-chrome.js';
+export * from './transforms.js';
+export * from './vite-plugin.js';

package/dist/node/style-isolation/scope-chrome.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin as VitePlugin } from 'vite';
+export interface ChromeCssScopePluginOptions {
+    enabled: boolean;
+}
+export declare function chromeCssScopePlugin(opts: ChromeCssScopePluginOptions): VitePlugin;
+//# sourceMappingURL=scope-chrome.d.ts.map

package/dist/node/style-isolation/scope-chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-chrome.d.ts","sourceRoot":"","sources":["../../../src/node/style-isolation/scope-chrome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAKhD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,2BAA2B,GAAG,UAAU,CAgBlF"}

package/dist/node/style-isolation/scope-chrome.js

@@ -0,0 +1,37 @@
+import { APP_SCOPE_ROOT, DEFAULTS_LAYER, STORY_SCOPE_BOUNDARY } from './selectors.js';
+import { wrapChromeCss } from './transforms.js';
+import { isChromeCss } from './vite-plugin.js';
+export function chromeCssScopePlugin(opts) {
+    return {
+        name: 'poveste:style-isolation:chrome-css',
+        transform(code, id) {
+            if (!opts.enabled)
+                return null;
+            if (isMainChromeCss(id)) {
+                return { code: wrapChromeCss(code, { scopeRoot: APP_SCOPE_ROOT, scopeLower: STORY_SCOPE_BOUNDARY }), map: null };
+            }
+            if (isSandboxChromeCss(id)) {
+                // Sandbox chrome defaults coexist with user CSS inside the iframe.
+                // @layer makes user's unlayered rules win the cascade.
+                return { code: `@layer ${DEFAULTS_LAYER} {\n${code}\n}\n`, map: null };
+            }
+            return null;
+        },
+    };
+}
+// Stylesheets loaded only by the chrome page (bundle-main).
+function isMainChromeCss(id) {
+    if (!isChromeCss(id))
+        return false;
+    const cleaned = id.split('?')[0];
+    return /(?:poveste-app|@poveste\/app)\/(?:dist\/style\.css|dist\/bundled\/[^/]+\.css|src\/app\/style\/main\.(?:css|pcss))$/.test(cleaned);
+}
+// Stylesheets loaded into the sandbox iframe — must coexist with user CSS,
+// so they get a cascade-layer wrap rather than an @scope wrap.
+function isSandboxChromeCss(id) {
+    if (!isChromeCss(id))
+        return false;
+    const cleaned = id.split('?')[0];
+    return /\/(?:poveste-app|@poveste\/app)\/(?:dist|src)\/.*\bsandbox\.css$/.test(cleaned)
+        || /\/(?:poveste-controls|@poveste\/controls)\/dist\/index\.es\.css$/.test(cleaned);
+}

package/dist/node/style-isolation/selectors.d.ts

@@ -0,0 +1,7 @@
+export declare const APP_SCOPE_ROOT = ".poveste-app-root";
+export declare const STORY_SCOPE_ROOT = ".__poveste-render-story";
+export declare const STORY_SCOPE_BOUNDARY = ".__poveste-render-story:not(.__poveste-render-custom-controls)";
+export declare const DEFAULTS_LAYER = "poveste-defaults";
+export declare const USER_GLOBALS_LAYER = "poveste-user-globals";
+export declare const GLOBAL_LAYER_QUERY = "poveste-global-layer";
+//# sourceMappingURL=selectors.d.ts.map

package/dist/node/style-isolation/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../../src/node/style-isolation/selectors.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc,sBAAsB,CAAA;AACjD,eAAO,MAAM,gBAAgB,4BAA4B,CAAA;AAIzD,eAAO,MAAM,oBAAoB,mEAAmE,CAAA;AACpG,eAAO,MAAM,cAAc,qBAAqB,CAAA;AAChD,eAAO,MAAM,kBAAkB,yBAAyB,CAAA;AAGxD,eAAO,MAAM,kBAAkB,yBAAyB,CAAA"}

package/dist/node/style-isolation/selectors.js

@@ -0,0 +1,15 @@
+// Centralised CSS scope-root class names used by the style-isolation
+// pipeline. Keep in sync with the runtime markers applied in
+// poveste-app (App.vue's `poveste-app-root` wrapper, GenericRenderStory's
+// `__poveste-render-story` class, sandbox.ts's body class).
+export const APP_SCOPE_ROOT = '.poveste-app-root';
+export const STORY_SCOPE_ROOT = '.__poveste-render-story';
+// Custom-controls panels carry both classes (.__poveste-render-story and
+// .__poveste-render-custom-controls) but render inside the chrome panel,
+// so the @scope boundary must keep them in chrome scope.
+export const STORY_SCOPE_BOUNDARY = '.__poveste-render-story:not(.__poveste-render-custom-controls)';
+export const DEFAULTS_LAYER = 'poveste-defaults';
+export const USER_GLOBALS_LAYER = 'poveste-user-globals';
+// Import query `globalStyles` files carry so the user-CSS plugin leaves them
+// alone — they belong in the chrome page, not inside the story scope.
+export const GLOBAL_LAYER_QUERY = 'poveste-global-layer';

package/dist/node/style-isolation/transforms.d.ts

@@ -0,0 +1,11 @@
+export interface WrapOptions {
+    scopeRoot: string;
+}
+export interface WrapWithLowerOptions {
+    scopeRoot: string;
+    scopeLower: string;
+}
+export declare function wrapUserCss(css: string, opts: WrapOptions): string;
+export declare function wrapChromeCss(css: string, opts: WrapWithLowerOptions): string;
+export declare function isGlobalImport(id: string): boolean;
+//# sourceMappingURL=transforms.d.ts.map

package/dist/node/style-isolation/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../../src/node/style-isolation/transforms.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAWlE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAc7E;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKlD"}

package/dist/node/style-isolation/transforms.js

@@ -0,0 +1,75 @@
+import { Buffer } from 'node:buffer';
+import { transform as lightningcssTransform } from 'lightningcss';
+export function wrapUserCss(css, opts) {
+    const trimmed = css.trimStart();
+    if (trimmed.startsWith('@scope')) {
+        return css;
+    }
+    const { hoisted, remainder } = extractHoistableAtRules(css);
+    const body = remainder.includes(':root')
+        ? rewriteRootToScope(remainder)
+        : remainder;
+    const hoistedBlock = hoisted.length > 0 ? `${hoisted.join('\n')}\n` : '';
+    return `${hoistedBlock}@scope (${opts.scopeRoot}) {\n${body}\n}\n`;
+}
+export function wrapChromeCss(css, opts) {
+    const trimmed = css.trimStart();
+    if (trimmed.startsWith('@scope (')) {
+        return css;
+    }
+    const { hoisted, remainder } = extractHoistableAtRules(css);
+    // Rewrite `:root` to `:scope` so source-level `@scope (:root) to (...)`
+    // rules nest correctly under the outer scope; without this, the inner
+    // `:root` resolves to the document root which is outside the outer scope.
+    const body = remainder.includes(':root')
+        ? rewriteRootToScope(remainder)
+        : remainder;
+    const hoistedBlock = hoisted.length > 0 ? `${hoisted.join('\n')}\n` : '';
+    return `${hoistedBlock}@scope (${opts.scopeRoot}) to (${opts.scopeLower}) {\n${body}\n}\n`;
+}
+export function isGlobalImport(id) {
+    const q = id.indexOf('?');
+    if (q === -1)
+        return false;
+    const parts = id.slice(q + 1).split('&');
+    return parts.includes('global') || parts.some(p => p.startsWith('global='));
+}
+function rewriteRootToScope(css) {
+    const processed = lightningcssTransform({
+        filename: 'user.css',
+        code: Buffer.from(css, 'utf8'),
+        minify: false,
+        visitor: {
+            Selector(selector) {
+                for (const part of selector) {
+                    if (part.type === 'pseudo-class' && part.kind === 'root') {
+                        ;
+                        part.kind = 'scope';
+                    }
+                }
+                return selector;
+            },
+        },
+    });
+    return Buffer.from(processed.code).toString('utf8');
+}
+// Top-level at-rule extraction. Anchored to line start with optional leading
+// whitespace; covers the formatted output produced by Vite/PostCSS. Inputs
+// with rules on the same line as other rules, or strings/comments containing
+// `;`/`}`, are not handled — these are extremely rare in practice and would
+// only mis-classify within a generated poveste-app or vendor stylesheet.
+const HOIST_SEMI_RE = /^[ \t]*@(?:import|charset|namespace)\s[^;]+;[ \t]*\n?/gm;
+const HOIST_FONT_FACE_RE = /^[ \t]*@font-face\s*\{[^}]*\}[ \t]*\n?/gm;
+function extractHoistableAtRules(css) {
+    const hoisted = [];
+    let remainder = css;
+    remainder = remainder.replace(HOIST_SEMI_RE, (match) => {
+        hoisted.push(match.trim());
+        return '';
+    });
+    remainder = remainder.replace(HOIST_FONT_FACE_RE, (match) => {
+        hoisted.push(match.trim());
+        return '';
+    });
+    return { hoisted, remainder };
+}

package/dist/node/style-isolation/vite-plugin.d.ts

@@ -0,0 +1,15 @@
+import type { Plugin as VitePlugin } from 'vite';
+export declare const USER_CSS_MARK_START = "/*__PVT_USER_CSS_START__*/";
+export declare const USER_CSS_MARK_END = "/*__PVT_USER_CSS_END__*/";
+export interface UserCssScopePluginOptions {
+    enabled: boolean;
+    /**
+     * 'mark' — insert sentinel comments; entry-css-merger wraps per-entry at
+     * build time. 'wrap' — wrap directly in @scope at transform time (dev,
+     * no merger).
+     */
+    mode?: 'mark' | 'wrap';
+}
+export declare function userCssScopePlugin(opts: UserCssScopePluginOptions): VitePlugin;
+export declare function isChromeCss(id: string): boolean;
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/node/style-isolation/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../../../src/node/style-isolation/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAIhD,eAAO,MAAM,mBAAmB,+BAA+B,CAAA;AAC/D,eAAO,MAAM,iBAAiB,6BAA6B,CAAA;AAE3D,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,UAAU,CAsB9E;AAsBD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG/C"}

package/dist/node/style-isolation/vite-plugin.js

@@ -0,0 +1,62 @@
+import { GLOBAL_LAYER_QUERY, STORY_SCOPE_ROOT } from './selectors.js';
+import { wrapUserCss } from './transforms.js';
+export const USER_CSS_MARK_START = '/*__PVT_USER_CSS_START__*/';
+export const USER_CSS_MARK_END = '/*__PVT_USER_CSS_END__*/';
+export function userCssScopePlugin(opts) {
+    const mode = opts.mode ?? 'mark';
+    return {
+        name: 'poveste:style-isolation:user-css',
+        transform(code, id) {
+            if (!opts.enabled)
+                return null;
+            const q = id.indexOf('?');
+            const path = q === -1 ? id : id.slice(0, q);
+            const query = q === -1 ? '' : id.slice(q + 1);
+            // Cheap substring rejection of all poveste-internal CSS first.
+            if (isChromePath(path))
+                return null;
+            if (!isCssPath(path, query))
+                return null;
+            if (hasGlobalQuery(query))
+                return null;
+            if (mode === 'wrap') {
+                return { code: wrapUserCss(code, { scopeRoot: STORY_SCOPE_ROOT }), map: null };
+            }
+            return {
+                code: `${USER_CSS_MARK_START}\n${code}\n${USER_CSS_MARK_END}\n`,
+                map: null,
+            };
+        },
+    };
+}
+const CSS_EXT_RE = /\.(?:css|pcss|postcss|scss|sass|less|styl|stylus)$/;
+// Vue / Svelte / Vite virtual style modules carry the source extension as a
+// `lang.<ext>` query, e.g. `Foo.vue?vue&type=style&index=0&lang.css`.
+const CSS_LANG_QUERY_RE = /(?:^|&)lang\.(?:css|pcss|postcss|scss|sass|less|styl|stylus)(?:&|$)/;
+function isCssPath(path, query) {
+    return CSS_EXT_RE.test(path) || CSS_LANG_QUERY_RE.test(query);
+}
+function hasGlobalQuery(query) {
+    if (!query)
+        return false;
+    const parts = query.split('&');
+    // `?global` is the per-import escape hatch; the `globalStyles` config marks
+    // its files with `?poveste-global-layer` and they get a cascade layer of
+    // their own in global-styles.ts.
+    return parts.includes('global')
+        || parts.some(p => p.startsWith('global='))
+        || parts.includes(GLOBAL_LAYER_QUERY);
+}
+export function isChromeCss(id) {
+    const q = id.indexOf('?');
+    return isChromePath(q === -1 ? id : id.slice(0, q));
+}
+function isChromePath(path) {
+    return path.includes('@poveste/app/')
+        || path.includes('poveste-app/')
+        || path.includes('@poveste/controls/')
+        || path.includes('poveste-controls/')
+        || path.includes('@poveste/vendors/')
+        || path.includes('poveste-vendors/')
+        || path.includes('virtual:$poveste-');
+}

package/dist/node/util/head.d.ts

@@ -0,0 +1,3 @@
+import type { UseHeadInput } from 'unhead/types';
+export declare function applyHeadTransform(html: string, head: UseHeadInput | undefined): Promise<string>;
+//# sourceMappingURL=head.d.ts.map