@autoview/cli 0.1.0

package/lib/utils/classifyEndpoints.d.ts

@@ -0,0 +1,62 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoViewEndpoint } from "./toEndpoints";
+/**
+ * Deterministic CRUD role of an endpoint — the first brick of the "정확한 틀".
+ *
+ * The MAP layer (SdkStudy + ProductPlan) was 100% LLM improvisation: same
+ * swagger, different screens every run, no CRUD-completeness guarantee, and a
+ * commerce-hardcoded prompt. This classifier derives each endpoint's role from
+ * method + path shape + query presence — purely structural, zero LLM, fully
+ * reproducible and domain-agnostic.
+ *
+ * - `list`    GET on a collection (no trailing path param), no query
+ * - `search`  GET on a collection WITH query parameters (filter/paginate)
+ * - `detail`  GET on a single item (trailing `{param}`)
+ * - `create`  POST on a collection
+ * - `update`  PUT / PATCH on a single item
+ * - `delete`  DELETE on a single item
+ * - `action`  anything else (e.g. POST /pets/{id}/uploadImage, RPC-ish verbs)
+ */
+export type EndpointRole = "list" | "search" | "detail" | "create" | "update" | "delete" | "action";
+/**
+ * One link in a resource hierarchy: a collection name plus the path param that
+ * addresses a single item of it. `param` is `null` for a leaf collection that
+ * the endpoint does not item-address (`/sales/{saleId}/questions` → the
+ * `questions` link has `param: null` on a list, `param: "id"` on a detail).
+ */
+export interface IResourceLink {
+    name: string;
+    param: string | null;
+}
+export interface IClassifiedEndpoint {
+    endpoint: IAutoViewEndpoint;
+    /** Top-level resource bucket = the first link of {@link chain}. */
+    resource: string;
+    /**
+     * Full resource hierarchy parsed from the path, skipping namespace/actor
+     * prefixes. `/shoppings/admins/sales/{saleId}/questions/{id}` →
+     * `[{sales, saleId}, {questions, id}]`. Length 1 = a top-level resource.
+     */
+    chain: IResourceLink[];
+    role: EndpointRole;
+    /** True when the path targets a single item (trailing `{param}`). */
+    itemScoped: boolean;
+}
+/** All endpoints of one resource, plus the set of roles it actually exposes. */
+export interface IResourceGroup {
+    /** Leaf resource name = the last link of {@link chain}. */
+    resource: string;
+    /** Full hierarchy of this group (`[sales]`, `[sales, questions]`). */
+    chain: IResourceLink[];
+    /** `chain.length` — 1 = top-level, ≥2 = nested under a parent. */
+    depth: number;
+    endpoints: IClassifiedEndpoint[];
+    /** Which CRUD roles this resource supports — drives the screen set later. */
+    roles: Set<EndpointRole>;
+}
+export declare function classifyEndpoint(endpoint: IAutoViewEndpoint, candidates?: ReadonlySet<string>, document?: OpenApi.IDocument): IClassifiedEndpoint;
+/**
+ * Classify every endpoint and bucket by resource. Resource order follows first
+ * appearance; endpoints within a resource keep their input order.
+ */
+export declare function classifyEndpoints(endpoints: IAutoViewEndpoint[], document?: OpenApi.IDocument): IResourceGroup[];

