@autoview/cli 0.1.0

package/lib/orchestrate/utils/describeEndpointResponseShape.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeEndpointResponseShape = describeEndpointResponseShape;
+const renderJsonSchema_1 = require("./renderJsonSchema");
+/**
+ * Render the response body type of a single AutoBE operation as a readable,
+ * multi-line TypeScript-shaped string. Used by the Render phase to spoon-feed
+ * the LLM the exact field names + nesting of every endpoint's return value —
+ * otherwise the model invents plausible-sounding properties (e.g. `auth.member`
+ * on `IAuthorized` when the real shape is `{ id, created_at, token }`), which
+ * then fails TypeScript when the user runs `npm run typecheck` against the
+ * generated frontend.
+ *
+ * Returns `void` when the operation has no response body, so callers can
+ * pass-through to `Promise<void>` in the rendered signature. Delegates the
+ * actual schema walk to {@link renderJsonSchema} so request and response
+ * descriptions stay shape-compatible.
+ *
+ * Pure. Does not mutate the document.
+ */
+function describeEndpointResponseShape(op, doc) {
+    if (op.responseBody === null)
+        return "void";
+    const shape = (0, renderJsonSchema_1.renderNamedSchema)(op.responseBody.typeName, doc);
+    // A list endpoint responds with an array of the element type. Make the
+    // array explicit so the Render phase builds a table/list off the element
+    // fields, not a single-record view.
+    return op.responseBody.isArray ? `${shape}[]` : shape;
+}
+//# sourceMappingURL=describeEndpointResponseShape.js.map

package/lib/orchestrate/utils/describeEndpointResponseShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeEndpointResponseShape.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/describeEndpointResponseShape.ts"],"names":[],"mappings":";;AAqBA,sEAUC;AA5BD,yDAAuD;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,6BAA6B,CAC3C,EAAqB,EACrB,GAAsB;IAEtB,IAAI,EAAE,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAA,oCAAiB,EAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/D,uEAAuE;IACvE,yEAAyE;IACzE,oCAAoC;IACpC,OAAO,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACxD,CAAC"}

package/lib/orchestrate/utils/executeCachedBatch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Executes a task list with semaphore-controlled parallelization.
+ *
+ * All tasks are dispatched immediately into a worker pool, with concurrency
+ * limited by `semaphore` to prevent overwhelming LLM APIs. Results are returned
+ * in original order. On the first task failure the remaining queue is aborted
+ * and the original error is rethrown.
+ *
+ * Standalone copy of `@autobe/agent`'s `executeCachedBatch` that takes the
+ * concurrency cap directly as a number — the autoview package does not need the
+ * full `AutoBeContext` shape just to read `ctx.vendor.semaphore`.
+ *
+ * @param semaphore Concurrency cap (1–N parallel tasks at any one time).
+ * @param taskList List of async tasks to execute, each receiving the cache key
+ *   as its argument.
+ * @param promptCacheKey Optional cache key (generates a UUID if omitted) — used
+ *   as the user-message body so the LLM provider can reuse a cached system
+ *   prompt across calls.
+ */
+export declare const executeCachedBatch: <T>(semaphore: number, taskList: Task<T>[], promptCacheKey?: string) => Promise<T[]>;
+type Task<T> = (user: string) => Promise<T>;
+export {};

package/lib/orchestrate/utils/executeCachedBatch.js

