@voxgig/sdkgen 0.43.0 → 0.45.0

package/bin/voxgig-sdkgen

@@ -8,7 +8,7 @@ const { Shape, One } = require('shape')
 
 const { SdkGen } = require('../dist/sdkgen.js')
 
-const VERSION = '0.43.0'
+const VERSION = '0.45.0'
 const KONSOLE = console
 
 

package/dist/cmp/ReadmeEntity.js

@@ -2,161 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReadmeEntity = void 0;
 const jostraca_1 = require("jostraca");
-const types_1 = require("../types");
-const OP_DESC = {
-    load: { method: 'load(match)', goMethod: 'Load(match, ctrl)', desc: 'Load a single entity by match criteria.' },
-    list: { method: 'list(match)', goMethod: 'List(match, ctrl)', desc: 'List entities matching the criteria.' },
-    create: { method: 'create(data)', goMethod: 'Create(data, ctrl)', desc: 'Create a new entity with the given data.' },
-    update: { method: 'update(data)', goMethod: 'Update(data, ctrl)', desc: 'Update an existing entity.' },
-    remove: { method: 'remove(match)', goMethod: 'Remove(match, ctrl)', desc: 'Remove the matching entity.' },
-};
+const utility_1 = require("../utility");
+// Per-language Entities section lives in
+// `project/.sdk/src/cmp/<lang>/ReadmeEntity_<lang>.ts`.
+// Each language emits its own create-instance call style and
+// op-method spelling (Go's `Load(match, ctrl)` vs TS's `load(match)`).
 const ReadmeEntity = (0, jostraca_1.cmp)(function ReadmeEntity(props) {
-    const { target } = props;
-    const { model } = props.ctx$;
-    const entity = (0, types_1.getModelPath)(model, `main.${types_1.KIT}.entity`);
-    const isGo = target.name === 'go';
-    const lang = isGo ? 'go' : 'ts';
-    const publishedEntities = (0, jostraca_1.each)(entity)
-        .filter((entity) => entity.active !== false);
-    if (0 === publishedEntities.length) {
-        return;
+    const { target, ctx$ } = props;
+    const ReadmeEntity_sdk = (0, utility_1.requirePath)(ctx$, `./cmp/${target.name}/ReadmeEntity_${target.name}`, { ignore: true });
+    if (ReadmeEntity_sdk) {
+        ReadmeEntity_sdk['ReadmeEntity']({ target });
     }
-    (0, jostraca_1.Content)(`
-
-## Entities
-
-`);
-    publishedEntities.map((entity) => {
-        const opnames = Object.keys(entity.op || {});
-        const fields = entity.fields || [];
-        (0, jostraca_1.Content)(`
-### ${entity.Name}
-
-`);
-        if (entity.short) {
-            (0, jostraca_1.Content)(`${entity.short}
-
-`);
-        }
-        if (isGo) {
-            (0, jostraca_1.Content)(`Create an instance: \`${entity.name} := client.${entity.Name}(nil)\`
-
-`);
-        }
-        else {
-            (0, jostraca_1.Content)(`Create an instance: \`const ${entity.name} = client.${entity.Name}()\`
-
-`);
-        }
-        // Operations table
-        if (opnames.length > 0) {
-            (0, jostraca_1.Content)(`#### Operations
-
-| Method | Description |
-| --- | --- |
-`);
-            opnames.map((opname) => {
-                const info = OP_DESC[opname];
-                if (info) {
-                    const method = isGo ? info.goMethod : info.method;
-                    (0, jostraca_1.Content)(`| \`${method}\` | ${info.desc} |
-`);
-                }
-            });
-            (0, jostraca_1.Content)(`
-`);
-        }
-        // Fields table
-        if (fields.length > 0) {
-            (0, jostraca_1.Content)(`#### Fields
-
-| Field | Type | Description |
-| --- | --- | --- |
-`);
-            (0, jostraca_1.each)(fields, (field) => {
-                const desc = field.short || '';
-                (0, jostraca_1.Content)(`| \`${field.name}\` | \`${field.type || 'any'}\` | ${desc} |
-`);
-            });
-            (0, jostraca_1.Content)(`
-`);
-        }
-        // Example usage
-        if (isGo) {
-            if (opnames.includes('load')) {
-                (0, jostraca_1.Content)(`#### Example: Load
-
-\`\`\`go
-result, err := client.${entity.Name}(nil).Load(map[string]any{"id": "${entity.name}_id"}, nil)
-\`\`\`
-
-`);
-            }
-            if (opnames.includes('list')) {
-                (0, jostraca_1.Content)(`#### Example: List
-
-\`\`\`go
-results, err := client.${entity.Name}(nil).List(nil, nil)
-\`\`\`
-
-`);
-            }
-            if (opnames.includes('create')) {
-                (0, jostraca_1.Content)(`#### Example: Create
-
-\`\`\`go
-result, err := client.${entity.Name}(nil).Create(map[string]any{
-`);
-                (0, jostraca_1.each)(fields, (field) => {
-                    if ('id' !== field.name && field.req) {
-                        (0, jostraca_1.Content)(`    "${field.name}": /* ${field.type || 'value'} */,
-`);
-                    }
-                });
-                (0, jostraca_1.Content)(`}, nil)
-\`\`\`
-
-`);
-            }
-        }
-        else {
-            if (opnames.includes('load')) {
-                (0, jostraca_1.Content)(`#### Example: Load
-
-\`\`\`ts
-const ${entity.name} = await client.${entity.Name}().load({ id: '${entity.name}_id' })
-\`\`\`
-
-`);
-            }
-            if (opnames.includes('list')) {
-                (0, jostraca_1.Content)(`#### Example: List
-
-\`\`\`ts
-const ${entity.name}s = await client.${entity.Name}().list()
-\`\`\`
-
-`);
-            }
-            if (opnames.includes('create')) {
-                (0, jostraca_1.Content)(`#### Example: Create
-
-\`\`\`ts
-const ${entity.name} = await client.${entity.Name}().create({
-`);
-                (0, jostraca_1.each)(fields, (field) => {
-                    if ('id' !== field.name && field.req) {
-                        (0, jostraca_1.Content)(`  ${field.name}: /* ${field.type || 'value'} */,
-`);
-                    }
-                });
-                (0, jostraca_1.Content)(`})
-\`\`\`
-
-`);
-            }
-        }
-    });
 });
 exports.ReadmeEntity = ReadmeEntity;
 //# sourceMappingURL=ReadmeEntity.js.map

package/dist/cmp/ReadmeEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadmeEntity.js","sourceRoot":"","sources":["../../src/cmp/ReadmeEntity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReadmeEntity.js","sourceRoot":"","sources":["../../src/cmp/ReadmeEntity.ts"],"names":[],"mappings":";;;AACA,uCAA8B;AAE9B,wCAAwC;AAGxC,yCAAyC;AACzC,wDAAwD;AACxD,6DAA6D;AAC7D,uEAAuE;AACvE,MAAM,YAAY,GAAG,IAAA,cAAG,EAAC,SAAS,YAAY,CAAC,KAAU;IACvD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAE9B,MAAM,gBAAgB,GACpB,IAAA,qBAAW,EAAC,IAAI,EAAE,SAAS,MAAM,CAAC,IAAI,iBAAiB,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAEzF,IAAI,gBAAgB,EAAE,CAAC;QACrB,gBAAgB,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAC,CAAA;AAIA,oCAAY"}

package/dist/cmp/ReadmeIntro.js

@@ -2,21 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReadmeIntro = void 0;
 const jostraca_1 = require("jostraca");
-const TARGET_INTRO = {
-    ts: 'Provides a type-safe,\nentity-oriented interface with full async/await support.',
-    go: 'Provides an entity-oriented interface\nusing standard Go conventions \u2014 no generics required, data flows as\n`map[string]any`.',
-    js: 'Provides an entity-oriented\ninterface with full async/await support.',
-};
+const utility_1 = require("../utility");
+// Per-language intro lives in `project/.sdk/src/cmp/<lang>/ReadmeIntro_<lang>.ts`.
+// Each language declares its own tagline and stylistic emphasis (Go's
+// `map[string]any` data-flow note, TS's async/await emphasis, etc.).
 const ReadmeIntro = (0, jostraca_1.cmp)(function ReadmeIntro(props) {
-    const { target } = props;
-    const { model } = props.ctx$;
-    const desc = model.main.def.desc || '';
-    const targetIntro = TARGET_INTRO[target.name] || 'Provides an entity-oriented interface.';
-    (0, jostraca_1.Content)(`# ${model.Name} ${target.title} SDK
-
-The ${target.title} SDK for the ${model.Name} API. ${targetIntro}
-
-`);
+    const { target, ctx$ } = props;
+    const ReadmeIntro_sdk = (0, utility_1.requirePath)(ctx$, `./cmp/${target.name}/ReadmeIntro_${target.name}`, { ignore: true });
+    if (ReadmeIntro_sdk) {
+        ReadmeIntro_sdk['ReadmeIntro']({ target });
+    }
 });
 exports.ReadmeIntro = ReadmeIntro;
 //# sourceMappingURL=ReadmeIntro.js.map

package/dist/cmp/ReadmeIntro.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadmeIntro.js","sourceRoot":"","sources":["../../src/cmp/ReadmeIntro.ts"],"names":[],"mappings":";;;AACA,uCAAuC;AAQvC,MAAM,YAAY,GAA2B;IAC3C,EAAE,EAAE,iFAAiF;IACrF,EAAE,EAAE,oIAAoI;IACxI,EAAE,EAAE,uEAAuE;CAC5E,CAAA;AAGD,MAAM,WAAW,GAAG,IAAA,cAAG,EAAC,SAAS,WAAW,CAAC,KAAU;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAA;IAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;IAEtC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,wCAAwC,CAAA;IAEzF,IAAA,kBAAO,EAAC,KAAK,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK;;MAEnC,MAAM,CAAC,KAAK,gBAAgB,KAAK,CAAC,IAAI,SAAS,WAAW;;CAE/D,CAAC,CAAA;AAEF,CAAC,CAAC,CAAA;AAMA,kCAAW"}
+{"version":3,"file":"ReadmeIntro.js","sourceRoot":"","sources":["../../src/cmp/ReadmeIntro.ts"],"names":[],"mappings":";;;AACA,uCAA8B;AAE9B,wCAAwC;AAGxC,mFAAmF;AACnF,sEAAsE;AACtE,qEAAqE;AACrE,MAAM,WAAW,GAAG,IAAA,cAAG,EAAC,SAAS,WAAW,CAAC,KAAU;IACrD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAE9B,MAAM,eAAe,GACnB,IAAA,qBAAW,EAAC,IAAI,EAAE,SAAS,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAExF,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC,CAAC,CAAA;AAIA,kCAAW"}

package/dist/cmp/ReadmeModel.js

@@ -20,20 +20,22 @@ const ReadmeModel = (0, jostraca_1.cmp)(function ReadmeModel(props) {
     }
     else {
         // Fallback: generic reference summary
-        ReadmeModelGeneric({ target, model, entityList });
+        ReadmeModelGeneric({ target, model, entityList, authActive: (0, utility_1.isAuthActive)(model) });
     }
 });
 exports.ReadmeModel = ReadmeModel;
 const ReadmeModelGeneric = (0, jostraca_1.cmp)(function ReadmeModelGeneric(props) {
-    const { target, model, entityList } = props;
+    const { target, model, entityList, authActive } = props;
+    const apikeyRow = authActive
+        ? '| `apikey` | `string` | API key for authentication. |\n'
+        : '';
     (0, jostraca_1.Content)(`### ${model.Name}SDK
 
 #### Constructor
 
 | Option | Type | Description |
 | --- | --- | --- |
-| \`apikey\` | \`string\` | API key for authentication. |
-| \`base\` | \`string\` | Base URL of the API server. |
+${apikeyRow}| \`base\` | \`string\` | Base URL of the API server. |
 | \`prefix\` | \`string\` | URL path prefix prepended to all requests. |
 | \`suffix\` | \`string\` | URL path suffix appended to all requests. |
 | \`feature\` | \`object\` | Feature activation flags. |

package/dist/cmp/ReadmeModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadmeModel.js","sourceRoot":"","sources":["../../src/cmp/ReadmeModel.ts"],"names":[],"mappings":";;;AACA,uCAA6C;AAE7C,oCAGiB;AAEjB,wCAAwC;AAGxC,MAAM,WAAW,GAAG,IAAA,cAAG,EAAC,SAAS,WAAW,CAAC,KAAU;IACrD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAEtB,MAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,KAAK,EAAE,QAAQ,WAAG,SAAS,CAAC,CAAA;IACxD,MAAM,UAAU,GAAG,IAAA,eAAI,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAA;IAEtE,IAAA,kBAAO,EAAC;;;CAGT,CAAC,CAAA;IAEA,gDAAgD;IAChD,MAAM,eAAe,GACnB,IAAA,qBAAW,EAAC,IAAI,EAAE,SAAS,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAExF,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC;SACI,CAAC;QACJ,sCAAsC;QACtC,kBAAkB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;IACnD,CAAC;AACH,CAAC,CAAC,CAAA;AAkEA,kCAAW;AA/Db,MAAM,kBAAkB,GAAG,IAAA,cAAG,EAAC,SAAS,kBAAkB,CAAC,KAAU;IACnE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IAE3C,IAAA,kBAAO,EAAC,OAAO,KAAK,CAAC,IAAI;;;;;;;;;;;;;;;;;CAiB1B,CAAC,CAAA;IAEA,IAAA,eAAI,EAAC,UAAU,EAAE,CAAC,GAAQ,EAAE,EAAE;QAC5B,IAAA,kBAAO,EAAC,OAAO,GAAG,CAAC,IAAI,iBAAiB,GAAG,CAAC,IAAI,uBAAuB,GAAG,CAAC,IAAI;CAClF,CAAC,CAAA;IACA,CAAC,CAAC,CAAA;IAEF,IAAA,kBAAO,EAAC;;;;wCAI8B,KAAK,CAAC,IAAI;;;;;;MAM5C,KAAK,CAAC,IAAI,uCAAuC,KAAK,CAAC,IAAI;;;;;;;;;;;;;;;;;;;CAmBhE,CAAC,CAAA;AACF,CAAC,CAAC,CAAA"}
+{"version":3,"file":"ReadmeModel.js","sourceRoot":"","sources":["../../src/cmp/ReadmeModel.ts"],"names":[],"mappings":";;;AACA,uCAA6C;AAE7C,oCAGiB;AAEjB,wCAAsD;AAGtD,MAAM,WAAW,GAAG,IAAA,cAAG,EAAC,SAAS,WAAW,CAAC,KAAU;IACrD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAEtB,MAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,KAAK,EAAE,QAAQ,WAAG,SAAS,CAAC,CAAA;IACxD,MAAM,UAAU,GAAG,IAAA,eAAI,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAA;IAEtE,IAAA,kBAAO,EAAC;;;CAGT,CAAC,CAAA;IAEA,gDAAgD;IAChD,MAAM,eAAe,GACnB,IAAA,qBAAW,EAAC,IAAI,EAAE,SAAS,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAExF,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC;SACI,CAAC;QACJ,sCAAsC;QACtC,kBAAkB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,IAAA,sBAAY,EAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACpF,CAAC;AACH,CAAC,CAAC,CAAA;AAoEA,kCAAW;AAjEb,MAAM,kBAAkB,GAAG,IAAA,cAAG,EAAC,SAAS,kBAAkB,CAAC,KAAU;IACnE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IACvD,MAAM,SAAS,GAAG,UAAU;QAC1B,CAAC,CAAC,yDAAyD;QAC3D,CAAC,CAAC,EAAE,CAAA;IAEN,IAAA,kBAAO,EAAC,OAAO,KAAK,CAAC,IAAI;;;;;;EAMzB,SAAS;;;;;;;;;;CAUV,CAAC,CAAA;IAEA,IAAA,eAAI,EAAC,UAAU,EAAE,CAAC,GAAQ,EAAE,EAAE;QAC5B,IAAA,kBAAO,EAAC,OAAO,GAAG,CAAC,IAAI,iBAAiB,GAAG,CAAC,IAAI,uBAAuB,GAAG,CAAC,IAAI;CAClF,CAAC,CAAA;IACA,CAAC,CAAC,CAAA;IAEF,IAAA,kBAAO,EAAC;;;;wCAI8B,KAAK,CAAC,IAAI;;;;;;MAM5C,KAAK,CAAC,IAAI,uCAAuC,KAAK,CAAC,IAAI;;;;;;;;;;;;;;;;;;;CAmBhE,CAAC,CAAA;AACF,CAAC,CAAC,CAAA"}

package/dist/cmp/ReadmeOptions.js

@@ -2,69 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReadmeOptions = void 0;
 const jostraca_1 = require("jostraca");
+const utility_1 = require("../utility");
+// Per-language Options block lives in
+// `project/.sdk/src/cmp/<lang>/ReadmeOptions_<lang>.ts`.
+// Each language emits its own constructor-call shape and option-table
+// formatting; they share the data source (target.options).
 const ReadmeOptions = (0, jostraca_1.cmp)(function ReadmeOptions(props) {
-    const { target } = props;
-    const { model } = props.ctx$;
-    const isGo = target.name === 'go';
-    const publishedOptions = (0, jostraca_1.each)(target.options)
-        .filter((option) => option.publish);
-    if (0 === publishedOptions.length) {
-        return;
+    const { target, ctx$ } = props;
+    const ReadmeOptions_sdk = (0, utility_1.requirePath)(ctx$, `./cmp/${target.name}/ReadmeOptions_${target.name}`, { ignore: true });
+    if (ReadmeOptions_sdk) {
+        ReadmeOptions_sdk['ReadmeOptions']({ target });
     }
-    (0, jostraca_1.Content)(`
-
-## Options
-
-Pass options when creating a client instance:
-
-`);
-    if (isGo) {
-        (0, jostraca_1.Content)(`\`\`\`go
-client := sdk.New${model.const.Name}SDK(map[string]any{
-`);
-        publishedOptions.map((option) => {
-            if ('apikey' === option.name) {
-                (0, jostraca_1.Content)(`    "${option.name}": os.Getenv("${model.NAME}_APIKEY"),
-`);
-            }
-            else {
-                (0, jostraca_1.Content)(`    // "${option.name}": ${option.kind === 'string' ? '"..."' : '...'},
-`);
-            }
-        });
-        (0, jostraca_1.Content)(`})
-\`\`\`
-
-`);
-    }
-    else {
-        (0, jostraca_1.Content)(`\`\`\`ts
-const client = new ${model.Name}SDK({
-`);
-        publishedOptions.map((option) => {
-            if ('apikey' === option.name) {
-                (0, jostraca_1.Content)(`  ${option.name}: process.env.${model.NAME}_APIKEY,
-`);
-            }
-            else {
-                (0, jostraca_1.Content)(`  // ${option.name}: ${option.kind === 'string' ? "'...'" : '...'},
-`);
-            }
-        });
-        (0, jostraca_1.Content)(`})
-\`\`\`
-
-`);
-    }
-    (0, jostraca_1.Content)(`| Option | Type | Description |
-| --- | --- | --- |
-`);
-    publishedOptions.map((option) => {
-        (0, jostraca_1.Content)(`| \`${option.name}\` | \`${option.kind}\` | ${option.short} |
-`);
-    });
-    (0, jostraca_1.Content)(`
-`);
 });
 exports.ReadmeOptions = ReadmeOptions;
 //# sourceMappingURL=ReadmeOptions.js.map

