@voxgig/sdkgen 4.21.0 → 4.22.0

package/dist/helpers/applicability.js

@@ -1,25 +1,4 @@
 "use strict";
-// Which features a target can actually take.
-//
-// THE ONE PLACE THIS RULE LIVES. `Feature` (what source is copied), the
-// per-language `Config_<lang>` and `Main_<lang>` components (what the
-// generated registry, imports and metadata contain) and `configDefinition`
-// (the embedded config) must all reach the same answer for one
-// (feature, target) pair. They previously each read the raw feature map,
-// which is how a feature with no source for a target still reached that
-// target's imports.
-//
-// The shape is `docs/design/feature-tags.md`: a feature declares what it
-// NEEDS, a target declares what it PROVIDES, and the feature applies when
-// `needs` is a subset of `provides`. Both default to empty, so a feature
-// that needs nothing applies everywhere — every feature that existed
-// before this gate keeps its behaviour with no model edit, which is what
-// makes the change additive.
-//
-// A named target list was the cheaper design and fails on time: it has to
-// be edited for targets the feature's author has never heard of, so a
-// published package starves every target added after its release. A tag is
-// a claim about the feature that stays true as the target set grows.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TAGS = void 0;
 exports.featureApplies = featureApplies;
@@ -27,15 +6,6 @@ exports.targetFeatures = targetFeatures;
 exports.featureTags = tags;
 exports.unknownTags = unknownTags;
 const apidef_1 = require("@voxgig/apidef");
