forgebook 0.1.2 → 0.1.4

package/dist/bin/forgebook/mcpTools.js

@@ -0,0 +1,212 @@
+/**
+ * The tools `forgebook mcp` offers agents, each answered as the command of the same name answers: `list_stories`,
+ * `get_story`, `story_address`, `new_stories`, `check_story`, `recent_errors` and `story_shot`.
+ *
+ * @module
+ */
+import { mkdtempSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { filteredStories, isStoriesDocument } from "../../src/vite/agentApi.js";
+import { askErrors } from "./errorsRun.js";
+/** The schema of the view argument, shared by the tools. */
+const VIEW = {
+    type: "string",
+    description: "The view the links open in, as the catalogue's address writes it (theme=dark&lang=it); none for the default."
+};
+/** A text argument, or none. */
+const textOf = (args, name) => {
+    const value = args[name];
+    return typeof value === "string" && value !== "" ? value : undefined;
+};
+/** An answer as a tool's result: a failure when the catalogue did not answer 200. */
+const resultOf = (answer) => ({
+    structured: answer.body,
+    isError: answer.status !== 200
+});
+/**
+ * The tools.
+ *
+ * @param reach - what they reach the catalogue through.
+ */
+export const catalogueTools = ({ ask, writeNew, check, shot }) => [
+    {
+        name: "list_stories",
+        description: "List the catalogue's components and stories, with each story's id and the links that open it, and the problems the story index found. Filter by source id or by text in a component's title.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                source: { type: "string", description: "Only this source's stories (its id)." },
+                component: { type: "string", description: "Only components whose title holds this text, any case." },
+                usedIn: {
+                    type: "boolean",
+                    description: "Add each component's usedIn: the components whose stories use it, directly or through another. Reads the package's import graph, so the first call takes longer."
+                },
+                view: VIEW
+            },
+            additionalProperties: false
+        },
+        call: async (args) => {
+            const answer = await ask("stories", new URLSearchParams({ view: textOf(args, "view") ?? "", usedIn: String(args["usedIn"] === true) }));
+            if (answer.status !== 200 || !isStoriesDocument(answer.body))
+                return resultOf(answer);
+            const filter = { source: textOf(args, "source"), component: textOf(args, "component") };
+            return { structured: filteredStories(answer.body, filter), isError: false };
+        }
+    },
+    {
+        name: "get_story",
+        description: "One story in detail: its args as the catalogue renders it, its component's props (types, defaults, descriptions), the components whose stories use it (usedIn), its links in the view asked for, and what failed while reading it.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "The story's id, as list_stories gives it." },
+                view: VIEW
+            },
+            required: ["id"],
+            additionalProperties: false
+        },
+        call: async (args) => resultOf(await ask("story", new URLSearchParams({ id: textOf(args, "id") ?? "", view: textOf(args, "view") ?? "" })))
+    },
+    {
+        name: "story_address",
+        description: "The links that open a story in the catalogue and in its frame alone, in the view asked for: give them to a person to look at what you describe.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "The story's id, as list_stories gives it." },
+                view: VIEW
+            },
+            required: ["id"],
+            additionalProperties: false
+        },
+        call: async (args) => {
+            const id = textOf(args, "id") ?? "";
+            const answer = await ask("stories", new URLSearchParams({ view: textOf(args, "view") ?? "" }));
+            if (answer.status !== 200 || !isStoriesDocument(answer.body))
+                return resultOf(answer);
+            const story = answer.body.components
+                .flatMap((component) => component.stories)
+                .find((each) => each.id === id);
+            return story === undefined
+                ? { structured: { error: `No story "${id}"` }, isError: true }
+                : { structured: { id, links: story.links }, isError: false };
+        }
+    },
+    {
+        name: "new_stories",
+        description: "Write a component's first stories from its typed props (the main story with its required props, one story per value of its first choice prop, the worst case) and answer the file's text and where it would go; writes nothing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file: {
+                    type: "string",
+                    description: "The component's file, relative to the catalogue's folder or absolute."
+                },
+                export: { type: "string", description: "The component to read, when the file exports several." }
+            },
+            required: ["file"],
+            additionalProperties: false
+        },
+        call: async (args) => {
+            try {
+                const written = await writeNew(textOf(args, "file") ?? "", textOf(args, "export"));
+                return { structured: { file: written.file, text: written.text }, isError: false };
+            }
+            catch (error) {
+                return {
+                    structured: { error: error instanceof Error ? error.message : String(error) },
+                    isError: true
+                };
+            }
+        }
+    },
+    {
+        name: "check_story",
+        description: "Run the catalogue's checks on a story in a browser, as its tests do: accessibility (axe), elements spilling out of their parents, overlays past the frame, the page's errors (a failed play among them), a story that could not be shown. Give a component's id to check all its stories. Needs @forgebook/testing and Playwright in the project.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "A story's id, or a component's for its listed stories." },
+                views: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "The views to check in, each as the catalogue's address writes it (theme=dark&width=360); the default view when none."
+                },
+                allVariants: {
+                    type: "boolean",
+                    description: "Check every variant the catalogue's browser tests check."
+                }
+            },
+            required: ["id"],
+            additionalProperties: false
+        },
+        call: async (args) => {
+            const views = Array.isArray(args["views"])
+                ? args["views"].filter((view) => typeof view === "string")
+                : [];
+            const report = await check({
+                id: textOf(args, "id") ?? "",
+                views,
+                isAllVariants: args["allVariants"] === true
+            });
+            if (typeof report === "string")
+                return { structured: { error: report }, isError: true };
+            return { structured: report, isError: report.results.some((result) => result.problems.length > 0) };
+        }
+    },
+    {
+        name: "recent_errors",
+        description: "What the catalogue's open frames reported while you edited: stories that could not be shown and plays that failed, numbered, with the story index's problems. Give since (the last answer's last) to get only the new ones. Only frames open in a browser report; check_story checks a story without one.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                since: { type: "number", description: "Only the errors after this number; every one kept when none." }
+            },
+            additionalProperties: false
+        },
+        call: async (args) => {
+            const since = typeof args["since"] === "number" ? args["since"] : 0;
+            const document = await askErrors(ask, since);
+            if (typeof document === "string")
+                return { structured: { error: document }, isError: true };
+            return { structured: document, isError: false };
+        }
+    },
+    {
+        name: "story_shot",
+        description: "Take a story's pictures in a browser, one per view, and look at them: the answer holds the pictures themselves, and the PNG files' paths. Views are written as the catalogue's address writes them (theme=dark&width=360) or as words (\"dark it 360\"). Needs @forgebook/testing and Playwright in the project.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "A story's id, or a component's for its listed stories." },
+                views: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "The views to picture it in; the default view when none."
+                },
+                allVariants: {
+                    type: "boolean",
+                    description: "Picture every variant the catalogue's browser tests check."
+                }
+            },
+            required: ["id"],
+            additionalProperties: false
+        },
+        call: async (args) => {
+            const views = Array.isArray(args["views"])
+                ? args["views"].filter((view) => typeof view === "string")
+                : [];
+            const outDir = mkdtempSync(join(tmpdir(), "forgebook-shot-"));
+            const report = await shot({ id: textOf(args, "id") ?? "", views, isAllVariants: args["allVariants"] === true }, outDir);
+            if (typeof report === "string")
+                return { structured: { error: report }, isError: true };
+            const images = report.shots.map((each) => ({
+                data: readFileSync(each.file).toString("base64"),
+                mimeType: "image/png"
+            }));
+            return { structured: report, isError: false, images };
+        }
+    }
+];
+//# sourceMappingURL=mcpTools.js.map

