@voxgig/sdkgen 4.15.0 → 4.17.0

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'
@@ -181,6 +179,32 @@ type SdkGenOptions = {
   }
 
   dryrun?: boolean
+
+  // WHERE AN OUT-OF-TREE ITEM GOES, DECIDED AT GENERATE TIME RATHER THAN IN
+  // THE MODEL. Keyed by item name:
+  //
+  //   external: { 'seneca-provider': { path: '../..', sdkrel: '.sdksrc/acme-sdk', enclosing: true } }
+  //
+  // `output: path` in the model is a fact about ONE developer's checkout
+  // layout, and it is committed. The same model generated from a different
+  // layout is the same model — a different INVOCATION of it, not a second
+  // truth to encode — so the second layout belongs here and not in a second
+  // committed value that the two layouts then fight over.
+  //
+  // The case that forced it: a provider repo that carries a tagged checkout
+  // of its SDK in a subfolder and regenerates itself from it. The SDK's own
+  // committed model cannot describe that, because the SDK does not know it
+  // has been cloned into someone else's repo.
+  external?: Record<string, ExternalOverride>
+}
+
+
+// See SdkGenOptions.external. `enclosing` is separate from `path` on
+// purpose — see checkExternalFolders.
+type ExternalOverride = {
+  path?: string
+  sdkrel?: string
+  enclosing?: boolean
 }
 
 
@@ -317,12 +341,14 @@ function SdkGen(opts: SdkGenOptions) {
     // so resolve it ONCE: every destination is compared against it, and a
     // comparison between a relative and an absolute path is meaningless.
     const root = Path.resolve(folder)
+
+    const externalOverride = resolveExternalOverride(opts, log)
     // Snapshot the decision before preflight. In particular, do not check a
     // missing optional destination once for safety and AGAIN before writing:
     // 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'])
+      externalItems(model, root, ['target'], externalOverride)
         .map((ext) => ({ ...ext, skip: externalSkipReason(ext, fs) }))
 
     // Before ANY file is written, in-tree included: a destination that turns
@@ -335,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) {
@@ -434,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({
@@ -600,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)
     }
   }
 