@@ -0,0 +1,64 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeCachedBatch = void 0;
+const tstl_1 = require("tstl");
+const uuid_1 = require("uuid");
+/**
+ * Executes a task list with semaphore-controlled parallelization.
+ *
+ * All tasks are dispatched immediately into a worker pool, with concurrency
+ * limited by `semaphore` to prevent overwhelming LLM APIs. Results are returned
+ * in original order. On the first task failure the remaining queue is aborted
+ * and the original error is rethrown.
+ *
+ * Standalone copy of `@autobe/agent`'s `executeCachedBatch` that takes the
+ * concurrency cap directly as a number — the autoview package does not need the
+ * full `AutoBeContext` shape just to read `ctx.vendor.semaphore`.
+ *
+ * @param semaphore Concurrency cap (1–N parallel tasks at any one time).
+ * @param taskList List of async tasks to execute, each receiving the cache key
+ *   as its argument.
+ * @param promptCacheKey Optional cache key (generates a UUID if omitted) — used
+ *   as the user-message body so the LLM provider can reuse a cached system
+ *   prompt across calls.
+ */
+const executeCachedBatch = (semaphore, taskList, promptCacheKey) => __awaiter(void 0, void 0, void 0, function* () {
+    if (taskList.length === 0)
+        return [];
+    promptCacheKey !== null && promptCacheKey !== void 0 ? promptCacheKey : (promptCacheKey = (0, uuid_1.v7)());
+    const queue = taskList.map((task, index) => new tstl_1.Pair(task, index));
+    const results = [];
+    let aborted = false;
+    let firstError = null;
+    yield Promise.allSettled(new Array(Math.min(semaphore, queue.length)).fill(0).map(() => __awaiter(void 0, void 0, void 0, function* () {
+        while (queue.length !== 0 && !aborted) {
+            const item = queue.splice(0, 1)[0];
+            try {
+                const result = yield item.first(promptCacheKey);
+                if (!aborted)
+                    results.push(new tstl_1.Pair(result, item.second));
+            }
+            catch (error) {
+                if (!aborted) {
+                    aborted = true;
+                    queue.length = 0;
+                    firstError = error;
+                }
+            }
+        }
+    })));
+    if (firstError !== null)
+        throw firstError;
+    return results.sort((x, y) => x.second - y.second).map((p) => p.first);
+});
+exports.executeCachedBatch = executeCachedBatch;
+//# sourceMappingURL=executeCachedBatch.js.map

package/lib/orchestrate/utils/executeCachedBatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeCachedBatch.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/executeCachedBatch.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+BAA4B;AAC5B,+BAA0B;AAE1B;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,kBAAkB,GAAG,CAChC,SAAiB,EACjB,QAAmB,EACnB,cAAuB,EACT,EAAE;IAChB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,cAAc,aAAd,cAAc,cAAd,cAAc,IAAd,cAAc,GAAK,IAAA,SAAE,GAAE,EAAC;IAExB,MAAM,KAAK,GAAiC,QAAQ,CAAC,GAAG,CACtD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,WAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CACvC,CAAC;IACF,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,IAAI,OAAO,GAAY,KAAK,CAAC;IAC7B,IAAI,UAAU,GAAY,IAAI,CAAC;IAC/B,MAAM,OAAO,CAAC,UAAU,CACtB,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAS,EAAE;QAClE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,IAAI,GAA0B,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;YAC3D,IAAI,CAAC;gBACH,MAAM,MAAM,GAAM,MAAM,IAAI,CAAC,KAAK,CAAC,cAAe,CAAC,CAAC;gBACpD,IAAI,CAAC,OAAO;oBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,WAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,IAAI,CAAC;oBACf,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;oBACjB,UAAU,GAAG,KAAK,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAA,CAAC,CACH,CAAC;IACF,IAAI,UAAU,KAAK,IAAI;QAAE,MAAM,UAAU,CAAC;IAC1C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC,CAAA,CAAC;AAlCW,QAAA,kBAAkB,sBAkC7B"}

package/lib/orchestrate/utils/loadShoppingFixture.d.ts

@@ -0,0 +1,33 @@
+import { OpenApi } from "@typia/interface";
+/**
+ * Lazy-load `@samchon/shopping-api/swagger.json` and convert it to an
+ * {@link OpenApi.IDocument} so AutoView can run against a stable reference
+ * SDK without depending on the live `interface` phase.
+ *
+ * Also surfaces the swagger's first declared server URL — the bundled
+ * `@samchon/shopping-api` swagger lists `https://shopping-be.wrtn.ai` so the
+ * generated frontend can hit a real backend (and render real product names like
+ * "Apple Watch") instead of typia-random mock gibberish. The Scaffold phase
+ * uses this URL to seed the default `IConnection.host`.
+ *
+ * The swagger payload is ~700 KB, so the result is memoized on the first call.
+ * The conversion reuses the same `invertOpenApiDocument` helper the live
+ * interface compiler relies on, which means the rest of the AutoView pipeline
+ * cannot tell the document came from a fixture instead of a freshly generated
+ * session.
+ *
+ * The shopping-api package ships an OpenAPI 3.x document — its shape is
+ * structurally identical to typia's `OpenApi.IDocument`, so we cast through
+ * `unknown` rather than dragging in another normalization library. The
+ * downstream invert helper validates the relevant fields itself; an
+ * incompatible document would surface there.
+ */
+export interface IShoppingFixture {
+    document: OpenApi.IDocument;
+    /**
+     * First entry from `swagger.servers[]`. `null` when the swagger omits
+     * `servers` (the SDK would then have to rely on simulate-only mocks).
+     */
+    serverUrl: string | null;
+}
+export declare function loadShoppingFixture(): IShoppingFixture;

