@voxgig/build 4.3.0 → 4.11.0

package/README.md

@@ -1,5 +1,54 @@
-# Build
+# @voxgig/build
 
-PROTOTYPE.
+Code generation for Voxgig system projects. Reads the compiled
+[voxgig-model](https://github.com/voxgig/model) (`model.json`) and generates
+deployment artifacts and application code with the
+[jostraca](https://github.com/jostraca/jostraca) templating library:
 
+- **EnvLambda** — AWS Lambda deployment templates (Serverless function
+  defs, per-service handlers, resources).
+- **EnvGen** — per-environment deployment artifacts (`local`, `basic`,
+  `docker`, `vm`, `aws`, `azure`, `cloudflare`, `web`) driven by the
+  model's `main: env:` declarations.
+- **EnvWeb** — a full model-driven enterprise web app: SPA frontend
+  (public site, login, app shell, generic entity CRUD with relationship
+  navigation, settings), backend web runner, auth + generic entity
+  services, design themes, customisation hooks, and custom entity views.
+- **Docs** — model-driven documentation for generated projects: mermaid
+  ER / message-flow / system-map diagrams and per-service READMEs,
+  regenerated on every model-build.
+- **Api** — a strict-JSON REST API defined by the model (`main.api`):
+  uniform entity paths, API-key auth, an OpenAPI spec generated from the
+  entity field definitions, and generated request-validation shapes.
 
+Generation is normally driven by `npm run model-build` inside a project
+created with `npm create @voxgig/system` — you rarely call this package
+directly.
+
+## Documentation
+
+Organised by the [Diátaxis](https://diataxis.fr) framework:
+
+- **Tutorial**: [From model to generated app](docs/tutorial.md)
+- **How-to guides**:
+  - [Customise generation templates](docs/how-to/customise-templates.md)
+  - [Generate the web app (EnvWeb)](docs/how-to/generate-the-web-app.md)
+  - [Add a target environment](docs/how-to/add-an-environment.md)
+- **Reference**:
+  - [Public API](docs/reference/api.md)
+  - [EnvWeb: files, slots, model inputs](docs/reference/envweb.md)
+- **Explanation**: [Design](docs/explanation/design.md)
+
+Working on this repo with an AI agent? See [AGENTS.md](AGENTS.md).
+
+## Develop
+
+```bash
+npm install
+npm run build   # tsc -> dist/ (dist is committed; always rebuild before commit)
+npm test        # node:test + coverage thresholds
+```
+
+## License
+
+MIT. Copyright (c) Voxgig Ltd.

package/build.ts

@@ -19,6 +19,8 @@ import { resources_yml } from './env/lambda/res_yml'
 
 import { env_gen, ENV_FILES, ENV_SRC, KINDS as ENV_KINDS } from './env/env_gen'
 import { web_gen, WEB_FILES } from './env/web/web_gen'
+import { doc_gen } from './doc/doc_gen'
+import { api_gen } from './api/api_gen'
 
 import {
   generate, empty, TM,
@@ -55,6 +57,22 @@ const EnvWeb = {
 }
 
 
+// Docs: model-driven documentation (mermaid ER/message-flow/system-map
+// diagrams + per-service READMEs), regenerated every model-build. See
+// doc/doc_gen.ts.
+const Docs = {
+  doc_gen,
+}
+
+
+// Api: the strict-JSON REST API (model main.api) - OpenAPI spec from the
+// entity field definitions + generated request-validation shapes. See
+// api/api_gen.ts.
+const Api = {
+  api_gen,
+}
+
+
 // Fragment tooling (used by voxgig-system template list/eject/diff, and
 // available to project code).
 const Fragments = {
@@ -69,6 +87,8 @@ export {
   EnvLambda,
   EnvGen,
   EnvWeb,
+  Docs,
+  Api,
   Fragments,
 
   // Building blocks for ejected project templates (src/gen/<name>.ts

package/dist/api/api_gen.d.ts

@@ -0,0 +1,7 @@
+type ApiSpec = {
+    root: string;
+};
+declare const api_gen: (model: any, spec: ApiSpec) => Promise<{
+    created: string[];
+}>;
+export { api_gen, };

package/dist/api/api_gen.js

@@ -0,0 +1,370 @@
+"use strict";
+/* Copyright © 2026 Voxgig Ltd, MIT License. */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.api_gen = void 0;
+// Api: generation for the strict-JSON REST API (model main.api).
+// Regenerated on every model-build (pure functions of the model,
+// content-diffed, AUTO-GENERATED):
+//
+//   backend/gen/api/openapi.json      OpenAPI 3.1 spec; schemas from the
+//                                     entity field definitions (an entity
+//                                     response schema plus <Name>Create /
+//                                     <Name>Update request schemas, which
+//                                     mirror the gubu shapes below)
+//   backend/gen/api/openapi.yaml      the same spec in YAML - the format
+//                                     most SDK/codegen tools (incl.
+//                                     @voxgig/sdkgen) expect
+//   backend/src/srv/api/valid_gen.ts  gubu shapes per exposed entity op,
+//                                     used by the api service to validate
+//                                     request bodies (strict: closed)
+//
+// The JSON and YAML are the SAME object (openapi(model)), just serialized
+// twice - they never diverge.
+//
+// Exposure rules (same as the api service's expose.ts): application
+// entities are exposed by default, the sys zone never is, per-entity
+// overrides live under main.api.ent.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+// Server-managed fields: never client-writable (and readOnly in OpenAPI).
+const MANAGED = ['id', 'owner_id', 't_c', 't_m'];
+function apiConf(model) {
+    const api = (model.main && model.main.api) || {};
+    return {
+        active: false !== api.active && null != model.main.api,
+        prefix: api.prefix || '/api',
+        version: api.version || 'v1',
+        ent: api.ent || {},
+    };
+}
+function exposed(model) {
+    const conf = apiConf(model);
+    const out = [];
+    const zones = (model.main && model.main.ent) || {};
+    for (const zone of Object.keys(zones)) {
+        if ('sys' === zone) {
+            continue;
+        }
+        for (const name of Object.keys(zones[zone])) {
+            const canon = zone + '/' + name;
+            const entconf = conf.ent[canon];
+            if (entconf && false === entconf.active) {
+                continue;
+            }
+            out.push({ canon, zone, name, def: zones[zone][name] || {} });
+        }
+    }
+    return out.sort((a, b) => a.canon < b.canon ? -1 : 1);
+}
+function fieldsOf(def) {
+    const out = [];
+    const fields = def.field || {};
+    for (const fname of Object.keys(fields).sort()) {
+        const f = fields[fname] || {};
+        const valid = null == f.valid ? '' : String(f.valid);
+        out.push({
+            name: fname,
+            kind: ['String', 'Number', 'Boolean'].includes(f.kind) ? f.kind : 'String',
+            required: !MANAGED.includes(fname) && !/Skip/.test(valid),
+            managed: MANAGED.includes(fname),
+            label: f.label || fname,
+            ref: f.ref,
+        });
+    }
+    return out;
+}
+// ---- valid_gen.ts ----
+function validGenTs(model) {
+    const ents = exposed(model);
+    const lines = [];
+    lines.push('/* AUTO-GENERATED from the model by @voxgig/build (api_gen) - do not edit.');
+    lines.push('   Regenerated on every model-build. */');
+    lines.push('');
+    lines.push('// Request-body validation shapes for the REST API, derived from the');
+    lines.push('// entity field definitions. Shapes are CLOSED (strict JSON: unknown');
+    lines.push('// fields are rejected); server-managed fields (' + MANAGED.join(', ') + ')');
+    lines.push('// are excluded entirely. create requires the required fields; update');
+    lines.push('// accepts any subset (partial).');
+    lines.push('');
+    lines.push('module.exports = function makeShapes(Gubu: any) {');
+    lines.push('  const { Skip } = Gubu');
+    lines.push('  const shapes: any = {}');
+    lines.push('');
+    for (const e of ents) {
+        const flds = fieldsOf(e.def).filter((f) => !f.managed);
+        const create = flds.map((f) => `      ${f.name}: ${f.required ? f.kind : `Skip(${f.kind})`},`);
+        const update = flds.map((f) => `      ${f.name}: Skip(${f.kind}),`);
+        lines.push(`  shapes['${e.canon}'] = {`);
+        lines.push('    create: Gubu({');
+        lines.push(...create);
+        lines.push('    }),');
+        lines.push('    update: Gubu({');
+        lines.push(...update);
+        lines.push('    }),');
+        lines.push('  }');
+        lines.push('');
+    }
+    lines.push('  return shapes');
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+// ---- openapi.json ----
+const KINDTYPE = {
+    String: 'string', Number: 'number', Boolean: 'boolean',
+};
+function openapi(model) {
+    const conf = apiConf(model);
+    const core = (model.main.conf && model.main.conf.core) || {};
+    const ents = exposed(model);
+    const schemas = {
+        Error: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                error: {
+                    type: 'object',
+                    additionalProperties: true,
+                    properties: {
+                        code: { type: 'string' },
+                        message: { type: 'string' },
+                        details: { type: 'array', items: { type: 'object' } },
+                    },
+                    required: ['code'],
+                },
+            },
+            required: ['error'],
+        },
+    };
+    const paths = {};
+    for (const e of ents) {
+        const sname = schemaName(e.canon);
+        const flds = fieldsOf(e.def);
+        const properties = {};
+        const required = [];
+        for (const f of flds) {
+            properties[f.name] = { type: KINDTYPE[f.kind], title: f.label };
+            if (f.managed) {
+                properties[f.name].readOnly = true;
+            }
+            if (f.ref) {
+                properties[f.name].description = 'Reference to ' + f.ref;
+            }
+            if (f.required) {
+                required.push(f.name);
+            }
+        }
+        schemas[sname] = {
+            type: 'object',
+            additionalProperties: false,
+            properties,
+            ...(required.length ? { required } : {}),
+        };
+        // Request bodies are NOT the entity schema. The entity schema describes
+        // what comes back - it carries the server-managed fields, and its
+        // `required` list is the create contract. What the server ACCEPTS is
+        // narrower, and differs per op (see validGenTs, which derives the
+        // enforcing gubu shapes from these same fields):
+        //
+        //   create  managed fields rejected; required fields required
+        //   update  managed fields rejected; everything optional (partial)
+        //
+        // Marking the managed fields `readOnly` on the entity schema is not
+        // enough on its own. It is the correct OpenAPI signal, but a closed
+        // schema (`additionalProperties: false`) plus `readOnly` is a
+        // combination most codegen tools ignore - they emit a request type with
+        // every property - so a generated client sends `id` and the closed gubu
+        // shape rejects the whole body with 400. Separate request schemas say
+        // the same thing in a form every tool understands.
+        const writable = flds.filter((f) => !f.managed);
+        const writableProps = {};
+        for (const f of writable) {
+            writableProps[f.name] = { type: KINDTYPE[f.kind], title: f.label };
+            if (f.ref) {
+                writableProps[f.name].description = 'Reference to ' + f.ref;
+            }
+        }
+        const writableRequired = writable.filter((f) => f.required).map((f) => f.name);
+        schemas[sname + 'Create'] = {
+            type: 'object',
+            additionalProperties: false,
+            properties: writableProps,
+            ...(writableRequired.length ? { required: writableRequired } : {}),
+        };
+        schemas[sname + 'Update'] = {
+            type: 'object',
+            additionalProperties: false,
+            properties: writableProps,
+        };
+        const ref = { $ref: '#/components/schemas/' + sname };
+        const createRef = { $ref: '#/components/schemas/' + sname + 'Create' };
+        const updateRef = { $ref: '#/components/schemas/' + sname + 'Update' };
+        const errRef = { $ref: '#/components/schemas/Error' };
+        const errResponses = {
+            '400': { description: 'Invalid request', content: { 'application/json': { schema: errRef } } },
+            '401': { description: 'Missing or invalid API key', content: { 'application/json': { schema: errRef } } },
+            '403': { description: 'Forbidden', content: { 'application/json': { schema: errRef } } },
+            '404': { description: 'Not found', content: { 'application/json': { schema: errRef } } },
+        };
+        const itemResult = (desc) => ({
+            description: desc,
+            content: {
+                'application/json': {
+                    schema: {
+                        type: 'object', additionalProperties: false,
+                        properties: { item: ref }, required: ['item'],
+                    },
+                },
+            },
+        });
+        const base = '/' + conf.version + '/' + e.canon;
+        paths[base] = {
+            get: {
+                operationId: opId('list', e), summary: 'List ' + e.name + ' entities',
+                tags: [e.canon],
+                parameters: flds.map((f) => ({
+                    name: f.name, in: 'query', required: false,
+                    schema: { type: KINDTYPE[f.kind] },
+                    description: 'Filter by ' + f.name,
+                })),
+                responses: {
+                    '200': {
+                        description: 'Matching ' + e.name + ' entities',
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object', additionalProperties: false,
+                                    properties: { items: { type: 'array', items: ref } },
+                                    required: ['items'],
+                                },
+                            },
+                        },
+                    },
+                    ...errResponses,
+                },
+            },
+            post: {
+                operationId: opId('create', e), summary: 'Create a ' + e.name,
+                tags: [e.canon],
+                requestBody: {
+                    required: true,
+                    content: { 'application/json': { schema: createRef } },
+                },
+                responses: { '201': itemResult('The created ' + e.name), ...errResponses },
+            },
+        };
+        paths[base + '/{id}'] = {
+            parameters: [{
+                    name: 'id', in: 'path', required: true, schema: { type: 'string' },
+                }],
+            get: {
+                operationId: opId('load', e), summary: 'Load one ' + e.name,
+                tags: [e.canon],
+                responses: { '200': itemResult('The ' + e.name), ...errResponses },
+            },
+            put: {
+                operationId: opId('update', e), summary: 'Update a ' + e.name + ' (partial)',
+                tags: [e.canon],
+                requestBody: {
+                    required: true,
+                    content: { 'application/json': { schema: updateRef } },
+                },
+                responses: { '200': itemResult('The updated ' + e.name), ...errResponses },
+            },
+            delete: {
+                operationId: opId('remove', e), summary: 'Remove a ' + e.name,
+                tags: [e.canon],
+                responses: {
+                    '200': {
+                        description: 'Removed',
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object', additionalProperties: false,
+                                    properties: { ok: { type: 'boolean' }, id: { type: 'string' } },
+                                    required: ['ok', 'id'],
+                                },
+                            },
+                        },
+                    },
+                    ...errResponses,
+                },
+            },
+        };
+    }
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: (core.name || 'system') + ' API',
+            version: conf.version,
+            description: 'Strict-JSON REST API, generated from the model. ' +
+                'Uniform entity paths: <zone>/<name>[/<id>].',
+        },
+        servers: [{ url: conf.prefix }],
+        security: [{ bearerAuth: [] }],
+        components: {
+            securitySchemes: {
+                bearerAuth: {
+                    type: 'http', scheme: 'bearer',
+                    description: 'API access key (create one under Settings & security)',
+                },
+            },
+            schemas,
+        },
+        paths,
+    };
+}
+// Uniform operation ids for SDK generation: list_proj_project, ...
+function opId(op, e) {
+    return op + '_' + e.zone + '_' + e.name;
+}
+function schemaName(canon) {
+    return canon.split('/').map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join('');
+}
+function writeIfChanged(dest, content) {
+    const existing = fs_1.default.existsSync(dest) ? fs_1.default.readFileSync(dest, 'utf8') : null;
+    if (existing === content) {
+        return false;
+    }
+    fs_1.default.mkdirSync(path_1.default.dirname(dest), { recursive: true });
+    fs_1.default.writeFileSync(dest, content);
+    return true;
+}
+// api_gen(model, spec): generate the REST API artifacts. No-op unless
+// the model declares main.api. Returns { created }.
+const api_gen = async (model, spec) => {
+    const created = [];
+    if (null == (model.main && model.main.api)) {
+        return { created };
+    }
+    const doc = openapi(model);
+    const spec_json = JSON.stringify(doc, null, 2) + '\n';
+    if (writeIfChanged(path_1.default.join(spec.root, 'backend', 'gen', 'api', 'openapi.json'), spec_json)) {
+        created.push('backend/gen/api/openapi.json');
+    }
+    // YAML of the SAME object. noRefs is REQUIRED: the spec reuses $ref
+    // objects (the Error schema ref appears in every error response, each
+    // entity ref in several operations), and without noRefs js-yaml emits
+    // anchors/aliases (&ref_0 / *ref_0) that most OpenAPI codegen tools -
+    // including @voxgig/sdkgen - do not resolve. lineWidth:-1 stops long
+    // strings (descriptions, the server url) being line-folded.
+    const spec_yaml = js_yaml_1.default.dump(doc, { noRefs: true, lineWidth: -1 });
+    if (writeIfChanged(path_1.default.join(spec.root, 'backend', 'gen', 'api', 'openapi.yaml'), spec_yaml)) {
+        created.push('backend/gen/api/openapi.yaml');
+    }
+    // The validation shapes land next to the api service - only when the
+    // service is implemented (its folder exists).
+    const srvapi = path_1.default.join(spec.root, 'backend', 'src', 'srv', 'api');
+    if (fs_1.default.existsSync(srvapi)) {
+        if (writeIfChanged(path_1.default.join(srvapi, 'valid_gen.ts'), validGenTs(model))) {
+            created.push('backend/src/srv/api/valid_gen.ts');
+        }
+    }
+    return { created: created.sort() };
+};
+exports.api_gen = api_gen;
+//# sourceMappingURL=api_gen.js.map

