forgebook 0.2.0 → 0.3.0

package/dist/src/vite/pluginModules.js

@@ -10,11 +10,15 @@
  */
 import { codeLiteral } from "../codeLiteral.js";
 import { packedUsage } from "../usedIn.js";
-import { indexedStoryFiles, PAGES_SEARCH_PREFIX, REACH_PREFIX, SEARCH_PREFIX, storyFilesCode, storyFilesGroupOf, TEXTS_PREFIX, USAGE_PREFIX } from "./storyFilesModule.js";
+import { EVERY_FILE, FILES_SPECIFIER_PREFIX, indexedStoryFiles, PAGES_SEARCH_PREFIX, REACH_PREFIX, SEARCH_PREFIX, storyFileKeys, storyFilesCode, storyFilesGroupOf, TEXTS_PREFIX, USAGE_PREFIX } from "./storyFilesModule.js";
 import { storyReach } from "./storyReach.js";
 import { joinedUsage } from "./usageModule.js";
-/** The id of a pattern's module: virtual, with the declaring module's folder and the pattern after it. */
-export const FILES_PREFIX = "\0forgebook-files:";
+import { VITE_PATHS } from "./vitePaths.js";
+/**
+ * The id of a group of story files' module: virtual, with the declaring module's folder and the patterns after it,
+ * whether a `?forgebook-files` import or the group's specifier (`FILES_SPECIFIER_PREFIX`) names it.
+ */
+export const FILES_PREFIX = `\0${FILES_SPECIFIER_PREFIX}`;
 /** The resolved id of a group's "Used in" module: Rollup's mark of a virtual module, then its import's specifier. */
 export const USAGE_ID_PREFIX = `\0${USAGE_PREFIX}`;
 /** The resolved id of a group's reach module, the same way. */
@@ -51,7 +55,7 @@ export const docsModule = (component, watch) => ({
     moduleType: "js"
 });
 /**
- * The module of a `?forgebook-files` pattern: every matched story file's index and loaders; with the files, indexed,
+ * The module of a group of story files: every listed story file's index and loaders; with the files, indexed,
  * which the dev server keeps to tell an edit that changes the list.
  *
  * @param id - the module's id (`FILES_PREFIX`, then the group: `storyFilesGroupText`).
@@ -61,18 +65,51 @@ export const docsModule = (component, watch) => ({
  * @param warm - starts reading the docs of a story file ahead of its request; none in a test run.
  * @param startTexts - a build's: starts reading the files' docs, code and pages, which the module imports from the
  * group's texts module (`builtTexts.ts`); none imports each from its query.
+ * @param isKept - whether a listed file may be read; every one by default.
  * @throws when a story file cannot be indexed.
  */