package/lib/orchestrate/utils/loadShoppingFixture.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadShoppingFixture = loadShoppingFixture;
+const utils_1 = require("@typia/utils");
+let cached = null;
+function loadShoppingFixture() {
+    var _a, _b, _c;
+    if (cached !== null)
+        return cached;
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const swagger = require("@samchon/shopping-api/swagger.json");
+    const document = utils_1.OpenApiConverter.upgradeDocument(swagger);
+    const serverUrl = (_c = (_b = (_a = swagger.servers) === null || _a === void 0 ? void 0 : _a.find((s) => typeof (s === null || s === void 0 ? void 0 : s.url) === "string" && s.url.length > 0)) === null || _b === void 0 ? void 0 : _b.url) !== null && _c !== void 0 ? _c : null;
+    cached = { document, serverUrl: serverUrl !== null && serverUrl !== void 0 ? serverUrl : null };
+    return cached;
+}
+//# sourceMappingURL=loadShoppingFixture.js.map

package/lib/orchestrate/utils/loadShoppingFixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadShoppingFixture.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/loadShoppingFixture.ts"],"names":[],"mappings":";;AAqCA,kDAcC;AAlDD,wCAAgD;AAkChD,IAAI,MAAM,GAA4B,IAAI,CAAC;AAE3C,SAAgB,mBAAmB;;IACjC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,iEAAiE;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,oCAAoC,CAE3D,CAAC;IACF,MAAM,QAAQ,GAAG,wBAAgB,CAAC,eAAe,CAC/C,OAA4E,CAC7E,CAAC;IACF,MAAM,SAAS,GACb,MAAA,MAAA,MAAA,OAAO,CAAC,OAAO,0CAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,GAAG,CAAA,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,0CACxE,GAAG,mCAAI,IAAI,CAAC;IAClB,MAAM,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,IAAI,EAAE,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/orchestrate/utils/normalizeProductPlanPaths.d.ts

@@ -0,0 +1,24 @@
+import { IAutoViewProductPlan } from "../structures/IAutoViewProductPlan";
+/**
+ * Normalize Next.js dynamic-segment names inside a product plan so the
+ * generated app router does not blow up with the `"You cannot use different
+ * slug names for the same dynamic path"` error.
+ *
+ * Background: the Product Plan phase routinely emits sibling routes such as
+ * `/sales/[id]` and `/sales/[saleId]/questions`. Next.js refuses to start when
+ * two routes under the same parent disagree on the dynamic-segment name. Rather
+ * than re-running the planner just to fix the slugs, we rewrite every dynamic
+ * segment in place so the first name we saw at a given parent prefix wins.
+ *
+ * The rewrite touches three places that all need to stay in sync:
+ *
+ * - `screens[].path` (and the screens are returned in the same order so the
+ *   Render phase still maps the right TSX to the right route).
+ * - `navigation[].primary` / `navigation[].secondary` (path arrays referencing
+ *   the screens above).
+ * - That's it — `IOmission.target` is a free-form label, not a path, so the
+ *   function leaves it alone.
+ *
+ * Pure. Does not mutate the input.
+ */
+export declare function normalizeProductPlanPaths(plan: IAutoViewProductPlan): IAutoViewProductPlan;

