tosijs-ui 1.6.19 → 1.6.21

package/dist/doc-system/site/orchestrator.js

@@ -25,6 +25,18 @@ import { buildEpub } from './epub';
 // Module specifiers contain regex metacharacters (`/`, `.`, `@`, …), so escape
 // before interpolating into the require-shim detector below.
 const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+// Externalize the tjs CodeMirror editor extension ONLY when tjs-lang isn't
+// installed — otherwise it's bundled in so it shares the editor's CodeMirror
+// instance (see the `external` comment in buildSite). Returns [] when present.
+function tjsEditorExternal(root) {
+    try {
+        Bun.resolveSync('tjs-lang/editors/codemirror', root);
+        return [];
+    }
+    catch {
+        return ['tjs-lang/editors/codemirror'];
+    }
+}
 export async function buildSite(config) {
     const PROJECT_ROOT = './';
     const PUBLIC = path.resolve(PROJECT_ROOT, config.outputDir ?? 'docs');
@@ -97,7 +109,17 @@ export async function buildSite(config) {
     console.time('build');
     // Optionally also build the library (ESM + type declarations) — for repos
     // whose single build publishes both an npm package and its doc site.
-    if (config.libraryTsconfig) {
+    if (config.libraryBuild) {
+        // Full override — the consumer owns emitting dist/*.js + *.d.ts for ALL
+        // sources (e.g. tsc for `.ts` + `tjs convert`/`generateDTS` for native `.tjs`
+        // that tsc can't compile). See BUILD-TJS-HOOK.md.
+        await config.libraryBuild({
+            dist: DIST,
+            root: path.resolve(PROJECT_ROOT),
+            tsconfig: config.libraryTsconfig,
+        });
+    }
+    else if (config.libraryTsconfig) {
         // Consumer-controlled library build (handles root noEmit, removeComments,
         // outDir, etc.).
         try {
@@ -127,12 +149,20 @@ export async function buildSite(config) {
             format: 'iife',
             minify: true,
             naming: scriptName,
-            // tjs-lang transpiles live examples; it's dynamically import()'d at
-            // runtime (falling back to CDN), so keep it out of the bundle.
+            // tjs-lang's TRANSPILER (browser bundles) is dynamically import()'d at
+            // runtime (same-origin `/tjs/` copy, else CDN), so keep it out of the bundle.
+            //
+            // `tjs-lang/editors/codemirror` (the CodeMirror language + autocomplete) is
+            // different: it MUST share the editor's CodeMirror instance, so it has to be
+            // bundled IN — a separately loaded copy carries its own `@codemirror/state`
+            // and silently no-ops. So we do NOT externalize it *when tjs-lang is
+            // installed*. But tjs-lang is an OPTIONAL peer; if it's absent, bundling would
+            // fail to resolve, so we externalize it in that case (the runtime import then
+            // no-ops to plain TS highlighting — graceful degradation).
             external: [
-                'tjs-lang',
                 'tjs-lang/browser',
                 'tjs-lang/browser/from-ts',
+                ...tjsEditorExternal(PROJECT_ROOT),
                 ...(config.bundleExternals ?? []),
             ],
         });
@@ -258,7 +288,13 @@ export async function buildSite(config) {
     const genCss = existsSync(genCssTs)
         ? genCssTs
         : `${import.meta.dir}/generate-css.js`;
-    await $ `bun ${genCss} ${PUBLIC}/doc-system.css ${JSON.stringify(config.theme || {})}`.text();
+    // generate-css imports the consumer's library to burn the theme; when that graph
+    // reaches non-`.ts` sources (e.g. `.tjs`), `--preload` a module that registers the
+    // Bun loader plugin so those modules evaluate. (See BUILD-TJS-HOOK.md.)
+    const themeArg = JSON.stringify(config.theme || {});
+    await (config.generateCssPreload
+        ? $ `bun --preload ${config.generateCssPreload} ${genCss} ${PUBLIC}/doc-system.css ${themeArg}`
+        : $ `bun ${genCss} ${PUBLIC}/doc-system.css ${themeArg}`).text();
     console.log(`generated ${pageCount} static pages`);
     // ── host preset files ──
     // Idempotent, and an explicit static file (copied from staticDirs) always wins.

package/dist/doc-system/site/site-config.d.ts

@@ -3,6 +3,15 @@ import type { DocSystemTheme } from '../doc-system-styles';
 import type { Doc } from './docs';
 import type { BookManifest } from '../book-manifest';
 export type SiteHost = 'github-pages' | 'firebase' | 'static';
+/** Resolved paths handed to a `libraryBuild` override (see SiteConfig). */
+export interface LibraryBuildContext {
+    /** absolute path to the `dist` output dir the artifacts must land in */
+    dist: string;
+    /** project root the build runs from */
+    root: string;
+    /** the configured `libraryTsconfig`, if any (so the override can still run tsc) */
+    tsconfig?: string;
+}
 export interface SiteConfig {
     /** project / brand name — header, <title> suffix, og:site_name */
     name: string;
@@ -103,6 +112,25 @@ export interface SiteConfig {
      * yourself (e.g. keep doc comments in the published JS for AI readers).
      */
     libraryTsconfig?: string;
+    /**
+     * Fully override the library build (the `tsc` step that `libraryTsconfig` /
+     * `emitLibrary` run). Receives the resolved paths and is responsible for emitting
+     * `dist/*.js` + `*.d.ts` for ALL sources. Use this when some sources aren't `.ts`
+     * — e.g. native tjs-lang `.tjs` modules, which `tsc` can't compile: run `tsc` for
+     * the `.ts` graph and `tjs convert` + `generateDTS` for the `.tjs` files, into the
+     * same `dist`. Takes precedence over `libraryTsconfig` and `emitLibrary`. Pairs
+     * with `generateCssPreload` (below) for the CSS-extraction eval. See
+     * BUILD-TJS-HOOK.md.
+     */
+    libraryBuild?: (ctx: LibraryBuildContext) => void | Promise<void>;
+    /**
+     * A module to `--preload` into the CSS-extraction subprocess (`generate-css`),
+     * which imports your library to burn the theme stylesheet. Needed when that import
+     * graph reaches non-`.ts` sources (e.g. `.tjs`) that require a Bun loader plugin
+     * to evaluate — point this at a module that registers it (via `Bun.plugin({...})`
+     * at import time). Without it the subprocess throws `Cannot find module './x.tjs'`.
+     */
+    generateCssPreload?: string;
     /**
      * Emit llms.txt agent-discoverability index. Default true (uses `name` /
      * `description` / `baseUrl` / `projectLinks`). Set false to skip, or pass a