@metaobjectsdev/tanstack 0.24.5 → 1.0.0-rc.1

package/dist/cell-renderers.d.ts

@@ -1,9 +1,37 @@
 import type { CellContext } from "@tanstack/react-table";
 import type { ReactNode } from "react";
+import { type ImageUploadAdapter } from "@metaobjectsdev/runtime-web";
 export type CellRenderer = (ctx: CellContext<any, any>) => ReactNode;
 /**
  * Default cell renderers keyed by field `view` subtype.
  * Apps override per-key via <CellRendererProvider>.
  */
 export declare const defaultCellRenderers: Record<string, CellRenderer>;
+/** Presentation knobs for {@link imageCell}. Both have defaults; neither is metadata —
+ *  a column's `meta` carries only view/sortable/width/renderer, so `view.image`'s
+ *  @aspectRatio / @maxEdge do not reach the grid. */
+export interface ImageCellOptions {
+    /** Rendered edge length in px (square thumbnail). Default 32. */
+    size?: number;
+    /** Alt text. Defaults to "" — the row around the cell already carries the meaning,
+     *  and announcing an opaque storage key is worse than announcing nothing. */
+    alt?: string;
+}
+/**
+ * Cell renderer for a `view.image` column, closed over the app's upload/serve adapter.
+ *
+ * A FACTORY rather than a `defaultCellRenderers` key, and deliberately: the field stores
+ * an opaque storage key, so turning it into a `src` requires `ImageUploadAdapter.imageUrl`
+ * — and the adapter's React context lives in `@metaobjectsdev/react`, which declares
+ * `react-hook-form` and `@hookform/resolvers` as REQUIRED peers. A dependency edge from
+ * this package would make every grid-only consumer responsible for a form stack it never
+ * uses, and `peerDependencies` are declared per PACKAGE, so no subpath or export-map change
+ * reaches that. The app supplies the adapter instead:
+ *
+ *     <CellRendererProvider value={{ image: imageCell(adapter) }}>
+ *
+ * Only the adapter's TYPE is imported here, from a package this one already depends on, so
+ * the helper costs nothing at install or bundle time.
+ */
+export declare function imageCell(adapter: ImageUploadAdapter, opts?: ImageCellOptions): CellRenderer;
 //# sourceMappingURL=cell-renderers.d.ts.map

