@metaobjectsdev/codegen-ts-tanstack 0.5.0-rc.1

package/dist/templates/columns-file.js

@@ -0,0 +1,142 @@
+import { code, imp, joinCode } from "ts-poet";
+import { LAYOUT_SUBTYPE_DATA_GRID, LAYOUT_DATA_GRID_ATTR_PAGE_SIZE, LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD, LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER, LAYOUT_DATA_GRID_ATTR_FILTERABLE, LAYOUT_DATA_GRID_ATTR_FILTER, LAYOUT_DATA_GRID_ATTR_COLUMNS, } from "@metaobjectsdev/metadata";
+import { GENERATED_HEADER, entityModuleSpecifier } from "@metaobjectsdev/codegen-ts";
+function humanize(s) {
+    return s
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/^./, (c) => c.toUpperCase());
+}
+function fieldViewKind(field) {
+    const view = field.ownViews()[0];
+    return view?.subType ?? "text";
+}
+function fieldLabel(field) {
+    const view = field.ownViews()[0];
+    const label = view?.ownAttr("label");
+    if (typeof label === "string")
+        return label;
+    return humanize(field.name);
+}
+/**
+ * Extract grid specs from an entity's dataGrid layouts, resolving column
+ * metadata against the entity's field list.
+ *
+ * Column set: read from @columns stringArray attr on the layout. If absent,
+ * fall back to all fields on the entity (pre-E-T2 behaviour, kept for
+ * backwards compat with metadata not yet migrated by E-T4).
+ */
+function extractGrids(entity) {
+    // fields() and layouts() are both effective (own + inherited via extends:/super:).
+    const fieldsByName = new Map(entity.fields().map((f) => [f.name, f]));
+    const grids = [];
+    for (const layout of entity.layouts()) {
+        if (layout.subType !== LAYOUT_SUBTYPE_DATA_GRID)
+            continue;
+        // @columns is a stringArray attr on the layout (set by E-T4 migration).
+        // Fall back to all entity fields if not present.
+        const columnsAttr = layout.ownAttr(LAYOUT_DATA_GRID_ATTR_COLUMNS);
+        const columnNames = Array.isArray(columnsAttr)
+            ? columnsAttr.filter((x) => typeof x === "string")
+            : [...fieldsByName.keys()];
+        const columns = columnNames.flatMap((name) => {
+            const field = fieldsByName.get(name);
+            if (!field)
+                return []; // columns ref that doesn't exist on entity; defensive skip
+            const spec = {
+                id: name,
+                header: fieldLabel(field),
+                viewKind: fieldViewKind(field),
+            };
+            return [spec];
+        });
+        const sortField = layout.ownAttr(LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD);
+        const sortOrder = layout.ownAttr(LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER);
+        const filterAttr = layout.ownAttr(LAYOUT_DATA_GRID_ATTR_FILTER);
+        const grid = {
+            name: layout.name || "default",
+            pageSize: layout.ownAttr(LAYOUT_DATA_GRID_ATTR_PAGE_SIZE) ?? 25,
+            filterable: layout.ownAttr(LAYOUT_DATA_GRID_ATTR_FILTERABLE) === true,
+            columns,
+        };
+        if (typeof sortField === "string")
+            grid.defaultSortField = sortField;
+        if (sortOrder === "asc" || sortOrder === "desc")
+            grid.defaultSortOrder = sortOrder;
+        if (typeof filterAttr === "object" && filterAttr !== null && !Array.isArray(filterAttr)) {
+            grid.filter = filterAttr;
+        }
+        grids.push(grid);
+    }
+    return grids;
+}
+function renderColumnDef(col) {
+    const parts = [];
+    parts.push(`    id: ${JSON.stringify(col.id)}`);
+    parts.push(`    accessorKey: ${JSON.stringify(col.id)}`);
+    parts.push(`    header: ${JSON.stringify(col.header)}`);
+    const meta = [`view: ${JSON.stringify(col.viewKind)}`];
+    if (col.sortable !== undefined)
+        meta.push(`sortable: ${col.sortable}`);
+    if (col.width !== undefined)
+        meta.push(`width: ${col.width}`);
+    if (col.renderer !== undefined)
+        meta.push(`renderer: ${JSON.stringify(col.renderer)}`);
+    parts.push(`    meta: { ${meta.join(", ")} }`);
+    return `  {\n${parts.join(",\n")}\n  }`;
+}
+export function renderColumnsFile(entity, ctx) {
+    const entityName = entity.name;
+    const lcEntity = entityName.charAt(0).toLowerCase() + entityName.slice(1);
+    const grids = extractGrids(entity);
+    const ColumnDefSym = imp("t:ColumnDef@@tanstack/react-table");
+    // Track whether any grid emits a filter const so we know to import <Entity>Filter.
+    let hasFilterConst = false;
+    const sections = grids.map((grid) => {
+        const gridConstName = `${lcEntity}${capitalize(grid.name)}Grid`;
+        const columnsConstName = `${lcEntity}${capitalize(grid.name)}Columns`;
+        const sortBlock = grid.defaultSortField && grid.defaultSortOrder
+            ? `  defaultSort: { field: ${JSON.stringify(grid.defaultSortField)}, order: ${JSON.stringify(grid.defaultSortOrder)} as const },\n`
+            : "";
+        const gridConst = code `
+export const ${gridConstName} = {
+  name:        ${JSON.stringify(grid.name)},
+  pageSize:    ${grid.pageSize},
+${sortBlock}  filterable:  ${grid.filterable},
+};
+`;
+        const colsLines = grid.columns.map(renderColumnDef).join(",\n");
+        const colsConst = code `
+export const ${columnsConstName}: ${ColumnDefSym}<${entityName}Row>[] = [
+${colsLines},
+];
+`;
+        // Emit per-grid filter const when @filter is set. The value is already a
+        // desugared, load-time-validated object — emit it verbatim.
+        let filterConstCode = null;
+        if (grid.filter !== undefined) {
+            const filterConstName = `${lcEntity}${capitalize(grid.name)}Filter`;
+            hasFilterConst = true;
+            filterConstCode = code `
+export const ${filterConstName}: ${entityName}Filter = ${JSON.stringify(grid.filter, null, 2)};
+`;
+        }
+        return filterConstCode
+            ? code `${gridConst}\n${colsConst}\n${filterConstCode}`
+            : code `${gridConst}\n${colsConst}`;
+    });
+    const header = `// ${GENERATED_HEADER}-tanstack — DO NOT EDIT.\n` +
+        `// Source metadata: ${entityName} (${entity.fqn()})\n`;
+    // Import the entity's own file. Same target → relative "./Entity"; cross
+    // target → importBase-qualified package path.
+    const entityModule = entityModuleSpecifier(ctx.selfTarget, ctx.entityModuleTarget, entity.package, entityName, ctx.extStyle);
+    // Import <Entity>Row always; import <Entity>Filter only when a filter const is emitted.
+    const entityImportCode = hasFilterConst
+        ? code `import type { ${entityName} as ${entityName}Row, ${entityName}Filter } from ${JSON.stringify(entityModule)};`
+        : code `import type { ${entityName} as ${entityName}Row } from ${JSON.stringify(entityModule)};`;
+    const body = joinCode(sections, { on: "\n" });
+    return header + entityImportCode.toString() + "\n" + body.toString();
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=columns-file.js.map

package/dist/templates/columns-file.js.map

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

package/dist/templates/grid-hook-file.d.ts

@@ -0,0 +1,4 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import type { RenderContext } from "@metaobjectsdev/codegen-ts";
+export declare function renderGridHookFile(entity: MetaObject, ctx: RenderContext): string;
+//# sourceMappingURL=grid-hook-file.d.ts.map

package/dist/templates/grid-hook-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-hook-file.d.ts","sourceRoot":"","sources":["../../src/templates/grid-hook-file.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,0BAA0B,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AA8BhE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CA+GjF"}

package/dist/templates/grid-hook-file.js

@@ -0,0 +1,125 @@
+// Generated grid-hook template — emits one use<Entity><Grid>Grid() per
+// layout[dataGrid] declared on the entity. The hook owns
+// {sorting, pagination, columnFilters, search} state and runs the query
+// against the entity's CRUD list route with withCount=1 (opt-in envelope).
+//
+// The hook returns the controlled-<EntityGrid> prop shape, so a consumer
+// page is just:
+//   const grid = useSubscriberDefaultGrid();
+//   <EntityGrid {...grid} columns={subscriberDefaultColumns} grid={subscriberDefaultGrid} />
+import { code, imp, joinCode } from "ts-poet";
+import { LAYOUT_SUBTYPE_DATA_GRID } from "@metaobjectsdev/metadata";
+import { GENERATED_HEADER, entityModuleSpecifier, siblingSpecifier } from "@metaobjectsdev/codegen-ts";
+function extractGrids(entity) {
+    const out = [];
+    for (const l of entity.layouts()) {
+        if (l.subType !== LAYOUT_SUBTYPE_DATA_GRID)
+            continue;
+        out.push({
+            name: l.name || "default",
+            pageSize: l.pageSize ?? 25,
+            hasFilterPreset: l.filter !== undefined,
+            defaultSortField: l.defaultSortField,
+            defaultSortOrder: l.defaultSortOrder,
+        });
+    }
+    return out;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+export function renderGridHookFile(entity, ctx) {
+    const entityName = entity.name;
+    const lcEntity = entityName.charAt(0).toLowerCase() + entityName.slice(1);
+    const grids = extractGrids(entity);
+    if (grids.length === 0)
+        return "";
+    // Import the entity's own file. Same target → relative "./Entity"; cross
+    // target → importBase-qualified package path.
+    const entityModule = entityModuleSpecifier(ctx.selfTarget, ctx.entityModuleTarget, entity.package, entityName, ctx.extStyle);
+    // ts-poet symbols (imp()) — typed and deduped on emit.
+    const useStateSym = imp("useState@react");
+    const useMemoSym = imp("useMemo@react");
+    const useQuerySym = imp("useQuery@@tanstack/react-query");
+    const SortingStateSym = imp("t:SortingState@@tanstack/react-table");
+    const PaginationStateSym = imp("t:PaginationState@@tanstack/react-table");
+    const ColumnFiltersStateSym = imp("t:ColumnFiltersState@@tanstack/react-table");
+    const useEntityFetcherSym = imp("useEntityFetcher@@metaobjectsdev/tanstack");
+    const buildFilterQsSym = imp("buildFilterQs@@metaobjectsdev/runtime-web");
+    const entityImports = code `
+import { ${entityName} } from ${JSON.stringify(entityModule)};
+import type { ${entityName} as ${entityName}Row } from ${JSON.stringify(entityModule)};
+`;
+    // Collect names of all filter preset consts needed.
+    const filterPresetImports = grids
+        .filter((g) => g.hasFilterPreset)
+        .map((g) => `${lcEntity}${capitalize(g.name)}Filter`);
+    // Columns file is a same-target sibling of the grid-hook (both emitted to
+    // selfTarget) — always relative, package-layout aware.
+    const columnsModule = siblingSpecifier(ctx.selfTarget, entity.package, `${entityName}.columns`, ctx.extStyle);
+    const filterPresetImportCode = filterPresetImports.length > 0
+        ? code `import { ${filterPresetImports.join(", ")} } from ${JSON.stringify(columnsModule)};\n`
+        : code ``;
+    const sections = grids.map((grid) => {
+        const cap = capitalize(grid.name);
+        const hookName = `use${entityName}${cap}Grid`;
+        const presetConst = grid.hasFilterPreset ? `${lcEntity}${cap}Filter` : null;
+        const initialSorting = grid.defaultSortField
+            ? `[{ id: ${JSON.stringify(grid.defaultSortField)}, desc: ${JSON.stringify(grid.defaultSortOrder === "desc")} }]`
+            : `[]`;
+        const initialPagination = `{ pageIndex: 0, pageSize: ${grid.pageSize} }`;
+        return code `
+export function ${hookName}() {
+  const [sorting,       setSorting]       = ${useStateSym}<${SortingStateSym}>(${initialSorting});
+  const [pagination,    setPagination]    = ${useStateSym}<${PaginationStateSym}>(${initialPagination});
+  const [columnFilters, setColumnFilters] = ${useStateSym}<${ColumnFiltersStateSym}>([]);
+  const [search,        setSearch]        = ${useStateSym}<string>("");
+
+  const fetcher = ${useEntityFetcherSym}();
+
+  const qs = ${useMemoSym}(() => {
+    const filterObj: Record<string, unknown> = ${presetConst ? `{ ...${presetConst} }` : `{}`};
+    for (const f of columnFilters) {
+      filterObj[f.id] = f.value as unknown;
+    }
+    const sort = sorting.length > 0
+      ? \`\${sorting[0].id}:\${sorting[0].desc ? "desc" : "asc"}\`
+      : undefined;
+    return ${buildFilterQsSym}({
+      ...filterObj,
+      ...(sort !== undefined ? { sort } : {}),
+      limit:  pagination.pageSize,
+      offset: pagination.pageIndex * pagination.pageSize,
+      ...(search !== "" ? { search } : {}),
+      withCount: 1,
+    });
+  }, [sorting, pagination, columnFilters, search]);
+
+  const query = ${useQuerySym}<{ rows: ${entityName}Row[]; total: number }>({
+    queryKey: [${JSON.stringify(lcEntity)}, "grid", ${JSON.stringify(grid.name)}, qs],
+    queryFn: () => fetcher<{ rows: ${entityName}Row[]; total: number }>(
+      \`\${${entityName}.$apiPrefix}\${${entityName}.$path}?\${qs}\`,
+    ),
+  });
+
+  return {
+    data: query.data?.rows ?? [],
+    rowCount: query.data?.total ?? 0,
+    state: { sorting, pagination, columnFilters },
+    onSortingChange:       setSorting,
+    onPaginationChange:    setPagination,
+    onColumnFiltersChange: setColumnFilters,
+    search,
+    onSearchChange: setSearch,
+    isLoading: query.isLoading,
+    error:     query.error,
+  };
+}
+`;
+    });
+    const header = `// ${GENERATED_HEADER}-tanstack — DO NOT EDIT.\n` +
+        `// Source metadata: ${entityName} (${entity.fqn()})\n`;
+    const body = joinCode(sections, { on: "\n" });
+    return header + entityImports.toString() + filterPresetImportCode.toString() + body.toString();
+}
+//# sourceMappingURL=grid-hook-file.js.map

package/dist/templates/grid-hook-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-hook-file.js","sourceRoot":"","sources":["../../src/templates/grid-hook-file.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yDAAyD;AACzD,wEAAwE;AACxE,2EAA2E;AAC3E,EAAE;AACF,yEAAyE;AACzE,gBAAgB;AAChB,6CAA6C;AAC7C,6FAA6F;AAE7F,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAa,MAAM,SAAS,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAUvG,SAAS,YAAY,CAAC,MAAkB;IACtC,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAkB,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,OAAO,KAAK,wBAAwB;YAAE,SAAS;QACrD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;YACzB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;YAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,KAAK,SAAS;YACvC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;YACpC,gBAAgB,EAAE,CAAC,CAAC,gBAA8C;SACnE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAkB,EAAE,GAAkB;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;IAC/B,MAAM,QAAQ,GAAK,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAQ,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,yEAAyE;IACzE,8CAA8C;IAC9C,MAAM,YAAY,GAAG,qBAAqB,CACxC,GAAG,CAAC,UAAU,EACd,GAAG,CAAC,kBAAkB,EACtB,MAAM,CAAC,OAAO,EACd,UAAU,EACV,GAAG,CAAC,QAAQ,CACb,CAAC;IAEF,uDAAuD;IACvD,MAAM,WAAW,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAS,GAAG,CAAC,sCAAsC,CAAC,CAAC;IAC1E,MAAM,kBAAkB,GAAM,GAAG,CAAC,yCAAyC,CAAC,CAAC;IAC7E,MAAM,qBAAqB,GAAG,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAChF,MAAM,mBAAmB,GAAG,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAC7E,MAAM,gBAAgB,GAAM,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAE7E,MAAM,aAAa,GAAS,IAAI,CAAA;WACvB,UAAU,WAAW,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBAC5C,UAAU,OAAO,UAAU,cAAc,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;CACpF,CAAC;IAEA,oDAAoD;IACpD,MAAM,mBAAmB,GAAa,KAAK;SACxC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAExD,0EAA0E;IAC1E,uDAAuD;IACvD,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9G,MAAM,sBAAsB,GAC1B,mBAAmB,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,CAAC,IAAI,CAAA,YAAY,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK;QAC7F,CAAC,CAAC,IAAI,CAAA,EAAE,CAAC;IAEb,MAAM,QAAQ,GAAW,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAQ,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC;QAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QAE5E,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB;YAC1C,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,KAAK;YACjH,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,iBAAiB,GAAG,6BAA6B,IAAI,CAAC,QAAQ,IAAI,CAAC;QAEzE,OAAO,IAAI,CAAA;kBACG,QAAQ;8CACoB,WAAW,IAAI,eAAe,KAAK,cAAc;8CACjD,WAAW,IAAI,kBAAkB,KAAK,iBAAiB;8CACvD,WAAW,IAAI,qBAAqB;8CACpC,WAAW;;oBAErC,mBAAmB;;eAExB,UAAU;iDACwB,WAAW,CAAC,CAAC,CAAC,QAAQ,WAAW,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;aAOhF,gBAAgB;;;;;;;;;;kBAUX,WAAW,YAAY,UAAU;iBAClC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;qCAC1C,UAAU;aAClC,UAAU,kBAAkB,UAAU;;;;;;;;;;;;;;;;;CAiBlD,CAAC;IACA,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GACV,MAAM,gBAAgB,4BAA4B;QAClD,uBAAuB,UAAU,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC;IAE1D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,sBAAsB,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;AACjG,CAAC"}

package/dist/templates/hooks-file.d.ts

@@ -0,0 +1,20 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import type { RenderContext } from "@metaobjectsdev/codegen-ts";
+/**
+ * Render <Entity>.hooks.ts — query-key factory + 2 query hooks + (for non-projections) 3 mutation hooks.
+ *
+ * Projections (view-backed, read-only) emit only:
+ *   - <camel>Keys query-key factory
+ *   - use<Entity>(id)       — useQuery on GET :id
+ *   - use<Entities>(filter) — useQuery on list
+ *
+ * Full (writable) entities additionally emit:
+ *   - useCreate<Entity>
+ *   - useUpdate<Entity>
+ *   - useDelete<Entity>
+ *
+ * All hooks call useEntityFetcher() (from @metaobjectsdev/tanstack) for
+ * the underlying HTTP. Mutations aggressively invalidate <entity>Keys.all().
+ */
+export declare function renderHooksFile(entity: MetaObject, ctx: RenderContext): string;
+//# sourceMappingURL=hooks-file.d.ts.map

package/dist/templates/hooks-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-file.d.ts","sourceRoot":"","sources":["../../src/templates/hooks-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAc9E"}

package/dist/templates/hooks-file.js

@@ -0,0 +1,208 @@
+import { code, imp, joinCode } from "ts-poet";
+import { GENERATED_HEADER, isProjection, pluralize, entityModuleSpecifier } from "@metaobjectsdev/codegen-ts";
+/**
+ * Render <Entity>.hooks.ts — query-key factory + 2 query hooks + (for non-projections) 3 mutation hooks.
+ *
+ * Projections (view-backed, read-only) emit only:
+ *   - <camel>Keys query-key factory
+ *   - use<Entity>(id)       — useQuery on GET :id
+ *   - use<Entities>(filter) — useQuery on list
+ *
+ * Full (writable) entities additionally emit:
+ *   - useCreate<Entity>
+ *   - useUpdate<Entity>
+ *   - useDelete<Entity>
+ *
+ * All hooks call useEntityFetcher() (from @metaobjectsdev/tanstack) for
+ * the underlying HTTP. Mutations aggressively invalidate <entity>Keys.all().
+ */
+export function renderHooksFile(entity, ctx) {
+    // Import the entity's own file. Same target → relative "./Entity"; cross
+    // target → importBase-qualified package path.
+    const entityModule = entityModuleSpecifier(ctx.selfTarget, ctx.entityModuleTarget, entity.package, entity.name, ctx.extStyle);
+    if (isProjection(entity)) {
+        return renderReadOnlyHooksFile(entity, entityModule);
+    }
+    return renderFullHooksFile(entity, entityModule);
+}
+// ---------------------------------------------------------------------------
+// Read-only path (projections)
+// ---------------------------------------------------------------------------
+function renderReadOnlyHooksFile(entity, entityModule) {
+    const entityName = entity.name;
+    const entityNamePlural = pluralize(entityName);
+    const lcEntity = entityName.charAt(0).toLowerCase() + entityName.slice(1);
+    const keysVar = `${lcEntity}Keys`;
+    const useQuerySym = imp("useQuery@@tanstack/react-query");
+    const useQueryOptionsSym = imp("t:UseQueryOptions@@tanstack/react-query");
+    const useQueryResultSym = imp("t:UseQueryResult@@tanstack/react-query");
+    const useEntityFetcherSym = imp("useEntityFetcher@@metaobjectsdev/tanstack");
+    const buildFilterQsSym = imp("buildFilterQs@@metaobjectsdev/runtime-web");
+    const entityImports = code `
+import {
+  ${entityName},
+  type ${entityName} as ${entityName}Row,
+  type ${entityName}Filter,
+} from ${JSON.stringify(entityModule)};
+`;
+    const queryKeys = code `
+export const ${keysVar} = {
+  all:     () => [${JSON.stringify(lcEntity)}] as const,
+  lists:   () => [...${keysVar}.all(), "list"] as const,
+  list:    (filter?: ${entityName}Filter) => [...${keysVar}.lists(), filter ?? {}] as const,
+  details: () => [...${keysVar}.all(), "detail"] as const,
+  detail:  (id: number) => [...${keysVar}.details(), id] as const,
+};
+`;
+    const queries = code `
+export function use${entityName}(
+  id: number,
+  opts?: Omit<${useQueryOptionsSym}<${entityName}Row>, "queryKey" | "queryFn">,
+): ${useQueryResultSym}<${entityName}Row> {
+  const fetcher = ${useEntityFetcherSym}();
+  return ${useQuerySym}<${entityName}Row>({
+    queryKey: ${keysVar}.detail(id),
+    queryFn: () => fetcher<${entityName}Row>(\`\${${entityName}.$apiPrefix}\${${entityName}.$path}/\${id}\`),
+    ...opts,
+  });
+}
+
+export function use${entityNamePlural}(
+  filter?: ${entityName}Filter,
+  opts?: Omit<${useQueryOptionsSym}<${entityName}Row[]>, "queryKey" | "queryFn">,
+): ${useQueryResultSym}<${entityName}Row[]> {
+  const fetcher = ${useEntityFetcherSym}();
+  const qs = filter ? "?" + ${buildFilterQsSym}(filter as Record<string, unknown>) : "";
+  return ${useQuerySym}<${entityName}Row[]>({
+    queryKey: ${keysVar}.list(filter),
+    queryFn: () => fetcher<${entityName}Row[]>(\`\${${entityName}.$apiPrefix}\${${entityName}.$path}\${qs}\`),
+    ...opts,
+  });
+}
+`;
+    const body = joinCode([queryKeys, queries], { on: "\n" });
+    const header = `// ${GENERATED_HEADER}-tanstack — DO NOT EDIT.\n` +
+        `// Source metadata: ${entityName} (${entity.fqn()})\n`;
+    return header + entityImports.toString() + body.toString();
+}
+// ---------------------------------------------------------------------------
+// Full path (writable entities — table-backed or write-through)
+// ---------------------------------------------------------------------------
+function renderFullHooksFile(entity, entityModule) {
+    const entityName = entity.name;
+    const entityNamePlural = pluralize(entityName);
+    const lcEntity = entityName.charAt(0).toLowerCase() + entityName.slice(1);
+    const keysVar = `${lcEntity}Keys`;
+    const useMutationSym = imp("useMutation@@tanstack/react-query");
+    const useQuerySym = imp("useQuery@@tanstack/react-query");
+    const useQueryClientSym = imp("useQueryClient@@tanstack/react-query");
+    const useQueryOptionsSym = imp("t:UseQueryOptions@@tanstack/react-query");
+    const useMutationOptionsSym = imp("t:UseMutationOptions@@tanstack/react-query");
+    const useQueryResultSym = imp("t:UseQueryResult@@tanstack/react-query");
+    const useMutationResultSym = imp("t:UseMutationResult@@tanstack/react-query");
+    const useEntityFetcherSym = imp("useEntityFetcher@@metaobjectsdev/tanstack");
+    const buildFilterQsSym = imp("buildFilterQs@@metaobjectsdev/runtime-web");
+    const entityImports = code `
+import {
+  ${entityName},
+  type ${entityName} as ${entityName}Row,
+  type ${entityName}Insert,
+  type ${entityName}Update,
+  type ${entityName}Filter,
+} from ${JSON.stringify(entityModule)};
+`;
+    const queryKeys = code `
+export const ${keysVar} = {
+  all:     () => [${JSON.stringify(lcEntity)}] as const,
+  lists:   () => [...${keysVar}.all(), "list"] as const,
+  list:    (filter?: ${entityName}Filter) => [...${keysVar}.lists(), filter ?? {}] as const,
+  details: () => [...${keysVar}.all(), "detail"] as const,
+  detail:  (id: number) => [...${keysVar}.details(), id] as const,
+};
+`;
+    const queries = code `
+export function use${entityName}(
+  id: number,
+  opts?: Omit<${useQueryOptionsSym}<${entityName}Row>, "queryKey" | "queryFn">,
+): ${useQueryResultSym}<${entityName}Row> {
+  const fetcher = ${useEntityFetcherSym}();
+  return ${useQuerySym}<${entityName}Row>({
+    queryKey: ${keysVar}.detail(id),
+    queryFn: () => fetcher<${entityName}Row>(\`\${${entityName}.$apiPrefix}\${${entityName}.$path}/\${id}\`),
+    ...opts,
+  });
+}
+
+export function use${entityNamePlural}(
+  filter?: ${entityName}Filter,
+  opts?: Omit<${useQueryOptionsSym}<${entityName}Row[]>, "queryKey" | "queryFn">,
+): ${useQueryResultSym}<${entityName}Row[]> {
+  const fetcher = ${useEntityFetcherSym}();
+  const qs = filter ? "?" + ${buildFilterQsSym}(filter as Record<string, unknown>) : "";
+  return ${useQuerySym}<${entityName}Row[]>({
+    queryKey: ${keysVar}.list(filter),
+    queryFn: () => fetcher<${entityName}Row[]>(\`\${${entityName}.$apiPrefix}\${${entityName}.$path}\${qs}\`),
+    ...opts,
+  });
+}
+`;
+    const mutations = code `
+export function useCreate${entityName}(
+  opts?: Omit<${useMutationOptionsSym}<${entityName}Row, Error, ${entityName}Insert>, "mutationFn">,
+): ${useMutationResultSym}<${entityName}Row, Error, ${entityName}Insert> {
+  const fetcher = ${useEntityFetcherSym}();
+  const qc = ${useQueryClientSym}();
+  return ${useMutationSym}<${entityName}Row, Error, ${entityName}Insert>({
+    mutationFn: (input) => fetcher<${entityName}Row>(\`\${${entityName}.$apiPrefix}\${${entityName}.$path}\`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(input),
+    }),
+    ...opts,
+    onSuccess: (...args) => {
+      qc.invalidateQueries({ queryKey: ${keysVar}.all() });
+      opts?.onSuccess?.(...args);
+    },
+  });
+}
+
+export function useUpdate${entityName}(
+  opts?: Omit<${useMutationOptionsSym}<${entityName}Row, Error, { id: number; input: ${entityName}Update }>, "mutationFn">,
+): ${useMutationResultSym}<${entityName}Row, Error, { id: number; input: ${entityName}Update }> {
+  const fetcher = ${useEntityFetcherSym}();
+  const qc = ${useQueryClientSym}();
+  return ${useMutationSym}({
+    mutationFn: ({ id, input }) => fetcher<${entityName}Row>(\`\${${entityName}.$apiPrefix}\${${entityName}.$path}/\${id}\`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(input),
+    }),
+    ...opts,
+    onSuccess: (...args) => {
+      qc.invalidateQueries({ queryKey: ${keysVar}.all() });
+      opts?.onSuccess?.(...args);
+    },
+  });
+}
+
+export function useDelete${entityName}(
+  opts?: Omit<${useMutationOptionsSym}<void, Error, number>, "mutationFn">,
+): ${useMutationResultSym}<void, Error, number> {
+  const fetcher = ${useEntityFetcherSym}();
+  const qc = ${useQueryClientSym}();
+  return ${useMutationSym}({
+    mutationFn: (id) => fetcher<void>(\`\${${entityName}.$apiPrefix}\${${entityName}.$path}/\${id}\`, { method: "DELETE" }),
+    ...opts,
+    onSuccess: (...args) => {
+      qc.invalidateQueries({ queryKey: ${keysVar}.all() });
+      opts?.onSuccess?.(...args);
+    },
+  });
+}
+`;
+    const body = joinCode([queryKeys, queries, mutations], { on: "\n" });
+    const header = `// ${GENERATED_HEADER}-tanstack — DO NOT EDIT.\n` +
+        `// Source metadata: ${entityName} (${entity.fqn()})\n`;
+    return header + entityImports.toString() + body.toString();
+}
+//# sourceMappingURL=hooks-file.js.map

package/dist/templates/hooks-file.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@metaobjectsdev/codegen-ts-tanstack",
+  "version": "0.5.0-rc.1",
+  "description": "TanStack codegen for metaobjects — emits hooks and column definitions for TanStack Query and Table.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "src", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p .",
+    "typecheck": "tsc -p tsconfig.typecheck.json"
+  },
+  "license": "Apache-2.0",
+  "author": "Doug Mealing <doug@dougmealing.com>",
+  "homepage": "https://metaobjects.dev",
+  "bugs": {
+  "url": "https://github.com/metaobjectsdev/metaobjects/issues"
+},
+"repository": {
+  "type": "git",
+  "url": "https://github.com/metaobjectsdev/metaobjects.git",
+  "directory": "server/typescript/packages/codegen-ts-tanstack"
+},
+"keywords": ["metaobjects", "codegen", "tanstack", "react-query", "react-table"],
+"publishConfig": {
+"access": "public"
+},
+"dependencies": {
+  "@metaobjectsdev/metadata": "0.5.0",
+  "@metaobjectsdev/codegen-ts": "0.5.0",
+  "ts-poet": "^6.10.0"
+},
+"peerDependencies": {
+  "@biomejs/biome": ">=1.9.0"
+},
+"devDependencies": {
+  "@biomejs/biome": "^1.9.0",
+  "bun-types": "latest",
+  "typescript": "^5.6.0"
+}
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+// Public API surface for @metaobjectsdev/codegen-ts-tanstack.
+export { tanstackQuery, type TanstackQueryOpts } from "./tanstack-query.js";
+export { tanstackGrid, type TanstackGridOpts } from "./tanstack-grid.js";
+export { tanstackGridHook, type TanstackGridHookOpts } from "./tanstack-grid-hook.js";

package/src/tanstack-grid-hook.ts

@@ -0,0 +1,50 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import { LAYOUT_SUBTYPE_DATA_GRID } from "@metaobjectsdev/metadata";
+import { perEntity, type Generator, type GeneratorFactory, formatTs, entityOutputPath } from "@metaobjectsdev/codegen-ts";
+import { renderGridHookFile } from "./templates/grid-hook-file.js";
+
+export interface TanstackGridHookOpts {
+  filter?: (entity: MetaObject) => boolean;
+  target?: string;
+}
+
+function hasDataGridLayout(entity: MetaObject): boolean {
+  // layouts() is effective — own + inherited layouts (from extends:/super:).
+  return entity.layouts().some((l) => l.subType === LAYOUT_SUBTYPE_DATA_GRID);
+}
+
+/**
+ * Per-entity generator that emits <Entity>.grid.ts — one
+ * use<Entity><Grid>Grid() hook per layout[dataGrid] declared on the entity.
+ *
+ * Per-entity opt-out via @emitTanstack: false. Per-entity opt-IN: presence of
+ * at least one dataGrid layout on the object (mirrors tanstackGrid).
+ */
+export const tanstackGridHook = function tanstackGridHook(opts?: TanstackGridHookOpts): Generator {
+  const userFilter = opts?.filter ?? (() => true);
+  const generator: Generator = {
+    name: "tanstack-grid-hook",
+    // AND-composes opt-out, user filter, and dataGrid layout presence.
+    filter: (e: MetaObject) =>
+      e.ownAttr("emitTanstack") !== false
+      && userFilter(e)
+      && hasDataGridLayout(e),
+    generate: perEntity(async (entity, ctx) => {
+      if (!ctx.renderContext) {
+        throw new Error("tanstack-grid-hook: renderContext is required (provided by runGen)");
+      }
+      return {
+        path: entityOutputPath(
+          ctx.renderContext.outputLayout,
+          entity.package,
+          `${entity.name}.grid.ts`,
+        ),
+        content: await formatTs(renderGridHookFile(entity, ctx.renderContext)),
+      };
+    }),
+  };
+  if (opts?.target) {
+    generator.target = opts.target;
+  }
+  return generator;
+} as GeneratorFactory<TanstackGridHookOpts | void>;