forgebook 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,23 @@
+/** What a coloured piece of code is, which is its colour. */
+export type CodeRole = "keyword" | "string" | "number" | "comment" | "type" | "function" | "property" | "tag" | "attribute";
+/** A slice of a block of code, with what it is when it is coloured. */
+export type CodePiece = {
+    /** The slice, as written. */
+    readonly text: string;
+    /** What it is; none leaves it plain. */
+    readonly role?: CodeRole;
+};
+/**
+ * Whether a fence name is of the TypeScript family, coloured here.
+ *
+ * @param language - the fence name (`tsx`, `ts`, `js`), in any case.
+ */
+export declare const isTypeScriptLanguage: (language: string) => boolean;
+/**
+ * A block of the TypeScript family as pieces, in order, covering it whole.
+ *
+ * @param code - the block.
+ * @param language - its fence name (`tsx`, `ts`, `js`, `jsx`…); one outside the family is read as TSX.
+ */
+export declare const typeScriptPieces: (code: string, language: string) => CodePiece[];
+//# sourceMappingURL=typeScriptPieces.d.ts.map

package/dist/src/vite/typeScriptPieces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeScriptPieces.d.ts","sourceRoot":"","sources":["../../../src/vite/typeScriptPieces.ts"],"names":[],"mappings":"AAsBA,6DAA6D;AAC7D,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,KAAK,GACL,WAAW,CAAC;AAEhB,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC1B,CAAC;AA2CF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,KAAG,OACH,CAAC;AA4HtD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,KAAG,SAAS,EAkC1E,CAAC"}

package/dist/src/vite/typeScriptPieces.js