package/dist/cell-renderers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cell-renderers.d.ts","sourceRoot":"","sources":["../src/cell-renderers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,SAAS,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA0B7D,CAAC"}
+{"version":3,"file":"cell-renderers.d.ts","sourceRoot":"","sources":["../src/cell-renderers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,SAAS,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA+D7D,CAAC;AAEF;;qDAEqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;iFAC6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,GAAE,gBAAqB,GAAG,YAAY,CA4BhG"}

package/dist/cell-renderers.js

@@ -1,3 +1,4 @@
+import { jsx as _jsx } from "react/jsx-runtime";
 import { formatCurrency } from "@metaobjectsdev/runtime-web";
 /**
  * Default cell renderers keyed by field `view` subtype.
@@ -11,11 +12,44 @@ export const defaultCellRenderers = {
         const v = ctx.getValue();
         return v ? new Date(v).toLocaleDateString() : "";
     },
-    datetime: (ctx) => {
+    // #355 — keyed by REGISTERED view subtype. `checkbox` is the registered subtype for a
+    // boolean-valued view; this renderer previously sat under `boolean`, which no subtype
+    // produces, so it was unreachable and a checkbox column rendered a raw true/false.
+    checkbox: (ctx) => (ctx.getValue() ? "Yes" : "No"),
+    // `view.month` is registered as "Month picker / month display", and rendered the raw
+    // stored string. Parsed field-wise rather than through `new Date("2026-09")`, which is
+    // UTC midnight and so displays the PREVIOUS month for every viewer west of Greenwich.
+    month: (ctx) => {
         const v = ctx.getValue();
-        return v ? new Date(v).toLocaleString() : "";
+        if (v == null || v === "")
+            return "";
+        const m = /^(\d{4})-(\d{2})/.exec(String(v));
+        const d = m ? new Date(Number(m[1]), Number(m[2]) - 1, 1) : new Date(String(v));
+        return Number.isNaN(d.getTime())
+            ? String(v)
+            : d.toLocaleDateString(undefined, { year: "numeric", month: "long" });
+    },
+    // `view.hotlink` is registered as "Renders the value as a clickable link" and rendered
+    // plain text — the same broken promise `checkbox` had. The scheme is checked because
+    // this value comes from the database: an anchor built blindly from a stored string is
+    // a `javascript:` URL away from executing it on click. Anything not http/https/mailto
+    // renders as text, which is what it did before, so the guard can only ever be safe.
+    hotlink: (ctx) => {
+        const v = ctx.getValue();
+        const s = v == null ? "" : String(v);
+        if (s === "")
+            return "";
+        let scheme;
+        try {
+            scheme = new URL(s).protocol;
+        }
+        catch {
+            return s; // not an absolute URL at all — render it as the text it is
+        }
+        if (scheme !== "http:" && scheme !== "https:" && scheme !== "mailto:")
+            return s;
+        return (_jsx("a", { href: s, rel: "noreferrer noopener", target: "_blank", children: s }));
     },
-    boolean: (ctx) => (ctx.getValue() ? "Yes" : "No"),
     currency: (ctx) => {
         const value = ctx.getValue();
         if (value == null || !Number.isFinite(Number(value)))
@@ -30,6 +64,48 @@ export const defaultCellRenderers = {
         }
     },
     dropdown: (ctx) => String(ctx.getValue() ?? ""),
+    // Same rendering as `dropdown` — a selection control's cell is its chosen value. Keyed
+    // explicitly rather than left to EntityGrid's no-renderer fall-through, so that "a radio
+    // column shows its value" is a decision this map records instead of an accident.
+    radio: (ctx) => String(ctx.getValue() ?? ""),
     password: () => "•••••",
 };
+/**
+ * Cell renderer for a `view.image` column, closed over the app's upload/serve adapter.
+ *
+ * A FACTORY rather than a `defaultCellRenderers` key, and deliberately: the field stores
+ * an opaque storage key, so turning it into a `src` requires `ImageUploadAdapter.imageUrl`
+ * — and the adapter's React context lives in `@metaobjectsdev/react`, which declares
+ * `react-hook-form` and `@hookform/resolvers` as REQUIRED peers. A dependency edge from
+ * this package would make every grid-only consumer responsible for a form stack it never
+ * uses, and `peerDependencies` are declared per PACKAGE, so no subpath or export-map change
+ * reaches that. The app supplies the adapter instead:
+ *
+ *     <CellRendererProvider value={{ image: imageCell(adapter) }}>
+ *
+ * Only the adapter's TYPE is imported here, from a package this one already depends on, so
+ * the helper costs nothing at install or bundle time.
+ */
+export function imageCell(adapter, opts = {}) {
+    const size = opts.size ?? 32;
+    const alt = opts.alt ?? "";
+    return (ctx) => {
+        const v = ctx.getValue();
+        const key = v == null ? "" : String(v);
+        if (key === "")
+            return "";
+        let src;
+        try {
+            src = adapter.imageUrl(key);
+        }
+        catch {
+            // An adapter that cannot resolve the key: render the key as the text it is, the
+            // same fall-back `hotlink` makes for a value that is not a URL. There is no
+            // harmless empty-src alternative — an <img src=""> resolves to the PAGE url and
+            // re-requests it.
+            return key;
+        }
+        return (_jsx("img", { src: src, alt: alt, width: size, height: size, loading: "lazy", style: { objectFit: "cover" } }));
+    };
+}
 //# sourceMappingURL=cell-renderers.js.map

package/dist/cell-renderers.js.map

@@ -1 +1 @@
-{"version":3,"file":"cell-renderers.js","sourceRoot":"","sources":["../src/cell-renderers.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,IAAI,EAAM,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,EAAI,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAI,EAAM,CAAC,GAAG,EAAE,EAAE;QAChB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAW,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;QAChB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAW,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,EAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;QAChB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAA2C,CAAC;QACzF,IAAI,CAAC;YACH,OAAO,cAAc,CAAC,KAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO;CACxB,CAAC"}
+{"version":3,"file":"cell-renderers.js","sourceRoot":"","sources":["../src/cell-renderers.tsx"],"names":[],"mappings":"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"}

package/dist/entity-fetcher.d.ts

@@ -1,11 +1,27 @@
 import { type ReactNode } from "react";
-import type { EntityFetcher } from "@metaobjectsdev/runtime-web";
+import { type EntityFetcher } from "@metaobjectsdev/runtime-web";
 export interface EntityFetcherProviderProps {
-    value: EntityFetcher;
+    /**
+     * Transport only. It receives an already-prefixed URL and never learns about
+     * routing — that split is why `baseUrl` is a sibling option here rather than
+     * something each app hides inside its own fetch helper.
+     */
+    fetcher: EntityFetcher;
+    /**
+     * Where the API lives — a path (`/api`) or a full origin
+     * (`https://api.example.com/v1`).
+     *
+     * OPTIONAL, default `""`: same-origin at the root, which is what `meta init`
+     * scaffolds (`apiPrefix: ""`). Generated hooks emit entity-relative paths, so this
+     * is the single place the base is decided, and deciding it at RUNTIME rather than
+     * at `meta gen` time is what lets one client bundle serve a dev proxy, a preview
+     * environment and a separate API host without regenerating.
+     */
+    baseUrl?: string | undefined;
     children: ReactNode;
 }
 /** Wrap your app (or admin subtree) to supply a fetcher to generated hooks. */
-export declare function EntityFetcherProvider({ value, children }: EntityFetcherProviderProps): import("react").JSX.Element;
-/** Reads the fetcher from context. Throws if not provided. */
+export declare function EntityFetcherProvider({ fetcher, baseUrl, children, }: EntityFetcherProviderProps): import("react").JSX.Element;
+/** Reads the fetcher from context, already bound to `baseUrl`. Throws if not provided. */
 export declare function useEntityFetcher(): EntityFetcher;
 //# sourceMappingURL=entity-fetcher.d.ts.map

package/dist/entity-fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-fetcher.d.ts","sourceRoot":"","sources":["../src/entity-fetcher.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,0BAA0B,+BAEpF;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,IAAI,aAAa,CAShD"}
+{"version":3,"file":"entity-fetcher.d.ts","sourceRoot":"","sources":["../src/entity-fetcher.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI9E,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,OAAO,EAAE,aAAa,CAAC;IACvB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,GACT,EAAE,0BAA0B,+BAU5B;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,IAAI,aAAa,CAShD"}

package/dist/entity-fetcher.js

@@ -1,16 +1,20 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext } from "react";
+import { createContext, useContext, useMemo } from "react";
+import { joinBaseUrl } from "@metaobjectsdev/runtime-web";
 const EntityFetcherContext = createContext(null);
 /** Wrap your app (or admin subtree) to supply a fetcher to generated hooks. */
-export function EntityFetcherProvider({ value, children }) {
+export function EntityFetcherProvider({ fetcher, baseUrl, children, }) {
+    // Memoized so the wrapped identity is stable across renders. An unmemoized wrapper is
+    // a new function every render, which churns everything downstream that captures it.
+    const value = useMemo(() => ((path, init) => fetcher(joinBaseUrl(baseUrl, path), init)), [fetcher, baseUrl]);
     return _jsx(EntityFetcherContext.Provider, { value: value, children: children });
 }
-/** Reads the fetcher from context. Throws if not provided. */
+/** Reads the fetcher from context, already bound to `baseUrl`. Throws if not provided. */
 export function useEntityFetcher() {
     const fetcher = useContext(EntityFetcherContext);
     if (!fetcher) {
         throw new Error("useEntityFetcher() called outside <EntityFetcherProvider>. " +
-            "Wrap your app (or the relevant subtree) with EntityFetcherProvider value={...}.");
+            "Wrap your app (or the relevant subtree) with EntityFetcherProvider fetcher={...}.");
     }
     return fetcher;
 }

package/dist/entity-fetcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-fetcher.js","sourceRoot":"","sources":["../src/entity-fetcher.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAGlE,MAAM,oBAAoB,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAOvE,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAA8B;IACnF,OAAO,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAiC,CAAC;AACjG,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,iFAAiF,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"entity-fetcher.js","sourceRoot":"","sources":["../src/entity-fetcher.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAsB,MAAM,6BAA6B,CAAC;AAE9E,MAAM,oBAAoB,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAuBvE,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,GACmB;IAC3B,sFAAsF;IACtF,oFAAoF;IACpF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CACH,CAAC,CAAK,IAAY,EAAE,IAAkB,EAAE,EAAE,CACxC,OAAO,CAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAkB,EAClE,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB,CAAC;IACF,OAAO,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAiC,CAAC;AACjG,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,mFAAmF,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { EntityFetcherProvider, useEntityFetcher } from "./entity-fetcher.js";
 export type { EntityFetcherProviderProps } from "./entity-fetcher.js";
 export type { EntityFetcher, GridConfig } from "@metaobjectsdev/runtime-web";
-export { defaultCellRenderers, type CellRenderer } from "./cell-renderers.js";
+export { defaultCellRenderers, imageCell, type CellRenderer, type ImageCellOptions, } from "./cell-renderers.js";
 export { CellRendererProvider, useCellRenderers, type CellRendererProviderProps, } from "./cell-renderer-provider.js";
 export { EntityGrid, type EntityGridProps, type EntityGridState } from "./entity-grid.js";
 export { buildFilterQs } from "@metaobjectsdev/runtime-web";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 // Public API surface for @metaobjectsdev/tanstack.
 export { EntityFetcherProvider, useEntityFetcher } from "./entity-fetcher.js";
-export { defaultCellRenderers } from "./cell-renderers.js";
+export { defaultCellRenderers, imageCell, } from "./cell-renderers.js";
 export { CellRendererProvider, useCellRenderers, } from "./cell-renderer-provider.js";
 export { EntityGrid } from "./entity-grid.js";
 export { buildFilterQs } from "@metaobjectsdev/runtime-web";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,EAAE,oBAAoB,EAAqB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAA8C,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,EACL,oBAAoB,EACpB,SAAS,GAGV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAA8C,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/tanstack",
-  "version": "0.24.5",
+  "version": "1.0.0-rc.1",
   "description": "TanStack runtime for metaobjects: EntityFetcherProvider, EntityGrid, default cell renderers.",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@metaobjectsdev/runtime-web": "0.24.5"
+    "@metaobjectsdev/runtime-web": "1.0.0-rc.1"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.90.0",

package/src/cell-renderers.tsx

@@ -1,6 +1,6 @@
 import type { CellContext } from "@tanstack/react-table";
 import type { ReactNode } from "react";
-import { formatCurrency } from "@metaobjectsdev/runtime-web";
+import { formatCurrency, type ImageUploadAdapter } from "@metaobjectsdev/runtime-web";
 
 export type CellRenderer = (ctx: CellContext<any, any>) => ReactNode;
 
@@ -16,11 +16,44 @@ export const defaultCellRenderers: Record<string, CellRenderer> = {
     const v = ctx.getValue();
     return v ? new Date(v as string).toLocaleDateString() : "";
   },
-  datetime: (ctx) => {
+  // #355 — keyed by REGISTERED view subtype. `checkbox` is the registered subtype for a
+  // boolean-valued view; this renderer previously sat under `boolean`, which no subtype
+  // produces, so it was unreachable and a checkbox column rendered a raw true/false.
+  checkbox: (ctx) => (ctx.getValue() ? "Yes" : "No"),
+  // `view.month` is registered as "Month picker / month display", and rendered the raw
+  // stored string. Parsed field-wise rather than through `new Date("2026-09")`, which is
+  // UTC midnight and so displays the PREVIOUS month for every viewer west of Greenwich.
+  month: (ctx) => {
     const v = ctx.getValue();
-    return v ? new Date(v as string).toLocaleString() : "";
+    if (v == null || v === "") return "";
+    const m = /^(\d{4})-(\d{2})/.exec(String(v));
+    const d = m ? new Date(Number(m[1]), Number(m[2]) - 1, 1) : new Date(String(v));
+    return Number.isNaN(d.getTime())
+      ? String(v)
+      : d.toLocaleDateString(undefined, { year: "numeric", month: "long" });
+  },
+  // `view.hotlink` is registered as "Renders the value as a clickable link" and rendered
+  // plain text — the same broken promise `checkbox` had. The scheme is checked because
+  // this value comes from the database: an anchor built blindly from a stored string is
+  // a `javascript:` URL away from executing it on click. Anything not http/https/mailto
+  // renders as text, which is what it did before, so the guard can only ever be safe.
+  hotlink: (ctx) => {
+    const v = ctx.getValue();
+    const s = v == null ? "" : String(v);
+    if (s === "") return "";
+    let scheme: string;
+    try {
+      scheme = new URL(s).protocol;
+    } catch {
+      return s; // not an absolute URL at all — render it as the text it is
+    }
+    if (scheme !== "http:" && scheme !== "https:" && scheme !== "mailto:") return s;
+    return (
+      <a href={s} rel="noreferrer noopener" target="_blank">
+        {s}
+      </a>
+    );
   },
-  boolean:  (ctx) => (ctx.getValue() ? "Yes" : "No"),
   currency: (ctx) => {
     const value = ctx.getValue();
     if (value == null || !Number.isFinite(Number(value))) return "";
@@ -33,5 +66,66 @@ export const defaultCellRenderers: Record<string, CellRenderer> = {
     }
   },
   dropdown: (ctx) => String(ctx.getValue() ?? ""),
+  // Same rendering as `dropdown` — a selection control's cell is its chosen value. Keyed
+  // explicitly rather than left to EntityGrid's no-renderer fall-through, so that "a radio
+  // column shows its value" is a decision this map records instead of an accident.
+  radio:    (ctx) => String(ctx.getValue() ?? ""),
   password: () => "•••••",
 };
+
+/** Presentation knobs for {@link imageCell}. Both have defaults; neither is metadata —
+ *  a column's `meta` carries only view/sortable/width/renderer, so `view.image`'s
+ *  @aspectRatio / @maxEdge do not reach the grid. */
+export interface ImageCellOptions {
+  /** Rendered edge length in px (square thumbnail). Default 32. */
+  size?: number;
+  /** Alt text. Defaults to "" — the row around the cell already carries the meaning,
+   *  and announcing an opaque storage key is worse than announcing nothing. */
+  alt?: string;
+}
+
+/**
+ * Cell renderer for a `view.image` column, closed over the app's upload/serve adapter.
+ *
+ * A FACTORY rather than a `defaultCellRenderers` key, and deliberately: the field stores
+ * an opaque storage key, so turning it into a `src` requires `ImageUploadAdapter.imageUrl`
+ * — and the adapter's React context lives in `@metaobjectsdev/react`, which declares
+ * `react-hook-form` and `@hookform/resolvers` as REQUIRED peers. A dependency edge from
+ * this package would make every grid-only consumer responsible for a form stack it never
+ * uses, and `peerDependencies` are declared per PACKAGE, so no subpath or export-map change
+ * reaches that. The app supplies the adapter instead:
+ *
+ *     <CellRendererProvider value={{ image: imageCell(adapter) }}>
+ *
+ * Only the adapter's TYPE is imported here, from a package this one already depends on, so
+ * the helper costs nothing at install or bundle time.
+ */
+export function imageCell(adapter: ImageUploadAdapter, opts: ImageCellOptions = {}): CellRenderer {
+  const size = opts.size ?? 32;
+  const alt = opts.alt ?? "";
+  return (ctx) => {
+    const v = ctx.getValue();
+    const key = v == null ? "" : String(v);
+    if (key === "") return "";
+    let src: string;
+    try {
+      src = adapter.imageUrl(key);
+    } catch {
+      // An adapter that cannot resolve the key: render the key as the text it is, the
+      // same fall-back `hotlink` makes for a value that is not a URL. There is no
+      // harmless empty-src alternative — an <img src=""> resolves to the PAGE url and
+      // re-requests it.
+      return key;
+    }
+    return (
+      <img
+        src={src}
+        alt={alt}
+        width={size}
+        height={size}
+        loading="lazy"
+        style={{ objectFit: "cover" }}
+      />
+    );
+  };
+}

package/src/entity-fetcher.tsx

@@ -1,25 +1,53 @@
-import { createContext, useContext, type ReactNode } from "react";
-import type { EntityFetcher } from "@metaobjectsdev/runtime-web";
+import { createContext, useContext, useMemo, type ReactNode } from "react";
+import { joinBaseUrl, type EntityFetcher } from "@metaobjectsdev/runtime-web";
 
 const EntityFetcherContext = createContext<EntityFetcher | null>(null);
 
 export interface EntityFetcherProviderProps {
-  value: EntityFetcher;
+  /**
+   * Transport only. It receives an already-prefixed URL and never learns about
+   * routing — that split is why `baseUrl` is a sibling option here rather than
+   * something each app hides inside its own fetch helper.
+   */
+  fetcher: EntityFetcher;
+  /**
+   * Where the API lives — a path (`/api`) or a full origin
+   * (`https://api.example.com/v1`).
+   *
+   * OPTIONAL, default `""`: same-origin at the root, which is what `meta init`
+   * scaffolds (`apiPrefix: ""`). Generated hooks emit entity-relative paths, so this
+   * is the single place the base is decided, and deciding it at RUNTIME rather than
+   * at `meta gen` time is what lets one client bundle serve a dev proxy, a preview
+   * environment and a separate API host without regenerating.
+   */
+  baseUrl?: string | undefined;
   children: ReactNode;
 }
 
 /** Wrap your app (or admin subtree) to supply a fetcher to generated hooks. */
-export function EntityFetcherProvider({ value, children }: EntityFetcherProviderProps) {
+export function EntityFetcherProvider({
+  fetcher,
+  baseUrl,
+  children,
+}: EntityFetcherProviderProps) {
+  // Memoized so the wrapped identity is stable across renders. An unmemoized wrapper is
+  // a new function every render, which churns everything downstream that captures it.
+  const value = useMemo<EntityFetcher>(
+    () =>
+      (<T,>(path: string, init?: RequestInit) =>
+        fetcher<T>(joinBaseUrl(baseUrl, path), init)) as EntityFetcher,
+    [fetcher, baseUrl],
+  );
   return <EntityFetcherContext.Provider value={value}>{children}</EntityFetcherContext.Provider>;
 }
 
-/** Reads the fetcher from context. Throws if not provided. */
+/** Reads the fetcher from context, already bound to `baseUrl`. Throws if not provided. */
 export function useEntityFetcher(): EntityFetcher {
   const fetcher = useContext(EntityFetcherContext);
   if (!fetcher) {
     throw new Error(
       "useEntityFetcher() called outside <EntityFetcherProvider>. " +
-        "Wrap your app (or the relevant subtree) with EntityFetcherProvider value={...}.",
+        "Wrap your app (or the relevant subtree) with EntityFetcherProvider fetcher={...}.",
     );
   }
   return fetcher;

package/src/index.ts

@@ -2,7 +2,12 @@
 export { EntityFetcherProvider, useEntityFetcher } from "./entity-fetcher.js";
 export type { EntityFetcherProviderProps } from "./entity-fetcher.js";
 export type { EntityFetcher, GridConfig } from "@metaobjectsdev/runtime-web";
-export { defaultCellRenderers, type CellRenderer } from "./cell-renderers.js";
+export {
+  defaultCellRenderers,
+  imageCell,
+  type CellRenderer,
+  type ImageCellOptions,
+} from "./cell-renderers.js";
 export {
   CellRendererProvider,
   useCellRenderers,