@12ui/design 0.2.56 → 0.2.58

package/dist/improve-core/improve-added-specs.js

@@ -0,0 +1,160 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+import { insertionAnchor, selectorLabel, domPx } from './improve-dom-anchor.js';
+import { improveIconSvgVariants } from './improve-icon-svg.js';
+/** Flatten target leaves while retaining group ancestry for sibling placement. */
+export const flattenImproveHierarchy = (document) => {
+    const layers = document && typeof document === 'object' && 'layers' in document
+        && Array.isArray(document.layers) ? document.layers : [];
+    const output = [];
+    const visit = (nodes, parents) => {
+        nodes.forEach((node, index) => {
+            if (!node || typeof node !== 'object')
+                return;
+            const leaf = node;
+            if (leaf.kind === 'group' && Array.isArray(leaf.children)) {
+                visit(leaf.children, [...parents, `${leaf.name ?? 'group'}[${index}]`]);
+            }
+            else
+                output.push({ leaf, parentPath: parents });
+        });
+    };
+    visit(layers, []);
+    return output;
+};
+const commonDepth = (left, right) => {
+    let index = 0;
+    while (index < left.length && left[index] === right[index])
+        index += 1;
+    return index;
+};
+const insertionFor = (args) => {
+    const target = args.normalizedTarget[args.designIndex];
+    const siblings = args.diff.matched.filter((entry) => args.before[entry.beforeIndex]?.dom)
+        .map((entry) => ({
+        entry,
+        depth: commonDepth(args.hierarchy[args.designIndex]?.parentPath ?? [], args.hierarchy[entry.afterIndex]?.parentPath ?? []),
+        distance: target?.box && args.normalizedTarget[entry.afterIndex]?.box
+            ? Math.hypot(target.box[0] - args.normalizedTarget[entry.afterIndex].box[0], target.box[1] - args.normalizedTarget[entry.afterIndex].box[1])
+            : Number.POSITIVE_INFINITY,
+    }))
+        .sort((left, right) => right.depth - left.depth || left.distance - right.distance);
+    const sibling = siblings[0];
+    if (sibling) {
+        const siblingBox = args.normalizedTarget[sibling.entry.afterIndex]?.box;
+        const relation = target?.box && siblingBox
+            && (target.box[1] < siblingBox[1] || (target.box[1] === siblingBox[1] && target.box[0] < siblingBox[0]))
+            ? 'before'
+            : 'after';
+        return `${relation} ${selectorLabel(args.before[sibling.entry.beforeIndex])}`;
+    }
+    if (target?.box) {
+        const fallback = insertionAnchor(target.box, args.before);
+        if (fallback.container >= 0)
+            return `inside ${selectorLabel(args.before[fallback.container])}`;
+    }
+    return 'unresolved — no matched parent or sibling selector';
+};
+const shown = (value, suffix = '') => value === undefined || value === null || value === ''
+    ? 'not specified'
+    : `${typeof value === 'object' ? JSON.stringify(value) : String(value)}${suffix}`;
+/** Preference order for the extracted artifact a plan should hand a coder. */
+export const improveArtifactIds = (leaf) => {
+    const artifacts = leaf.artifacts;
+    if (!artifacts || typeof artifacts !== 'object' || Array.isArray(artifacts))
+        return [];
+    const preference = ['cutout', 'region2x', 'crop'];
+    return Object.entries(artifacts).flatMap(([name, value]) => (value && typeof value === 'object' && !Array.isArray(value)
+        && typeof value.artifactId === 'string'
+        ? [{ name, id: value.artifactId }]
+        : [])).sort((left, right) => {
+        const leftIndex = preference.indexOf(left.name);
+        const rightIndex = preference.indexOf(right.name);
+        return (leftIndex < 0 ? preference.length : leftIndex)
+            - (rightIndex < 0 ? preference.length : rightIndex);
+    }).map((entry) => entry.id);
+};
+const svgAssetStem = (designIndex, leaf) => (`added-${String(designIndex).padStart(3, '0')}-${(leaf.content ?? 'icon')
+    .toLowerCase().replace(/[^a-z0-9]+/gu, '-').replace(/^-+|-+$/gu, '') || 'icon'}`);
+/**
+ * Every target leaf the diff never matched, with the full specification a coder
+ * needs to build it: where it goes relative to a real selector, its complete
+ * typography and style map, and the asset it references. Inline `iconSvg` is
+ * materialized into the returned `files` map rather than written here, so the
+ * CLI and the browser produce the same bytes at the same relative path.
+ */
+export const buildImproveAddedElementSpecs = (args) => {
+    const hierarchy = flattenImproveHierarchy(args.targetDoc);
+    const matched = new Set(args.diff.matched.map((entry) => entry.afterIndex));
+    const specs = [];
+    const files = {};
+    for (const [designIndex, entry] of hierarchy.entries()) {
+        if (matched.has(designIndex))
+            continue;
+        const leaf = entry.leaf;
+        const ids = improveArtifactIds(leaf);
+        let asset = ids.length === 0
+            ? undefined
+            : args.resolveAsset?.(ids)
+                ?? { kind: `unresolved extracted artifact (${ids.join(', ')})`, resolvable: false };
+        if (typeof leaf.iconSvg === 'string' && leaf.iconSvg.trim()) {
+            // A single `currentColor` file rendered black wherever the kit told a
+            // lane to put it (F30). The layer declares its colour, so both forms are
+            // written and the spec says which is which.
+            const variants = improveIconSvgVariants({
+                svg: leaf.iconSvg,
+                color: leaf.color,
+                stem: svgAssetStem(designIndex, leaf),
+            });
+            for (const file of variants.files)
+                files[`assets/${file.name}`] = `${file.svg}\n`;
+            const inline = variants.inline && variants.inline.name !== variants.primary.name
+                ? {
+                    path: args.describePath(`assets/${variants.inline.name}`),
+                    destination: `src/assets/design/${variants.inline.name}`,
+                }
+                : undefined;
+            asset = {
+                kind: variants.color
+                    ? `inline iconSvg materialized as SVG, painted ${variants.color}`
+                    : 'inline iconSvg materialized as SVG',
+                path: args.describePath(`assets/${variants.primary.name}`),
+                destination: `src/assets/design/${variants.primary.name}`,
+                resolvable: true,
+                usage: variants.primary.usage,
+                ...(inline ? { inline } : {}),
+                colorNote: variants.note,
+            };
+        }
+        const insertion = insertionFor({
+            designIndex,
+            hierarchy,
+            normalizedTarget: args.normalizedTarget,
+            before: args.before,
+            diff: args.diff,
+        });
+        const markdown = [
+            `### Added ${designIndex}: ${leaf.kind ?? 'layer'} — ${shown(leaf.content)}`,
+            '',
+            `- Kind: \`${leaf.kind ?? 'layer'}\``,
+            `- Content: ${shown(leaf.content)}`,
+            `- Box: target-design px ${shown(leaf.box)}; DOM-frame px ${shown(domPx(args.normalizedTarget[designIndex]?.box, args.canvas))}`,
+            `- Insert: ${insertion}`,
+            `- Typography: font-family ${shown(leaf.googleFontFamily)}; font-size ${shown(leaf.fontSizePx, leaf.fontSizePx === undefined ? '' : 'px')}; fitted-font-size ${shown(leaf.fittedFontSizePx, leaf.fittedFontSizePx === undefined ? '' : 'px')}; font-weight ${shown(leaf.fontWeight)}; color ${shown(leaf.color)}; align ${shown(leaf.align)}`,
+            `- Style map: \`${JSON.stringify(leaf.style ?? {})}\``,
+            `- Visual fields: surface ${shown(leaf.surface)}; opacity ${shown(leaf.opacity)}; rotation ${shown(leaf.rotationDeg, leaf.rotationDeg === undefined ? '' : 'deg')}`,
+            asset?.path
+                ? `- Asset: ${asset.kind}; absolute path \`${asset.path}\`; suggested destination \`${asset.destination}\`; resolvable: yes`
+                : asset
+                    ? `- Asset: ${asset.kind}; absolute path unresolved; suggested destination unresolved; resolvable: no`
+                    : '- Asset: none referenced by the target node',
+            ...(asset?.inline
+                ? [`- Inline variant: absolute path \`${asset.inline.path}\`; suggested destination \`${asset.inline.destination}\``]
+                : []),
+            ...(asset?.colorNote ? [`- Colour: ${asset.colorNote}`] : []),
+        ].join('\n');
+        specs.push({ designIndex, insertion, markdown, ...(asset ? { asset } : {}) });
+    }
+    return { specs, files };
+};
+//# sourceMappingURL=improve-added-specs.js.map