@@ -652,7 +612,7 @@ function SdkGen(opts: SdkGenOptions) {
     generate,
     action,
     check,
-    docs,
+    edition,
     target,
     feature,
 
@@ -700,6 +660,11 @@ type ExternalSpec = {
   target: any
   folder: string
   active: boolean
+
+  // The caller asked, at generate time, to write into a folder that CONTAINS
+  // the SDK project. Never read from the model — see SdkGenOptions.external
+  // and checkExternalFolders.
+  enclosing: boolean
 }
 
 
@@ -721,31 +686,117 @@ type ExternalPlan = ExternalSpec & {
 // An INACTIVE target is still listed: it must be taken out of the in-tree
 // model (see withoutExternal) so that switching it off does not silently
 // relocate it into `<sdk-repo>/<target>/`. The generate loop skips it.
-// Every item, of every kind, that generates OUTSIDE the SDK repo.
+// The generate-time override of where out-of-tree items are written.
+//
+// Two ways in, merged, the environment winning:
 //
-// 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.
+//   opts.external     the caller holds the config — a build script it owns.
+//   SDKGEN_EXTERNAL   JSON, for driving a checkout the caller does NOT own.
 //
-// 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.
+// The environment matters more than it looks. The case this exists for is a
+// repository that carries a tagged checkout of its SDK and regenerates
+// itself from it: the script doing that owns neither the SDK's model nor its
+// `.sdk/build/sdkgen.js`, so any route that requires editing a file inside
+// the checkout means patching someone else's repo on every clone — and the
+// point of the exercise was that the clone is disposable.
+//
+// ONE JSON VARIABLE, not one variable per item per field. Item names carry
+// hyphens (`seneca-provider`), so a
+// `SDKGEN_EXTERNAL_SENECA_PROVIDER_PATH` scheme needs a name mangling with
+// no inverse: `a-b` and `a_b` collide, and nothing can tell which was meant.
+function resolveExternalOverride(
+  opts: SdkGenOptions, log: any,
+): Record<string, ExternalOverride> {
+  const declared = opts.external || {}
+  const raw = process.env.SDKGEN_EXTERNAL
+
+  if (null == raw || '' === raw.trim()) {
+    return declared
+  }
+
+  let parsed: any
+
+  try {
+    parsed = JSON.parse(raw)
+  }
+  catch (err: any) {
+    throw new SdkGenError(
+      'SDKGEN_EXTERNAL is not valid JSON: ' + (err?.message || err) +
+      '\n  Expected an object keyed by item name, for example:' +
+      '\n    {"seneca-provider":{"path":"../..","sdkrel":".sdksrc/acme-sdk","enclosing":true}}' +
+      '\n  Got: ' + raw.slice(0, 200))
+  }
+
+  if (null == parsed || 'object' !== typeof parsed || Array.isArray(parsed)) {
+    throw new SdkGenError(
+      'SDKGEN_EXTERNAL must be a JSON OBJECT keyed by item name, for example:' +
+      '\n    {"seneca-provider":{"path":"../..","sdkrel":".sdksrc/acme-sdk","enclosing":true}}' +
+      '\n  Got: ' + raw.slice(0, 200))
+  }
+
+  const merged: Record<string, ExternalOverride> = { ...declared }
+
+  for (const name of Object.keys(parsed)) {
+    merged[name] = { ...(declared[name] || {}), ...(parsed[name] || {}) }
+  }
+
+  // LOUDLY. Generation writing somewhere other than the model says is
+  // exactly the thing whose only previous trace was one INFO line naming a
+  // resolved folder, and that cost a silent green run that emitted nothing.
+  const named = Object.keys(parsed).sort()
+  log.info({
+    point: 'external-override',
+    items: named.join(','),
+    note: 'SDKGEN_EXTERNAL overrides the output of: ' + named.join(', '),
+  })
+
+  return merged
+}
+
+
+// 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>,
 ): ExternalSpec[] {
   return kinds.flatMap((kind: string) => {
     const items = model?.main?.[KIT]?.[kind] || {}
 
     return Object.keys(items).sort()
-      .map((name: string) => ({ kind, name, target: items[name] }))
+      .map((name: string) => {
+        // Overrides are keyed by installed target name.
+        const ov = override[name] || {}
+
+        // A SHALLOW CLONE, so the override never writes back into the model.
+        // The in-tree pass still reads it, and `target add` still round-trips
+        // it to disk; an override is for THIS RUN. Nothing compares these by
+        // identity — withoutExternal keys by kind:name.
+        const output = { ...(items[name]?.output || {}) }
+
+        if (null != ov.path && '' !== ov.path) {
+          output.path = ov.path
+        }
+        if (null != ov.sdkrel && '' !== ov.sdkrel) {
+          output.sdkrel = ov.sdkrel
+        }
+
+        return { kind, name, target: { ...items[name], output }, ov }
+      })
+      // AFTER the override, so it can send an item out of tree that the
+      // model generates in tree. The machinery needs nothing else for that:
+      // withoutExternal takes it out of the in-tree pass by kind:name, and
+      // every destination guard below runs on it either way.
       .filter((t: any) => {
-        const path = t.target?.output?.path
+        const path = t.target.output.path
         return null != path && '' !== path
       })
       .map((t: any) => ({
-        ...t,
+        kind: t.kind,
+        name: t.name,
+        target: t.target,
         folder: Path.resolve(folder, String(t.target.output.path)),
+        enclosing: true === t.ov.enclosing,
         active: false !== t.target.active,
       }))
   })
@@ -848,11 +899,31 @@ function checkExternalFolders(external: ExternalPlan[], root: string, fs: any) {
         ext.name + '/.')
     }
 
-    if (folderContains(ext.folder, root)) {
+    // A DESTINATION THAT CONTAINS THE PROJECT is what `..` produces, and it
+    // is refused — UNLESS the caller said at generate time that it meant it.
+    //
+    // The legitimate case is a repository that carries a tagged checkout of
+    // its SDK in a subfolder and regenerates itself from it: the SDK then
+    // sits INSIDE its own output folder, and `output: path` resolves to an
+    // ancestor. Generation writes the files its components declare and
+    // prunes nothing, so the checkout survives its own run.
+    //
+    // `enclosing` is a separate flag from `path` on purpose, and only the
+    // override can set it — never the model. Overriding a path is one
+    // decision; writing over the directory holding the project is a second,
+    // much worse thing to get wrong, and it fails silently: a typo'd `..`
+    // fabricates a package tree over an unrelated repo, overwriting its
+    // package.json, README, LICENSE and CI in place. Saying it twice is the
+    // cost of keeping the typo caught for everyone who did not ask.
+    if (folderContains(ext.folder, root) && !ext.enclosing) {
       throw new SdkGenError(
         'External output path contains the SDK project.\n  ' + where +
         '\n  Generation would write this package over the directory holding ' +
-        'the SDK project itself.')
+        'the SDK project itself.' +
+        '\n  If that is deliberate — the SDK is checked out INSIDE its own ' +
+        'output folder, and regenerates it — say so at generate time with ' +
+        '`enclosing: true` in the ' + ext.name + ' entry of SDKGEN_EXTERNAL ' +
+        'or the `external` build option. It cannot be set in the model.')
     }
 
     // ACROSS KINDS, not within one: `docs` and `target` are separate
@@ -876,6 +947,20 @@ function checkExternalFolders(external: ExternalPlan[], root: string, fs: any) {
 
     if (true === ext.target.output.adopt) continue
 
+    // AN ENCLOSING DESTINATION ALWAYS HOLDS CONTENT: the SDK project itself
+    // is inside it, along with whatever else the repository carries. The
+    // emptiness check can therefore only ever say "yes, it has content", so
+    // it carries no information here — and requiring `output: adopt` on top
+    // of the opt-in would put the layout back in the SDK's COMMITTED model,
+    // which is the coupling the generate-time override exists to break. An
+    // SDK cloned into a repository it regenerates cannot have anticipated
+    // being cloned there.
+    //
+    // The containment check above is what guards this case, and it is
+    // stricter: it refuses unless the caller named this item and said
+    // `enclosing` for it.
+    if (ext.enclosing) continue
+
     const entries: string[] = fs.readdirSync(ext.folder)
       .map((entry: any) => String(entry))
 
@@ -936,6 +1021,17 @@ function externalSdkRel(ext: ExternalSpec, root: string, log: any): string {
   // earlier one is a directory ABOVE it, which nothing in the model declares.
   const named = derived.split('/').filter((seg) => '..' !== seg)
 
+  // NOT WHEN THE OUTPUT ENCLOSES THE PROJECT. There the walk back descends
+  // rather than ascends — `.sdksrc/acme-sdk` names the subfolder holding the
+  // checkout and then the checkout, both INSIDE the output folder and both
+  // chosen by whoever asked for this layout. Nothing is above anything, so
+  // the warning's complaint (directories the model does not declare) is
+  // false, and its advice (declare `output: sdkrel`) would put one layout's
+  // path into the other's committed model.
+  if (ext.enclosing) {
+    return derived
+  }
+
   if (1 < named.length) {
     log.warn({
       point: 'external-sdkrel-derived', target: ext.name, sdkrel: derived,

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":";AAAA,6EAA6E;AAC7E,EAAE;AACF,sBAAsB;AACtB,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,yEAAyE;AACzE,yEAAyE;AACzE,gEAAgE;AAChE,EAAE;AACF,yBAAyB;AACzB,EAAE;AACF,wEAAwE;AACxE,EAAE;AACF,yEAAyE;AACzE,+DAA+D;AAC/D,gDAAgD;AAChD,oEAAoE;AACpE,4EAA4E;AAC5E,qEAAqE;AACrE,8EAA8E;AAC9E,0CAA0C;AAC1C,4EAA4E;AAC5E,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,2DAA2D;AAC3D,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,+DAA+D;AAC/D,EAAE;AACF,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAC9E,mCAAmC;;QAgRjC,WAAW;QACX,QAAQ;AA/QV,uCAA2D;AAO3D,wCAAwC;AAExC,8CAAwD;AAExD,0CAA0C;AAE1C,iCAA0D;AAG1D,uCAA6C;AAE7C,qCAA4D;AAE5D,qCAAyE;AAGzE,wEAAwE;AACxE,6EAA6E;AAC7E,4EAA4E;AAC5E,QAAQ;AACR,MAAM,SAAS,GAAG,kBAAkB,CAAA;AAEpC,SAAS,OAAO;IACd,MAAM,GAAG,GAAG,IAAA,gBAAS,EAAC,MAAM,EAAE,SAAS,CAAC;SACrC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,CAAC,CAAA;IAE7C,OAAO,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;AACrE,CAAC;AAGD,MAAM,OAAO,GAAQ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;IACtD,GAAG,EAAE,YAAY;CAClB,CAAC,CAAA;AAGF,KAAK,UAAU,WAAW,CACxB,IAAc,EAAE,IAAmB;IAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE5B,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,qBAAW,CACnB,oBAAoB,GAAG,OAAO,GAAG,cAAc;YAC/C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AAC9B,CAAC;AAGD,KAAK,UAAU,YAAY,CACzB,IAAc,EAAE,IAAmB;IAEnC,OAAO,QAAQ,CAAC,IAAA,sBAAa,EAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;AAC5C,CAAC;AAGD,YAAY;AACZ,KAAK,UAAU,QAAQ,CACrB,IAAc,EAAE,IAAmB;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;IAE9B,MAAM,IAAI,GAAG;QACX,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;QACxC,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,mEAAmE;YACnE,iEAAiE;YACjE,OAAO,EAAE,IAAA,oBAAW,EAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SACzD;QACD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,yEAAyE;QACzE,0EAA0E;QAC1E,iEAAiE;QACjE,aAAa;QACb,OAAO,EAAE;YACP,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;SAC3B;QACD,oEAAoE;QACpE,gBAAgB;QAChB,GAAG,EAAE,IAAA,eAAQ,GAAE;KAChB,CAAA;IAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAA;IAEF,8CAA8C;IAC9C,EAAE;IACF,2EAA2E;IAC3E,4EAA4E;IAC5E,2EAA2E;IAC3E,uEAAuE;IACvE,4EAA4E;IAC5E,wDAAwD;IACxD,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAErB,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,IAAA,2BAAkB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAEhC,wEAAwE;IACxE,2EAA2E;IAC3E,yEAAyE;IACzE,yEAAyE;IACzE,kCAAkC;IAClC,IAAA,2BAAiB,EAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAErC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAC9C,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAE3B,OAAO,EAAE,IAAI,EAAE,CAAA;AACjB,CAAC;AAGD,4EAA4E;AAC5E,uEAAuE;AACvE,8DAA8D;AAC9D,SAAS,SAAS,CAAC,IAAc,EAAE,IAAmB;IACpD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAA,kBAAW,EAAC,GAAG,EAAE,MAAM,EAAE,IAAW,CAAC,CAAA;QAEpD,KAAK,MAAM,IAAI,IAAI,IAAA,gBAAS,EAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnB,SAAQ;YACV,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAA;YAE5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,qBAAW,CACnB,OAAO,GAAG,MAAM,CAAC,IAAI,GAAG,6BAA6B,GAAG,IAAI;oBAC5D,wCAAwC,GAAG,IAAI,CAAC,IAAI;oBACpD,6BAA6B,CAAC,CAAA;YAClC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAGD,MAAM,QAAQ,GAAG,IAAA,cAAG,EAAC,SAAS,QAAQ,CAAC,KAAU;IAC/C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAC5B,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAEpB,IAAA,kBAAO,EAAC,EAAE,EAAE,GAAG,EAAE;QACf,kEAAkE;QAClE,uEAAuE;QACvE,qBAAqB;QACrB,MAAM,MAAM,GAAa,EAAE,CAAA;QAE3B,IAAA,eAAI,EAAC,IAAI,EAAE,CAAC,CAAM,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAA;YAEnB,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAEzD,gEAAgE;YAChE,oEAAoE;YACpE,oEAAoE;YACpE,MAAM,MAAM,GAAG,IAAA,kBAAW,EAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;YAE9C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAExB,GAAG,CAAC,IAAI,CAAC;gBACP,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI;gBACvE,IAAI,EAAE,MAAM,CAAC,IAAI;oBACf,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;wBAChC,SAAS,GAAG,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,QAAQ,GAAG,MAAM,CAAC,MAAM;aAC3B,CAAC,CAAA;YAEF,IAAA,iBAAM,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,CAAC,IAAA,gBAAS,EAAC;gBAC7C,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;gBACzC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU;aACtC,CAAC,CAAC,CAAA;YAEH,oEAAoE;YACpE,sEAAsE;YACtE,qEAAqE;YACrE,sEAAsE;YACtE,iCAAiC;YACjC,MAAM,IAAI,GAAG,IAAA,gBAAS,EAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YAC3C,MAAM,IAAI,GAAG,IAAA,gBAAS,EAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;YAE/C,IAAI,CAAC,OAAO,CAAC,CAAC,IAAa,EAAE,CAAS,EAAE,EAAE;gBACxC,qEAAqE;gBACrE,qEAAqE;gBACrE,qEAAqE;gBACrE,0DAA0D;gBAC1D,EAAE;gBACF,kEAAkE;gBAClE,mEAAmE;gBACnE,kEAAkE;gBAClE,iEAAiE;gBACjE,IAAI,UAAU,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;oBAChC,IAAA,4BAAmB,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EACvD,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;gBAC/B,CAAC;gBAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YAC5C,CAAC,CAAC,CAAA;YAEF,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACxE,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAGF,8DAA8D;AAC9D,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,qCAAqC;AACrC,SAAS,QAAQ,CAAC,IAAS,EAAE,MAAW,EAAE,IAAa,EAAE,QAAgB;IACvE,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACpB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAA;IAE3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,qBAAW,CACnB,OAAO,GAAG,MAAM,CAAC,IAAI,GAAG,6BAA6B,GAAG,IAAI,CAAC,CAAA;QACjE,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI;YACnE,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,wBAAwB,GAAG,QAAQ;gBACrD,mBAAmB;SACtB,CAAC,CAAA;QACF,OAAM;IACR,CAAC;IAED,sEAAsE;IACtE,yEAAyE;IACzE,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,2CAA2C;IAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/D,IAAA,qBAAY,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAC9D,OAAO,EAAE,CAAC,CAAA;QACZ,OAAM;IACR,CAAC;IAED,IAAA,iBAAM,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;QAC/B,IAAA,eAAI,EAAC;YACH,IAAI;YACJ,8DAA8D;YAC9D,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC/B,EAAE,OAAO,EAAE,IAAA,6BAAoB,EAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

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"}