package/dist/cmp/ReadmeOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadmeOptions.js","sourceRoot":"","sources":["../../src/cmp/ReadmeOptions.ts"],"names":[],"mappings":";;;AACA,uCAA6C;AAG7C,MAAM,aAAa,GAAG,IAAA,cAAG,EAAC,SAAS,aAAa,CAAC,KAAU;IACzD,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAA;IAE5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,IAAI,CAAA;IAEjC,MAAM,gBAAgB,GAAG,IAAA,eAAI,EAAC,MAAM,CAAC,OAAO,CAAC;SAC1C,MAAM,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAE1C,IAAI,CAAC,KAAK,gBAAgB,CAAC,MAAM,EAAE,CAAC;QAClC,OAAM;IACR,CAAC;IAED,IAAA,kBAAO,EAAC;;;;;;CAMT,CAAC,CAAA;IAEA,IAAI,IAAI,EAAE,CAAC;QACT,IAAA,kBAAO,EAAC;mBACO,KAAK,CAAC,KAAK,CAAC,IAAI;CAClC,CAAC,CAAA;QAEE,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE;YACnC,IAAI,QAAQ,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAA,kBAAO,EAAC,QAAQ,MAAM,CAAC,IAAI,iBAAiB,KAAK,CAAC,IAAI;CAC7D,CAAC,CAAA;YACI,CAAC;iBACI,CAAC;gBACJ,IAAA,kBAAO,EAAC,WAAW,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;CACrF,CAAC,CAAA;YACI,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,IAAA,kBAAO,EAAC;;;CAGX,CAAC,CAAA;IACA,CAAC;SACI,CAAC;QACJ,IAAA,kBAAO,EAAC;qBACS,KAAK,CAAC,IAAI;CAC9B,CAAC,CAAA;QAEE,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE;YACnC,IAAI,QAAQ,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAA,kBAAO,EAAC,KAAK,MAAM,CAAC,IAAI,iBAAiB,KAAK,CAAC,IAAI;CAC1D,CAAC,CAAA;YACI,CAAC;iBACI,CAAC;gBACJ,IAAA,kBAAO,EAAC,QAAQ,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;CACjF,CAAC,CAAA;YACI,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,IAAA,kBAAO,EAAC;;;CAGX,CAAC,CAAA;IACA,CAAC;IAED,IAAA,kBAAO,EAAC;;CAET,CAAC,CAAA;IAEA,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE;QACnC,IAAA,kBAAO,EAAC,OAAO,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,KAAK;CACtE,CAAC,CAAA;IACA,CAAC,CAAC,CAAA;IAEF,IAAA,kBAAO,EAAC;CACT,CAAC,CAAA;AAEF,CAAC,CAAC,CAAA;AAKA,sCAAa"}
+{"version":3,"file":"ReadmeOptions.js","sourceRoot":"","sources":["../../src/cmp/ReadmeOptions.ts"],"names":[],"mappings":";;;AACA,uCAA8B;AAE9B,wCAAwC;AAGxC,sCAAsC;AACtC,yDAAyD;AACzD,sEAAsE;AACtE,2DAA2D;AAC3D,MAAM,aAAa,GAAG,IAAA,cAAG,EAAC,SAAS,aAAa,CAAC,KAAU;IACzD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAE9B,MAAM,iBAAiB,GACrB,IAAA,qBAAW,EAAC,IAAI,EAAE,SAAS,MAAM,CAAC,IAAI,kBAAkB,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAE1F,IAAI,iBAAiB,EAAE,CAAC;QACtB,iBAAiB,CAAC,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAChD,CAAC;AACH,CAAC,CAAC,CAAA;AAIA,sCAAa"}