package/lib/orchestrate/utils/normalizeProductPlanPaths.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeProductPlanPaths = normalizeProductPlanPaths;
+/**
+ * Normalize Next.js dynamic-segment names inside a product plan so the
+ * generated app router does not blow up with the `"You cannot use different
+ * slug names for the same dynamic path"` error.
+ *
+ * Background: the Product Plan phase routinely emits sibling routes such as
+ * `/sales/[id]` and `/sales/[saleId]/questions`. Next.js refuses to start when
+ * two routes under the same parent disagree on the dynamic-segment name. Rather
+ * than re-running the planner just to fix the slugs, we rewrite every dynamic
+ * segment in place so the first name we saw at a given parent prefix wins.
+ *
+ * The rewrite touches three places that all need to stay in sync:
+ *
+ * - `screens[].path` (and the screens are returned in the same order so the
+ *   Render phase still maps the right TSX to the right route).
+ * - `navigation[].primary` / `navigation[].secondary` (path arrays referencing
+ *   the screens above).
+ * - That's it — `IOmission.target` is a free-form label, not a path, so the
+ *   function leaves it alone.
+ *
+ * Pure. Does not mutate the input.
+ */
+function normalizeProductPlanPaths(plan) {
+    const canonical = new Map(); // parentPrefix -> slug name
+    const rewrites = new Map(); // original → normalized
+    const normalize = (path) => {
+        const cached = rewrites.get(path);
+        if (cached !== undefined)
+            return cached;
+        const result = normalizeSinglePath(path, canonical);
+        rewrites.set(path, result);
+        return result;
+    };
+    // First pass: build the canonical map by walking screens in order.
+    // The first screen that introduces a dynamic segment at a given
+    // parent wins, which matches the operator's mental model when they
+    // scan the plan top-to-bottom.
+    const screens = plan.screens.map((screen) => (Object.assign(Object.assign({}, screen), { path: normalize(screen.path) })));
+    // Second pass: rewrite nav references through the same map.
+    const navigation = plan.navigation.map((nav) => (Object.assign(Object.assign({}, nav), { primary: nav.primary.map(normalize), secondary: nav.secondary.map(normalize) })));
+    return {
+        screens,
+        navigation,
+        intentionalOmissions: plan.intentionalOmissions,
+    };
+}
+function normalizeSinglePath(path, canonical) {
+    const segments = path.replace(/^\/+/, "").split("/");
+    if (segments.length === 0 || segments[0] === "")
+        return path;
+    let prefix = "";
+    const out = [];
+    for (const seg of segments) {
+        const dynamic = /^\[(.+)\]$/.exec(seg);
+        if (dynamic === null) {
+            out.push(seg);
+            prefix = `${prefix}/${seg}`;
+            continue;
+        }
+        const known = canonical.get(prefix);
+        if (known === undefined) {
+            canonical.set(prefix, dynamic[1]);
+            out.push(seg);
+            prefix = `${prefix}/${seg}`;
+        }
+        else {
+            const normalized = `[${known}]`;
+            out.push(normalized);
+            prefix = `${prefix}/${normalized}`;
+        }
+    }
+    return `/${out.join("/")}`;
+}
+//# sourceMappingURL=normalizeProductPlanPaths.js.map

package/lib/orchestrate/utils/normalizeProductPlanPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeProductPlanPaths.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/normalizeProductPlanPaths.ts"],"names":[],"mappings":";;AAwBA,8DAsCC;AA5DD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,yBAAyB,CACvC,IAA0B;IAE1B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,4BAA4B;IACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,wBAAwB;IACpE,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACpD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,mEAAmE;IACnE,gEAAgE;IAChE,mEAAmE;IACnE,+BAA+B;IAC/B,MAAM,OAAO,GAAmC,IAAI,CAAC,OAAO,CAAC,GAAG,CAC9D,CAAC,MAAM,EAAE,EAAE,CAAC,iCACP,MAAM,KACT,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAC5B,CACH,CAAC;IAEF,4DAA4D;IAC5D,MAAM,UAAU,GAAuC,IAAI,CAAC,UAAU,CAAC,GAAG,CACxE,CAAC,GAAG,EAAE,EAAE,CAAC,iCACJ,GAAG,KACN,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EACnC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IACvC,CACH,CAAC;IAEF,OAAO;QACL,OAAO;QACP,UAAU;QACV,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;KAChD,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAY,EACZ,SAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,IAAI,KAAK,GAAG,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC7B,CAAC"}

package/lib/orchestrate/utils/renderJsonSchema.d.ts

