tosijs-ui 1.9.0 → 1.9.2

package/dist/doc-system/site/dev-server.js

@@ -9,13 +9,14 @@ Build-time only (Bun APIs). Never import this from browser code.
 */
 import * as path from 'path';
 import { statSync } from 'fs';
+import { tmpdir } from 'os';
 import { $, spawn } from 'bun';
-import { buildSite } from './orchestrator';
-import { preflight } from './preflight';
-import { auditDependencies, reportAudit } from './audit-guard';
-import { openDevBrowser } from './open-browser';
-import { resolveTunnelLocalPort } from './site-config';
-import { TUNNEL_LINK_CMD, isLockedDown, hasTunnel, isLoopbackAddressForAuth as isLoopbackAddress, mayReadSite, shouldInterceptLinkToken, createAuthState, issueLink, readCookie, redeemLink, sessionCookie, urlWithoutToken, validSession, mayWriteSource, isProxiedRequest, SESSION_COOKIE, } from './dev-auth';
+import { buildSite } from './orchestrator.js';
+import { preflight } from './preflight.js';
+import { auditDependencies, reportAudit } from './audit-guard.js';
+import { openDevBrowser } from './open-browser.js';
+import { resolveTunnelLocalPort } from './site-config.js';
+import { TUNNEL_LINK_CMD, isLockedDown, hasTunnel, isLoopbackAddressForAuth as isLoopbackAddress, mayReadSite, shouldInterceptLinkToken, createAuthState, issueLink, readCookie, redeemLink, sessionCookie, urlWithoutToken, validSession, mayWriteSource, isProxiedRequest, SESSION_COOKIE, } from './dev-auth.js';
 const TEST_RESULTS_FILE = '.browser-tests.json';
 const DEFAULT_IDLE_HOURS = 8;
 /**
@@ -1210,7 +1211,6 @@ export async function devServer(config, opts = {}) {
             testReportResolve = resolve;
             setTimeout(() => reject(new Error('Browser tests timed out')), testTimeout);
         });
-        let haltija;
         /**
          * Tear down the haltija WE started — including the Electron grandchild. Defined up
          * front so EVERY failure path can call it, including the start-timeout below, which
@@ -1270,72 +1270,55 @@ export async function devServer(config, opts = {}) {
     
         Declining to adopt is safe: we spawn with `-f`, which stomps the stale instance.
         */
