create-ailk 0.32.0 → 0.33.0

package/README.md

@@ -665,9 +665,15 @@ each directory's own `index.mdx` becomes its `BlogList/index` or
 `parent` comes from its path, never its frontmatter, and a file the walk skips
 is listed with the rule it failed. Their fumadocs frontmatter is mapped to
 the stored fields (`date` →
-`publishedAt`, `updated` → `updatedAt`); keys the store does not keep from a
-caller (`featured`, `sidebar`, `tags`) are not sent, and `--apply` names them
-in one line per file. Each outcome carries `root: "content"` or
+`publishedAt`, `updated` → `updatedAt`); every other key — the template's
+`featured` and `sidebar`, or a site's own such as `imageAlt` or `sources` —
+is sent in the page's `siteFields` under its own name, and a blog post's
+`tags` are sent as its categories (#10806). A key the store cannot keep is
+named with its reason under `--apply`, in one line per file:
+`<path>: not imported — <key> (<reason>); …`. A hub that predates site
+fields and drops them is named too: `<path>: not kept by the hub: <keys> (…)`.
+`export-content` writes `siteFields` back as top-level frontmatter keys.
+Each outcome carries `root: "content"` or
 `root: "editorial"`, and an editorial line is printed prefixed `editorial: `.
 
 ```bash

package/component-catalog.json

@@ -17,7 +17,7 @@
       "importPath": "@working-theory/ui/blocks",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/blocks",
-      "count": 107
+      "count": 108
     },
     {
       "name": "chrome",
@@ -1695,6 +1695,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "ScoreBar",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/ScoreBar.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "One labelled score bar on a scored magnet's results page: a label (the overall score's, or a dimension's name), the points out of the most a respondent could score, the Level name that share falls in, and one bar filled to the evaluator's own `pct` (`evaluateWaitlistScoring` returns `{ points, max, pct, level }` for the total and per dimension).",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "SectionActionRow",
       "tier": "blocks",

package/component-catalog.md

@@ -15,13 +15,13 @@ The component inventory of `@working-theory/ui` and the shells of `@working-theo
 3. Check the Primitives, Panels and Shells tables too — a low-level control, a collapsible layout container, or a route-level frame lives there, not under Sections or Blocks.
 4. Only then build. If you do build, you are declaring the capability is genuinely absent.
 
-Inventory: **324 component files** across 16 tiers — 60 sections, 107 blocks, 19 chrome, 79 primitives, 6 panels, 8 shells, 5 docs-blog-blocks, 1 docs-blog-chrome, 2 docs-blog-shells, 2 scheduling-sections, 6 scheduling-blocks, 5 signal-collectors-sections, 9 signal-collectors-blocks, 2 commerce-sections, 12 commerce-blocks, 1 commerce-panels. 321 distinct names: `SchedulerEmbed`, `Separator`, `Tabs` exist in more than one tier as genuinely different components, listed once per tier with its own source path.
+Inventory: **325 component files** across 16 tiers — 60 sections, 108 blocks, 19 chrome, 79 primitives, 6 panels, 8 shells, 5 docs-blog-blocks, 1 docs-blog-chrome, 2 docs-blog-shells, 2 scheduling-sections, 6 scheduling-blocks, 5 signal-collectors-sections, 9 signal-collectors-blocks, 2 commerce-sections, 12 commerce-blocks, 1 commerce-panels. 322 distinct names: `SchedulerEmbed`, `Separator`, `Tabs` exist in more than one tier as genuinely different components, listed once per tier with its own source path.
 
-Description coverage: **320/324** components carry a capability description derived from source — 45 from the section registry's hand-authored when-to-use text, 240 from the component's own doc-comment header, 35 from its tier barrel's roster line. **4** have none; they are listed under [Undescribed components](#undescribed-components) rather than given a sentence invented from their name.
+Description coverage: **321/325** components carry a capability description derived from source — 45 from the section registry's hand-authored when-to-use text, 241 from the component's own doc-comment header, 35 from its tier barrel's roster line. **4** have none; they are listed under [Undescribed components](#undescribed-components) rather than given a sentence invented from their name.
 
-Of those, **286** are *strong* — a capability sentence you could match a requirement against — and **34** are *weak*: either one short clause, or a long one that spends itself on wiring (client boundaries, class names, which primitives it composes) instead of on what the thing is for. Weak rows are marked `(weak)` and listed in full under [Weak descriptions](#weak-descriptions). Coverage is 99%, but **findable-without-luck coverage is 88%**.
+Of those, **287** are *strong* — a capability sentence you could match a requirement against — and **34** are *weak*: either one short clause, or a long one that spends itself on wiring (client boundaries, class names, which primitives it composes) instead of on what the thing is for. Weak rows are marked `(weak)` and listed in full under [Weak descriptions](#weak-descriptions). Coverage is 99%, but **findable-without-luck coverage is 88%**.
 
-Per tier, strong out of total: **Sections** 59/60 · **Blocks** 99/107 · **Chrome** 10/19 · **Primitives** 64/79 (4 undescribed) · **Panels** 5/6 · **Shells** 7/8 · **Docs + Blog Blocks** 5/5 · **Docs + Blog Chrome** 1/1 · **Docs + Blog Shells** 0/2 · **Scheduling Sections** 2/2 · **Scheduling Blocks** 6/6 · **Signal-Collectors Sections** 5/5 · **Signal-Collectors Blocks** 8/9 · **Commerce Sections** 2/2 · **Commerce Blocks** 12/12 · **Commerce Panels** 1/1. A tier low on this line is a tier where a capability search is most likely to come up empty on something that exists.
+Per tier, strong out of total: **Sections** 59/60 · **Blocks** 100/108 · **Chrome** 10/19 · **Primitives** 64/79 (4 undescribed) · **Panels** 5/6 · **Shells** 7/8 · **Docs + Blog Blocks** 5/5 · **Docs + Blog Chrome** 1/1 · **Docs + Blog Shells** 0/2 · **Scheduling Sections** 2/2 · **Scheduling Blocks** 6/6 · **Signal-Collectors Sections** 5/5 · **Signal-Collectors Blocks** 8/9 · **Commerce Sections** 2/2 · **Commerce Blocks** 12/12 · **Commerce Panels** 1/1. A tier low on this line is a tier where a capability search is most likely to come up empty on something that exists.
 
 That grade is **mechanical**. It counts what it can measure — how much a description adds beyond the component's own name, how much of it is spent on wiring, whether the extraction came out damaged — and it cannot tell a fluent paragraph about the wrong subject from a useful one. A person reading these tables will find more rows unusable than the weak count admits. Treat it as a floor on the problem, not a measurement of it, and read the source before concluding a capability is absent.
 
@@ -124,7 +124,7 @@ Import: `import { X } from "@working-theory/ui/sections";` (or from the `@workin
 
 ---
 
-## Blocks (107)
+## Blocks (108)
 
 Intermediate composition tiles — the pieces sections are built from. Compose primitives and panels; never import a section.
 
@@ -215,6 +215,7 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `ResponsiveSheet` | ONE component, TWO forms, ONE open pair. Renders its `children` as a Radix Dialog at `md` (768px, --breakpoint-md) and up, and as a full-screen Radix Sheet below it — never both at once. | `import { ResponsiveSheet } from "@working-theory/ui/blocks"` |
 | `RowGroup` | The bordered box that groups ListRows with hairline dividers. The reference is `packages-paid/admin/design/demos/first-steps/demo.html`'s `.box` (`background:var(--bg);border:1px solid var(--border); border-radius:6px;overflow:hidden`) with `.row{border-top:…}` and `.row:first-child{border-top:0}` — i.e. hairlines BETWEEN rows, none above the first. | `import { RowGroup } from "@working-theory/ui/blocks"` |
 | `SchedulerEmbed` | A declarative third-party booking iframe. Renders a full-width, border-0, lazy-loaded <iframe> at `src` with a graceful loading skeleton (shown until the iframe's own `load` event fires) and a timeout-gated plain-link fallback beneath it — for environments that block third-party frames (ad blockers, a strict CSP `frame-src`) where the iframe may load blank or never load at all. | `import { SchedulerEmbed } from "@working-theory/ui/blocks"` · `packages/ui/src/blocks/SchedulerEmbed.tsx` |
+| `ScoreBar` | One labelled score bar on a scored magnet's results page: a label (the overall score's, or a dimension's name), the points out of the most a respondent could score, the Level name that share falls in, and one bar filled to the evaluator's own `pct` (`evaluateWaitlistScoring` returns `{ points, max, pct, level }` for the total and per dimension). | `import { ScoreBar } from "@working-theory/ui/blocks"` |
 | `SectionActionRow` | The bottom-anchored, centered action row a section places BENEATH its own content, at the 44×44px target-size floor. It is the block form of the placement established for `stair-steps`: a bounded 1-2 action list rendered after the section body rather than inside the section header. | `import { SectionActionRow } from "@working-theory/ui/blocks"` |
 | `SectionHeader` | Alignment-parameterized section header (eyebrow/subtitle/description/supportLink). The same component serves two ranks (headingLevel="section" \| "subsection") and three alignments (align="start" \| "center" \| "end"). It knows nothing about columns/splits/carousels — it is width-flexible and fills whatever container the section places it in. | `import { SectionHeader } from "@working-theory/ui/blocks"` |
 | `ShareBar` | The reader-facing counterpart to DocsActionBar. Both surfaces share the same SplitButton *affordance + slot* (outline variant, right-justified on the post title row) but fill it with different actions: DocsActionBar carries the AI-ingestion set (Copy page + Open in …), ShareBar carries the social-share set (X · LinkedIn · Bluesky · Copy link). One primitive, two configs. | `import { ShareBar } from "@working-theory/ui/blocks"` |

package/dist/export-content.d.ts

@@ -6,8 +6,11 @@ export declare class ExportContentRefusedError extends Error {
     constructor(message: string);
 }
 export declare const SPOKE_HINT = "the site's read does not serve this workspace's published version \u2014 is the spoke at --store database?";
-/** The site-relative file a stored page is written to, and whether it is editorial. */
-export declare function fileFor(targetDir: string, type: string, slug: string, locale: string): {
+/**
+ * The site-relative file a stored page is written to, and whether it is
+ * editorial. A blog post's `parent` is its series' directory (#10811 D1).
+ */
+export declare function fileFor(targetDir: string, type: string, slug: string, locale: string, parent?: string): {
     path: string;
     editorial: boolean;
 };
@@ -51,5 +54,5 @@ export interface ExportContentArgs {
     workspaceId: string | undefined;
     help: boolean;
 }
-export declare const EXPORT_CONTENT_HELP = "create-ailk export-content \u2014 write every published page back to its content file.\n\nUsage:\n  AILK_AGENT_KEY=<key> create-ailk export-content [<dir>] [--dry-run] [--api-url <origin>] [--workspace <wksp_id>]\n\nArguments:\n  <dir>                    The site. Defaults to the current dir.\n\nOptions:\n  --dry-run                Print what would be written, and write nothing.\n  --api-url <origin>       The API origin that holds the workspace \u2014 on a\n                           spoke, its hub's. Else AILK_API_URL.\n  --workspace <wksp_id>    The workspace. Else AILK_WORKSPACE_ID.\n  -h, --help               Show this help.\n\nThe rollback for a cutover: every page the workspace list reports published\nin the default locale is written to the file migrate-content reads it from\n\u2014 content/en/<Type>/<slug>.mdx (or the legacy content/<Type>/<slug>.mdx that\nexists), apps/web/content/en/blog/<slug>.mdx for a post and the same under\ndocs for a docs page \u2014 with its words moved back into its sections, so a\nre-run of migrate-content reports every page unchanged. Published edits are\nkept. A page with a draft ahead of its published version fails by name:\npublish or revert it in Admin, then re-run. The site's own API read must\nserve the workspace's published version (on a spoke, the hub's row at\n--store database). Each page prints created, written, unchanged or failed.\nThe agent key needs the content-edit grant; on a spoke, AILK_SPOKE_KEY is\nneeded too. Exit 0 when no page failed, 1 when any did, 2 on a refusal.\n";
+export declare const EXPORT_CONTENT_HELP = "create-ailk export-content \u2014 write every published page back to its content file.\n\nUsage:\n  AILK_AGENT_KEY=<key> create-ailk export-content [<dir>] [--dry-run] [--api-url <origin>] [--workspace <wksp_id>]\n\nArguments:\n  <dir>                    The site. Defaults to the current dir.\n\nOptions:\n  --dry-run                Print what would be written, and write nothing.\n  --api-url <origin>       The API origin that holds the workspace \u2014 on a\n                           spoke, its hub's. Else AILK_API_URL.\n  --workspace <wksp_id>    The workspace. Else AILK_WORKSPACE_ID.\n  -h, --help               Show this help.\n\nThe rollback for a cutover: every page the workspace list reports published\nin the default locale is written to the file migrate-content reads it from\n\u2014 content/en/<Type>/<slug>.mdx (or the legacy content/<Type>/<slug>.mdx that\nexists), apps/web/content/en/blog/<slug>.mdx for a post,\napps/web/content/en/blog/<series>/<slug>.mdx for a post in a series and the\nsame under docs for a docs page; a post or doc goes to whichever of\n<slug>.mdx or <slug>/index.mdx is on disk, <slug>.mdx when neither is \u2014 with\nits words moved back into its sections, so a re-run of migrate-content\nreports every page unchanged. Published edits are\nkept. A page with a draft ahead of its published version fails by name:\npublish or revert it in Admin, then re-run. The site's own API read must\nserve the workspace's published version (on a spoke, the hub's row at\n--store database). Each page prints created, written, unchanged or failed.\nThe agent key needs the content-edit grant; on a spoke, AILK_SPOKE_KEY is\nneeded too. Exit 0 when no page failed, 1 when any did, 2 on a refusal.\n";
 export declare function parseExportContentArgs(argv: string[]): ExportContentArgs;

package/dist/export-content.js

@@ -24,7 +24,7 @@
  *
  * Pure module: no `import.meta.url`, so jest imports it directly.
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { parseArgs } from "node:util";
 import { listWorkspacePages, loadSiteWordsCodec, readDraftPage, readPublishedPage, readSiteLocales, resolveWorkspaceAccess, } from "./inventory.js";
@@ -52,21 +52,32 @@ const EDITORIAL_DIRS = {
 const EDITORIAL_RENAMES = { publishedAt: "date", updatedAt: "updated" };
 /** Keys an editorial file does not carry: its path decides both. */
 const EDITORIAL_DROPPED = new Set(["type", "slug"]);
+/**
+ * Never written from `siteFields` (#10806 D6): a mapped fumadocs key, an
+ * address key, the strip marker, or a prototype name.
+ */
+const NOT_SITE_FIELDS = new Set(["date", "updated", "type", "slug", "oss", "siteFields", "__proto__"]);
 const INDEX_SLUG = "index";
 /** The store's address shapes, restated (create-ailk has no runtime dep): a path built from them stays in the site. */
 const TYPE_SHAPE = /^[A-Z][A-Za-z]*$/;
 const SLUG_SHAPE = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
 const LOCALE_SHAPE = /^[a-z]{2}(-[A-Z]{2})?$/;
+/** A blog series' shape (`PARENT` in `lib/import-mdx.ts`), restated: a directory built from it stays in the blog. */
+const SERIES_SHAPE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 /** A pinned item's read times out as the kit's other reads do (`inventory.ts`). */
 const ITEM_READ_TIMEOUT_MS = 15_000;
 export const SPOKE_HINT = "the site's read does not serve this workspace's published version — is the spoke at --store database?";
 // ── File addressing (D6) ────────────────────────────────────────────────────
-/** The site-relative file a stored page is written to, and whether it is editorial. */
-export function fileFor(targetDir, type, slug, locale) {
+/**
+ * The site-relative file a stored page is written to, and whether it is
+ * editorial. A blog post's `parent` is its series' directory (#10811 D1).
+ */
+export function fileFor(targetDir, type, slug, locale, parent) {
     const exists = (path) => existsSync(join(targetDir, path));
     const editorial = EDITORIAL_DIRS[type];
     if (editorial !== undefined && editorial.index === (slug === INDEX_SLUG)) {
-        const base = `apps/web/content/${locale}/${editorial.dir}`;
+        const series = type === "BlogPosting" && parent !== undefined ? `/${parent}` : "";
+        const base = `apps/web/content/${locale}/${editorial.dir}${series}`;
         if (editorial.index)
             return { path: `${base}/index.mdx`, editorial: true };
         // The importer reads `<slug>.mdx` first and `<slug>/index.mdx` (#10701);
@@ -88,11 +99,20 @@ export function recombine(content, sections, codec, editorial, pinned) {
     const { body: rawBody, ...rest } = content;
     let body = typeof rawBody === "string" ? rawBody : "";
     const frontmatter = {};
-    for (const [key, value] of Object.entries(rest)) {
+    const { siteFields, ...stored } = rest;
+    for (const [key, value] of Object.entries(editorial ? stored : rest)) {
         if (editorial && EDITORIAL_DROPPED.has(key))
             continue;
         frontmatter[editorial ? (EDITORIAL_RENAMES[key] ?? key) : key] = value;
     }
+    // #10806 D6 — an editorial page's site fields are its file's own keys, after
+    // the mapped ones; a mapped key always wins.
+    if (editorial && siteFields !== null && typeof siteFields === "object" && !Array.isArray(siteFields)) {
+        for (const [key, value] of Object.entries(siteFields)) {
+            if (!Object.hasOwn(frontmatter, key) && !NOT_SITE_FIELDS.has(key))
+                frontmatter[key] = value;
+        }
+    }
     if (sections !== undefined && sections.length > 0) {
         const applied = codec.applyWords(body, sections);
         if (applied.issues.length > 0) {
@@ -170,6 +190,15 @@ export async function exportContent(opts) {
         if (draft.version !== row.publishedVersionId) {
             return failed("the draft read is not the published version; re-run");
         }
+        // #10811 D4 — a blog post's series becomes a directory, so it must be one
+        // the importer reads back; the API's value is not printed.
+        const stored = type === "BlogPosting" ? draft.content["parent"] : undefined;
+        const parent = typeof stored === "string" && SERIES_SHAPE.test(stored) && stored !== slug && stored !== "category"
+            ? stored
+            : undefined;
+        if (stored !== undefined && parent === undefined) {
+            return failed("its series is not one a file can be written under (lowercase words joined by single hyphens, not its own slug, not category)");
+        }
         const published = await readPublishedPage(access, fetch, type, slug, locale);
         if (!published.found || published.publishedVersionId !== row.publishedVersionId) {
             return failed(SPOKE_HINT);
@@ -177,8 +206,18 @@ export async function exportContent(opts) {
         const pinned = await pinnedItems(published.sections ?? [], locale);
         if (typeof pinned === "string")
             return failed(pinned);
-        const { path, editorial } = fileFor(targetDir, type, slug, locale);
-        const file = recombine(draft.content, published.sections, codec, editorial, pinned);
+        const { path, editorial } = fileFor(targetDir, type, slug, locale, parent);
+        let content = draft.content;
+        if (parent !== undefined && editorial) {
+            const holder = addressHolder(slug, parent);
+            if (holder !== undefined) {
+                return failed(`${holder} would hold this post's address on import; remove it, then re-run`, path);
+            }
+            // #10811 D3 — the path carries the series, as it carries type and slug.
+            const { parent: _series, ...unparented } = content;
+            content = unparented;
+        }
+        const file = recombine(content, published.sections, codec, editorial, pinned);
         if ("reason" in file)
             return failed(file.reason, path);
         const absolute = join(targetDir, path);
@@ -190,6 +229,33 @@ export async function exportContent(opts) {
         }
         return { type, slug, file: path, result };
     }
+    /**
+     * The first other file, in path order, that the editorial walk reads as
+     * this series post's `BlogPosting/<slug>` (#10811 D5): the top-level forms,
+     * or the same post under another series. The walk skips `category`, `_`
+     * entries and symbolic links, and refuses a series not in its shape or
+     * named after its own post, so none of those holds the address.
+     */
+    function addressHolder(slug, parent) {
+        const blog = `apps/web/content/${locale}/blog`;
+        const series = existsSync(join(targetDir, blog))
+            ? readdirSync(join(targetDir, blog), { withFileTypes: true })
+                .filter((d) => d.isDirectory() && SERIES_SHAPE.test(d.name) && ![parent, slug, "category"].includes(d.name))
+                .map((d) => `${blog}/${d.name}`)
+            : [];
+        // Every directory below `blog` a real directory and the file a real file.
+        const walked = (path) => {
+            const parts = path.slice(blog.length + 1).split("/");
+            return parts.every((_, i) => {
+                const stat = lstatSync(join(targetDir, blog, ...parts.slice(0, i + 1)), { throwIfNoEntry: false });
+                return i === parts.length - 1 ? stat?.isFile() === true : stat?.isDirectory() === true;
+            });
+        };
+        return [blog, ...series]
+            .flatMap((dir) => [`${dir}/${slug}.mdx`, `${dir}/${slug}/index.mdx`])
+            .filter(walked)
+            .sort()[0];
+    }
     /**
      * The Live words of every item the page's faq / glossary-index sections pin
      * (#10735 D9), by kind and slug — `undefined` when none pins — or why the
@@ -261,9 +327,12 @@ Options:
 The rollback for a cutover: every page the workspace list reports published
 in the default locale is written to the file migrate-content reads it from
 — content/en/<Type>/<slug>.mdx (or the legacy content/<Type>/<slug>.mdx that
-exists), apps/web/content/en/blog/<slug>.mdx for a post and the same under
-docs for a docs page — with its words moved back into its sections, so a
-re-run of migrate-content reports every page unchanged. Published edits are
+exists), apps/web/content/en/blog/<slug>.mdx for a post,
+apps/web/content/en/blog/<series>/<slug>.mdx for a post in a series and the
+same under docs for a docs page; a post or doc goes to whichever of
+<slug>.mdx or <slug>/index.mdx is on disk, <slug>.mdx when neither is — with
+its words moved back into its sections, so a re-run of migrate-content
+reports every page unchanged. Published edits are
 kept. A page with a draft ahead of its published version fails by name:
 publish or revert it in Admin, then re-run. The site's own API read must
 serve the workspace's published version (on a spoke, the hub's row at

package/dist/lib/import-mdx.d.ts

@@ -32,6 +32,19 @@ export interface MdxAdapterModule {
         data: Record<string, unknown>;
         content: string;
     };
+    /**
+     * The site-field rule from the adapter's validation package (#10806 D4);
+     * without it the editorial walk sends no `siteFields` and no `tags`, and
+     * names the keys it would have sent.
+     */
+    siteFields?: SiteFieldRules;
+}
+/** The validation package's site-field rule, typed structurally. */
+export interface SiteFieldRules {
+    refusal: (key: string, value: unknown) => string | null;
+    publicPageTags: (tags: readonly unknown[]) => string[];
+    maxKeys: number;
+    maxBytes: number;
 }
 export interface ImportMdxOptions {
     /** The site's content root (`content/`). */
@@ -88,6 +101,35 @@ interface At {
 export declare function outcomePath(at: At): string;
 /** The whole report, one line per page and a final count line. */
 export declare function formatImportMdxReport(result: ImportMdxResult): string;
+/**
+ * A section string's inline HTML as the constrained Markdown the upstream
+ * renderers read (#10804 D3): a link with an allowed href becomes
+ * `[label](href)`, `<br>` a newline, a block or list item a paragraph break,
+ * and every other tag goes, its text kept. A string with no tag comes back
+ * byte-identical; the result never holds one. `notCarried` names, sorted,
+ * every tag the layout does not keep.
+ */
+export declare function inlineHtmlToMarkdown(value: string): {
+    text: string;
+    notCarried: string[];
+};
+/**
+ * Each section with every string in its `data` that holds a tag converted by
+ * `inlineHtmlToMarkdown` (#10804 D2); keys and tag-free strings are kept as
+ * they are. `notCarried` is the sorted union of the names it did not carry.
+ */
+export declare function sectionsWithoutHtml<T>(sections: readonly T[]): {
+    sections: T[];
+    notCarried: string[];
+};
+/**
+ * The first section-string or key rule of the hub's structure write
+ * (`checkSectionData`) the layout breaks, as `<message> (sections[i].data<path>)`,
+ * or `undefined` (#10804 D5). The depth and size bounds are not restated.
+ */
+export declare function layoutRefusal(layout: {
+    sections: readonly unknown[];
+}): string | undefined;
 export declare function importMdx(opts: ImportMdxOptions): Promise<ImportMdxResult>;
 /**
  * The site's installed adapter package, resolved from its `apps/web` — never