@skmtc/gen-shadcn-table

Produce a React data-table component sourced from a GET list-response operation.

An operation generator. Companion to gen-shadcn-select — same filter (GET + list response), different output (table rather than select dropdown). Use for inventory-style screens that display many items.

What it generates

Per supported list operation, a tables/<Operation>Table.generated.tsx module of TanStack Table column definitions. Columns come entirely from the enrichment — subject.table.columns in client.json, each entry binding a response-item property (moduleSelect.schemaPath) to a header label; with no enrichment the module renders an empty columns array. Real output for two configured columns:

import type {Pet} from '@/types/pet.generated.ts'
import {createColumnHelper} from '@tanstack/react-table'
import {DataTableColumnHeader} from '@/components/data-table/data-table-column-header'

const columnHelper = createColumnHelper<Pet>();

const columns = [
  columnHelper.accessor('name', {header: ({ column }) => <DataTableColumnHeader column={column} title="Name" />}),
  columnHelper.accessor('status', {header: ({ column }) => <DataTableColumnHeader column={column} title="Status" />}
)];

The enrichment that produced it:

{
  "@skmtc/gen-shadcn-table": {
    "/pet/findByStatus": {
      "get": {
        "main": {
          "table": {
            "columns": [
              { "moduleSelect": { "schemaPath": ["name"] }, "label": "Name" },
              { "moduleSelect": { "schemaPath": ["status"] }, "label": "Status" }
            ]
          }
        }
      }
    }
  }
}

An optional module on a column's moduleSelect points the cell at a consumer-side formatter component; without it the cell renders the raw value.

Source

skmtc-generators/gen-shadcn-table/src/

Key decisions

Same isSupported as gen-shadcn-select. Both generators share the GET + list-response filter, importing isListResponse from @skmtc/gen-tanstack-query-supabase-zod. This is the deliberate shape sharing — two UI outputs sourced from the same operation shape.
Columns derived from the item schema. Each property of the list-item schema becomes a column. No filtering of which properties show up — the stock dumps everything, which is rarely what users want for production tables.
toPreviewModule hook. Enables IDE preview integration the same way gen-shadcn-form does.

What to learn from it

Sibling generators sharing isSupported logic. Two generators (select, table) gate on identical operation shapes but produce different outputs. The pattern works because filtering and rendering are decoupled — the entry filters, the Projection shapes the output.
Schema-shape to columns. Iterating an OasObject's properties to produce table columns is the table-version of gen-shadcn-form's schemaToField dispatch. Same idea, simpler product.

Common customizations when cloned

Filter visible columns. Add enrichments for columns: { include?: string[], exclude?: string[] } to let users hide noisy fields.
Custom cell renderers per column. Date columns format with Intl.DateTimeFormat, image-URL columns render <img>, etc.
Add pagination, sorting, filtering. The stock is a static table. Tanstack Table is the canonical library to layer on top if you need those features.
Swap UI library. shadcn/ui Table → DaisyUI Table → custom.