@voxgig/sdkgen 3.4.6 → 3.5.0

package/dist/helpers/semver.js

@@ -0,0 +1,174 @@
+"use strict";
+// A DELIBERATELY SMALL semver range check, for `engines.sdkgen`.
+//
+// WHY NOT node-semver
+//
+// This package has no runtime dependencies (`dependencies: {}`), and adding
+// one to read a single optional manifest field is a poor trade. What the field
+// actually carries is a floor — `">=3.5"` — so the subset below covers the
+// spellings that occur, and REFUSES TO GUESS at anything else.
+//
+// THE FAILURE DIRECTION MATTERS MORE THAN THE COVERAGE
+//
+// Getting this wrong in the strict direction refuses a package that would
+// have worked, which is worse than the incompatibility it is trying to
+// prevent. So `satisfies` has three outcomes, not two: yes, no, and
+// `undefined` for "this range is outside the subset I understand". A caller
+// that gets `undefined` must let the install proceed and say so, never treat
+// it as a failure.
+//
+// SUPPORTED
+//   *  x  X  ''            any version
+//   >=1.2.3  >1.2  <=2  <2  =1.2.3  1.2.3
+//   ^1.2.3  ~1.2.3
+//   space-separated conjunction:  ">=3.5 <4"
+//   ||-separated alternatives:    "^3 || ^4"
+//
+// NOT SUPPORTED (returns undefined)
+//   hyphen ranges (`1.2.3 - 2.3.4`), prerelease/build metadata comparison,
+//   and anything else. Prereleases are compared by their numeric core only,
+//   which is why a range mentioning one is rejected rather than mishandled.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.satisfies = satisfies;
+exports.parseVersion = parseVersion;
+const COMPARATOR_RE = /^(>=|<=|>|<|=|\^|~)?v?(\d+)(?:\.(\d+))?(?:\.(\d+))?$/;
+const ANY_RE = /^(\*|x|X)$/;
+// A version as three numbers, or undefined if it is not a plain `X.Y.Z`.
+// A prerelease or build suffix returns undefined deliberately: comparing them
+// properly is most of what makes semver hard, and this subset does not.
+function parseVersion(v) {
+    const m = /^v?(\d+)\.(\d+)\.(\d+)$/.exec(String(v).trim());
+    return null == m ? undefined :
+        [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+function compare(a, b) {
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i]) {
+            return a[i] < b[i] ? -1 : 1;
+        }
+    }
+    return 0;
+}
+// The upper bound `^` and `~` imply, exclusive.
+//
+//   ^1.2.3 -> <2.0.0      ^0.2.3 -> <0.3.0      ^0.0.3 -> <0.0.4
+//   ~1.2.3 -> <1.3.0      ~1.2   -> <1.3.0      ~1     -> <2.0.0
+//
+// `^0.x` is the case worth stating: npm treats a leading zero as unstable, so
+// the caret narrows to the first NON-ZERO component. Getting that wrong would
+// admit `0.3.0` for `^0.2.3`, which is a breaking change by that convention.
+function caretBound(p) {
+    if (0 !== p[0])
+        return [p[0] + 1, 0, 0];
+    if (0 !== p[1])
+        return [0, p[1] + 1, 0];
+    return [0, 0, p[2] + 1];
+}
+function tildeBound(p, given) {
+    return nextBound(p, given);
+}
+// The version just past everything a PARTIAL version covers: `3.4` covers all
+// of 3.4.x, so the next bound is 3.5.0; `3` covers all of 3.x, so 4.0.0.
+// Shared by `~` and by the two strict comparators that need it, so they
+// cannot disagree about where a partial version ends.
+function nextBound(p, given) {
+    return 1 === given ? [p[0] + 1, 0, 0] : [p[0], p[1] + 1, 0];
+}
+// One comparator against one version. `undefined` if the comparator is
+// outside the subset.
+function satisfiesOne(version, comparator) {
+    const c = comparator.trim();
+    if ('' === c || ANY_RE.test(c)) {
+        return true;
+    }
+    const m = COMPARATOR_RE.exec(c);
+    if (null == m) {
+        return undefined;
+    }
+    const op = m[1] ?? '=';
+    // How many components were actually written — `~1.2` and `~1` bound
+    // differently, and a partial version means "any" in its missing places.
+    const given = null != m[4] ? 3 : null != m[3] ? 2 : 1;
+    const p = [Number(m[2]), Number(m[3] ?? 0), Number(m[4] ?? 0)];
+    const cmp = compare(version, p);
+    // A PARTIAL version is a RANGE, not a version with zeroes in it, and two of
+    // the four strict comparators have to move their bound to say so:
+    //
+    //   >3.4   means ">= all of 3.4.x"  ->  >=3.5.0    (not >3.4.0)
+    //   <=3.4  means "<= all of 3.4.x"  ->  <3.5.0     (not <=3.4.0)
+    //   >=3.4  ->  >=3.4.0     <3.4  ->  <3.4.0        (already right)
+    //
+    // Read as literal zeroes, `>3.4` admitted 3.4.8 (an incompatible package
+    // let through) and `<=3.4` rejected it (a compatible one refused) — the two
+    // failures this module's whole shape is meant to avoid, in one comparator.
+    const bound = 3 === given ? p : nextBound(p, given);
+    if ('>=' === op)
+        return 0 <= cmp;
+    if ('<' === op)
+        return 0 > cmp;
+    if ('>' === op)
+        return 3 === given ? 0 < cmp : 0 <= compare(version, bound);
+    if ('<=' === op)
+        return 3 === given ? 0 >= cmp : 0 > compare(version, bound);
+    if ('^' === op) {
+        return 0 <= cmp && 0 > compare(version, caretBound(p));
+    }
+    if ('~' === op) {
+        return 0 <= cmp && 0 > compare(version, tildeBound(p, given));
+    }
+    // `=` / bare. A partial version is a PREFIX match: `1.2` admits any 1.2.x,
+    // which is what every other tool means by it.
+    if (3 === given)
+        return 0 === cmp;
+    if (2 === given)
+        return version[0] === p[0] && version[1] === p[1];
+    return version[0] === p[0];
+}
+// Does `version` satisfy `range`?
+//
+// `true` / `false` / `undefined` — see the note at the top: undefined means
+// "not understood", and the caller must not treat it as a failure.
+function satisfies(version, range) {
+    const v = parseVersion(version);
+    if (null == v) {
+        return undefined;
+    }
+    const text = String(range ?? '').trim();
+    if ('' === text || ANY_RE.test(text)) {
+        return true;
+    }
+    // A hyphen range is not supported, and its parts would otherwise be read as
+    // a conjunction of two bare versions — which is never satisfiable, i.e. a
+    // false REFUSAL. Rejected explicitly rather than by accident.
+    if (/\s-\s/.test(text)) {
+        return undefined;
+    }
+    // An alternative that MATCHES wins immediately, whatever the others say.
+    // But a `false` is only reportable if every comparator was understood:
+    // otherwise the honest answer is "do not know", and refusing on it would be
+    // the strict-direction failure this module is shaped to avoid.
+    let unknown = false;
+    for (const alt of text.split('||')) {
+        const comparators = alt.trim().split(/\s+/).filter((s) => '' !== s);
+        if (0 === comparators.length) {
+            unknown = true;
+            continue;
+        }
+        let all = true;
+        for (const c of comparators) {
+            const one = satisfiesOne(v, c);
+            if (null == one) {
+                unknown = true;
+                all = false;
+            }
+            else if (!one) {
+                all = false;
+            }
+        }
+        if (all) {
+            return true;
+        }
+    }
+    return unknown ? undefined : false;
+}
+//# sourceMappingURL=semver.js.map

