@loomweaver/cli 0.7.2

package/dist/main.mjs

@@ -0,0 +1,2526 @@
+#!/usr/bin/env node
+
+// ../devkit/src/lib/generate/generate.ts
+function isUnsafePath(path) {
+  return path.length === 0 || path.startsWith("/") || path.includes("\\") || path.split("/").includes("..");
+}
+function generate(recipe, input) {
+  const files = recipe.build(input);
+  const unsafe = Object.keys(files).find(isUnsafePath);
+  if (unsafe !== void 0) {
+    throw new Error(`Recipe "${recipe.id}" produced an unsafe path: "${unsafe}".`);
+  }
+  return files;
+}
+
+// ../devkit/src/lib/generate/casing.ts
+function isKebabId(value) {
+  return /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(value);
+}
+function words(value) {
+  return value.split(/[-_\s]+/).filter(Boolean);
+}
+function toPascalCase(value) {
+  return words(value).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+function toCamelCase(value) {
+  const pascal = toPascalCase(value);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function toTitleCase(value) {
+  return words(value).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+
+// ../devkit/src/lib/validate/manifest.ts
+var KNOWN_CAPABILITIES = [
+  "contributions",
+  "ui",
+  "host",
+  "navigation",
+  "session",
+  "theme",
+  "automation"
+];
+function validateManifest(manifest2, known = KNOWN_CAPABILITIES) {
+  const findings = [];
+  if (typeof manifest2.id !== "string" || !isKebabId(manifest2.id)) {
+    findings.push({
+      level: "error",
+      code: "manifest.id",
+      message: `Plugin id must be a kebab-case string; got ${JSON.stringify(manifest2.id)}.`,
+      path: "manifest.id"
+    });
+  }
+  if (manifest2.name !== void 0 && typeof manifest2.name !== "string") {
+    findings.push({
+      level: "error",
+      code: "manifest.name",
+      message: "Plugin name must be a string when provided.",
+      path: "manifest.name"
+    });
+  }
+  findings.push(...validateCapabilities(manifest2.capabilities, known));
+  return findings;
+}
+function validateCapabilities(capabilities, known) {
+  if (capabilities === void 0) {
+    return [];
+  }
+  if (!Array.isArray(capabilities)) {
+    return [
+      {
+        level: "error",
+        code: "manifest.capabilities",
+        message: "capabilities must be an array when provided.",
+        path: "manifest.capabilities"
+      }
+    ];
+  }
+  const findings = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const capability of capabilities) {
+    if (typeof capability !== "string" || !known.includes(capability)) {
+      findings.push({
+        level: "error",
+        code: "manifest.capability.unknown",
+        message: `Unknown capability ${JSON.stringify(capability)}. Known: ${known.join(", ")}.`,
+        path: "manifest.capabilities"
+      });
+      continue;
+    }
+    if (seen.has(capability)) {
+      findings.push({
+        level: "warning",
+        code: "manifest.capability.duplicate",
+        message: `Duplicate capability "${capability}".`,
+        path: "manifest.capabilities"
+      });
+    }
+    seen.add(capability);
+  }
+  return findings;
+}
+
+// ../devkit/src/recipes/angular-weaver/weaver-i18n.ts
+function i18nBundle(w) {
+  const bundle = { title: w.name };
+  if (w.features.container) {
+    bundle["canvas"] = "Canvas";
+    bundle["details"] = "Details";
+  }
+  if (w.features.command) {
+    bundle["action"] = `${w.name} action`;
+    bundle["actionDescription"] = `Shows a short ${w.name} message.`;
+  }
+  if (w.features.about) bundle["about"] = `About ${w.name}`;
+  if (w.features.settings)
+    bundle["settings"] = { title: w.name, enabled: "Enabled", note: "Note" };
+  return bundle;
+}
+function i18nFile(w) {
+  return JSON.stringify(i18nBundle(w), null, 2) + "\n";
+}
+
+// ../devkit/src/recipes/angular-weaver/recipe.ts
+var DEFAULT_MENU_SLOT = "content/tab/context";
+var SURFACE_ICON = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><rect x="4" y="4" width="16" height="16" rx="3"/><path d="M8 9h8M8 13h8M8 17h5"/></svg>';
+function accessLiteral(spec) {
+  if (spec === "authenticated") return "{ authenticated: true }";
+  if (spec === "anonymous") return "{ authenticated: false }";
+  if (spec.startsWith("role:")) {
+    const role = spec.slice("role:".length);
+    if (!role)
+      throw new Error('Access "role:" needs a role name, e.g. "role:admin".');
+    if (/['\\]/.test(role))
+      throw new Error(
+        `Access role "${role}" must not contain quotes or backslashes.`
+      );
+    return `{ anyRole: ['${role}'] }`;
+  }
+  throw new Error(
+    `Unknown access "${spec}". Use "authenticated", "anonymous" or "role:<name>".`
+  );
+}
+function resolveMenuSlot(menu) {
+  if (menu === true) {
+    return DEFAULT_MENU_SLOT;
+  }
+  return typeof menu === "string" && menu.length ? menu : void 0;
+}
+var PLATFORM_BOUND_CHORD_TOKENS = [
+  "cmd",
+  "command",
+  "ctrl",
+  "control",
+  "meta"
+];
+function assertPlatformNeutralChord(shortcut) {
+  const tokens = shortcut.toLowerCase().split("+").map((token) => token.trim());
+  const bound = tokens.find(
+    (token) => PLATFORM_BOUND_CHORD_TOKENS.includes(token)
+  );
+  if (bound) {
+    throw new Error(
+      `Shortcut "${shortcut}" binds the platform-specific "${bound}" key. Use the neutral 'mod' token (e.g. 'mod+shift+k') \u2014 the host renders it as \u2318 on macOS and Ctrl elsewhere.`
+    );
+  }
+}
+function resolveFeatures(id, input) {
+  const menuSlot = resolveMenuSlot(input?.menu);
+  const barItem = Boolean(input?.barItem);
+  const hasShortcut = Boolean(input?.shortcut?.trim());
+  if (hasShortcut) {
+    assertPlatformNeutralChord(input?.shortcut?.trim() ?? "");
+  }
+  const instanceable = Boolean(input?.instanceable);
+  const container = Boolean(input?.container);
+  if (instanceable && container) {
+    throw new Error(
+      'A surface cannot be both a container and instanceable: a container tab holds its own ":id" and is therefore routable, while named instances exist only for a docked, non-routable surface. Pick one.'
+    );
+  }
+  return {
+    command: Boolean(input?.command) || menuSlot !== void 0 || barItem || hasShortcut,
+    menuSlot,
+    settings: Boolean(input?.settings),
+    access: input?.access ? accessLiteral(input.access) : void 0,
+    shortcut: input?.shortcut?.trim() || `mod+shift+${id.charAt(0)}`,
+    barItem,
+    about: Boolean(input?.about),
+    instanceable,
+    container,
+    spec: input?.spec !== false
+  };
+}
+function deriveCapabilities(features) {
+  const set = /* @__PURE__ */ new Set(["contributions", "navigation"]);
+  if (features.command) set.add("ui");
+  if (features.about) {
+    set.add("ui");
+    set.add("host");
+  }
+  return KNOWN_CAPABILITIES.filter((capability) => set.has(capability));
+}
+function resolveWeaverInput(input) {
+  if (!isKebabId(input.id)) {
+    throw new Error(
+      `Weaver id must be kebab-case (e.g. "notes"); got "${input.id}".`
+    );
+  }
+  const features = resolveFeatures(input.id, input.features);
+  const capabilities = input.capabilities?.length ? [...input.capabilities] : deriveCapabilities(features);
+  return {
+    id: input.id,
+    name: input.name?.trim() || toTitleCase(input.id),
+    className: toPascalCase(input.id),
+    propertyName: toCamelCase(input.id),
+    capabilities,
+    features,
+    prefix: input.prefix?.trim() || "lw",
+    importPath: input.importPath?.trim() || `@loomweaver/${input.id}-weaver`
+  };
+}
+function capabilityItems(capabilities) {
+  return capabilities.map((capability) => `'${capability}'`).join(", ");
+}
+var CONTAINER_EXAMPLE_ID = "example";
+function containerChildIds(w) {
+  return [`${w.id}.canvas`, `${w.id}.details`];
+}
+function containerSurfaceBlock(w) {
+  const children = containerChildIds(w).map((id) => `'${id}'`).join(", ");
+  const lines = [
+    "    ctx.registerSurface({",
+    `      id: '${w.id}',`,
+    `      title: '${w.id}.title',`,
+    `      icon: '${w.id}',`,
+    `      routable: { path: '${w.id}/:id' },`,
+    "      container: {",
+    `        children: [${children}],`,
+    `        initial: [${children}],`,
+    "      },"
+  ];
+  if (w.features.access) lines.push(`      access: ${w.features.access},`);
+  lines.push("    });");
+  for (const [suffix, className] of [
+    ["canvas", `${w.className}CanvasView`],
+    ["details", `${w.className}DetailsView`]
+  ]) {
+    lines.push(
+      "    ctx.registerSurface({",
+      `      id: '${w.id}.${suffix}',`,
+      `      title: '${w.id}.${suffix}',`,
+      "      docks: [],",
+      `      component: ${className},`,
+      "    });"
+    );
+  }
+  return lines.join("\n");
+}
+function surfaceBlock(w) {
+  if (w.features.container) {
+    return containerSurfaceBlock(w);
+  }
+  const lines = [
+    "    ctx.registerSurface({",
+    `      id: '${w.id}',`,
+    `      title: '${w.id}.title',`,
+    `      icon: '${w.id}',`,
+    `      component: ${w.className}View,`
+  ];
+  if (w.features.instanceable) {
+    lines.push("      docks: ['primary'],", "      instanceable: true,");
+  } else {
+    lines.push(`      routable: { path: '${w.id}' },`);
+  }
+  if (w.features.access) lines.push(`      access: ${w.features.access},`);
+  lines.push("    });");
+  return lines.join("\n");
+}
+function railTarget(w) {
+  if (w.features.container) {
+    return `ctx.navigateContent('${w.id}/${CONTAINER_EXAMPLE_ID}')`;
+  }
+  if (w.features.instanceable) {
+    return `ctx.revealSurface('${w.id}')`;
+  }
+  return `ctx.navigateContent('${w.id}')`;
+}
+function railBlock(w) {
+  const lines = [
+    "    ctx.registerRailItem({",
+    `      id: '${w.id}.rail',`,
+    "      rail: 'primary',",
+    `      icon: '${w.id}',`,
+    `      title: '${w.id}.title',`,
+    `      run: () => ${railTarget(w)},`
+  ];
+  if (w.features.access) lines.push(`      access: ${w.features.access},`);
+  lines.push("    });");
+  return lines.join("\n");
+}
+function commandBlock(w) {
+  return [
+    "    ctx.registerCommand({",
+    `      id: '${w.id}.hello',`,
+    `      title: '${w.id}.action',`,
+    `      description: '${w.id}.actionDescription',`,
+    `      shortcut: '${w.features.shortcut}',`,
+    "      callable: true,",
+    `      run: () => ctx.ui.toast({ message: '${w.id}.action', kind: 'info' }),`,
+    "    });"
+  ].join("\n");
+}
+function barItemBlock(w) {
+  return [
+    "    ctx.registerBarItem({",
+    `      id: '${w.id}.bar',`,
+    "      bar: 'status-bar',",
+    "      slot: 'end',",
+    `      icon: '${w.id}',`,
+    `      tooltip: '${w.id}.action',`,
+    `      command: '${w.id}.hello',`,
+    "    });"
+  ].join("\n");
+}
+function aboutCommandBlock(w) {
+  return [
+    "    ctx.registerCommand({",
+    `      id: '${w.id}.about',`,
+    `      title: '${w.id}.about',`,
+    `      run: () => ctx.ui.open(${w.className}AboutDialog, { data: ctx.host, title: '${w.id}.title' }),`,
+    "    });"
+  ].join("\n");
+}
+function aboutRailBlock(w) {
+  return [
+    "    ctx.registerRailItem({",
+    `      id: '${w.id}.rail.about',`,
+    "      rail: 'primary',",
+    "      anchor: 'bottom',",
+    `      icon: '${w.id}',`,
+    `      title: '${w.id}.about',`,
+    `      command: '${w.id}.about',`,
+    "    });"
+  ].join("\n");
+}
+function menuBlock(w) {
+  return [
+    "    ctx.registerMenuItem({",
+    `      menu: '${w.features.menuSlot}',`,
+    `      command: '${w.id}.hello',`,
+    "    });"
+  ].join("\n");
+}
+function settingsBlock(w) {
+  return [
+    "    ctx.registerSettingsSection({",
+    `      id: '${w.id}',`,
+    `      title: '${w.id}.settings.title',`,
+    "      rows: [",
+    "        {",
+    "          id: 'enabled',",
+    `          label: '${w.id}.settings.enabled',`,
+    `          control: { kind: 'toggle', value: () => ${w.propertyName}Enabled(), set: (v) => ${w.propertyName}Enabled.set(v) },`,
+    "        },",
+    "        {",
+    "          id: 'note',",
+    `          label: '${w.id}.settings.note',`,
+    `          control: { kind: 'text', value: () => ${w.propertyName}Note(), set: (v) => ${w.propertyName}Note.set(v) },`,
+    "        },",
+    "      ],",
+    "    });"
+  ].join("\n");
+}
+function pluginFile(w) {
+  const imports = ["import { Plugin } from '@loomweaver/plugin-sdk';"];
+  if (w.features.container) {
+    imports.push(
+      `import { ${w.className}CanvasView } from '../views/${w.id}-canvas-view';`,
+      `import { ${w.className}DetailsView } from '../views/${w.id}-details-view';`
+    );
+  } else {
+    imports.push(`import { ${w.className}View } from '../views/${w.id}-view';`);
+  }
+  if (w.features.about) {
+    imports.push(
+      `import { ${w.className}AboutDialog } from '../dialogs/${w.id}-about-dialog';`
+    );
+  }
+  if (w.features.settings) {
+    imports.unshift("import { signal } from '@angular/core';");
+  }
+  const consts = [`const icon =
+  '${SURFACE_ICON}';`];
+  if (w.features.settings) {
+    consts.push(
+      `const ${w.propertyName}Enabled = signal(true);`,
+      `const ${w.propertyName}Note = signal('');`
+    );
+  }
+  const body = [`    ctx.contributeIcons({ '${w.id}': icon });`];
+  if (w.features.command) body.push(commandBlock(w));
+  if (w.features.about) body.push(aboutCommandBlock(w));
+  body.push(surfaceBlock(w), railBlock(w));
+  if (w.features.about) body.push(aboutRailBlock(w));
+  if (w.features.barItem) body.push(barItemBlock(w));
+  if (w.features.menuSlot) body.push(menuBlock(w));
+  if (w.features.settings) body.push(settingsBlock(w));
+  return `${imports.join("\n")}
+
+${consts.join("\n")}
+
+export const ${w.propertyName}Plugin: Plugin = {
+  manifest: {
+    id: '${w.id}',
+    name: '${w.name}',
+    capabilities: [${capabilityItems(w.capabilities)}],
+  },
+  activate(ctx) {
+${body.join("\n")}
+  },
+};
+`;
+}
+function aboutDialogFile(w) {
+  return `import { Component, inject } from '@angular/core';
+import { DialogRef, PluginHost } from '@loomweaver/plugin-sdk';
+
+@Component({
+  selector: '${w.prefix}-${w.id}-about-dialog',
+  templateUrl: './${w.id}-about-dialog.html',
+})
+export class ${w.className}AboutDialog {
+  protected readonly host = inject(DialogRef).data as PluginHost;
+}
+`;
+}
+function aboutDialogTemplateFile(w) {
+  return `<div class="flex flex-col items-center gap-2 text-center">
+  <h2 class="text-lg font-semibold text-content">${w.name}</h2>
+  <span class="text-xs text-content-faint tabular-nums">v{{ host.version() }}</span>
+</div>
+`;
+}
+function indexFile(w) {
+  return `export { ${w.propertyName}Plugin } from './lib/plugin/${w.id}.plugin';
+`;
+}
+function viewFile(w) {
+  if (!w.features.instanceable) {
+    return `import { Component } from '@angular/core';
+
+@Component({
+  selector: '${w.prefix}-${w.id}-view',
+  templateUrl: './${w.id}-view.html',
+})
+export class ${w.className}View {}
+`;
+  }
+  return `import { Component, computed, inject } from '@angular/core';
+import { VIEW_STATE, type ViewState } from '@loomweaver/plugin-sdk';
+
+interface ${w.className}State {
+  readonly sort: 'natural' | 'alpha';
+}
+
+const FRESH: ${w.className}State = { sort: 'natural' };
+
+@Component({
+  selector: '${w.prefix}-${w.id}-view',
+  templateUrl: './${w.id}-view.html',
+})
+export class ${w.className}View {
+  private readonly viewState = inject(VIEW_STATE) as ViewState<${w.className}State>;
+
+  // undefined = a fresh instance, so apply your own default.
+  private readonly state = computed(() => this.viewState.value() ?? FRESH);
+
+  protected readonly sort = computed(() => this.state().sort);
+
+  protected toggleSort(): void {
+    // set() replaces the whole blob, so spread what is already there.
+    this.viewState.set({
+      ...this.state(),
+      sort: this.sort() === 'alpha' ? 'natural' : 'alpha',
+    });
+  }
+}
+`;
+}
+function viewTemplateFile(w) {
+  const stateNote = w.features.instanceable ? `  <button type="button" class="lw-btn lw-btn--default self-start" (click)="toggleSort()">
+    Sort: {{ sort() }}
+  </button>
+  <p class="text-sm text-content-faint">
+    That choice lives in this instance's <code class="text-content">VIEW_STATE</code>, so it survives a
+    tab switch, a collapsed sidebar and a reload. Anything that must not be lost belongs there.
+  </p>
+` : "";
+  return `<div class="mx-auto flex max-w-2xl flex-col gap-4 p-6">
+  <h2 class="text-lg font-semibold text-content">${w.name}</h2>
+  <p class="text-sm text-content-faint">
+    Your new weaver surface. Register more surfaces, commands, rail items and menus on
+    <code class="text-content">ctx</code> inside the plugin's
+    <code class="text-content">activate</code>.
+  </p>
+${stateNote}</div>
+`;
+}
+function childViewFile(w, suffix, className) {
+  return `import { Component, inject } from '@angular/core';
+import { ActivatedRoute } from '@angular/router';
+
+@Component({
+  selector: '${w.prefix}-${w.id}-${suffix}-view',
+  templateUrl: './${w.id}-${suffix}-view.html',
+})
+export class ${className} {
+  private readonly route = inject(ActivatedRoute, { optional: true });
+
+  protected readonly instanceId =
+    this.route?.snapshot.paramMap.get('id') ?? '\u2014';
+}
+`;
+}
+function childViewTemplateFile(w, heading) {
+  return `<div class="flex h-full flex-col gap-3 p-4">
+  <h3 class="text-sm font-semibold text-content">${heading}</h3>
+  <p class="text-sm text-content-faint">
+    Scoped to <code class="text-content">{{ instanceId }}</code> \u2014 the id of the container tab this
+    pane lives in. Every open container tab has its own inner tree, so two of them show two
+    different ids side by side.
+  </p>
+</div>
+`;
+}
+function specFile(w) {
+  return `import { ${w.propertyName}Plugin } from './${w.id}.plugin';
+
+describe('${w.propertyName}Plugin', () => {
+  it('declares its manifest', () => {
+    expect(${w.propertyName}Plugin.manifest.id).toBe('${w.id}');
+    expect(${w.propertyName}Plugin.manifest.capabilities).toContain('contributions');
+  });
+});
+`;
+}
+function surfaceNotes(w) {
+  const railNote = "Rail and bar items reference region ids (`primary`, `status`) that must exist in your layout.";
+  if (w.features.container) {
+    return [
+      `The surface is a **container**: it is routable at \`/${w.id}/:id\`, and its tab holds a`,
+      "nested pane tree of child surfaces. The host draws the inner tabs, splits and drag targets; this",
+      "weaver only declares which children it offers.",
+      "",
+      `- \`children\` is what the inner "new tab" picker lists \u2014 the host access-gates it for you.`,
+      "- `initial` is what a freshly opened container tab starts with.",
+      `- The children declare \`docks: []\`. That is the container-only convention: they are never seeded`,
+      "  into a sidebar, they exist solely inside this container.",
+      `- Each child reads the container's \`:id\` from an injected \`ActivatedRoute\` \u2014 the host supplies a`,
+      "  synthetic one, so a child needs no knowledge of where it is mounted. Two open container tabs are",
+      "  two independent trees, each scoped to its own id.",
+      `- The inner tree is **sealed**: a child cannot be dragged out, and nothing can be dragged in. It`,
+      "  travels with the tab, including into a sidebar or a pop-out window.",
+      "",
+      `The rail item opens the fixed id \`${CONTAINER_EXAMPLE_ID}\`. Replace that with whatever the user`,
+      "actually picked \u2014 a document, a run, a project.",
+      "",
+      railNote
+    ];
+  }
+  if (w.features.instanceable) {
+    return [
+      `The surface is **docked** into the \`primary\` region and marked \`instanceable\`, so the host shows a`,
+      "switcher for saving, naming, renaming and deleting several configurations of it, each with its own",
+      "`VIEW_STATE` blob.",
+      "",
+      "It is deliberately **not** routable. Named instances exist only for a docked surface \u2014 a routable",
+      "one holds the URL pane instead, and the host drops `instanceable` on that path. The rail item",
+      "therefore reveals the surface (`ctx.revealSurface`) rather than navigating to a URL, which focuses",
+      "it wherever the user has since moved it.",
+      "",
+      "The generated view already uses that blob for its sort order, because a hidden surface is destroyed",
+      "as soon as it is clean: state kept in a component field survives neither a tab switch nor",
+      "a collapsed sidebar, and never survived a reload. The rule is *evictable = reload-safe* \u2014 anything",
+      "that must not be lost goes through `VIEW_STATE`, and `set()` replaces the whole blob, so spread it.",
+      "",
+      railNote
+    ];
+  }
+  return [
+    `The surface is routable at \`/${w.id}\`; ${railNote.charAt(0).toLowerCase()}${railNote.slice(1)}`,
+    "",
+    "A routable surface has **no `VIEW_STATE` handle** \u2014 injecting the token there throws. It owns a URL,",
+    "so anything shareable (a filter, the active sub-tab) belongs in route params or `subRoutes`, where it",
+    "survives a deep link too; unsaved edits are `DirtySurface`, and an instance that is expensive to",
+    "rebuild declares `retain: 'always'`. Generate with `--instanceable` for the docked, `VIEW_STATE`",
+    "flavour instead."
+  ];
+}
+function readmeFile(w) {
+  return [
+    `# ${w.name} weaver`,
+    "",
+    `A LoomWeaver weaver (a domain plugin bundle). It consumes only the public \`@loomweaver/plugin-sdk\` contract.`,
+    "",
+    "## Wire it into a distribution",
+    "",
+    `1. Add the plugin to \`providePlugins\` in \`src/app/app.config.ts\`. It is **variadic** and`,
+    `   returns an array, so spread it:`,
+    "",
+    "   ```ts",
+    `   import { ${w.propertyName}Plugin } from '${w.importPath}';   // Nx: the workspace alias; without one, a relative path to this library's src/index.ts`,
+    `   ...providePlugins(${w.propertyName}Plugin),`,
+    "   ```",
+    "",
+    `2. Grant its capabilities (default-deny) via \`provideCapabilityGrants\`:`,
+    "",
+    "   ```ts",
+    `   provideCapabilityGrants({ '${w.id}': [${capabilityItems(w.capabilities)}] });`,
+    "   ```",
+    "",
+    `3. Compose its translations with \`provideTranslationNamespaces('${w.id}')\` \u2014 and serve the`,
+    `   bundle by adding an assets glob to your application's build target, so the loader can fetch`,
+    `   \`/i18n/${w.id}/<lang>.json\` (the Nx generator adds this glob for you):`,
+    "",
+    "   ```json",
+    `   { "glob": "**/*.json", "input": "<path to this library>/src/lib/i18n", "output": "i18n/${w.id}" }`,
+    "   ```",
+    "",
+    `4. If your application compiles the shell's theme with Tailwind, name this library as a source`,
+    `   for it, so the utility classes in these templates are emitted. Tailwind also detects sources`,
+    `   by itself, but that depends on where it resolves the project root and on \`.gitignore\`, and`,
+    `   what the scaffold names covers the application alone (the Nx generator adds this line for`,
+    `   you). Applications scaffolded with \`--styles precompiled\` run no Tailwind and need nothing:`,
+    "",
+    "   ```css",
+    `   @source '<path from that stylesheet to this library>/src';`,
+    "   ```",
+    "",
+    ...surfaceNotes(w),
+    "",
+    "## After scaffolding",
+    "",
+    "- `src/lib/i18n/de.json` starts as a copy of the English strings \u2014 translate it.",
+    `- A scaffolded command defaults its shortcut to \`mod+shift+<first letter of the id>\` \u2014 two weavers whose ids share a first letter collide; pass \`--shortcut\` or edit the command.`,
+    "- The project is generated **untagged**: Nx tags belong to your `depConstraints`, and inventing",
+    "  one would fail a lint policy you never opted this project into. If your workspace enforces",
+    "  module boundaries, give it tags your constraints allow \u2014 `--tags` at generation time, or",
+    "  `tags` in `project.json` afterwards.",
+    ""
+  ].join("\n");
+}
+var angularWeaver = {
+  id: "angular-weaver",
+  build(input) {
+    const w = resolveWeaverInput(input);
+    const files = {
+      "src/index.ts": indexFile(w),
+      [`src/lib/plugin/${w.id}.plugin.ts`]: pluginFile(w),
+      "src/lib/i18n/en.json": i18nFile(w),
+      "src/lib/i18n/de.json": i18nFile(w),
+      "README.md": readmeFile(w)
+    };
+    if (w.features.container) {
+      files[`src/lib/views/${w.id}-canvas-view.ts`] = childViewFile(
+        w,
+        "canvas",
+        `${w.className}CanvasView`
+      );
+      files[`src/lib/views/${w.id}-canvas-view.html`] = childViewTemplateFile(
+        w,
+        "Canvas"
+      );
+      files[`src/lib/views/${w.id}-details-view.ts`] = childViewFile(
+        w,
+        "details",
+        `${w.className}DetailsView`
+      );
+      files[`src/lib/views/${w.id}-details-view.html`] = childViewTemplateFile(
+        w,
+        "Details"
+      );
+    } else {
+      files[`src/lib/views/${w.id}-view.ts`] = viewFile(w);
+      files[`src/lib/views/${w.id}-view.html`] = viewTemplateFile(w);
+    }
+    if (w.features.about) {
+      files[`src/lib/dialogs/${w.id}-about-dialog.ts`] = aboutDialogFile(w);
+      files[`src/lib/dialogs/${w.id}-about-dialog.html`] = aboutDialogTemplateFile(w);
+    }
+    if (w.features.spec) {
+      files[`src/lib/plugin/${w.id}.plugin.spec.ts`] = specFile(w);
+    }
+    return files;
+  }
+};
+
+// ../devkit/src/recipes/frame-plugin/recipe.ts
+function resolveFramePluginInput(input) {
+  if (!isKebabId(input.id)) {
+    throw new Error(`Sandbox plugin id must be kebab-case (e.g. "notes"); got "${input.id}".`);
+  }
+  return { id: input.id, name: input.name?.trim() || toTitleCase(input.id) };
+}
+function pluginHtml(p) {
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${p.name} \u2014 frame plugin (logic)</title>
+  </head>
+  <body>
+    <script src="/frame-kit/penpal.global.js"></script>
+    <script src="./plugin.js"></script>
+  </body>
+</html>
+`;
+}
+function pluginJs(p) {
+  return `(function () {
+  const Penpal = globalThis.Penpal;
+  const messenger = new Penpal.WindowMessenger({
+    remoteWindow: globalThis.parent,
+    allowedOrigins: ['*'],
+  });
+  const connection = Penpal.connect({ messenger });
+
+  connection.promise
+    .then(function (ctx) {
+      return Promise.all([
+        ctx.toast({ message: '${p.name} ready', kind: 'success', timeoutMs: 4000 }),
+        ctx.registerSurface({
+          id: '${p.id}.view',
+          title: '${p.name}',
+          iframe: '/${p.id}/view.html',
+          routable: { path: '${p.id}', titleIsLiteral: true },
+        }),
+      ]);
+    })
+    .catch(function (error) {
+      console.error('[${p.id}] frame plugin failed', error);
+    });
+})();
+`;
+}
+function viewHtml(p) {
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${p.name}</title>
+    <link rel="stylesheet" href="/frame-kit/lw-frame.css" />
+    <style>
+      body {
+        margin: 0;
+        font-family: var(--lw-font-sans, system-ui, sans-serif);
+        color: var(--lw-content, #1f2937);
+        background: var(--lw-surface, transparent);
+      }
+      .wrap { max-width: 42rem; margin: 0 auto; padding: 1.5rem; }
+      h1 { font-size: 1.125rem; font-weight: 600; }
+      p { color: var(--lw-content-faint, #6b7280); }
+    </style>
+  </head>
+  <body>
+    <div class="wrap">
+      <h1>${p.name}</h1>
+      <p>
+        Your sandboxed surface. It runs isolated in its own iframe, so its body can be built with
+        any framework (React, Vue, Svelte, vanilla). The frame UI kit (served by the distribution
+        under <code>/frame-kit/</code>) defines the <code>lw-*</code> element family and
+        the <code>.lw-*</code> class contracts; the host pushes its resolved design tokens over RPC.
+      </p>
+      <p><lw-button variant="primary" size="sm">Kit button</lw-button></p>
+    </div>
+    <script src="/frame-kit/penpal.global.js"></script>
+    <script src="/frame-kit/lw-elements.global.js"></script>
+    <script>
+      globalThis.Penpal.connect({
+        messenger: new globalThis.Penpal.WindowMessenger({
+          remoteWindow: globalThis.parent,
+          allowedOrigins: ['*'],
+        }),
+        methods: {
+          render: function (state) {
+            globalThis.LwFrame.applySurfaceState(state);
+          },
+        },
+      });
+    </script>
+  </body>
+</html>
+`;
+}
+function readme(p) {
+  return [
+    `# ${p.name} \u2014 frame plugin`,
+    "",
+    `A framework-agnostic LoomWeaver plugin: it runs in an isolated \`<iframe sandbox>\` and`,
+    `receives \`ctx\` over Penpal RPC through the same default-deny broker a trusted plugin uses.`,
+    "",
+    "## Serve it + wire it into a distribution",
+    "",
+    `1. Put these files under the distribution's static dir, e.g. \`public/${p.id}/\`. The plugin`,
+    `   references the **frame UI kit** (\`@loomweaver/frame-kit\`) at \`/frame-kit/\` \u2014`,
+    `   the distribution serves it via an assets glob (generated distributions already do):`,
+    "",
+    "   ```jsonc",
+    '   { "input": "node_modules/@loomweaver/frame-kit/dist", "glob": "**", "output": "frame-kit" }',
+    "   ```",
+    "",
+    `2. Register + grant it in the composition root:`,
+    "",
+    "   ```ts",
+    `   provideFramePlugins({ id: '${p.id}', entryUrl: '/${p.id}/plugin.html', capabilities: ['contributions', 'ui'] });`,
+    `   provideCapabilityGrants({ '${p.id}': ['contributions', 'ui'] });`,
+    "   ```",
+    "",
+    `The surface is routable at \`/${p.id}\`. Replace \`view.html\` with your own UI in any framework.`,
+    ""
+  ].join("\n");
+}
+var framePlugin = {
+  id: "frame-plugin",
+  build(input) {
+    const p = resolveFramePluginInput(input);
+    return {
+      "plugin.html": pluginHtml(p),
+      "plugin.js": pluginJs(p),
+      "view.html": viewHtml(p),
+      "README.md": readme(p)
+    };
+  }
+};
+
+// ../devkit/src/recipes/shell-regions.ts
+var SHELL_REGIONS = [
+  "{ id: 'top-bar', type: 'bar', dock: 'top' }",
+  "{ id: 'primary', type: 'rail', dock: 'left' }",
+  "{ id: 'left-panel', type: 'panel', dock: 'left' }",
+  "{ id: 'right-panel', type: 'panel', dock: 'right' }",
+  "{ id: 'main', type: 'content', dock: 'center' }",
+  "{ id: 'status-bar', type: 'bar', dock: 'bottom' }"
+];
+function renderRegions(indent) {
+  return SHELL_REGIONS.map((region) => `${indent}${region},`).join("\n");
+}
+
+// ../devkit/src/recipes/angular-distribution/logo.ts
+var PLACEHOLDER_LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="512" height="512" viewBox="87.5 -53 1129.9 1129.9"><g paint-order="stroke"><path d="m0 0 12.6-10.6-9.2-8-14.5 12.1q-.7.8 1.2 1.5A17 17 0 0 1-2.4-.5Q-1 .7 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 265.2 368.8)"/><path d="m0 0 19-16c.6-.5.5-1.6-.2-2.3q-2.8-3-7.5-4.5c-1.2-.4-2.8-.1-3.4.4l-17 14.3z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 593.2 644.5)"/><path d="m0 0 5.8-4.9-9.2-8-2.8 2.3q-.9 1 0 2.5l4 7.4Q-1 .7 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#c59a2f;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 386.3 170)"/><path d="m0 0 12.4-10.4-9.2-8.1L-9.2-8.1Z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#c59a2f;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 608.2 356.6)"/><path d="m0 0 5-4.2c.6-.5.6-1.6 0-2.5l-4-7.4q-1-1.4-2.1-.7l-8 6.7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#c59a2f;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 933.4 630)"/><path d="m0 0 14.6-12.3-9.2-8L-11-6.6c-.6.5-.6 1.6.2 2.4Q-8-1.2-3.3.3C-2.2.7-.6.5 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 589.5 28.9)"/><path d="m0 0 17-14.3q.8-.8-1.3-1.4a17 17 0 0 1-7.5-4.5c-.7-.8-1.8-1-2.4-.5l-15 12.6Z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 948.5 330.8)"/><path d="m0 0 8.4-7-13.6-12-8.4 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 514.5 213.2)"/><path d="m0 0 5.7-4.8q1.3-1 .4-2L3-9.5l-8.4 7 3 2.7A2 2 0 0 0 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 743 48)"/><path d="m0 0 8.4-7-2.2-2q-1-.7-2.3.2L-2-4q-1 1.2-.2 2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 158.6 526.5)"/><path d="m0 0 8.4-7L-5-18.9c-.5-.5-1.6-.4-2.3.2l-5.8 4.8q-1 1-.3 2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 492.8 507)"/><path d="m0 0 5.7-4.8q1.3-1 .4-2l-14.7-13-8.4 7.1L-2.3.3C-1.8.6-.7.5 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 902.6 182)"/><path d="m0 0 5.9-5Q7-6 6.2-7l-3-2.7-8.7 7.2L-2.4.3Q-1.4.9 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 1065.8 319.3)"/><path d="m0 0 8.6-7.2-13.6-12-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 836.9 484.2)"/><path d="m0 0 8.6-7.2-2.2-2q-1-.6-2.4.3l-5.9 5Q-3-3-2.2-2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 481 797.5)"/><g transform="matrix(15.6303 0 0 -15.6303 877.6 706.6)"><linearGradient id="a" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 64.4 103.4)scale(2.18666 -2.18666)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#c59a2f;stop-opacity:1"/><stop offset="100%" style="stop-color:#614d06;stop-opacity:1"/></linearGradient><path d="m176.7 129.6 2-1.7 9.2 8-2 1.8z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#a);fill-rule:nonzero;opacity:1" transform="translate(-182.3 -132.8)"/></g><g transform="matrix(15.6303 0 0 -15.6303 711.4 567.2)"><linearGradient id="b" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 56.7 106)scale(-2.18726 2.18726)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#c59a2f;stop-opacity:1"/><stop offset="100%" style="stop-color:#614d06;stop-opacity:1"/></linearGradient><path d="m166 138.5 2.1-1.7 9.2 8.1-2 1.7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#b);fill-rule:nonzero;opacity:1" transform="translate(-171.7 -141.7)"/></g><g transform="matrix(15.6303 0 0 -15.6303 532.5 867.7)"><linearGradient id="c" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -65.1 251)scale(2.11643 -2.11643)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m155 125.2 8.5-7.2 2 1.8-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#c);fill-rule:nonzero;opacity:1" transform="translate(-160.2 -122.5)"/></g><g transform="matrix(15.6303 0 0 -15.6303 707.2 713.6)"><linearGradient id="d" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(-134.3 114 30.2)scale(2.11524 -2.11524)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m166.1 135 8.6-7.1 2 1.7-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#d);fill-rule:nonzero;opacity:1" transform="translate(-171.4 -132.3)"/></g><g transform="matrix(15.6303 0 0 -15.6303 888.2 554.5)"><linearGradient id="e" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -77.5 288)scale(2.11554 -2.11554)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m177.7 145.3 8.6-7.3 2 1.8-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#e);fill-rule:nonzero;opacity:1" transform="translate(-183 -142.5)"/></g><g transform="matrix(15.6303 0 0 -15.6303 1062 401.2)"><linearGradient id="f" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -84.1 307.3)scale(-2.11583 2.11583)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m188.8 155 8.6-7.2 2 1.8-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#f);fill-rule:nonzero;opacity:1" transform="translate(-194.1 -152.3)"/></g><g transform="matrix(15.6303 0 0 -15.6303 206.5 595.5)"><linearGradient id="g" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(225.7 98.9 40.5)scale(-2.0962 2.0962)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m134.3 142.5 8.2-7 2 1.8-8.3 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#g);fill-rule:nonzero;opacity:1" transform="translate(-139.4 -139.9)"/></g><g transform="matrix(15.6303 0 0 -15.6303 381 441.4)"><linearGradient id="h" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(-134.3 107 43.3)scale(2.0962 -2.0962)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m145.4 152.3 8.3-6.9 2 1.8-8.3 6.9z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#h);fill-rule:nonzero;opacity:1" transform="translate(-150.5 -149.8)"/></g><g transform="matrix(15.6303 0 0 -15.6303 562 282.3)"><linearGradient id="i" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(225.7 114.5 45.7)scale(-2.0953 2.0953)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m157 162.5 8.2-7 2 1.8-8.2 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#i);fill-rule:nonzero;opacity:1" transform="translate(-162.1 -160)"/></g><g transform="matrix(15.6303 0 0 -15.6303 736 129)"><linearGradient id="j" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -115.1 291)scale(-2.0956 2.0956)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m168.1 172.3 8.3-6.9 2 1.7-8.3 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#j);fill-rule:nonzero;opacity:1" transform="translate(-173.2 -169.7)"/></g><g transform="matrix(15.6303 0 0 -15.6303 544.8 441.3)"><linearGradient id="k" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 50.4 108)scale(2.18666 -2.18666)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#c59a2f;stop-opacity:1"/><stop offset="100%" style="stop-color:#614d06;stop-opacity:1"/></linearGradient><path d="m155.9 147 2-1.6 9.2 8-2 1.8z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#k);fill-rule:nonzero;opacity:1" transform="translate(-161.5 -150.3)"/></g><g transform="matrix(15.6303 0 0 -15.6303 390.7 294.8)"><linearGradient id="l" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 42.9 110.5)scale(-2.17357 2.17357)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#c59a2f;stop-opacity:1"/><stop offset="100%" style="stop-color:#614d06;stop-opacity:1"/></linearGradient><path d="m145.6 156 2-1.7 9 8-2 1.6z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#l);fill-rule:nonzero;opacity:1" transform="translate(-151.2 -159.1)"/></g><g transform="matrix(15.6303 0 0 -15.6303 375.9 585.7)"><linearGradient id="m" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 46.2 101)scale(-1.9968 1.9968)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m144.7 137.2 1.8-1.5 9.2 8.1-1.8 1.5z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#m);fill-rule:nonzero;opacity:1" transform="translate(-150.2 -140.5)"/></g><g transform="matrix(15.6303 0 0 -15.6303 733.7 274)"><linearGradient id="n" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(-44.3 284 -131.7)scale(1.9968 -1.9968)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m167.6 157.2 1.8-1.5 9.2 8-1.8 1.6z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#n);fill-rule:nonzero;opacity:1" transform="translate(-173.1 -160.5)"/></g><g transform="matrix(15.6303 0 0 -15.6303 893.6 408.2)"><linearGradient id="o" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 61 113.2)scale(1.9962 -1.9962)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m177.8 148.6 1.8-1.5 9.2 8-1.8 1.6z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#o);fill-rule:nonzero;opacity:1" transform="translate(-183.3 -151.9)"/></g><g transform="matrix(15.6303 0 0 -15.6303 535.9 720)"><linearGradient id="p" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 53.6 98.6)scale(1.9962 -1.9962)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m155 128.6 1.7-1.5 9.2 8.1-1.8 1.5z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#p);fill-rule:nonzero;opacity:1" transform="translate(-160.4 -132)"/></g><g transform="matrix(15.6303 0 0 -15.6303 717.3 421.6)"><linearGradient id="q" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -93.5 280)scale(-2.095 2.095)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m167 153.6 8.2-7 2 1.8-8.3 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#q);fill-rule:nonzero;opacity:1" transform="translate(-172 -151)"/></g><g transform="matrix(15.6303 0 0 -15.6303 542.1 575.9)"><linearGradient id="r" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -87 261)scale(2.0956 -2.0956)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m155.7 143.8 8.3-7 2 1.8-8.3 6.9z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#r);fill-rule:nonzero;opacity:1" transform="translate(-160.8 -141.2)"/></g></g></svg>
+`;
+
+// ../devkit/src/recipes/angular-distribution/recipe.ts
+var STYLES = ["tailwind", "precompiled"];
+function resolveDistributionInput(input) {
+  if (!isKebabId(input.name)) {
+    throw new Error(
+      `Distribution name must be kebab-case (e.g. "acme-studio"); got "${input.name}".`
+    );
+  }
+  const styles = input.styles ?? "tailwind";
+  if (!STYLES.includes(styles)) {
+    throw new Error(
+      `Unknown styles option "${styles}"; expected one of ${STYLES.join(", ")}.`
+    );
+  }
+  const directory = input.directory === void 0 ? `apps/${input.name}` : input.directory.trim();
+  const depth = directory.split("/").filter(Boolean).length;
+  return {
+    name: input.name,
+    title: input.title?.trim() || toTitleCase(input.name),
+    nodeModulesFromSrc: `${"../".repeat(depth + 1)}node_modules`,
+    withTests: input.withTests !== false,
+    styles
+  };
+}
+function mainTs() {
+  return `import { bootstrapApplication } from '@angular/platform-browser';
+import { appConfig } from './app/app.config';
+import { App } from './app/app';
+
+bootstrapApplication(App, appConfig).catch((err) => console.error(err));
+`;
+}
+function appConfigTs(d) {
+  return `import { ApplicationConfig } from '@angular/core';
+import {
+  provideLayout,
+  provideShell,
+  provideShellRouter,
+  type ShellLayout,
+} from '@loomweaver/shell';
+import { provideProductIdentity } from '@loomweaver/plugin-sdk';
+
+/* Which regions exist and where they dock. Contributions target these ids, so a region a
+   weaver names but this layout omits renders nothing \u2014 silently. 'primary' (rail) and
+   'status-bar' (bar) are what the scaffolded weaver targets. */
+export const layout: ShellLayout = {
+  regions: [
+${renderRegions("    ")}
+  ],
+};
+
+/* Everything this product is made of goes in this array: your weavers, their capability
+   grants and your branding. The shell arrives with every capability on; switch gestures
+   off with provideShellFeatures and drop contributions with provideShell({ omit }).
+   See LOOMWEAVER.md. */
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideShellRouter(),
+    provideShell(),
+    provideLayout(layout),
+    provideProductIdentity({
+      name: '${d.title}',
+      tagline: 'Built on LoomWeaver',
+      logoUrl: 'logo.svg',
+    }),
+  ],
+};
+`;
+}
+function appTs() {
+  return `import { Component } from '@angular/core';
+import { Shell } from '@loomweaver/shell';
+
+@Component({
+  selector: 'app-root',
+  imports: [Shell],
+  templateUrl: './app.html',
+})
+export class App {}
+`;
+}
+function appHtml() {
+  return `<lw-shell />
+`;
+}
+function appConfigSpec() {
+  return `import { layout } from './app.config';
+
+/* A green starting point that pins the one trap the compiler cannot catch: a contribution aimed at
+   a region id this layout omits renders nothing, and says nothing. List the ids your weavers target
+   here, and this fails the day someone edits the layout instead of failing in the browser. */
+describe('layout', () => {
+  it('declares the regions contributions target', () => {
+    const ids = layout.regions.map((region) => region.id);
+    for (const id of ['primary', 'status-bar', 'main']) {
+      expect(ids).toContain(id);
+    }
+  });
+});
+`;
+}
+function indexHtml(d) {
+  return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${d.title}</title>
+    <base href="/" />
+    <meta
+      http-equiv="Content-Security-Policy"
+      content="default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; font-src 'self' data:; connect-src 'self'; frame-src 'self'; object-src 'none'; base-uri 'self'"
+    />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="theme-color" content="#2E96C9" />
+    <link rel="icon" type="image/svg+xml" href="logo.svg" />
+    <link rel="manifest" href="manifest.webmanifest" />
+  </head>
+  <body>
+    <app-root></app-root>
+  </body>
+</html>
+`;
+}
+function precompiledCss() {
+  return `/* The stylesheet we compiled: the design tokens, the .lw-* class contracts and every utility
+   the shell's own templates use. This application needs no Tailwind to build.
+
+   BRINGING YOUR OWN CSS FRAMEWORK? Import it INTO A CASCADE LAYER. Every rule we ship is layered,
+   and unlayered CSS outranks layered CSS whatever its specificity \u2014 so an unlayered Bootstrap
+   Reboot (button { border-radius: 0 }) strips the chrome's radii and borders without a fight.
+   A @layer statement is one of the few things allowed before @import:
+
+     @layer vendor;
+     @import 'bootstrap/dist/css/bootstrap.css' layer(vendor);
+
+   Then re-theme by pointing the --lw-* tokens at your framework's variables. For Bootstrap 5.3 the
+   whole 29-token mapping is a scaffold:
+
+     loomweaver theme --name acme --preset bootstrap
+     @import './themes/acme.css';   (after the import below) */
+
+@import '@loomweaver/shell/styles/shell.css';
+`;
+}
+function tailwindCss(d) {
+  return `@import 'tailwindcss';
+
+/* LoomWeaver design tokens + theme (light/dark, brand colors). Every @import has to precede the
+   other at-rules below: that is what plain CSS requires, and it is what keeps editors from
+   flagging a misplaced @import in a file you did not write. */
+@import '@loomweaver/shell/styles/theme.css';
+
+@plugin '@tailwindcss/typography';
+
+/* Generate the utility classes the shell (and your own components) use. The @source path must
+   reach your workspace's node_modules FROM THIS FILE \u2014 adjust the ../ hops if this project does
+   not sit at that depth, or Tailwind silently emits none of the shell's classes. */
+@source '${d.nodeModulesFromSrc}/@loomweaver/shell';
+@source './';
+`;
+}
+function stylesCss(d) {
+  return d.styles === "precompiled" ? precompiledCss() : tailwindCss(d);
+}
+function ngswConfig() {
+  return JSON.stringify(
+    {
+      $schema: "./node_modules/@angular/service-worker/config/schema.json",
+      index: "/index.html",
+      assetGroups: [
+        {
+          name: "app",
+          installMode: "prefetch",
+          resources: {
+            files: ["/index.html", "/manifest.webmanifest", "/*.css", "/*.js"]
+          }
+        },
+        {
+          name: "i18n",
+          installMode: "prefetch",
+          updateMode: "prefetch",
+          resources: {
+            files: ["/i18n/**/*.json"]
+          }
+        },
+        {
+          name: "assets",
+          installMode: "lazy",
+          updateMode: "prefetch",
+          resources: {
+            files: [
+              "/**/*.(svg|cur|jpg|jpeg|png|apng|webp|avif|gif|otf|ttf|woff|woff2|ico)"
+            ]
+          }
+        }
+      ]
+    },
+    null,
+    2
+  );
+}
+function manifest(d) {
+  return JSON.stringify(
+    {
+      name: d.title,
+      short_name: d.title,
+      description: `${d.title} \u2014 a LoomWeaver distribution.`,
+      start_url: "/",
+      display: "standalone",
+      background_color: "#ffffff",
+      theme_color: "#2E96C9",
+      icons: [{ src: "logo.svg", type: "image/svg+xml", sizes: "any" }]
+    },
+    null,
+    2
+  );
+}
+function stylesNotes(d) {
+  if (d.styles === "precompiled") {
+    return [
+      "`src/styles.css` imports the stylesheet **we** compiled \u2014 tokens, the `.lw-*` class contracts",
+      "and every utility the shell's own templates use, 67 KB minified and 11 KB over the wire. There",
+      "is nothing to install and nothing to configure: no `tailwindcss`, no `.postcssrc.json`, no",
+      "`@source` paths to miscount.",
+      "",
+      "What you give up is writing Tailwind utilities in *your own* templates. The `--lw-*` tokens stay",
+      "available to any CSS you write, so re-theming stays a token remap rather than a fight.",
+      "",
+      "If you bring a CSS framework of your own, **import it into a cascade layer** \u2014 the file says how,",
+      "and it is the one decision that determines whether the chrome survives the introduction. Prefer",
+      "Tailwind after all? Re-run the scaffold with `--styles tailwind`."
+    ];
+  }
+  return [
+    "`src/styles.css` compiles the shell's source theme with Tailwind 4, which is also what lets you",
+    "write Tailwind utilities in your own templates. It needs two things the scaffold cannot add for",
+    "you \u2014 the packages:",
+    "",
+    "```sh",
+    "npm install -D tailwindcss @tailwindcss/postcss @tailwindcss/typography",
+    "```",
+    "",
+    "and the PostCSS plugin, in a file next to your `package.json`:",
+    "",
+    "```jsonc",
+    "// .postcssrc.json",
+    '{ "plugins": { "@tailwindcss/postcss": {} } }',
+    "```",
+    "",
+    "Use **semantic tokens only** in your own templates (`bg-surface`, `text-content`, `text-brand`,",
+    "`border-border`), never raw palette colours.",
+    "",
+    "**Count the `../` hops in the `@source` line.** It is resolved from the stylesheet, not from the",
+    "workspace root, and the scaffold derived it from where this project sits. Move the project and",
+    "nothing errors \u2014 Tailwind simply emits none of the shell's classes and the app renders unstyled.",
+    "",
+    "Want none of this? Re-run the scaffold with `--styles precompiled` and you get a one-line",
+    "stylesheet that needs no Tailwind at all \u2014 the right choice if your product is themed with",
+    "Bootstrap, Bulma or hand-written CSS."
+  ];
+}
+function readme2(d) {
+  return [
+    `# ${d.title} \u2014 a LoomWeaver distribution`,
+    "",
+    `The composition root that assembles the platform into a shippable product. It renders the bare`,
+    `shell out of the box; add your weavers and branding below. Your own README is untouched \u2014 the`,
+    `scaffold writes its notes here so it can never overwrite prose you wrote.`,
+    "",
+    "## Run it",
+    "",
+    "In an Nx workspace (the generator wired the project):",
+    "",
+    "```sh",
+    `nx serve ${d.name}`,
+    "```",
+    "",
+    "Scaffolded over the CLI or MCP, these files are sources without build wiring \u2014 drop them into",
+    "an application you already serve (`ng new`, or an Nx application). They keep Angular's own",
+    "shape: `main.ts` bootstraps `App`, `App` renders `<lw-shell />`, and everything this product is",
+    "made of lives in `app.config.ts`. Nothing of the generated app is deleted. Over an existing",
+    "application `--force` replaces exactly the files above \u2014 all of them bootstrap wiring, none of",
+    "them content you authored. Under Nx it additionally merges the build targets into that",
+    "project's `project.json`, keeping the targets, `implicitDependencies` and tags it already had.",
+    "",
+    "Two leftovers from `ng new` are no longer referenced and can go: `src/app/app.routes.ts` (the",
+    "shell owns content routing via `provideShellRouter()`) and `src/app/app.css`. The generated",
+    "`src/app/app.spec.ts` now fails \u2014 `App` pulls the whole shell into a bare `TestBed` \u2014 so delete",
+    "it and test your own components instead of the composition root.",
+    "",
+    "The project is generated **untagged**: Nx tags belong to your `depConstraints`, and inventing",
+    "one would fail a lint policy you never opted this project into. If your workspace enforces",
+    "module boundaries, give it tags your constraints allow \u2014 `--tags` at generation time, or",
+    "`tags` in `project.json` afterwards.",
+    "",
+    "## Compose weavers + branding (in `src/app/app.config.ts`)",
+    "",
+    "The layout is already there. Adding a weaver is three providers plus its import \u2014 note the",
+    "**spread**, since `providePlugins` is variadic and returns an array:",
+    "",
+    "```ts",
+    "import { providePlugins, provideCapabilityGrants, provideTranslationNamespaces } from '@loomweaver/shell';",
+    "import { notesPlugin } from '@acme/notes-weaver';   // Nx: the workspace alias; otherwise a relative path",
+    "",
+    "    provideTranslationNamespaces('notes'),",
+    "    provideCapabilityGrants({ notes: ['contributions', 'ui', 'navigation'] }),",
+    "    ...providePlugins(notesPlugin),",
+    "```",
+    "",
+    "Grant exactly what the weaver's manifest declares \u2014 the broker is default-deny, so an ungranted",
+    "plugin throws `CapabilityError` instead of quietly doing less. A weaver also needs its",
+    "translations served: add an assets glob for its `src/lib/i18n` under `i18n/<id>` (the Nx",
+    "generator does this for you).",
+    "",
+    "`public/logo.svg` is the LoomWeaver mark, dropped in as a placeholder so the top bar renders",
+    "something from the first run instead of a broken image. Replace it with your own \u2014 any square",
+    "image will do; `logoUrl` resolves against your served root. `tagline` is a",
+    "translation key that falls back to rendering itself, so the literal above works but makes",
+    "Transloco log a missing-translation warning in dev; point it at a key of your own to silence it.",
+    "",
+    "That same file is also the **app icon**: the browser tab reads it, and the manifest names it so",
+    "the app has an icon at all. One gap is left on purpose, because a scaffold writes text and",
+    "cannot invent your artwork: **Chromium only offers installation once the manifest names a 192",
+    "and a 512 raster icon**, and iOS ignores manifest icons entirely in favour of",
+    "`apple-touch-icon`. Drop `icon-192.png` and `icon-512.png` next to the logo, add them to the",
+    "manifest's `icons` and add an `apple-touch-icon` link to `index.html`, and the app becomes",
+    "installable. Until then it runs and caches offline, it simply is not offered for installation.",
+    "",
+    "## Styles",
+    "",
+    ...stylesNotes(d),
+    "",
+    "## Build wiring",
+    "",
+    "The Nx generator put all of this in `project.json`. Scaffolded over the CLI or MCP, add it to",
+    "your build target yourself \u2014 `angular.json` under `projects.<name>.architect.build.options` with",
+    "the Angular CLI, `project.json` under `targets.build.options` in Nx. Paths inside `assets` are",
+    "resolved from the workspace root, so they read the same either way:",
+    "",
+    "```jsonc",
+    '"styles": ["src/styles.css"],',
+    '"assets": [',
+    '  { "glob": "**/*", "input": "public" },',
+    '  { "glob": "**/*", "input": "node_modules/@loomweaver/shell/i18n", "output": "i18n" },',
+    '  { "glob": "**/*", "input": "node_modules/@loomweaver/frame-kit/dist", "output": "frame-kit" }',
+    "],",
+    '"serviceWorker": "ngsw-config.json"',
+    "```",
+    "",
+    "And in the **production** configuration of that same target:",
+    "",
+    "```jsonc",
+    '"optimization": { "styles": { "inlineCritical": false } }',
+    "```",
+    "",
+    "Each of those earns its place. The **`@loomweaver/shell/i18n` glob** is the one whose absence is easy",
+    "to misread: the shell fetches its own UI strings at runtime, so without it every label in the",
+    "chrome renders as its raw translation key and nothing errors. The **frame-kit** glob only",
+    "matters if you host sandboxed (iframe) plugins \u2014 install that package then; until you do, the",
+    "glob simply matches nothing. **`serviceWorker`** emits the worker that `provideShell()` already",
+    "registers for you (inert in dev) \u2014 never add `provideServiceWorker` yourself, and if you would",
+    "rather ship no worker at all, drop `ngsw-config.json` and pass",
+    "`provideShell({ serviceWorker: false })`, because otherwise the registration 404s in production.",
+    "**`inlineCritical: false`** is not optional here: the `index.html` above ships a strict",
+    "`script-src 'self'`, and Angular's critical-CSS pass loads the stylesheet with an **inline**",
+    "`onload` handler that the policy blocks \u2014 the app then renders completely unstyled, and only in",
+    "production builds.",
+    "",
+    "## Ship less than the whole workbench",
+    "",
+    "The shell arrives with every capability on: splitting, dragging tabs between panes, pinning,",
+    "stacking views, pop-out windows, keyboard shortcuts, the curation checklists. A product whose",
+    "users would be overwhelmed by that switches parts off in the same providers array:",
+    "",
+    "```ts",
+    "import { provideShellFeatures } from '@loomweaver/shell';",
+    "",
+    "    provideShellFeatures({",
+    "      content: { splitRight: false, splitDown: false, moveTabs: false },",
+    "      sidebar: { stackViews: false },",
+    "      windows: { popout: false },",
+    "    }),",
+    "```",
+    "",
+    "A switch takes the **affordance and the gesture**: turning `splitRight` off removes the toolbar",
+    "button, the drop edges *and* `mod+\\`, so the capability cannot come back through a second door.",
+    "Fields merge group by group, so name only what you turn off. The groups are `content`,",
+    "`sidebar`, `rail`, `workspaces`, `windows` and `commands`; everything is on by default except",
+    "`content.escalate`, the unlabelled double-click cycle on a tab.",
+    "",
+    "That provider is for **gestures**. A command, a bar or rail item, a settings row or a menu entry",
+    "is a *contribution* and goes instead \u2014 by id \u2014 into `provideShell({ omit: [...] })`. Where a",
+    "capability is both, the feature switch wins and takes the menu entry with it.",
+    "",
+    "A product backend is optional: implement the settings-store / auth-source ports",
+    "(`provideSettingsStore` / `provideAuthSource`, both against the `KeyValueStore` shape)",
+    "with your own backend, or keep the local/anonymous defaults for a standalone UI.",
+    "Working state stays on `WORKING_STATE_STORE` and never reaches your",
+    "settings backend; back it separately with `provideWorkingStateStore` only if",
+    "working state should travel across devices.",
+    ""
+  ].join("\n");
+}
+var angularDistribution = {
+  id: "angular-distribution",
+  build(input) {
+    const d = resolveDistributionInput(input);
+    return {
+      "src/main.ts": mainTs(),
+      "src/app/app.config.ts": appConfigTs(d),
+      ...d.withTests ? { "src/app/app.config.spec.ts": appConfigSpec() } : {},
+      "src/app/app.ts": appTs(),
+      "src/app/app.html": appHtml(),
+      "src/index.html": indexHtml(d),
+      "src/styles.css": stylesCss(d),
+      "public/logo.svg": PLACEHOLDER_LOGO_SVG,
+      "public/manifest.webmanifest": manifest(d) + "\n",
+      "ngsw-config.json": ngswConfig() + "\n",
+      "LOOMWEAVER.md": readme2(d)
+    };
+  }
+};
+
+// ../devkit/src/recipes/auth-source/recipe.ts
+function resolveAuthSourceInput(input) {
+  if (!isKebabId(input.name)) {
+    throw new Error(`Auth source name must be kebab-case (e.g. "dev"); got "${input.name}".`);
+  }
+  return {
+    name: input.name,
+    className: toPascalCase(input.name),
+    propertyName: toCamelCase(input.name)
+  };
+}
+function moduleFile(a) {
+  return `// Provider-neutral AuthSource. LoomWeaver owns no authentication \u2014 it only reacts to
+// a session snapshot. Wire it with: provideAuthSource(() => ${a.propertyName}AuthSource()).
+// Replace the dev switcher below by mapping your product's real session onto an AuthSnapshot.
+import { signal, Signal } from '@angular/core';
+import { ANONYMOUS, AuthSnapshot } from '@loomweaver/plugin-sdk';
+
+const USER: AuthSnapshot = {
+  authenticated: true,
+  roles: ['user'],
+  claims: {},
+  displayName: 'Signed-in user',
+};
+
+const ADMIN: AuthSnapshot = {
+  authenticated: true,
+  roles: ['user', 'admin'],
+  claims: {},
+  displayName: 'Administrator',
+};
+
+const state = signal<AuthSnapshot>(ANONYMOUS);
+
+export function ${a.propertyName}AuthSource(): Signal<AuthSnapshot> {
+  return state.asReadonly();
+}
+
+export function cycle${a.className}User(): void {
+  const current = state();
+  const next = !current.authenticated
+    ? USER
+    : current.roles.includes('admin')
+      ? ANONYMOUS
+      : ADMIN;
+  state.set(next);
+}
+`;
+}
+var authSource = {
+  id: "auth-source",
+  build(input) {
+    const a = resolveAuthSourceInput(input);
+    return { [`${a.name}-auth-source.ts`]: moduleFile(a) };
+  }
+};
+
+// ../devkit/src/recipes/settings-store/recipe.ts
+function resolveSettingsStoreInput(input) {
+  if (!isKebabId(input.name)) {
+    throw new Error(
+      `Settings store name must be kebab-case (e.g. "backend"); got "${input.name}".`
+    );
+  }
+  return { name: input.name, className: toPascalCase(input.name) };
+}
+function moduleFile2(s) {
+  return `// A backend-backed settings store for the SETTINGS_STORE port. The platform
+// ships local defaults; the product persists settings against its own backend. Only genuine
+// settings flow through this port \u2014 working state stays on WORKING_STATE_STORE. Wire it with:
+// provideSettingsStore(new ${s.className}SettingsStore()).
+import { KeyValueStore } from '@loomweaver/shell';
+
+export class ${s.className}SettingsStore implements KeyValueStore {
+  constructor(private readonly baseUrl = '/api/settings') {}
+
+  async get(key: string): Promise<string | undefined> {
+    const response = await fetch(this.url(key));
+    if (!response.ok) {
+      return undefined;
+    }
+    return response.text();
+  }
+
+  async set(key: string, value: string): Promise<void> {
+    await fetch(this.url(key), { method: 'PUT', body: value });
+  }
+
+  async delete(key: string): Promise<void> {
+    await fetch(this.url(key), { method: 'DELETE' });
+  }
+
+  private url(key: string): string {
+    return \`\${this.baseUrl}/\${encodeURIComponent(key)}\`;
+  }
+}
+`;
+}
+var settingsStore = {
+  id: "settings-store",
+  build(input) {
+    const s = resolveSettingsStoreInput(input);
+    return { [`${s.name}-settings-store.ts`]: moduleFile2(s) };
+  }
+};
+
+// ../devkit/src/recipes/theme/recipe.ts
+var PRESETS = ["literal", "bootstrap"];
+function resolveThemeInput(input) {
+  if (!isKebabId(input.name)) {
+    throw new Error(`Theme name must be kebab-case (e.g. "midnight"); got "${input.name}".`);
+  }
+  const preset = input.preset ?? "literal";
+  if (!PRESETS.includes(preset)) {
+    throw new Error(`Unknown theme preset "${preset}"; expected one of ${PRESETS.join(", ")}.`);
+  }
+  return { name: input.name, title: toTitleCase(input.name), preset };
+}
+function cssFile(t) {
+  return `/* ${t.title} theme \u2014 overrides LoomWeaver's --lw-* design tokens.
+   Import it AFTER the shell theme in your distribution styles.css:
+     @import '@loomweaver/shell/styles/theme.css';
+     @import './themes/${t.name}.css';
+   Declared in @layer lw-tenant-theme so it beats any plugin's ctx.contributeTheme
+   (Product default < Plugin < Tenant). The --lw-* ladder flips in :root.dark, so override both. */
+
+@layer lw-tenant-theme {
+  :root {
+    --lw-brand: #2e96c9;
+    --lw-brand-strong: #237aa6;
+    --lw-brand-fill: #2e96c9;
+    --lw-brand-text: #1f6f97;
+    --lw-accent: #c59a2f;
+    --lw-surface: #ffffff;
+    --lw-surface-raised: #f7f8fa;
+    --lw-content: #1f2937;
+    --lw-content-muted: #4b5563;
+    --lw-content-faint: #6b7280;
+    --lw-border: #e5e7eb;
+  }
+
+  :root.dark {
+    --lw-brand: #3aa9dd;
+    --lw-brand-strong: #2e96c9;
+    --lw-brand-fill: #2e96c9;
+    --lw-brand-text: #7cc4e6;
+    --lw-accent: #d8b45a;
+    --lw-surface: #0f141a;
+    --lw-surface-raised: #171d25;
+    --lw-content: #e5e7eb;
+    --lw-content-muted: #9ca3af;
+    --lw-content-faint: #6b7280;
+    --lw-border: #2a323c;
+  }
+}
+`;
+}
+function bootstrapFile(t) {
+  return `/* ${t.title} theme \u2014 maps LoomWeaver's --lw-* design tokens onto Bootstrap 5.3's --bs-*.
+   Import it AFTER the shell theme in your distribution styles.css, and import Bootstrap itself
+   INTO A LAYER \u2014 unlayered CSS outranks layered CSS whatever its specificity, so Bootstrap's
+   Reboot (button { border-radius: 0 }) would otherwise beat our .lw-* component classes:
+     @layer vendor;
+     @import 'bootstrap/dist/css/bootstrap.css' layer(vendor);
+     @import '@loomweaver/shell/styles/shell.css';   (or styles/theme.css if you run Tailwind)
+     @import './themes/${t.name}.css';
+   Declared in @layer lw-tenant-theme so it beats any plugin's ctx.contributeTheme
+   (Product default < Plugin < Tenant).
+
+   THERE IS NO :root.dark BLOCK, on purpose. Bootstrap redefines its own --bs-* variables under
+   [data-bs-theme="dark"], so every var() below already resolves to the dark value \u2014 provided that
+   attribute is in step with the shell's mode. Mirror it once at startup, from somewhere with an
+   injection context \u2014 your root component, or provideEnvironmentInitializer in app.config.ts:
+
+     private readonly theme = inject(ThemeService);        // from '@loomweaver/shell'
+     private readonly html = inject(DOCUMENT).documentElement;
+     constructor() {
+       effect(() => this.html.setAttribute('data-bs-theme', this.theme.resolvedTheme()));
+     }
+
+   Use resolvedTheme, never mode: mode can be 'system', which Bootstrap does not understand.
+
+   WHERE THIS MAPPING IS DELIBERATELY NOT ONE TO ONE: LoomWeaver splits a brand colour into the
+   identity colour, the colour it is safe to *read* as text, and the colour it is safe to *fill*
+   behind white text, because each clears a different WCAG threshold. Bootstrap 5.3 draws the same
+   distinction with -text-emphasis, so that is what the text tokens point at. The on-* tokens are
+   literal because they must contrast with the fill, not follow it, and they match what Bootstrap
+   itself puts on .btn-primary, .btn-warning and .btn-info.
+
+   CONTRAST IS YOURS NOW. LoomWeaver's own palette is verified against WCAG 2.1 AA. These values are
+   your Bootstrap theme's, so the guarantee travels with them: if your --bs-primary does not clear
+   4.5:1 behind white text, neither will our buttons. */
+
+@layer lw-tenant-theme {
+  :root {
+    --lw-brand: var(--bs-primary);
+    --lw-brand-strong: var(--bs-primary-text-emphasis);
+    --lw-brand-text: var(--bs-primary-text-emphasis);
+    --lw-brand-fill: var(--bs-primary);
+    --lw-on-brand: #fff;
+    --lw-accent: var(--bs-secondary);
+    --lw-accent-strong: var(--bs-secondary-text-emphasis);
+
+    --lw-surface: var(--bs-body-bg);
+    --lw-surface-raised: var(--bs-body-bg);
+    --lw-surface-overlay: var(--bs-tertiary-bg);
+    --lw-field: var(--bs-body-bg);
+    --lw-border: var(--bs-border-color);
+
+    --lw-content: var(--bs-body-color);
+    --lw-content-muted: var(--bs-secondary-color);
+    --lw-content-faint: var(--bs-secondary-color);
+
+    --lw-tooltip: var(--bs-emphasis-color);
+    --lw-tooltip-content: var(--bs-body-bg);
+
+    --lw-positive: var(--bs-success);
+    --lw-on-positive: #fff;
+    --lw-negative: var(--bs-danger);
+    --lw-negative-fill: var(--bs-danger);
+    --lw-on-negative: #fff;
+    --lw-caution: var(--bs-warning);
+    --lw-on-caution: #000;
+    --lw-info: var(--bs-info);
+    --lw-on-info: #000;
+
+    --lw-scrim: rgb(0 0 0 / 0.5);
+
+    --lw-font-sans: var(--bs-body-font-family);
+    --lw-font-mono: var(--bs-font-monospace);
+  }
+}
+`;
+}
+var theme = {
+  id: "theme",
+  build(input) {
+    const t = resolveThemeInput(input);
+    const content = t.preset === "bootstrap" ? bootstrapFile(t) : cssFile(t);
+    return { [`${t.name}.css`]: content };
+  }
+};
+
+// ../devkit/src/recipes/layout/recipe.ts
+function resolveLayoutInput(input) {
+  const name = input.name?.trim() || "base";
+  if (!isKebabId(name)) {
+    throw new Error(`Layout name must be kebab-case (e.g. "base"); got "${name}".`);
+  }
+  return { name, propertyName: toCamelCase(name) };
+}
+function moduleFile3(l) {
+  return `// A base layout for the distribution. Pass it to provideLayout(${l.propertyName}Layout)
+// in src/app/app.config.ts. Region ids are what contributions target \u2014 'primary' (rail) and 'status-bar' (bar) match
+// the devkit weaver defaults, so a scaffolded weaver's rail + bar items land here.
+import { ShellLayout } from '@loomweaver/shell';
+
+export const ${l.propertyName}Layout: ShellLayout = {
+  regions: [
+${renderRegions("    ")}
+  ],
+};
+`;
+}
+var layout = {
+  id: "layout",
+  build(input) {
+    const l = resolveLayoutInput(input);
+    return { [`${l.name}-layout.ts`]: moduleFile3(l) };
+  }
+};
+
+// ../devkit/src/lib/scaffolds/scaffolds.ts
+function str(values, name) {
+  const value = values[name];
+  return typeof value === "string" ? value : void 0;
+}
+function bool(values, name) {
+  const value = values[name];
+  return typeof value === "boolean" ? value : void 0;
+}
+function kebabCase(name) {
+  return name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+var ID_PATTERN = "^[a-z][a-z0-9]*(-[a-z0-9]+)*$";
+var PLACEMENT_OPTIONS = [
+  {
+    name: "directory",
+    type: "string",
+    description: "Project root, relative to the workspace root.",
+    workspaceOnly: true
+  },
+  {
+    name: "tags",
+    type: "string",
+    description: "Comma-separated Nx tags for the project.",
+    workspaceOnly: true
+  },
+  {
+    name: "prefix",
+    type: "string",
+    description: "Selector prefix for generated components and directives.",
+    default: "lw",
+    pattern: ID_PATTERN,
+    workspaceOnly: true
+  },
+  {
+    name: "unitTestRunner",
+    type: "string",
+    description: "Test wiring to emit. 'vitest' uses @nx/angular:unit-test; 'none' emits no test target.",
+    choices: ["vitest", "none"],
+    default: "vitest",
+    workspaceOnly: true
+  }
+];
+var APP_OPTION = {
+  name: "app",
+  type: "string",
+  description: "Application to drop into. Inferred when the workspace has exactly one.",
+  workspaceOnly: true
+};
+var SCAFFOLDS = [
+  {
+    name: "weaver",
+    summary: "an Angular in-process plugin: manifest, surface, rail item, i18n, test",
+    options: [
+      {
+        name: "id",
+        type: "string",
+        description: "Plugin id in kebab-case, e.g. 'notes'.",
+        required: true,
+        pattern: ID_PATTERN
+      },
+      {
+        name: "name",
+        type: "string",
+        description: "Human-readable name. Defaults to a title-cased id."
+      },
+      {
+        name: "command",
+        type: "boolean",
+        description: "Also scaffold a registered command the weaver can trigger.",
+        default: false
+      },
+      {
+        name: "shortcut",
+        type: "string",
+        description: "Keyboard chord for the command, e.g. 'mod+shift+k'. Implies --command."
+      },
+      {
+        name: "menu",
+        type: "string",
+        description: "Hook a menu item into a slot, e.g. 'content/tab/context'. Implies --command."
+      },
+      {
+        name: "barItem",
+        type: "boolean",
+        description: "Also add a status-bar button that triggers the command. Implies --command.",
+        default: false
+      },
+      {
+        name: "settings",
+        type: "boolean",
+        description: "Also scaffold a settings section with signal-backed value owners.",
+        default: false
+      },
+      {
+        name: "about",
+        type: "boolean",
+        description: "Also scaffold an About dialog that reads ctx.host, plus a bottom rail item.",
+        default: false
+      },
+      {
+        name: "instanceable",
+        type: "boolean",
+        description: "Dock the surface and give it named saved instances, each with its own view state. Not combinable with --container: named instances exist only for a docked, non-routable surface.",
+        default: false
+      },
+      {
+        name: "container",
+        type: "boolean",
+        description: "Make the surface a container: a routable tab at '<id>/:id' holding a nested pane tree of child surfaces, which the host draws. Not combinable with --instanceable.",
+        default: false
+      },
+      {
+        name: "access",
+        type: "string",
+        description: "Auth-gate the surface and rail item: 'authenticated', 'anonymous' or 'role:<name>'."
+      },
+      {
+        name: "spec",
+        type: "boolean",
+        description: "Generate a starter unit test. Use --no-spec to skip it.",
+        default: true
+      },
+      {
+        name: "projectName",
+        type: "string",
+        description: "Nx project name. Defaults to '<id>-weaver'.",
+        workspaceOnly: true
+      },
+      {
+        name: "importPath",
+        type: "string",
+        description: "Import path for the workspace alias. Defaults to the workspace scope plus the project name.",
+        workspaceOnly: true
+      },
+      APP_OPTION,
+      ...PLACEMENT_OPTIONS
+    ],
+    build: (values) => generate(angularWeaver, {
+      id: str(values, "id") ?? "",
+      name: str(values, "name"),
+      prefix: str(values, "prefix"),
+      importPath: str(values, "importPath"),
+      features: {
+        command: bool(values, "command"),
+        shortcut: str(values, "shortcut"),
+        menu: str(values, "menu"),
+        barItem: bool(values, "barItem"),
+        settings: bool(values, "settings"),
+        about: bool(values, "about"),
+        instanceable: bool(values, "instanceable"),
+        container: bool(values, "container"),
+        access: str(values, "access"),
+        spec: bool(values, "spec")
+      }
+    })
+  },
+  {
+    name: "frame-plugin",
+    summary: "a framework-agnostic iframe plugin (Penpal + the frame UI kit)",
+    options: [
+      {
+        name: "id",
+        type: "string",
+        description: "Plugin id in kebab-case, e.g. 'notes'.",
+        required: true,
+        pattern: ID_PATTERN
+      },
+      {
+        name: "name",
+        type: "string",
+        description: "Human-readable name. Defaults to a title-cased id."
+      },
+      APP_OPTION
+    ],
+    build: (values) => generate(framePlugin, {
+      id: str(values, "id") ?? "",
+      name: str(values, "name")
+    })
+  },
+  {
+    name: "distribution",
+    summary: "a runnable composition root that boots the shell",
+    options: [
+      {
+        name: "name",
+        type: "string",
+        description: "Distribution name in kebab-case, e.g. 'acme-studio'.",
+        required: true,
+        pattern: ID_PATTERN
+      },
+      {
+        name: "title",
+        type: "string",
+        description: "Product display title. Defaults to a title-cased name."
+      },
+      {
+        name: "styles",
+        type: "string",
+        description: "Which stylesheet to emit. 'tailwind' compiles the shell's source theme and lets you write Tailwind utilities of your own; 'precompiled' imports the stylesheet we compiled, so the application needs no Tailwind and can be themed with Bootstrap or anything else.",
+        choices: ["tailwind", "precompiled"],
+        default: "tailwind"
+      },
+      {
+        name: "force",
+        type: "boolean",
+        description: "Compose into the application already at that path, replacing the bootstrap files this scaffold owns and merging its build targets. Without it an existing project is an error.",
+        workspaceOnly: true
+      },
+      ...PLACEMENT_OPTIONS
+    ],
+    build: (values) => generate(angularDistribution, {
+      name: str(values, "name") ?? "",
+      title: str(values, "title"),
+      directory: str(values, "directory"),
+      styles: str(values, "styles") ?? "tailwind"
+    })
+  },
+  {
+    name: "auth-source",
+    summary: "a provider-neutral AuthSource that feeds the session",
+    options: [
+      {
+        name: "name",
+        type: "string",
+        description: "Source name in kebab-case, e.g. 'dev'.",
+        required: true,
+        pattern: ID_PATTERN
+      },
+      APP_OPTION
+    ],
+    build: (values) => generate(authSource, { name: str(values, "name") ?? "" })
+  },
+  {
+    name: "settings-store",
+    summary: "a settings-store implementation backed by your API",
+    options: [
+      {
+        name: "name",
+        type: "string",
+        description: "Store name in kebab-case, e.g. 'backend'.",
+        required: true,
+        pattern: ID_PATTERN
+      },
+      APP_OPTION
+    ],
+    build: (values) => generate(settingsStore, { name: str(values, "name") ?? "" })
+  },
+  {
+    name: "theme",
+    summary: "a token-override stylesheet in @layer lw-tenant-theme",
+    options: [
+      {
+        name: "name",
+        type: "string",
+        description: "Theme name in kebab-case, e.g. 'midnight'.",
+        required: true,
+        pattern: ID_PATTERN
+      },
+      {
+        name: "preset",
+        type: "string",
+        description: "Where the token values come from. 'literal' writes editable colours; 'bootstrap' maps them onto Bootstrap 5.3's --bs-* variables, which makes the shell follow your Bootstrap theme live.",
+        choices: ["literal", "bootstrap"],
+        default: "literal"
+      },
+      APP_OPTION
+    ],
+    build: (values) => generate(theme, {
+      name: str(values, "name") ?? "",
+      preset: str(values, "preset") ?? "literal"
+    })
+  },
+  {
+    name: "layout",
+    summary: "a ShellLayout with the regions a weaver expects",
+    options: [
+      {
+        name: "name",
+        type: "string",
+        description: "Layout name. Defaults to a base layout."
+      },
+      APP_OPTION
+    ],
+    build: (values) => generate(layout, { name: str(values, "name") })
+  }
+];
+function findScaffold(name) {
+  return SCAFFOLDS.find((scaffold2) => scaffold2.name === name);
+}
+function portableOptions(scaffold2) {
+  return scaffold2.options.filter((option) => !option.workspaceOnly);
+}
+function usageFor(scaffold2) {
+  const parts = portableOptions(scaffold2).map((option) => {
+    const flag = `--${kebabCase(option.name)}`;
+    const body = option.type === "boolean" ? flag : `${flag} <${option.name}>`;
+    return option.required ? body : `[${body}]`;
+  });
+  return [scaffold2.name, ...parts].join(" ");
+}
+
+// ../devkit/src/lib/validate/i18n.ts
+function flattenKeys(bundle, prefix = "") {
+  return Object.entries(bundle).flatMap(([key, value]) => {
+    const path = prefix ? `${prefix}.${key}` : key;
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      return flattenKeys(value, path);
+    }
+    return [path];
+  });
+}
+function validateI18nParity(bundles) {
+  const languages = Object.keys(bundles);
+  if (languages.length < 2) {
+    return [];
+  }
+  const keysByLanguage = new Map(languages.map((lang) => [lang, new Set(flattenKeys(bundles[lang]))]));
+  const allKeys = /* @__PURE__ */ new Set();
+  for (const keys of keysByLanguage.values()) {
+    for (const key of keys) {
+      allKeys.add(key);
+    }
+  }
+  const findings = [];
+  for (const lang of languages) {
+    const keys = keysByLanguage.get(lang);
+    for (const key of allKeys) {
+      if (!keys?.has(key)) {
+        findings.push({
+          level: "warning",
+          code: "i18n.missingKey",
+          message: `Language "${lang}" is missing translation key "${key}".`,
+          path: `i18n/${lang}`
+        });
+      }
+    }
+  }
+  return findings;
+}
+
+// ../devkit/src/lib/validate/catalog.ts
+var CATALOG_ENTRY_KEYS = [
+  "id",
+  "name",
+  "entryUrl",
+  "capabilities",
+  "version",
+  "iconUrl",
+  "description",
+  "icon",
+  "category",
+  "author",
+  "downloads",
+  "updated",
+  "repository",
+  "readmeUrl"
+];
+var SAME_ORIGIN_FIELDS = ["entryUrl", "iconUrl", "readmeUrl"];
+function at(index, field) {
+  return field ? `catalog[${index}].${field}` : `catalog[${index}]`;
+}
+function isPlainObject(raw) {
+  return typeof raw === "object" && raw !== null && !Array.isArray(raw);
+}
+function urlFinding(value, index, field, required) {
+  if (typeof value !== "string" || value.length === 0) {
+    return required ? {
+      level: "error",
+      code: "catalog.entryUrl",
+      message: `${at(index, field)} must be a non-empty string; the host drops the whole entry without it.`,
+      path: at(index, field)
+    } : {
+      level: "warning",
+      code: "catalog.url.empty",
+      message: `${at(index, field)} is present but not a non-empty string, so the host ignores it.`,
+      path: at(index, field)
+    };
+  }
+  const scheme = /^([a-z][a-z0-9+.-]*):/i.exec(value)?.[1]?.toLowerCase();
+  if (scheme && scheme !== "http" && scheme !== "https") {
+    return {
+      level: "error",
+      code: "catalog.url.scheme",
+      message: `${at(index, field)} uses the "${scheme}:" scheme. The host accepts same-origin http(s) URLs only${required ? " and drops the entry" : " and ignores the field"}.`,
+      path: at(index, field)
+    };
+  }
+  if (scheme) {
+    return {
+      level: "warning",
+      code: "catalog.url.absolute",
+      message: `${at(index, field)} is absolute. The host requires same-origin, so this holds only while it matches the origin the app is served from; a root-relative path is same-origin by construction.`,
+      path: at(index, field)
+    };
+  }
+  return void 0;
+}
+function validateCapabilities2(value, index, known) {
+  if (value === void 0) {
+    return [
+      {
+        level: "warning",
+        code: "catalog.capabilities.missing",
+        message: `${at(index)} declares no capabilities. Accepting the install dialog grants exactly what is declared, so the plugin will be denied everything at runtime.`,
+        path: at(index, "capabilities")
+      }
+    ];
+  }
+  if (!Array.isArray(value)) {
+    return [
+      {
+        level: "error",
+        code: "catalog.capabilities",
+        message: `${at(index, "capabilities")} must be an array; the host ignores any other shape and grants nothing.`,
+        path: at(index, "capabilities")
+      }
+    ];
+  }
+  const findings = [];
+  for (const capability of value) {
+    if (typeof capability !== "string" || !known.includes(capability)) {
+      findings.push({
+        level: "error",
+        code: "catalog.capability.unknown",
+        message: `${at(index, "capabilities")} contains ${JSON.stringify(capability)}, which the host filters out silently \u2014 the plugin then throws CapabilityError at runtime. Known: ${known.join(", ")}.`,
+        path: at(index, "capabilities")
+      });
+    }
+  }
+  return findings;
+}
+function validateEntry(raw, index, known) {
+  if (!isPlainObject(raw)) {
+    return [
+      {
+        level: "error",
+        code: "catalog.entry",
+        message: `${at(index)} is not an object, so the host drops it.`,
+        path: at(index)
+      }
+    ];
+  }
+  const findings = [];
+  if (typeof raw["id"] !== "string" || raw["id"].length === 0) {
+    findings.push({
+      level: "error",
+      code: "catalog.id",
+      message: `${at(index, "id")} must be a non-empty string; the host drops the whole entry without it.`,
+      path: at(index, "id")
+    });
+  }
+  for (const field of SAME_ORIGIN_FIELDS) {
+    if (field !== "entryUrl" && raw[field] === void 0) {
+      continue;
+    }
+    const finding = urlFinding(raw[field], index, field, field === "entryUrl");
+    if (finding) {
+      findings.push(finding);
+    }
+  }
+  if (raw["name"] === void 0) {
+    findings.push({
+      level: "warning",
+      code: "catalog.name.missing",
+      message: `${at(index)} has no name, so the store falls back to showing the id.`,
+      path: at(index, "name")
+    });
+  } else if (typeof raw["name"] !== "string" || raw["name"].length === 0) {
+    findings.push({
+      level: "warning",
+      code: "catalog.name",
+      message: `${at(index, "name")} is not a non-empty string, so the store falls back to showing the id.`,
+      path: at(index, "name")
+    });
+  }
+  if (raw["version"] === void 0) {
+    findings.push({
+      level: "warning",
+      code: "catalog.version.missing",
+      message: `${at(index)} carries no version. Update detection compares catalog versions, so the store can never offer an update and republishing the plugin will not respawn it for anyone who already installed it.`,
+      path: at(index, "version")
+    });
+  }
+  findings.push(...validateCapabilities2(raw["capabilities"], index, known));
+  if (raw["downloads"] !== void 0 && (typeof raw["downloads"] !== "number" || raw["downloads"] < 0)) {
+    findings.push({
+      level: "warning",
+      code: "catalog.downloads",
+      message: `${at(index, "downloads")} must be a non-negative number, so the host ignores it.`,
+      path: at(index, "downloads")
+    });
+  }
+  if (raw["updated"] !== void 0 && !isRenderableDate(raw["updated"])) {
+    findings.push({
+      level: "warning",
+      code: "catalog.updated",
+      message: `${at(index, "updated")} is not a date the store can parse, so it renders the raw string instead of "2 days ago".`,
+      path: at(index, "updated")
+    });
+  }
+  if (raw["repository"] !== void 0 && !isHttpUrl(raw["repository"])) {
+    findings.push({
+      level: "warning",
+      code: "catalog.repository",
+      message: `${at(index, "repository")} must be an http(s) URL, so the host drops it and the detail pane shows no link.`,
+      path: at(index, "repository")
+    });
+  }
+  for (const key of Object.keys(raw)) {
+    if (!CATALOG_ENTRY_KEYS.includes(key)) {
+      findings.push({
+        level: "warning",
+        code: "catalog.unknown-key",
+        message: `${at(index, key)} is not one of the fields the host reads (${CATALOG_ENTRY_KEYS.join(", ")}), so it is ignored without a word \u2014 which is exactly what a misspelled field looks like.`,
+        path: at(index, key)
+      });
+    }
+  }
+  return findings;
+}
+function isHttpUrl(raw) {
+  if (typeof raw !== "string") {
+    return false;
+  }
+  try {
+    const url = new URL(raw);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function isRenderableDate(raw) {
+  return typeof raw === "string" && !Number.isNaN(new Date(raw).getTime());
+}
+function validateCatalog(catalog, known = KNOWN_CAPABILITIES) {
+  if (!Array.isArray(catalog)) {
+    return [
+      {
+        level: "error",
+        code: "catalog.shape",
+        message: "A plugin catalog must be a JSON array of entries; the host loads nothing otherwise.",
+        path: "catalog"
+      }
+    ];
+  }
+  const findings = [];
+  const seen = /* @__PURE__ */ new Set();
+  catalog.forEach((entry, index) => {
+    findings.push(...validateEntry(entry, index, known));
+    const id = isPlainObject(entry) ? entry["id"] : void 0;
+    if (typeof id === "string" && id.length > 0) {
+      if (seen.has(id)) {
+        findings.push({
+          level: "warning",
+          code: "catalog.id.duplicate",
+          message: `${at(index, "id")} repeats "${id}". The host keeps the first entry with an id and drops the rest.`,
+          path: at(index, "id")
+        });
+      }
+      seen.add(id);
+    }
+  });
+  return findings;
+}
+
+// src/lib/run.ts
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+// src/lib/args.ts
+var ArgError = class extends Error {
+};
+function assign(flags, token, next) {
+  const body = token.slice(2);
+  const eq = body.indexOf("=");
+  if (eq !== -1) {
+    flags[body.slice(0, eq)] = body.slice(eq + 1);
+    return false;
+  }
+  if (body.startsWith("no-")) {
+    flags[body.slice(3)] = false;
+    return false;
+  }
+  if (next === void 0 || next.startsWith("-")) {
+    flags[body] = true;
+    return false;
+  }
+  flags[body] = next;
+  return true;
+}
+function parseArgs(argv) {
+  const flags = {};
+  let command = "";
+  for (let i = 0; i < argv.length; i++) {
+    const token = argv[i];
+    if (token === "-h" || token === "--help") {
+      flags["help"] = true;
+      continue;
+    }
+    if (token === "-v" || token === "--version") {
+      flags["version"] = true;
+      continue;
+    }
+    if (token.startsWith("--")) {
+      if (assign(flags, token, argv[i + 1])) {
+        i++;
+      }
+      continue;
+    }
+    if (token.startsWith("-")) {
+      throw new ArgError(`Unknown option "${token}".`);
+    }
+    if (command) {
+      throw new ArgError(`Unexpected argument "${token}" after "${command}".`);
+    }
+    command = token;
+  }
+  return { command, flags };
+}
+function rejectUnknownFlags(args, allowed) {
+  const known = /* @__PURE__ */ new Set(["help", "version", ...allowed]);
+  const unknown = Object.keys(args.flags).filter((name) => !known.has(name));
+  if (unknown.length > 0) {
+    throw new ArgError(
+      `Unknown option${unknown.length > 1 ? "s" : ""} ${unknown.map((name) => `"--${name}"`).join(", ")}. Run "loomweaver list" to see every option.`
+    );
+  }
+}
+function stringFlag(args, name) {
+  const value = args.flags[name];
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    throw new ArgError(`Option --${name} needs a value.`);
+  }
+  return value;
+}
+function requiredFlag(args, name) {
+  const value = stringFlag(args, name);
+  if (!value) {
+    throw new ArgError(`Option --${name} is required.`);
+  }
+  return value;
+}
+function boolFlag(args, name) {
+  const value = args.flags[name];
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "boolean") {
+    throw new ArgError(`Option --${name} does not take a value.`);
+  }
+  return value;
+}
+
+// src/lib/scaffold.ts
+import { relative, resolve } from "node:path";
+function findScaffold2(name) {
+  const scaffold2 = findScaffold(name);
+  if (!scaffold2) {
+    throw new ArgError(
+      `Unknown command "${name}". Run "loomweaver list" to see what is available.`
+    );
+  }
+  return scaffold2;
+}
+function allowedFlagsFor(scaffold2) {
+  return portableOptions(scaffold2).flatMap((option) => [
+    option.name,
+    kebabCase(option.name)
+  ]);
+}
+function readFlag(args, option) {
+  const kebab = kebabCase(option.name);
+  const value = args.flags[kebab] ?? args.flags[option.name];
+  if (value === void 0) {
+    return void 0;
+  }
+  if (option.type === "string" && typeof value !== "string") {
+    throw new ArgError(`Option --${kebab} needs a value.`);
+  }
+  if (option.type === "boolean" && typeof value !== "boolean") {
+    throw new ArgError(`Option --${kebab} does not take a value.`);
+  }
+  return value;
+}
+function valuesFor(scaffold2, args) {
+  const values = {};
+  for (const option of portableOptions(scaffold2)) {
+    const value = readFlag(args, option);
+    if (value === void 0) {
+      if (option.required) {
+        throw new ArgError(
+          `Option --${kebabCase(option.name)} is required.`
+        );
+      }
+      continue;
+    }
+    if (option.choices && !option.choices.includes(String(value))) {
+      throw new ArgError(
+        `Option --${kebabCase(option.name)} must be one of: ${option.choices.join(", ")}.`
+      );
+    }
+    values[option.name] = value;
+  }
+  return values;
+}
+function directoryFromOut(out) {
+  const below = relative(process.cwd(), resolve(out ?? "."));
+  return below.startsWith("..") ? "" : below;
+}
+function buildScaffold(scaffold2, args) {
+  const values = valuesFor(scaffold2, args);
+  const takesDirectory = scaffold2.options.some(
+    (option) => option.name === "directory"
+  );
+  const out = args.flags["out"];
+  return scaffold2.build(
+    takesDirectory ? {
+      ...values,
+      directory: directoryFromOut(
+        typeof out === "string" ? out : void 0
+      )
+    } : values
+  );
+}
+
+// src/lib/write.ts
+import {
+  lstatSync,
+  mkdirSync,
+  realpathSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import { dirname, isAbsolute, relative as relative2, resolve as resolve2 } from "node:path";
+var WriteError = class extends Error {
+};
+function planWrite(files, root) {
+  const absoluteRoot = resolve2(root);
+  const planned = [];
+  const conflicts = [];
+  for (const path of Object.keys(files).sort()) {
+    const absolute = resolve2(absoluteRoot, path);
+    const inside = relative2(absoluteRoot, absolute);
+    if (inside.startsWith("..") || isAbsolute(inside)) {
+      throw new WriteError(`Refusing to write outside the target directory: ${path}`);
+    }
+    planned.push({ path, absolute });
+    if (entryExists(absolute)) {
+      conflicts.push(path);
+    }
+  }
+  return { root: absoluteRoot, files: planned, conflicts };
+}
+function applyWrite(files, plan) {
+  for (const file of plan.files) {
+    mkdirSync(dirname(file.absolute), { recursive: true });
+    assertResolvesInsideRoot(plan.root, file.path, file.absolute);
+    replaceSymlinkEntry(file.absolute);
+    writeFileSync(file.absolute, files[file.path], "utf8");
+  }
+}
+function entryExists(absolute) {
+  try {
+    lstatSync(absolute);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function assertResolvesInsideRoot(root, path, absolute) {
+  const inside = relative2(realpathSync(root), realpathSync(dirname(absolute)));
+  if (inside.startsWith("..") || isAbsolute(inside)) {
+    throw new WriteError(
+      `Refusing to write through a link that leaves the target directory: ${path}`
+    );
+  }
+}
+function replaceSymlinkEntry(absolute) {
+  if (entryExists(absolute) && lstatSync(absolute).isSymbolicLink()) {
+    rmSync(absolute);
+  }
+}
+
+// src/lib/run.ts
+var VERSION = "0.7.2";
+function help() {
+  const commands = SCAFFOLDS.map((s) => `  ${s.name.padEnd(16)}${s.summary}`);
+  return [
+    "loomweaver \u2014 LoomWeaver scaffolding",
+    "",
+    "Usage: loomweaver <command> [options]",
+    "",
+    "Scaffolds:",
+    ...commands,
+    "",
+    "Other commands:",
+    "  list            print every scaffold with its options",
+    "  validate-manifest --id <id> [--name <name>] [--capabilities <a,b>]",
+    "  validate-i18n   --dir <dir>   check <lang>.json bundles for key parity",
+    "  validate-catalog --file <path> check a plugin store catalog the host parses defensively",
+    "",
+    "Options:",
+    "  --out <dir>     where to write (default: the current directory)",
+    "  --dry-run       list the files without writing them",
+    "  --force         overwrite files that already exist",
+    "  --strict        make validation warnings fail the exit code (for CI)",
+    "  -h, --help      this text",
+    "  -v, --version   the version, which matches the platform packages"
+  ].join("\n");
+}
+function list(args, io) {
+  rejectUnknownFlags(args, []);
+  for (const scaffold2 of SCAFFOLDS) {
+    io.out(`${scaffold2.name}`);
+    io.out(`  ${scaffold2.summary}`);
+    io.out(`  loomweaver ${usageFor(scaffold2)}`);
+    for (const option of portableOptions(scaffold2)) {
+      const flag = `--${kebabCase(option.name)}`;
+      io.out(`    ${flag.padEnd(18)}${option.description}`);
+    }
+    io.out("");
+  }
+  return 0;
+}
+function reportFindings(io, findings, strict) {
+  if (findings.length === 0) {
+    io.out("No findings.");
+    return 0;
+  }
+  findings.forEach((f) => io.err(`${f.level}: ${f.message}`));
+  if (findings.some((f) => f.level === "error")) {
+    return 1;
+  }
+  return strict ? 1 : 0;
+}
+function validateManifestCommand(args, io) {
+  rejectUnknownFlags(args, ["id", "name", "capabilities", "strict"]);
+  const capabilities = (stringFlag(args, "capabilities") ?? "").split(",").map((entry) => entry.trim()).filter(Boolean);
+  return reportFindings(
+    io,
+    validateManifest({
+      id: requiredFlag(args, "id"),
+      name: stringFlag(args, "name"),
+      capabilities
+    }),
+    boolFlag(args, "strict") === true
+  );
+}
+function readBundles(dir) {
+  const bundles = {};
+  for (const entry of readdirSync(dir)) {
+    if (!entry.endsWith(".json")) {
+      continue;
+    }
+    const language = entry.slice(0, -".json".length);
+    try {
+      bundles[language] = JSON.parse(readFileSync(join(dir, entry), "utf8"));
+    } catch (error) {
+      throw new ArgError(`${entry} is not valid JSON: ${error.message}`);
+    }
+  }
+  if (Object.keys(bundles).length === 0) {
+    throw new ArgError(`No <lang>.json bundles found in ${dir}.`);
+  }
+  return bundles;
+}
+function validateI18nCommand(args, io) {
+  rejectUnknownFlags(args, ["dir", "strict"]);
+  return reportFindings(
+    io,
+    validateI18nParity(readBundles(requiredFlag(args, "dir"))),
+    boolFlag(args, "strict") === true
+  );
+}
+function readCatalog(file) {
+  let raw;
+  try {
+    raw = readFileSync(file, "utf8");
+  } catch (error) {
+    throw new ArgError(`Cannot read ${file}: ${error.message}`);
+  }
+  try {
+    return JSON.parse(raw);
+  } catch (error) {
+    throw new ArgError(`${file} is not valid JSON: ${error.message}`);
+  }
+}
+function validateCatalogCommand(args, io) {
+  rejectUnknownFlags(args, ["file", "strict"]);
+  return reportFindings(
+    io,
+    validateCatalog(readCatalog(requiredFlag(args, "file"))),
+    boolFlag(args, "strict") === true
+  );
+}
+function scaffold(args, io) {
+  const descriptor = findScaffold2(args.command);
+  rejectUnknownFlags(args, [
+    ...allowedFlagsFor(descriptor),
+    "out",
+    "dry-run",
+    "force"
+  ]);
+  const files = buildScaffold(descriptor, args);
+  const plan = planWrite(files, stringFlag(args, "out") ?? ".");
+  const paths = plan.files.map((file) => file.path);
+  if (boolFlag(args, "dry-run")) {
+    io.out(`Would write ${paths.length} file(s) into ${plan.root}:`);
+    paths.forEach((path) => io.out(`  ${path}`));
+    if (plan.conflicts.length > 0) {
+      io.out(
+        `${plan.conflicts.length} of them already exist and would need --force:`
+      );
+      plan.conflicts.forEach((path) => io.out(`  ${path}`));
+    }
+    return 0;
+  }
+  if (plan.conflicts.length > 0 && !boolFlag(args, "force")) {
+    io.err(
+      `${plan.conflicts.length} file(s) already exist; pass --force to overwrite:`
+    );
+    plan.conflicts.forEach((path) => io.err(`  ${path}`));
+    return 1;
+  }
+  applyWrite(files, plan);
+  io.out(`Wrote ${paths.length} file(s) into ${plan.root}:`);
+  paths.forEach((path) => io.out(`  ${path}`));
+  return 0;
+}
+function run(argv, io) {
+  let args;
+  try {
+    args = parseArgs(argv);
+  } catch (error) {
+    io.err(error.message);
+    return 1;
+  }
+  if (args.flags["version"]) {
+    io.out(VERSION);
+    return 0;
+  }
+  if (args.flags["help"]) {
+    io.out(help());
+    return 0;
+  }
+  if (!args.command) {
+    io.out(help());
+    return 1;
+  }
+  try {
+    if (args.command === "list") {
+      return list(args, io);
+    }
+    if (args.command === "validate-manifest") {
+      return validateManifestCommand(args, io);
+    }
+    if (args.command === "validate-i18n") {
+      return validateI18nCommand(args, io);
+    }
+    if (args.command === "validate-catalog") {
+      return validateCatalogCommand(args, io);
+    }
+    return scaffold(args, io);
+  } catch (error) {
+    io.err(error.message);
+    return 1;
+  }
+}
+
+// src/main.ts
+process.exitCode = run(process.argv.slice(2), {
+  out: (line) => console.log(line),
+  err: (line) => console.error(line)
+});