package/lib/utils/classifyEndpoints.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyEndpoint = classifyEndpoint;
+exports.classifyEndpoints = classifyEndpoints;
+const extractFields_1 = require("./extractFields");
+const PARAM = /^\{.*\}$/;
+function segments(path) {
+    return path.split("/").filter((s) => s.length > 0);
+}
+/**
+ * Whether an endpoint's response is a browsable collection — an array, or a
+ * page/wrapper object whose resolved fields contain a collection field
+ * (`data` / `items` / `entries` / …). Used to tell a real `PATCH`-as-search
+ * (returns a page of results) from a `PATCH` that merely uses the verb to mutate
+ * a named sub-resource (`/databases/{id}/config`) and returns void or a single
+ * object. Without a document a page wrapper cannot be resolved, so any named
+ * body is conservatively treated as a collection (preserving legacy behavior)
+ * while a void response is still recognized as a non-collection.
+ */
+function returnsCollection(endpoint, document) {
+    if (endpoint.responseBody === null)
+        return false;
+    if (endpoint.responseBody.isArray)
+        return true;
+    if (document === undefined)
+        return true;
+    return ((0, extractFields_1.findCollectionField)((0, extractFields_1.extractFields)(endpoint.responseBody.typeName, document)) !==
+        undefined);
+}
+function classifyEndpoint(endpoint, candidates = new Set(), document) {
+    var _a, _b, _c;
+    const segs = segments(endpoint.path);
+    const last = (_a = segs.at(-1)) !== null && _a !== void 0 ? _a : "";
+    // "single item" = the path's last segment is a parameter (`/pets/{id}`),
+    // i.e. it addresses one entity. `/pets/{id}/photos` is a collection again
+    // (last segment `photos` is not a param), so it lists pet-scoped photos.
+    const itemScoped = PARAM.test(last);
+    // Any path parameter means the write targets a specific entity (or a child
+    // of one) — `/orders/{id}/cancel`, `/pets/{id}/photos`, `/items/{id}`. We
+    // cannot tell a sub-resource create from an RPC verb deterministically (no
+    // noun/verb NLP), so both collapse to `action`: an item-scoped write the
+    // detail screen surfaces as a button/sub-form. A `create` is reserved for a
+    // POST on a bare collection (`/items`).
+    const hasPathParam = segs.some((s) => PARAM.test(s));
+    const method = endpoint.method.toLowerCase();
+    const hasQuery = endpoint.query !== null;
+    const role = (() => {
+        switch (method) {
+            case "get":
+                // `/pets/{id}` → detail; `/pets/{id}/photos` → list (sub-collection).
+                if (itemScoped)
+                    return "detail";
+                return hasQuery ? "search" : "list";
+            case "post":
+                return hasPathParam ? "action" : "create";
+            case "put":
+                return "update";
+            case "patch":
+                // nestia / AutoBE convention: PATCH on a collection is index/search
+                // (the filter rides in the request body), NOT a partial update — this
+                // is how shopping/ERP expose their list endpoints. PATCH on a single
+                // item (`/x/{id}`) is a genuine update.
+                if (itemScoped)
+                    return "update";
+                // ...but only when it actually returns a collection. A non-item PATCH
+                // that returns void or a single object (`PATCH /databases/{id}/config`)
+                // is a mutation, not a search — classifying it as a read would tag the
+                // tool `readOnly` and tell an agent a state-changing call is safe.
+                if (!returnsCollection(endpoint, document))
+                    return "action";
+                return hasQuery ? "search" : "list";
+            case "delete":
+                return "delete";
+            default:
+                return "action";
+        }
+    })();
+    const chain = resourceChainOf(segs, candidates, role);
+    return {
+        endpoint,
+        resource: (_c = (_b = chain[0]) === null || _b === void 0 ? void 0 : _b.name) !== null && _c !== void 0 ? _c : resourceOf(segs, candidates),
+        chain,
+        role,
+        itemScoped,
+    };
+}
+function stripBraces(seg) {
+    return seg.replace(/^\{/, "").replace(/\}$/, "");
+}
+/**
+ * Parse a path into its resource hierarchy, skipping namespace / actor prefix
+ * segments. A static segment becomes a resource link when it is item-addressed
+ * (a `{param}` follows it), is a known resource elsewhere (in `candidates`), or
+ * is the terminal collection. Pure namespacing (`shoppings`, `admins`,
+ * `systematic`) is dropped.
+ *
+ * `/shoppings/admins/sales/{saleId}/questions/{id}` → `[{sales,saleId},{questions,id}]`
+ * `/shoppings/customers/orders/{id}/publish` (action) → `[{orders,id}]`
+ *   (the trailing verb is the action name, not a sub-resource).
+ */
+function resourceChainOf(segs, candidates, role) {
+    const chain = [];
+    for (let i = 0; i < segs.length; i++) {
+        const seg = segs[i];
+        if (PARAM.test(seg))
+            continue;
+        const next = segs[i + 1];
+        const nextIsParam = next !== undefined && PARAM.test(next);
+        const isTerminal = i === segs.length - 1;
+        if (nextIsParam) {
+            // item-addressed collection → a real resource (`sales/{saleId}`).
+            chain.push({ name: seg, param: stripBraces(next) });
+        }
+        else if (candidates.has(seg)) {
+            // a known resource (item-addressed elsewhere), here without an id.
+            chain.push({ name: seg, param: null });
+        }
+        else if (isTerminal && chain.length === 0) {
+            // a top-level read-only collection that is never item-addressed
+            // (`/health`, `/system`, `/store/inventory`).
+            chain.push({ name: seg, param: null });
+        }
+        // else: a namespace/actor prefix, OR a deeper trailing verb/view that is
+        // never item-addressed (`/sales/details`, `/channels/hierarchical`,
+        // `/orders/incompletes`). The latter is a VARIANT of its parent resource,
+        // not a resource of its own — skip it so the endpoint folds into the parent
+        // group instead of spawning a junk top-level card.
+    }
+    // An action's trailing static verb (`.../{id}/publish`) is not a resource —
+    // drop it so the action attaches to its parent. Keep length ≥ 1.
+    if (role === "action" && chain.length > 1 && chain.at(-1).param === null) {
+        chain.pop();
+    }
+    return chain.length > 0 ? chain : [{ name: "root", param: null }];
+}
+/**
+ * The segment immediately before a path's last `{param}` — the entity the path
+ * addresses (`/shoppings/admins/coupons/{id}` → `coupons`, `/pet/{petId}` →
+ * `pet`). `null` when the path has no param (a collection or verb path).
+ */
+function paramAnchoredResource(segs) {
+    for (let i = segs.length - 1; i >= 0; i--) {
+        if (PARAM.test(segs[i]))
+            return i > 0 ? segs[i - 1] : null;
+    }
+    return null;
+}
+/**
+ * Resource bucket of a path, using the set of param-anchored resources as
+ * the source of truth.
+ *
+ * - Param path (`/pet/{petId}`, `/coupons/{id}`) → the segment before the
+ *   param. This recovers the real resource even under deep accessors that
+ *   share a `shoppings` prefix.
+ * - Collection / verb path with no param (`/pet/findByStatus`, `/pet`,
+ *   `/user/login`) → absorbed into a known resource if the path passes through
+ *   one (findByStatus → pet, login → user), so RPC-style verbs do not spawn
+ *   junk resources. Falls back to its own last segment when it belongs to no
+ *   known resource (`/store/inventory` → inventory).
+ */
+function resourceOf(segs, candidates) {
+    var _a;
+    const anchored = paramAnchoredResource(segs);
+    if (anchored !== null)
+        return anchored;
+    const nonParam = segs.filter((s) => !PARAM.test(s));
+    for (let i = nonParam.length - 1; i >= 0; i--) {
+        if (candidates.has(nonParam[i]))
+            return nonParam[i];
+    }
+    return (_a = nonParam.at(-1)) !== null && _a !== void 0 ? _a : "root";
+}
+/**
+ * Classify every endpoint and bucket by resource. Resource order follows first
+ * appearance; endpoints within a resource keep their input order.
+ */
+function classifyEndpoints(endpoints, document) {
+    // Pass 1: collect the real resources — segments that have a `{param}` child.
+    const candidates = new Set();
+    for (const endpoint of endpoints) {
+        const r = paramAnchoredResource(segments(endpoint.path));
+        if (r !== null)
+            candidates.add(r);
+    }
+    // Pass 2: classify and bucket by the FULL resource chain (so a sub-resource
+    // like `sales/questions` is its own group, distinct from `sales`), absorbing
+    // param-less verb paths into a known resource.
+    const groups = new Map();
+    for (const endpoint of endpoints) {
+        const classified = classifyEndpoint(endpoint, candidates, document);
+        const chainKey = classified.chain.map((c) => c.name).join("/");
+        const existing = groups.get(chainKey);
+        const group = existing !== null && existing !== void 0 ? existing : {
+            resource: classified.chain.at(-1).name,
+            chain: classified.chain,
+            depth: classified.chain.length,
+            endpoints: [],
+            roles: new Set(),
+        };
+        // Prefer a chain link that carries an item param (a detail endpoint) so the
+        // group's chain has the real param names for routing, not just `null`s.
+        if (existing !== undefined) {
+            classified.chain.forEach((link, i) => {
+                var _a;
+                if (link.param !== null && ((_a = existing.chain[i]) === null || _a === void 0 ? void 0 : _a.param) == null) {
+                    existing.chain[i] = link;
+                }
+            });
+        }
+        group.endpoints.push(classified);
+        group.roles.add(classified.role);
+        groups.set(chainKey, group);
+    }
+    return [...groups.values()];
+}
+//# sourceMappingURL=classifyEndpoints.js.map