package/dist/helpers/semver.js.map

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

package/dist/helpers/shipped.d.ts

@@ -0,0 +1,4 @@
+declare function packageRoot(): string;
+declare function schemaFile(): string;
+declare function scaffoldFolder(): string;
+export { packageRoot, schemaFile, scaffoldFolder, };

package/dist/helpers/shipped.js

@@ -0,0 +1,36 @@
+"use strict";
+// WHERE THIS GENERATOR'S OWN FILES ARE, resolved from the compiled code.
+//
+// Every other path in `action/` is relative to the PROJECT being operated on
+// — `node_modules/@voxgig/sdkgen/project/.sdk` is how a consumer reaches the
+// bundled scaffold, and that is correct there. `package check` has no project:
+// it is run by an AUTHOR against a package that may sit anywhere, and it
+// still needs this generator's base schema (to unify against) and its feature
+// catalogue (to know which names denote features). Those come from the
+// installation doing the checking, which is this one.
+//
+// `__dirname` is `dist/helpers` in the shipped package, so the package root is
+// two levels up. npm can only ship files under that root, which is why the
+// canonical `model/` is mirrored into `ts/model/` (the model-mirror guard
+// fails on drift).
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packageRoot = packageRoot;
+exports.schemaFile = schemaFile;
+exports.scaffoldFolder = scaffoldFolder;
+const node_path_1 = __importDefault(require("node:path"));
+function packageRoot() {
+    return node_path_1.default.resolve(__dirname, '..', '..');
+}
+// The base model schema — `@voxgig/sdkgen/model/sdkgen.aontu`.
+function schemaFile() {
+    return node_path_1.default.join(packageRoot(), 'model', 'sdkgen.aontu');
+}
+// The bundled scaffold — the `.sdk` of `ts/project`, which is itself an
+// sdkgen package.
+function scaffoldFolder() {
+    return node_path_1.default.join(packageRoot(), 'project', '.sdk');
+}
+//# sourceMappingURL=shipped.js.map

