@crvy/strybk 0.0.1 → 0.0.2

package/CHANGELOG.md

@@ -5,4 +5,46 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.2] - 2026-06-11
+## [0.0.1] - 2026-06-11
+
+### Added
+
+- Add lean config and generator core
+- Support creevey skip metadata extraction
+- Add Storybook channel driver and switchStory helper
+- Add shared-page Playwright fixtures
+- Add strybk CLI
+- Simplify generated spec imports to use @crvy/strybk directly
+
+### Documentation
+
+- Correct Yarn 4 local link instructions
+- Add minimal config example and improve fetch error message
+
+### Fixed
+
+- Default generated region marker in renderer
+- Harden creevey metadata filtering
+- Support meta-level creevey skip
+- Harden Storybook channel driver
+- Keep switch timeout through font readiness
+- Preserve sharedPage fixture typing
+- Hide internal worker page fixture
+- Preserve built-in playwright fixture types
+- Harden linked playwright runtime and generation
+
+### Miscellaneous
+
+- Bootstrap strybk package
+- Align strybk bootstrap with plan
+- Fix strybk bin entry
+- Make strybk bootstrap manifest honest
+- Tighten strybk bootstrap packaging
+- Ignore strybk build artifacts
+- Sync strybk lockfile
+- Build strybk before packing
+- Sync current workspace
+- Align publish setup with crvy-rprtr
+- Bump version to 0.0.1 and update bin field format
 ## [Unreleased]

package/README.md

@@ -25,17 +25,29 @@ bun run check
 Generate screenshot specs from a Storybook index:
 
 ```sh
-strybk generate --config ./strybk.config.ts
+crvy-strybk generate --config ./strybk.config.ts
 ```
 
 Use `--dry-run` to compute outputs without writing files:
 
 ```sh
-strybk generate --config ./strybk.config.ts --dry-run
+crvy-strybk generate --config ./strybk.config.ts --dry-run
 ```
 
 The config module should export a `StrybkConfig` object, typically as the default export from `defineConfig(...)`.
 
+Minimal `strybk.config.ts`:
+
+```ts
+import { defineConfig } from "@crvy/strybk";
+
+export default defineConfig({
+  storybookUrl: "http://localhost:6006",
+  storyGlobs: ["src/**/*.stories.tsx"],
+  resolveSpecPath: ({ storyFilePath }) => storyFilePath.replace(/\.stories\.tsx$/, ".spec.ts"),
+});
+```
+
 ## Changelog
 
 Preview the next changelog entry:
@@ -69,7 +81,7 @@ Link it into the consumer project:
 
 ```sh
 cd /path/to/consumer-project
-bun link strybk
+bun link @crvy/strybk
 ```
 
 If you want to persist the link in the consumer's manifest, Bun supports a `link:` dependency entry:
@@ -77,7 +89,7 @@ If you want to persist the link in the consumer's manifest, Bun supports a `link
 ```json
 {
   "dependencies": {
-    "strybk": "link:strybk"
+    "@crvy/strybk": "link:strybk"
   }
 }
 ```

package/dist/src/cli.js