package/dist/bin/forgebook/mcpTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpTools.js","sourceRoot":"","sources":["../../../bin/forgebook/mcpTools.ts"],"names":[],"mappings":"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"}

package/dist/bin/forgebook/newStories.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The first stories of a component, written from its props as the docs extractor reads them (`forgebook new`): the
+ * meta, the main story with the required props filled, one story per value of its first choice prop, and the worst
+ * case. Args only, so the file is the same for any framework but its type import. Pure: docs in, text out.
+ *
+ * @module
+ */
+import type { ComponentDocs } from "../../src/componentDocs.ts";
+/** What the file is written from. */
+export type NewStoriesInput = {
+    /** The component's docs (its props). */
+    readonly docs: ComponentDocs;
+    /** How the story file imports the component (`./Badge`). */
+    readonly importPath: string;
+    /** The meta's title (`Actions/Badge`). */
+    readonly title: string;
+    /** The module the story types come from (`@forgebook/react`). */
+    readonly typesModule: string;
+};
+/**
+ * The story file's text.
+ *
+ * @param input - the component's docs, its import, the title and the story types' module.
+ * @returns the file, ending with a newline.
+ */
+export declare const newStories: (input: NewStoriesInput) => string;
+//# sourceMappingURL=newStories.d.ts.map