-// Tags are a MAP keyed by tag name, `{ sekreto: true }` — see the schema
-// note on `needs`. A map because aontu unifies maps by key, so a package
-// can add one tag without restating the others; and because a defaulted
-// list disjunction in this position hangs the unifier on a real project's
-// model. A tag counts only when its value is true, so a tag can be turned
-// off by overriding it rather than by deleting the key.
-//
-// A list is still accepted, for a hand-written model that used the shape
-// docs/design/feature-tags.md first proposed.
 function tags(val) {
     if (Array.isArray(val)) {
         return val.filter((t) => 'string' === typeof t);
@@ -48,20 +18,12 @@ function tags(val) {
 // Does this feature apply to this target?
 function featureApplies(feature, target) {
     const needs = tags(feature && feature.needs);
-    // The common case, and the reason this is additive: no needs, applies
-    // anywhere. Checked first so a target with no `provides` is unaffected.
     if (0 === needs.length) {
         return true;
     }
     const provides = tags(target && target.provides);
     return needs.every((need) => provides.includes(need));
 }
-// The features that apply to `target`, in the same map shape
-// `getModelPath(model, 'main.<kit>.feature')` returns — already
-// active-filtered by getModelPath, then gated by the tags.
-//
-// `target` may be the target object or its name; components hold the
-// object, `configDefinition` is only given the name.
 function targetFeatures(model, target) {
     const feature = (0, apidef_1.getModelPath)(model, `main.${apidef_1.KIT}.feature`, { required: false }) || {};
     const t = 'string' === typeof target ?
@@ -72,10 +34,6 @@ function targetFeatures(model, target) {
     if (null == t) {
         return feature;
     }
-    // Keyed off the map, not off `f.name`: the key is what every consumer
-    // indexes by, and rebuilding from a field would drop an entry whose
-    // model never set one. Order is not preserved on purpose — consumers
-    // re-sort with `each`, which is what keeps output byte-stable.
     const applies = {};
     for (const [name, f] of Object.entries(feature)) {
         if (featureApplies(f, t)) {
@@ -84,27 +42,9 @@ function targetFeatures(model, target) {
     }
     return applies;
 }
-// THE CLOSED VOCABULARY. The schema comment says applicability tags are a
-// closed set; without this, `provides: &: boolean` accepts any key, so a
-// typo (`sekrreto`) compiles cleanly and silently makes the feature apply
-// NOWHERE — the worst failure shape, because the feature simply vanishes
-// with no diagnostic.
-//
-// Extended by adding a tag here AND documenting it in model/sdkgen.aon.
 const TAGS = [
     // A vendored sekreto port lives in this target's feature container.
     'sekreto',
-    // The target can VALIDATE against the generated `Schema` module: the
-    // model's option spec and, when a feature asks for them, per-entity
-    // struct.validate specs.
-    //
-    // NOT "emits Schema". Every target emits one — make_options reads the
-    // option spec out of it — so that claim is universal and gates nothing.
-    // This tag is the `validate` FEATURE's `needs`, and a feature
-    // also needs its per-target source: tagging a target that has no
-    // `tm/<lang>/src/feature/validate/` makes the feature apply with nothing
-    // to copy. featuremodel.test.ts holds the two together in both
-    // directions.
     'schema',
 ];
 exports.TAGS = TAGS;

package/dist/helpers/applicability.js.map

@@ -1 +1 @@
-{"version":3,"file":"applicability.js","sourceRoot":"","sources":["../../src/helpers/applicability.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"applicability.js","sourceRoot":"","sources":["../../src/helpers/applicability.ts"],"names":[],"mappings":";;;QAsEE,cAAc;QACd,cAAc;QACN,WAAW;QACnB,WAAW;AAxEb,2CAAkD;AAGlD,SAAS,IAAI,CAAC,GAAQ;IACpB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,OAAO,GAAG,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AACtE,CAAC;AAGD,0CAA0C;AAC1C,SAAS,cAAc,CAAC,OAAY,EAAE,MAAW;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAA;IAE5C,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAA;IAEhD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;AAC/D,CAAC;AAGD,SAAS,cAAc,CAAC,KAAU,EAAE,MAAW;IAC7C,MAAM,OAAO,GAAG,IAAA,qBAAY,EAAC,KAAK,EAAE,QAAQ,YAAG,UAAU,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAA;IAErF,MAAM,CAAC,GAAG,QAAQ,KAAK,OAAO,MAAM,CAAC,CAAC;QACpC,CAAC,IAAA,qBAAY,EAAC,KAAK,EAAE,QAAQ,YAAG,SAAS,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,MAAM,CAAA;IAER,sEAAsE;IACtE,qEAAqE;IACrE,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACd,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,MAAM,OAAO,GAAwB,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAA8B,CAAC,EAAE,CAAC;QACvE,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAGD,MAAM,IAAI,GAAG;IACX,oEAAoE;IACpE,SAAS;IAET,QAAQ;CACT,CAAA;QAcC,IAAI;AAXN,uEAAuE;AACvE,SAAS,WAAW,CAAC,GAAQ;IAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AAC3D,CAAC"}

package/dist/helpers/buildIdNames.js

@@ -1,16 +1,4 @@
 "use strict";
-// Build the list of placeholder ID names that the test setup populates into
-// `setup.idmap`. The set is the union of:
-//   - the entity's own ids (`<entity>01..03`)
-//   - every ancestor entity's ids (`<anc>01..03`)
-//   - every literal string value referenced by `step.match` across the flow
-//     (e.g. path-parameter aliases like `year01` for `/{year}/domain` — apidef
-//     doesn't always populate `relations.ancestors` when the parent in the
-//     path is a bare parameter rather than an entity, so we have to mine the
-//     flow steps directly to avoid KeyError-ing the idmap from generated test
-//     code)
-//
-// Identical helper was previously inlined in TestEntity_{go,py,lua,rb,php}.ts.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildIdNames = buildIdNames;
 const COUNT = 3; // 3 ids per name: <name>01, <name>02, <name>03

package/dist/helpers/buildIdNames.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildIdNames.js","sourceRoot":"","sources":["../../src/helpers/buildIdNames.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,0CAA0C;AAC1C,8CAA8C;AAC9C,kDAAkD;AAClD,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,8EAA8E;AAC9E,YAAY;AACZ,EAAE;AACF,+EAA+E;;QAyD7E,YAAY;AAvDd,MAAM,KAAK,GAAG,CAAC,CAAA,CAAC,+CAA+C;AAa/D,SAAS,YAAY,CAAC,MAAkB,EAAE,IAAc;IACtD,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;IAE5D,MAAM,SAAS,GAAa,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACtE,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC,IAAI;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;QACD,wEAAwE;QACxE,qEAAqE;QACrE,wEAAwE;QACxE,4CAA4C;QAC5C,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"buildIdNames.js","sourceRoot":"","sources":["../../src/helpers/buildIdNames.ts"],"names":[],"mappings":";;QAwDE,YAAY;AAvDd,MAAM,KAAK,GAAG,CAAC,CAAA,CAAC,+CAA+C;AAa/D,SAAS,YAAY,CAAC,MAAkB,EAAE,IAAc;IACtD,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;IAE5D,MAAM,SAAS,GAAa,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACtE,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC,IAAI;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;QACD,wEAAwE;QACxE,qEAAqE;QACrE,wEAAwE;QACxE,4CAA4C;QAC5C,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/helpers/canonSpec.js

@@ -1,43 +1,4 @@
 "use strict";
-// Canonical type-sentinel -> struct.validate SPEC mapper.
-//
-// The sibling of canonType: that table turns a field's canon sentinel into a
-// language TYPE NAME (what the generated source declares); this one turns the
-// same sentinel into a struct.validate SPEC VALUE (what the generated runtime
-// checks a payload against). One vocabulary, two renderings, and — as with
-// canonType — a SINGLE mapping that components must not copy locally.
-//
-// WHY THIS IS ALMOST NOTHING. apidef stores `$STRING`, `$INTEGER`, `$NUMBER`,
-// `$BOOLEAN`, `$NULL`, `$ARRAY`, `$OBJECT`, `$ANY` on `fields[].type`, and
-// struct.validate's own vocabulary is `$STRING $NUMBER $INTEGER $DECIMAL
-// $BOOLEAN $NULL $NIL $MAP $LIST $FUNCTION $INSTANCE $ANY $CHILD $ONE $EXACT`.
-// Six of the eight scalar names are the IDENTICAL string. Only three things
-// have to be adapted, and each is a real difference rather than a translation:
-//
-//   1. CONTAINERS ARE NAMED DIFFERENTLY. apidef speaks OpenAPI ($ARRAY,
-//      $OBJECT), struct speaks its own value model ($LIST, $MAP).
-//
-//   2. UNIONS ARE SHAPED DIFFERENTLY. apidef nests the members —
-//      ['`$ONE`', [a, b]] — and struct wants them flat: ['`$ONE`', a, b].
-//      The nested form does not fail loudly, which is the trap: struct reads
-//      the inner LIST as a single alternative, so `['`$ONE`', ['`$STRING`',
-//      '`$INTEGER`']]` rejects the string 'x' with "expected [string,integer]".
-//
-//   3. STRUCT'S `$STRING` REJECTS THE EMPTY STRING. That is right for an
-//      option (an empty apikey is a missing apikey) and wrong for API data,
-//      where '' is an ordinary value a server returns. A field spec therefore
-//      widens to ['`$ONE`', '`$STRING`', ['`$EXACT`', '']].
-//
-// OPTIONALITY. struct requires every key its spec names, so an optional field
-// is the union of its type with `$NIL` (which matches an ABSENT value; `$NULL`
-// matches a stored JSON null). `req: false` on a field, and `optional: true`
-// on an opRequestShape item, both land here.
-//
-// WHAT THIS CANNOT EXPRESS, because the model does not carry it (the same
-// KNOWN GAPS canonType records): array ELEMENT types, nested object schemas,
-// enums, string formats, and any numeric or length bound. A spec built here
-// checks the shape the model knows about and nothing more — which is why
-// record specs are `$OPEN` (below) rather than closed.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SPEC_STRING = void 0;
 exports.byExampleSpec = byExampleSpec;
@@ -64,20 +25,15 @@ const S_ANY = sentinel('ANY');
 const S_STRING = sentinel('STRING');
 const S_NULL = sentinel('NULL');
 const S_OPEN = sentinel('OPEN');
-// Canon sentinel key -> the struct.validate sentinel that checks it.
-// STRING is deliberately absent: it needs the empty-string widening above and
-// is handled in canonToSpec, so a caller cannot get the bare form by accident.
 const CANON_STRUCT = {
     INTEGER: sentinel('INTEGER'),
     NUMBER: sentinel('NUMBER'),
     BOOLEAN: sentinel('BOOLEAN'),
     NULL: sentinel('NULL'),
-    // The container renaming (difference 1 above).
     ARRAY: sentinel('LIST'),
     OBJECT: sentinel('MAP'),
     ANY: S_ANY,
 };
-// A string that may be empty (difference 3 above).
 const SPEC_STRING = [S_ONE, S_STRING, [S_EXACT, '']];
 exports.SPEC_STRING = SPEC_STRING;
 // Flatten a spec into the alternatives of a union, so that widening a value
@@ -88,29 +44,12 @@ function alternatives(spec) {
     }
     return [spec];
 }
-// A spec that also admits an ABSENT value.
-//
-// struct requires every key its spec names, so this is how "optional" is
-// spelled. Flattened through `alternatives`, so widening something that is
-// already a union (an empty-string-tolerant `$STRING`, an apidef `$ONE`)
-// adds one member rather than nesting a union inside a union — which struct
-// reads as a single alternative and rejects.
 function optionalSpec(spec) {
-    // `$ANY` already admits an absent value, so widening it would only make
-    // the spec longer and its error messages worse.
     if (S_ANY === spec) {
         return spec;
     }
     return [S_ONE, ...alternatives(spec), S_NIL];
 }
-// Map one field/param type sentinel to a struct.validate spec value.
-//
-// Unknown or missing sentinel -> `$ANY`, never a throw: this mirrors
-// canonToType's contract, and for the same reason. A sentinel this table has
-// not met is a model the generator should still emit for, and an over-strict
-// spec would reject live traffic at runtime rather than fail a build.
-//
-// `optional` widens the result with `$NIL` so an absent key passes.
 function canonToSpec(type, optional) {
     let spec;
     if (Array.isArray(type)) {
@@ -125,27 +64,6 @@ function canonToSpec(type, optional) {
                     }
                 }
             }
-            // A NULLABLE FIELD NEEDS `$NIL`, NOT JUST `$NULL`.
-            //
-            // apidef writes a nullable field as ['`$ONE`', [<type>, '`$NULL`']],
-            // and `$NULL` on its own does match a stored null. Inside a union it
-            // does not: struct resolves each alternative through a lookup that
-            // reads a stored null as "no value", so the value that reaches the
-            // `$NULL` validator is undefined and every nullable field rejected the
-            // one value it exists to allow. `$NIL` matches that no-value, so the
-            // pair covers both readings.
-            //
-            // THE COST, stated because it is real and not an oversight: `$NIL` is
-            // also how an OPTIONAL field is spelled, and struct cannot tell a
-            // stored null from an absent key inside a union — the lookup collapses
-            // them before any alternative sees the value. So a REQUIRED nullable
-            // field (`string | null`, `req: true`) also passes when the key is
-            // missing. The alternative is worse: drop `$NIL` and a nullable field
-            // rejects null, which is the one value it is declared to hold, for
-            // EVERY such field rather than weakening presence on a subset. Closing
-            // the gap needs a presence check outside struct, i.e. a second
-            // validation mechanism beside the one this whole module exists to
-            // reuse. Revisit if struct gains a spelling that separates them.
             if (0 <= members.indexOf(S_NULL) && members.indexOf(S_NIL) < 0) {
                 members.push(S_NIL);
             }
@@ -163,14 +81,6 @@ function canonToSpec(type, optional) {
     }
     return optional ? optionalSpec(spec) : spec;
 }
-// The spec for one entity RECORD: every active field, keyed by name.
-//
-// OPEN, ALWAYS. apidef records the properties a spec declared, which is not a
-// promise that a response carries nothing else — a server that adds a field is
-// not breaking its clients, and a closed spec would turn that into a client
-// error for every caller at once. The declared fields are type-checked; the
-// rest pass. A caller who wants the closed reading drops `$OPEN` at runtime
-// (the validate feature's `strict` option does exactly that).
 function entityDataSpec(ent) {
     const spec = { [S_OPEN]: true };
     const fields = (ent && ent.fields) ? (0, jostraca_1.each)(ent.fields) : [];
@@ -182,12 +92,6 @@ function entityDataSpec(ent) {
     }
     return spec;
 }
-// The spec for one operation's REQUEST payload.
-//
-// The members and their optionality are opRequestShape's answer, not a second
-// reading of the model: the partiality policy that decides what a generated
-// `<Name>CreateData` requires is the same policy that decides what a create
-// call must carry, and two copies of it would drift the moment one is edited.
 function entityOpSpec(ent, opname) {
     const { items } = (0, opShape_1.opRequestShape)(ent, opname);
     if (0 === items.length) {
@@ -214,24 +118,6 @@ function entitySpecs(ent) {
     }
     return { data: entityDataSpec(ent), op };
 }
-// A DEFAULT VALUE, read as a type.
-//
-// A feature declares its options as defaults (`ttl: 5000`, `currency: 'USD'`,
-// `methods: ['GET']`) — a map written to document what happens when you say
-// nothing, not to state a type. struct.validate reads it by example, and by
-// example is SHARPER than the author meant: `unit: 0` says "an integer", so
-// cost's own `unit: 0.002` failed its own feature's spec; `header: ''` says
-// "a non-empty string", which the default itself is not.
-//
-// So the default is kept for its KIND and widened to that kind's sentinel.
-// Nothing is lost by dropping the value: a feature's defaults are applied by
-// the feature's own code (`this._options.currency || 'USD'`), never by this
-// spec — each feature entry is optional, and struct fills in nothing through
-// an optional union.
-//
-// This applies to a DEFAULTS map only. `main.kit.optspec` is written as a
-// spec, so its concrete values are the author's own choice of constraint and
-// are passed through untouched.
 function byExampleSpec(val) {
     if (null == val) {
         return S_ANY;

package/dist/helpers/canonSpec.js.map

@@ -1 +1 @@
-{"version":3,"file":"canonSpec.js","sourceRoot":"","sources":["../../src/helpers/canonSpec.ts"],"names":[],"mappings":";AAAA,0DAA0D;AAC1D,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,sEAAsE;AACtE,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,yEAAyE;AACzE,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,EAAE;AACF,wEAAwE;AACxE,kEAAkE;AAClE,EAAE;AACF,iEAAiE;AACjE,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,gFAAgF;AAChF,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,8EAA8E;AAC9E,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAC7E,6CAA6C;AAC7C,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,yEAAyE;AACzE,uDAAuD;;;QA8PrD,aAAa;QACb,WAAW;QACX,YAAY;QACZ,cAAc;QACd,YAAY;QACZ,WAAW;QACX,QAAQ;AAlQV,uCAA+B;AAE/B,2CAAsC;AACtC,uCAA0C;AAG1C,0EAA0E;AAC1E,4EAA4E;AAC5E,+CAA+C;AAC/C,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;AAElC,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,EAAE,GAAG,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;AAC7B,CAAC;AAGD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;AACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC7B,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;AACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;AAG/B,qEAAqE;AACrE,8EAA8E;AAC9E,+EAA+E;AAC/E,MAAM,YAAY,GAA2B;IAC3C,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC5B,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC5B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;IAEtB,+CAA+C;IAC/C,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC;IACvB,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC;IAEvB,GAAG,EAAE,KAAK;CACX,CAAA;AAGD,mDAAmD;AACnD,MAAM,WAAW,GAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;QAwNzD,WAAW;AArNb,4EAA4E;AAC5E,mEAAmE;AACnE,SAAS,YAAY,CAAC,IAAS;IAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAGD,2CAA2C;AAC3C,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,4EAA4E;AAC5E,6CAA6C;AAC7C,SAAS,YAAY,CAAC,IAAS;IAC7B,wEAAwE;IACxE,gDAAgD;IAChD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAA;AAC9C,CAAC;AAGD,qEAAqE;AACrE,EAAE;AACF,qEAAqE;AACrE,6EAA6E;AAC7E,6EAA6E;AAC7E,sEAAsE;AACtE,EAAE;AACF,oEAAoE;AACpE,SAAS,WAAW,CAAC,IAAa,EAAE,QAAkB;IACpD,IAAI,IAAS,CAAA;IAEb,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,qEAAqE;QACrE,6DAA6D;QAC7D,IAAI,KAAK,KAAK,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,OAAO,GAAU,EAAE,CAAA;YACzB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;oBACpD,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,OAAO,GAAG,EAAE,CAAC;wBACxD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;oBACnB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,mDAAmD;YACnD,EAAE;YACF,qEAAqE;YACrE,qEAAqE;YACrE,mEAAmE;YACnE,mEAAmE;YACnE,uEAAuE;YACvE,qEAAqE;YACrE,6BAA6B;YAC7B,EAAE;YACF,sEAAsE;YACtE,kEAAkE;YAClE,uEAAuE;YACvE,qEAAqE;YACrE,mEAAmE;YACnE,sEAAsE;YACtE,mEAAmE;YACnE,uEAAuE;YACvE,+DAA+D;YAC/D,kEAAkE;YAClE,iEAAiE;YACjE,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;YAED,IAAI,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,CAAA;QAC3D,CAAC;aACI,CAAC;YACJ,sEAAsE;YACtE,oCAAoC;YACpC,IAAI,GAAG,KAAK,CAAA;QACd,CAAC;IACH,CAAC;SACI,CAAC;QACJ,MAAM,GAAG,GAAG,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAA;QAC1B,IAAI,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAA;IACtE,CAAC;IAED,OAAO,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC7C,CAAC;AAGD,qEAAqE;AACrE,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,8DAA8D;AAC9D,SAAS,cAAc,CAAC,GAAQ;IAC9B,MAAM,IAAI,GAAwB,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAA;IAEpD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,eAAI,EAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YACtD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAA;IACrD,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAGD,gDAAgD;AAChD,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,8EAA8E;AAC9E,SAAS,YAAY,CAAC,GAAQ,EAAE,MAAc;IAC5C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,wBAAc,EAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IAC7C,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,IAAI,GAAwB,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAA;IACpD,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAGD,8EAA8E;AAC9E,4EAA4E;AAC5E,uEAAuE;AACvE,kEAAkE;AAClE,SAAS,WAAW,CAAC,GAAQ;IAC3B,MAAM,EAAE,GAAwB,EAAE,CAAA;IAElC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAA;IACjC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACxC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACnB,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAA;AAC1C,CAAC;AAGD,mCAAmC;AACnC,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,yDAAyD;AACzD,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,qBAAqB;AACrB,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,gCAAgC;AAChC,SAAS,aAAa,CAAC,GAAQ;IAC7B,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QAChB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,CAAC,GAAG,OAAO,GAAG,CAAA;IAEpB,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,WAAW,CAAA;IACpB,CAAC;IACD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,yEAAyE;QACzE,mDAAmD;QACnD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC3B,CAAC;IACD,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC5B,CAAC;IACD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC"}
+{"version":3,"file":"canonSpec.js","sourceRoot":"","sources":["../../src/helpers/canonSpec.ts"],"names":[],"mappings":"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"}

package/dist/helpers/canonType.js

@@ -1,52 +1,10 @@
 "use strict";
-// Canonical type-sentinel -> language primitive type mapper.
-//
-// SOURCE OF TRUTH for the sentinel set: @voxgig/apidef (`VALID_CANON` +
-// `CANON_ONE`, exported from the package). VALID_CANON maps an OpenAPI type
-// NAME -> a `$SENTINEL` string (e.g. 'string' -> `$STRING`). The model stores
-// those sentinels on every `fields[].type` and op `points[].args.params[].type`.
-// A multi-type (OpenAPI `type: [a, b]`) is stored as the ARRAY-shaped union
-// sentinel `['`$ONE`', [member, ...]]` (see canonToType below).
-//
-// This table maps the SENTINEL the other way -> a concrete primitive type in
-// each target language, so the typed-model generators (EntityTypes_<lang>.ts)
-// and the README type columns (ReadmeRef_<lang>.ts / ReadmeEntity_<lang>.ts)
-// can turn the model's field/param sentinels into real language types. It is
-// the SINGLE mapping per language: components must not keep local copies.
-//
-// Kept as a small mirror here (rather than importing VALID_CANON at runtime)
-// because apidef is a peer dependency and the table is the INVERSE direction.
-//
-// `ts/test/canonsync.test.ts` guards it two ways: the vocabulary and every
-// language column are pinned LOCALLY (that check always runs), and the table
-// is cross-checked against apidef's exported VALID_CANON/CANON_ONE when the
-// installed apidef exports them. Note that the currently published apidef
-// (6.3.1) does NOT export them, so the cross-check skips — do not rely on it
-// alone; add a new sentinel to the local list in the same change.
-//
-// KNOWN GAPS (papered over sanely, documented for the port):
-//  - Unknown / missing sentinel  -> the language's "any" (never throws).
-//  - Array element typing is not in the model: $ARRAY maps to an untyped
-//    list/array. `list` ops return T[] via op-kind inference in the op
-//    fragment, NOT via a field sentinel.
-//  - Object/nested field schemas are not in the corpus: $OBJECT maps to the
-//    language's open record/map type.
-//  - No enum/format/nullability beyond the `req` flag.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PANDAS_DTYPE = exports.CANON_UNION_JOIN = exports.CANON_ANY = exports.CANON_TYPE = void 0;
 exports.canonToType = canonToType;
 exports.canonToDtype = canonToDtype;
 exports.canonKey = canonKey;
 exports.canonScalarKey = canonScalarKey;
-// Bare sentinel key (backticks + leading `$` stripped, upper-cased)
-// -> per-language primitive type name.
-//
-// Column notes:
-//  - kotlin: every type is nullable (`?`) — the kotlin emitter drops
-//    per-member optionality because the column is already-nullable.
-//  - java/scala: boxed JVM types (nullable), so optionality needs no marker.
-//  - rust/c/cpp/swift: `Value`/`voxgig_value*`/`VMap` are the vendored
-//    dynamic value types those runtimes ship.
 const CANON_TYPE = {
     STRING: {
         ts: 'string', js: 'string', py: 'str', php: 'string', rb: 'String',
@@ -111,11 +69,6 @@ const CANON_ANY = {
     rust: 'Value', c: 'voxgig_value*', cpp: 'Value', elixir: 'any()',
 };
 exports.CANON_ANY = CANON_ANY;
-// Union ($ONE) member separator for languages with a native union/sum type
-// syntax. Languages absent here have no way to express an anonymous union in
-// a type position, so a $ONE sentinel degrades to that language's "any".
-// (php 8 unions exist but cannot combine with the `?` optional prefix the
-// emitters use, so php deliberately degrades to `mixed`.)
 const CANON_UNION_JOIN = {
     ts: ' | ',
     js: '|',
@@ -124,23 +77,6 @@ const CANON_UNION_JOIN = {
     elixir: ' | ',
 };
 exports.CANON_UNION_JOIN = CANON_UNION_JOIN;
-// Canonical sentinel -> pandas dtype, for the `py-data` target's generated
-// DataFrame accessors. Deliberately NOT a CanonLang column: py-data is a
-// consumer target layered on `py`, not a language, and these are storage
-// dtypes rather than type-annotation names.
-//
-// NULLABLE dtypes throughout ('Int64' not 'int64', 'boolean' not 'bool').
-// The model carries no nullability beyond the `req` flag, and API payloads
-// omit optional fields freely, so a column that looks integral in one page
-// can arrive with nulls in the next. NumPy's int64/bool cannot hold NA and
-// would silently upcast to float64/object mid-fetch, changing a column's
-// dtype based on which rows came back — the pandas nullable extension types
-// keep it stable.
-//
-// There is no $DATE / $DATETIME sentinel in apidef's vocabulary (the model
-// carries no string formats), so date handling is NOT inferred here. It is
-// an explicit runtime opt-in via the accessor's `parse_dates=` kwarg. Do not
-// add a DATE row unless apidef starts emitting the sentinel.
 const PANDAS_DTYPE = {
     STRING: 'string',
     INTEGER: 'Int64',
@@ -174,21 +110,6 @@ function canonKey(sentinel) {
     }
     return String(sentinel).replace(/[`$]/g, '').trim().toUpperCase();
 }
-// The bare key of the sentinel a VALUE of this type must satisfy, resolving
-// the union sentinel `['`$ONE`', [member, ...]]` to its first non-NULL member
-// (recursively — a member may itself be a union).
-//
-// canonKey alone cannot do this: given an array it stringifies it, so a
-// nullable `['`$ONE`', ['`$NUMBER`','`$NULL`']]` field yields neither NUMBER
-// nor anything else recognizable and every caller falls through to its
-// "unknown, use a string" branch. canonToType meanwhile renders that same
-// sentinel as `number | null`, so the doc example said `'..._id'` while the
-// generated type said `number` — a TS2322 in the SDK's own README, which is
-// exactly the disagreement the example helpers exist to prevent.
-//
-// A union of nothing but NULL resolves to NULL; an unrecognized array shape,
-// or an empty member list, resolves to '' (unknown) like any missing
-// sentinel.
 function canonScalarKey(sentinel) {
     if (Array.isArray(sentinel)) {
         if ('ONE' !== canonKey(sentinel[0]) || !Array.isArray(sentinel[1])) {
@@ -209,14 +130,6 @@ function canonScalarKey(sentinel) {
     }
     return canonKey(sentinel);
 }
-// Map a field/param type sentinel to a target-language primitive type.
-// Unknown or missing sentinel -> that language's "any" (never throws).
-//
-// The union sentinel `['`$ONE`', [member, ...]]` (apidef CANON_ONE, produced
-// for OpenAPI multi-types) renders as a joined member union in languages with
-// union syntax (see CANON_UNION_JOIN); elsewhere it degrades to "any".
-// Members may themselves be unions (handled recursively) or the literal
-// 'Any' apidef emits for an unknown member name (canonKey maps it to ANY).
 function canonToType(sentinel, lang) {
     const l = lang;
     const fallback = CANON_ANY[l] ?? 'any';

package/dist/helpers/canonType.js.map

@@ -1 +1 @@
-{"version":3,"file":"canonType.js","sourceRoot":"","sources":["../../src/helpers/canonType.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"canonType.js","sourceRoot":"","sources":["../../src/helpers/canonType.ts"],"names":[],"mappings":";;;QAyKE,WAAW;QACX,YAAY;QACZ,QAAQ;QACR,cAAc;AAlKhB,MAAM,UAAU,GAA8C;IAC5D,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ;QAClE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ;QAC7D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ;QACnE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY;KACrE;IACD,OAAO,EAAE;QACP,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS;QAChE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;QACtD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK;QACnE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW;KAC/D;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO;QAClE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ;QAC9D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK;QAC1E,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS;KAC3D;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS;QACpE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;QAC3D,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;QAC3E,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;KAC1D;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU;QAC/D,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ;QACxD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ;QAC/D,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;KAC/D;IACD,KAAK,EAAE;QACL,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO;QAC/D,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc;QACxE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,SAAS;QACxE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,eAAe;QAC7D,GAAG,EAAE,oBAAoB,EAAE,MAAM,EAAE,QAAQ;KAC5C;IACD,MAAM,EAAE;QACN,EAAE,EAAE,qBAAqB,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO;QACjE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,gBAAgB;QAC9C,MAAM,EAAE,6BAA6B,EAAE,IAAI,EAAE,qBAAqB;QAClE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,+BAA+B;QACpE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB;QAC3C,IAAI,EAAE,0CAA0C,EAAE,CAAC,EAAE,eAAe;QACpE,GAAG,EAAE,8BAA8B,EAAE,MAAM,EAAE,OAAO;KACrD;IACD,GAAG,EAAE;QACH,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;QACzD,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ;QACxD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;QAChE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;KACjE;CACF,CAAA;QA8GC,UAAU;AA5GZ,yDAAyD;AACzD,0DAA0D;AAC1D,MAAM,SAAS,GAA8B;IAC3C,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;IACzD,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ;IACxD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;IAChE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;CACjE,CAAA;QAsGC,SAAS;AApGX,MAAM,gBAAgB,GAAuC;IAC3D,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,KAAK;IACT,GAAG,EAAE,GAAG;IACR,MAAM,EAAE,KAAK;CACd,CAAA;QA+FC,gBAAgB;AA5FlB,MAAM,YAAY,GAA2B;IAC3C,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,yEAAyE;IACzE,IAAI,EAAE,QAAQ;IACd,0EAA0E;IAC1E,oEAAoE;IACpE,yEAAyE;IACzE,4DAA4D;IAC5D,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,QAAQ;CACd,CAAA;QA+EC,YAAY;AA7Ed,0EAA0E;AAC1E,yEAAyE;AACzE,sEAAsE;AACtE,SAAS,YAAY,CAAC,QAAiB;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,OAAO,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAA;AACrD,CAAC;AAGD,6DAA6D;AAC7D,kDAAkD;AAClD,SAAS,QAAQ,CAAC,QAAiB;IACjC,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;QACrB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AACnE,CAAC;AAGD,SAAS,cAAc,CAAC,QAAiB;IACvC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO,EAAE,CAAA;QACX,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;YAClC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnB,OAAO,GAAG,IAAI,CAAA;gBACd,SAAQ;YACV,CAAC;YACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,OAAO,GAAG,CAAA;YACZ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9B,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC3B,CAAC;AAGD,SAAS,WAAW,CAAC,QAAiB,EAAE,IAAY;IAClD,MAAM,CAAC,GAAG,IAAiB,CAAA;IAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAA;IAEtC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAA;YAChC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAA;YACjB,CAAC;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAClE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;YAC/E,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvD,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1C,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAA;AAC3B,CAAC"}

package/dist/helpers/collectDeps.js

@@ -1,25 +1,4 @@
 "use strict";
-// Collect target-language dependencies from features and from the target's
-// own `deps` block, applying the active-flag semantics that every Package_*.ts
-// template was hand-rolling identically:
-//
-//   - feature deps  : included when `dep.active === true`  (default off)
-//   - plugin  deps  : the same, and only for an ACTIVE plugin of that feature
-//   - target  deps  : included when `dep.active !== false` (default on)
-//
-// THE PLUGIN LEVEL IS GATED ONE STEP DEEPER THAN THE FEATURE. A feature's
-// deps flow as soon as the feature is active; a plugin is a trimmable part
-// within an active feature, so a dependency only its files use must not
-// reach the manifest until that plugin is active too. rust's mini vault is
-// the case: it takes `ring` for AES-256-GCM, and at feature level that
-// would land in every secrets-enabled rust SDK, including the ones whose
-// chain is `[env, dotenv]` and which never compile a vault.
-//
-// The two sources are kept distinct via the `source` field so callers can
-// apply their own version defaults / formatting (e.g. go uses `v0.0.0`,
-// python `0.0`). The original dep object is exposed as `raw` for callers that
-// need extra fields like `dep.replace` (go module replace directives) or
-// `dep.kind` (prod/dev/peer).
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.collectDeps = collectDeps;
 const applicability_1 = require("./applicability");
@@ -29,12 +8,6 @@ function collectDeps(model, targetName, targetDeps, log) {
     // Gated: a feature that does not apply to this target must not flow a
     // dependency into its generated manifest.
     const feature = (0, applicability_1.targetFeatures)(model, targetName);
-    // Deduplicate by package name. Two features can require the same package
-    // (or a feature and the target itself can), and every Package_<lang>.ts
-    // renders one manifest line per entry — a duplicate key is a hard parse
-    // error in go.mod and Cargo.toml, and silently last-wins in package.json.
-    // FIRST occurrence wins, so the deterministic (sorted-key) feature order
-    // decides; a conflicting version is reported rather than silently dropped.
     const seen = {};
     const add = (dep, source, owner) => {
         const name = dep.key$;

package/dist/helpers/collectDeps.js.map

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

package/dist/helpers/definition.js

@@ -1,19 +1,4 @@
 "use strict";
-// WHERE A KIND'S DEFINITION FILES LIVE.
-//
-// `model/<kind>/<name>.aon`, with `model/<kind>/<kind>-index.aon` as the
-// include list beside them. One line of path-building — and it was written out
-// longhand in three places (the resolver, the feature catalogue, doctor), each
-// with its own idea of which files in that directory count.
-//
-// That is the same shape of defect this workstream has now fixed four times:
-// the same rule expressed twice, drifting. The manifest makes it four callers,
-// so it becomes one function first.
-//
-// The EXCLUSIONS matter as much as the path. A `model/<kind>/` directory holds
-// the index file (a list of includes, not a definition) and, in the shipped
-// scaffold, a `README.md`. Neither is an item, and a caller that forgets one
-// invents a `feature-index` feature.
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -36,23 +21,9 @@ function definitionFolder(sdkfolder, kind) {
 function indexName(kind) {
     return kind + '-index.aon';
 }
-// Every item of `kind` a `.sdk` folder DEFINES, sorted. Sorted because it
-// feeds an exact-set comparison against a manifest and, through
-// `availableFeatures`, the feature-trim catalogue — both of which are compared
-// as text, so a readdir order that varies by filesystem would vary the result.
-//
-// An absent directory is not an error: a package providing only features has
-// no `model/target/`, and that is the normal shape of a feature package.
 function definitionNames(fs, sdkfolder, kind) {
     const dir = definitionFolder(sdkfolder, kind);
     const index = indexName(kind);
-    // `existsSync` is true for a REGULAR FILE and for a directory this process
-    // cannot read, so guarding on it and then calling `readdirSync` let a bare
-    // `ENOTDIR`/`EACCES` escape to callers that have no catch — including
-    // `featureCatalogue`, which runs on every ordinary `target add`, so the
-    // whole add aborted with an errno instead of a diagnostic. Not-a-readable-
-    // directory is the same answer as not-there: this kind defines nothing
-    // here.
     let entries;
     try {
         entries = fs.readdirSync(dir);

package/dist/helpers/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/helpers/definition.ts"],"names":[],"mappings":";AAAA,wCAAwC;AACxC,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,+EAA+E;AAC/E,4DAA4D;AAC5D,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,oCAAoC;AACpC,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,6EAA6E;AAC7E,qCAAqC;;;;;QA+DnC,cAAc;QACd,gBAAgB;QAChB,eAAe;QACf,SAAS;AAhEX,0DAA4B;AAE5B,iCAA+B;AAG/B,oCAAoC;AACpC,SAAS,cAAc,CAAC,SAAiB,EAAE,IAAY,EAAE,IAAY;IACnE,OAAO,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,CAAA;AAC3D,CAAC;AAGD,8CAA8C;AAC9C,SAAS,gBAAgB,CAAC,SAAiB,EAAE,IAAY;IACvD,OAAO,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;AAC5C,CAAC;AAGD,gCAAgC;AAChC,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,GAAG,YAAY,CAAA;AAC5B,CAAC;AAGD,0EAA0E;AAC1E,gEAAgE;AAChE,+EAA+E;AAC/E,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,SAAS,eAAe,CAAC,EAAO,EAAE,SAAiB,EAAE,IAAY;IAC/D,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAE7B,2EAA2E;IAC3E,2EAA2E;IAC3E,sEAAsE;IACtE,wEAAwE;IACxE,2EAA2E;IAC3E,uEAAuE;IACvE,QAAQ;IACR,IAAI,OAAiB,CAAA;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,0EAA0E;IAC1E,yEAAyE;IACzE,6EAA6E;IAC7E,oDAAoD;IACpD,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAA,aAAM,EAAC,CAAC,CAAC,CAAC;SACtE,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SAC3C,IAAI,EAAE,CAAA;AACX,CAAC"}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/helpers/definition.ts"],"names":[],"mappings":";;;;;QAgDE,cAAc;QACd,gBAAgB;QAChB,eAAe;QACf,SAAS;AAlDX,0DAA4B;AAE5B,iCAA+B;AAG/B,oCAAoC;AACpC,SAAS,cAAc,CAAC,SAAiB,EAAE,IAAY,EAAE,IAAY;IACnE,OAAO,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,CAAA;AAC3D,CAAC;AAGD,8CAA8C;AAC9C,SAAS,gBAAgB,CAAC,SAAiB,EAAE,IAAY;IACvD,OAAO,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;AAC5C,CAAC;AAGD,gCAAgC;AAChC,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,GAAG,YAAY,CAAA;AAC5B,CAAC;AAGD,SAAS,eAAe,CAAC,EAAO,EAAE,SAAiB,EAAE,IAAY;IAC/D,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAE7B,IAAI,OAAiB,CAAA;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,0EAA0E;IAC1E,yEAAyE;IACzE,6EAA6E;IAC7E,oDAAoD;IACpD,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAA,aAAM,EAAC,CAAC,CAAC,CAAC;SACtE,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SAC3C,IAAI,EAAE,CAAA;AACX,CAAC"}

package/dist/helpers/dryrun.js

@@ -1,12 +1,4 @@
 "use strict";
-// Report what a dry run WOULD have done.
-//
-// `@voxgig/util`'s showChanges only lists merged and conflicted files, which
-// on a fresh `target add` is nothing at all — so `-y target add ts` printed
-// `** DRY RUN **`, listed no files, and (before the control fix) wrote them
-// anyway. A preview that shows nothing is indistinguishable from a preview of
-// nothing, which is exactly the wrong answer for the command whose whole job
-// is to overwrite a project's vendored scaffold.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showDryrun = showDryrun;
 // Log every path the run touched, one line each, plus a total. `written`