package/dist/improve-core/improve-added-specs.js.map

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

package/dist/improve-core/improve-artifacts.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The plan core never touches a filesystem: it returns the kit it wants to
+ * exist and lets the caller realize it. The CLI writes the map under a run
+ * directory; the web page zips the same map. One policy module, two hosts,
+ * byte-identical artifacts for the same inputs.
+ *
+ * Keys are relative POSIX paths inside the directory the caller names — never
+ * absolute, never `..`. `remove` lists the relative paths a previous run may
+ * have left behind that this run's state invalidates (a passing gate deletes
+ * `GATE.md`; a blocked gate deletes the plan it must not imply).
+ */
+export type ImproveArtifactMap = {
+    files: Record<string, string | Uint8Array>;
+    remove: string[];
+};
+/** A caller-supplied way to name a relative artifact in rendered prose. */
+export type ImproveDescribePath = (relativePath: string) => string;
+//# sourceMappingURL=improve-artifacts.d.ts.map

package/dist/improve-core/improve-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-artifacts.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-artifacts.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC"}

package/dist/improve-core/improve-artifacts.js

@@ -0,0 +1,4 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+export {};
+//# sourceMappingURL=improve-artifacts.js.map

package/dist/improve-core/improve-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-artifacts.js","sourceRoot":"","sources":["../../src/improve-core/improve-artifacts.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,uEAAuE"}