package/dist/api/api_gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_gen.js","sourceRoot":"","sources":["../../api/api_gen.ts"],"names":[],"mappings":";AAAA,+CAA+C;;;;;;AAE/C,iEAAiE;AACjE,iEAAiE;AACjE,mCAAmC;AACnC,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,oEAAoE;AACpE,yEAAyE;AACzE,oEAAoE;AACpE,6DAA6D;AAC7D,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,EAAE;AACF,0EAA0E;AAC1E,8BAA8B;AAC9B,EAAE;AACF,oEAAoE;AACpE,qEAAqE;AACrE,qCAAqC;AAErC,4CAAmB;AACnB,gDAAuB;AACvB,sDAA0B;AAO1B,0EAA0E;AAC1E,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;AAGhD,SAAS,OAAO,CAAC,KAAU;IACzB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IAChD,OAAO;QACL,MAAM,EAAE,KAAK,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG;QACtD,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,MAAM;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;KACnB,CAAA;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAU;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3B,MAAM,GAAG,GAAU,EAAE,CAAA;IACrB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IAClD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,SAAQ;QACV,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAA;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAC/B,IAAI,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;gBACxC,SAAQ;YACV,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACvD,CAAC;AAED,SAAS,QAAQ,CAAC,GAAQ;IACxB,MAAM,GAAG,GAAuG,EAAE,CAAA;IAClH,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAA;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACpD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;YAC1E,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YACzD,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK;YACvB,GAAG,EAAE,CAAC,CAAC,GAAG;SACX,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAGD,yBAAyB;AAEzB,SAAS,UAAU,CAAC,KAAU;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAA;IACxF,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAA;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAA;IAClF,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAA;IAClF,KAAK,CAAC,IAAI,CAAC,kDAAkD,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAA;IACzF,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAA;IACnF,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAA;IAC/D,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;IACrC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5B,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5B,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,IAAI,CAAC,CAAA;QACtC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAA;QACxC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAChC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QACrB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACrB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAChC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QACrB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACf,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAGD,yBAAyB;AAEzB,MAAM,QAAQ,GAA2B;IACvC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS;CACvD,CAAA;AAED,SAAS,OAAO,CAAC,KAAU;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3B,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAE3B,MAAM,OAAO,GAAQ;QACnB,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;oBAC1B,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;qBACtD;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF,CAAA;IACD,MAAM,KAAK,GAAQ,EAAE,CAAA;IAErB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAE5B,MAAM,UAAU,GAAQ,EAAE,CAAA;QAC1B,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;YAC/D,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAA;YACpC,CAAC;YACD,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;gBACV,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,eAAe,GAAG,CAAC,CAAC,GAAG,CAAA;YAC1D,CAAC;YACD,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,GAAG;YACf,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,UAAU;YACV,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzC,CAAA;QAED,wEAAwE;QACxE,kEAAkE;QAClE,qEAAqE;QACrE,kEAAkE;QAClE,iDAAiD;QACjD,EAAE;QACF,8DAA8D;QAC9D,mEAAmE;QACnE,EAAE;QACF,oEAAoE;QACpE,oEAAoE;QACpE,8DAA8D;QAC9D,wEAAwE;QACxE,wEAAwE;QACxE,sEAAsE;QACtE,mDAAmD;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAC/C,MAAM,aAAa,GAAQ,EAAE,CAAA;QAC7B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;YAClE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;gBACV,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,eAAe,GAAG,CAAC,CAAC,GAAG,CAAA;YAC7D,CAAC;QACH,CAAC;QACD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAE9E,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG;YAC1B,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE,aAAa;YACzB,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAA;QACD,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG;YAC1B,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE,aAAa;SAC1B,CAAA;QAED,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,uBAAuB,GAAG,KAAK,EAAE,CAAA;QACrD,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,uBAAuB,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAA;QACtE,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,uBAAuB,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAA;QACtE,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAA;QACrD,MAAM,YAAY,GAAG;YACnB,KAAK,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;YAC9F,KAAK,EAAE,EAAE,WAAW,EAAE,4BAA4B,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;YACzG,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;YACxF,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;SACzF,CAAA;QACD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;YACpC,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK;wBAC3C,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC;qBAC9C;iBACF;aACF;SACF,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,CAAA;QAC/C,KAAK,CAAC,IAAI,CAAC,GAAG;YACZ,GAAG,EAAE;gBACH,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,GAAG,WAAW;gBACrE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;gBACf,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK;oBAC1C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;oBAClC,WAAW,EAAE,YAAY,GAAG,CAAC,CAAC,IAAI;iBACnC,CAAC,CAAC;gBACH,SAAS,EAAE;oBACT,KAAK,EAAE;wBACL,WAAW,EAAE,WAAW,GAAG,CAAC,CAAC,IAAI,GAAG,WAAW;wBAC/C,OAAO,EAAE;4BACP,kBAAkB,EAAE;gCAClB,MAAM,EAAE;oCACN,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK;oCAC3C,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;oCACpD,QAAQ,EAAE,CAAC,OAAO,CAAC;iCACpB;6BACF;yBACF;qBACF;oBACD,GAAG,YAAY;iBAChB;aACF;YACD,IAAI,EAAE;gBACJ,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,CAAC,IAAI;gBAC7D,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;gBACf,WAAW,EAAE;oBACX,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;iBACvD;gBACD,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,YAAY,EAAE;aAC3E;SACF,CAAA;QACD,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG;YACtB,UAAU,EAAE,CAAC;oBACX,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACnE,CAAC;YACF,GAAG,EAAE;gBACH,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,CAAC,IAAI;gBAC3D,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;gBACf,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,YAAY,EAAE;aACnE;YACD,GAAG,EAAE;gBACH,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,CAAC,IAAI,GAAG,YAAY;gBAC5E,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;gBACf,WAAW,EAAE;oBACX,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;iBACvD;gBACD,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,YAAY,EAAE;aAC3E;YACD,MAAM,EAAE;gBACN,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,CAAC,IAAI;gBAC7D,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;gBACf,SAAS,EAAE;oBACT,KAAK,EAAE;wBACL,WAAW,EAAE,SAAS;wBACtB,OAAO,EAAE;4BACP,kBAAkB,EAAE;gCAClB,MAAM,EAAE;oCACN,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK;oCAC3C,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oCAC/D,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;iCACvB;6BACF;yBACF;qBACF;oBACD,GAAG,YAAY;iBAChB;aACF;SACF,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACJ,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,MAAM;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,kDAAkD;gBAC7D,6CAA6C;SAChD;QACD,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC9B,UAAU,EAAE;YACV,eAAe,EAAE;gBACf,UAAU,EAAE;oBACV,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;oBAC9B,WAAW,EAAE,uDAAuD;iBACrE;aACF;YACD,OAAO;SACR;QACD,KAAK;KACN,CAAA;AACH,CAAC;AAED,mEAAmE;AACnE,SAAS,IAAI,CAAC,EAAU,EAAE,CAAM;IAC9B,OAAO,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,CAAA;AACzC,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAChC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACpD,CAAC;AAGD,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACnD,MAAM,QAAQ,GAAG,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3E,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,KAAK,CAAA;IACd,CAAC;IACD,YAAE,CAAC,SAAS,CAAC,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,YAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC/B,OAAO,IAAI,CAAA;AACb,CAAC;AAGD,sEAAsE;AACtE,oDAAoD;AACpD,MAAM,OAAO,GAAG,KAAK,EAAE,KAAU,EAAE,IAAa,EAAE,EAAE;IAClD,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,CAAA;IACpB,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;IACrD,IAAI,cAAc,CAChB,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;IAC9C,CAAC;IAED,oEAAoE;IACpE,sEAAsE;IACtE,sEAAsE;IACtE,sEAAsE;IACtE,qEAAqE;IACrE,4DAA4D;IAC5D,MAAM,SAAS,GAAG,iBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACjE,IAAI,cAAc,CAChB,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;IAC9C,CAAC;IAED,qEAAqE;IACrE,8CAA8C;IAC9C,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IACnE,IAAI,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,IAAI,cAAc,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;QAClD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAA;AACpC,CAAC,CAAA;AAIC,0BAAO"}

