@voxgig/sdkgen 4.16.0 → 4.17.1

package/src/helpers/modelcheck.ts

@@ -33,6 +33,8 @@
 //      project's own file, not the package's.
 
 import { Aontu } from 'aontu'
+import { createRequire } from 'node:module'
+import Path from 'node:path'
 
 import { schemaFile } from './shipped'
 
@@ -112,8 +114,8 @@ function slashComments(text: string): { line: number, text: string }[] {
 // A FRESH INSTANCE each time: the option call mutates the instance's jsonic,
 // so a cached one would leak its configuration into the bare compile that is
 // deliberately paired with it.
-function strictAontu(): any {
-  const aontu: any = new Aontu()
+function strictAontu(options?: any): any {
+  const aontu: any = new Aontu(options)
   aontu.lang.jsonic.options({ comment: { def: { slash: null, multi: null } } })
   return aontu
 }
@@ -186,7 +188,12 @@ function compileModel(
     includeLine(schemaFile()) + '\n' + src : src
 
   try {
-    const aontu = false === opts?.strict ? new Aontu() : strictAontu()
+    // Resolve package includes from the model being checked, including native
+    // package self-references. The SDK toolchain's dependencies are unrelated.
+    const localRequire = Object.assign(createRequire(Path.resolve(path)), { main: require.main })
+    // Aontu forwards this runtime resolver option to Lang; its public type omits it.
+    const options: any = { require: localRequire }
+    const aontu = false === opts?.strict ? new Aontu(options) : strictAontu(options)
     const model = aontu.generate(text, { path, errs })
 
     return {

package/src/helpers/shipped.ts

@@ -9,9 +9,8 @@
 // installation doing the checking, which is this one.
 //
 // `__dirname` is `dist/helpers` in the shipped package, so the package root is
-// two levels up. npm can only ship files under that root, which is why the
-// canonical `model/` is mirrored into `ts/model/` (the model-mirror guard
-// fails on drift).
+// two levels up. The authoritative schema lives directly in its model/
+// directory, in both a checkout and an installed package.
 
 import Path from 'node:path'
 

package/src/helpers/testPolicy.ts

@@ -1,52 +1,14 @@
-// How strict the generated LIVE tests are.
-//
-// WHY THIS IS A MODEL DECISION
-//
-// The generated direct tests are deliberately lenient in live mode:
-//
-//   if (setup.live) {
-//     // Live mode is lenient: synthetic IDs frequently 4xx.
-//     if (!result.ok || result.status < 200 || result.status >= 300) {
-//       return                       // <-- passes
-//     }
-//   } else {
-//     assert(result.ok === true)
-//     ...
-//   }
-//
-// That is CORRECT for sdkgen's default case — a fleet SDK generated against
-// an arbitrary third-party public API, where synthetic IDs 4xx constantly and
-// list response shapes vary wildly. Asserting there would mean permanent red.
-//
-// It is WRONG for a project that owns the server it tests against, and those
-// projects had no way to say so. Measured on voxgig-solardemo-sdk: the live
-// TypeScript suite reports 186 pass / 0 fail against the local test app —
-// and 184 pass / 2 fail with the server STOPPED. Only the two entity `basic`
-// flows noticed. A green live run said almost nothing.
-//
-// Gaps that announce themselves as a passing test suite are worse than the
-// ones that break a build.
-
 import { KIT } from '../types'
 
-
-// True when live assertions should match the offline ones. Per-target
-// override first, then the SDK-wide default, then false.
-//
-//   main: kit: test: live: strict: true
-//   main: kit: target: go: test: live: strict: true
+// Live requests assert success by default. This never enables fail-fast:
+// independent tests continue and their framework aggregates the failures.
+// An explicit false preserves the legacy exploratory policy for callers
+// migrating a fleet; it must not be confused with full live verification.
 function liveStrict(model: any, target?: string): boolean {
   const perTarget = null == target ? undefined :
     model?.main?.[KIT]?.target?.[target]?.test?.live?.strict
-
-  if (null != perTarget) {
-    return true === perTarget
-  }
-
-  return true === model?.main?.[KIT]?.test?.live?.strict
+  const configured = perTarget ?? model?.main?.[KIT]?.test?.live?.strict
+  return false !== configured
 }
 
-
-export {
-  liveStrict,
-}
+export { liveStrict }

package/src/sdkgen.ts

@@ -24,8 +24,6 @@ import { SdkGenError, requirePath, isAuthActive, resolveAuthPrefix, isHttpBasicA
 import { Main } from './cmp/Main'
 import { featureApplies, targetFeatures, featureTags, unknownTags, TAGS } from './helpers/applicability'
 import { ExternalTarget } from './cmp/ExternalTarget'
-import { Docs, DocsItem } from './cmp/Docs'
-import { ExternalDocs } from './cmp/ExternalDocs'
 
 import { KIT } from '@voxgig/apidef'
 import { Deploy } from './cmp/Deploy'
@@ -150,7 +148,7 @@ import {
 
 import { cmd_package_check } from './action/check'
 
-import { docs_add } from './action/docs'
+import { edition_add } from './action/edition'
 
 // The verbs, built from the kind registry — see action/dispatch.
 import { ACTION_MAP, actionNames, needsModel } from './action/dispatch'
@@ -350,7 +348,7 @@ function SdkGen(opts: SdkGenOptions) {
     // if it appeared between those checks, the pass could write into content
     // that was never ownership-validated.
     const external: ExternalPlan[] =
-      externalItems(model, root, ['target', 'docs'], externalOverride)
+      externalItems(model, root, ['target'], externalOverride)
         .map((ext) => ({ ...ext, skip: externalSkipReason(ext, fs) }))
 
     // Before ANY file is written, in-tree included: a destination that turns
@@ -363,74 +361,13 @@ function SdkGen(opts: SdkGenOptions) {
 
     showChanges(jopts.log, 'generate-result', jres, Path.dirname(process.cwd()))
 
-    // IN-TREE DOCS, in their own pass over the same root.
-    //
-    // The alternative is one `Kinds()` call in the consumer's `Root.ts` —
-    // which create-sdkgen writes once and never revisits, so every project
-    // scaffolded before the docs kind existed would have to be hand-edited
-    // before `docs add` did anything. A second pass costs one more changes
-    // report and makes the kind work in projects that predate it, which is
-    // the whole point of putting the destinations in packages.
-    //
-    // Items with `output: path` are excluded here and generated by the loop
-    // below, exactly as out-of-tree targets are.
-    const intreedocs = Object.keys(model?.main?.[KIT]?.docs ?? {})
-      .filter((name: string) => {
-        const item = model.main[KIT].docs[name]
-        const path = item?.output?.path
-        return false !== item?.active && (null == path || '' === path)
+    // Docgen owns editions, destinations, templates, text QA and deployment.
+    if (model?.main?.[KIT]?.doc?.active !== false && Object.values(model?.main?.[KIT]?.doc?.edition ?? {})
+      .some((item: any) => item.active !== false)) {
+      const docgenPath = require.resolve('@voxgig/docgen', {
+        paths: [Path.join(root, '.sdk')],
       })
-
-    // AN IN-TREE DOCS ITEM AND A TARGET CANNOT SHARE A NAME.
-    //
-    // `docs` and `target` are separate namespaces — deliberately, so an item
-    // of each may be called `api` — and their `.sdk` trees are nested apart
-    // (`src/cmp/docs/<n>` vs `src/cmp/<n>`), so installing both is fine.
-    //
-    // Their GENERATED destinations are not separate. Both render into
-    // `<sdk-repo>/<name>/`, the docs pass runs second, and jostraca is
-    // last-write-wins — so a docs item named `go` would quietly overwrite the
-    // Go SDK's README, and whatever else the two have in common, leaving a
-    // corrupt SDK and a green run.
-    //
-    // Refused rather than reordered, and refused BEFORE the docs pass writes
-    // anything: this is the in-tree half of the rule `checkExternalFolders`
-    // enforces for out-of-tree destinations, and the fix is the same either
-    // way — give one of them `output: path`, or rename it.
-    const targets: any = model?.main?.[KIT]?.target ?? {}
-
-    for (const name of intreedocs) {
-      const target = targets[name]
-
-      if (null == target || false === target.active) {
-        continue
-      }
-
-      const tpath = target.output?.path
-
-      if (null != tpath && '' !== tpath) {
-        continue
-      }
-
-      throw new SdkGenError(
-        'Docs item "' + name + '" and target "' + name + '" would both ' +
-        'generate into <sdk-project>/' + name + '/.\n' +
-        '  They are separate kinds, so sharing a name is legal — but they ' +
-        'share one output folder, and the docs pass runs second, so it ' +
-        'would overwrite the SDK.\n' +
-        '  Give one of them `output: path`, or rename it.')
-    }
-
-    if (0 < intreedocs.length) {
-      log.info({
-        point: 'generate-docs-start', docs: intreedocs,
-        note: intreedocs.join(', ')
-      })
-
-      const dres = await jostraca.generate(jopts, () => Docs({ model }))
-
-      showChanges(jopts.log, 'generate-docs-result', dres,
-        Path.dirname(process.cwd()))
+      await require(docgenPath).generate({ ...jopts, folder: root, model })
     }
 
     for (const ext of external) {
@@ -462,12 +399,7 @@ function SdkGen(opts: SdkGenOptions) {
 
       const sdkrelpath = externalSdkRel(ext, root, log)
 
-      const eres = 'docs' === ext.kind ?
-        await jostraca.generate(
-          { ...jopts, folder: ext.folder },
-          () => ExternalDocs({
-            model, item: ext.target, cmpfolder: folder, sdkrelpath,
-          })) :
+      const eres =
         await jostraca.generate(
         { ...jopts, folder: ext.folder },
         () => ExternalTarget({
@@ -628,10 +560,10 @@ function SdkGen(opts: SdkGenOptions) {
 
   // The third kind. sdkgen ships no docs items, so every ref here is a path
   // into a package — see action/docs.
-  const docs = {
+  const edition = {
     add: async (items: string[]): Promise<ActionResult> => {
       const ctx = resolveActionContext()
-      return docs_add(items, ctx)
+      return edition_add(items, ctx)
     }
   }
 
@@ -680,7 +612,7 @@ function SdkGen(opts: SdkGenOptions) {
     generate,
     action,
     check,
-    docs,
+    edition,
     target,
     feature,
 
@@ -822,16 +754,8 @@ function resolveExternalOverride(
 }
 
 
-// Every item, of every kind, that generates OUTSIDE the SDK repo.
-//
-// Keyed by kind because `docs` needs exactly this and a second copy of it
-// would drift: the out-of-tree rules — a destination must be outside the
-// project, unclaimed, and either empty or previously generated into — are
-// properties of WRITING SOMEWHERE ELSE, not of being a target.
-//
-// The claim map spanning kinds is the load-bearing part: a docs item and a
-// target pointed at the same folder would otherwise silently overwrite each
-// other, in whatever order the passes happen to run.
+// SDK targets can generate into separately owned repositories. Documentation
+// editions are confined to this SDK repository and are handled by docgen.
 function externalItems(
   model: any, folder: string, kinds: string[],
   override: Record<string, ExternalOverride>,
@@ -841,10 +765,7 @@ function externalItems(
 
     return Object.keys(items).sort()
       .map((name: string) => {
-        // Keyed by NAME, across kinds: a docs item and a target that share a
-        // name share an override. They already share an output folder if both
-        // are pointed at one (the claim map refuses that), so a name that
-        // means two things is a problem before it reaches here.
+        // Overrides are keyed by installed target name.
         const ov = override[name] || {}
 
         // A SHALLOW CLONE, so the override never writes back into the model.

package/src/utility.ts

@@ -381,8 +381,14 @@ function withPointParts(op: any): any {
   each(op, (o: any, opname: string) => {
     out[opname] = null == o || null == o.points ? o : {
       ...o,
-      points: each(o.points).map((pt: any) =>
-        null == pt ? pt : { ...pt, parts: pointParts(pt) }),
+      points: each(o.points).map((pt: any) => {
+        if (null == pt) return pt
+        // Contracts feed test generation directly from the model. Keeping
+        // them in every runtime entity also retains entire request/response
+        // schemas in clones and debug output, exhausting large SDKs' memory.
+        const { contract, ...runtimePoint } = pt
+        return { ...runtimePoint, parts: pointParts(pt) }
+      }),
     }
   })
 

package/dist/action/docs.d.ts

@@ -1,4 +0,0 @@
-import type { ActionContext, ActionResult } from '../types';
-declare function action_docs(args: string[], actx: ActionContext): Promise<ActionResult>;
-declare function docs_add(docs: string[], actx: ActionContext): Promise<ActionResult>;
-export { action_docs, docs_add, };

package/dist/action/docs.js.map

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

package/dist/cmp/Docs.d.ts

@@ -1,4 +0,0 @@
-declare function prepareModel(model: any, ctx$: any): void;
-declare const DocsItem: import("jostraca").Component;
-declare const Docs: import("jostraca").Component;
-export { Docs, DocsItem, prepareModel, };

package/dist/cmp/Docs.js

@@ -1,98 +0,0 @@
-"use strict";
-// GENERATING A DOCS ITEM. See docs/design/sdkgen-packages.md §20.3.
-//
-// A docs item is dispatched by the same convention a target is —
-// `cmp/docs/<n>/Main_<n>` — so an item's package supplies the emitter and
-// sdkgen supplies only the call.
-//
-// WHY THIS IS NOT RENDERED BY THE CONSUMER'S Root.ts
-//
-// A project's `Root.ts` is written once, by create-sdkgen, and is never
-// touched again (doctor has an `unwired` category precisely because of it).
-// So a kind introduced later can reach generation in one of two ways: every
-// existing project edits its Root, or sdkgen runs the kind's own pass. The
-// second is what happens here — `docs add` in a project scaffolded years ago
-// generates with no scaffold change at all, which is the whole point of
-// putting the destinations in packages.
-//
-// The cost is honest and small: a second `generate()` call over the same
-// root, so the changes report arrives in two parts.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocsItem = exports.Docs = void 0;
-exports.prepareModel = prepareModel;
-const jostraca_1 = require("jostraca");
-const utility_1 = require("../utility");
-const stdrep_1 = require("../helpers/stdrep");
-const types_1 = require("../types");
-// The model preamble every pass performs before rendering: the case-variant
-// name constants (`Name`, `NAME`, …) and the ProjectName replacement map that
-// template substitution reads.
-//
-// Done HERE rather than relied upon, because a docs pass does NOT go through
-// the consumer's Root — nothing else has set `ctx$.model`, and when there are
-// out-of-tree items the Root was handed a FILTERED COPY, so the preamble it
-// performed did not touch this object at all.
-function prepareModel(model, ctx$) {
-    ctx$.model = model;
-    model.const = model.const || { name: model.name };
-    (0, jostraca_1.names)(model.const, model.name);
-    if (null == model.const.year) {
-        model.const.year = new Date().getFullYear();
-    }
-    (0, jostraca_1.names)(model, model.name);
-    ctx$.stdrep = ctx$.stdrep || {};
-    (0, jostraca_1.names)(ctx$.stdrep, model.Name, 'Project' + 'Name');
-}
-// One item: its emitter, called with the item and the shared replace map.
-//
-// No Folder here — WHERE it lands is the caller's business, because that is
-// exactly what differs between the two passes: in-tree the item owns
-// `<sdk-repo>/<name>/`, out-of-tree the destination IS the item's root.
-const DocsItem = (0, jostraca_1.cmp)(function DocsItem(props) {
-    const { item, ctx$ } = props;
-    const log = ctx$.log;
-    const model = props.model ?? ctx$.model;
-    const stdrep = (0, stdrep_1.ensureStdrep)(ctx$);
-    // The MODEL KEY is the fallback, and it is not paranoia: `name` comes from
-    // the base schema's `name: key()`, so an item whose project has not
-    // included that schema — or whose own definition omits it — reached
-    // `require('cmp/docs/undefined/Main_undefined')`, a message naming nothing
-    // the author wrote. Seen in the first real install of a docs package.
-    const name = item.name ?? item.key$;
-    if (null == name || '' === name) {
-        throw new Error('Docs item has no name and no model key, so its component cannot be ' +
-            'located: ' + JSON.stringify(Object.keys(item ?? {})));
-    }
-    const Main_docs = (0, utility_1.requirePath)(ctx$, `cmp/docs/${name}/Main_${name}`);
-    Main_docs['Main']({ model, docs: item, stdrep });
-    log.info({
-        point: 'generate-docs', docs: name, note: 'docs:' + name
-    });
-});
-exports.DocsItem = DocsItem;
-// Every IN-TREE docs item, each in its own folder.
-//
-// Items with `output: path` are excluded: they get their own pass rooted at
-// that path, and rendering them here as well would ALSO write them into
-// `<sdk-repo>/<name>/` — the same reason `withoutExternal` exists for
-// targets.
-const Docs = (0, jostraca_1.cmp)(function Docs(props) {
-    const { ctx$ } = props;
-    const model = props.model ?? ctx$.model;
-    prepareModel(model, ctx$);
-    const items = model?.main?.[types_1.KIT]?.docs ?? {};
-    (0, jostraca_1.each)(items, (item) => {
-        if (false === item.active) {
-            return;
-        }
-        const path = item.output?.path;
-        if (null != path && '' !== path) {
-            return;
-        }
-        const name = item.name ?? item.key$;
-        (0, jostraca_1.names)(item, name);
-        (0, jostraca_1.Folder)({ name }, () => DocsItem({ item }));
-    });
-});
-exports.Docs = Docs;
-//# sourceMappingURL=Docs.js.map

package/dist/cmp/Docs.js.map

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

package/dist/cmp/ExternalDocs.d.ts

@@ -1,2 +0,0 @@
-declare const ExternalDocs: import("jostraca").Component;
-export { ExternalDocs };

package/dist/cmp/ExternalDocs.js

@@ -1,43 +0,0 @@
-"use strict";
-// The Root for a DOCS item that generates outside the SDK repo
-// (`main: kit: docs: <n>: output: path`).
-//
-// Out of tree is the NORMAL case for a docs item, not the exception it is for
-// a target: a documentation site usually has its own repo, and in-tree it
-// would collide with the SDK repo's own README and CI workflows.
-//
-// The two facts that make this a separate `generate()` pass rather than a
-// folder are the ones `ExternalTarget` documents at length: jostraca's
-// `FileHandler.validName` refuses a `..` segment in a folder name (the guard
-// that keeps generation inside the tree it was pointed at, not an oversight
-// to route around), and the output root is `jopts.folder` PER CALL — so
-// writing somewhere else means another call.
-//
-// No Folder wraps the item: the destination IS the site, so its files go at
-// the root of the output path.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExternalDocs = void 0;
-const jostraca_1 = require("jostraca");
-const Docs_1 = require("./Docs");
-const ExternalDocs = (0, jostraca_1.cmp)(function ExternalDocs(props) {
-    const { model, item, cmpfolder, sdkrelpath } = props;
-    const ctx$ = props.ctx$;
-    // Components live in the PROJECT, not in the repo being written to. This
-    // pass has retargeted jostraca's output folder, which is what requirePath
-    // otherwise resolves against — see utility.resolvePath. Losing this line
-    // makes the pass look for components under the DESTINATION.
-    ctx$.cmpfolder = cmpfolder;
-    // The path from the destination back to the SDK project, for a site that
-    // sits beside the SDK in a known layout and needs to name it.
-    ctx$.sdkrelpath = sdkrelpath;
-    // The same preamble the in-tree pass performs — one definition, both
-    // callers, because a project whose ONLY docs item is out of tree must
-    // generate exactly as one with both.
-    (0, Docs_1.prepareModel)(model, ctx$);
-    (0, jostraca_1.Project)({}, () => {
-        (0, jostraca_1.names)(item, item.name ?? item.key$);
-        (0, Docs_1.DocsItem)({ item });
-    });
-});
-exports.ExternalDocs = ExternalDocs;
-//# sourceMappingURL=ExternalDocs.js.map

package/dist/cmp/ExternalDocs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExternalDocs.js","sourceRoot":"","sources":["../../src/cmp/ExternalDocs.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,0CAA0C;AAC1C,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,iEAAiE;AACjE,EAAE;AACF,0EAA0E;AAC1E,uEAAuE;AACvE,6EAA6E;AAC7E,4EAA4E;AAC5E,wEAAwE;AACxE,6CAA6C;AAC7C,EAAE;AACF,4EAA4E;AAC5E,+BAA+B;;;AAE/B,uCAA8C;AAI9C,iCAA+C;AAG/C,MAAM,YAAY,GAAG,IAAA,cAAG,EAAC,SAAS,YAAY,CAAC,KAAU;IACvD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IAEvB,yEAAyE;IACzE,0EAA0E;IAC1E,yEAAyE;IACzE,4DAA4D;IAC5D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAE1B,yEAAyE;IACzE,8DAA8D;IAC9D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAE5B,qEAAqE;IACrE,sEAAsE;IACtE,qCAAqC;IACrC,IAAA,mBAAY,EAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAEzB,IAAA,kBAAO,EAAC,EAAE,EAAE,GAAG,EAAE;QACf,IAAA,gBAAK,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAA;QAEnC,IAAA,eAAQ,EAAC,EAAE,IAAI,EAAE,CAAC,CAAA;IACpB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;QAIA,YAAY"}

package/src/cmp/Docs.ts

@@ -1,125 +0,0 @@
-// GENERATING A DOCS ITEM. See docs/design/sdkgen-packages.md §20.3.
-//
-// A docs item is dispatched by the same convention a target is —
-// `cmp/docs/<n>/Main_<n>` — so an item's package supplies the emitter and
-// sdkgen supplies only the call.
-//
-// WHY THIS IS NOT RENDERED BY THE CONSUMER'S Root.ts
-//
-// A project's `Root.ts` is written once, by create-sdkgen, and is never
-// touched again (doctor has an `unwired` category precisely because of it).
-// So a kind introduced later can reach generation in one of two ways: every
-// existing project edits its Root, or sdkgen runs the kind's own pass. The
-// second is what happens here — `docs add` in a project scaffolded years ago
-// generates with no scaffold change at all, which is the whole point of
-// putting the destinations in packages.
-//
-// The cost is honest and small: a second `generate()` call over the same
-// root, so the changes report arrives in two parts.
-
-import { cmp, each, names, Folder } from 'jostraca'
-
-import { requirePath } from '../utility'
-
-import { ensureStdrep } from '../helpers/stdrep'
-
-import { KIT } from '../types'
-
-
-// The model preamble every pass performs before rendering: the case-variant
-// name constants (`Name`, `NAME`, …) and the ProjectName replacement map that
-// template substitution reads.
-//
-// Done HERE rather than relied upon, because a docs pass does NOT go through
-// the consumer's Root — nothing else has set `ctx$.model`, and when there are
-// out-of-tree items the Root was handed a FILTERED COPY, so the preamble it
-// performed did not touch this object at all.
-function prepareModel(model: any, ctx$: any) {
-  ctx$.model = model
-
-  model.const = model.const || { name: model.name }
-  names(model.const, model.name)
-  if (null == model.const.year) {
-    model.const.year = new Date().getFullYear()
-  }
-  names(model, model.name)
-
-  ctx$.stdrep = ctx$.stdrep || {}
-  names(ctx$.stdrep, model.Name, 'Project' + 'Name')
-}
-
-
-// One item: its emitter, called with the item and the shared replace map.
-//
-// No Folder here — WHERE it lands is the caller's business, because that is
-// exactly what differs between the two passes: in-tree the item owns
-// `<sdk-repo>/<name>/`, out-of-tree the destination IS the item's root.
-const DocsItem = cmp(function DocsItem(props: any) {
-  const { item, ctx$ } = props
-  const log = ctx$.log
-  const model = props.model ?? ctx$.model
-
-  const stdrep = ensureStdrep(ctx$)
-
-  // The MODEL KEY is the fallback, and it is not paranoia: `name` comes from
-  // the base schema's `name: key()`, so an item whose project has not
-  // included that schema — or whose own definition omits it — reached
-  // `require('cmp/docs/undefined/Main_undefined')`, a message naming nothing
-  // the author wrote. Seen in the first real install of a docs package.
-  const name = item.name ?? item.key$
-
-  if (null == name || '' === name) {
-    throw new Error(
-      'Docs item has no name and no model key, so its component cannot be ' +
-      'located: ' + JSON.stringify(Object.keys(item ?? {})))
-  }
-
-  const Main_docs = requirePath(ctx$, `cmp/docs/${name}/Main_${name}`)
-
-  Main_docs['Main']({ model, docs: item, stdrep })
-
-  log.info({
-    point: 'generate-docs', docs: name, note: 'docs:' + name
-  })
-})
-
-
-// Every IN-TREE docs item, each in its own folder.
-//
-// Items with `output: path` are excluded: they get their own pass rooted at
-// that path, and rendering them here as well would ALSO write them into
-// `<sdk-repo>/<name>/` — the same reason `withoutExternal` exists for
-// targets.
-const Docs = cmp(function Docs(props: any) {
-  const { ctx$ } = props
-  const model = props.model ?? ctx$.model
-
-  prepareModel(model, ctx$)
-
-  const items = model?.main?.[KIT]?.docs ?? {}
-
-  each(items, (item: any) => {
-    if (false === item.active) {
-      return
-    }
-
-    const path = item.output?.path
-
-    if (null != path && '' !== path) {
-      return
-    }
-
-    const name = item.name ?? item.key$
-
-    names(item, name)
-
-    Folder({ name }, () => DocsItem({ item }))
-  })
-})
-
-
-export {
-  Docs,
-  DocsItem,
-  prepareModel,
-}