package/dist/bin/forgebook/newStories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newStories.d.ts","sourceRoot":"","sources":["../../../bin/forgebook/newStories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,4BAA4B,CAAC;AAG1E,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AA0DF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,eAAe,KAAG,MAyDnD,CAAC"}

package/dist/bin/forgebook/newStories.js

@@ -0,0 +1,109 @@
+import { WORST_NUMBER, WORST_TEXT } from "../../src/worstCase.js";
+/** A prop's name in words, for a text's value (`helperText` → `Helper text`). */
+const words = (name) => {
+    const spaced = name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase();
+    return `${spaced.charAt(0).toUpperCase()}${spaced.slice(1)}`;
+};
+/** A name in PascalCase, letters and digits only (`md` → `Md`, `x-large` → `XLarge`). */
+const pascal = (text) => text
+    .split(/[^A-Za-z0-9]+/)
+    .filter((part) => part !== "")
+    .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
+    .join("");
+/** A default written in TSDoc, as code: a number or a boolean as it is, a quoted string kept, a word quoted. */
+const defaultCode = (text) => /^(-?\d+(\.\d+)?|true|false|null|"[^"]*"|'[^']*')$/.test(text)
+    ? text.replace(/^'(.*)'$/, '"$1"')
+    : JSON.stringify(text);
+/** A required prop's value as code, from its kind; none for one the type checker must point at. */
+const requiredCode = (prop) => {
+    if (prop.defaultValue !== undefined)
+        return defaultCode(prop.defaultValue);
+    if (prop.kind === "choice" && prop.choices?.[0] !== undefined)
+        return JSON.stringify(prop.choices[0]);
+    if (prop.kind === "text")
+        return JSON.stringify(words(prop.name));
+    if (prop.kind === "number")
+        return "0";
+    if (prop.kind === "toggle")
+        return "false";
+    if (prop.kind === "event")
+        return "() => undefined";
+    // an empty list is a safe start for any list prop (`readonly string[]`, `Array<Item>`)
+    if (/\[\]$|^(readonly\s+)?(Readonly)?Array<.*>$/.test(prop.type.trim()))
+        return "[]";
+    return undefined;
+};
+/** The widest a line of args gets before each arg goes on a line of its own. */
+const LINE_WIDTH = 100;
+/** One story's args as code: on one line when it fits, one arg per line otherwise. */
+const argsCode = (args) => {
+    if (args.length === 0)
+        return "{}";
+    const pairs = args.map(([name, value]) => `${name}: ${value}`);
+    const line = `{ ${pairs.join(", ")} }`;
+    return line.length <= LINE_WIDTH ? line : `{\n${pairs.map((pair) => `    ${pair}`).join(",\n")}\n  }`;
+};
+/** The required props' args, and the ones the type checker must point at, as comments. */
+const requiredArgs = (props) => {
+    const args = [];
+    const todo = [];
+    for (const prop of props.filter((each) => each.isRequired)) {
+        const value = requiredCode(prop);
+        if (value === undefined)
+            todo.push(`${prop.name}: ${prop.type}`);
+        else
+            args.push([prop.name, value]);
+    }
+    return { args, todo };
+};
+/**
+ * The story file's text.
+ *
+ * @param input - the component's docs, its import, the title and the story types' module.
+ * @returns the file, ending with a newline.
+ */
+export const newStories = (input) => {
+    const { docs } = input;
+    const name = docs.name;
+    const type = `Story<typeof ${name}>`;
+    const { args, todo } = requiredArgs(docs.props);
+    const todoLine = todo.length === 0 ? [] : [`  // TODO: give ${todo.join(", ")}`];
+    const story = (exportName, summary, storyArgs, parameters) => [
+        `/** ${summary} */`,
+        `export const ${exportName}: ${type} = {`,
+        ...todoLine,
+        `  args: ${argsCode(storyArgs)}${parameters === undefined ? "" : ","}`,
+        ...(parameters === undefined ? [] : [`  parameters: ${parameters}`]),
+        "};",
+        ""
+    ];
+    const choice = docs.props.find((prop) => prop.kind === "choice" && (prop.choices?.length ?? 0) > 1);
+    const choiceStories = (choice?.choices ?? []).flatMap((value) => story(`${pascal(choice?.name ?? "")}${pascal(String(value))}`, `With ${choice?.name} ${JSON.stringify(value)}.`, [...args.filter(([prop]) => prop !== choice?.name), [choice?.name ?? "", JSON.stringify(value)]]));
+    const worst = docs.props.flatMap((prop) => {
+        if (prop.kind === "text" || prop.canTakeText === true)
+            return [[prop.name, JSON.stringify(WORST_TEXT)]];
+        if (prop.kind === "number")
+            return [[prop.name, String(WORST_NUMBER)]];
+        return [];
+    });
+    const worstArgs = [...args.filter(([prop]) => !worst.some(([each]) => each === prop)), ...worst];
+    return [
+        "/**",
+        ` * The stories of ${name}, written by \`forgebook new\` from its props: complete them by hand.`,
+        " *",
+        " * @module",
+        " */",
+        `import type { Meta, Story } from ${JSON.stringify(input.typesModule)};`,
+        "",
+        `import { ${name} } from ${JSON.stringify(input.importPath)};`,
+        "",
+        `export default { title: ${JSON.stringify(input.title)}, component: ${name} } satisfies Meta<typeof ${name}>;`,
+        "",
+        ...story("Default", `${name} as most pages use it.`, args, "{ main: true }"),
+        ...choiceStories,
+        ...story("WorstCase", `Long texts and huge numbers, to see where ${name} breaks.`, worstArgs, '{ group: "worst-case" }')
+    ]
+        .join("\n")
+        .replace(/\n+$/, "\n");
+};
+//# sourceMappingURL=newStories.js.map