package/lib/utils/classifyEndpoints.js.map

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

package/lib/utils/endpointFilter.d.ts

@@ -0,0 +1,26 @@
+import { IAutoViewEndpoint } from "./toEndpoints";
+/**
+ * Operator-controlled endpoint filter — the answer to "huge swaggers explode
+ * into 73 screens and mix actor scopes".
+ *
+ * A big swagger (shopping/ERP) should not be turned into a screen per endpoint:
+ * actor scopes collide (a customer screen calling an admin endpoint 500s) and
+ * the screen count is unusable. Instead of guessing actors from the path
+ * (swagger-specific), the operator slices the surface explicitly:
+ *
+ *   --include "shoppings/customers/**"   → only the customer surface
+ *   --exclude "**​/monitors/**"           → drop monitoring noise
+ *
+ * Patterns match against the endpoint PATH (leading slash optional). Glob:
+ *   `*`  matches within a path segment (no `/`)
+ *   `**` matches across segments
+ */
+export interface IEndpointFilter {
+    include?: string[];
+    exclude?: string[];
+}
+/**
+ * Apply include/exclude to an endpoint list. Include keeps only matches (when
+ * given); exclude then drops matches. Empty/absent filter is a no-op.
+ */
+export declare function filterEndpoints(endpoints: IAutoViewEndpoint[], filter?: IEndpointFilter): IAutoViewEndpoint[];

