@flux-lang/viewer 0.1.4-canary.078fd1eea

package/dist/editor-dist.d.ts

@@ -0,0 +1,19 @@
+import { promises as fs } from "node:fs";
+export type EditorDistSource = "flag" | "env" | "embedded" | "missing";
+export interface EditorDistResolution {
+    dir: string | null;
+    indexPath: string | null;
+    source: EditorDistSource;
+    reason?: string;
+    tried?: string[];
+}
+export interface ResolveEditorDistOptions {
+    editorDist?: string;
+    env?: NodeJS.ProcessEnv;
+    embeddedDir?: string;
+    fsImpl?: Pick<typeof fs, "stat" | "access">;
+}
+export declare function resolveEditorDist(options?: ResolveEditorDistOptions): Promise<EditorDistResolution>;
+export declare function defaultEmbeddedDir(): string;
+export declare function buildEditorMissingHtml(resolution: EditorDistResolution): string;
+//# sourceMappingURL=editor-dist.d.ts.map

package/dist/editor-dist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-dist.d.ts","sourceRoot":"","sources":["../src/editor-dist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAIzC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CAC7C;AAID,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiD7G;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAaD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAiC/E"}

package/dist/editor-dist.js

@@ -0,0 +1,110 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const DEFAULT_INDEX = "index.html";
+export async function resolveEditorDist(options = {}) {
+    const env = options.env ?? process.env;
+    const fsImpl = options.fsImpl ?? fs;
+    const tried = [];
+    const maybeCheck = async (rawPath, source) => {
+        if (!rawPath)
+            return null;
+        const resolved = path.isAbsolute(rawPath) ? rawPath : path.resolve(process.cwd(), rawPath);
+        tried.push(resolved);
+        const ok = await hasIndex(fsImpl, resolved);
+        if (ok) {
+            return {
+                dir: resolved,
+                indexPath: path.join(resolved, DEFAULT_INDEX),
+                source,
+            };
+        }
+        return {
+            dir: resolved,
+            indexPath: null,
+            source: "missing",
+            reason: `Missing ${DEFAULT_INDEX} in ${resolved}`,
+            tried,
+        };
+    };
+    const flagResult = await maybeCheck(options.editorDist, "flag");
+    if (flagResult)
+        return flagResult;
+    const envResult = await maybeCheck(env?.FLUX_EDITOR_DIST, "env");
+    if (envResult)
+        return envResult;
+    const embedded = options.embeddedDir ?? defaultEmbeddedDir();
+    tried.push(embedded);
+    if (await hasIndex(fsImpl, embedded)) {
+        return {
+            dir: embedded,
+            indexPath: path.join(embedded, DEFAULT_INDEX),
+            source: "embedded",
+        };
+    }
+    return {
+        dir: embedded,
+        indexPath: null,
+        source: "missing",
+        reason: `Missing ${DEFAULT_INDEX} in ${embedded}`,
+        tried,
+    };
+}
+export function defaultEmbeddedDir() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..", "editor-dist");
+}
+async function hasIndex(fsImpl, dir) {
+    try {
+        const stats = await fsImpl.stat(dir);
+        if (!stats.isDirectory())
+            return false;
+        await fsImpl.access(path.join(dir, DEFAULT_INDEX));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function buildEditorMissingHtml(resolution) {
+    const tried = resolution.tried?.filter(Boolean) ?? [];
+    const listItems = tried.map((item) => `<li><code>${escapeHtml(item)}</code></li>`).join("");
+    const reason = resolution.reason ? `<p>${escapeHtml(resolution.reason)}</p>` : "";
+    return [
+        "<!doctype html>",
+        "<html>",
+        "<head>",
+        '<meta charset="utf-8">',
+        "<title>Flux Editor Missing</title>",
+        '<meta name="viewport" content="width=device-width, initial-scale=1">',
+        "<style>",
+        "body { font-family: \"Source Sans 3\", system-ui, sans-serif; padding: 24px; background: #141311; color: #ece7df; }",
+        "code { background: #1f1d19; padding: 2px 6px; border-radius: 4px; }",
+        "a { color: #9fd0ff; }",
+        "ul { padding-left: 20px; }",
+        "</style>",
+        "</head>",
+        "<body>",
+        "<h1>Flux editor bundle not found</h1>",
+        reason,
+        "<p>Build the in-repo editor bundle (base <code>/edit/</code>) and sync it into the viewer package:</p>",
+        "<pre><code>npm run build --workspace @flux-lang/editor-ui</code></pre>",
+        "<pre><code>npm run sync-editor</code></pre>",
+        "<p>Or point the viewer at a local editor build:</p>",
+        "<pre><code>FLUX_EDITOR_DIST=/abs/path/to/editor/dist flux view &lt;file&gt;</code></pre>",
+        "<p>CLI flag option:</p>",
+        "<pre><code>flux view --editor-dist /abs/path/to/flux-site/dist &lt;file&gt;</code></pre>",
+        "<p>Paths checked:</p>",
+        `<ul>${listItems || "<li><em>none</em></li>"}</ul>`,
+        "</body>",
+        "</html>",
+    ].join("\n");
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+//# sourceMappingURL=editor-dist.js.map

package/dist/editor-dist.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { createDocumentRuntimeIR, type RenderDocumentIR } from "@flux-lang/core";
+import { renderHtml, type RenderHtmlResult } from "@flux-lang/render-html";
+export declare const VIEWER_VERSION: string;
+export interface ViewerServerOptions {
+    docPath: string;
+    port?: number;
+    host?: string;
+    docstepMs?: number;
+    seed?: number;
+    allowNet?: string[];
+    docstepStart?: number;
+    advanceTime?: boolean;
+    timeRate?: number;
+    editorDist?: string;
+}
+export interface ViewerServer {
+    port: number;
+    url: string;
+    buildId?: string | null;
+    editorDist?: string | null;
+    close(): Promise<void>;
+}
+type ViewerRenderOptions = Parameters<typeof renderHtml>[1];
+export declare function noCacheHeaders(extra?: Record<string, string>): Record<string, string>;
+export declare function computeBuildId(dir: string | null | undefined, indexPath: string | null | undefined): Promise<string | null>;
+export declare function advanceViewerRuntime(runtime: ReturnType<typeof createDocumentRuntimeIR>, renderOptions: ViewerRenderOptions, advanceTime: boolean, dtSeconds: number, timeRate: number): {
+    ir: RenderDocumentIR;
+    render: RenderHtmlResult;
+};
+export declare function startViewerServer(options: ViewerServerOptions): Promise<ViewerServer>;
+export declare function getViewerJs(): string;
+export { resolveEditorDist, defaultEmbeddedDir } from "./editor-dist.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,uBAAuB,EASvB,KAAK,gBAAgB,EAGtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ3E,eAAO,MAAM,cAAc,QAAyD,CAAC;AAErF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAmED,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D,wBAAgB,cAAc,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzF;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,EACnD,aAAa,EAAE,mBAAmB,EAClC,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf;IAAE,EAAE,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAWpD;AAID,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAujC3F;AAwGD,wBAAgB,WAAW,IAAI,MAAM,CAgvBpC;AAshCD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}