@voxgig/sdkgen 3.4.7 → 3.5.0

package/dist/action/docs.js

@@ -0,0 +1,236 @@
+"use strict";
+// `docs add <ref>` — the third kind. See docs/design/sdkgen-packages.md §20.
+//
+// WHAT A DOCS ITEM IS
+//
+// A generation target whose destination is a DOCUMENTATION SYSTEM rather than
+// a language: a static site, a developer-portal catalogue, a hosted service's
+// config. sdkgen ships the kind and no items; the items live in packages
+// (`@voxgig/docgen` first), which is what makes the destinations someone
+// else's business rather than a list this repo has to guess at.
+//
+// WHY IT IS NOT A TARGET
+//
+// Three reasons, argued in §20.2 and worth restating where the code is:
+//
+//   - a docs item's INPUT is the target collection — a page per SDK, the
+//     package table, per-language tabs — so a docs item inside
+//     `main.kit.target` would enumerate itself;
+//   - `action/feature.ts` fans out with `each(target, …)` and warns
+//     `feature-source-missing` per target with no source, so a docs item in
+//     that collection would collect one warning per feature, forever
+//     (`srcfeature: false` does not help — that flag is read at generate time
+//     and never by the add-time fan-out);
+//   - `ext`, `comment: line` and `module: name` are required, non-defaulted
+//     strings in the target spread, and a site emitting `.md`, `.yml`, `.css`
+//     and `.svg` at once has no honest value for `comment.line`.
+//
+// WHAT THIS ACTION DOES, AND WHAT IT DELIBERATELY DOES NOT
+//
+// It installs the definition — through the shared spine, so provenance,
+// aliasing and the index come along unchanged — and the kind's trees, whose
+// paths come from the registry rather than being spelled here.
+//
+// It does NOT fan out over targets, trim, or prune. A docs item reads the
+// target collection at GENERATE time, not at add time: the opposite direction
+// and the opposite moment from a feature's fan-out, so sharing that machinery
+// would have been a false economy.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.action_docs = action_docs;
+exports.docs_add = docs_add;
+const jostraca_1 = require("jostraca");
+const utility_1 = require("../utility");
+const stdrep_1 = require("../helpers/stdrep");
+const junk_1 = require("../helpers/junk");
+const kind_1 = require("./kind");
+const resolve_1 = require("./resolve");
+const target_1 = require("./target");
+const action_1 = require("./action");
+// The PREFIX of a docs item's component tree (`src/cmp/docs/`), for the
+// alias rewrite. Derived from the registry's declaration rather than written
+// out a second time, so the two cannot disagree about where docs components
+// live.
+const NAME_MARK = '\u0001name\u0001';
+function cmpBase() {
+    const cmp = (0, kind_1.kindTrees)('docs', NAME_MARK)
+        .find((t) => 'none' === t.replace);
+    return null == cmp ? 'src/cmp/docs/' : cmp.path.split(NAME_MARK)[0];
+}
+const CMD_MAP = Object.assign(Object.create(null), {
+    add: cmd_docs_add,
+});
+async function action_docs(args, actx) {
+    const cmdname = args[1];
+    const cmd = CMD_MAP[cmdname];
+    if (null == cmd) {
+        throw new utility_1.SdkGenError('Unknown docs cmd: ' + cmdname + ' (expected: ' +
+            Object.keys(CMD_MAP).sort().join(', ') + ')');
+    }
+    return await cmd(args, actx);
+}
+async function cmd_docs_add(args, actx) {
+    return docs_add((0, action_1.parseAddNames)(args), actx);
+}
+// Code API.
+async function docs_add(docs, actx) {
+    const jostraca = actx.jostraca;
+    const opts = {
+        fs: actx.fs,
+        folder: actx.folder,
+        log: actx.log.child({ cmp: 'jostraca' }),
+        meta: {
+            url: actx.url,
+            // Seeded: no project scaffolded before the docs kind existed has a
+            // docs index, and every project alive today is in that position.
+            content: (0, action_1.loadContent)(actx, 'docs', { docs: '# Docs\n' }),
+        },
+        model: actx.model,
+        // Per-call, never left to the Jostraca instance: `generate` runs its own
+        // options through OptionsShape first, which fills `control.dryrun: false`
+        // and would override the instance flag. The same trap target_add
+        // documents.
+        control: {
+            dryrun: !!actx.opts.dryrun
+        },
+        // Per-call for the same reason, and covering the same accident: see
+        // helpers/junk.
+        cmp: (0, junk_1.copyOpts)(),
+    };
+    opts.log.info({
+        point: 'docs-start',
+        note: (actx.opts.dryrun ? '** DRY RUN **' : '')
+    });
+    // PREFLIGHT, before a single file is written.
+    //
+    // The write pass emits the definition and its index entry before it copies
+    // the trees, so a ref whose definition exists but whose required components
+    // do not left the command failed AND the project carrying a docs item with
+    // no implementation — which the next model compile then reads as real.
+    // `package add` already validates a whole package up front for exactly this
+    // reason; a direct `docs add` needs the same guarantee.
+    preflight(docs, actx);
+    // The project's own model must INCLUDE the docs index, or everything below
+    // is invisible: no project scaffolded before this kind existed includes it,
+    // and `main.kit.docs` would simply be absent from the next compile.
+    (0, action_1.ensureModelInclude)(actx, 'docs');
+    // Into the IN-MEMORY model before anything reads it. Nothing recompiles
+    // `model/sdk.aontu` mid-process, so without this a second docs item in the
+    // same command — and anything else later in it — behaves as if the first
+    // was never installed. One definition of what gets recorded, shared with
+    // `target add` and `package add`.
+    (0, resolve_1.registerInstalled)('docs', docs, actx);
+    const jres = await jostraca.generate(opts, () => DocsRoot({ docs, actx }));
+    return { jres };
+}
+// Resolve every ref and check every REQUIRED tree, throwing before anything
+// is written. Resolution itself is the other half: a ref that names no
+// definition fails here rather than partway through the pass.
+function preflight(docs, actx) {
+    const fs = actx.fs();
+    for (const ref of docs) {
+        const source = (0, kind_1.resolveKind)(ref, 'docs', actx);
+        for (const tree of (0, kind_1.kindTrees)('docs', source.origname)) {
+            if (!tree.required) {
+                continue;
+            }
+            const from = source.folder + '/' + tree.path;
+            if (!fs.existsSync(from)) {
+                throw new utility_1.SdkGenError('Docs ' + source.name + ': required tree not found: ' + from +
+                    '\n  a docs item needs its components (' + tree.path +
+                    '); nothing has been written');
+            }
+        }
+    }
+}
+const DocsRoot = (0, jostraca_1.cmp)(function DocsRoot(props) {
+    const { ctx$, docs } = props;
+    const { log } = ctx$;
+    (0, jostraca_1.Project)({}, () => {
+        // Every installed name seen so far in this run: the index File is
+        // re-rendered per item and the last render wins, so each render has to
+        // carry all of them.
+        const dnames = [];
+        (0, jostraca_1.each)(docs, (n) => {
+            const dref = n.val$;
+            log.info({ point: 'docs-build', docs: dref, note: dref });
+            // The shared spine: a BARE name resolves against what the model
+            // RECORDS, so a docs item installed from a package resolves back to
+            // that package on its next add rather than to the bundled scaffold.
+            const source = (0, kind_1.resolveKind)(dref, 'docs', ctx$);
+            dnames.push(source.name);
+            log.info({
+                point: 'docs-name', docs: source.name, folder: source.folder, ref: dref,
+                note: source.name +
+                    (source.name !== source.origname ?
+                        ' (from ' + source.origname + ')' : '') +
+                    ' from:' + source.folder
+            });
+            (0, jostraca_1.Folder)({ name: 'model/docs' }, () => (0, kind_1.kindModel)({
+                ctx$, kind: 'docs', source, names: dnames,
+                content: ctx$.meta.content.docs_index,
+            }));
+            // Both ends of every tree come from the registry's ONE declaration,
+            // resolved twice: the source carries the ORIGIN name, the destination
+            // the installed one. Deriving the source path by substituting inside
+            // the destination path would corrupt any item whose name also appears
+            // in the fixed part of the path.
+            const dest = (0, kind_1.kindTrees)('docs', source.name);
+            const from = (0, kind_1.kindTrees)('docs', source.origname);
+            dest.forEach((tree, i) => {
+                // Copy only ADDS and overwrites. A newer version of the package that
+                // RETIRED a template would leave the old one behind, generating from
+                // it forever — the failure `pruneStaleTemplates` exists for, and the
+                // reason 30 repos once carried a superseded harness file.
+                //
+                // Templates only, exactly as `target add` prunes only `tm`: extra
+                // files under a component tree are the project's own (doctor calls
+                // them `additive`, and adding a component is the supported way to
+                // extend an item), so pruning there would delete supported work.
+                if ('template' === tree.replace) {
+                    (0, target_1.pruneStaleTemplates)(ctx$, source.folder + '/' + from[i].path, tree.path, [], !!props.actx?.opts?.dryrun);
+                }
+                copyTree(ctx$, source, tree, from[i].path);
+            });
+            log.info({ point: 'docs-done', docs: source.name, note: source.name });
+        });
+    });
+});
+// One tree, copied from the origin path to the installed one.
+//
+// An optional tree the source does not ship is simply not copied — that is
+// what `required: false` means, and a docs item whose every byte is generated
+// legitimately has no template tree.
+function copyTree(ctx$, source, tree, frompath) {
+    const fs = ctx$.fs();
+    const from = source.folder + '/' + frompath;
+    if (!fs.existsSync(from)) {
+        if (tree.required) {
+            throw new utility_1.SdkGenError('Docs ' + source.name + ': required tree not found: ' + from);
+        }
+        ctx$.log.info({
+            point: 'docs-tree-absent', docs: source.name, tree: tree.path, from,
+            note: source.name + ': the source ships no ' + frompath +
+                ', nothing to copy'
+        });
+        return;
+    }
+    // An ALIASED component tree cannot be copied verbatim: components are
+    // dispatched by the convention `cmp/docs/<n>/Main_<n>`, so files keeping
+    // the origin suffix resolve nothing — `Main_apidocs.ts` is invisible to a
+    // lookup for `Main_portal`. Same rule as a target's, so the same function
+    // does it; jostraca's tree Copy has no per-entry rename hook, which is why
+    // an aliased tree is emitted file by file.
+    if (source.name !== source.origname && 'none' === tree.replace) {
+        (0, target_1.aliasCmpTree)(ctx$, from, tree.path, source.origname, source.name, cmpBase());
+        return;
+    }
+    (0, jostraca_1.Folder)({ name: tree.path }, () => {
+        (0, jostraca_1.Copy)({
+            from,
+            // Shared with doctor, which re-applies them before comparing.
+            ...('template' === tree.replace ?
+                { replace: (0, stdrep_1.templateReplacements)(ctx$.model, source.name) } : {}),
+        });
+    });
+}
+//# sourceMappingURL=docs.js.map

package/dist/action/docs.js.map

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

package/dist/action/doctor.d.ts

@@ -6,9 +6,12 @@ type DoctorReport = {
     missing: string[];
     additive: string[];
     unwired: string[];
+    resyncPending: string[];
+    aliasedDiff: string[];
     ok: boolean;
 };
 declare function action_doctor(args: string[], actx: ActionContext): Promise<ActionResult>;
-declare function doctor(actx: ActionContext): Promise<ActionResult>;
-export type { DoctorReport, };
+type DoctorScope = (kind: string, name: string) => boolean;
+declare function doctor(actx: ActionContext, scope?: DoctorScope): Promise<ActionResult>;
+export type { DoctorReport, DoctorScope, };
 export { action_doctor, doctor, };