@@ -0,0 +1,23 @@
+import { OpenApi } from "@typia/interface";
+/**
+ * Render an OpenAPI schema (or a named schema reference) as a readable,
+ * multi-line TypeScript-shaped string. The output is intended for inclusion in
+ * an LLM prompt where the model has to write a TSX page against an SDK type —
+ * raw OpenAPI JSON forces the model to mentally translate schema indirection
+ * back into TypeScript and it routinely improvises instead of doing the work.
+ *
+ * Nested `$ref` targets are inlined up to a fixed depth so the LLM does not
+ * have to chase indirection. Beyond that depth the bare type name is emitted so
+ * cycles stay finite. Properties are kept in declaration order; optional fields
+ * are suffixed with `?`. String formats (`uuid`, `date-time`, ...) are appended
+ * as a trailing comment so the LLM can still see the semantic when it matters.
+ *
+ * Pure. Does not mutate the document.
+ */
+export declare function renderJsonSchema(schema: OpenApi.IJsonSchema, doc: OpenApi.IDocument): string;
+/**
+ * Look up a schema by its component name and render it. Returns the bare type
+ * name when the schema is missing from `(doc.components?.schemas ?? {})` so callers can
+ * still surface something useful when the document is incomplete.
+ */
+export declare function renderNamedSchema(typeName: string, doc: OpenApi.IDocument): string;