package/dist/helpers/shipped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipped.js","sourceRoot":"","sources":["../../src/helpers/shipped.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,yEAAyE;AACzE,8EAA8E;AAC9E,uEAAuE;AACvE,sDAAsD;AACtD,EAAE;AACF,+EAA+E;AAC/E,2EAA2E;AAC3E,0EAA0E;AAC1E,mBAAmB;;;;;QAwBjB,WAAW;QACX,UAAU;QACV,cAAc;AAxBhB,0DAA4B;AAG5B,SAAS,WAAW;IAClB,OAAO,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAC5C,CAAC;AAGD,+DAA+D;AAC/D,SAAS,UAAU;IACjB,OAAO,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,CAAA;AAC1D,CAAC;AAGD,wEAAwE;AACxE,kBAAkB;AAClB,SAAS,cAAc;IACrB,OAAO,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AACpD,CAAC"}

package/dist/helpers/stdrep.d.ts

@@ -1,3 +1,11 @@
 declare function ensureStdrep(ctx$: any): any;
 declare function templateReplacements(model: any, tname: string): Record<string, string>;
-export { ensureStdrep, templateReplacements, };
+type Provenance = {
+    base: string;
+    origname?: string;
+    name?: string;
+    package?: string;
+};
+declare function provenanceReplace(prov: Provenance): Record<string, string>;
+export type { Provenance, };
+export { ensureStdrep, templateReplacements, provenanceReplace, };

package/dist/helpers/stdrep.js

@@ -10,6 +10,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureStdrep = ensureStdrep;
 exports.templateReplacements = templateReplacements;
+exports.provenanceReplace = provenanceReplace;
 const packageMeta_1 = require("./packageMeta");
 // PROJECTENV — the env-var base for this SDK's `<BASE>_TEST_LIVE`,
 // `<BASE>_APIKEY` and friends.
@@ -44,4 +45,25 @@ function templateReplacements(model, tname) {
         PROJECTVERSION: (0, packageMeta_1.packageVersion)(model, tname),
     };
 }