-export const patternModule = (id, watch, loaders, cache, warm, startTexts) => {
-    const { root, pattern } = storyFilesGroupOf(id.slice(FILES_PREFIX.length));
-    const files = indexedStoryFiles(root, pattern, watch, cache);
+export const patternModule = (id, watch, loaders, cache, warm, startTexts, isKept = EVERY_FILE) => {
+    const { root, patterns } = storyFilesGroupOf(id.slice(FILES_PREFIX.length));
+    const files = indexedStoryFiles(root, patterns, watch, cache, isKept);
     const [first] = files;
     if (first !== undefined)
         warm?.(first.file);
     startTexts?.(files);
-    const code = storyFilesCode(root, pattern, files, loaders, startTexts !== undefined);
+    const code = storyFilesCode(root, patterns, files, loaders, startTexts !== undefined);
     return { code, moduleType: "js", files };
 };
+/**
+ * Whether a story file added or removed changes what a group of story files lists: listed now and not when its module
+ * was served, or the other way round. A file no pattern lists, or one a `!` pattern leaves out, changes nothing, so
+ * the pages need no reload for it.
+ *
+ * @param id - the group's module's id (`FILES_PREFIX`, then the group).
+ * @param listed - the files its module listed when served, absolute in Vite's form; none when it could not be made.
+ * @param file - the file added or removed.
+ * @param isKept - whether a listed file may be read; every one by default.
+ */
+export const isListingChanged = (id, listed, file, isKept = EVERY_FILE) => {
+    if (listed === undefined)
+        return true;
+    const { root, patterns } = storyFilesGroupOf(id.slice(FILES_PREFIX.length));
+    const isListed = storyFileKeys(root, patterns, isKept).includes(VITE_PATHS.relativeKey(root, file));
+    return isListed !== listed.has(VITE_PATHS.normalize(file));
+};
+/**
+ * The modules a story file added or removed renews: the groups whose list it changes (`isListingChanged`) and, with
+ * them, the modules that read their files; none when it changes no list.
+ *
+ * @param served - the groups' modules, with the files each listed when served.
+ * @param file - the file added or removed.
+ * @param readers - the modules that read the groups' files: their "Used in" and search indexes.
+ * @param isKept - whether a listed file may be read; every one by default.
+ */
+export const listingRenewals = (served, file, readers, isKept = EVERY_FILE) => {
+    const changed = [...served]
+        .filter(([id, listed]) => isListingChanged(id, listed, file, isKept))
+        .map(([id]) => id);
+    return changed.length === 0 ? undefined : [...changed, ...readers];
+};
 /**
  * A group's facts: its story files indexed, what their stories render read in the docs worker.
  *
@@ -80,10 +117,11 @@ export const patternModule = (id, watch, loaders, cache, warm, startTexts) => {
  * @param watch - adds a file whose edit renews the module (each story file).
  * @param usage - reads the facts in the docs worker.
  * @param cache - the pattern's index kept between starts; none reads every file.
+ * @param isKept - whether a listed file may be read.
  */
-const groupUsage = async (group, watch, usage, cache) => {
-    const { root, pattern } = storyFilesGroupOf(group);
-    const files = indexedStoryFiles(root, pattern, watch, cache);
+const groupUsage = async (group, watch, usage, cache, isKept) => {
+    const { root, patterns } = storyFilesGroupOf(group);
+    const files = indexedStoryFiles(root, patterns, watch, cache, isKept);
     const graph = await usage(files.map((file) => ({
         storyFile: file.file,
         exports: file.index.stories.map((story) => story.exportName)
@@ -99,9 +137,10 @@ const groupUsage = async (group, watch, usage, cache) => {
  * @param usage - reads the facts in the docs worker.
  * @param cache - the pattern's index kept between starts; none reads every file.
  * @param pack - writes the module's JSON as its value: as it is on a dev server, in a gzipped file of a build's.
+ * @param isKept - whether a listed file may be read; every one by default.
  */
-export const usageModule = async (id, watch, usage, cache, pack) => {
-    const { files, graph } = await groupUsage(id.slice(USAGE_ID_PREFIX.length), watch, usage, cache);
+export const usageModule = async (id, watch, usage, cache, pack, isKept = EVERY_FILE) => {
+    const { files, graph } = await groupUsage(id.slice(USAGE_ID_PREFIX.length), watch, usage, cache, isKept);
     const answer = typeof graph === "string"
         ? { error: graph }
         : packedUsage(joinedUsage(graph, files.map((file) => ({
@@ -120,9 +159,10 @@ export const usageModule = async (id, watch, usage, cache, pack) => {
  * @param watch - adds a file whose edit renews the module (each story file).
  * @param usage - reads the facts in the docs worker.
  * @param cache - the pattern's index kept between starts; none reads every file.
+ * @param isKept - whether a listed file may be read; every one by default.
  */
-export const reachModule = async (id, watch, usage, cache) => {
-    const { files, graph } = await groupUsage(id.slice(REACH_ID_PREFIX.length), watch, usage, cache);
+export const reachModule = async (id, watch, usage, cache, isKept = EVERY_FILE) => {
+    const { files, graph } = await groupUsage(id.slice(REACH_ID_PREFIX.length), watch, usage, cache, isKept);
     const reach = typeof graph === "string"
         ? []
         : storyReach(graph, files.map((file) => ({ storyFile: file.file, title: file.index.title })));
@@ -134,7 +174,7 @@ export const reachModule = async (id, watch, usage, cache) => {
  *
  * @param id - the module's id.
  * @param watch - adds a file whose edit renews the module.
- * @param read - a story file's component docs, and how the module writes its JSON.
+ * @param read - a story file's component docs, how the module writes its JSON, and which listed files may be read.
  * @returns the index; none for another id.
  */
 export const searchIndexModule = async (id, watch, read) => {
@@ -142,17 +182,17 @@ export const searchIndexModule = async (id, watch, read) => {
     if (!isPages && !id.startsWith(SEARCH_ID_PREFIX))
         return undefined;
     const { storySearchModule, pagesSearchModule } = await import("./searchModule.js");
-    const { root, pattern } = storyFilesGroupOf(id.slice((isPages ? PAGES_SEARCH_ID_PREFIX : SEARCH_ID_PREFIX).length));
+    const { root, patterns } = storyFilesGroupOf(id.slice((isPages ? PAGES_SEARCH_ID_PREFIX : SEARCH_ID_PREFIX).length));
     const code = isPages
-        ? pagesSearchModule(root, pattern, watch, read.pack)
-        : await storySearchModule(root, pattern, watch, read.docsOf, read.isServing, read.pack);
+        ? pagesSearchModule(root, patterns, watch, read.pack, read.isKept)
+        : await storySearchModule(root, patterns, watch, read.docsOf, read.isServing, read.pack, read.isKept);
     return { module: { code, moduleType: "js" }, isPages };
 };
 /**
  * The search's indexes of a plugin: a build reads each component's docs once, for its page and its index.
  *
- * @param read - reads a story file's component docs, says whether a dev server runs, and keeps each index's id with the
- * modules an edit renews (a docs pages' index with the docs pages').
+ * @param read - reads a story file's component docs, says whether a dev server runs, keeps each index's id with the
+ * modules an edit renews (a docs pages' index with the docs pages'), and says which listed files may be read.
  */
 export const searchIndexes = (read) => {
     const built = new Map();
@@ -166,7 +206,12 @@ export const searchIndexes = (read) => {
     return {
         docsOf,
         moduleOf: async (id, watch, pack) => {
-            const search = await searchIndexModule(id, watch, { docsOf, isServing: read.isServing(), pack });
+            const search = await searchIndexModule(id, watch, {
+                docsOf,
+                isServing: read.isServing(),
+                pack,
+                isKept: read.isKept
+            });
             if (search === undefined)
                 return undefined;
             read.track(id, search.isPages);

package/dist/src/vite/prebundled.js

@@ -86,6 +86,7 @@ export const scannedEntries = (config, resolve, readText) => {
             return [];
         return [...text.matchAll(FILES_IMPORT)].flatMap((match) => match[1] === undefined ? [] : [VITE_PATHS.join(VITE_PATHS.dirname(file), match[1])]);
     });
-    // the previews too: what they import loads with the first story, and found then it reloads the page
+    // the previews too: what they import loads with the first story, and found then it reloads the page; the project's
+    // `!` patterns stay as they are, which Vite's scanner reads as fast-glob does, from the same folder
     return [...config.stories, ...fromSources, ...config.previews];
 };

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

@@ -2,6 +2,7 @@ import type { DocBlock } from "../docPages.ts";
 import type { SearchSection } from "../searchIndex.ts";
 import type { DocsResult } from "./docsExtractor.ts";
 import type { PackJson } from "./packedModule.ts";
+import { type IsFileKept } from "./storyFilesModule.ts";
 /**
  * HTML as stretches of documentation, one per heading that carries an anchor.
  *
@@ -20,7 +21,7 @@ export declare const blockSections: (blocks: readonly DocBlock[]) => SearchSecti
  * A group of story files' search index, as the code of its module.
  *
  * @param root - the declaring module's folder.
- * @param pattern - the pattern.
+ * @param patterns - the group's patterns.
  * @param watch - adds a file whose edit renews the module.
  * @param extract - reads a story file's component.
  * @param isServing - whether a dev server runs: only its tools read the problems, which name files on this computer, so
@@ -28,13 +29,14 @@ export declare const blockSections: (blocks: readonly DocBlock[]) => SearchSecti
  * @param pack - writes the index's JSON as the module's value: as it is, or in a gzipped file of a build's own, which
  * few visits read.
  */
-export declare const storySearchModule: (root: string, pattern: string, watch: (file: string) => void, extract: (storyFile: string) => Promise<DocsResult>, isServing: boolean, pack: PackJson) => Promise<string>;
+export declare const storySearchModule: (root: string, patterns: readonly string[], watch: (file: string) => void, extract: (storyFile: string) => Promise<DocsResult>, isServing: boolean, pack: PackJson, isKept?: IsFileKept) => Promise<string>;
 /**
  * A group of docs pages' search index, as the code of its module.
  *
  * @param root - the declaring module's folder.
- * @param pattern - the pattern.
+ * @param patterns - the group's patterns.
  * @param watch - adds a file whose edit renews the module.
  * @param pack - writes the index's JSON as the module's value.
+ * @param isKept - whether a listed page may be read; every one by default.
  */
-export declare const pagesSearchModule: (root: string, pattern: string, watch: (file: string) => void, pack: PackJson) => string;
+export declare const pagesSearchModule: (root: string, patterns: readonly string[], watch: (file: string) => void, pack: PackJson, isKept?: IsFileKept) => string;

package/dist/src/vite/searchModule.js

@@ -14,7 +14,7 @@ import { readFileSync } from "node:fs";
 import { componentPage } from "./componentPage.js";
 import { compiledDocPage } from "./docPageMarkdown.js";
 import { indexedDocPages } from "./docPagesModule.js";
-import { indexedStoryFiles } from "./storyFilesModule.js";
+import { EVERY_FILE, indexedStoryFiles } from "./storyFilesModule.js";
 /** A heading of the pages' HTML: its anchor, and what is inside it. */
 const HEADING = /<h[1-6] id="doc-([^"]*)"[^>]*>([\s\S]*?)<\/h[1-6]>/g;
 /** A tag: `>` inside a quoted attribute does not end it. */
@@ -177,7 +177,7 @@ const entryOf = (file, read, watch) => {
  * A group of story files' search index, as the code of its module.
  *
  * @param root - the declaring module's folder.
- * @param pattern - the pattern.
+ * @param patterns - the group's patterns.
  * @param watch - adds a file whose edit renews the module.
  * @param extract - reads a story file's component.
  * @param isServing - whether a dev server runs: only its tools read the problems, which name files on this computer, so
@@ -185,8 +185,8 @@ const entryOf = (file, read, watch) => {
  * @param pack - writes the index's JSON as the module's value: as it is, or in a gzipped file of a build's own, which
  * few visits read.
  */
-export const storySearchModule = async (root, pattern, watch, extract, isServing, pack) => {
-    const files = indexedStoryFiles(root, pattern, watch);
+export const storySearchModule = async (root, patterns, watch, extract, isServing, pack, isKept = EVERY_FILE) => {
+    const files = indexedStoryFiles(root, patterns, watch, undefined, isKept);
     const entries = await Promise.all(files.map(async (file) => ({ file, ...entryOf(file, await extract(file.file), watch) })));
     const problems = entries.flatMap(({ problem }) => problem ?? []);
     const index = {
@@ -199,12 +199,13 @@ export const storySearchModule = async (root, pattern, watch, extract, isServing
  * A group of docs pages' search index, as the code of its module.
  *
  * @param root - the declaring module's folder.
- * @param pattern - the pattern.
+ * @param patterns - the group's patterns.
  * @param watch - adds a file whose edit renews the module.
  * @param pack - writes the index's JSON as the module's value.
+ * @param isKept - whether a listed page may be read; every one by default.
  */
-export const pagesSearchModule = (root, pattern, watch, pack) => {
-    const pages = indexedDocPages(root, pattern, watch).map(({ key, file }) => [
+export const pagesSearchModule = (root, patterns, watch, pack, isKept = EVERY_FILE) => {
+    const pages = indexedDocPages(root, patterns, watch, [], isKept).map(({ key, file }) => [
         key,
         blockSections(compiledDocPage(file, readFileSync(file, "utf8")).blocks)
     ]);

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

@@ -1,23 +1,31 @@
 import type { StoryFileIndex } from "@forgebook/story-format/source";
 import { type DiskCache } from "./diskCache.ts";
-/** A pattern of story files and the folder it is read from: the declaring module's folder, the import's pattern. */
+/**
+ * A group of story files and the folder its patterns are read from: the declaring module's folder, the import's
+ * patterns.
+ */
 export type StoryFilesGroup = {
     /** The declaring module's folder, absolute: the files' keys are relative to it. */
     readonly root: string;
-    /** The pattern relative to it, its leading `./` dropped (`../src/**\/*.stories.tsx`). */
-    readonly pattern: string;
+    /**
+     * The patterns relative to it, their leading `./` dropped (`../src/**\/*.stories.tsx`), and the `!` ones that leave
+     * files out (`listedFiles`).
+     */
+    readonly patterns: readonly string[];
 };
+/** Between a group's parts in a module's id: no path or pattern holds it. */
+export declare const GROUP_SEPARATOR = "::";
 /**
- * A `?forgebook-files` group written for a module's id: the folder, how many folders the pattern climbs, and the rest
- * of the pattern. A Vite module's id is served under a URL path, whose normalisation would let a `..` remove the part
- * before it (`app::../storybook`: the folder and the separator), so the pattern's leading `../` are counted, never
+ * A group of story files written for a module's id: the folder, then for each pattern how many folders it climbs and
+ * the rest of it. A Vite module's id is served under a URL path, whose normalisation would let a `..` remove the part
+ * before it (`app::../storybook`: the folder and the separator), so a pattern's leading `../` are counted, never
  * written. The files keep their keys relative to the declaring module (`../src/x.stories.tsx`), unique in a source and
  * the testing package's too.
  *
  * @param folder - the declaring module's folder.
- * @param pattern - the pattern as the import writes it (`../src/**\/*.stories.tsx`).
+ * @param patterns - the patterns as the import or the configuration writes them (`../src/**\/*.stories.tsx`).
  */
-export declare const storyFilesGroupText: (folder: string, pattern: string) => string;
+export declare const storyFilesGroupText: (folder: string, patterns: readonly string[]) => string;
 /**
  * A group read back from a module's id (`storyFilesGroupText`).
  *
@@ -25,12 +33,31 @@ export declare const storyFilesGroupText: (folder: string, pattern: string) => s
  */
 export declare const storyFilesGroupOf: (text: string) => StoryFilesGroup;
 /**
- * The story files patterns match, as paths relative to `root` starting with `./` or `../`, sorted.
+ * Whether a file a group lists may be read. A dev server refuses what `server.fs.deny` names (`fileAccess.ts`).
+ *
+ * @param file - the file, absolute in Vite's form.
+ */
+export type IsFileKept = (file: string) => boolean;
+/** Every file a group lists: a build's, and a test's that reads the files from the disk. */
+export declare const EVERY_FILE: IsFileKept;
+/**
+ * The story files patterns list, as paths relative to `root` starting with `./` or `../`, each once, sorted: the union
+ * of the patterns less what the `!` ones match (`listedFiles`).
  *
  * @param root - the folder the patterns are relative to: the declaring module's.
- * @param patterns - the patterns (`../src/**\/*.stories.tsx`).
+ * @param patterns - the patterns (`../src/**\/*.stories.tsx`, `!../src/**\/legacy/*`).
+ * @param isKept - whether a listed file may be read; every one by default.
+ * @throws when every pattern is a `!` one.
+ */
+export declare const storyFileKeys: (root: string, patterns: readonly string[], isKept?: IsFileKept) => string[];
+/**
+ * The specifier prefix of a group of story files named by its patterns, the group following (`storyFilesGroupText`):
+ * how the module generated for a catalogue's `stories` imports them as one group, `!` patterns included, which a
+ * `?forgebook-files` import of one pattern cannot say.
  */
-export declare const storyFileKeys: (root: string, patterns: readonly string[]) => string[];
+export declare const FILES_SPECIFIER_PREFIX = "virtual:forgebook-files:";
+/** The specifier prefix of a group of docs pages named by its patterns, the same way: a catalogue's `docs`. */
+export declare const DOCS_PAGES_SPECIFIER_PREFIX = "virtual:forgebook-docs-pages:";
 /**
  * The id prefix of a group's "Used in" module: the group follows (`storyFilesGroupText`), as in a `?forgebook-files`
  * module's id. The plugin answers it (`usageModule.ts`) only when a page asks.
@@ -53,66 +80,71 @@ export declare const TEXTS_PREFIX = "virtual:forgebook-texts:";
  * it, so a page that shows "Used in" never downloads it.
  */
 export declare const REACH_PREFIX = "virtual:forgebook-reach:";
-/** A story file a pattern matches, with its key and its index. */
+/** A story file a group lists, with its key, the pattern that lists it and its index. */
 export type IndexedStoryFile = {
     /** Its path relative to the declaring module (`../src/x.stories.tsx`). */
     readonly key: string;
+    /** The group's first pattern that lists it, whose static start begins its title when its meta writes none. */
+    readonly pattern: string;
     /** Its absolute path. */
     readonly file: string;
     /** Its index. */
     readonly index: StoryFileIndex;
 };
-/** A pattern's index as it is kept between starts, by file key. */
+/** A group's index as it is kept between starts, by file key. */
 export type KeptIndex = Readonly<Record<string, StoryFileIndex>>;
-/** Whether what a cache file holds is a pattern's index. */
+/** Whether what a cache file holds is a group's index. */
 export declare const isKeptIndex: (value: unknown) => value is KeptIndex;
 /**
- * One story file a pattern matches, indexed from its text on disk, with the title its path makes when it writes none.
+ * One story file a pattern lists, indexed from its text on disk, with the title its path makes when it writes none.
  *
  * @internal
  * @param root - the declaring module's folder.
- * @param pattern - the pattern.
+ * @param pattern - the pattern that lists it.
  * @param key - the file's path relative to the declaring module.
  * @returns the index, or a message saying why the file cannot be indexed.
  */
 export declare const storyFileIndex: (root: string, pattern: string, key: string) => StoryFileIndex | string;
 /**
- * Every story file a pattern matches, indexed.
+ * Every story file a group's patterns list, indexed.
  *
  * @param root - the declaring module's folder.
- * @param pattern - the pattern.
+ * @param patterns - the patterns (`storyFileKeys`).
  * @param watch - adds a file whose edit renews the module that read it.
  * @param cache - the index kept between starts, which holds while the files it came from do; none reads them all.
+ * @param isKept - whether a listed file may be read; every one by default.
  * @throws when a story file cannot be indexed.
  */
-export declare const indexedStoryFiles: (root: string, pattern: string, watch: (file: string) => void, cache?: DiskCache<KeptIndex>) => IndexedStoryFile[];
+export declare const indexedStoryFiles: (root: string, patterns: readonly string[], watch: (file: string) => void, cache?: DiskCache<KeptIndex>, isKept?: IsFileKept) => IndexedStoryFile[];
 /** The loaders a group offers besides its story files'. */
 export type GroupLoaders = {
+    /** Whether it offers each story file's component docs (the catalogue reads them); `true` by default. */
+    readonly hasDocs?: boolean;
     /** Whether it offers its "Used in" (the catalogue did not turn it off). */
     readonly hasUsage: boolean;
     /** Whether it offers what each story reaches: only on a dev server, for its tools. */
     readonly hasReach: boolean;
 };
 /**
- * The code of the module for one pattern.
+ * The code of the module for one group.
  *
  * @param root - the declaring module's folder.
- * @param pattern - the pattern before `?forgebook-files`.
+ * @param patterns - the group's patterns.
  * @param watch - adds a file whose edit renews the module (each story file: its index is in the module).
- * @param loaders - the group's loaders besides its story files'; both by default.
+ * @param loaders - the group's loaders besides its story files'; all of them by default.
  * @param cache - the index kept between starts.
  * @returns the module's code, or a message saying which file cannot be indexed.
  */
-export declare const storyFilesModule: (root: string, pattern: string, watch: (file: string) => void, loaders?: GroupLoaders, cache?: DiskCache<KeptIndex>) => string;
+export declare const storyFilesModule: (root: string, patterns: readonly string[], watch: (file: string) => void, loaders?: GroupLoaders, cache?: DiskCache<KeptIndex>) => string;
 /**
- * The code of the module for one pattern, from its story files indexed.
+ * The code of the module for one group, from its story files indexed.
  *
  * @internal
  * @param root - the declaring module's folder.
- * @param pattern - the pattern before `?forgebook-files`.
- * @param files - the story files it matches, indexed.
+ * @param patterns - the group's patterns.
+ * @param files - the story files it lists, indexed.
  * @param loaders - the group's loaders besides its story files'.
  * @param hasTexts - a build's: whether each file's docs, code and page come from the group's texts module, in the
  * rows' order (`TEXTS_PREFIX`), and not each from its query.
  */
-export declare const storyFilesCode: (root: string, pattern: string, files: readonly IndexedStoryFile[], loaders: GroupLoaders, hasTexts?: boolean) => string;
+export declare const storyFilesCode: (root: string, patterns: readonly string[], files: readonly IndexedStoryFile[], loaders: GroupLoaders, hasTexts?: boolean) => string;