package/lib/orchestrate/utils/renderJsonSchema.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderJsonSchema = renderJsonSchema;
+exports.renderNamedSchema = renderNamedSchema;
+/**
+ * Render an OpenAPI schema (or a named schema reference) as a readable,
+ * multi-line TypeScript-shaped string. The output is intended for inclusion in
+ * an LLM prompt where the model has to write a TSX page against an SDK type —
+ * raw OpenAPI JSON forces the model to mentally translate schema indirection
+ * back into TypeScript and it routinely improvises instead of doing the work.
+ *
+ * Nested `$ref` targets are inlined up to a fixed depth so the LLM does not
+ * have to chase indirection. Beyond that depth the bare type name is emitted so
+ * cycles stay finite. Properties are kept in declaration order; optional fields
+ * are suffixed with `?`. String formats (`uuid`, `date-time`, ...) are appended
+ * as a trailing comment so the LLM can still see the semantic when it matters.
+ *
+ * Pure. Does not mutate the document.
+ */
+function renderJsonSchema(schema, doc) {
+    return renderSchema(schema, doc, 0);
+}
+/**
+ * Look up a schema by its component name and render it. Returns the bare type
+ * name when the schema is missing from `(doc.components?.schemas ?? {})` so callers can
+ * still surface something useful when the document is incomplete.
+ */
+function renderNamedSchema(typeName, doc) {
+    var _a, _b;
+    const schema = ((_b = (_a = doc.components) === null || _a === void 0 ? void 0 : _a.schemas) !== null && _b !== void 0 ? _b : {})[typeName];
+    if (schema === undefined)
+        return typeName;
+    return renderJsonSchema(schema, doc);
+}
+const MAX_DEPTH = 3;
+const INDENT = "  ";
+function renderSchema(schema, doc, depth) {
+    var _a, _b;
+    if ("$ref" in schema && typeof schema.$ref === "string") {
+        const name = schema.$ref.replace(/^#\/components\/schemas\//, "");
+        if (depth >= MAX_DEPTH)
+            return name;
+        const target = ((_b = (_a = doc.components) === null || _a === void 0 ? void 0 : _a.schemas) !== null && _b !== void 0 ? _b : {})[name];
+        if (target === undefined)
+            return name;
+        return renderSchema(target, doc, depth);
+    }
+    if ("oneOf" in schema) {
+        const parts = schema.oneOf.map((branch) => renderSchema(branch, doc, depth));
+        return parts.length > 0 ? parts.join(" | ") : "unknown";
+    }
+    if ("const" in schema) {
+        return JSON.stringify(schema.const);
+    }
+    if (!("type" in schema))
+        return "unknown";
+    switch (schema.type) {
+        case "boolean":
+            return "boolean";
+        case "integer":
+        case "number":
+            return "number";
+        case "string": {
+            const tagged = formatStringTag(schema);
+            return tagged === null ? "string" : `string /* ${tagged} */`;
+        }
+        case "null":
+            return "null";
+        case "array": {
+            // OpenAPI arrays are `IArray | ITuple`; only `IArray` carries `items`.
+            // Real-world swaggers (Stripe) also ship array schemas with no `items`
+            // at all — degrade to `unknown[]` instead of recursing into `undefined`.
+            if (!("items" in schema) || schema.items == null) {
+                return "unknown[]";
+            }
+            const item = renderSchema(schema.items, doc, depth);
+            return needsArrayWrap(item) ? `Array<${item}>` : `${item}[]`;
+        }
+        case "object":
+            return renderObject(schema, doc, depth);
+    }
+    return "unknown";
+}
+function renderObject(schema, doc, depth) {
+    var _a;
+    // `properties` is nominally required by the schema type, but real-world
+    // swaggers (Stripe) ship `type: "object"` schemas with no `properties`
+    // key — typically a free-form map declared only via
+    // `additionalProperties`. `Object.entries(undefined)` throws, so guard
+    // to a `Record<string, unknown>`-ish placeholder instead of crashing
+    // the whole Render phase.
+    if (schema.properties === undefined || schema.properties === null) {
+        return "{ [key: string]: unknown }";
+    }
+    const entries = Object.entries(schema.properties);
+    if (entries.length === 0)
+        return "{}";
+    if (depth >= MAX_DEPTH)
+        return "{ ... }";
+    const required = new Set((_a = schema.required) !== null && _a !== void 0 ? _a : []);
+    const pad = INDENT.repeat(depth + 1);
+    const closePad = INDENT.repeat(depth);
+    const lines = entries.map(([name, prop]) => {
+        const rendered = renderSchema(prop, doc, depth + 1);
+        const optional = required.has(name) ? "" : "?";
+        return `${pad}${name}${optional}: ${rendered};`;
+    });
+    return `{\n${lines.join("\n")}\n${closePad}}`;
+}
+function needsArrayWrap(rendered) {
+    if (rendered.includes(" | "))
+        return true;
+    if (rendered.startsWith("{"))
+        return true;
+    return false;
+}
+function formatStringTag(schema) {
+    if (typeof schema.format === "string")
+        return schema.format;
+    return null;
+}
+//# sourceMappingURL=renderJsonSchema.js.map

package/lib/orchestrate/utils/renderJsonSchema.js.map

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

package/lib/orchestrate/utils/renderResourcePage.d.ts

@@ -0,0 +1,36 @@
+import { OpenApi } from "@typia/interface";
+import { IFieldSpec } from "../../utils/extractFields";
+import { IAutoViewEndpoint } from "../../utils/toEndpoints";
+import { IAutoViewProductPlan } from "../structures/IAutoViewProductPlan";
+/**
+ * Deterministic page generator — the replacement for the LLM Render phase.
+ *
+ * Given one planned screen and the operations it composes, emit a complete,
+ * runnable `page.tsx` that wires the typed SDK call to one of the universal
+ * `Resource*` components (table / detail / form / landing). The component set is
+ * static (shipped in the template); this only produces the thin per-route page:
+ *
+ * - column / field metadata baked from {@link extractFields} (every property of
+ *   the row / response / request type → one column / row / input — dense and
+ *   complete by construction, never an LLM-chosen subset),
+ * - a typed SDK call whose `props` argument is cast to
+ *   `Parameters<typeof api.functional.X.method>[1]` so the generated project
+ *   typechecks against Nestia's exact generated types without this generator
+ *   needing to import them.
+ *
+ * Same swagger → same pages, every run. No LLM, no retries, no typecheck
+ * roulette.
+ */
+export declare function renderResourcePage(screen: IAutoViewProductPlan.IScreen, endpoints: IAutoViewEndpoint[], document: OpenApi.IDocument, allScreens: IAutoViewProductPlan.IScreen[]): string;
+/**
+ * The browsable ROW collection a response carries, or `null` for a single object
+ * / void. Shared by the screen classifier (list vs detail) and the table
+ * renderer so they never disagree. Recognizes a bare array, a generically named
+ * wrapper (`data`/`entries`), a wrapper named after the resource
+ * (`{ droplets: [...] }`, DigitalOcean), and an element that is a `$ref` type OR
+ * an INLINE object (DO's droplet shape is inline).
+ */
+export declare function responseCollection(op: IAutoViewEndpoint, doc: OpenApi.IDocument): {
+    field: string | null;
+    columns: IFieldSpec[];
+} | null;