poveste 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2022 Guillaume Chau (original "histoire" project)
+Copyright (c) 2026 Sorin Gitlan (poveste fork)
+
+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/README.md

@@ -0,0 +1,11 @@
+# Poveste
+
+> Fast and beautiful interactive component playgrounds
+
+[Learn more](https://github.com/poveste-dev/poveste)
+
+```
+pnpm add histoire -D
+pnpm exec histoire dev
+pnpm exec histoire build
+```

package/bin.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict'
+
+import './dist/node/bin.js'

package/client.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @deprecated
+ */
+export function hstEvent(name: string, argument): void
+
+/**
+ * Logs an event to the 'Events' sidepane.
+ * @param name Event name
+ * @param argument Additional log data displayed when inspecting the event.
+ */
+export function logEvent(name: string, argument): void
+
+/**
+ * Returns `true` when in the NodeJS server while collecting stories.
+ */
+export function isCollecting(): boolean
+
+export function toggleDark(value?: boolean): boolean
+export function isDark(): boolean

package/client.js

@@ -0,0 +1,15 @@
+import { logEvent } from '@poveste/app'
+
+export * from '@poveste/app'
+
+export function isCollecting() {
+  return process.env.HST_COLLECT === 'true'
+}
+
+/**
+ * @deprecated
+ */
+export function hstEvent(...args) {
+  console.warn(`'hstEvent' is deprecated. Use 'logEvent' instead.`)
+  return logEvent(...args)
+}

package/dist/controls.d.ts

@@ -0,0 +1,2 @@
+export * from '@poveste/controls';
+//# sourceMappingURL=controls.d.ts.map

package/dist/controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../src/controls.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA"}

package/dist/controls.js

@@ -0,0 +1 @@
+export * from '@poveste/controls';

package/dist/node/alias.d.ts

@@ -0,0 +1,3 @@
+export declare const APP_PATH: string;
+export declare const TEMP_PATH: string;
+//# sourceMappingURL=alias.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alias.d.ts","sourceRoot":"","sources":["../../src/node/alias.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,QAAmH,CAAA;AAExI,eAAO,MAAM,SAAS,QAAwD,CAAA"}

package/dist/node/alias.js

@@ -0,0 +1,5 @@
+import { createRequire } from 'node:module';
+import path from 'pathe';
+const require = createRequire(import.meta.url);
+export const APP_PATH = path.join(path.dirname(require.resolve('@poveste/app/package.json')), process.env.HISTOIRE_DEV ? 'src' : 'dist');
+export const TEMP_PATH = path.join(process.cwd(), 'node_modules', '.histoire');

package/dist/node/bin.d.ts

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

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

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

package/dist/node/bin.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'pathe';
+import sade from 'sade';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const { version } = JSON.parse(fs.readFileSync(resolve(__dirname, '../../package.json'), 'utf8'));
+process.env.NODE_ENV = 'development';
+process.env.HISTOIRE = 'true';
+const program = sade('poveste');
+program.version(version);
+program.command('dev')
+    .describe('open the stories in your browser for development')
+    .option('-p, --port <port>', 'Listening port of the server')
+    .option('-c, --config <file>', `[string] use specified config file`)
+    .option('--open', 'Open in your default browser')
+    .option('--host <host>', '[string] specify hostname')
+    .action(async (options) => {
+    const { devCommand } = await import('./commands/dev.js');
+    return devCommand(options);
+});
+program.command('build')
+    .describe('build the histoire final app you can deploy')
+    .option('-c, --config <file>', `[string] use specified config file`)
+    .action(async (options) => {
+    const { buildCommand } = await import('./commands/build.js');
+    return buildCommand(options);
+});
+program.command('preview')
+    .describe('preview the built directory')
+    .option('-p, --port <port>', 'Listening port of the server')
+    .action(async (options) => {
+    const { previewCommand } = await import('./commands/preview.js');
+    return previewCommand(options);
+});
+program.parse(process.argv);

package/dist/node/build-serialize.d.ts

@@ -0,0 +1,22 @@
+import type { ServerStory } from '@poveste/shared';
+import type { Context } from './context.js';
+interface SerializedStory extends Omit<ServerStory, 'docsText'> {
+    relativePath: string;
+    supportPluginId: string;
+    treePath?: string[];
+    virtual?: boolean;
+    markdownFile?: SerializedMarkdownFile;
+}
+interface SerializedMarkdownFile {
+    id: string;
+    relativePath: string;
+    isRelatedToStory: boolean;
+    frontmatter?: any;
+}
+interface SerializedStoryData {
+    stories: SerializedStory[];
+    markdownFiles: SerializedMarkdownFile[];
+}
+export declare function getSerializedStoryData(ctx: Context): SerializedStoryData;
+export {};
+//# sourceMappingURL=build-serialize.d.ts.map

package/dist/node/build-serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-serialize.d.ts","sourceRoot":"","sources":["../../src/node/build-serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,UAAU,eAAgB,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IAC7D,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,sBAAsB,CAAA;CACtC;AAED,UAAU,sBAAsB;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,OAAO,CAAA;IACzB,WAAW,CAAC,EAAE,GAAG,CAAA;CAClB;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,aAAa,EAAE,sBAAsB,EAAE,CAAA;CACxC;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAsCxE"}

package/dist/node/build-serialize.js

@@ -0,0 +1,36 @@
+export function getSerializedStoryData(ctx) {
+    const data = {
+        stories: [],
+        markdownFiles: [],
+    };
+    for (const storyFile of ctx.storyFiles) {
+        if (storyFile.story) {
+            data.stories.push({
+                ...Object.assign({}, storyFile.story, {
+                    docsText: undefined,
+                }),
+                relativePath: storyFile.relativePath,
+                supportPluginId: storyFile.supportPluginId,
+                treePath: storyFile.treePath,
+                virtual: storyFile.virtual,
+                markdownFile: storyFile.markdownFile
+                    ? {
+                        id: storyFile.markdownFile.id,
+                        relativePath: storyFile.markdownFile.relativePath,
+                        isRelatedToStory: storyFile.markdownFile.isRelatedToStory,
+                        frontmatter: storyFile.markdownFile.frontmatter,
+                    }
+                    : null,
+            });
+        }
+    }
+    for (const markdownFile of ctx.markdownFiles) {
+        data.markdownFiles.push({
+            id: markdownFile.id,
+            relativePath: markdownFile.relativePath,
+            isRelatedToStory: markdownFile.isRelatedToStory,
+            frontmatter: markdownFile.frontmatter,
+        });
+    }
+    return data;
+}

package/dist/node/build.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from './context.js';
+export declare function build(ctx: Context): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/node/build.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AA+B3C,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,iBA8MvC"}

package/dist/node/build.js

@@ -0,0 +1,228 @@
+import { performance } from 'node:perf_hooks';
+import fs from 'fs-extra';
+import { lookup as lookupMime } from 'mrmime';
+import { join } from 'pathe';
+import pc from 'picocolors';
+import { createServer as createViteServer, mergeConfig as mergeViteConfig, build as viteBuild, } from 'vite';
+import { APP_PATH } from './alias.js';
+import { getSerializedStoryData } from './build-serialize.js';
+import { useCollectStories } from './collect/index.js';
+import { useModuleLoader } from './load.js';
+import { createMarkdownFilesWatcher } from './markdown.js';
+import { BuildPluginApi } from './plugin.js';
+import { startPreview } from './preview.js';
+import { findAllStories } from './stories.js';
+import { getViteConfigWithPlugins } from './vite.js';
+const PRELOAD_MODULES = [
+    'vendor',
+];
+const PREFETCHED_MODULES = [
+    'StoryView',
+    'reactivity',
+    'global-components',
+];
+export async function build(ctx) {
+    const startTime = performance.now();
+    await findAllStories(ctx);
+    // Scan for markdown files
+    {
+        const { stop } = await createMarkdownFilesWatcher(ctx);
+        await stop();
+    }
+    const { viteConfig } = await getViteConfigWithPlugins(true, ctx);
+    const server = await createViteServer(mergeViteConfig(viteConfig, {
+        optimizeDeps: { include: [], noDiscovery: true },
+    }));
+    await server.pluginContainer.buildStart({});
+    const moduleLoader = useModuleLoader({
+        server,
+        throws: true,
+    });
+    const changeViteConfigCallbacks = [];
+    const buildEndCallbacks = [];
+    const previewStoryCallbacks = [];
+    for (const plugin of ctx.config.plugins) {
+        if (plugin.onBuild) {
+            const api = new BuildPluginApi(ctx, plugin, moduleLoader);
+            await plugin.onBuild(api);
+            changeViteConfigCallbacks.push(...api.changeViteConfigCallbacks);
+            buildEndCallbacks.push(...api.buildEndCallbacks);
+            previewStoryCallbacks.push(...api.previewStoryCallbacks);
+        }
+    }
+    // Collect story data
+    const { executeStoryFile, destroy: destroyCollectStories } = useCollectStories({
+        server,
+        throws: true,
+    }, ctx);
+    await Promise.all(ctx.storyFiles.map(storyFile => executeStoryFile(storyFile)));
+    await destroyCollectStories();
+    const storyCount = ctx.storyFiles.reduce((sum, file) => sum + (file.story?.variants.length ? 1 : 0), 0);
+    const variantCount = ctx.storyFiles.reduce((sum, file) => sum + (file.story?.variants.length ?? 0), 0);
+    const emptyStoryCount = ctx.storyFiles.length - storyCount;
+    const { viteConfig: buildViteConfigRaw } = await getViteConfigWithPlugins(false, ctx);
+    const buildViteConfig = mergeViteConfig(buildViteConfigRaw, {
+        mode: 'development',
+        build: {
+            lib: false,
+            rollupOptions: {
+                input: [
+                    join(APP_PATH, 'bundle-main.js'),
+                    join(APP_PATH, 'bundle-sandbox.js'),
+                ],
+                plugins: [
+                    {
+                        name: 'histoire-build-rollup-options-override',
+                        enforce: 'post',
+                        options(options) {
+                            // Don't externalize
+                            options.external = [];
+                        },
+                    },
+                ],
+            },
+        },
+    });
+    // For @vite/plugin-vue: Always put our vite server
+    // Disable template inlining
+    // (so that we no longer need defineExpose)
+    // Nuxt: replaces the Nuxt vite dev server
+    buildViteConfig.plugins.push({
+        name: 'histoire-vue-plugin-override',
+        config(config) {
+            const vuePlugin = config.plugins.find((p) => p.name === 'vite:vue');
+            if (vuePlugin) {
+                // @ts-expect-error vue plugin use function form
+                const original = vuePlugin.configureServer.bind(vuePlugin);
+                vuePlugin.configureServer = () => {
+                    original({
+                        ...server,
+                        config: {
+                            ...server.config,
+                            server: {
+                                ...server.config.server,
+                                hmr: false,
+                            },
+                        },
+                    });
+                };
+                // @ts-expect-error vue plugin use function form
+                vuePlugin.configureServer(server);
+            }
+        },
+    });
+    buildViteConfig.plugins.push({
+        name: 'histoire-build-config-override',
+        enforce: 'post',
+        config(config) {
+            // Don't externalize
+            config.build.rollupOptions.external = [];
+            // Force chunk strategy
+            config.build.rollupOptions.output = {
+                manualChunks(id) {
+                    if (!id.includes('@poveste/app') && id.includes('node_modules')) {
+                        for (const test of ctx.config.build?.excludeFromVendorsChunk ?? []) {
+                            if ((typeof test === 'string' && id.includes(test)) || (test instanceof RegExp && test.test(id))) {
+                                // Excluded from vendor chunk
+                                return;
+                            }
+                        }
+                        return 'vendor';
+                    }
+                },
+            };
+            // Force vite build options
+            Object.assign(config.build, {
+                outDir: ctx.config.outDir,
+                emptyOutDir: true,
+                cssCodeSplit: false,
+                minify: false,
+                // Don't build in SSR mode
+                ssr: false,
+            });
+            config.define.__HST_COLLECT__ = false;
+        },
+    });
+    for (const cb of changeViteConfigCallbacks) {
+        console.log('vite config hook', cb);
+        await cb(buildViteConfig);
+    }
+    const results = await viteBuild(buildViteConfig);
+    const result = Array.isArray(results) ? results[0] : results;
+    const styleOutput = result.output.find(o => o.name === 'style.css' && o.type === 'asset');
+    // Preload
+    const preloadOutputs = result.output.filter(o => PRELOAD_MODULES.includes(o.name) && o.type === 'chunk');
+    const preloadHtml = generateScriptLinks(preloadOutputs.map(o => o.fileName), 'preload', ctx);
+    // Prefetch
+    const prefetchOutputs = result.output.filter(o => PREFETCHED_MODULES.includes(o.name) && o.type === 'chunk');
+    const prefetchHtml = generateScriptLinks(prefetchOutputs.map(o => o.fileName), 'prefetch', ctx);
+    // Index
+    const indexOutput = result.output.find(o => o.name === 'bundle-main' && o.type === 'chunk');
+    const indexHtml = generateEntryHtml(indexOutput.fileName, styleOutput.fileName, {
+        HEAD: `${preloadHtml}${prefetchHtml}`,
+    }, ctx);
+    await writeFile('index.html', indexHtml, ctx);
+    // Sandbox
+    const sandboxOutput = result.output.find(o => o.name === 'bundle-sandbox' && o.type === 'chunk');
+    const sandboxHtml = generateEntryHtml(sandboxOutput.fileName, styleOutput.fileName, {}, ctx);
+    await writeFile('__sandbox.html', sandboxHtml, ctx);
+    await writeFile('histoire.json', JSON.stringify(getSerializedStoryData(ctx), null, 2), ctx);
+    const duration = performance.now() - startTime;
+    if (emptyStoryCount) {
+        console.warn(pc.yellow(`⚠️  ${emptyStoryCount} empty story file${emptyStoryCount === 1 ? '' : 's'}`));
+    }
+    console.log(pc.green(`✅ Built ${storyCount} stor${storyCount === 1 ? 'y' : 'ies'} (${variantCount} variant${variantCount === 1 ? '' : 's'}) in ${Math.round(duration / 1000 * 100) / 100}s`));
+    // Render
+    if (previewStoryCallbacks.length) {
+        const { baseUrl, close } = await startPreview(null, ctx);
+        for (const storyFile of ctx.storyFiles) {
+            const story = storyFile.story;
+            for (const variant of story.variants) {
+                const query = new URLSearchParams();
+                query.append('storyId', story.id);
+                query.append('variantId', variant.id);
+                const url = `${baseUrl}__sandbox.html?${query.toString()}`;
+                for (const fn of previewStoryCallbacks) {
+                    await fn({
+                        file: storyFile.path,
+                        story,
+                        variant,
+                        url,
+                    });
+                }
+            }
+        }
+        await close();
+    }
+    await server.close();
+    for (const fn of buildEndCallbacks) {
+        await fn();
+    }
+}
+function generateBaseHtml(head, body, ctx) {
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <title>${ctx.config.theme.title}</title>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <meta name="description" content="">
+  ${head}
+</head>
+<body>
+  ${body}
+</body>
+</html>`;
+}
+function generateEntryHtml(jsEntryFile, cssEntryFile, variables, ctx) {
+    return generateBaseHtml(`<link rel="stylesheet" href="${ctx.resolvedViteConfig.base}${cssEntryFile}">
+    ${ctx.config.theme?.favicon ? `<link rel="icon" type="${lookupMime(ctx.config.theme.favicon)}" href="${ctx.resolvedViteConfig.base}${ctx.config.theme.favicon}"/>` : ''}
+    ${variables.HEAD ?? ''}`, `<div id="app"></div>
+    <script type="module" src="${ctx.resolvedViteConfig.base}${jsEntryFile}"></script>`, ctx);
+}
+async function writeFile(fileName, content, ctx) {
+    await fs.writeFile(join(ctx.config.outDir, fileName), content, 'utf8');
+}
+function generateScriptLinks(prefetchScripts, rel, ctx) {
+    return prefetchScripts.map(s => `<link rel="${rel}" href="${ctx.resolvedViteConfig.base}${s}" as="script" crossOrigin="anonymous">`).join('');
+}

package/dist/node/builtin-plugins/pinceau-tokens.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from '@poveste/shared';
+export interface PinceauTokensOptions {
+    configOrPaths?: string | string[];
+    configFileName?: string;
+}
+export declare function pinceauTokens(_options?: PinceauTokensOptions): Plugin;
+//# sourceMappingURL=pinceau-tokens.d.ts.map

package/dist/node/builtin-plugins/pinceau-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinceau-tokens.d.ts","sourceRoot":"","sources":["../../../src/node/builtin-plugins/pinceau-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAA;AAI5D,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,aAAa,CAAC,QAAQ,GAAE,oBAAyB,GAAG,MAAM,CA2DzE"}