@braidlabs/console 0.3.0 → 0.4.0

package/src/lib/shell-codegen.js

@@ -0,0 +1,316 @@
+import { formatAreas, isSafeTrackList, parseAreas } from '@braidlabs/registry';
+export const SHELL_TARGETS = [
+    { id: 'react', label: 'React' },
+    { id: 'angular', label: 'Angular' },
+    { id: 'angular-ssr', label: 'Angular SSR' },
+    { id: 'vanilla', label: 'Plain JS' },
+];
+export function shellCode(shell, fragments, target) {
+    const byId = new Map(fragments.map((fragment) => [fragment.id, fragment]));
+    const used = new Set();
+    const routes = shell.routes.map((route, index) => describeRoute(shell, route, uniqueStem(shell, route, index, used), byId));
+    switch (target) {
+        case 'react':
+            return [reactRoutes(shell, routes), layoutCss(routes), indexHtml(shell, '<div id="root"></div>')];
+        case 'angular':
+            return [...angularFiles(shell, routes), indexHtml(shell, '<app-root></app-root>')];
+        case 'angular-ssr':
+            return [...angularFiles(shell, routes), angularServer(shell), indexHtml(shell, '<app-root></app-root>')];
+        case 'vanilla':
+            return routes.map((route) => vanillaPage(shell, route));
+    }
+}
+/** `/orders/*` → `<shell>-orders`, `/` → `<shell>-root`; a collision gets its route index appended. */
+function uniqueStem(shell, route, index, used) {
+    const base = `${ident(shell.id)}-${ident(route.path) || 'root'}`;
+    let stem = base;
+    for (let n = index; used.has(stem); n += 1)
+        stem = `${base}-${n}`;
+    used.add(stem);
+    return stem;
+}
+function describeRoute(shell, route, stem, byId) {
+    const parsed = parseAreas(route.layout.areas);
+    const names = parsed.areas.map((area) => area.name);
+    const slots = Object.entries(route.slots ?? {})
+        .filter(([area]) => names.includes(area))
+        .map(([area, fragment]) => {
+        const manifest = byId.get(fragment);
+        // Only widgets (bound: false) take a src; a screen follows the host's own location.
+        const src = manifest?.bound === false ? manifest.src : undefined;
+        return { area, fragment, ...(src ? { src } : {}) };
+    });
+    return {
+        path: route.path,
+        stem,
+        componentName: `${pascal(stem)}Layout`,
+        areaRows: parsed.errors.length > 0 ? [] : formatAreas(parsed.cells),
+        ...trackProps(route.layout),
+        slots,
+        empty: names.filter((name) => !slots.some((slot) => slot.area === name)),
+    };
+}
+function trackProps(layout) {
+    const safe = (value) => (value !== undefined && isSafeTrackList(value) ? value.trim() : undefined);
+    const columns = safe(layout.columns);
+    const rows = safe(layout.rows);
+    const gap = safe(layout.gap);
+    return { ...(columns ? { columns } : {}), ...(rows ? { rows } : {}), ...(gap ? { gap } : {}) };
+}
+// ---------------------------------------------------------------------------
+// Shared pieces
+// ---------------------------------------------------------------------------
+function cssRule(route, selector) {
+    return [
+        `${selector} {`,
+        `  display: grid;`,
+        ...(route.gap ? [`  gap: ${route.gap};`] : []),
+        ...(route.columns ? [`  grid-template-columns: ${route.columns};`] : []),
+        ...(route.rows ? [`  grid-template-rows: ${route.rows};`] : []),
+        `  grid-template-areas:`,
+        ...route.areaRows.map((row, index) => `    ${row}${index === route.areaRows.length - 1 ? ';' : ''}`),
+        `}`,
+    ];
+}
+function layoutCss(routes) {
+    return {
+        name: 'shell-layout.css',
+        language: 'css',
+        code: routes.flatMap((route) => [`/* ${commentSafe(route.path)} */`, ...cssRule(route, `.${route.stem}`), '']).join('\n').trimEnd(),
+    };
+}
+function headLines(shell) {
+    const head = shell.head ?? {};
+    const ownViewport = (head.meta ?? []).some((meta) => meta.name === 'viewport');
+    return [
+        `<meta charset="utf-8">`,
+        ...(ownViewport ? [] : [`<meta name="viewport" content="width=device-width, initial-scale=1">`]),
+        ...(head.title ? [`<title>${escapeHtml(head.title)}</title>`] : []),
+        ...(head.meta ?? [])
+            .filter((meta) => meta.name ?? meta.property)
+            .map((meta) => meta.property
+            ? `<meta property="${escapeHtml(meta.property)}" content="${escapeHtml(meta.content)}">`
+            : `<meta name="${escapeHtml(meta.name ?? '')}" content="${escapeHtml(meta.content)}">`),
+        ...(head.stylesheets ?? []).map((sheet) => `<link rel="stylesheet" href="${escapeHtml(sheet.href)}"${sheet.integrity ? ` integrity="${escapeHtml(sheet.integrity)}" crossorigin="anonymous"` : ''}>`),
+        ...(head.scripts ?? []).map((script) => {
+            const attrs = [
+                ...(script.type === 'module' ? [`type="module"`] : []),
+                `src="${escapeHtml(script.src)}"`,
+                ...(script.integrity ? [`integrity="${escapeHtml(script.integrity)}"`, `crossorigin="anonymous"`] : []),
+                ...(script.async ? ['async'] : []),
+                ...(script.defer ? ['defer'] : []),
+            ];
+            return `<script ${attrs.join(' ')}></script>`;
+        }),
+    ];
+}
+function indexHtml(shell, body) {
+    return {
+        name: 'index.html',
+        language: 'html',
+        code: [
+            `<!doctype html>`,
+            `<html lang="en">`,
+            `<head>`,
+            ...headLines(shell).map((line) => `  ${line}`),
+            `</head>`,
+            `<body>`,
+            `  ${body}`,
+            `</body>`,
+            `</html>`,
+        ].join('\n'),
+    };
+}
+function header(shell, comment) {
+    return [comment(`Generated by Braid Console from shell ${jsString(shell.id)}. Regenerate rather than edit by hand.`)];
+}
+const js = (text) => `// ${commentSafe(text)}`;
+// ---------------------------------------------------------------------------
+// React
+// ---------------------------------------------------------------------------
+function reactRoutes(shell, routes) {
+    const components = routes.flatMap((route) => [
+        js(`Route ${route.path}`),
+        `export function ${route.componentName}() {`,
+        `  return (`,
+        // Braces, not quotes: a JSX string attribute has no escapes, so a value is only safe as a JS
+        // expression.
+        `    <div className={${jsString(route.stem)}}>`,
+        ...route.slots.map((slot) => `      <BraidFragment name={${jsString(slot.fragment)}}${slot.src ? ` src={${jsString(slot.src)}}` : ''} style={{ gridArea: ${jsString(slot.area)} }} />`),
+        ...(route.empty.length ? [`      {/* empty areas: ${commentSafe(route.empty.join(', '))} */}`] : []),
+        `    </div>`,
+        `  );`,
+        `}`,
+        ``,
+    ]);
+    return {
+        name: `${ident(shell.id)}.tsx`,
+        language: 'tsx',
+        code: [
+            ...header(shell, js),
+            js(`Call initBraidReact() once before rendering, and route each path below to its layout.`),
+            `import { BraidFragment } from '@braidlabs/react';`,
+            `import './shell-layout.css';`,
+            ``,
+            ...components,
+            `export const routes = [`,
+            ...routes.map((route) => `  { path: ${jsString(route.path)}, element: <${route.componentName} /> },`),
+            `];`,
+        ].join('\n'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Angular
+// ---------------------------------------------------------------------------
+function angularFiles(shell, routes) {
+    const components = routes.flatMap((route) => {
+        const template = [
+            `<div class="${escapeAngular(route.stem)}">`,
+            ...route.slots.map((slot) => `  <braid-fragment name="${escapeAngular(slot.fragment)}"${slot.src ? ` src="${escapeAngular(slot.src)}"` : ''} style="grid-area: ${escapeAngular(slot.area)}" />`),
+            `</div>`,
+        ];
+        return [
+            js(`Route ${route.path}`),
+            `@Component({`,
+            `  selector: ${jsString(`app-${route.stem}`)},`,
+            `  imports: [BraidFragment],`,
+            `  template: \``,
+            ...template.map((line) => `    ${templateLiteral(line)}`),
+            `  \`,`,
+            `  styles: \``,
+            ...cssRule(route, `.${route.stem}`).map((line) => `    ${templateLiteral(line)}`),
+            `  \`,`,
+            `})`,
+            `export class ${route.componentName} {}`,
+            ``,
+        ];
+    });
+    return [
+        {
+            name: `${ident(shell.id)}.routes.ts`,
+            language: 'typescript',
+            code: [
+                ...header(shell, js),
+                js(`Add provideBraid() to the application's providers once.`),
+                `import { Component } from '@angular/core';`,
+                `import type { Routes } from '@angular/router';`,
+                `import { BraidFragment } from '@braidlabs/angular';`,
+                ``,
+                ...components,
+                `export const routes: Routes = [`,
+                ...routes.map((route) => `  { path: ${jsString(angularPath(route.path))}, component: ${route.componentName} },`),
+                `];`,
+            ].join('\n'),
+        },
+    ];
+}
+/** URLPattern pathname → Angular route path: no leading slash, and a trailing `*` becomes `**`. */
+export function angularPath(path) {
+    return path.replace(/^\/+/, '').replace(/(^|\/)\*$/, '$1**');
+}
+function angularServer(shell) {
+    return {
+        name: 'server.ts',
+        language: 'typescript',
+        code: [
+            ...header(shell, js),
+            js(`The gateway sits in front of the Angular SSR handler: it asks Angular for the shell`),
+            js(`document, then server-side renders each fragment into its <fragment-slot>.`),
+            `import { createGateway } from '@braidlabs/gateway';`,
+            `import { toNodeMiddleware } from '@braidlabs/gateway/node';`,
+            `import { snapshotRegistry } from '@braidlabs/registry';`,
+            `import { fileSnapshotStore } from '@braidlabs/registry/node';`,
+            ``,
+            `const gateway = createGateway({`,
+            `  mode: 'production',`,
+            `  registry: snapshotRegistry({`,
+            `    store: fileSnapshotStore({ directory: process.env['BRAID_REGISTRY_DIR'] ?? '.braid/registry' }),`,
+            `    pinned: process.env['BRAID_REGISTRY_SNAPSHOT'],`,
+            `  }),`,
+            `});`,
+            ``,
+            js(`Before the Angular request handler, so it can wrap the documents Angular renders:`),
+            `app.use(toNodeMiddleware(gateway));`,
+        ].join('\n'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Plain JS
+// ---------------------------------------------------------------------------
+function vanillaPage(shell, route) {
+    return {
+        name: `${route.stem}.html`,
+        language: 'html',
+        code: [
+            `<!doctype html>`,
+            `<!-- ${commentSafe(`Generated by Braid Console from shell "${shell.id}", route ${route.path}.`)} -->`,
+            `<html lang="en">`,
+            `<head>`,
+            ...headLines(shell).map((line) => `  ${line}`),
+            `  <style>`,
+            ...cssRule(route, `.${route.stem}`).map((line) => `    ${line}`),
+            `  </style>`,
+            `  <script type="module">`,
+            `    // A bare specifier: serve this page through your bundler, or map it with an import map.`,
+            `    import { initBraid } from '@braidlabs/core';`,
+            `    initBraid();`,
+            `  </script>`,
+            `</head>`,
+            `<body>`,
+            `  <div class="${escapeHtml(route.stem)}">`,
+            ...route.slots.map((slot) => `    <fragment-slot name="${escapeHtml(slot.fragment)}"${slot.src ? ` src="${escapeHtml(slot.src)}"` : ''} style="grid-area: ${escapeHtml(slot.area)}"></fragment-slot>`),
+            `  </div>`,
+            `</body>`,
+            `</html>`,
+        ].join('\n'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Escaping
+// ---------------------------------------------------------------------------
+export function escapeHtml(value) {
+    return String(value).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
+/**
+ * A JS string literal. JSON.stringify leaves U+2028 and U+2029 raw: legal in a string since ES2019,
+ * but invisible to a reviewer and a line break to older tooling.
+ */
+function jsString(value) {
+    return JSON.stringify(String(value)).replace(/\u2028/g, '\\u2028').replace(/\u2029/g, '\\u2029');
+}
+/** HTML escaping plus braces, so a value cannot become an Angular `{{ }}` interpolation. */
+function escapeAngular(value) {
+    return escapeHtml(value).replace(/\{/g, '&#123;').replace(/\}/g, '&#125;');
+}
+/** Text placed inside a JS template literal: no backtick, no `${`, no stray escape. */
+function templateLiteral(value) {
+    return value.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$\{/g, '\\${');
+}
+/**
+ * Text placed inside a comment of any of the three languages, unable to close it early: `*\/`
+ * for CSS and block comments, `-->`, `--!>` and `<!--` for HTML, and every line terminator JS
+ * recognizes — U+2028 and U+2029 end a `//` comment too, and most editors draw them invisibly.
+ */
+function commentSafe(value) {
+    return String(value)
+        .replace(/\*\//g, '* /')
+        .replace(/--!?>/g, '-- >')
+        .replace(/<!--/g, '< !--')
+        .replace(/[\r\n\u2028\u2029]+/g, ' ');
+}
+/** A CSS-identifier- and filename-safe stem. */
+function ident(value) {
+    return value
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/^(\d)/, 'x$1')
+        .toLowerCase();
+}
+function pascal(value) {
+    return value
+        .split('-')
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+//# sourceMappingURL=shell-codegen.js.map

package/src/lib/shell-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-codegen.js","sourceRoot":"","sources":["../../../../../libs/braid-console/src/lib/shell-codegen.ts"],"names":[],"mappings":"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"}

package/src/lib/shells-panel.d.ts

@@ -0,0 +1,43 @@
+import { type ShellManifest } from '@braidlabs/registry';
+import { type ConsoleApi, type PublishOutcome } from './client.js';
+export interface ShellsPanelProps {
+    /** Needs the registry write API: shells live in snapshots, which discovery does not serve. */
+    api?: ConsoleApi;
+    theme?: 'light' | 'dark';
+    className?: string;
+    /**
+     * The open shell's id, when the host keeps it in its URL. Uncontrolled when omitted.
+     * `onSelect` reports opens, closes and renames, so the host can follow.
+     */
+    selected?: string | null;
+    onSelect?: (id: string | null) => void;
+    onPublished?: (outcome: PublishOutcome) => void;
+    /**
+     * Whether there are unpublished changes, for a host that wants to warn before leaving. The
+     * panel does not touch `beforeunload` itself: the page is the host's.
+     */
+    onDirtyChange?: (dirty: boolean) => void;
+    /**
+     * Change it to have the panel reload HEAD — after a rollback elsewhere, say. Ignored while there
+     * are unpublished changes: those publish against their own base and a stale one is a 409.
+     */
+    refreshKey?: unknown;
+}
+/**
+ * Shells: list, design, and publish them.
+ *
+ * Same contract as the fragment editor: **branch from what is pinned → edit → publish a new
+ * snapshot**. A draft lives in the browser until then. Publishing sends the pinned fragments back
+ * unchanged with the edited shells, and `baseId`, so a publish that would overwrite someone else's
+ * is refused rather than silently winning.
+ *
+ * The head a shell declares — meta tags, scripts, stylesheets — is edited as data and never
+ * injected into this page. Rendering it here would run third-party code in the admin origin with
+ * an operator's token in reach; the preview draws the grid and nothing else.
+ */
+export declare function ShellsPanel({ api, theme, className, selected, onSelect, onPublished, onDirtyChange, refreshKey }: ShellsPanelProps): import("react").JSX.Element;
+/**
+ * A starting shell: a three-row page. Its id and its route are both unique, so two new shells
+ * never collide — a page has one shell, and validation refuses two on the same route.
+ */
+export declare function newShell(existing: readonly ShellManifest[], tags?: string[]): ShellManifest;