+// Two spaces, matching every shipped model file's indentation for these keys.
+const PROVENANCE_INDENT = '  ';
+// A value as a single-quoted aontu string. These are PATHS and NAMES from the
+// filesystem, so they can legally contain a quote — `/home/o'connor/pkg` is a
+// valid directory — and concatenating one between quotes closes the string
+// early and leaves the copied model unparsable. Aontu accepts a backslash
+// escape, which keeps the quoting style every shipped model already uses.
+function aontuString(value) {
+    return "'" + String(value).replace(/\\/g, '\\\\').replace(/'/g, "\\'") + "'";
+}
+function provenanceReplace(prov) {
+    const lines = ['base: ' + aontuString(prov.base)];
+    if (null != prov.origname && null != prov.name &&
+        prov.origname !== prov.name) {
+        lines.push('origname: ' + aontuString(prov.origname));
+    }
+    if (null != prov.package && '' !== prov.package) {
+        lines.push('package: ' + aontuString(prov.package));
+    }
+    return { "base: 'BASE'": lines.join('\n' + PROVENANCE_INDENT) };
+}
 //# sourceMappingURL=stdrep.js.map

package/dist/helpers/stdrep.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdrep.js","sourceRoot":"","sources":["../../src/helpers/stdrep.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,EAAE;AACF,uDAAuD;AACvD,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,qEAAqE;;QA8CnE,YAAY;QACZ,oBAAoB;AA7CtB,+CAAuD;AAGvD,mEAAmE;AACnE,+BAA+B;AAC/B,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,uEAAuE;AACvE,SAAS,YAAY,CAAC,IAAS;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IAEhD,IAAI,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9B,MAAM,CAAC,UAAU,GAAG,IAAA,qBAAO,EAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAGD,4EAA4E;AAC5E,iBAAiB;AACjB,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,yEAAyE;AACzE,6EAA6E;AAC7E,wCAAwC;AACxC,SAAS,oBAAoB,CAAC,KAAU,EAAE,KAAa;IACrD,OAAO;QACL,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI;QAE/B,gEAAgE;QAChE,oEAAoE;QACpE,uEAAuE;QACvE,cAAc,EAAE,IAAA,4BAAc,EAAC,KAAK,EAAE,KAAK,CAAC;KAC7C,CAAA;AACH,CAAC"}
+{"version":3,"file":"stdrep.js","sourceRoot":"","sources":["../../src/helpers/stdrep.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,EAAE;AACF,uDAAuD;AACvD,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,qEAAqE;;QAmHnE,YAAY;QACZ,oBAAoB;QACpB,iBAAiB;AAnHnB,+CAAuD;AAGvD,mEAAmE;AACnE,+BAA+B;AAC/B,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,uEAAuE;AACvE,SAAS,YAAY,CAAC,IAAS;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IAEhD,IAAI,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9B,MAAM,CAAC,UAAU,GAAG,IAAA,qBAAO,EAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAGD,4EAA4E;AAC5E,iBAAiB;AACjB,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,yEAAyE;AACzE,6EAA6E;AAC7E,wCAAwC;AACxC,SAAS,oBAAoB,CAAC,KAAU,EAAE,KAAa;IACrD,OAAO;QACL,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI;QAE/B,gEAAgE;QAChE,oEAAoE;QACpE,uEAAuE;QACvE,cAAc,EAAE,IAAA,4BAAc,EAAC,KAAK,EAAE,KAAK,CAAC;KAC7C,CAAA;AACH,CAAC;AAsCD,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,IAAI,CAAA;AAG9B,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAC1E,0EAA0E;AAC1E,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,GAAG,CAAA;AAC9E,CAAC;AAGD,SAAS,iBAAiB,CAAC,IAAgB;IACzC,MAAM,KAAK,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAEjD,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI;QAC5C,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IACvD,CAAC;IAED,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IACrD,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,EAAE,CAAA;AACjE,CAAC"}

package/dist/sdkgen.d.ts

@@ -40,6 +40,9 @@ import type { ExampleLang } from './helpers/opExample';
 import { liveStrict } from './helpers/testPolicy';
 import { featureOf, availableFeatures, findFeatureSources, featureExcludes, fullsetExcludes, srcFeatureExcludes } from './helpers/featureSource';
 import type { FeatureSource } from './helpers/featureSource';
+import { definitionPath, definitionFolder, definitionNames } from './helpers/definition';
+import { MANIFEST, manifestPath, readManifest, validateManifest } from './helpers/manifest';
+import type { Manifest, ManifestRead } from './helpers/manifest';
 import { packageName, installCommand, registryState, isPublished, registryName, vendorCommand, pkgDescription, nonAffiliation, keywords, authorInfo, contributorList, envName, envToken, goModule, goVersion, goPackageIdent, packageVersion, repoInfo, apiName, langLabel, PUBLISHER, PUBLISHER_URL, SECURITY_EMAIL, GENERATOR_URL } from './helpers/packageMeta';
 import type { DoctorReport } from './action/doctor';
 type SdkGenOptions = {
@@ -70,19 +73,28 @@ declare function SdkGen(opts: SdkGenOptions): {
         ok: boolean;
         name: string;
     }>;
-    action: (args: string[]) => Promise<any>;
+    action: (args: string[], flags?: Record<string, any>) => Promise<any>;
     check: () => Promise<ActionResult>;
+    docs: {
+        add: (items: string[]) => Promise<ActionResult>;
+    };
     target: {
         add: (targets: string[]) => Promise<ActionResult>;
     };
     feature: {
         add: (features: string[]) => Promise<ActionResult>;
     };
+    package: {
+        add: (refs: string[], flags?: Record<string, any>) => Promise<ActionResult>;
+        list: () => Promise<ActionResult>;
+        update: (names: string[], flags?: Record<string, any>) => Promise<ActionResult>;
+        check: (refs?: string[]) => Promise<ActionResult>;
+    };
 };
 declare namespace SdkGen {
     var makeBuild: (opts: SdkGenOptions) => Promise<(model: any, build: any, ctx: any) => Promise<any>>;
 }
-export type { SdkGenOptions, ExampleLang, DepEntry, FeatureSource, DoctorReport, RegisterOptions, };
+export type { SdkGenOptions, ExampleLang, DepEntry, FeatureSource, DoctorReport, RegisterOptions, Manifest, ManifestRead, };
 export type { SdkModel, ModelKit, ModelTarget, ModelFeature, ModelEntity, ModelDep, ModelHook, } from './types';
 type Component = (props: any, children?: any) => void;
 export declare const cmp: (component: Function) => Component;
@@ -109,4 +121,4 @@ export declare const Inject: Component;
 export declare const Line: Component;
 export declare const Slot: Component;
 export declare const List: Component;
-export { Main, Deploy, License, Security, Changelog, Entity, Feature, Test, Readme, ReadmeTop, AgentGuideTop, AgentGuide, AgentGuideFeature, ReadmeInstall, ReadmeQuick, ReadmeErrors, ReadmeIntro, ReadmeModel, ReadmeOptions, ReadmeEntity, ReadmeHowto, ReadmeExplanation, ReadmeRef, FeatureHook, registerComponent, Jostraca, SdkGen, requirePath, isAuthActive, resolveAuthPrefix, CONFIG_DATA_THRESHOLD, CONFIG_REPR_VALUES, isConfigData, configRepr, configReprSetting, configDefinition, clean, rawStringLiteral, SdkGenError, buildIdNames, getMatchEntries, collectDeps, canonToType, canonToDtype, canonKey, OP_SUFFIX, opTypeName, opParams, opActions, entityActions, entityPath, opRequestShape, entityIdField, entityDataIdField, entityOps, entityPrimaryOp, pickExampleEntity, entityClassName, entityTypeCollisions, warnEntityTypeCollisions, deriveEntityNames, entityCollection, isReservedName, safeVarName, exampleVarName, phpEntityAccessor, entityCacheField, isRbCoreConstant, rbSafeTypeName, isSwiftSdkType, swiftSafeTypeName, serverVariables, hasServerVariables, liveStrict, primaryOpCall, idLiteral, matchArg, dataArg, litFor, featureOf, availableFeatures, findFeatureSources, featureExcludes, fullsetExcludes, srcFeatureExcludes, jsProp, jsOptProp, jsKey, packageName, installCommand, registryState, isPublished, registryName, vendorCommand, pkgDescription, nonAffiliation, keywords, authorInfo, contributorList, envName, envToken, goModule, goVersion, goPackageIdent, packageVersion, repoInfo, apiName, langLabel, PUBLISHER, PUBLISHER_URL, SECURITY_EMAIL, GENERATOR_URL, };
+export { Main, Deploy, License, Security, Changelog, Entity, Feature, Test, Readme, ReadmeTop, AgentGuideTop, AgentGuide, AgentGuideFeature, ReadmeInstall, ReadmeQuick, ReadmeErrors, ReadmeIntro, ReadmeModel, ReadmeOptions, ReadmeEntity, ReadmeHowto, ReadmeExplanation, ReadmeRef, FeatureHook, registerComponent, Jostraca, SdkGen, requirePath, isAuthActive, resolveAuthPrefix, CONFIG_DATA_THRESHOLD, CONFIG_REPR_VALUES, isConfigData, configRepr, configReprSetting, configDefinition, clean, rawStringLiteral, SdkGenError, buildIdNames, getMatchEntries, collectDeps, canonToType, canonToDtype, canonKey, OP_SUFFIX, opTypeName, opParams, opActions, entityActions, entityPath, opRequestShape, entityIdField, entityDataIdField, entityOps, entityPrimaryOp, pickExampleEntity, entityClassName, entityTypeCollisions, warnEntityTypeCollisions, deriveEntityNames, entityCollection, isReservedName, safeVarName, exampleVarName, phpEntityAccessor, entityCacheField, isRbCoreConstant, rbSafeTypeName, isSwiftSdkType, swiftSafeTypeName, serverVariables, hasServerVariables, liveStrict, primaryOpCall, idLiteral, matchArg, dataArg, litFor, featureOf, availableFeatures, findFeatureSources, featureExcludes, fullsetExcludes, srcFeatureExcludes, definitionPath, definitionFolder, definitionNames, MANIFEST, manifestPath, readManifest, validateManifest, jsProp, jsOptProp, jsKey, packageName, installCommand, registryState, isPublished, registryName, vendorCommand, pkgDescription, nonAffiliation, keywords, authorInfo, contributorList, envName, envToken, goModule, goVersion, goPackageIdent, packageVersion, repoInfo, apiName, langLabel, PUBLISHER, PUBLISHER_URL, SECURITY_EMAIL, GENERATOR_URL, };