forgebook 0.3.0 → 0.3.2

package/dist/src/vite/pluginIds.d.ts

@@ -21,6 +21,21 @@ export declare const virtualId: (source: string) => string | undefined;
  * @param id - the module's id.
  */
 export declare const isGroupId: (id: string) => boolean;
+/**
+ * The group a project's module names for a group's module: the story files of their "Used in", reach, search index and
+ * texts, the docs pages of their search index. Those read the same files and only their group's module imports them, so
+ * a client that already holds the group's module needs no other import to have been seen.
+ *
+ * @param id - a group's module's id.
+ */
+export declare const namingGroupOf: (id: string) => string;
+/**
+ * Whether a module's text names a group. Its transform must run for the plugin to see the import, so a cache of
+ * transforms must not keep it.
+ *
+ * @param code - the module's text.
+ */
+export declare const namesGroup: (code: string) => boolean;
 /** The resolved id of the configuration's data module. */
 export declare const CONFIG_ID = "\0virtual:forgebook/config";
 /** The resolved id of the design tokens' module. */

package/dist/src/vite/pluginIds.js

@@ -70,6 +70,29 @@ export const virtualId = (source) => {
  * @param id - the module's id.
  */
 export const isGroupId = (id) => VIRTUAL_PREFIXES.some((prefix) => id.startsWith(`\0${prefix}`));
+/** The modules that read a group of story files' own files: named once its story files are. */
+const STORY_FILES_READERS = [USAGE_PREFIX, REACH_PREFIX, SEARCH_PREFIX, TEXTS_PREFIX];
+/**
+ * The group a project's module names for a group's module: the story files of their "Used in", reach, search index and
+ * texts, the docs pages of their search index. Those read the same files and only their group's module imports them, so
+ * a client that already holds the group's module needs no other import to have been seen.
+ *
+ * @param id - a group's module's id.
+ */
+export const namingGroupOf = (id) => {
+    const pagesSearch = `\0${PAGES_SEARCH_PREFIX}`;
+    if (id.startsWith(pagesSearch))
+        return `${DOCS_PAGES_PREFIX}${id.slice(pagesSearch.length)}`;
+    const reader = STORY_FILES_READERS.map((prefix) => `\0${prefix}`).find((mark) => id.startsWith(mark));
+    return reader === undefined ? id : `${FILES_PREFIX}${id.slice(reader.length)}`;
+};
+/**
+ * Whether a module's text names a group. Its transform must run for the plugin to see the import, so a cache of
+ * transforms must not keep it.
+ *
+ * @param code - the module's text.
+ */
+export const namesGroup = (code) => [FILES_QUERY, DOCS_PAGES_QUERY, ...VIRTUAL_PREFIXES].some((name) => code.includes(name));
 /** The resolved id of the configuration's data module. */
 export const CONFIG_ID = `\0${CONFIG_MODULE}`;
 /** The resolved id of the design tokens' module. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgebook",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "See every component in every theme, contrast, language and width: CSF stories, one frame per story, and a props table from the components' types.",
   "keywords": [
     "react",
@@ -232,6 +232,10 @@
     "./code-literal": {
       "types": "./dist/src/codeLiteral.d.ts",
       "default": "./dist/src/codeLiteral.js"
+    },
+    "./story-mocks": {
+      "types": "./dist/src/storyMocks.d.ts",
+      "default": "./dist/src/storyMocks.js"
     }
   },
   "dependencies": {
@@ -240,7 +244,7 @@
     "lightningcss": "1.33.0",
     "marked": "18.1.0",
     "typescript-6": "npm:typescript@6.0.3",
-    "@forgebook/story-format": "0.2.1"
+    "@forgebook/story-format": "0.2.3"
   },
   "peerDependencies": {
     "@testing-library/dom": "^10.4.0",
@@ -248,7 +252,7 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "sass-embedded": "^1.80.0",
-    "vite": "^8.0.0"
+    "vite": "^8.3.4"
   },
   "devDependencies": {
     "@testing-library/dom": "10.4.2",
@@ -262,8 +266,8 @@
     "sass-embedded": "1.106.1",
     "vite": "8.3.5",
     "vitest": "5.0.5",
-    "@forgebook/tools": "0.0.0",
-    "@forgebook/typescript-config": "0.0.0"
+    "@forgebook/typescript-config": "0.0.0",
+    "@forgebook/tools": "0.0.0"
   },
   "peerDependenciesMeta": {
     "@testing-library/dom": {