package/dist/build.d.ts

@@ -56,10 +56,25 @@ declare const EnvWeb: {
         out: string;
     }[];
 };
+declare const Docs: {
+    doc_gen: (model: any, spec: {
+        root: string;
+        srvfolder?: string;
+    }) => Promise<{
+        created: string[];
+    }>;
+};
+declare const Api: {
+    api_gen: (model: any, spec: {
+        root: string;
+    }) => Promise<{
+        created: string[];
+    }>;
+};
 declare const Fragments: {
     load: typeof loadFragment;
     render: typeof renderFragment;
     list: typeof listFragments;
     folder: string;
 };
-export { EnvLambda, EnvGen, EnvWeb, Fragments, generate, empty, TM, loadFragment, renderFragment, MsgMetaShape, CoreConfShape, CloudConfShape, res_dynamo_yml, };
+export { EnvLambda, EnvGen, EnvWeb, Docs, Api, Fragments, generate, empty, TM, loadFragment, renderFragment, MsgMetaShape, CoreConfShape, CloudConfShape, res_dynamo_yml, };

package/dist/build.js

@@ -1,7 +1,7 @@
 "use strict";
 /* Copyright © 2022-2026 Voxgig Ltd, MIT License. */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.res_dynamo_yml = exports.CloudConfShape = exports.CoreConfShape = exports.MsgMetaShape = exports.renderFragment = exports.loadFragment = exports.TM = exports.empty = exports.generate = exports.Fragments = exports.EnvWeb = exports.EnvGen = exports.EnvLambda = void 0;