@@ -32,8 +32,7 @@ const resolveConfigExport = (moduleNamespace) => {
 const isStrybkConfig = (value) => isRecord(value) &&
     typeof value.storybookUrl === "string" &&
     Array.isArray(value.storyGlobs) &&
-    typeof value.resolveSpecPath === "function" &&
-    typeof value.resolveHarnessImports === "function";
+    typeof value.resolveSpecPath === "function";
 const getIndexEntriesRecord = (payload) => {
     if (!isRecord(payload)) {
         throw new Error("Storybook index response must be an object");
@@ -77,9 +76,15 @@ const loadConfig = async (configPath) => {
 };
 const fetchStoryIndex = async (config) => {
     const indexUrl = resolveStorybookIndexUrl(config.storybookUrl);
-    const response = await fetch(indexUrl);
+    let response;
+    try {
+        response = await fetch(indexUrl);
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch Storybook index at ${indexUrl.toString()} — is Storybook running?`, { cause: error });
+    }
     if (!response.ok) {
-        throw new Error(`Failed to fetch ${indexUrl.toString()}: ${response.status} ${response.statusText}`.trim());
+        throw new Error(`Failed to fetch Storybook index at ${indexUrl.toString()}: ${response.status} ${response.statusText}`.trim());
     }
     const payload = asUnknown(await response.json());
     const entries = getIndexEntriesRecord(payload);

package/dist/src/config.d.ts

@@ -7,12 +7,6 @@ export interface StrybkConfig {
     resolveSpecPath: (args: {
         storyFilePath: string;
     }) => string;
-    resolveHarnessImports: (args: {
-        outputPath: string;
-    }) => {
-        fixturesImport: string;
-        switchStoryImport: string;
-    };
     generatedRegionName?: string;
     deleteOrphans?: boolean;
     metadataExtractors?: "creevey"[];

package/dist/src/generate/index.js

@@ -35,14 +35,11 @@ export async function generateScreenshots(args) {
         if (filteredStories.length === 0 && manualRegion.length === 0) {
             return [];
         }
-        const harnessImports = args.config.resolveHarnessImports({ outputPath });
         return [
             {
                 outputPath,
                 content: renderScreenshotSpec({
                     config: args.config,
-                    fixturesImport: harnessImports.fixturesImport,
-                    switchStoryImport: harnessImports.switchStoryImport,
                     title: storyFile.title,
                     stories: filteredStories,
                     manualRegion,

package/dist/src/generate/render.d.ts

@@ -5,8 +5,6 @@ export interface RenderableStory {
 }
 export declare function renderScreenshotSpec(args: {
     config: StrybkConfig;
-    fixturesImport: string;
-    switchStoryImport: string;
     title: string;
     stories: RenderableStory[];
     manualRegion: string;

package/dist/src/generate/render.js

@@ -4,5 +4,5 @@ export function renderScreenshotSpec(args) {
     const tests = args.stories
         .map((story) => `  test('${escapeSingleQuotes(story.name)}', async ({ sharedPage }) => {\n    await switchStory(sharedPage, '${story.id}');\n    await expect(sharedPage).toHaveScreenshot();\n  });`)
         .join("\n\n");
-    return `import { test, expect } from '${args.fixturesImport}';\nimport { switchStory } from '${args.switchStoryImport}';\n\n// @generated-begin ${generatedRegionName}\ntest.describe('${escapeSingleQuotes(args.title)}', () => {\n${tests}\n});\n// @generated-end ${generatedRegionName}\n\n${args.manualRegion}`;
+    return `import { test, expect, switchStory } from '@crvy/strybk';\n\n// @generated-begin ${generatedRegionName}\ntest.describe('${escapeSingleQuotes(args.title)}', () => {\n${tests}\n});\n// @generated-end ${generatedRegionName}\n\n${args.manualRegion}`;
 }

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
 export { defineConfig } from "./config.js";
 export type { StrybkConfig, StorybookGlobals } from "./config.js";
 export { generateScreenshots } from "./generate/index.js";
-export { createStrybkFixtures, switchStory } from "./playwright/index.js";
+export { test, expect, switchStory } from "./playwright/index.js";

package/dist/src/index.js

@@ -1,3 +1,3 @@
 export { defineConfig } from "./config.js";
 export { generateScreenshots } from "./generate/index.js";
-export { createStrybkFixtures, switchStory } from "./playwright/index.js";
+export { test, expect, switchStory } from "./playwright/index.js";

package/dist/src/playwright/index.d.ts

@@ -1,2 +1,5 @@
-export { createStrybkFixtures } from "./fixtures.js";
 export { switchStory } from "./switchStory.js";
+export declare const test: import("playwright/test").TestType<import("playwright/test").PlaywrightTestArgs & import("playwright/test").PlaywrightTestOptions & {
+    sharedPage: import("playwright-core").Page;
+}, import("playwright/test").PlaywrightWorkerArgs & import("playwright/test").PlaywrightWorkerOptions>;
+export declare const expect: import("playwright/test").Expect<{}>;

package/dist/src/playwright/index.js

@@ -1,2 +1,5 @@
-export { createStrybkFixtures } from "./fixtures.js";
+import { createStrybkFixtures } from "./fixtures.js";
 export { switchStory } from "./switchStory.js";
+const fixtures = createStrybkFixtures();
+export const test = fixtures.test;
+export const expect = fixtures.expect;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvy/strybk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Generator-first Playwright screenshot testing for Storybook.",
   "keywords": [
     "crvy",
@@ -20,7 +20,7 @@
     "url": "git+https://github.com/creevey/strybk.git"
   },
   "bin": {
-    "strybk": "./dist/src/cli.js"
+    "crvy-strybk": "./dist/src/cli.js"
   },
   "files": [
     "dist/",
@@ -89,7 +89,7 @@
   },
   "engines": {
     "bun": ">=1.3.0",
-    "node": ">=24"
+    "node": ">=22"
   },
   "packageManager": "bun@1.3.13"
 }