package/lib/utils/endpointFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpointFilter.js","sourceRoot":"","sources":["../../src/utils/endpointFilter.ts"],"names":[],"mappings":";;AA4CA,0CAYC;AAjCD,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,4EAA4E;IAC5E,kDAAkD;IAClD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,QAAkB;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAC7B,SAA8B,EAC9B,SAA0B,EAAE;IAE5B,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,OAAQ,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,OAAQ,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/utils/extractFields.d.ts

@@ -0,0 +1,85 @@
+import { OpenApi } from "@typia/interface";
+/**
+ * Deterministic data contract — the field list a screen renders.
+ *
+ * Derived structurally from a component schema's properties: list table
+ * columns, detail rows, and form inputs all come from here instead of the LLM
+ * guessing. This is what makes "table 엄청 적게" structurally impossible — every
+ * property of the row/response/request type becomes a column/row/input.
+ */
+export type FieldKind = "string" | "number" | "boolean" | "enum" | "array" | "object" | "ref" | "union" | "unknown";
+export interface IFieldSpec {
+    name: string;
+    required: boolean;
+    kind: FieldKind;
+    /** String format (`uuid`, `date-time`, `uri`, ...) when present. */
+    format?: string;
+    /** Allowed values for an `enum` field. */
+    enumValues?: Array<string | number | boolean>;
+    /** Component type name for a `ref` field, or the element type of an `array`. */
+    ref?: string;
+    /** For an `array`, the element's kind (e.g. array of strings vs array of refs). */
+    itemKind?: FieldKind;
+    /** For an `array` of primitives, the element's string format (`uri`, …). A
+     *  `string[]` of image URLs carries `format: "uri"` on the ITEM, not the
+     *  array, so the signal is lost without preserving it here. */
+    itemFormat?: string;
+    /**
+     * For an `array` whose elements are an INLINE object (no `$ref`, so {@link ref}
+     * is undefined), the element's own field list — e.g. DigitalOcean's
+     * `{ droplets: [ { id, name, … } ] }`, where the droplet shape is inline. Lets
+     * a table render real columns for such collections instead of one opaque cell.
+     */
+    itemFields?: IFieldSpec[];
+}
+/**
+ * Field names a paginated/collection response uses to hold its array of items.
+ * `data` is the nestia/AutoBE convention; real APIs vary (Box uses `entries`,
+ * others `items` / `results`). Recognizing all of them lets a list endpoint be
+ * rendered as a table off its element type instead of a one-record detail.
+ */
+export declare const COLLECTION_FIELD_NAMES: Set<string>;
+/** The array field that holds a collection response's items, if any. */
+export declare function findCollectionField(fields: IFieldSpec[]): IFieldSpec | undefined;
+/**
+ * Resolve a schema's effective `{ properties, required }`, following `$ref` and
+ * merging every `allOf` member. Composition (`allOf`) is a core OpenAPI feature
+ * real swaggers (Box, Stripe, …) lean on heavily — a type is often
+ * `allOf: [BasePagination, { properties: { entries } }]` with no direct
+ * `properties` of its own. Without this, such a type renders zero fields.
+ *
+ * Own `properties` win over inherited ones on a name clash; `required` is the
+ * union. Depth-guarded against cyclic `$ref`.
+ */
+export declare function resolveProperties(schema: OpenApi.IJsonSchema, doc: OpenApi.IDocument, depth?: number): {
+    properties: Record<string, OpenApi.IJsonSchema>;
+    required: string[];
+};
+/**
+ * Extract the field list of a schema directly (resolving `$ref` and `allOf`).
+ * Works for both named component schemas and INLINE schemas — e.g. a response
+ * `{ databases: T[], links: … }` that is not a named component (common on
+ * DigitalOcean). Returns `[]` when there are no resolvable `properties`.
+ */
+export declare function extractFieldsFromSchema(schema: OpenApi.IJsonSchema, document: OpenApi.IDocument): IFieldSpec[];
+/**
+ * Extract the field list of a NAMED component schema. Returns `[]` when the type
+ * is unknown or has no resolvable `properties` — the caller then degrades
+ * gracefully rather than inventing fields.
+ */
+export declare function extractFields(typeName: string, document: OpenApi.IDocument): IFieldSpec[];
+/**
+ * The field that best represents a record's image, or `undefined`. A scalar
+ * `string` (often `format: uri`) or a `string[]` of image URLs whose NAME reads
+ * as an image wins; failing that, a uri-formatted url-ish field. This is the
+ * signal that turns a list into a catalog of cards instead of a table.
+ */
+export declare function imageFieldOf(columns: IFieldSpec[]): IFieldSpec | undefined;
+/** The field that best titles a record (a card's heading), or `undefined`. */
+export declare function titleFieldOf(columns: IFieldSpec[]): IFieldSpec | undefined;
+/**
+ * A collection deserves a catalog (card grid) rather than a table when its rows
+ * carry both an image and a title — the two things a card needs. Purely
+ * structural from the element schema; no domain keywords.
+ */
+export declare function isCatalogCollection(columns: IFieldSpec[]): boolean;