+exports.res_dynamo_yml = exports.CloudConfShape = exports.CoreConfShape = exports.MsgMetaShape = exports.renderFragment = exports.loadFragment = exports.TM = exports.empty = exports.generate = exports.Fragments = exports.Api = exports.Docs = exports.EnvWeb = exports.EnvGen = exports.EnvLambda = void 0;
 // EnvLambda: generation of the Lambda deployment templates, built on the
 // jostraca templating library. The templates live in env/lambda/, one file
 // per output for convenience:
@@ -19,6 +19,8 @@ const srv_handler_1 = require("./env/lambda/srv_handler");
 const res_yml_1 = require("./env/lambda/res_yml");
 const env_gen_1 = require("./env/env_gen");
 const web_gen_1 = require("./env/web/web_gen");
+const doc_gen_1 = require("./doc/doc_gen");
+const api_gen_1 = require("./api/api_gen");
 const generate_1 = require("./env/lambda/generate");
 Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return generate_1.generate; } });
 Object.defineProperty(exports, "empty", { enumerable: true, get: function () { return generate_1.empty; } });
@@ -54,6 +56,20 @@ const EnvWeb = {
     files: web_gen_1.WEB_FILES,
 };
 exports.EnvWeb = EnvWeb;
+// Docs: model-driven documentation (mermaid ER/message-flow/system-map
+// diagrams + per-service READMEs), regenerated every model-build. See
+// doc/doc_gen.ts.
+const Docs = {
+    doc_gen: doc_gen_1.doc_gen,
+};
+exports.Docs = Docs;
+// Api: the strict-JSON REST API (model main.api) - OpenAPI spec from the
+// entity field definitions + generated request-validation shapes. See
+// api/api_gen.ts.
+const Api = {
+    api_gen: api_gen_1.api_gen,
+};
+exports.Api = Api;
 // Fragment tooling (used by voxgig-system template list/eject/diff, and
 // available to project code).
 const Fragments = {

package/dist/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../build.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,yEAAyE;AACzE,2EAA2E;AAC3E,8BAA8B;AAC9B,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,wEAAwE;AACxE,qCAAqC;AAErC,kDAA8C;AAC9C,0DAAsD;AACtD,kDAAoD;AAEpD,2CAA+E;AAC/E,+CAAsD;AAEtD,oDAG8B;AAmD5B,yFArDA,mBAAQ,OAqDA;AACR,sFAtDU,gBAAK,OAsDV;AACL,mFAvDiB,aAAE,OAuDjB;AACF,6FAvDA,uBAAY,OAuDA;AACZ,+FAxDc,yBAAc,OAwDd;AArDhB,qCAA0C;AAsDxC,6FAtDO,kBAAY,OAsDP;AArDd,uCAA4D;AAsD1D,8FAtDO,oBAAa,OAsDP;AACb,+FAvDsB,qBAAc,OAuDtB;AAtDhB,yDAAqD;AAuDnD,+FAvDO,+BAAc,OAuDP;AApDhB,MAAM,SAAS,GAAG;IAChB,OAAO,EAAP,iBAAO;IACP,WAAW,EAAX,yBAAW;IACX,aAAa,EAAb,uBAAa;CACd,CAAA;AAgCC,8BAAS;AA7BX,wEAAwE;AACxE,yDAAyD;AACzD,MAAM,MAAM,GAAG;IACb,OAAO,EAAP,iBAAO;IACP,KAAK,EAAE,mBAAS;IAChB,QAAQ,EAAE,iBAAO;IACjB,KAAK,EAAE,CAAC,GAAG,eAAS,EAAE,KAAK,CAAC;CAC7B,CAAA;AAuBC,wBAAM;AApBR,oEAAoE;AACpE,wDAAwD;AACxD,MAAM,MAAM,GAAG;IACb,OAAO,EAAP,iBAAO;IACP,KAAK,EAAE,mBAAS;CACjB,CAAA;AAgBC,wBAAM;AAbR,wEAAwE;AACxE,8BAA8B;AAC9B,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,uBAAY;IAClB,MAAM,EAAE,yBAAc;IACtB,IAAI,EAAE,wBAAa;IACnB,MAAM,EAAE,iBAAM;CACf,CAAA;AAOC,8BAAS"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../build.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,yEAAyE;AACzE,2EAA2E;AAC3E,8BAA8B;AAC9B,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,wEAAwE;AACxE,qCAAqC;AAErC,kDAA8C;AAC9C,0DAAsD;AACtD,kDAAoD;AAEpD,2CAA+E;AAC/E,+CAAsD;AACtD,2CAAuC;AACvC,2CAAuC;AAEvC,oDAG8B;AAqE5B,yFAvEA,mBAAQ,OAuEA;AACR,sFAxEU,gBAAK,OAwEV;AACL,mFAzEiB,aAAE,OAyEjB;AACF,6FAzEA,uBAAY,OAyEA;AACZ,+FA1Ec,yBAAc,OA0Ed;AAvEhB,qCAA0C;AAwExC,6FAxEO,kBAAY,OAwEP;AAvEd,uCAA4D;AAwE1D,8FAxEO,oBAAa,OAwEP;AACb,+FAzEsB,qBAAc,OAyEtB;AAxEhB,yDAAqD;AAyEnD,+FAzEO,+BAAc,OAyEP;AAtEhB,MAAM,SAAS,GAAG;IAChB,OAAO,EAAP,iBAAO;IACP,WAAW,EAAX,yBAAW;IACX,aAAa,EAAb,uBAAa;CACd,CAAA;AAgDC,8BAAS;AA7CX,wEAAwE;AACxE,yDAAyD;AACzD,MAAM,MAAM,GAAG;IACb,OAAO,EAAP,iBAAO;IACP,KAAK,EAAE,mBAAS;IAChB,QAAQ,EAAE,iBAAO;IACjB,KAAK,EAAE,CAAC,GAAG,eAAS,EAAE,KAAK,CAAC;CAC7B,CAAA;AAuCC,wBAAM;AApCR,oEAAoE;AACpE,wDAAwD;AACxD,MAAM,MAAM,GAAG;IACb,OAAO,EAAP,iBAAO;IACP,KAAK,EAAE,mBAAS;CACjB,CAAA;AAgCC,wBAAM;AA7BR,uEAAuE;AACvE,sEAAsE;AACtE,kBAAkB;AAClB,MAAM,IAAI,GAAG;IACX,OAAO,EAAP,iBAAO;CACR,CAAA;AAyBC,oBAAI;AAtBN,yEAAyE;AACzE,sEAAsE;AACtE,kBAAkB;AAClB,MAAM,GAAG,GAAG;IACV,OAAO,EAAP,iBAAO;CACR,CAAA;AAkBC,kBAAG;AAfL,wEAAwE;AACxE,8BAA8B;AAC9B,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,uBAAY;IAClB,MAAM,EAAE,yBAAc;IACtB,IAAI,EAAE,wBAAa;IACnB,MAAM,EAAE,iBAAM;CACf,CAAA;AASC,8BAAS"}

package/dist/doc/doc_gen.d.ts

@@ -0,0 +1,8 @@
+type DocSpec = {
+    root: string;
+    srvfolder?: string;
+};
+declare const doc_gen: (model: any, spec: DocSpec) => Promise<{
+    created: string[];
+}>;
+export { doc_gen, };