package/dist/bin/forgebook/newStories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newStories.js","sourceRoot":"","sources":["../../../bin/forgebook/newStories.ts"],"names":[],"mappings":"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"}

package/dist/bin/forgebook/newStoriesFile.d.ts

@@ -0,0 +1,18 @@
+/** A component's first stories, ready to write. */
+export type NewStoriesFile = {
+    /** Where they go: `<Component>.stories.tsx` beside the component. */
+    readonly file: string;
+    /** The file's text. */
+    readonly text: string;
+};
+/**
+ * A component's first stories.
+ *
+ * @param componentFile - the component's file, absolute.
+ * @param exportName - the export to read; the file's only component when none.
+ * @param framework - the framework the stories are written for (`react`).
+ * @throws a `ScriptError` when the file is in no package, the framework cannot read it, or it exports no single
+ *   component.
+ */
+export declare const newStoriesFile: (componentFile: string, exportName: string | undefined, framework: string) => Promise<NewStoriesFile>;
+//# sourceMappingURL=newStoriesFile.d.ts.map

package/dist/bin/forgebook/newStoriesFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newStoriesFile.d.ts","sourceRoot":"","sources":["../../../bin/forgebook/newStoriesFile.ts"],"names":[],"mappings":"AAiBA,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAUF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACzB,eAAe,MAAM,EACrB,YAAY,MAAM,GAAG,SAAS,EAC9B,WAAW,MAAM,KAChB,OAAO,CAAC,cAAc,CAsBxB,CAAC"}

package/dist/bin/forgebook/newStoriesFile.js