package/dist/improve-core/improve-concept.d.ts

@@ -0,0 +1,7 @@
+import { type ImproveRetainPolicy } from './improve-retain.js';
+/** The real steering limit after reserving room for the mandatory harness. */
+export declare const IMPROVE_DIRECTION_MAX_CHARACTERS: number;
+/** Where cut detail belongs, stated once for the refusal and the skill. */
+export declare const IMPROVE_DIRECTION_TRIM_HINT: string;
+export declare const buildImproveConcept: (direction?: string, retain?: ImproveRetainPolicy) => string;
+//# sourceMappingURL=improve-concept.d.ts.map

package/dist/improve-core/improve-concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-concept.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-concept.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AA+I7B,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,QAAuD,CAAC;AAErG,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,QACG,CAAC;AAS5C,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,EAClB,SAAQ,mBAA4C,KACnD,MA+CF,CAAC"}

package/dist/improve-core/improve-concept.js

@@ -0,0 +1,185 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+import { conceptCharacterCount, conceptOverLimitMessage, MAX_CONCEPT_CHARACTERS, readConceptValue, } from './concept-input.js';
+import { DEFAULT_IMPROVE_RETAIN, IMPROVE_RETAIN_FACETS, improveRetainKeeps, } from './improve-retain.js';
+import { ImproveRefusal } from './improve-refusal.js';
+/**
+ * THE BRIEF LEADS, AND THE CLAUSES AROUND IT SCALE WITH THE TOGGLES (owner,
+ * 2026-09-02).
+ *
+ * The harness used to SANDWICH the brief: a fixed three-sentence "preserve its
+ * product identity and working structure" paragraph first, the user's brief as
+ * one `Direction:` line in the middle, and one no-invention clause last — the
+ * same three sentences no matter what the run was retaining. The owner asked
+ * for "a modern minimal saas with line art imagery" and got his own page with
+ * a slightly different background, which is what that sandwich asks for.
+ *
+ * So the brief goes first, and every sentence after it is chosen by a retain
+ * facet the service already understands:
+ *   layout  — is the page redrawn, or lifted where it stands?
+ *   style   — is there a new visual system, or is the existing one sharpened?
+ *   assets  — is the brand held?
+ *   content — are the words held, or may they be rewritten?
+ * Nothing here invents a policy: turn a toggle and exactly one sentence
+ * changes, so what the visitor set is what the model is told.
+ *
+ * ONE THING IS NOT A TOGGLE. No combination licenses inventing a product fact.
+ * With copy held that is "say the same things"; with copy free it is "rewrite
+ * the words, keep the facts" — the failure pole improve exists to avoid
+ * (CLAUDE.md item 8) is never one click away.
+ */
+/**
+ * ALL FOUR TOGGLES ON IS THE POLISH POSTURE, NOT A FREEZE (owner, 2026-09-02,
+ * direct chat with a screenshot): "Selecting all the options results in no
+ * changes?" — chargedesk.com, brief "Modern minimal saas with line art", four
+ * candidates indistinguishable from the live page.
+ *
+ * They were indistinguishable because the assembly asked for that. `layout`
+ * kept said "the position of everything on it exactly where they are";
+ * `style` kept said the palette, typography and texture were fixed while the
+ * server's retain clause simultaneously promised back "spacing rhythm …
+ * texture and ink … and polish". Between them the two mandates named every
+ * axis a design has, and an image edit given a full freeze returns its input.
+ *
+ * So each mandate now separates what it HOLDS from what it may still IMPROVE,
+ * and says so in the same breath — a person who turns everything on is asking
+ * for their page polished, not photocopied.
+ */
+const LAYOUT_MANDATE = {
+    keep: 'Improve this existing product interface into a production-ready version of itself, keeping its layout and section order: nothing moves to a new place, though spacing and alignment may be tightened.',
+    free: 'Redesign this existing product interface. Its layout, composition, section order, and proportions are yours to rework: this should read as a new design of the same product, not a retouch of the one it has.',
+};
+/**
+ * A STYLE HAS AN IDENTITY AND IT HAS A FINISH. The identity is what makes the
+ * page recognisably this product's — its palette, its typography voice, its
+ * image treatment. The finish is spacing rhythm, alignment, surfaces, control
+ * affordances, ink and type rendering: what a designer tidies without anyone
+ * saying the brand changed. "Keep style" keeps the identity; the finish is
+ * exactly what an improvement is for.
+ *
+ * These are the same words the service's retain clause uses for a retained
+ * `style` on a subject run (`workers/api/src/create/retain.ts`), because the
+ * harness sentence the toggle picks and the retain clause the toggle produces
+ * must not tell the model two different things.
+ */
+const STYLE_MANDATE = {
+    keep: 'Work inside its existing visual language: its palette, typography voice, and image treatment stay, and everything around them is sharpened - spacing rhythm, alignment, surfaces, control affordances, ink, and type rendering.',
+    free: 'Give it a deliberate hierarchy, a real spacing rhythm, typography with range, restrained color, purposeful states, and surfaces and controls that belong to one system.',
+};
+const BRAND_CLAUSE = "Keep the product's logo, wordmark, and brand imagery as they are.";
+/**
+ * THE TOGGLES ARE CONSERVATION DEFAULTS AND THE BRIEF OUTRANKS THEM (owner,
+ * 2026-09-02: "Maybe the wording becomes keep xyz PROVIDING it doesn't
+ * conflict with the prompt?").
+ *
+ * Read as absolutes, four "keep" sentences and one brief can only contradict
+ * each other, and an image edit resolves a contradiction the safe way: it
+ * returns its input. That is the whole of the owner's chargedesk report —
+ * "Modern minimal saas with line art" against a gold bokeh photograph, all
+ * four toggles on, four candidates indistinguishable from the live page. The
+ * brief asked for a different visual world and every other sentence said
+ * nothing may change.
+ *
+ * So there is a precedence order and it is stated ONCE, not bolted onto each
+ * facet as a caveat: the brief beats the toggles, and the toggles beat the
+ * page as it stands. A brief that asks for nothing in particular — the empty
+ * brief's neutral head — outranks nothing, so everything stays kept. This is
+ * the same rule the service states in its retain clause
+ * (`workers/api/src/create/retain.ts`), so the concept and the retain clause
+ * cannot tell the model two different things.
+ *
+ * IT IS THE SHORT FORM HERE ON PURPOSE. Every character this harness spends is
+ * a character taken off the brief a visitor may type
+ * (`IMPROVE_DIRECTION_MAX_CHARACTERS` below), and the service states the same
+ * rule at full length in the retain clause of the very same prompt. So the
+ * concept carries the rule, not the essay.
+ */
+const PRECEDENCE_RULE = 'These are conservation defaults, not a freeze:'
+    + ' the brief above outranks them, and they outrank the page as it stands.';
+const CONTENT_CLAUSE = {
+    keep: 'Keep every real piece of content, data, and control the page carries: say the same things, in whatever arrangement serves them best, and invent nothing.',
+    free: 'The words may be rewritten and re-sequenced, but every fact the page states — what the product is, its claims, its numbers, its offers, and every control it gives a person — must still be present and still be true; invent no product facts, features, prices, or data.',
+};
+/**
+ * THE BRIEF IS THE HEAD, NOT A LABELLED FIELD.
+ *
+ * Both templates that consume a concept put it in a `for <noun phrase>` slot
+ * or after a label of their own: the draft prompt reads "Create one
+ * distinctive desktop interface for {concept}." and the improve generation
+ * prompt reads "Improvement direction: {concept}". A concept that carried its
+ * own `Direction: ` label produced "for Direction: A modern minimal saas …"
+ * and "Improvement direction: Direction: …" — one label too many, and a head
+ * that is not a noun phrase. So the brief leads bare, and with no brief the
+ * head is the run's own subject.
+ */
+const NO_BRIEF_HEAD = "a better version of this product's own page";
+/**
+ * THE BRIEF NEEDS AN END. Paragraph breaks do not survive the wire: the
+ * service normalizes every run of whitespace to a single space before it
+ * measures or stores a concept (`cleanText`, workers/api validation), so the
+ * blank line this harness used to put around the brief reached the model as
+ * one space. With the brief leading and a mandate right behind it, a brief
+ * that does not punctuate itself would run straight into that mandate.
+ */
+const terminated = (steering) => (/[.!?:;]$/u.test(steering) ? steering : `${steering}.`);
+/**
+ * The steering limit must not depend on the toggles, or a brief a visitor
+ * typed would be refused by flipping a switch. Reserve the LONGEST assembly —
+ * plus the terminator a brief may be given — so every retain set accepts the
+ * same brief.
+ */
+const longest = (choice) => (Math.max(choice.keep.length, choice.free.length));
+const RESERVED_CONCEPT_CHARACTERS = 1 + BRAND_CLAUSE.length + PRECEDENCE_RULE.length
+    + longest(LAYOUT_MANDATE) + longest(STYLE_MANDATE) + longest(CONTENT_CLAUSE) + 8;
+/** The real steering limit after reserving room for the mandatory harness. */
+export const IMPROVE_DIRECTION_MAX_CHARACTERS = MAX_CONCEPT_CHARACTERS - RESERVED_CONCEPT_CHARACTERS;
+/** Where cut detail belongs, stated once for the refusal and the skill. */
+export const IMPROVE_DIRECTION_TRIM_HINT = 'Keep the intended hierarchy, rhythm, typography,'
+    + ' surfaces, color, controls, and mood.';
+/**
+ * F9 found that detailed, style-anchored direction reliably beats a vague
+ * "make it better" instruction. Naming an empty or thin region as the defect
+ * did the opposite: the image model filled it with invented product content.
+ */
+const FABRICATION_TRIGGER = /\b(?:empty|emptiness|underfilled|under-filled|thin[ -]content|lack of content|missing content|dead space|blank (?:area|region|half|section))\b/iu;
+export const buildImproveConcept = (direction, retain = DEFAULT_IMPROVE_RETAIN) => {
+    const steering = direction?.replace(/\s+/gu, ' ').trim() ?? '';
+    // F7 (wave-2, 2026-09-03): naming only the cap cost two lanes their first
+    // command each — the refusal has to name the length of what was written, so
+    // the direction can be fixed in one edit rather than counted by hand.
+    if (conceptCharacterCount(steering) > IMPROVE_DIRECTION_MAX_CHARACTERS) {
+        throw new ImproveRefusal(conceptOverLimitMessage({
+            flag: '--direction',
+            raw: direction ?? '',
+            normalized: steering,
+            limit: IMPROVE_DIRECTION_MAX_CHARACTERS,
+            because: `improve reserves the other ${RESERVED_CONCEPT_CHARACTERS} of the`
+                + ` ${MAX_CONCEPT_CHARACTERS}-character concept for its retain mandates and`
+                + ' no-invention guardrails, so --direction is what is left.',
+            trimHint: IMPROVE_DIRECTION_TRIM_HINT,
+        }), 'improve_direction_too_long');
+    }
+    if (FABRICATION_TRIGGER.test(steering)) {
+        throw new ImproveRefusal('--direction must describe the intended style and hierarchy, not emptiness or thin content;'
+            + ' naming a content void invites fabricated UI.', 'improve_direction_emptiness');
+    }
+    const pick = (facet, choice) => (improveRetainKeeps(retain, facet) ? choice.keep : choice.free);
+    // With nothing kept there is no conservation for the brief to outrank, so
+    // the rule would be a sentence about nothing.
+    const keepsAnything = IMPROVE_RETAIN_FACETS.some((facet) => improveRetainKeeps(retain, facet));
+    const concept = [
+        terminated(steering || NO_BRIEF_HEAD),
+        [pick('layout', LAYOUT_MANDATE), pick('style', STYLE_MANDATE)].join(' '),
+        [
+            ...(improveRetainKeeps(retain, 'assets') ? [BRAND_CLAUSE] : []),
+            pick('content', CONTENT_CLAUSE),
+        ].join(' '),
+        ...(keepsAnything ? [PRECEDENCE_RULE] : []),
+    ].join('\n\n');
+    return readConceptValue({
+        value: concept,
+        flag: '--direction',
+        trimHint: IMPROVE_DIRECTION_TRIM_HINT,
+    });
+};
+//# sourceMappingURL=improve-concept.js.map