package/lib/utils/extractFields.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLLECTION_FIELD_NAMES = void 0;
+exports.findCollectionField = findCollectionField;
+exports.resolveProperties = resolveProperties;
+exports.extractFieldsFromSchema = extractFieldsFromSchema;
+exports.extractFields = extractFields;
+exports.imageFieldOf = imageFieldOf;
+exports.titleFieldOf = titleFieldOf;
+exports.isCatalogCollection = isCatalogCollection;
+function refName($ref) {
+    return $ref.split("/").pop();
+}
+/**
+ * Field names a paginated/collection response uses to hold its array of items.
+ * `data` is the nestia/AutoBE convention; real APIs vary (Box uses `entries`,
+ * others `items` / `results`). Recognizing all of them lets a list endpoint be
+ * rendered as a table off its element type instead of a one-record detail.
+ */
+exports.COLLECTION_FIELD_NAMES = new Set([
+    "data",
+    "entries",
+    "items",
+    "results",
+    "values",
+    "list",
+    "records",
+    "rows",
+]);
+/** The array field that holds a collection response's items, if any. */
+function findCollectionField(fields) {
+    return fields.find((f) => f.kind === "array" && exports.COLLECTION_FIELD_NAMES.has(f.name.toLowerCase()));
+}
+function kindOf(schema) {
+    if ("$ref" in schema && typeof schema.$ref === "string") {
+        return { kind: "ref", ref: refName(schema.$ref) };
+    }
+    // A bare `const` (no `oneOf`) is a single-value literal — typically a
+    // discriminant like `{ const: "customer" }`. Treat it as a one-value enum so
+    // it renders as a labeled value, not `unknown`.
+    if ("const" in schema && !("oneOf" in schema)) {
+        return {
+            kind: "enum",
+            enumValues: [schema.const],
+        };
+    }
+    // upgradeDocument normalizes a string enum into `oneOf: [{ const }, ...]`, and
+    // a nullable type into `oneOf: [{ type: "null" }, <real schema>]`. Drop the
+    // null branch first, then: an all-`const` set is an enum; a single remaining
+    // branch is just that type made nullable (unwrap it — a nullable `$ref`
+    // becomes a `ref`, not a `union`); anything else is a real union.
+    if ("oneOf" in schema && Array.isArray(schema.oneOf)) {
+        const branches = schema.oneOf.filter((b) => !("type" in b && b.type === "null"));
+        const consts = branches.map((b) => "const" in b ? b.const : undefined);
+        if (consts.length > 0 && consts.every((c) => c !== undefined)) {
+            return { kind: "enum", enumValues: consts };
+        }
+        if (branches.length === 1)
+            return kindOf(branches[0]);
+        // A homogeneous primitive union (e.g. a string that is `ipv4 | ipv6`, or
+        // `uri | ""`) is, for display, just that primitive — collapse it. Branches
+        // with differing or no `type` (a real polymorphic `$ref` union) stay
+        // `union` so we never mislabel one variant as another.
+        const prims = branches.map((b) => "type" in b ? b.type : undefined);
+        if (prims.every((t) => t !== undefined && t === prims[0])) {
+            return kindOf(branches[0]);
+        }
+        return { kind: "union" };
+    }
+    if ("anyOf" in schema || "allOf" in schema) {
+        return { kind: "union" };
+    }
+    if (!("type" in schema))
+        return { kind: "unknown" };
+    switch (schema.type) {
+        case "boolean":
+            return { kind: "boolean" };
+        case "integer":
+        case "number":
+            return { kind: "number" };
+        case "string": {
+            // biome-ignore lint: enum is part of the JSON Schema string node
+            const enumValues = schema.enum;
+            if (Array.isArray(enumValues) && enumValues.length > 0) {
+                return { kind: "enum", enumValues, format: schema.format };
+            }
+            return { kind: "string", format: schema.format };
+        }
+        case "array": {
+            const items = "items" in schema ? schema.items : undefined;
+            if (items === undefined)
+                return { kind: "array", itemKind: "unknown" };
+            const inner = kindOf(items);
+            return {
+                kind: "array",
+                itemKind: inner.kind,
+                ref: inner.ref,
+                itemFormat: inner.format,
+            };
+        }
+        case "object":
+            return { kind: "object" };
+        default:
+            return { kind: "unknown" };
+    }
+}
+/**
+ * Resolve a schema's effective `{ properties, required }`, following `$ref` and
+ * merging every `allOf` member. Composition (`allOf`) is a core OpenAPI feature
+ * real swaggers (Box, Stripe, …) lean on heavily — a type is often
+ * `allOf: [BasePagination, { properties: { entries } }]` with no direct
+ * `properties` of its own. Without this, such a type renders zero fields.
+ *
+ * Own `properties` win over inherited ones on a name clash; `required` is the
+ * union. Depth-guarded against cyclic `$ref`.
+ */
+function resolveProperties(schema, doc, depth = 0) {
+    var _a, _b;
+    if (depth > 8)
+        return { properties: {}, required: [] };
+    if ("$ref" in schema && typeof schema.$ref === "string") {
+        const target = ((_b = (_a = doc.components) === null || _a === void 0 ? void 0 : _a.schemas) !== null && _b !== void 0 ? _b : {})[refName(schema.$ref)];
+        return target === undefined
+            ? { properties: {}, required: [] }
+            : resolveProperties(target, doc, depth + 1);
+    }
+    let properties = {};
+    let required = [];
+    if ("allOf" in schema && Array.isArray(schema.allOf)) {
+        for (const member of schema.allOf) {
+            const sub = resolveProperties(member, doc, depth + 1);
+            properties = Object.assign(Object.assign({}, properties), sub.properties);
+            required = [...required, ...sub.required];
+        }
+    }
+    if ("properties" in schema && schema.properties !== undefined) {
+        properties = Object.assign(Object.assign({}, properties), schema.properties);
+    }
+    if ("required" in schema && Array.isArray(schema.required)) {
+        required = [...required, ...schema.required];
+    }
+    return { properties, required: [...new Set(required)] };
+}
+/**
+ * Extract the field list of a schema directly (resolving `$ref` and `allOf`).
+ * Works for both named component schemas and INLINE schemas — e.g. a response
+ * `{ databases: T[], links: … }` that is not a named component (common on
+ * DigitalOcean). Returns `[]` when there are no resolvable `properties`.
+ */
+function extractFieldsFromSchema(schema, document) {
+    const { properties, required } = resolveProperties(schema, document, 0);
+    const requiredSet = new Set(required);
+    return Object.entries(properties).map(([name, prop]) => {
+        const k = kindOf(prop);
+        // For an array of INLINE objects (no $ref element type), resolve the
+        // element's own fields so a table can show its columns.
+        let itemFields;
+        if (k.kind === "array" && k.ref === undefined) {
+            const items = prop.items;
+            if (items !== undefined) {
+                const inner = extractFieldsFromSchema(items, document);
+                if (inner.length > 0)
+                    itemFields = inner;
+            }
+        }
+        return {
+            name,
+            required: requiredSet.has(name),
+            kind: k.kind,
+            format: k.format,
+            enumValues: k.enumValues,
+            ref: k.ref,
+            itemKind: k.itemKind,
+            itemFormat: k.itemFormat,
+            itemFields,
+        };
+    });
+}
+/**
+ * Extract the field list of a NAMED component schema. Returns `[]` when the type
+ * is unknown or has no resolvable `properties` — the caller then degrades
+ * gracefully rather than inventing fields.
+ */
+function extractFields(typeName, document) {
+    var _a, _b;
+    const schema = ((_b = (_a = document.components) === null || _a === void 0 ? void 0 : _a.schemas) !== null && _b !== void 0 ? _b : {})[typeName];
+    if (schema === undefined)
+        return [];
+    return extractFieldsFromSchema(schema, document);
+}
+/** Field names that read as an image, optionally suffixed with url(s)/uri(s)/src. */
+const IMAGE_NAME = /(image|img|photo|picture|thumbnail|thumb|avatar|icon|logo|banner|cover|poster|artwork)s?(_?(url|uri|src|href)s?)?$/i;
+/** Field names that hold a human title for a record (the card's heading). */
+const TITLE_NAMES = new Set([
+    "name",
+    "title",
+    "label",
+    "headline",
+    "subject",
+    "nickname",
+]);
+/**
+ * The field that best represents a record's image, or `undefined`. A scalar
+ * `string` (often `format: uri`) or a `string[]` of image URLs whose NAME reads
+ * as an image wins; failing that, a uri-formatted url-ish field. This is the
+ * signal that turns a list into a catalog of cards instead of a table.
+ */
+function imageFieldOf(columns) {
+    const named = columns.find((c) => IMAGE_NAME.test(c.name) &&
+        (c.kind === "string" || (c.kind === "array" && c.itemKind === "string")));
+    if (named !== undefined)
+        return named;
+    return columns.find((c) => (c.kind === "string" &&
+        c.format === "uri" &&
+        /url|uri|src|link/i.test(c.name)) ||
+        (c.kind === "array" && c.itemKind === "string" && c.itemFormat === "uri"));
+}
+/** The field that best titles a record (a card's heading), or `undefined`. */
+function titleFieldOf(columns) {
+    var _a;
+    return ((_a = columns.find((c) => c.kind === "string" && TITLE_NAMES.has(c.name.toLowerCase()))) !== null && _a !== void 0 ? _a : columns.find((c) => c.kind === "string" && /name|title/i.test(c.name)));
+}
+/**
+ * A collection deserves a catalog (card grid) rather than a table when its rows
+ * carry both an image and a title — the two things a card needs. Purely
+ * structural from the element schema; no domain keywords.
+ */
+function isCatalogCollection(columns) {
+    return (imageFieldOf(columns) !== undefined && titleFieldOf(columns) !== undefined);
+}
+//# sourceMappingURL=extractFields.js.map

package/lib/utils/extractFields.js.map

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