@@ -0,0 +1,58 @@
+/**
+ * Where `forgebook new` writes a component's first stories and what they say: the component read from its file by the
+ * framework's docs module, the title from the stories file's path, the import beside it. Shared by the command and the
+ * MCP tool `new_stories`.
+ *
+ * @module
+ */
+import { basename, dirname, join, relative } from "node:path";
+import { findUp } from "@ensiria/cli-kit/files";
+import { ScriptError } from "@ensiria/cli-kit/script";
+import { autoTitle, patternBase } from "../../src/vite/autoTitle.js";
+import { findConfigFile, loadConfigFile } from "../../src/vite/configFile.js";
+import { frameworkDocsModule } from "../frameworkDocs.js";
+import { newStories } from "./newStories.js";
+/** The folder the title starts from: the catalogue's first stories pattern's, else `src` for a file under it. */
+const titleBase = async (packageDir, storiesFile) => {
+    const config = findConfigFile(packageDir);
+    const [pattern] = config === undefined ? [] : (await loadConfigFile(config)).stories;
+    if (pattern !== undefined)
+        return patternBase(pattern).replace(/^\.\//, "");
+    return relative(packageDir, storiesFile).split("/")[0] === "src" ? "src" : "";
+};
+/**
+ * A component's first stories.
+ *
+ * @param componentFile - the component's file, absolute.
+ * @param exportName - the export to read; the file's only component when none.
+ * @param framework - the framework the stories are written for (`react`).
+ * @throws a `ScriptError` when the file is in no package, the framework cannot read it, or it exports no single
+ *   component.
+ */
+export const newStoriesFile = async (componentFile, exportName, framework) => {
+    const manifest = findUp("package.json", dirname(componentFile));
+    if (manifest === undefined)
+        throw new ScriptError(`${componentFile} is in no package`);
+    const packageDir = dirname(manifest);
+    const docsModule = await frameworkDocsModule(packageDir, framework);
+    if (docsModule.extractFileComponent === undefined)
+        throw new ScriptError(`@forgebook/${framework} cannot read a component from its file yet`, {
+            hint: `Update @forgebook/${framework}`
+        });
+    const component = docsModule.extractFileComponent(componentFile, exportName);
+    if (typeof component === "string")
+        throw new ScriptError(component);
+    if (!("file" in component))
+        throw new ScriptError(`${componentFile} exports no component`);
+    const name = component.docs.name;
+    const file = join(dirname(componentFile), `${name}.stories.tsx`);
+    const title = autoTitle(await titleBase(packageDir, file), relative(packageDir, file)) ?? name;
+    const text = newStories({
+        docs: component.docs,
+        importPath: `./${basename(componentFile).replace(/\.[cm]?[jt]sx?$/, "")}`,
+        title,
+        typesModule: docsModule.storyTypesModule ?? `@forgebook/${framework}`
+    });
+    return { file, text };
+};
+//# sourceMappingURL=newStoriesFile.js.map

package/dist/bin/forgebook/newStoriesFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newStoriesFile.js","sourceRoot":"","sources":["../../../bin/forgebook/newStoriesFile.ts"],"names":[],"mappings":"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"}

package/dist/bin/forgebook/storyCheckRun.d.ts

@@ -0,0 +1,39 @@
+import { type StoryCheckReport, type StoryShotReport } from "../../src/storyCheck.ts";
+import type { AgentStory, StoriesDocument } from "../../src/vite/agent.types.ts";
+import type { ResolvedConfig } from "../../src/vite/configFile.ts";
+/** What a run is asked: the id, the views and whether to run every variant. */
+export type StoryCheckInput = {
+    /** A story's id, or a component's for its listed stories. */
+    readonly id: string;
+    /** The views, in the address's form or as words; none for the default view. */
+    readonly views: readonly string[];
+    /** Run every variant the catalogue's browser tests check. */
+    readonly isAllVariants: boolean;
+};
+/**
+ * The stories an id names: the story itself, or a component's listed stories.
+ *
+ * @param document - the catalogue's stories.
+ * @param id - the id.
+ */
+export declare const storiesNamed: (document: StoriesDocument, id: string) => AgentStory[];
+/**
+ * Runs the catalogue's checks.
+ *
+ * @param config - the catalogue's configuration.
+ * @param url - where `forgebook dev` runs, when not at Vite's default address.
+ * @param input - the id, the views and whether to check every variant.
+ * @returns the report, or why the check could not run.
+ */
+export declare const runStoryCheck: (config: ResolvedConfig, url: string | undefined, input: StoryCheckInput) => Promise<StoryCheckReport | string>;
+/**
+ * Takes the stories' pictures.
+ *
+ * @param config - the catalogue's configuration.
+ * @param url - where `forgebook dev` runs, when not at Vite's default address.
+ * @param input - the id, the views and whether to picture every variant.
+ * @param outDir - the folder the pictures go in, absolute.
+ * @returns the pictures, or why they could not be taken.
+ */
+export declare const runStoryShot: (config: ResolvedConfig, url: string | undefined, input: StoryCheckInput, outDir: string) => Promise<StoryShotReport | string>;
+//# sourceMappingURL=storyCheckRun.d.ts.map

package/dist/bin/forgebook/storyCheckRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyCheckRun.d.ts","sourceRoot":"","sources":["../../../bin/forgebook/storyCheckRun.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,gBAAgB,EAErB,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAOnE,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,eAAe,EAAE,IAAI,MAAM,KAAG,UAAU,EAI9E,CAAC;AA8GF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,cAAc,EACtB,KAAK,MAAM,GAAG,SAAS,EACvB,OAAO,eAAe,KACrB,OAAO,CAAC,gBAAgB,GAAG,MAAM,CAQnC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,cAAc,EACtB,KAAK,MAAM,GAAG,SAAS,EACvB,OAAO,eAAe,EACtB,QAAQ,MAAM,KACb,OAAO,CAAC,eAAe,GAAG,MAAM,CAQlC,CAAC"}