package/dist/improve-core/improve-concept.js.map

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

package/dist/improve-core/improve-discovery.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Page discovery policy for improve: which same-origin pages a site's root
+ * claims are its key screens, and in what order.
+ *
+ * ONE RANKER, TWO HOSTS. The hosted capture service renders the root in
+ * Playwright and collects layout facts (`collectRenderedLinksInPage`); the CLI
+ * reads the root's HTML and collects the structural facts a parsed document
+ * can state (`collectLinksFromDocument`). Both hand the same fact shape to
+ * `rankRenderedLinks`, so the two products cannot disagree about ordering
+ * policy — only about how much the page told them.
+ *
+ * WHY RANK AT ALL. Scoping discovery to `nav`/`header`/`footer` loses whole
+ * sites: chargedesk.com states 112 same-origin links, every one of them in
+ * div chrome, and landmark-scoped discovery captured the root alone (owner
+ * report 2026-09-02). Nothing is dropped here; links are ordered and the
+ * caller's `maxPages` cap decides how deep it goes.
+ *
+ * Every fact is one the page declared or the browser measured — no guessing
+ * at a link's importance from its text (CLAUDE.md item 8).
+ */
+/** Pages captured for a site when the caller states no cap (root included). */
+export declare const IMPROVE_DISCOVERY_DEFAULT_MAX_PAGES = 5;
+/**
+ * Landmark chrome: where a site states its own key screens. Mirrored as a
+ * literal inside `collectRenderedLinksInPage` because Playwright serializes
+ * that function into the page — see the note there.
+ */
+export declare const CHROME_LANDMARK_SELECTOR = "nav, header, footer, [role=\"navigation\"], [role=\"banner\"], [role=\"contentinfo\"]";
+/** What one anchor told us. Absent facts mean "not measured", never "false". */
+export type DiscoveredLinkFacts = {
+    href: string;
+    /** Inside a landmark element (`CHROME_LANDMARK_SELECTOR`). */
+    chrome?: boolean;
+    /** Document-space top of the anchor's rect; absent when nothing laid the page out. */
+    y?: number;
+    /** Rendered with a non-zero box; absent when nothing laid the page out. */
+    visible?: boolean;
+};
+export type DiscoveredLinkCollection = {
+    /** Full document height, so the bottom band can be measured from the end. */
+    docHeight: number;
+    links: DiscoveredLinkFacts[];
+};
+/**
+ * Runs inside the rendered page: every anchor with its landmark and layout
+ * facts. Playwright serializes this function, so it must be self-contained —
+ * no module-scope references survive `page.evaluate`. The landmark selector is
+ * therefore repeated here as a literal; `improve-discovery.test.ts` asserts it
+ * still matches `CHROME_LANDMARK_SELECTOR`.
+ */
+export declare const collectRenderedLinksInPage: () => unknown;
+/**
+ * The minimum a parsed (unrendered) document has to offer. Typed structurally
+ * so a `linkedom` document satisfies it without this pure module importing a
+ * DOM implementation.
+ */
+export type StaticAnchorElement = {
+    getAttribute: (name: string) => string | null | undefined;
+    closest: (selectors: string) => unknown;
+};
+export type StaticLinkDocument = {
+    /** `ArrayLike`, not `Iterable`: a `linkedom` NodeList satisfies the former. */
+    querySelectorAll: (selectors: string) => ArrayLike<StaticAnchorElement>;
+};
+/**
+ * The same facts from a parsed document: landmark membership is declared in
+ * the markup, position and visibility are not, so they are left absent rather
+ * than invented. Absent position ranks a link in the body tier, where document
+ * order decides — the only positional fact static HTML actually states.
+ */
+export declare const collectLinksFromDocument: (document: StaticLinkDocument) => DiscoveredLinkCollection;
+/**
+ * Orders links by how likely they are to be a key screen: landmark chrome
+ * first, then the top band (div headers), then the bottom band (div footers),
+ * then body links — visible before hidden within a tier, account plumbing
+ * last. Document order breaks every remaining tie.
+ *
+ * Accepts a collection, a bare fact list, or plain href strings (no facts →
+ * body tier, document order), so a caller that measured nothing still works.
+ */
+export declare const rankRenderedLinks: (input: DiscoveredLinkCollection | readonly DiscoveredLinkFacts[] | readonly string[] | null | undefined) => string[];
+/** Homepage first, then ranked same-origin links, one per pathname, capped. */
+export declare const discoverSameOriginPages: (rootUrl: string, hrefs: readonly string[], maxPages?: number) => string[];
+//# sourceMappingURL=improve-discovery.d.ts.map

package/dist/improve-core/improve-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-discovery.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-discovery.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,0FAC8C,CAAC;AAQpF,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,QAAO,OAY7C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,+EAA+E;IAC/E,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC,mBAAmB,CAAC,CAAC;CACzE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,kBAAkB,KAAG,wBAQvE,CAAC;AAkBF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,wBAAwB,GAAG,SAAS,mBAAmB,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,KACtG,MAAM,EA0BR,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,OAAO,SAAS,MAAM,EAAE,EACxB,WAAU,MAA4C,KACrD,MAAM,EAuBR,CAAC"}