-        const haltijaReachable = async () => {
+        /*
+        ALWAYS an isolated instance. Never adopt, never stomp.
+    
+        The lane used to reuse any reachable haltija and otherwise spawn with `-f`, which
+        reclaims the shared default port and SIGTERMs whatever held it — often another
+        project's session. Both halves were a problem:
+    
+          - adopting meant inheriting the DESKTOP app's window, whose visibility depends on
+            whatever else is on screen. `hj` refuses to drive a hidden tab (rightly — a
+            backgrounded tab throttles rAF, so results are plausible-but-wrong), so the lane
+            failed intermittently, roughly two runs in three, with no programmatic way out.
+          - `-f` made this project's test run destructive to everyone else's.
+    
+        `--private` gives us our own server on an EPHEMERAL port, so there is nothing to
+        contend for and nothing to kill. The port is written to a file rather than guessed.
+        (tosijs-ui#18, #21.)
+        */
+        const portFile = `${tmpdir()}/tosijs-haltija-${process.pid}.json`;
+        console.log('Starting a private haltija…');
+        const haltija = spawn(['bunx', HALTIJA_PKG, '--private', '--port-file', portFile], {
+            // stdout/stderr are NOT inherited: `bunx haltija` launches Electron as a
+            // grandchild, and killing the bunx wrapper does not kill it. An orphan holding
+            // our inherited stdout keeps the pipe open forever, so the command looks hung
+            // long after it exited.
+            stdout: 'ignore',
+            stderr: 'ignore',
+        });
+        // Read the port it actually bound, rather than assuming one.
+        let hjPort = '';
+        for (let i = 0; i < 60; i++) {
+            await new Promise((resolve) => setTimeout(resolve, 500));
             try {
-                /*
-                `--json`, and fail CLOSED.
-        
-                Bare `hj windows` appends a dim hint line to STDOUT after the JSON, so
-                `JSON.parse` throws and a `catch` that fell through to `return true` adopted the
-                very dead server this check exists to reject — the gate was inert on every
-                npm-installed CLI. It passed verification here only because this machine's `hj` is
-                a standalone bundle with no `hints.json` beside it, so the hint was never emitted:
-                a real behavioural test, run against an environment adopters do not have.
-        
-                Failing closed costs nothing: the spawn below uses `-f`, which stomps a stale
-                instance. Adopting a server we could not read is the expensive direction.
-                */
-                const out = await $ `hj windows --json`.quiet().text();
-                return haltijaIsDrivable(out);
+                const info = JSON.parse(await Bun.file(portFile).text());
+                hjPort = String(info.port ?? info.address?.port ?? '');
+                if (hjPort)
+                    break;
             }
             catch {
-                return false;
+                /* not written yet */
             }
-        };
-        const adoptable = await haltijaReachable();
-        if (!adoptable) {
-            /*
-            Leave a receipt: spawning with `-f` reclaims haltija's shared default port, which
-            SIGTERMs whatever was there — frequently another project's session, or the
-            developer's own. This file already sets that norm for killStrayServer; declining to
-            adopt makes the stomp MORE frequent, so it must be at least as loud.
-            */
-            console.log(`No drivable haltija (server absent, or up with no connected tab).\n` +
-                `  Starting one with -f, which reclaims the shared haltija port — any other\n` +
-                `  project's session on it will be stopped.  (cwd: ${process.cwd()})`);
         }
-        if (adoptable) {
-            console.log('Using existing haltija browser');
-        }
-        else {
-            console.log('Starting haltija...');
-            // stdout/stderr are NOT inherited: `bunx haltija` launches an Electron app as a
-            // grandchild, and killing the bunx wrapper does not kill it. An orphaned Electron
-            // holding our inherited stdout keeps the pipe open forever, so a CI job or an
-            // agent capturing this command's output sees it hang long after it exited (0).
-            haltija = spawn(['bunx', HALTIJA_PKG, '-f'], {
-                stdout: 'ignore',
-                stderr: 'ignore',
-            });
-            const waitStarted = Date.now();
-            console.log('Waiting for haltija…');
-            let up = false;
-            for (let i = 0; i < 20; i++) {
-                await new Promise((resolve) => setTimeout(resolve, 500));
-                if (await haltijaReachable()) {
-                    up = true;
-                    break;
-                }
-            }
-            if (!up) {
-                console.error(`haltija did not become drivable within ${Math.round((Date.now() - waitStarted) / 1000)}s.\n` +
-                    `  A single \`hj windows\` can block for several seconds when a server is up\n` +
-                    `  with no tab, so this can take much longer than the poll count suggests.`);
-                await stopHaltija();
-                server.stop();
-                process.exit(1);
-            }
+        if (!hjPort) {
+            console.error(`haltija did not report a private port within 30s (${portFile}).\n` +
+                `  Is \`bunx ${HALTIJA_PKG}\` able to run? Try it by hand.`);
+            await stopHaltija();
+            server.stop();
+            process.exit(1);
         }
+        console.log(`  private haltija on port ${hjPort}`);
         console.log('Opening demo site...');
         // haltija 1.4: `hj navigate` exits NON-ZERO on failure (no browser reachable, a
         // window that didn't take the URL, …). Before 1.4 it exited 0 regardless, so a
@@ -1343,7 +1326,9 @@ export async function devServer(config, opts = {}) {
         // timeout with a misleading "Browser tests timed out". Now we can read the exit
         // code: fail immediately, say why, and tear down the haltija we spawned so the
         // next run isn't inheriting a half-navigated browser.
-        const nav = await $ `hj navigate https://localhost:${PORT}`.nothrow().quiet();
+        const nav = await $ `hj --port ${hjPort} navigate https://localhost:${PORT}`
+            .nothrow()
+            .quiet();
         if (nav.exitCode !== 0) {
             console.error(`hj navigate failed (exit ${nav.exitCode}): ${nav.stderr.toString().trim() || 'no browser reachable'}`);
             await stopHaltija();

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

@@ -95,9 +95,9 @@ e.g. `{ "pin": "top", "order": 1 }` above `{ "pin": "top", "order": 2 }`.
 // TODO CLI options
 import * as fs from 'fs';
 import * as path from 'path';
-import { pinnedSort } from '../nav-tree';
-import { buildSlugMap } from '../routing';
-import { withoutHidden } from '../book-target';
+import { pinnedSort } from '../nav-tree.js';
+import { buildSlugMap } from '../routing.js';
+import { withoutHidden } from '../book-target.js';
 const TRIM_REGEX = /^#+ |`/g;
 /**
  * Parse & strip a leading YAML frontmatter block (`---\n…\n---`). Every prose

package/dist/doc-system/site/epub-cli.js

@@ -12,7 +12,7 @@ the Bun.build note in orchestrator.ts.
 
 Build-time only. Never import this from browser code.
 */
-import { buildEpub } from './epub';
+import { buildEpub } from './epub.js';
 const payloadPath = process.argv[2];
 if (!payloadPath) {
     console.error('epub-cli: expected a payload file path');

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

@@ -1,5 +1,5 @@
-import type { SiteConfig } from './site-config';
-import { DEFAULT_BOOK_CSS, stripDocMeta } from '../book-html';
+import type { SiteConfig } from './site-config.js';
+import { DEFAULT_BOOK_CSS, stripDocMeta } from '../book-html.js';
 export { DEFAULT_BOOK_CSS, stripDocMeta };
 declare global {
     var Bun: any;

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

@@ -16,12 +16,12 @@ Build-time only (Bun APIs + the `zip` CLI); never import from browser code.
 */
 import * as fs from 'fs';
 import * as path from 'path';
-import { renderDocMarkdown } from '../render';
-import { buildSlugMap, pathForSlug, slugForPath } from '../routing';
-import { buildNavTree } from '../nav-tree';
-import { partitionByBook, DEFAULT_BOOK } from '../book-target';
-import { DEFAULT_BOOK_CSS, stripDocMeta, flatten, slugify } from '../book-html';
-import { selectBookDocs } from '../book-manifest';
+import { renderDocMarkdown } from '../render.js';
+import { buildSlugMap, pathForSlug, slugForPath } from '../routing.js';
+import { buildNavTree } from '../nav-tree.js';
+import { partitionByBook, DEFAULT_BOOK } from '../book-target.js';
+import { DEFAULT_BOOK_CSS, stripDocMeta, flatten, slugify } from '../book-html.js';
+import { selectBookDocs } from '../book-manifest.js';
 // Re-exported for back-compat (tosijs-ui/site's public surface + tests).
 export { DEFAULT_BOOK_CSS, stripDocMeta };
 // ── XML / XHTML helpers ─────────────────────────────────────────────────────

package/dist/doc-system/site/generate-css.d.ts

@@ -1,5 +1,5 @@
-import './build-dom-shim';
-import { DocSystemTheme } from '../doc-system-styles';
+import './build-dom-shim.js';
+import { DocSystemTheme } from '../doc-system-styles.js';
 declare global {
     var Bun: any;
 }

package/dist/doc-system/site/generate-css.js

@@ -10,9 +10,9 @@ would trigger an endless watch->rebuild loop.
 Usage: bun src/doc-system/site/generate-css.ts [outputPath]
 Default output: docs/doc-system.css
 */
-import './build-dom-shim'; // must precede any tosijs import (build has no DOM)
+import './build-dom-shim.js'; // must precede any tosijs import (build has no DOM)
 import { css } from 'tosijs';
-import { docSystemStyleSpec } from '../doc-system-styles';
+import { docSystemStyleSpec } from '../doc-system-styles.js';
 export async function generateCss(outputPath = 'docs/doc-system.css', theme = {}) {
     await Bun.write(outputPath, css(docSystemStyleSpec(theme)));
 }

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

@@ -1,6 +1,6 @@
-import type { Doc } from './docs';
-import type { ProjectLinks, LinkItem } from '../../doc-browser';
-import { type ExampleBakes } from '../render';
+import type { Doc } from './docs.js';
+import type { ProjectLinks, LinkItem } from '../../doc-browser.js';
+import { type ExampleBakes } from '../render.js';
 declare global {
     var Bun: any;
 }

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

@@ -10,10 +10,10 @@ the IIFE bundle loads.
 Build-time only (uses Bun.write). Shares slug + markdown rendering with the runtime
 component (src/doc-system/*) so static and hydrated output agree.
 */
-import { pageTitle } from '../doc-title';
-import { buildSlugMap, pathForSlug, rewriteDocLinks } from '../routing';
-import { buildNavTree, navOpenPath } from '../nav-tree';
-import { renderDocMarkdown, docDescription } from '../render';
+import { pageTitle } from '../doc-title.js';
+import { buildSlugMap, pathForSlug, rewriteDocLinks } from '../routing.js';
+import { buildNavTree, navOpenPath } from '../nav-tree.js';
+import { renderDocMarkdown, docDescription } from '../render.js';
 const escapeAttr = (s) => s
     .replace(/&/g, '&')
     .replace(/</g, '&lt;')

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

@@ -1,16 +1,16 @@
-export { defineSiteConfig } from './site-config';
-export type { SiteConfig, SiteHost, LibraryBuildContext } from './site-config';
-export { buildSite } from './orchestrator';
-export { devServer } from './dev-server';
-export { auditDependencies, reportAudit, resolveAuditMode } from './audit-guard';
-export type { AuditConfig, AuditGate, AuditResult, AuditSeverity, AuditMode, AuditAdvisory, } from './audit-guard';
-export { openDevBrowser, buildOpenPlan } from './open-browser';
-export type { OpenPlan, OpenPlanInput } from './open-browser';
-export { extractDocs, saveDocsJSON } from './docs';
-export type { Doc } from './docs';
-export { generateSite } from './generate-site';
-export type { GenerateSiteConfig } from './generate-site';
-export { buildEpub, DEFAULT_BOOK_CSS } from './epub';
-export type { BuildEpubOptions, BookMeta } from './epub';
-export { selectBookDocs } from '../book-manifest';
-export type { BookManifest } from '../book-manifest';
+export { defineSiteConfig } from './site-config.js';
+export type { SiteConfig, SiteHost, LibraryBuildContext } from './site-config.js';
+export { buildSite } from './orchestrator.js';
+export { devServer } from './dev-server.js';
+export { auditDependencies, reportAudit, resolveAuditMode } from './audit-guard.js';
+export type { AuditConfig, AuditGate, AuditResult, AuditSeverity, AuditMode, AuditAdvisory, } from './audit-guard.js';
+export { openDevBrowser, buildOpenPlan } from './open-browser.js';
+export type { OpenPlan, OpenPlanInput } from './open-browser.js';
+export { extractDocs, saveDocsJSON } from './docs.js';
+export type { Doc } from './docs.js';
+export { generateSite } from './generate-site.js';
+export type { GenerateSiteConfig } from './generate-site.js';
+export { buildEpub, DEFAULT_BOOK_CSS } from './epub.js';
+export type { BuildEpubOptions, BookMeta } from './epub.js';
+export { selectBookDocs } from '../book-manifest.js';
+export type { BookManifest } from '../book-manifest.js';

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

@@ -3,12 +3,12 @@ Public entry for `tosijs-ui/site` — the static, pre-rendered, hydrating
 doc-site build system. Build-time only (Bun/node APIs); never import this from
 browser code. See ./README is at ../doc-site-system.md and the repo docs.
 */
-export { defineSiteConfig } from './site-config';
-export { buildSite } from './orchestrator';
-export { devServer } from './dev-server';
-export { auditDependencies, reportAudit, resolveAuditMode } from './audit-guard';
-export { openDevBrowser, buildOpenPlan } from './open-browser';
-export { extractDocs, saveDocsJSON } from './docs';
-export { generateSite } from './generate-site';
-export { buildEpub, DEFAULT_BOOK_CSS } from './epub';
-export { selectBookDocs } from '../book-manifest';
+export { defineSiteConfig } from './site-config.js';
+export { buildSite } from './orchestrator.js';
+export { devServer } from './dev-server.js';
+export { auditDependencies, reportAudit, resolveAuditMode } from './audit-guard.js';
+export { openDevBrowser, buildOpenPlan } from './open-browser.js';
+export { extractDocs, saveDocsJSON } from './docs.js';
+export { generateSite } from './generate-site.js';
+export { buildEpub, DEFAULT_BOOK_CSS } from './epub.js';
+export { selectBookDocs } from '../book-manifest.js';

package/dist/doc-system/site/make-llms-txt.js

@@ -1,6 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import { buildSlugMap, pathForSlug } from '../routing';
+import { buildSlugMap, pathForSlug } from '../routing.js';
 const SRC = 'src';
 const DIST = 'dist';
 function extractTitle(text) {

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

@@ -1,4 +1,4 @@
-import type { SiteConfig } from './site-config';
+import type { SiteConfig } from './site-config.js';
 declare global {
     var Bun: any;
 }

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

@@ -12,21 +12,21 @@ the icon system here would put src/icon-data.ts into `bun --watch`'s graph and
 cause an endless rebuild loop.
 */
 import * as path from 'path';
-import { namedBooks, partitionByBook, DEFAULT_BOOK } from '../book-target';
-import { buildSlugMap } from '../routing';
+import { namedBooks, partitionByBook, DEFAULT_BOOK } from '../book-target.js';
+import { buildSlugMap } from '../routing.js';
 import { existsSync, mkdirSync, unlinkSync } from 'fs';
 import { tmpdir } from 'os';
 import { $, spawn } from 'bun';
-import { extractDocs } from './docs';
-import { checkExamples, formatExampleProblems, } from './check-examples';
-import { ensureSections } from './sections';
-import { generateLlmsTxt } from './make-llms-txt';
-import { generateSite } from './generate-site';
-import { findOutputDirOverlap } from './output-guard';
-import { preflight } from './preflight';
-import { auditDependencies, reportAudit } from './audit-guard';
-import { gatherBuildStamp, serializeBuildStamp } from './build-stamp';
-import { tjsEditorExternal, tjsEditorLeakedAsExternal, classicScriptSyntaxErrorInChild, } from './bundle-guard';
+import { extractDocs } from './docs.js';
+import { checkExamples, formatExampleProblems, } from './check-examples.js';
+import { ensureSections } from './sections.js';
+import { generateLlmsTxt } from './make-llms-txt.js';
+import { generateSite } from './generate-site.js';
+import { findOutputDirOverlap } from './output-guard.js';
+import { preflight } from './preflight.js';
+import { auditDependencies, reportAudit } from './audit-guard.js';
+import { gatherBuildStamp, serializeBuildStamp } from './build-stamp.js';
+import { tjsEditorExternal, tjsEditorLeakedAsExternal, classicScriptSyntaxErrorInChild, } from './bundle-guard.js';
 // Module specifiers contain regex metacharacters (`/`, `.`, `@`, …), so escape
 // before interpolating into the require-shim detector below.
 /** Give up on a hung ePub child rather than wedge the dev server's rebuild. */

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

@@ -13,8 +13,8 @@ doesn't loop. TOC links are root-relative (basePath-agnostic source).
 */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import * as path from 'path';
-import { buildSlugMap, pathForSlug, slugify, resolveParent } from '../routing';
-import { pinnedSort } from '../nav-tree';
+import { buildSlugMap, pathForSlug, slugify, resolveParent } from '../routing.js';
+import { pinnedSort } from '../nav-tree.js';
 const TOC_RE = /<!-- toc -->[\s\S]*?<!-- \/toc -->/;
 function readDocs(p) {
     return JSON.parse(readFileSync(p, 'utf8'));

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

@@ -1,9 +1,9 @@
-import type { ProjectLinks, LinkItem } from '../../doc-browser';
-import type { DocSystemTheme } from '../doc-system-styles';
-import type { Doc } from './docs';
-import type { PreflightMode } from './preflight';
-import type { AuditConfig } from './audit-guard';
-import type { BookManifest } from '../book-manifest';
+import type { ProjectLinks, LinkItem } from '../../doc-browser.js';
+import type { DocSystemTheme } from '../doc-system-styles.js';
+import type { Doc } from './docs.js';
+import type { PreflightMode } from './preflight.js';
+import type { AuditConfig } from './audit-guard.js';
+import type { BookManifest } from '../book-manifest.js';
 export type SiteHost = 'github-pages' | 'firebase' | 'static';
 /** Resolved paths handed to a `libraryBuild` override (see SiteConfig). */
 export interface LibraryBuildContext {

package/dist/editable-rect.js

@@ -69,8 +69,8 @@ After an element's position, size, or rotation are adjusted a `change` event is
 */
 /*{ "parent": "Components" }*/
 import { Component, elements, vars } from 'tosijs';
-import { icons } from './icons';
-import { trackDrag } from './track-drag';
+import { icons } from './icons.js';
+import { trackDrag } from './track-drag.js';
 const { div, slot } = elements;
 export class EditableRect extends Component {
     static preferredTagName = 'tosi-editable';

package/dist/filter-builder.d.ts

@@ -1,5 +1,5 @@
 import { Component as WebComponent, ElementCreator, PartsMap } from 'tosijs';
-import { TosiSelect } from './select';
+import { TosiSelect } from './select.js';
 type ObjectTest = (obj: any) => boolean;
 type ArrayFilter = (array: any[]) => any[];
 interface FilterMaker {

package/dist/filter-builder.js

@@ -145,8 +145,8 @@ interface FilterMaker {
 */
 /*{ "parent": "Form Components" }*/
 import { Component as WebComponent, elements, } from 'tosijs';
-import { icons } from './icons';
-import { tosiSelect } from './select';
+import { icons } from './icons.js';
+import { tosiSelect } from './select.js';
 const { div, input, button, span } = elements;
 const passThru = (array) => array;
 const NULL_FILTER_DESCRIPTION = 'null filter, everything matches';

package/dist/float.js

@@ -90,7 +90,7 @@ just add the `no-drag` class to an element or its container.
 */
 /*{ "parent": "Components" }*/
 import { Component as WebComponent, elements } from 'tosijs';
-import { trackDrag, bringToFront } from './track-drag';
+import { trackDrag, bringToFront } from './track-drag.js';
 const { slot } = elements;
 export class TosiFloat extends WebComponent {
     static preferredTagName = 'tosi-float';

package/dist/form.js

@@ -403,7 +403,7 @@ preview.querySelector('.set-values-btn').addEventListener('click', () => {
 */
 /*{ "parent": "Form Components" }*/
 import { Component as XinComponent, elements, varDefault, } from 'tosijs';
-import { colorInput } from './color-input';
+import { colorInput } from './color-input.js';
 const { form, slot, tosiSlot, label, input, span } = elements;
 function attr(element, name, value) {
     if (value !== '' && value !== false) {

package/dist/header.js

@@ -89,7 +89,7 @@ preview.append(
 */
 /*{ "parent": "Components" }*/
 import { Component, elements, varDefault } from 'tosijs';
-import { icons } from './icons';
+import { icons } from './icons.js';
 const { a } = elements;
 // ============================================================================
 // Header Component
@@ -101,7 +101,7 @@ export class TosiHeader extends Component {
             display: 'flex',
             alignItems: 'center',
             padding: varDefault.tosiHeaderPadding('12px 24px'),
-            background: varDefault.tosiHeaderBg('var(--tosi-accent, #EE257B)'),
+            background: varDefault.tosiHeaderBg('var(--tosi-accent, #d92270)'),
             lineHeight: varDefault.tosiHeaderLineHeight('32px'),
             gap: varDefault.tosiHeaderGap('8px'),
         },

package/dist/icon-svg.js

@@ -31,7 +31,7 @@ server-rendered template had no way to get markup except by parsing
 resorted to when putting its own logo on a generated page. There is nothing to protect:
 the map ships in the bundle either way.
 */
-import iconData from './icon-data';
+import iconData from './icon-data.js';
 export function iconSvg(name) {
     const data = iconData;
     let key = name.endsWith('_') ? name.slice(0, -1) : name;