@jskit-ai/ui-generator 0.1.47 → 0.1.49

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/ui-generator",
-  version: "0.1.47",
+  version: "0.1.49",
   kind: "generator",
   description: "Create non-CRUD pages, reusable UI elements, and subpage hosts.",
   options: {
@@ -40,22 +40,35 @@ export default Object.freeze({
       inputType: "text",
       defaultValue: "",
       promptLabel: "Placement target",
-      promptHint: "Optional target for placed-element placement (format: host:position, default: shell-layout:top-right)."
+      promptHint: "Semantic placement target for placed-element and outlet mapping (format: area.slot, default for placed-element: shell.status)."
     },
-    "link-placement": {
+    owner: {
       required: false,
       inputType: "text",
       defaultValue: "",
-      promptLabel: "Link placement",
-      promptHint: "Optional target for the generated page link placement (format: host:position)."
+      promptLabel: "Placement owner",
+      promptHint: "Optional owner id for semantic topology mappings. Page/settings placements default to the outlet host."
     },
-    "link-component-token": {
+    description: {
       required: false,
       inputType: "text",
       defaultValue: "",
-      promptLabel: "Link component token",
-      promptHint:
-        "Optional component token override for the generated page link placement (example: local.main.ui.tab-link-item)."
+      promptLabel: "Description",
+      promptHint: "Optional description for generated semantic topology mappings."
+    },
+    "link-renderer": {
+      required: false,
+      inputType: "text",
+      defaultValue: "local.main.ui.surface-aware-menu-link-item",
+      promptLabel: "Link renderer",
+      promptHint: "Default link renderer token for generated topology variants."
+    },
+    "link-placement": {
+      required: false,
+      inputType: "text",
+      defaultValue: "",
+      promptLabel: "Link placement",
+      promptHint: "Optional semantic target for the generated page link placement (format: area.slot)."
     },
     "link-to": {
       required: false,
@@ -120,9 +133,9 @@ export default Object.freeze({
             descriptionKey: "page-target-file"
           }
         ],
-        optionNames: ["name", "link-placement", "link-component-token", "link-to", "force"],
+        optionNames: ["name", "link-placement", "link-to", "force"],
         notes: [
-          "If a nearest parent subpages target is found, placement, link component token, and props.to are inferred automatically.",
+          "If a nearest parent subpages target is found, semantic placement and props.to are inferred automatically.",
           "If the parent target page is index.vue, child pages belong under index/...",
           "If the target page file already exists, rerun with --force to overwrite it."
         ],
@@ -151,10 +164,10 @@ export default Object.freeze({
         entrypoint: "src/server/subcommands/element.js",
         export: "runGeneratorSubcommand",
         description: "Create a Vue component file under the chosen component directory (default: src/components) and add a placement entry that renders it.",
-        optionNames: ["name", "surface", "path", "placement", "force"],
+        optionNames: ["name", "surface", "path", "placement", "owner", "force"],
         requiredOptionNames: ["name"],
         notes: [
-          "If --placement is omitted, the placed element is added at shell-layout:top-right.",
+          "If --placement is omitted, the placed element is added at shell.status.",
           "If the placement target belongs to a page-owned outlet, JSKIT infers the surface automatically.",
           "If the target is shared and the app has multiple enabled surfaces, pass --surface explicitly.",
           "If the component file already exists, rerun with --force to overwrite it."
@@ -174,7 +187,7 @@ export default Object.freeze({
               "  --name \"Ops Panel\" \\",
               "  --surface admin \\",
               "  --path src/widgets \\",
-              "  --placement shell-layout:top-right \\",
+              "  --placement shell.status \\",
               "  --force"
             ]
           }
@@ -226,9 +239,9 @@ export default Object.freeze({
         export: "runGeneratorSubcommand",
         description: "Inject a generic ShellOutlet block into an existing Vue page/component.",
         longDescription: [
-          "A ShellOutlet creates a named placement target inside a Vue file. That target is what other parts of JSKIT render into later.",
-          "After an outlet exists, `jskit list-placements` will discover it and show its `target`. That makes the outlet visible to humans and to generators that need a placement destination.",
-          "Commands that create placed UI, such as `ui-generator placed-element`, and commands that add page links can then target that outlet by writing placement entries that point at the same target."
+          "A ShellOutlet creates a concrete placement recipient inside a Vue file.",
+          "The command also appends the semantic topology mapping for that outlet, so `jskit list-placements` exposes the public `area.slot` placement instead of leaving the concrete recipient unused.",
+          "Generated topology includes compact, medium, and expanded variants. By default all three point at the inserted outlet; hand-edit `src/placementTopology.js` if the adaptive layout uses different concrete outlets."
         ],
         positionalArgs: [
           {
@@ -237,10 +250,11 @@ export default Object.freeze({
             descriptionKey: "existing-vue-sfc-target-file"
           }
         ],
-        optionNames: ["target"],
-        requiredOptionNames: ["target"],
+        optionNames: ["target", "placement", "owner", "surface", "description", "link-renderer"],
+        requiredOptionNames: ["target", "placement"],
         notes: [
-          "Use --target host:position."
+          "Use --target host:position for the concrete outlet and --placement area.slot for the public semantic placement.",
+          "The generated topology maps compact, medium, and expanded to the new concrete outlet."
         ],
         examples: [
           {
@@ -248,7 +262,8 @@ export default Object.freeze({
             lines: [
               "npx jskit generate ui-generator outlet \\",
               "  src/components/ContactSummaryCard.vue \\",
-              "  --target contact-view:sub-pages"
+              "  --target contact-view:sub-pages \\",
+              "  --placement page.section-nav"
             ]
           },
           {
@@ -256,7 +271,9 @@ export default Object.freeze({
             lines: [
               "npx jskit generate ui-generator outlet \\",
               "  src/pages/admin/customers/[customerId]/index.vue \\",
-              "  --target customer-view:summary-actions"
+              "  --target customer-view:summary-actions \\",
+              "  --placement page.actions \\",
+              "  --surface admin"
             ]
           }
         ]
@@ -278,7 +295,7 @@ export default Object.freeze({
   mutations: {
     dependencies: {
       runtime: {
-        "@jskit-ai/users-web": "0.1.79"
+        "@jskit-ai/users-web": "0.1.81"
       },
       dev: {}
     },

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@jskit-ai/ui-generator",
-  "version": "0.1.47",
+  "version": "0.1.49",
   "type": "module",
   "scripts": {
     "test": "node --test"
   },
   "dependencies": {
-    "@jskit-ai/kernel": "0.1.64",
-    "@jskit-ai/shell-web": "0.1.63"
+    "@jskit-ai/kernel": "0.1.66",
+    "@jskit-ai/shell-web": "0.1.65"
   },
   "exports": {
     "./server/buildTemplateContext": "./src/server/buildTemplateContext.js"

package/src/server/buildTemplateContext.js

@@ -12,6 +12,13 @@ function resolveLinkToPropLine(linkTo = "") {
   return `      to: ${JSON.stringify(linkTo)},\n`;
 }
 
+function resolveOwnerLine(owner = "") {
+  if (!owner) {
+    return "";
+  }
+  return `    owner: ${JSON.stringify(owner)},\n`;
+}
+
 async function buildUiPageTemplateContext({
   appRoot,
   targetFile = "",
@@ -28,13 +35,13 @@ async function buildUiPageTemplateContext({
     targetFile,
     context: "ui-generator page",
     placement: options?.["link-placement"],
-    componentToken: options?.["link-component-token"],
     linkTo: options?.["link-to"]
   });
 
   return {
     __JSKIT_UI_LINK_PLACEMENT_ID__: pageTarget.placementId,
     __JSKIT_UI_LINK_PLACEMENT_TARGET__: String(linkTarget.placementTarget?.id || ""),
+    __JSKIT_UI_LINK_OWNER_LINE__: resolveOwnerLine(linkTarget.placementTarget?.owner || ""),
     __JSKIT_UI_LINK_COMPONENT_TOKEN__: String(linkTarget.componentToken || ""),
     __JSKIT_UI_LINK_ICON__: DEFAULT_GENERATED_LINK_ICON,
     __JSKIT_UI_LINK_WORKSPACE_SUFFIX__: pageTarget.routeUrlSuffix,

package/src/server/subcommands/addSubpages.js

@@ -1,3 +1,4 @@
+import { readFile, writeFile } from "node:fs/promises";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
 import {
   DEFAULT_COMPONENT_DIRECTORY,
@@ -7,11 +8,60 @@ import {
   upgradePageFileToSubpages
 } from "./pageSupport.js";
 import {
+  PLACEMENT_TOPOLOGY_FILE,
+  appendBlockIfMarkerMissing,
   requireSinglePositionalTargetFile,
+  resolvePathWithinApp,
   resolveOutletTargetId,
   rejectUnexpectedOptions
 } from "./support.js";
 
+function resolveOutletOwner(target = "") {
+  const normalizedTarget = normalizeText(target);
+  const separatorIndex = normalizedTarget.indexOf(":");
+  if (separatorIndex <= 0) {
+    return "";
+  }
+  return normalizedTarget.slice(0, separatorIndex);
+}
+
+function renderSectionNavTopologyBlock({
+  marker = "",
+  owner = "",
+  surface = "",
+  target = ""
+} = {}) {
+  return (
+    `// ${marker}\n` +
+    "addPlacementTopology({\n" +
+    `  id: "page.section-nav",\n` +
+    `  owner: "${owner}",\n` +
+    `  description: "Navigation between child pages in this section.",\n` +
+    `  surfaces: ["${surface}"],\n` +
+    "  variants: {\n" +
+    "    compact: {\n" +
+    `      outlet: "${target}",\n` +
+    "      renderers: {\n" +
+    `        link: "local.main.ui.surface-aware-menu-link-item"\n` +
+    "      }\n" +
+    "    },\n" +
+    "    medium: {\n" +
+    `      outlet: "${target}",\n` +
+    "      renderers: {\n" +
+    `        link: "local.main.ui.surface-aware-menu-link-item"\n` +
+    "      }\n" +
+    "    },\n" +
+    "    expanded: {\n" +
+    `      outlet: "${target}",\n` +
+    "      renderers: {\n" +
+    `        link: "local.main.ui.surface-aware-menu-link-item"\n` +
+    "      }\n" +
+    "    }\n" +
+    "  }\n" +
+    "});\n"
+  );
+}
+
 function resolveSubpagesOutletTarget(options = {}, pageTarget = {}) {
   const rawTarget = normalizeText(options?.target);
   const defaultTarget = `${deriveDefaultSubpagesHost(pageTarget)}:${DEFAULT_SUBPAGES_POSITION}`;
@@ -60,10 +110,35 @@ async function runGeneratorSubcommand({
     dryRun
   });
 
+  const topologyPath = resolvePathWithinApp(appRoot, PLACEMENT_TOPOLOGY_FILE, {
+    context: "ui-generator add-subpages"
+  });
+  const owner = resolveOutletOwner(outletTarget.id);
+  const topologyMarker = `jskit:ui-generator.topology:page.section-nav:${owner}`;
+  const topologySource = await readFile(topologyPath.absolutePath, "utf8");
+  const topologyApplied = appendBlockIfMarkerMissing(
+    topologySource,
+    topologyMarker,
+    renderSectionNavTopologyBlock({
+      marker: topologyMarker,
+      owner,
+      surface: result.surfaceId,
+      target: outletTarget.id
+    })
+  );
+  const touchedFiles = new Set(result.touchedFiles);
+  if (topologyApplied.changed) {
+    if (dryRun !== true) {
+      await writeFile(topologyPath.absolutePath, topologyApplied.content, "utf8");
+    }
+    touchedFiles.add(topologyPath.relativePath);
+  }
+  const touchedFileList = [...touchedFiles].sort((left, right) => left.localeCompare(right));
+
   return {
-    touchedFiles: result.touchedFiles,
+    touchedFiles: touchedFileList,
     summary:
-      result.touchedFiles.length > 0
+      touchedFileList.length > 0
         ? `Enabled subpages in ${result.targetFile} for "${pageTarget.routeUrlSuffix}" using outlet target "${outletTarget.id}".`
         : `Subpages are already enabled in ${result.targetFile}.`
   };

package/src/server/subcommands/element.js

@@ -3,7 +3,7 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import {
   listSurfacePageRoots,
   resolveBestSurfaceMatchFromPageFile,
-  resolveShellOutletPlacementTargetFromApp,
+  resolveSemanticPlacementTargetFromApp,
   toPosixPath
 } from "@jskit-ai/kernel/server/support";
 import { normalizeSurfaceId } from "@jskit-ai/kernel/shared/surface";
@@ -22,7 +22,7 @@ import {
   insertBeforeClassDeclaration
 } from "./support.js";
 
-const DEFAULT_ELEMENT_PLACEMENT = "shell-layout:top-right";
+const DEFAULT_ELEMENT_PLACEMENT = "shell.status";
 
 function renderElementComponentSource(elementName = "") {
   return `<template>
@@ -41,14 +41,28 @@ async function resolvePlacedElementSurface({
   context = "ui-generator placed-element"
 } = {}) {
   const explicitSurface = normalizeSurfaceId(surface);
+  const placementSurfaces = Array.isArray(placementTarget?.surfaces)
+    ? placementTarget.surfaces.map((entry) => normalizeSurfaceId(entry)).filter(Boolean)
+    : [];
+  const isPlacementGlobal = placementSurfaces.length < 1 || placementSurfaces.includes("*");
+  const concreteSourcePath = normalizeText(placementTarget?.sourcePath).startsWith("src/")
+    ? normalizeText(placementTarget?.sourcePath)
+    : "";
   const inferredSurfaceMatch = await resolveBestSurfaceMatchFromPageFile(
-    String(placementTarget?.sourcePath || ""),
+    concreteSourcePath,
     await listSurfacePageRoots(appRoot, { context }),
     { context }
   );
-  const inferredSurface = normalizeSurfaceId(inferredSurfaceMatch?.surfaceId);
+  const inferredSurface =
+    normalizeSurfaceId(inferredSurfaceMatch?.surfaceId) ||
+    (placementSurfaces.length === 1 && !isPlacementGlobal ? placementSurfaces[0] : "");
 
   if (explicitSurface) {
+    if (!isPlacementGlobal && placementSurfaces.length > 0 && !placementSurfaces.includes(explicitSurface)) {
+      throw new Error(
+        `${context} target "${normalizeText(placementTarget?.id) || "<unknown>"}" is not available on surface "${explicitSurface}".`
+      );
+    }
     if (inferredSurface && explicitSurface !== inferredSurface) {
       throw new Error(
         `${context} target "${normalizeText(placementTarget?.id) || "<unknown>"}" belongs to surface "${inferredSurface}", ` +
@@ -89,7 +103,7 @@ async function runGeneratorSubcommand({
   if (Array.isArray(args) && args.length > 0) {
     throw new Error("ui-generator placed-element does not accept positional arguments.");
   }
-  rejectUnexpectedOptions(options, ["name", "surface", "path", "placement", "force"], {
+  rejectUnexpectedOptions(options, ["name", "surface", "path", "placement", "owner", "force"], {
     context: "ui-generator placed-element"
   });
 
@@ -115,10 +129,11 @@ async function runGeneratorSubcommand({
     context: "ui-generator placed-element"
   });
   const componentToken = `local.main.ui.element.${elementNameKebab}`;
-  const placementTarget = await resolveShellOutletPlacementTargetFromApp({
+  const placementTarget = await resolveSemanticPlacementTargetFromApp({
     appRoot,
     context: "ui-generator",
-    placement: options?.placement || DEFAULT_ELEMENT_PLACEMENT
+    placement: options?.placement || DEFAULT_ELEMENT_PLACEMENT,
+    owner: options?.owner
   });
   const surface = await resolvePlacedElementSurface({
     appRoot,
@@ -179,12 +194,15 @@ async function runGeneratorSubcommand({
 
   const placementSource = await readFile(placementPath.absolutePath, "utf8");
   const placementMarker = `jskit:ui-generator.element:${surface}:${elementNameKebab}`;
+  const ownerLine = placementTarget.owner ? `    owner: "${placementTarget.owner}",\n` : "";
   const placementBlock =
     `// ${placementMarker}\n` +
     "{\n" +
     "  addPlacement({\n" +
     `    id: "ui-generator.element.${elementNameKebab}",\n` +
     `    target: "${placementTarget.id}",\n` +
+    ownerLine +
+    `    kind: "component",\n` +
     `    surfaces: ["${surface}"],\n` +
     "    order: 155,\n" +
     `    componentToken: "${componentToken}"\n` +

package/src/server/subcommands/outlet.js

@@ -1,6 +1,13 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
 import {
+  normalizePlacementOwnerId,
+  normalizePlacementSurfaceId,
+  normalizeSemanticPlacementId
+} from "@jskit-ai/kernel/shared/support/shellLayoutTargets";
+import {
+  PLACEMENT_TOPOLOGY_FILE,
+  appendBlockIfMarkerMissing,
   requireSinglePositionalTargetFile,
   rejectUnexpectedOptions,
   resolveOutletTargetId,
@@ -75,6 +82,96 @@ function createOutletBlock({ target = "" } = {}) {
   return `<ShellOutlet target="${target}" />`;
 }
 
+function resolveOutletOwner(target = "") {
+  const normalizedTarget = normalizeText(target);
+  const separatorIndex = normalizedTarget.indexOf(":");
+  if (separatorIndex <= 0) {
+    return "";
+  }
+  return normalizedTarget.slice(0, separatorIndex);
+}
+
+function resolveSemanticPlacementOption(options = {}) {
+  const placementId = normalizeSemanticPlacementId(options?.placement);
+  if (!placementId) {
+    throw new Error('ui-generator outlet requires --placement in semantic "area.slot" format.');
+  }
+  return placementId;
+}
+
+function resolveSemanticPlacementOwner({ placementId = "", targetId = "", owner = "" } = {}) {
+  const explicitOwner = normalizePlacementOwnerId(owner);
+  if (explicitOwner) {
+    return explicitOwner;
+  }
+  if (placementId.startsWith("page.") || placementId.startsWith("settings.")) {
+    return resolveOutletOwner(targetId);
+  }
+  return "";
+}
+
+function resolveTopologySurfaces(options = {}) {
+  const surface = normalizePlacementSurfaceId(options?.surface);
+  if (surface) {
+    return [surface];
+  }
+  return ["*"];
+}
+
+function renderTopologyOwnerLine(owner = "") {
+  if (!owner) {
+    return "";
+  }
+  return `  owner: "${owner}",\n`;
+}
+
+function renderLinkRendererBlock(rendererToken = "") {
+  const normalizedRendererToken = normalizeText(rendererToken) || "local.main.ui.surface-aware-menu-link-item";
+  return (
+    "      renderers: {\n" +
+    `        link: "${normalizedRendererToken}"\n` +
+    "      }\n"
+  );
+}
+
+function renderOutletTopologyBlock({
+  marker = "",
+  placementId = "",
+  owner = "",
+  surfaces = ["*"],
+  description = "",
+  target = "",
+  rendererToken = ""
+} = {}) {
+  const descriptionLine = normalizeText(description)
+    ? `  description: ${JSON.stringify(normalizeText(description))},\n`
+    : "";
+  const rendererBlock = renderLinkRendererBlock(rendererToken);
+  return (
+    `// ${marker}\n` +
+    "addPlacementTopology({\n" +
+    `  id: "${placementId}",\n` +
+    renderTopologyOwnerLine(owner) +
+    descriptionLine +
+    `  surfaces: ${JSON.stringify(surfaces)},\n` +
+    "  variants: {\n" +
+    "    compact: {\n" +
+    `      outlet: "${target}",\n` +
+    rendererBlock +
+    "    },\n" +
+    "    medium: {\n" +
+    `      outlet: "${target}",\n` +
+    rendererBlock +
+    "    },\n" +
+    "    expanded: {\n" +
+    `      outlet: "${target}",\n` +
+    rendererBlock +
+    "    }\n" +
+    "  }\n" +
+    "});\n"
+  );
+}
+
 function findLastTemplateCloseTag(source = "") {
   const sourceText = String(source || "");
   let lastMatch = null;
@@ -123,7 +220,7 @@ async function runGeneratorSubcommand({
     throw new Error(`Unsupported ui-generator subcommand: ${normalizedSubcommand || "<empty>"}.`);
   }
   const targetFile = requireSinglePositionalTargetFile(args, { context: "ui-generator outlet" });
-  rejectUnexpectedOptions(options, ["target"], {
+  rejectUnexpectedOptions(options, ["target", "placement", "owner", "surface", "description", "link-renderer"], {
     context: "ui-generator outlet"
   });
 
@@ -132,6 +229,13 @@ async function runGeneratorSubcommand({
     optionName: "target"
   });
   const targetId = outletTarget.id;
+  const placementId = resolveSemanticPlacementOption(options);
+  const owner = resolveSemanticPlacementOwner({
+    placementId,
+    targetId,
+    owner: options?.owner
+  });
+  const surfaces = resolveTopologySurfaces(options);
 
   const targetFilePath = resolvePathWithinApp(appRoot, targetFile, {
     context: "ui-generator outlet"
@@ -162,11 +266,41 @@ async function runGeneratorSubcommand({
     await writeFile(targetFilePath.absolutePath, scriptApplied.content, "utf8");
   }
 
+  const topologyPath = resolvePathWithinApp(appRoot, PLACEMENT_TOPOLOGY_FILE, {
+    context: "ui-generator outlet"
+  });
+  const topologyMarker = `jskit:ui-generator.topology:${placementId}:${owner || "global"}`;
+  const topologySource = await readFile(topologyPath.absolutePath, "utf8");
+  const topologyApplied = appendBlockIfMarkerMissing(
+    topologySource,
+    topologyMarker,
+    renderOutletTopologyBlock({
+      marker: topologyMarker,
+      placementId,
+      owner,
+      surfaces,
+      description: options?.description,
+      target: targetId,
+      rendererToken: options?.["link-renderer"]
+    })
+  );
+  if (topologyApplied.changed && dryRun !== true) {
+    await writeFile(topologyPath.absolutePath, topologyApplied.content, "utf8");
+  }
+
+  const touchedFiles = new Set();
+  if (changed) {
+    touchedFiles.add(targetFilePath.relativePath);
+  }
+  if (topologyApplied.changed) {
+    touchedFiles.add(topologyPath.relativePath);
+  }
+
   return {
-    touchedFiles: changed ? [targetFilePath.relativePath] : [],
-    summary: changed
-      ? `Injected outlet "${targetId}" into ${targetFilePath.relativePath}.`
-      : `Outlet "${targetId}" is already present in ${targetFilePath.relativePath}.`
+    touchedFiles: [...touchedFiles].sort((left, right) => left.localeCompare(right)),
+    summary: touchedFiles.size > 0
+      ? `Injected outlet "${targetId}" and mapped semantic placement "${placementId}"${owner ? ` for owner "${owner}"` : ""}.`
+      : `Outlet "${targetId}" and semantic placement "${placementId}" are already present.`
   };
 }
 

package/src/server/subcommands/page.js

@@ -20,15 +20,20 @@ function renderPageLinkPlacementBlock({
   label = "",
   surface = ""
 } = {}) {
+  const componentTokenLine = context.__JSKIT_UI_LINK_COMPONENT_TOKEN__
+    ? `    componentToken: "${context.__JSKIT_UI_LINK_COMPONENT_TOKEN__}",\n`
+    : "";
   return (
     `// ${marker}\n` +
     "{\n" +
     "  addPlacement({\n" +
     `    id: "${context.__JSKIT_UI_LINK_PLACEMENT_ID__}",\n` +
     `    target: "${context.__JSKIT_UI_LINK_PLACEMENT_TARGET__}",\n` +
+    `${context.__JSKIT_UI_LINK_OWNER_LINE__}` +
+    `    kind: "link",\n` +
     `    surfaces: ["${surface}"],\n` +
     "    order: 155,\n" +
-    `    componentToken: "${context.__JSKIT_UI_LINK_COMPONENT_TOKEN__}",\n` +
+    componentTokenLine +
     "    props: {\n" +
     `      label: "${label}",\n` +
     `      icon: "${context.__JSKIT_UI_LINK_ICON__}",\n` +
@@ -56,7 +61,7 @@ async function runGeneratorSubcommand({
   const targetFile = requireSinglePositionalTargetFile(args, { context: "ui-generator page" });
   rejectUnexpectedOptions(
     options,
-    ["name", "link-placement", "link-component-token", "link-to", "force"],
+    ["name", "link-placement", "link-to", "force"],
     { context: "ui-generator page" }
   );
 

package/src/server/subcommands/pageSupport.js

@@ -313,7 +313,7 @@ function renderSubpagesTemplate({
     "<template>",
     renderSectionContainerOpenTag({ title, subtitle }),
     "    <template #tabs>",
-    `      <ShellOutlet target="${normalizedTarget}" default-link-component-token="${SUBPAGES_LINK_COMPONENT_TOKEN}" />`,
+    `      <ShellOutlet target="${normalizedTarget}" />`,
     "    </template>"
   ];
 

package/src/server/subcommands/support.js

@@ -10,6 +10,7 @@ import { toCamelCase, toSnakeCase } from "@jskit-ai/kernel/shared/support/string
 const DEFAULT_COMPONENT_DIRECTORY = "src/components";
 const MAIN_CLIENT_PROVIDER_FILE = "packages/main/src/client/providers/MainClientProvider.js";
 const PLACEMENT_FILE = "src/placement.js";
+const PLACEMENT_TOPOLOGY_FILE = "src/placementTopology.js";
 const SCRIPT_TAG_PATTERN = /<script\b([^>]*)>([\s\S]*?)<\/script>/gi;
 const SCRIPT_SETUP_ATTRIBUTE_PATTERN = /\bsetup\b/i;
 const ATTRIBUTE_PATTERN = /([:@]?[A-Za-z_][A-Za-z0-9_-]*)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'))?/g;
@@ -266,6 +267,7 @@ export {
   DEFAULT_COMPONENT_DIRECTORY,
   MAIN_CLIENT_PROVIDER_FILE,
   PLACEMENT_FILE,
+  PLACEMENT_TOPOLOGY_FILE,
   toKebabCase,
   toPascalCase,
   requireOption,