@@ -0,0 +1,236 @@
+/**
+ * Code of the TypeScript family (TypeScript, TSX, JavaScript, JSX) split into the pieces a reader tells apart, from
+ * the TypeScript compiler's syntactic classifications, for `highlightCode.ts` to colour (D-690).
+ *
+ * @remarks
+ * highlight.js has no JSX grammar: it reads JSX as HTML, so an attribute holding a function or a `>` ends the tag
+ * early and the rest of the example is left plain. The compiler parses JSX as the language defines it.
+ *
+ * One language service in syntactic mode, created on the first block and kept: it parses the block alone (no
+ * program, no library, no type checker), so a block costs a parse, not a type check. Its classifications tell
+ * keywords, literals (a regular expression among the strings), comments, JSX and the names declared by a class, an
+ * interface, an enum, a namespace or a type parameter apart; a name they leave as a plain identifier is placed from
+ * the block's syntax tree: a type where a type is written, a function where it is called or declared, a property
+ * where it is read or declared (D-691). The rest (operators, punctuation, plain names, JSX text) stays plain.
+ *
+ * The pieces are slices of the code, in order, covering it whole: the caller escapes each one, so a coloured piece
+ * never splits an HTML entity.
+ *
+ * @module
+ */
+import ts from "typescript-6";
+/** The fence names of the TypeScript family, and the kind of file each one is parsed as. */
+const SCRIPT_KINDS = {
+    ts: ts.ScriptKind.TS,
+    typescript: ts.ScriptKind.TS,
+    mts: ts.ScriptKind.TS,
+    cts: ts.ScriptKind.TS,
+    tsx: ts.ScriptKind.TSX,
+    js: ts.ScriptKind.JS,
+    javascript: ts.ScriptKind.JS,
+    mjs: ts.ScriptKind.JS,
+    cjs: ts.ScriptKind.JS,
+    jsx: ts.ScriptKind.JSX
+};
+/** The name the block is parsed under, for each kind of file: the extension tells the parser whether JSX is read. */
+const FILE_NAMES = new Map([
+    [ts.ScriptKind.TS, "/block.ts"],
+    [ts.ScriptKind.TSX, "/block.tsx"],
+    [ts.ScriptKind.JS, "/block.js"],
+    [ts.ScriptKind.JSX, "/block.jsx"]
+]);
+/** The compiler's classifications that colour a piece by themselves; the others are placed or left plain. */
+const CLASSIFICATION_ROLES = new Map([
+    [ts.ClassificationType.keyword, "keyword"],
+    [ts.ClassificationType.stringLiteral, "string"],
+    [ts.ClassificationType.jsxAttributeStringLiteralValue, "string"],
+    [ts.ClassificationType.numericLiteral, "number"],
+    [ts.ClassificationType.bigintLiteral, "number"],
+    [ts.ClassificationType.comment, "comment"],
+    [ts.ClassificationType.className, "type"],
+    [ts.ClassificationType.enumName, "type"],
+    [ts.ClassificationType.interfaceName, "type"],
+    [ts.ClassificationType.typeParameterName, "type"],
+    [ts.ClassificationType.moduleName, "type"],
+    [ts.ClassificationType.jsxOpenTagName, "tag"],
+    [ts.ClassificationType.jsxCloseTagName, "tag"],
+    [ts.ClassificationType.jsxSelfClosingTagName, "tag"],
+    [ts.ClassificationType.jsxAttribute, "attribute"]
+]);
+/**
+ * Whether a fence name is of the TypeScript family, coloured here.
+ *
+ * @param language - the fence name (`tsx`, `ts`, `js`), in any case.
+ */
+export const isTypeScriptLanguage = (language) => Object.hasOwn(SCRIPT_KINDS, language.toLowerCase());
+/** The block being classified: the language service reads it through its host. */
+const current = { fileName: "/block.tsx", text: "", version: 0 };
+/** The language service, created on the first block. */
+let service;
+/** The language service over the current block, in syntactic mode: it parses, never type-checks. */
+const languageService = () => {
+    if (service !== undefined)
+        return service;
+    const host = {
+        getCompilationSettings: () => ({ jsx: ts.JsxEmit.Preserve, allowJs: true }),
+        getScriptFileNames: () => [current.fileName],
+        getScriptVersion: () => String(current.version),
+        getScriptSnapshot: (fileName) => fileName === current.fileName ? ts.ScriptSnapshot.fromString(current.text) : undefined,
+        getCurrentDirectory: () => "/",
+        getDefaultLibFileName: () => "/lib.d.ts",
+        readFile: () => undefined,
+        fileExists: (fileName) => fileName === current.fileName
+    };
+    service = ts.createLanguageService(host, undefined, ts.LanguageServiceMode.Syntactic);
+    return service;
+};
+/**
+ * The name a node writes in a type's place: a type reference, a type alias, a heritage clause, the class of a `new`,
+ * a name imported as a type.
+ *
+ * @param node - any node of the block.
+ */
+const typeName = (node) => {
+    if (ts.isTypeReferenceNode(node))
+        return node.typeName;
+    if (ts.isTypeAliasDeclaration(node))
+        return node.name;
+    if (ts.isExpressionWithTypeArguments(node) || ts.isNewExpression(node))
+        return node.expression;
+    if (ts.isImportSpecifier(node) && (node.isTypeOnly || node.parent.parent.isTypeOnly))
+        return node.name;
+    return undefined;
+};
+/**
+ * The name a node calls or declares as a function: a call, a tagged template, a function or method, a variable
+ * holding an arrow or a function expression.
+ *
+ * @param node - any node of the block.
+ */
+const functionName = (node) => {
+    if (ts.isCallExpression(node))
+        return node.expression;
+    if (ts.isTaggedTemplateExpression(node))
+        return node.tag;
+    if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isMethodSignature(node)) {
+        return node.name;
+    }
+    if (!ts.isVariableDeclaration(node) || node.initializer === undefined)
+        return undefined;
+    const isFunction = ts.isArrowFunction(node.initializer) || ts.isFunctionExpression(node.initializer);
+    return isFunction ? node.name : undefined;
+};
+/**
+ * The name a node reads or declares as a property: a member read, a property of an object, a type or a class, an
+ * accessor.
+ *
+ * @param node - any node of the block.
+ */
+const propertyName = (node) => {
+    if (ts.isPropertyAccessExpression(node))
+        return node.name;
+    const isDeclaration = ts.isPropertyAssignment(node) ||
+        ts.isPropertySignature(node) ||
+        ts.isPropertyDeclaration(node) ||
+        ts.isGetAccessorDeclaration(node) ||
+        ts.isSetAccessorDeclaration(node);
+    return isDeclaration ? node.name : undefined;
+};
+/**
+ * Where each name the classifications leave plain stands, by its start: a type, a function or a property.
+ *
+ * @remarks
+ * The first role found wins, and a node is read before its children: a call places its member as a function
+ * (`items.map(…)`) before the member read under it would place it as a property.
+ *
+ * @param sourceFile - the block, parsed with its parents set.
+ */
+const nameRoles = (sourceFile) => {
+    const roles = new Map();
+    const mark = (node, role) => {
+        // a dotted name (`React.ReactNode`, `items.map`) takes the role on its last part
+        if (node === undefined)
+            return;
+        if (ts.isPropertyAccessExpression(node))
+            mark(node.name, role);
+        else if (ts.isQualifiedName(node))
+            mark(node.right, role);
+        else if (ts.isIdentifier(node) || ts.isPrivateIdentifier(node)) {
+            const start = node.getStart(sourceFile);
+            if (!roles.has(start))
+                roles.set(start, role);
+        }
+    };
+    const visit = (node) => {
+        mark(typeName(node), "type");
+        mark(functionName(node), "function");
+        mark(propertyName(node), "property");
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return roles;
+};
+/**
+ * Where the comment a comment span opens ends: a block comment after its closing `*` `/`, a line comment at its
+ * line's end. The compiler splits a documentation comment into its tags and names (and gives one of its pieces
+ * twice); the comment is coloured whole instead, as one piece, as it reads.
+ *
+ * @param code - the block.
+ * @param start - where the span starts.
+ * @param end - where the span ends: the answer for a span that does not open a comment.
+ */
+const commentEnd = (code, start, end) => {
+    if (code.startsWith("/*", start)) {
+        const close = code.indexOf("*/", start + 2);
+        return close === -1 ? code.length : close + 2;
+    }
+    if (!code.startsWith("//", start))
+        return end;
+    const lineEnd = code.slice(start).search(/[\r\n]/);
+    return lineEnd === -1 ? code.length : start + lineEnd;
+};
+/**
+ * A block of the TypeScript family as pieces, in order, covering it whole.
+ *
+ * @param code - the block.
+ * @param language - its fence name (`tsx`, `ts`, `js`, `jsx`…); one outside the family is read as TSX.
+ */
+export const typeScriptPieces = (code, language) => {
+    const scriptKind = SCRIPT_KINDS[language.toLowerCase()] ?? ts.ScriptKind.TSX;
+    current.fileName = FILE_NAMES.get(scriptKind) ?? "/block.tsx";
+    current.text = code;
+    current.version += 1;
+    const { spans } = languageService().getEncodedSyntacticClassifications(current.fileName, {
+        start: 0,
+        length: code.length
+    });
+    const roles = nameRoles(ts.createSourceFile(current.fileName, code, ts.ScriptTarget.Latest, true, scriptKind));
+    const pieces = [];
+    let cursor = 0;
+    const push = (end, role) => {
+        if (end <= cursor)
+            return;
+        const text = code.slice(cursor, end);
+        pieces.push(role === undefined ? { text } : { text, role });
+        cursor = end;
+    };
+    // the spans come as triples: start, length, classification
+    for (let index = 0; index + 2 < spans.length; index += 3) {
+        const start = spans[index] ?? 0;
+        const end = start + (spans[index + 1] ?? 0);
+        const classification = spans[index + 2] ?? ts.ClassificationType.text;
+        // a span inside a piece already written (a comment taken whole) is part of it
+        if (start < cursor)
+            continue;
+        push(start);
+        if (classification === ts.ClassificationType.comment)
+            push(commentEnd(code, start, end), "comment");
+        else if (classification === ts.ClassificationType.identifier)
+            push(end, roles.get(start));
+        else
+            push(end, CLASSIFICATION_ROLES.get(classification));
+    }
+    push(code.length);
+    return pieces;
+};
+//# sourceMappingURL=typeScriptPieces.js.map

package/dist/src/vite/typeScriptPieces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeScriptPieces.js","sourceRoot":"","sources":["../../../src/vite/typeScriptPieces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,MAAM,cAAc,CAAC;AAsB9B,4FAA4F;AAC5F,MAAM,YAAY,GAA4C;IAC5D,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;IACpB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;IAC5B,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG;IACtB,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;IACpB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;IAC5B,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG;CACvB,CAAC;AAEF,qHAAqH;AACrH,MAAM,UAAU,GAAuC,IAAI,GAAG,CAAC;IAC7D,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,WAAW,CAAC;IAC/B,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,YAAY,CAAC;IACjC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,WAAW,CAAC;IAC/B,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,YAAY,CAAC;CAClC,CAAC,CAAC;AAEH,6GAA6G;AAC7G,MAAM,oBAAoB,GAAiD,IAAI,GAAG,CAAC;IACjF,CAAC,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC;IAC1C,CAAC,EAAE,CAAC,kBAAkB,CAAC,aAAa,EAAE,QAAQ,CAAC;IAC/C,CAAC,EAAE,CAAC,kBAAkB,CAAC,8BAA8B,EAAE,QAAQ,CAAC;IAChE,CAAC,EAAE,CAAC,kBAAkB,CAAC,cAAc,EAAE,QAAQ,CAAC;IAChD,CAAC,EAAE,CAAC,kBAAkB,CAAC,aAAa,EAAE,QAAQ,CAAC;IAC/C,CAAC,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC;IAC1C,CAAC,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC;IACzC,CAAC,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC;IACxC,CAAC,EAAE,CAAC,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC;IAC7C,CAAC,EAAE,CAAC,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACjD,CAAC,EAAE,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC;IAC1C,CAAC,EAAE,CAAC,kBAAkB,CAAC,cAAc,EAAE,KAAK,CAAC;IAC7C,CAAC,EAAE,CAAC,kBAAkB,CAAC,eAAe,EAAE,KAAK,CAAC;IAC9C,CAAC,EAAE,CAAC,kBAAkB,CAAC,qBAAqB,EAAE,KAAK,CAAC;IACpD,CAAC,EAAE,CAAC,kBAAkB,CAAC,YAAY,EAAE,WAAW,CAAC;CAClD,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAgB,EAAW,EAAE,CAChE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AAEtD,kFAAkF;AAClF,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAEjE,wDAAwD;AACxD,IAAI,OAAuC,CAAC;AAE5C,oGAAoG;AACpG,MAAM,eAAe,GAAG,GAAuB,EAAE;IAC/C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC1C,MAAM,IAAI,GAA2B;QACnC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3E,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5C,gBAAgB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAC/C,iBAAiB,EAAE,CAAC,QAAgB,EAAkC,EAAE,CACtE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QACxF,mBAAmB,EAAE,GAAG,EAAE,CAAC,GAAG;QAC9B,qBAAqB,EAAE,GAAG,EAAE,CAAC,WAAW;QACxC,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;QACzB,UAAU,EAAE,CAAC,QAAgB,EAAW,EAAE,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;KACzE,CAAC;IACF,OAAO,GAAG,EAAE,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACtF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,QAAQ,GAAG,CAAC,IAAa,EAAuB,EAAE;IACtD,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvD,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACtD,IAAI,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC;IAC/F,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACvG,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CAAC,IAAa,EAAuB,EAAE;IAC1D,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC;IACtD,IAAI,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC;IACzD,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjG,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxF,MAAM,UAAU,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrG,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CAAC,IAAa,EAAuB,EAAE;IAC1D,IAAI,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC1D,MAAM,aAAa,GACjB,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC;QAC7B,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAC5B,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;QAC9B,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC;QACjC,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,SAAS,GAAG,CAAC,UAAyB,EAAyB,EAAE;IACrE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,MAAM,IAAI,GAAG,CAAC,IAAyB,EAAE,IAAc,EAAQ,EAAE;QAC/D,iFAAiF;QACjF,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,IAAI,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;aAC1D,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;aACrD,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;QACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;QACrC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC;IACF,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW,EAAU,EAAE;IACtE,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC5C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC;AACxD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAe,EAAE;IAC9E,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;IAC7E,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC;IAC9D,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACrB,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE,CAAC,kCAAkC,CAAC,OAAO,CAAC,QAAQ,EAAE;QACvF,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,SAAS,CACrB,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CACtF,CAAC;IACF,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,IAAe,EAAQ,EAAE;QAClD,IAAI,GAAG,IAAI,MAAM;YAAE,OAAO;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,CAAC;IACf,CAAC,CAAC;IACF,2DAA2D;IAC3D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,cAAc,GAA0B,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAC7F,8EAA8E;QAC9E,IAAI,KAAK,GAAG,MAAM;YAAE,SAAS;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;QACZ,IAAI,cAAc,KAAK,EAAE,CAAC,kBAAkB,CAAC,OAAO;YAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;aAC/F,IAAI,cAAc,KAAK,EAAE,CAAC,kBAAkB,CAAC,UAAU;YAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;;YACrF,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,205 @@
 {
   "name": "forgebook",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "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",
+    "catalogue",
+    "stories",
+    "csf",
+    "design-system"
+  ],
+  "license": "MIT",
+  "author": "Jason Scoppetta",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ensiria/forgebook.git",
+    "directory": "packages/forgebook"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "sideEffects": [
+    "*.css",
+    "*.scss"
+  ],
+  "bin": {
+    "forgebook": "./dist/bin/forgebook/forgebook.mjs",
+    "forgebook-docs": "./dist/bin/forgebook-docs/forgebook-docs.mjs",
+    "forgebook-texts": "./dist/bin/forgebook-texts/forgebook-texts.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/vite/config.d.ts",
+      "default": "./dist/src/vite/config.js"
+    },
+    "./story-tree": {
+      "types": "./dist/src/storyTree.d.ts",
+      "default": "./dist/src/storyTree.js"
+    },
+    "./shell": {
+      "types": "./dist/src/shell/mountShell.d.ts",
+      "default": "./dist/src/shell/mountShell.js"
+    },
+    "./frame": {
+      "types": "./dist/src/frame/mountFrame.d.ts",
+      "default": "./dist/src/frame/mountFrame.js"
+    },
+    "./vite": {
+      "types": "./dist/src/vite/forgebookPlugin.d.ts",
+      "default": "./dist/src/vite/forgebookPlugin.js"
+    },
+    "./renderer": {
+      "types": "./dist/src/frame/renderer.d.ts",
+      "default": "./dist/src/frame/renderer.js"
+    },
+    "./story-hooks": {
+      "types": "./dist/src/frame/storyHooks.d.ts",
+      "default": "./dist/src/frame/storyHooks.js"
+    },
+    "./story-module": {
+      "types": "./dist/src/frame/storyModule.d.ts",
+      "default": "./dist/src/frame/storyModule.js"
+    },
+    "./messages": {
+      "types": "./dist/src/messages.d.ts",
+      "default": "./dist/src/messages.js"
+    },
+    "./component-docs": {
+      "types": "./dist/src/componentDocs.d.ts",
+      "default": "./dist/src/componentDocs.js"
+    },
+    "./vite/adapter": {
+      "types": "./dist/src/vite/adapter.d.ts",
+      "default": "./dist/src/vite/adapter.js"
+    },
+    "./vite/docs-program": {
+      "types": "./dist/src/vite/docsProgram.d.ts",
+      "default": "./dist/src/vite/docsProgram.js"
+    },
+    "./vite/story-meta": {
+      "types": "./dist/src/vite/storyMeta.d.ts",
+      "default": "./dist/src/vite/storyMeta.js"
+    },
+    "./catalogue-docs": {
+      "types": "./dist/bin/forgebook-docs/collectDocs.d.ts",
+      "default": "./dist/bin/forgebook-docs/collectDocs.js"
+    },
+    "./catalogue-markdown": {
+      "types": "./dist/bin/forgebook-docs/catalogueMarkdown.d.ts",
+      "default": "./dist/bin/forgebook-docs/catalogueMarkdown.js"
+    },
+    "./a11y": {
+      "types": "./dist/src/a11y.d.ts",
+      "default": "./dist/src/a11y.js"
+    },
+    "./frame-status": {
+      "types": "./dist/src/frame/frameStatus.d.ts",
+      "default": "./dist/src/frame/frameStatus.js"
+    },
+    "./story-heights": {
+      "types": "./dist/src/storyHeights.d.ts",
+      "default": "./dist/src/storyHeights.js"
+    },
+    "./story-ids-element": {
+      "types": "./dist/src/storyIdsElement.d.ts",
+      "default": "./dist/src/storyIdsElement.js"
+    },
+    "./view-state": {
+      "types": "./dist/src/viewState.d.ts",
+      "default": "./dist/src/viewState.js"
+    },
+    "./frame-clock": {
+      "types": "./dist/src/frame/frameClock.d.ts",
+      "default": "./dist/src/frame/frameClock.js"
+    },
+    "./source-files": {
+      "types": "./dist/src/sourceFiles.d.ts",
+      "default": "./dist/src/sourceFiles.js"
+    },
+    "./story-clock": {
+      "types": "./dist/src/storyClock.d.ts",
+      "default": "./dist/src/storyClock.js"
+    },
+    "./story-texts": {
+      "types": "./dist/src/storyTexts.d.ts",
+      "default": "./dist/src/storyTexts.js"
+    },
+    "./vite/auto-title": {
+      "types": "./dist/src/vite/autoTitle.d.ts",
+      "default": "./dist/src/vite/autoTitle.js"
+    },
+    "./vite/index-story-file": {
+      "types": "./dist/src/vite/indexStoryFile.d.ts",
+      "default": "./dist/src/vite/indexStoryFile.js"
+    },
+    "./vite/story-files-module": {
+      "types": "./dist/src/vite/storyFilesModule.d.ts",
+      "default": "./dist/src/vite/storyFilesModule.js"
+    },
+    "./switches": {
+      "types": "./dist/src/switches.d.ts",
+      "default": "./dist/src/switches.js"
+    },
+    "./catalogue": {
+      "types": "./dist/src/catalogue.d.ts",
+      "default": "./dist/src/catalogue.js"
+    }
+  },
+  "dependencies": {
+    "@ensiria/cli-kit": "^0.1.1",
+    "axe-core": "4.14.0",
+    "highlight.js": "11.12.0",
+    "lightningcss": "1.33.0",
+    "marked": "18.1.0",
+    "typescript-6": "npm:typescript@6.0.3",
+    "@forgebook/story-format": "0.1.0"
+  },
+  "peerDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/user-event": "^14.6.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sass-embedded": "^1.80.0",
+    "vite": "^8.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "10.4.2",
+    "@testing-library/user-event": "14.6.8",
+    "@types/node": "24.19.2",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "happy-dom": "21.0.4",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "sass-embedded": "1.106.1",
+    "vite": "8.3.5",
+    "vitest": "5.0.5",
+    "@forgebook/tools": "0.0.0",
+    "@forgebook/typescript-config": "0.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@testing-library/dom": {
+      "optional": true
+    },
+    "@testing-library/user-event": {
+      "optional": true
+    },
+    "sass-embedded": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "package-build build",
+    "manifest": "package-build manifest",
+    "test": "vitest run",
+    "typecheck": "tsc -p src && tsc -p src/vite && tsc -p bin && tsc -p test"
+  }
 }