@marktiderman/genesis-studio 0.0.0 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mark Tiderman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1 +1,63 @@
-Placeholder. Install a version >= 0.1.0.
+# @marktiderman/genesis-studio
+
+**Genesis Data Studio**, the workspace UI: a sidebar of the tables the signed-in user may see, and a
+sheet of the selected one where a cell is edited in place. Every save is checked against the
+version of the row it was read at and committed with its audit entry, and the outcome is on screen:
+"Saved", with the audit entry, or "Not saved" and why.
+
+Built on genesis-ui's `ResourcePage` and `DataTable` (DATA-STUDIO.md decision 21). Routing and URL
+state come from your app through an adapter (decision 23), and sign-in fills a slot.
+
+**Status: 0.1, Experimental.** P0 scope: browse, search, sort, page, and single-cell edits.
+
+## Use it
+
+```tsx
+import { DataStudio, createSearchParamsRouter } from "@marktiderman/genesis-studio";
+import { createStudioProvider } from "@marktiderman/genesis-studio-server/client";
+import { useSearchParams } from "react-router";
+
+export default function AdminData() {
+  const { session } = useSupabaseSession(); // your app's own sign-in
+  const [params, setParams] = useSearchParams();
+  const router = createSearchParamsRouter(params, (next, { replace }) => setParams(next, { replace }));
+  const provider = useMemo(
+    () => createStudioProvider({ url: "/api/studio", getAccessToken: () => session?.access_token ?? null }),
+    [session],
+  );
+  return <DataStudio provider={provider} router={router} sessionKey={session?.user.id} signIn={<SignInForm />} />;
+}
+```
+
+The server half — the handler at `/api/studio` — is
+[`@marktiderman/genesis-studio-server`](../studio-server/README.md).
+
+Tailwind v4 needs to see the studio's classes:
+
+```css
+@import "tailwindcss";
+@import "@marktiderman/genesis-ui/styles.css";
+@import "@marktiderman/genesis-studio/styles.css";
+```
+
+## Props
+
+| Prop | |
+| --- | --- |
+| `provider` | Any Genesis `DataProvider` with `describe` and `listResources` — usually `createStudioProvider`. |
+| `router` | `{ location, navigate }`. `createSearchParamsRouter` adapts React Router or Next.js; `useHistoryRouter` works without a router; `useMemoryRouter` for tests. URL keys: `table`, `page`, `sort`, `q`. |
+| `signIn` | Rendered instead of the studio while the provider reports nobody signed in. |
+| `sessionKey` | The signed-in user's id. When it changes, everything loaded for the previous user is dropped. |
+| `title`, `perPage`, `className` | Presentation. |
+
+## What it shows
+
+- **Read-only tables** carry a lock in the sidebar and a banner with the server's reason (no version
+  trigger, editing not enabled, RLS off…).
+- **Columns** are exactly the fields `describe()` returned for this user; a column they can't read
+  never renders. Only fields with `permissions.update` are editable; enum and boolean fields edit
+  as a select.
+- **A conflict** keeps the editor open with the message, and the row then shows the other person's
+  value, so the next edit starts from it.
+- **This session's edits** lists every save and refusal, with the audit id, actor, time and the
+  before → after of each changed field.

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { DataProvider } from '@marktiderman/genesis-core/provider';
+import { AuditEntry } from '@marktiderman/genesis-core/schema';
+
+/** Everything the studio keeps in the URL. */
+interface StudioLocation {
+    /** `schema.table`, e.g. `public.clients`. */
+    resource?: string;
+    /** 1-based. */
+    page?: number;
+    /** `field:asc` or `field:desc`. */
+    sort?: string;
+    search?: string;
+}
+interface StudioNavigateOptions {
+    /** Replace the current history entry instead of pushing one (e.g. while typing a search). */
+    replace?: boolean;
+}
+interface StudioRouter {
+    location: StudioLocation;
+    navigate(next: StudioLocation, options?: StudioNavigateOptions): void;
+}
+declare function locationFromSearchParams(params: URLSearchParams): StudioLocation;
+/**
+ * The studio's location as query parameters, keeping every parameter in
+ * `base` that isn't the studio's own.
+ */
+declare function searchParamsFromLocation(location: StudioLocation, base?: URLSearchParams): URLSearchParams;
+/**
+ * An adapter over any router that exposes search params with a setter —
+ * React Router's `useSearchParams`, or Next.js's `useSearchParams` plus
+ * `router.replace`/`push`.
+ *
+ * @example React Router
+ * const [params, setParams] = useSearchParams();
+ * const router = createSearchParamsRouter(params, (next, { replace }) => setParams(next, { replace }));
+ */
+declare function createSearchParamsRouter(params: URLSearchParams, setParams: (next: URLSearchParams, options: {
+    replace: boolean;
+}) => void): StudioRouter;
+/**
+ * For an app with no router: keeps the studio's state in the current page's
+ * query string through the History API.
+ */
+declare function useHistoryRouter(): StudioRouter;
+/** A router held in memory, for tests and embedded previews. */
+declare function useMemoryRouter(initial?: StudioLocation): StudioRouter;
+
+/** One entry in the session's activity panel. */
+interface StudioActivity {
+    id: string;
+    at: Date;
+    resource: string;
+    field: string;
+    /** The record's key, as shown to the user. */
+    record: string;
+    outcome: "saved" | "not_saved";
+    message: string;
+    /** Present when the edit committed with an audit entry from the `table` sink. */
+    audit?: AuditEntry;
+}
+interface DataStudioProps {
+    /**
+     * Where the data comes from: the studio handler's client
+     * (`createStudioProvider` from `@marktiderman/genesis-studio-server/client`)
+     * or any Genesis `DataProvider` that implements `describe` and
+     * `listResources`.
+     */
+    provider: DataProvider;
+    /** URL state, from the app's router. See `createSearchParamsRouter` and `useHistoryRouter`. */
+    router: StudioRouter;
+    /** Shown in place of the studio while nobody is signed in. */
+    signIn?: ReactNode;
+    /**
+     * Changes when the signed-in user does (their id, say). The studio drops
+     * everything it loaded for the previous user and asks again.
+     */
+    sessionKey?: string | number | null;
+    /** Heading above the table list. Default "Data". */
+    title?: string;
+    /** Rows per page. Default 25. */
+    perPage?: number;
+    className?: string;
+}
+/**
+ * The Data Studio: a sidebar of the tables this user may see, and a sheet of
+ * the selected one where a cell is edited in place. Every edit carries the
+ * version it was read at, so a stale edit is refused rather than saved over
+ * someone else's, and the outcome — saved with its audit entry, or not saved
+ * and why — is shown on screen.
+ *
+ * It renders inside its own `GenesisProvider`, so it works whether or not
+ * the app already has one.
+ *
+ * @stability Experimental
+ */
+declare function DataStudio(props: DataStudioProps): react.JSX.Element;
+
+export { DataStudio, type DataStudioProps, type StudioActivity, type StudioLocation, type StudioNavigateOptions, type StudioRouter, createSearchParamsRouter, locationFromSearchParams, searchParamsFromLocation, useHistoryRouter, useMemoryRouter };

package/dist/index.js

@@ -0,0 +1,463 @@
+"use client";
+
+// src/DataStudio.tsx
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { keepPreviousData, useQuery, useQueryClient } from "@tanstack/react-query";
+import { Database, History, Lock, Table2 } from "lucide-react";
+import { GenesisProvider } from "@marktiderman/genesis-core/provider";
+import {
+  encodeRecordKey,
+  isDataWriteError,
+  keyFields
+} from "@marktiderman/genesis-core/schema";
+import { ResourcePage } from "@marktiderman/genesis-ui/data";
+import { Alert, AlertDescription, AlertTitle } from "@marktiderman/genesis-ui/alert";
+import { cn } from "@marktiderman/genesis-ui/utils";
+
+// src/values.ts
+function editText(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
+function displayText(value) {
+  if (value === null || value === void 0) return null;
+  return editText(value);
+}
+function parseDraft(field, draft) {
+  if (draft === "" && field.nullable) return null;
+  return draft;
+}
+function choicesFor(field) {
+  if (field.enumValues) return [...field.enumValues];
+  if (field.type === "boolean") return ["true", "false"];
+  return void 0;
+}
+
+// src/DataStudio.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var PER_PAGE = 25;
+var SEARCH_DEBOUNCE_MS = 300;
+function isUnauthenticated(error) {
+  return isDataWriteError(error) && error.outcome === "unauthenticated";
+}
+function errorText(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function DataStudio(props) {
+  return /* @__PURE__ */ jsx(GenesisProvider, { provider: props.provider, children: /* @__PURE__ */ jsx(StudioWorkspace, { ...props }) });
+}
+function StudioWorkspace({
+  provider,
+  router,
+  signIn,
+  sessionKey = null,
+  title = "Data",
+  perPage = PER_PAGE,
+  className
+}) {
+  const queryClient = useQueryClient();
+  const [activity, setActivity] = useState([]);
+  const [signedOut, setSignedOut] = useState(false);
+  useEffect(() => {
+    setSignedOut(false);
+    setActivity([]);
+    void queryClient.resetQueries({ queryKey: ["genesis-studio"] });
+  }, [sessionKey, queryClient]);
+  const resources = useQuery({
+    queryKey: ["genesis-studio", sessionKey, "resources"],
+    queryFn: () => {
+      if (!provider.listResources) throw new Error("This data provider can't list its resources.");
+      return provider.listResources();
+    },
+    retry: (count, error) => !isUnauthenticated(error) && count < 2
+  });
+  useEffect(() => {
+    if (isUnauthenticated(resources.error)) setSignedOut(true);
+  }, [resources.error]);
+  const record = useCallback((entry) => {
+    setActivity(
+      (prev) => [{ ...entry, id: `${Date.now()}-${Math.random().toString(36).slice(2)}`, at: /* @__PURE__ */ new Date() }, ...prev].slice(0, 50)
+    );
+  }, []);
+  if (signedOut) {
+    return /* @__PURE__ */ jsx("div", { className: cn("flex min-h-[320px] items-center justify-center p-6", className), "data-testid": "studio-sign-in", children: signIn ?? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Sign in to use the studio." }) });
+  }
+  const selected = router.location.resource;
+  const list = resources.data ?? [];
+  return /* @__PURE__ */ jsxs("div", { className: cn("flex min-h-[480px] w-full flex-col gap-4 lg:flex-row", className), "data-testid": "studio", children: [
+    /* @__PURE__ */ jsx(
+      TableSidebar,
+      {
+        title,
+        resources: list,
+        selected,
+        loading: resources.isLoading,
+        error: resources.isError ? errorText(resources.error) : null,
+        onSelect: (resource) => router.navigate({ resource })
+      }
+    ),
+    /* @__PURE__ */ jsxs("main", { className: "min-w-0 flex-1 space-y-4", "data-testid": "studio-main", children: [
+      selected ? /* @__PURE__ */ jsx(
+        Sheet,
+        {
+          provider,
+          resource: selected,
+          sessionKey,
+          router,
+          perPage,
+          onActivity: record,
+          onSignedOut: () => setSignedOut(true)
+        },
+        selected
+      ) : /* @__PURE__ */ jsxs(
+        "div",
+        {
+          className: "flex h-full min-h-[320px] flex-col items-center justify-center gap-2 rounded-lg border border-dashed p-8 text-center text-muted-foreground",
+          "data-testid": "studio-empty",
+          children: [
+            /* @__PURE__ */ jsx(Table2, { className: "h-6 w-6", "aria-hidden": true }),
+            /* @__PURE__ */ jsx("p", { className: "text-sm", children: list.length ? "Pick a table to open it." : "No tables to show yet." })
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsx(ActivityPanel, { entries: activity })
+    ] })
+  ] });
+}
+function TableSidebar({
+  title,
+  resources,
+  selected,
+  loading,
+  error,
+  onSelect
+}) {
+  return /* @__PURE__ */ jsxs("nav", { "aria-label": "Tables", className: "w-full shrink-0 self-start rounded-lg border bg-card lg:w-56", "data-testid": "studio-sidebar", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 border-b px-3 py-2 text-sm font-semibold", children: [
+      /* @__PURE__ */ jsx(Database, { className: "h-4 w-4 text-muted-foreground", "aria-hidden": true }),
+      title
+    ] }),
+    loading && /* @__PURE__ */ jsx("p", { className: "px-3 py-2 text-xs text-muted-foreground", children: "Loading tables\u2026" }),
+    error && /* @__PURE__ */ jsx("p", { role: "alert", className: "px-3 py-2 text-xs text-destructive", children: error }),
+    /* @__PURE__ */ jsx("ul", { className: "p-1", children: resources.map((r) => {
+      const active = r.name === selected;
+      return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
+        "button",
+        {
+          type: "button",
+          onClick: () => onSelect(r.name),
+          "aria-current": active ? "page" : void 0,
+          title: r.access.update ? r.name : `${r.name} \u2014 ${r.access.reason ?? "Read-only"}`,
+          "data-testid": `studio-table-${r.name}`,
+          className: cn(
+            "flex w-full items-center justify-between gap-2 rounded-md px-2 py-1.5 text-left text-sm",
+            active ? "bg-accent text-accent-foreground" : "hover:bg-muted"
+          ),
+          children: [
+            /* @__PURE__ */ jsx("span", { className: "truncate", children: r.label ?? r.name }),
+            !r.access.update && /* @__PURE__ */ jsx(Lock, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground", "aria-label": "Read-only" })
+          ]
+        }
+      ) }, r.name);
+    }) })
+  ] });
+}
+function parseSort(sort) {
+  if (!sort) return void 0;
+  const at = sort.lastIndexOf(":");
+  const field = at > 0 ? sort.slice(0, at) : sort;
+  const order = sort.slice(at + 1) === "desc" ? "desc" : "asc";
+  return field ? { field, order } : void 0;
+}
+function Sheet({
+  provider,
+  resource,
+  sessionKey,
+  router,
+  perPage,
+  onActivity,
+  onSignedOut
+}) {
+  const queryClient = useQueryClient();
+  const { location } = router;
+  const page = location.page ?? 1;
+  const sort = parseSort(location.sort);
+  const search = location.search ?? "";
+  const schemaQuery = useQuery({
+    queryKey: ["genesis-studio", sessionKey, "describe", resource],
+    queryFn: () => {
+      if (!provider.describe) throw new Error("This data provider can't describe its resources.");
+      return provider.describe(resource);
+    },
+    retry: false
+  });
+  const schema = schemaQuery.data;
+  const listKey = useMemo(
+    () => ["genesis-studio", sessionKey, "list", resource, page, perPage, location.sort ?? "", search],
+    [sessionKey, resource, page, perPage, location.sort, search]
+  );
+  const listQuery = useQuery({
+    queryKey: listKey,
+    enabled: Boolean(schema),
+    placeholderData: keepPreviousData,
+    retry: false,
+    queryFn: () => provider.getList(resource, {
+      pagination: { page, perPage },
+      sort,
+      search: search ? { query: search, fields: [] } : void 0
+    })
+  });
+  const failure = schemaQuery.error ?? listQuery.error;
+  useEffect(() => {
+    if (isUnauthenticated(failure)) onSignedOut();
+  }, [failure, onSignedOut]);
+  const searchTimer = useRef(void 0);
+  useEffect(() => () => clearTimeout(searchTimer.current), []);
+  const navigate = useCallback(
+    (patch, replace = false) => router.navigate({ ...location, resource, ...patch }, { replace }),
+    [router, location, resource]
+  );
+  const rows = listQuery.data?.data ?? [];
+  const keyed = Boolean(schema && keyFields(schema).length > 0);
+  const keys = useMemo(() => {
+    const map = /* @__PURE__ */ new Map();
+    rows.forEach((row, index) => map.set(row, schema && keyed ? String(encodeRecordKey(schema, row)) : `row-${index}`));
+    return map;
+  }, [rows, schema, keyed]);
+  const replaceRow = useCallback(
+    (oldRow, next) => {
+      queryClient.setQueryData(
+        listKey,
+        (prev) => prev ? { ...prev, data: prev.data.map((r) => r === oldRow ? next : r) } : prev
+      );
+    },
+    [queryClient, listKey]
+  );
+  const save = useCallback(
+    async (field, row, draft) => {
+      if (!schema) return;
+      if (draft === editText(row[field.name])) return;
+      const recordLabel = keys.get(row) ?? "";
+      const versionField = schema.version?.field;
+      const expectedVersion = versionField ? row[versionField] == null ? null : String(row[versionField]) : null;
+      try {
+        const result = await provider.update(resource, {
+          id: encodeRecordKey(schema, row),
+          data: { [field.name]: parseDraft(field, draft) },
+          expectedVersion
+        });
+        replaceRow(row, result.data);
+        onActivity({
+          resource,
+          field: field.name,
+          record: recordLabel,
+          outcome: "saved",
+          message: result.audit ? "Saved, with its audit entry." : "Saved.",
+          ...result.audit ? { audit: result.audit } : {}
+        });
+      } catch (error) {
+        if (isUnauthenticated(error)) onSignedOut();
+        if (isDataWriteError(error) && error.outcome === "conflict" && error.current) {
+          replaceRow(row, {
+            ...row,
+            ...error.current,
+            ...versionField ? { [versionField]: error.currentVersion ?? null } : {}
+          });
+        }
+        if (isDataWriteError(error) && error.outcome === "gone") {
+          void queryClient.invalidateQueries({ queryKey: listKey });
+        }
+        onActivity({ resource, field: field.name, record: recordLabel, outcome: "not_saved", message: errorText(error) });
+        throw error instanceof Error ? error : new Error(String(error));
+      }
+    },
+    [schema, keys, provider, resource, replaceRow, onActivity, onSignedOut, queryClient, listKey]
+  );
+  const columns = useMemo(() => {
+    if (!schema) return [];
+    return schema.fields.map((field) => {
+      const options = choicesFor(field);
+      return {
+        key: field.name,
+        header: field.name,
+        sortable: true,
+        accessor: (row) => editText(row[field.name]),
+        render: (row) => {
+          const text = displayText(row[field.name]);
+          return text === null ? /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "\u2014" }) : /* @__PURE__ */ jsx("span", { className: "block max-w-[320px] truncate", title: text, children: text });
+        },
+        ...field.permissions?.update ? {
+          editable: {
+            type: options ? "select" : "text",
+            ...options ? { options } : {},
+            onSave: (row, draft) => save(field, row, draft)
+          }
+        } : {}
+      };
+    });
+  }, [schema, save]);
+  if (schemaQuery.isError && !isUnauthenticated(schemaQuery.error)) {
+    return /* @__PURE__ */ jsxs(Alert, { variant: "destructive", "data-testid": "studio-describe-error", children: [
+      /* @__PURE__ */ jsxs(AlertTitle, { children: [
+        "Couldn't open ",
+        resource
+      ] }),
+      /* @__PURE__ */ jsx(AlertDescription, { children: errorText(schemaQuery.error) })
+    ] });
+  }
+  const editable = schema?.fields.filter((f) => f.permissions?.update).length ?? 0;
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-3", "data-testid": "studio-sheet", children: [
+    schema && !schema.access.update && /* @__PURE__ */ jsxs(Alert, { "data-testid": "studio-read-only", children: [
+      /* @__PURE__ */ jsx(Lock, { className: "h-4 w-4", "aria-hidden": true }),
+      /* @__PURE__ */ jsx(AlertTitle, { children: "Read-only" }),
+      /* @__PURE__ */ jsx(AlertDescription, { children: schema.access.reason ?? "You can view this table but not edit it." })
+    ] }),
+    /* @__PURE__ */ jsx(
+      ResourcePage,
+      {
+        title: schema?.label ?? resource,
+        subtitle: schemaSubtitle(schema, editable),
+        data: rows,
+        total: listQuery.data?.total ?? 0,
+        columns,
+        getKey: (row) => keys.get(row) ?? "",
+        detail: "none",
+        page,
+        perPage,
+        onPageChange: (next) => navigate({ page: next }),
+        onSortChange: (next) => navigate({ sort: next ? `${next.field}:${next.order}` : void 0, page: 1 }),
+        onSearchChange: (text) => {
+          clearTimeout(searchTimer.current);
+          searchTimer.current = setTimeout(() => navigate({ search: text || void 0, page: 1 }, true), SEARCH_DEBOUNCE_MS);
+        },
+        initialFilters: [
+          ...search ? [{ field: "__search__", operator: "contains", value: search }] : [],
+          ...location.sort ? [{ field: "__sort__", operator: "eq", value: location.sort }] : []
+        ],
+        loading: schemaQuery.isLoading || listQuery.isLoading,
+        error: listQuery.isError && !isUnauthenticated(listQuery.error),
+        errorMessage: listQuery.error ? errorText(listQuery.error) : void 0,
+        onRetry: () => void listQuery.refetch(),
+        columnVisibilityKey: `genesis-studio:${resource}`,
+        resizeKey: `genesis-studio:${resource}`,
+        viewSettingsKey: `genesis-studio:${resource}`,
+        stickyFirstColumn: true
+      }
+    )
+  ] });
+}
+function schemaSubtitle(schema, editable) {
+  if (!schema) return void 0;
+  const parts = [schema.name];
+  if (schema.access.update) parts.push(`${editable} of ${schema.fields.length} fields editable`);
+  if (schema.version) parts.push(`edits checked against ${schema.version.field}`);
+  return parts.join(" \xB7 ");
+}
+function ActivityPanel({ entries }) {
+  return /* @__PURE__ */ jsxs("section", { "aria-label": "This session's edits", className: "rounded-lg border bg-card", "data-testid": "studio-activity", children: [
+    /* @__PURE__ */ jsxs("h2", { className: "flex items-center gap-2 border-b px-3 py-2 text-sm font-semibold", children: [
+      /* @__PURE__ */ jsx(History, { className: "h-4 w-4 text-muted-foreground", "aria-hidden": true }),
+      "This session's edits"
+    ] }),
+    entries.length === 0 ? /* @__PURE__ */ jsx("p", { className: "px-3 py-3 text-xs text-muted-foreground", children: "Click a cell to edit it. Each save is checked against the latest version of the row, and audited." }) : /* @__PURE__ */ jsx("ol", { className: "divide-y", "aria-live": "polite", children: entries.map((entry) => /* @__PURE__ */ jsxs("li", { className: "px-3 py-2 text-xs", "data-testid": `studio-activity-${entry.outcome}`, children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2", children: [
+        /* @__PURE__ */ jsx("span", { className: entry.outcome === "saved" ? "font-medium text-foreground" : "font-medium text-destructive", children: entry.outcome === "saved" ? "Saved" : "Not saved" }),
+        /* @__PURE__ */ jsxs("span", { className: "text-muted-foreground", children: [
+          entry.resource,
+          " \xB7 ",
+          entry.field,
+          " \xB7 ",
+          entry.record
+        ] }),
+        /* @__PURE__ */ jsx("time", { className: "ml-auto text-muted-foreground", dateTime: entry.at.toISOString(), children: entry.at.toLocaleTimeString() })
+      ] }),
+      /* @__PURE__ */ jsx("p", { className: "mt-0.5 text-muted-foreground", children: entry.message }),
+      entry.audit && /* @__PURE__ */ jsx(AuditLine, { audit: entry.audit })
+    ] }, entry.id)) })
+  ] });
+}
+function AuditLine({ audit }) {
+  const changes = Object.keys(audit.after ?? {}).map((field) => ({
+    field,
+    before: displayText(audit.before?.[field]) ?? "\u2014",
+    after: displayText(audit.after?.[field]) ?? "\u2014"
+  }));
+  return /* @__PURE__ */ jsxs("div", { className: "mt-1 rounded bg-muted/50 px-2 py-1 font-mono text-[11px]", "data-testid": "studio-audit-entry", children: [
+    /* @__PURE__ */ jsxs("div", { className: "text-muted-foreground", children: [
+      "audit ",
+      audit.id.slice(0, 8),
+      " \xB7 ",
+      audit.occurredAt,
+      " \xB7 by ",
+      audit.actor ?? "unknown"
+    ] }),
+    changes.map((c) => /* @__PURE__ */ jsxs("div", { children: [
+      c.field,
+      ": ",
+      c.before,
+      " \u2192 ",
+      c.after
+    ] }, c.field))
+  ] });
+}
+
+// src/router.ts
+import { useCallback as useCallback2, useEffect as useEffect2, useMemo as useMemo2, useState as useState2 } from "react";
+var PARAM = { resource: "table", page: "page", sort: "sort", search: "q" };
+function locationFromSearchParams(params) {
+  const page = Number(params.get(PARAM.page));
+  return {
+    ...params.get(PARAM.resource) ? { resource: params.get(PARAM.resource) } : {},
+    ...Number.isInteger(page) && page > 1 ? { page } : {},
+    ...params.get(PARAM.sort) ? { sort: params.get(PARAM.sort) } : {},
+    ...params.get(PARAM.search) ? { search: params.get(PARAM.search) } : {}
+  };
+}
+function searchParamsFromLocation(location, base) {
+  const params = new URLSearchParams(base);
+  for (const name of Object.values(PARAM)) params.delete(name);
+  if (location.resource) params.set(PARAM.resource, location.resource);
+  if (location.page && location.page > 1) params.set(PARAM.page, String(location.page));
+  if (location.sort) params.set(PARAM.sort, location.sort);
+  if (location.search) params.set(PARAM.search, location.search);
+  return params;
+}
+function createSearchParamsRouter(params, setParams) {
+  return {
+    location: locationFromSearchParams(params),
+    navigate: (next, options) => setParams(searchParamsFromLocation(next, params), { replace: options?.replace ?? false })
+  };
+}
+function useHistoryRouter() {
+  const read = () => typeof window === "undefined" ? {} : locationFromSearchParams(new URLSearchParams(window.location.search));
+  const [location, setLocation] = useState2(read);
+  useEffect2(() => {
+    const onPop = () => setLocation(read());
+    window.addEventListener("popstate", onPop);
+    return () => window.removeEventListener("popstate", onPop);
+  }, []);
+  const navigate = useCallback2((next, options) => {
+    const params = searchParamsFromLocation(next, new URLSearchParams(window.location.search));
+    const query = params.toString();
+    const url = `${window.location.pathname}${query ? `?${query}` : ""}${window.location.hash}`;
+    if (options?.replace) window.history.replaceState(window.history.state, "", url);
+    else window.history.pushState(window.history.state, "", url);
+    setLocation(next);
+  }, []);
+  return useMemo2(() => ({ location, navigate }), [location, navigate]);
+}
+function useMemoryRouter(initial = {}) {
+  const [location, setLocation] = useState2(initial);
+  const navigate = useCallback2((next) => setLocation(next), []);
+  return useMemo2(() => ({ location, navigate }), [location, navigate]);
+}
+export {
+  DataStudio,
+  createSearchParamsRouter,
+  locationFromSearchParams,
+  searchParamsFromLocation,
+  useHistoryRouter,
+  useMemoryRouter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/DataStudio.tsx","../src/values.ts","../src/router.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from \"react\";\nimport { keepPreviousData, useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport { Database, History, Lock, Table2 } from \"lucide-react\";\nimport { GenesisProvider, type BaseRecord, type DataProvider } from \"@marktiderman/genesis-core/provider\";\nimport {\n  encodeRecordKey,\n  isDataWriteError,\n  keyFields,\n  type AuditEntry,\n  type FieldSchema,\n  type ResourceSchema,\n  type ResourceSummary,\n} from \"@marktiderman/genesis-core/schema\";\nimport { ResourcePage, type ResourceColumnDef } from \"@marktiderman/genesis-ui/data\";\nimport { Alert, AlertDescription, AlertTitle } from \"@marktiderman/genesis-ui/alert\";\nimport { cn } from \"@marktiderman/genesis-ui/utils\";\nimport type { StudioLocation, StudioRouter } from \"./router\";\nimport { choicesFor, displayText, editText, parseDraft } from \"./values\";\n\ntype Row = Record<string, unknown>;\n\n/** One entry in the session's activity panel. */\nexport interface StudioActivity {\n  id: string;\n  at: Date;\n  resource: string;\n  field: string;\n  /** The record's key, as shown to the user. */\n  record: string;\n  outcome: \"saved\" | \"not_saved\";\n  message: string;\n  /** Present when the edit committed with an audit entry from the `table` sink. */\n  audit?: AuditEntry;\n}\n\nexport interface DataStudioProps {\n  /**\n   * Where the data comes from: the studio handler's client\n   * (`createStudioProvider` from `@marktiderman/genesis-studio-server/client`)\n   * or any Genesis `DataProvider` that implements `describe` and\n   * `listResources`.\n   */\n  provider: DataProvider;\n  /** URL state, from the app's router. See `createSearchParamsRouter` and `useHistoryRouter`. */\n  router: StudioRouter;\n  /** Shown in place of the studio while nobody is signed in. */\n  signIn?: ReactNode;\n  /**\n   * Changes when the signed-in user does (their id, say). The studio drops\n   * everything it loaded for the previous user and asks again.\n   */\n  sessionKey?: string | number | null;\n  /** Heading above the table list. Default \"Data\". */\n  title?: string;\n  /** Rows per page. Default 25. */\n  perPage?: number;\n  className?: string;\n}\n\nconst PER_PAGE = 25;\nconst SEARCH_DEBOUNCE_MS = 300;\n\nfunction isUnauthenticated(error: unknown): boolean {\n  return isDataWriteError(error) && error.outcome === \"unauthenticated\";\n}\n\nfunction errorText(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * The Data Studio: a sidebar of the tables this user may see, and a sheet of\n * the selected one where a cell is edited in place. Every edit carries the\n * version it was read at, so a stale edit is refused rather than saved over\n * someone else's, and the outcome — saved with its audit entry, or not saved\n * and why — is shown on screen.\n *\n * It renders inside its own `GenesisProvider`, so it works whether or not\n * the app already has one.\n *\n * @stability Experimental\n */\nexport function DataStudio(props: DataStudioProps) {\n  return (\n    <GenesisProvider provider={props.provider}>\n      <StudioWorkspace {...props} />\n    </GenesisProvider>\n  );\n}\n\nfunction StudioWorkspace({\n  provider,\n  router,\n  signIn,\n  sessionKey = null,\n  title = \"Data\",\n  perPage = PER_PAGE,\n  className,\n}: DataStudioProps) {\n  const queryClient = useQueryClient();\n  const [activity, setActivity] = useState<StudioActivity[]>([]);\n  const [signedOut, setSignedOut] = useState(false);\n\n  // A new user sees nothing the previous one loaded.\n  useEffect(() => {\n    setSignedOut(false);\n    setActivity([]);\n    void queryClient.resetQueries({ queryKey: [\"genesis-studio\"] });\n  }, [sessionKey, queryClient]);\n\n  const resources = useQuery({\n    queryKey: [\"genesis-studio\", sessionKey, \"resources\"],\n    queryFn: () => {\n      if (!provider.listResources) throw new Error(\"This data provider can't list its resources.\");\n      return provider.listResources();\n    },\n    retry: (count, error) => !isUnauthenticated(error) && count < 2,\n  });\n\n  useEffect(() => {\n    if (isUnauthenticated(resources.error)) setSignedOut(true);\n  }, [resources.error]);\n\n  const record = useCallback((entry: Omit<StudioActivity, \"id\" | \"at\">) => {\n    setActivity((prev) =>\n      [{ ...entry, id: `${Date.now()}-${Math.random().toString(36).slice(2)}`, at: new Date() }, ...prev].slice(0, 50),\n    );\n  }, []);\n\n  if (signedOut) {\n    return (\n      <div className={cn(\"flex min-h-[320px] items-center justify-center p-6\", className)} data-testid=\"studio-sign-in\">\n        {signIn ?? <p className=\"text-sm text-muted-foreground\">Sign in to use the studio.</p>}\n      </div>\n    );\n  }\n\n  const selected = router.location.resource;\n  const list = resources.data ?? [];\n\n  return (\n    <div className={cn(\"flex min-h-[480px] w-full flex-col gap-4 lg:flex-row\", className)} data-testid=\"studio\">\n      <TableSidebar\n        title={title}\n        resources={list}\n        selected={selected}\n        loading={resources.isLoading}\n        error={resources.isError ? errorText(resources.error) : null}\n        onSelect={(resource) => router.navigate({ resource })}\n      />\n      <main className=\"min-w-0 flex-1 space-y-4\" data-testid=\"studio-main\">\n        {selected ? (\n          <Sheet\n            key={selected}\n            provider={provider}\n            resource={selected}\n            sessionKey={sessionKey}\n            router={router}\n            perPage={perPage}\n            onActivity={record}\n            onSignedOut={() => setSignedOut(true)}\n          />\n        ) : (\n          <div\n            className=\"flex h-full min-h-[320px] flex-col items-center justify-center gap-2 rounded-lg border border-dashed p-8 text-center text-muted-foreground\"\n            data-testid=\"studio-empty\"\n          >\n            <Table2 className=\"h-6 w-6\" aria-hidden />\n            <p className=\"text-sm\">{list.length ? \"Pick a table to open it.\" : \"No tables to show yet.\"}</p>\n          </div>\n        )}\n        <ActivityPanel entries={activity} />\n      </main>\n    </div>\n  );\n}\n\nfunction TableSidebar({\n  title,\n  resources,\n  selected,\n  loading,\n  error,\n  onSelect,\n}: {\n  title: string;\n  resources: ResourceSummary[];\n  selected?: string;\n  loading: boolean;\n  error: string | null;\n  onSelect: (resource: string) => void;\n}) {\n  return (\n    <nav aria-label=\"Tables\" className=\"w-full shrink-0 self-start rounded-lg border bg-card lg:w-56\" data-testid=\"studio-sidebar\">\n      <div className=\"flex items-center gap-2 border-b px-3 py-2 text-sm font-semibold\">\n        <Database className=\"h-4 w-4 text-muted-foreground\" aria-hidden />\n        {title}\n      </div>\n      {loading && <p className=\"px-3 py-2 text-xs text-muted-foreground\">Loading tables…</p>}\n      {error && (\n        <p role=\"alert\" className=\"px-3 py-2 text-xs text-destructive\">\n          {error}\n        </p>\n      )}\n      <ul className=\"p-1\">\n        {resources.map((r) => {\n          const active = r.name === selected;\n          return (\n            <li key={r.name}>\n              <button\n                type=\"button\"\n                onClick={() => onSelect(r.name)}\n                aria-current={active ? \"page\" : undefined}\n                title={r.access.update ? r.name : `${r.name} — ${r.access.reason ?? \"Read-only\"}`}\n                data-testid={`studio-table-${r.name}`}\n                className={cn(\n                  \"flex w-full items-center justify-between gap-2 rounded-md px-2 py-1.5 text-left text-sm\",\n                  active ? \"bg-accent text-accent-foreground\" : \"hover:bg-muted\",\n                )}\n              >\n                <span className=\"truncate\">{r.label ?? r.name}</span>\n                {!r.access.update && (\n                  <Lock className=\"h-3.5 w-3.5 shrink-0 text-muted-foreground\" aria-label=\"Read-only\" />\n                )}\n              </button>\n            </li>\n          );\n        })}\n      </ul>\n    </nav>\n  );\n}\n\nfunction parseSort(sort: string | undefined): { field: string; order: \"asc\" | \"desc\" } | undefined {\n  if (!sort) return undefined;\n  const at = sort.lastIndexOf(\":\");\n  const field = at > 0 ? sort.slice(0, at) : sort;\n  const order = sort.slice(at + 1) === \"desc\" ? \"desc\" : \"asc\";\n  return field ? { field, order } : undefined;\n}\n\nfunction Sheet({\n  provider,\n  resource,\n  sessionKey,\n  router,\n  perPage,\n  onActivity,\n  onSignedOut,\n}: {\n  provider: DataProvider;\n  resource: string;\n  sessionKey: string | number | null;\n  router: StudioRouter;\n  perPage: number;\n  onActivity: (entry: Omit<StudioActivity, \"id\" | \"at\">) => void;\n  onSignedOut: () => void;\n}) {\n  const queryClient = useQueryClient();\n  const { location } = router;\n  const page = location.page ?? 1;\n  const sort = parseSort(location.sort);\n  const search = location.search ?? \"\";\n\n  const schemaQuery = useQuery({\n    queryKey: [\"genesis-studio\", sessionKey, \"describe\", resource],\n    queryFn: () => {\n      if (!provider.describe) throw new Error(\"This data provider can't describe its resources.\");\n      return provider.describe(resource);\n    },\n    retry: false,\n  });\n  const schema = schemaQuery.data;\n\n  const listKey = useMemo(\n    () => [\"genesis-studio\", sessionKey, \"list\", resource, page, perPage, location.sort ?? \"\", search],\n    [sessionKey, resource, page, perPage, location.sort, search],\n  );\n  const listQuery = useQuery({\n    queryKey: listKey,\n    enabled: Boolean(schema),\n    placeholderData: keepPreviousData,\n    retry: false,\n    queryFn: () =>\n      provider.getList<BaseRecord>(resource, {\n        pagination: { page, perPage },\n        sort,\n        search: search ? { query: search, fields: [] } : undefined,\n      }),\n  });\n\n  const failure = schemaQuery.error ?? listQuery.error;\n  useEffect(() => {\n    if (isUnauthenticated(failure)) onSignedOut();\n  }, [failure, onSignedOut]);\n\n  // Debounce search into the URL; typing replaces rather than pushes history.\n  const searchTimer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n  useEffect(() => () => clearTimeout(searchTimer.current), []);\n  const navigate = useCallback(\n    (patch: Partial<StudioLocation>, replace = false) => router.navigate({ ...location, resource, ...patch }, { replace }),\n    [router, location, resource],\n  );\n\n  const rows = (listQuery.data?.data ?? []) as Row[];\n  const keyed = Boolean(schema && keyFields(schema).length > 0);\n  const keys = useMemo(() => {\n    const map = new Map<Row, string>();\n    rows.forEach((row, index) => map.set(row, schema && keyed ? String(encodeRecordKey(schema, row)) : `row-${index}`));\n    return map;\n  }, [rows, schema, keyed]);\n\n  const replaceRow = useCallback(\n    (oldRow: Row, next: Row) => {\n      queryClient.setQueryData(listKey, (prev: { data: Row[]; total: number } | undefined) =>\n        prev ? { ...prev, data: prev.data.map((r) => (r === oldRow ? next : r)) } : prev,\n      );\n    },\n    [queryClient, listKey],\n  );\n\n  const save = useCallback(\n    async (field: FieldSchema, row: Row, draft: string) => {\n      if (!schema) return;\n      if (draft === editText(row[field.name])) return; // nothing changed\n      const recordLabel = keys.get(row) ?? \"\";\n      const versionField = schema.version?.field;\n      const expectedVersion = versionField ? (row[versionField] == null ? null : String(row[versionField])) : null;\n      try {\n        const result = await provider.update<BaseRecord>(resource, {\n          id: encodeRecordKey(schema, row),\n          data: { [field.name]: parseDraft(field, draft) },\n          expectedVersion,\n        });\n        replaceRow(row, result.data as Row);\n        onActivity({\n          resource,\n          field: field.name,\n          record: recordLabel,\n          outcome: \"saved\",\n          message: result.audit ? \"Saved, with its audit entry.\" : \"Saved.\",\n          ...(result.audit ? { audit: result.audit } : {}),\n        });\n      } catch (error) {\n        if (isUnauthenticated(error)) onSignedOut();\n        if (isDataWriteError(error) && error.outcome === \"conflict\" && error.current) {\n          // Show the row as it is now, so the next edit starts from their change.\n          replaceRow(row, {\n            ...row,\n            ...error.current,\n            ...(versionField ? { [versionField]: error.currentVersion ?? null } : {}),\n          });\n        }\n        if (isDataWriteError(error) && error.outcome === \"gone\") {\n          void queryClient.invalidateQueries({ queryKey: listKey });\n        }\n        onActivity({ resource, field: field.name, record: recordLabel, outcome: \"not_saved\", message: errorText(error) });\n        throw error instanceof Error ? error : new Error(String(error));\n      }\n    },\n    [schema, keys, provider, resource, replaceRow, onActivity, onSignedOut, queryClient, listKey],\n  );\n\n  const columns = useMemo<ResourceColumnDef<Row>[]>(() => {\n    if (!schema) return [];\n    return schema.fields.map((field) => {\n      const options = choicesFor(field);\n      return {\n        key: field.name,\n        header: field.name,\n        sortable: true,\n        accessor: (row: Row) => editText(row[field.name]),\n        render: (row: Row) => {\n          const text = displayText(row[field.name]);\n          return text === null ? (\n            <span className=\"text-muted-foreground\">—</span>\n          ) : (\n            <span className=\"block max-w-[320px] truncate\" title={text}>\n              {text}\n            </span>\n          );\n        },\n        ...(field.permissions?.update\n          ? {\n              editable: {\n                type: options ? (\"select\" as const) : (\"text\" as const),\n                ...(options ? { options } : {}),\n                onSave: (row: Row, draft: string) => save(field, row, draft),\n              },\n            }\n          : {}),\n      };\n    });\n  }, [schema, save]);\n\n  if (schemaQuery.isError && !isUnauthenticated(schemaQuery.error)) {\n    return (\n      <Alert variant=\"destructive\" data-testid=\"studio-describe-error\">\n        <AlertTitle>Couldn't open {resource}</AlertTitle>\n        <AlertDescription>{errorText(schemaQuery.error)}</AlertDescription>\n      </Alert>\n    );\n  }\n\n  const editable = schema?.fields.filter((f) => f.permissions?.update).length ?? 0;\n\n  return (\n    <div className=\"space-y-3\" data-testid=\"studio-sheet\">\n      {schema && !schema.access.update && (\n        <Alert data-testid=\"studio-read-only\">\n          <Lock className=\"h-4 w-4\" aria-hidden />\n          <AlertTitle>Read-only</AlertTitle>\n          <AlertDescription>{schema.access.reason ?? \"You can view this table but not edit it.\"}</AlertDescription>\n        </Alert>\n      )}\n      <ResourcePage<Row>\n        title={schema?.label ?? resource}\n        subtitle={schemaSubtitle(schema, editable)}\n        data={rows}\n        total={listQuery.data?.total ?? 0}\n        columns={columns}\n        getKey={(row) => keys.get(row) ?? \"\"}\n        detail=\"none\"\n        page={page}\n        perPage={perPage}\n        onPageChange={(next) => navigate({ page: next })}\n        onSortChange={(next) => navigate({ sort: next ? `${next.field}:${next.order}` : undefined, page: 1 })}\n        onSearchChange={(text) => {\n          clearTimeout(searchTimer.current);\n          searchTimer.current = setTimeout(() => navigate({ search: text || undefined, page: 1 }, true), SEARCH_DEBOUNCE_MS);\n        }}\n        // Seed the search box and sort control from the URL, so a deep link\n        // or a reload shows why the rows are filtered. Sheet remounts per\n        // table, so mount-time seeding is enough.\n        initialFilters={[\n          ...(search ? [{ field: \"__search__\", operator: \"contains\" as const, value: search }] : []),\n          ...(location.sort ? [{ field: \"__sort__\", operator: \"eq\" as const, value: location.sort }] : []),\n        ]}\n        loading={schemaQuery.isLoading || listQuery.isLoading}\n        error={listQuery.isError && !isUnauthenticated(listQuery.error)}\n        errorMessage={listQuery.error ? errorText(listQuery.error) : undefined}\n        onRetry={() => void listQuery.refetch()}\n        columnVisibilityKey={`genesis-studio:${resource}`}\n        resizeKey={`genesis-studio:${resource}`}\n        viewSettingsKey={`genesis-studio:${resource}`}\n        stickyFirstColumn\n      />\n    </div>\n  );\n}\n\nfunction schemaSubtitle(schema: ResourceSchema | undefined, editable: number): string | undefined {\n  if (!schema) return undefined;\n  const parts = [schema.name];\n  if (schema.access.update) parts.push(`${editable} of ${schema.fields.length} fields editable`);\n  if (schema.version) parts.push(`edits checked against ${schema.version.field}`);\n  return parts.join(\" · \");\n}\n\nfunction ActivityPanel({ entries }: { entries: StudioActivity[] }) {\n  return (\n    <section aria-label=\"This session's edits\" className=\"rounded-lg border bg-card\" data-testid=\"studio-activity\">\n      <h2 className=\"flex items-center gap-2 border-b px-3 py-2 text-sm font-semibold\">\n        <History className=\"h-4 w-4 text-muted-foreground\" aria-hidden />\n        This session's edits\n      </h2>\n      {entries.length === 0 ? (\n        <p className=\"px-3 py-3 text-xs text-muted-foreground\">\n          Click a cell to edit it. Each save is checked against the latest version of the row, and audited.\n        </p>\n      ) : (\n        <ol className=\"divide-y\" aria-live=\"polite\">\n          {entries.map((entry) => (\n            <li key={entry.id} className=\"px-3 py-2 text-xs\" data-testid={`studio-activity-${entry.outcome}`}>\n              <div className=\"flex flex-wrap items-baseline gap-x-2\">\n                <span className={entry.outcome === \"saved\" ? \"font-medium text-foreground\" : \"font-medium text-destructive\"}>\n                  {entry.outcome === \"saved\" ? \"Saved\" : \"Not saved\"}\n                </span>\n                <span className=\"text-muted-foreground\">\n                  {entry.resource} · {entry.field} · {entry.record}\n                </span>\n                <time className=\"ml-auto text-muted-foreground\" dateTime={entry.at.toISOString()}>\n                  {entry.at.toLocaleTimeString()}\n                </time>\n              </div>\n              <p className=\"mt-0.5 text-muted-foreground\">{entry.message}</p>\n              {entry.audit && <AuditLine audit={entry.audit} />}\n            </li>\n          ))}\n        </ol>\n      )}\n    </section>\n  );\n}\n\nfunction AuditLine({ audit }: { audit: AuditEntry }) {\n  const changes = Object.keys(audit.after ?? {}).map((field) => ({\n    field,\n    before: displayText(audit.before?.[field]) ?? \"—\",\n    after: displayText(audit.after?.[field]) ?? \"—\",\n  }));\n  return (\n    <div className=\"mt-1 rounded bg-muted/50 px-2 py-1 font-mono text-[11px]\" data-testid=\"studio-audit-entry\">\n      <div className=\"text-muted-foreground\">\n        audit {audit.id.slice(0, 8)} · {audit.occurredAt} · by {audit.actor ?? \"unknown\"}\n      </div>\n      {changes.map((c) => (\n        <div key={c.field}>\n          {c.field}: {c.before} → {c.after}\n        </div>\n      ))}\n    </div>\n  );\n}\n","// How a stored value is shown, edited, and sent back. Postgres parses what\n// comes back (the handler casts every value to the column's type), so the\n// studio only decides what text the user sees and what \"empty\" means.\n\nimport type { FieldSchema } from \"@marktiderman/genesis-core/schema\";\n\n/** The text a cell starts editing from. JSON is edited as JSON text. */\nexport function editText(value: unknown): string {\n  if (value === null || value === undefined) return \"\";\n  if (typeof value === \"object\") return JSON.stringify(value);\n  return String(value);\n}\n\n/** The text a cell shows, or `null` for an empty cell. */\nexport function displayText(value: unknown): string | null {\n  if (value === null || value === undefined) return null;\n  return editText(value);\n}\n\n/**\n * The value to save for what the user typed. An emptied cell becomes `null`\n * when the field accepts null, and the empty string otherwise.\n */\nexport function parseDraft(field: FieldSchema, draft: string): unknown {\n  if (draft === \"\" && field.nullable) return null;\n  return draft;\n}\n\n/** The choices for a select-style cell, or `undefined` for free text. */\nexport function choicesFor(field: FieldSchema): string[] | undefined {\n  if (field.enumValues) return [...field.enumValues];\n  if (field.type === \"boolean\") return [\"true\", \"false\"];\n  return undefined;\n}\n","// ---------------------------------------------------------------------------\n// Routing and URL state come from the host app (DATA-STUDIO.md decision 23).\n//\n// The studio never touches `window.location` itself. It reads a\n// `StudioLocation` and asks for a new one; the adapter decides how that maps\n// onto the app's router, so a link to \"clients, page 3, sorted by name\" is a\n// plain URL the app already knows how to serve.\n// ---------------------------------------------------------------------------\n\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\n\n/** Everything the studio keeps in the URL. */\nexport interface StudioLocation {\n  /** `schema.table`, e.g. `public.clients`. */\n  resource?: string;\n  /** 1-based. */\n  page?: number;\n  /** `field:asc` or `field:desc`. */\n  sort?: string;\n  search?: string;\n}\n\nexport interface StudioNavigateOptions {\n  /** Replace the current history entry instead of pushing one (e.g. while typing a search). */\n  replace?: boolean;\n}\n\nexport interface StudioRouter {\n  location: StudioLocation;\n  navigate(next: StudioLocation, options?: StudioNavigateOptions): void;\n}\n\n/** Query parameter names. Short, and namespaced enough not to collide with an app's own. */\nconst PARAM = { resource: \"table\", page: \"page\", sort: \"sort\", search: \"q\" } as const;\n\nexport function locationFromSearchParams(params: URLSearchParams): StudioLocation {\n  const page = Number(params.get(PARAM.page));\n  return {\n    ...(params.get(PARAM.resource) ? { resource: params.get(PARAM.resource)! } : {}),\n    ...(Number.isInteger(page) && page > 1 ? { page } : {}),\n    ...(params.get(PARAM.sort) ? { sort: params.get(PARAM.sort)! } : {}),\n    ...(params.get(PARAM.search) ? { search: params.get(PARAM.search)! } : {}),\n  };\n}\n\n/**\n * The studio's location as query parameters, keeping every parameter in\n * `base` that isn't the studio's own.\n */\nexport function searchParamsFromLocation(location: StudioLocation, base?: URLSearchParams): URLSearchParams {\n  const params = new URLSearchParams(base);\n  for (const name of Object.values(PARAM)) params.delete(name);\n  if (location.resource) params.set(PARAM.resource, location.resource);\n  if (location.page && location.page > 1) params.set(PARAM.page, String(location.page));\n  if (location.sort) params.set(PARAM.sort, location.sort);\n  if (location.search) params.set(PARAM.search, location.search);\n  return params;\n}\n\n/**\n * An adapter over any router that exposes search params with a setter —\n * React Router's `useSearchParams`, or Next.js's `useSearchParams` plus\n * `router.replace`/`push`.\n *\n * @example React Router\n * const [params, setParams] = useSearchParams();\n * const router = createSearchParamsRouter(params, (next, { replace }) => setParams(next, { replace }));\n */\nexport function createSearchParamsRouter(\n  params: URLSearchParams,\n  setParams: (next: URLSearchParams, options: { replace: boolean }) => void,\n): StudioRouter {\n  return {\n    location: locationFromSearchParams(params),\n    navigate: (next, options) => setParams(searchParamsFromLocation(next, params), { replace: options?.replace ?? false }),\n  };\n}\n\n/**\n * For an app with no router: keeps the studio's state in the current page's\n * query string through the History API.\n */\nexport function useHistoryRouter(): StudioRouter {\n  const read = () =>\n    typeof window === \"undefined\" ? {} : locationFromSearchParams(new URLSearchParams(window.location.search));\n  const [location, setLocation] = useState<StudioLocation>(read);\n\n  useEffect(() => {\n    const onPop = () => setLocation(read());\n    window.addEventListener(\"popstate\", onPop);\n    return () => window.removeEventListener(\"popstate\", onPop);\n  }, []);\n\n  const navigate = useCallback((next: StudioLocation, options?: StudioNavigateOptions) => {\n    const params = searchParamsFromLocation(next, new URLSearchParams(window.location.search));\n    const query = params.toString();\n    const url = `${window.location.pathname}${query ? `?${query}` : \"\"}${window.location.hash}`;\n    if (options?.replace) window.history.replaceState(window.history.state, \"\", url);\n    else window.history.pushState(window.history.state, \"\", url);\n    setLocation(next);\n  }, []);\n\n  return useMemo(() => ({ location, navigate }), [location, navigate]);\n}\n\n/** A router held in memory, for tests and embedded previews. */\nexport function useMemoryRouter(initial: StudioLocation = {}): StudioRouter {\n  const [location, setLocation] = useState<StudioLocation>(initial);\n  const navigate = useCallback((next: StudioLocation) => setLocation(next), []);\n  return useMemo(() => ({ location, navigate }), [location, navigate]);\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,WAAW,SAAS,QAAQ,gBAAgC;AAClF,SAAS,kBAAkB,UAAU,sBAAsB;AAC3D,SAAS,UAAU,SAAS,MAAM,cAAc;AAChD,SAAS,uBAA2D;AACpE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AACP,SAAS,oBAA4C;AACrD,SAAS,OAAO,kBAAkB,kBAAkB;AACpD,SAAS,UAAU;;;ACRZ,SAAS,SAAS,OAAwB;AAC/C,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,UAAU,SAAU,QAAO,KAAK,UAAU,KAAK;AAC1D,SAAO,OAAO,KAAK;AACrB;AAGO,SAAS,YAAY,OAA+B;AACzD,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,SAAO,SAAS,KAAK;AACvB;AAMO,SAAS,WAAW,OAAoB,OAAwB;AACrE,MAAI,UAAU,MAAM,MAAM,SAAU,QAAO;AAC3C,SAAO;AACT;AAGO,SAAS,WAAW,OAA0C;AACnE,MAAI,MAAM,WAAY,QAAO,CAAC,GAAG,MAAM,UAAU;AACjD,MAAI,MAAM,SAAS,UAAW,QAAO,CAAC,QAAQ,OAAO;AACrD,SAAO;AACT;;;ADoDM,cA8EI,YA9EJ;AA1BN,IAAM,WAAW;AACjB,IAAM,qBAAqB;AAE3B,SAAS,kBAAkB,OAAyB;AAClD,SAAO,iBAAiB,KAAK,KAAK,MAAM,YAAY;AACtD;AAEA,SAAS,UAAU,OAAwB;AACzC,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;AAcO,SAAS,WAAW,OAAwB;AACjD,SACE,oBAAC,mBAAgB,UAAU,MAAM,UAC/B,8BAAC,mBAAiB,GAAG,OAAO,GAC9B;AAEJ;AAEA,SAAS,gBAAgB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,UAAU;AAAA,EACV;AACF,GAAoB;AAClB,QAAM,cAAc,eAAe;AACnC,QAAM,CAAC,UAAU,WAAW,IAAI,SAA2B,CAAC,CAAC;AAC7D,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,KAAK;AAGhD,YAAU,MAAM;AACd,iBAAa,KAAK;AAClB,gBAAY,CAAC,CAAC;AACd,SAAK,YAAY,aAAa,EAAE,UAAU,CAAC,gBAAgB,EAAE,CAAC;AAAA,EAChE,GAAG,CAAC,YAAY,WAAW,CAAC;AAE5B,QAAM,YAAY,SAAS;AAAA,IACzB,UAAU,CAAC,kBAAkB,YAAY,WAAW;AAAA,IACpD,SAAS,MAAM;AACb,UAAI,CAAC,SAAS,cAAe,OAAM,IAAI,MAAM,8CAA8C;AAC3F,aAAO,SAAS,cAAc;AAAA,IAChC;AAAA,IACA,OAAO,CAAC,OAAO,UAAU,CAAC,kBAAkB,KAAK,KAAK,QAAQ;AAAA,EAChE,CAAC;AAED,YAAU,MAAM;AACd,QAAI,kBAAkB,UAAU,KAAK,EAAG,cAAa,IAAI;AAAA,EAC3D,GAAG,CAAC,UAAU,KAAK,CAAC;AAEpB,QAAM,SAAS,YAAY,CAAC,UAA6C;AACvE;AAAA,MAAY,CAAC,SACX,CAAC,EAAE,GAAG,OAAO,IAAI,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC,IAAI,IAAI,oBAAI,KAAK,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,GAAG,EAAE;AAAA,IACjH;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,MAAI,WAAW;AACb,WACE,oBAAC,SAAI,WAAW,GAAG,sDAAsD,SAAS,GAAG,eAAY,kBAC9F,oBAAU,oBAAC,OAAE,WAAU,iCAAgC,wCAA0B,GACpF;AAAA,EAEJ;AAEA,QAAM,WAAW,OAAO,SAAS;AACjC,QAAM,OAAO,UAAU,QAAQ,CAAC;AAEhC,SACE,qBAAC,SAAI,WAAW,GAAG,wDAAwD,SAAS,GAAG,eAAY,UACjG;AAAA;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,WAAW;AAAA,QACX;AAAA,QACA,SAAS,UAAU;AAAA,QACnB,OAAO,UAAU,UAAU,UAAU,UAAU,KAAK,IAAI;AAAA,QACxD,UAAU,CAAC,aAAa,OAAO,SAAS,EAAE,SAAS,CAAC;AAAA;AAAA,IACtD;AAAA,IACA,qBAAC,UAAK,WAAU,4BAA2B,eAAY,eACpD;AAAA,iBACC;AAAA,QAAC;AAAA;AAAA,UAEC;AAAA,UACA,UAAU;AAAA,UACV;AAAA,UACA;AAAA,UACA;AAAA,UACA,YAAY;AAAA,UACZ,aAAa,MAAM,aAAa,IAAI;AAAA;AAAA,QAP/B;AAAA,MAQP,IAEA;AAAA,QAAC;AAAA;AAAA,UACC,WAAU;AAAA,UACV,eAAY;AAAA,UAEZ;AAAA,gCAAC,UAAO,WAAU,WAAU,eAAW,MAAC;AAAA,YACxC,oBAAC,OAAE,WAAU,WAAW,eAAK,SAAS,6BAA6B,0BAAyB;AAAA;AAAA;AAAA,MAC9F;AAAA,MAEF,oBAAC,iBAAc,SAAS,UAAU;AAAA,OACpC;AAAA,KACF;AAEJ;AAEA,SAAS,aAAa;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOG;AACD,SACE,qBAAC,SAAI,cAAW,UAAS,WAAU,gEAA+D,eAAY,kBAC5G;AAAA,yBAAC,SAAI,WAAU,oEACb;AAAA,0BAAC,YAAS,WAAU,iCAAgC,eAAW,MAAC;AAAA,MAC/D;AAAA,OACH;AAAA,IACC,WAAW,oBAAC,OAAE,WAAU,2CAA0C,kCAAe;AAAA,IACjF,SACC,oBAAC,OAAE,MAAK,SAAQ,WAAU,sCACvB,iBACH;AAAA,IAEF,oBAAC,QAAG,WAAU,OACX,oBAAU,IAAI,CAAC,MAAM;AACpB,YAAM,SAAS,EAAE,SAAS;AAC1B,aACE,oBAAC,QACC;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,SAAS,MAAM,SAAS,EAAE,IAAI;AAAA,UAC9B,gBAAc,SAAS,SAAS;AAAA,UAChC,OAAO,EAAE,OAAO,SAAS,EAAE,OAAO,GAAG,EAAE,IAAI,WAAM,EAAE,OAAO,UAAU,WAAW;AAAA,UAC/E,eAAa,gBAAgB,EAAE,IAAI;AAAA,UACnC,WAAW;AAAA,YACT;AAAA,YACA,SAAS,qCAAqC;AAAA,UAChD;AAAA,UAEA;AAAA,gCAAC,UAAK,WAAU,YAAY,YAAE,SAAS,EAAE,MAAK;AAAA,YAC7C,CAAC,EAAE,OAAO,UACT,oBAAC,QAAK,WAAU,8CAA6C,cAAW,aAAY;AAAA;AAAA;AAAA,MAExF,KAhBO,EAAE,IAiBX;AAAA,IAEJ,CAAC,GACH;AAAA,KACF;AAEJ;AAEA,SAAS,UAAU,MAAgF;AACjG,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,KAAK,KAAK,YAAY,GAAG;AAC/B,QAAM,QAAQ,KAAK,IAAI,KAAK,MAAM,GAAG,EAAE,IAAI;AAC3C,QAAM,QAAQ,KAAK,MAAM,KAAK,CAAC,MAAM,SAAS,SAAS;AACvD,SAAO,QAAQ,EAAE,OAAO,MAAM,IAAI;AACpC;AAEA,SAAS,MAAM;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQG;AACD,QAAM,cAAc,eAAe;AACnC,QAAM,EAAE,SAAS,IAAI;AACrB,QAAM,OAAO,SAAS,QAAQ;AAC9B,QAAM,OAAO,UAAU,SAAS,IAAI;AACpC,QAAM,SAAS,SAAS,UAAU;AAElC,QAAM,cAAc,SAAS;AAAA,IAC3B,UAAU,CAAC,kBAAkB,YAAY,YAAY,QAAQ;AAAA,IAC7D,SAAS,MAAM;AACb,UAAI,CAAC,SAAS,SAAU,OAAM,IAAI,MAAM,kDAAkD;AAC1F,aAAO,SAAS,SAAS,QAAQ;AAAA,IACnC;AAAA,IACA,OAAO;AAAA,EACT,CAAC;AACD,QAAM,SAAS,YAAY;AAE3B,QAAM,UAAU;AAAA,IACd,MAAM,CAAC,kBAAkB,YAAY,QAAQ,UAAU,MAAM,SAAS,SAAS,QAAQ,IAAI,MAAM;AAAA,IACjG,CAAC,YAAY,UAAU,MAAM,SAAS,SAAS,MAAM,MAAM;AAAA,EAC7D;AACA,QAAM,YAAY,SAAS;AAAA,IACzB,UAAU;AAAA,IACV,SAAS,QAAQ,MAAM;AAAA,IACvB,iBAAiB;AAAA,IACjB,OAAO;AAAA,IACP,SAAS,MACP,SAAS,QAAoB,UAAU;AAAA,MACrC,YAAY,EAAE,MAAM,QAAQ;AAAA,MAC5B;AAAA,MACA,QAAQ,SAAS,EAAE,OAAO,QAAQ,QAAQ,CAAC,EAAE,IAAI;AAAA,IACnD,CAAC;AAAA,EACL,CAAC;AAED,QAAM,UAAU,YAAY,SAAS,UAAU;AAC/C,YAAU,MAAM;AACd,QAAI,kBAAkB,OAAO,EAAG,aAAY;AAAA,EAC9C,GAAG,CAAC,SAAS,WAAW,CAAC;AAGzB,QAAM,cAAc,OAAkD,MAAS;AAC/E,YAAU,MAAM,MAAM,aAAa,YAAY,OAAO,GAAG,CAAC,CAAC;AAC3D,QAAM,WAAW;AAAA,IACf,CAAC,OAAgC,UAAU,UAAU,OAAO,SAAS,EAAE,GAAG,UAAU,UAAU,GAAG,MAAM,GAAG,EAAE,QAAQ,CAAC;AAAA,IACrH,CAAC,QAAQ,UAAU,QAAQ;AAAA,EAC7B;AAEA,QAAM,OAAQ,UAAU,MAAM,QAAQ,CAAC;AACvC,QAAM,QAAQ,QAAQ,UAAU,UAAU,MAAM,EAAE,SAAS,CAAC;AAC5D,QAAM,OAAO,QAAQ,MAAM;AACzB,UAAM,MAAM,oBAAI,IAAiB;AACjC,SAAK,QAAQ,CAAC,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,QAAQ,OAAO,gBAAgB,QAAQ,GAAG,CAAC,IAAI,OAAO,KAAK,EAAE,CAAC;AAClH,WAAO;AAAA,EACT,GAAG,CAAC,MAAM,QAAQ,KAAK,CAAC;AAExB,QAAM,aAAa;AAAA,IACjB,CAAC,QAAa,SAAc;AAC1B,kBAAY;AAAA,QAAa;AAAA,QAAS,CAAC,SACjC,OAAO,EAAE,GAAG,MAAM,MAAM,KAAK,KAAK,IAAI,CAAC,MAAO,MAAM,SAAS,OAAO,CAAE,EAAE,IAAI;AAAA,MAC9E;AAAA,IACF;AAAA,IACA,CAAC,aAAa,OAAO;AAAA,EACvB;AAEA,QAAM,OAAO;AAAA,IACX,OAAO,OAAoB,KAAU,UAAkB;AACrD,UAAI,CAAC,OAAQ;AACb,UAAI,UAAU,SAAS,IAAI,MAAM,IAAI,CAAC,EAAG;AACzC,YAAM,cAAc,KAAK,IAAI,GAAG,KAAK;AACrC,YAAM,eAAe,OAAO,SAAS;AACrC,YAAM,kBAAkB,eAAgB,IAAI,YAAY,KAAK,OAAO,OAAO,OAAO,IAAI,YAAY,CAAC,IAAK;AACxG,UAAI;AACF,cAAM,SAAS,MAAM,SAAS,OAAmB,UAAU;AAAA,UACzD,IAAI,gBAAgB,QAAQ,GAAG;AAAA,UAC/B,MAAM,EAAE,CAAC,MAAM,IAAI,GAAG,WAAW,OAAO,KAAK,EAAE;AAAA,UAC/C;AAAA,QACF,CAAC;AACD,mBAAW,KAAK,OAAO,IAAW;AAClC,mBAAW;AAAA,UACT;AAAA,UACA,OAAO,MAAM;AAAA,UACb,QAAQ;AAAA,UACR,SAAS;AAAA,UACT,SAAS,OAAO,QAAQ,iCAAiC;AAAA,UACzD,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,QAChD,CAAC;AAAA,MACH,SAAS,OAAO;AACd,YAAI,kBAAkB,KAAK,EAAG,aAAY;AAC1C,YAAI,iBAAiB,KAAK,KAAK,MAAM,YAAY,cAAc,MAAM,SAAS;AAE5E,qBAAW,KAAK;AAAA,YACd,GAAG;AAAA,YACH,GAAG,MAAM;AAAA,YACT,GAAI,eAAe,EAAE,CAAC,YAAY,GAAG,MAAM,kBAAkB,KAAK,IAAI,CAAC;AAAA,UACzE,CAAC;AAAA,QACH;AACA,YAAI,iBAAiB,KAAK,KAAK,MAAM,YAAY,QAAQ;AACvD,eAAK,YAAY,kBAAkB,EAAE,UAAU,QAAQ,CAAC;AAAA,QAC1D;AACA,mBAAW,EAAE,UAAU,OAAO,MAAM,MAAM,QAAQ,aAAa,SAAS,aAAa,SAAS,UAAU,KAAK,EAAE,CAAC;AAChH,cAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,MAChE;AAAA,IACF;AAAA,IACA,CAAC,QAAQ,MAAM,UAAU,UAAU,YAAY,YAAY,aAAa,aAAa,OAAO;AAAA,EAC9F;AAEA,QAAM,UAAU,QAAkC,MAAM;AACtD,QAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,WAAO,OAAO,OAAO,IAAI,CAAC,UAAU;AAClC,YAAM,UAAU,WAAW,KAAK;AAChC,aAAO;AAAA,QACL,KAAK,MAAM;AAAA,QACX,QAAQ,MAAM;AAAA,QACd,UAAU;AAAA,QACV,UAAU,CAAC,QAAa,SAAS,IAAI,MAAM,IAAI,CAAC;AAAA,QAChD,QAAQ,CAAC,QAAa;AACpB,gBAAM,OAAO,YAAY,IAAI,MAAM,IAAI,CAAC;AACxC,iBAAO,SAAS,OACd,oBAAC,UAAK,WAAU,yBAAwB,oBAAC,IAEzC,oBAAC,UAAK,WAAU,gCAA+B,OAAO,MACnD,gBACH;AAAA,QAEJ;AAAA,QACA,GAAI,MAAM,aAAa,SACnB;AAAA,UACE,UAAU;AAAA,YACR,MAAM,UAAW,WAAsB;AAAA,YACvC,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,YAC7B,QAAQ,CAAC,KAAU,UAAkB,KAAK,OAAO,KAAK,KAAK;AAAA,UAC7D;AAAA,QACF,IACA,CAAC;AAAA,MACP;AAAA,IACF,CAAC;AAAA,EACH,GAAG,CAAC,QAAQ,IAAI,CAAC;AAEjB,MAAI,YAAY,WAAW,CAAC,kBAAkB,YAAY,KAAK,GAAG;AAChE,WACE,qBAAC,SAAM,SAAQ,eAAc,eAAY,yBACvC;AAAA,2BAAC,cAAW;AAAA;AAAA,QAAe;AAAA,SAAS;AAAA,MACpC,oBAAC,oBAAkB,oBAAU,YAAY,KAAK,GAAE;AAAA,OAClD;AAAA,EAEJ;AAEA,QAAM,WAAW,QAAQ,OAAO,OAAO,CAAC,MAAM,EAAE,aAAa,MAAM,EAAE,UAAU;AAE/E,SACE,qBAAC,SAAI,WAAU,aAAY,eAAY,gBACpC;AAAA,cAAU,CAAC,OAAO,OAAO,UACxB,qBAAC,SAAM,eAAY,oBACjB;AAAA,0BAAC,QAAK,WAAU,WAAU,eAAW,MAAC;AAAA,MACtC,oBAAC,cAAW,uBAAS;AAAA,MACrB,oBAAC,oBAAkB,iBAAO,OAAO,UAAU,4CAA2C;AAAA,OACxF;AAAA,IAEF;AAAA,MAAC;AAAA;AAAA,QACC,OAAO,QAAQ,SAAS;AAAA,QACxB,UAAU,eAAe,QAAQ,QAAQ;AAAA,QACzC,MAAM;AAAA,QACN,OAAO,UAAU,MAAM,SAAS;AAAA,QAChC;AAAA,QACA,QAAQ,CAAC,QAAQ,KAAK,IAAI,GAAG,KAAK;AAAA,QAClC,QAAO;AAAA,QACP;AAAA,QACA;AAAA,QACA,cAAc,CAAC,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AAAA,QAC/C,cAAc,CAAC,SAAS,SAAS,EAAE,MAAM,OAAO,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,QAAW,MAAM,EAAE,CAAC;AAAA,QACpG,gBAAgB,CAAC,SAAS;AACxB,uBAAa,YAAY,OAAO;AAChC,sBAAY,UAAU,WAAW,MAAM,SAAS,EAAE,QAAQ,QAAQ,QAAW,MAAM,EAAE,GAAG,IAAI,GAAG,kBAAkB;AAAA,QACnH;AAAA,QAIA,gBAAgB;AAAA,UACd,GAAI,SAAS,CAAC,EAAE,OAAO,cAAc,UAAU,YAAqB,OAAO,OAAO,CAAC,IAAI,CAAC;AAAA,UACxF,GAAI,SAAS,OAAO,CAAC,EAAE,OAAO,YAAY,UAAU,MAAe,OAAO,SAAS,KAAK,CAAC,IAAI,CAAC;AAAA,QAChG;AAAA,QACA,SAAS,YAAY,aAAa,UAAU;AAAA,QAC5C,OAAO,UAAU,WAAW,CAAC,kBAAkB,UAAU,KAAK;AAAA,QAC9D,cAAc,UAAU,QAAQ,UAAU,UAAU,KAAK,IAAI;AAAA,QAC7D,SAAS,MAAM,KAAK,UAAU,QAAQ;AAAA,QACtC,qBAAqB,kBAAkB,QAAQ;AAAA,QAC/C,WAAW,kBAAkB,QAAQ;AAAA,QACrC,iBAAiB,kBAAkB,QAAQ;AAAA,QAC3C,mBAAiB;AAAA;AAAA,IACnB;AAAA,KACF;AAEJ;AAEA,SAAS,eAAe,QAAoC,UAAsC;AAChG,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,QAAQ,CAAC,OAAO,IAAI;AAC1B,MAAI,OAAO,OAAO,OAAQ,OAAM,KAAK,GAAG,QAAQ,OAAO,OAAO,OAAO,MAAM,kBAAkB;AAC7F,MAAI,OAAO,QAAS,OAAM,KAAK,yBAAyB,OAAO,QAAQ,KAAK,EAAE;AAC9E,SAAO,MAAM,KAAK,QAAK;AACzB;AAEA,SAAS,cAAc,EAAE,QAAQ,GAAkC;AACjE,SACE,qBAAC,aAAQ,cAAW,wBAAuB,WAAU,6BAA4B,eAAY,mBAC3F;AAAA,yBAAC,QAAG,WAAU,oEACZ;AAAA,0BAAC,WAAQ,WAAU,iCAAgC,eAAW,MAAC;AAAA,MAAE;AAAA,OAEnE;AAAA,IACC,QAAQ,WAAW,IAClB,oBAAC,OAAE,WAAU,2CAA0C,+GAEvD,IAEA,oBAAC,QAAG,WAAU,YAAW,aAAU,UAChC,kBAAQ,IAAI,CAAC,UACZ,qBAAC,QAAkB,WAAU,qBAAoB,eAAa,mBAAmB,MAAM,OAAO,IAC5F;AAAA,2BAAC,SAAI,WAAU,yCACb;AAAA,4BAAC,UAAK,WAAW,MAAM,YAAY,UAAU,gCAAgC,gCAC1E,gBAAM,YAAY,UAAU,UAAU,aACzC;AAAA,QACA,qBAAC,UAAK,WAAU,yBACb;AAAA,gBAAM;AAAA,UAAS;AAAA,UAAI,MAAM;AAAA,UAAM;AAAA,UAAI,MAAM;AAAA,WAC5C;AAAA,QACA,oBAAC,UAAK,WAAU,iCAAgC,UAAU,MAAM,GAAG,YAAY,GAC5E,gBAAM,GAAG,mBAAmB,GAC/B;AAAA,SACF;AAAA,MACA,oBAAC,OAAE,WAAU,gCAAgC,gBAAM,SAAQ;AAAA,MAC1D,MAAM,SAAS,oBAAC,aAAU,OAAO,MAAM,OAAO;AAAA,SAbxC,MAAM,EAcf,CACD,GACH;AAAA,KAEJ;AAEJ;AAEA,SAAS,UAAU,EAAE,MAAM,GAA0B;AACnD,QAAM,UAAU,OAAO,KAAK,MAAM,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW;AAAA,IAC7D;AAAA,IACA,QAAQ,YAAY,MAAM,SAAS,KAAK,CAAC,KAAK;AAAA,IAC9C,OAAO,YAAY,MAAM,QAAQ,KAAK,CAAC,KAAK;AAAA,EAC9C,EAAE;AACF,SACE,qBAAC,SAAI,WAAU,4DAA2D,eAAY,sBACpF;AAAA,yBAAC,SAAI,WAAU,yBAAwB;AAAA;AAAA,MAC9B,MAAM,GAAG,MAAM,GAAG,CAAC;AAAA,MAAE;AAAA,MAAI,MAAM;AAAA,MAAW;AAAA,MAAO,MAAM,SAAS;AAAA,OACzE;AAAA,IACC,QAAQ,IAAI,CAAC,MACZ,qBAAC,SACE;AAAA,QAAE;AAAA,MAAM;AAAA,MAAG,EAAE;AAAA,MAAO;AAAA,MAAI,EAAE;AAAA,SADnB,EAAE,KAEZ,CACD;AAAA,KACH;AAEJ;;;AExfA,SAAS,eAAAA,cAAa,aAAAC,YAAW,WAAAC,UAAS,YAAAC,iBAAgB;AAwB1D,IAAM,QAAQ,EAAE,UAAU,SAAS,MAAM,QAAQ,MAAM,QAAQ,QAAQ,IAAI;AAEpE,SAAS,yBAAyB,QAAyC;AAChF,QAAM,OAAO,OAAO,OAAO,IAAI,MAAM,IAAI,CAAC;AAC1C,SAAO;AAAA,IACL,GAAI,OAAO,IAAI,MAAM,QAAQ,IAAI,EAAE,UAAU,OAAO,IAAI,MAAM,QAAQ,EAAG,IAAI,CAAC;AAAA,IAC9E,GAAI,OAAO,UAAU,IAAI,KAAK,OAAO,IAAI,EAAE,KAAK,IAAI,CAAC;AAAA,IACrD,GAAI,OAAO,IAAI,MAAM,IAAI,IAAI,EAAE,MAAM,OAAO,IAAI,MAAM,IAAI,EAAG,IAAI,CAAC;AAAA,IAClE,GAAI,OAAO,IAAI,MAAM,MAAM,IAAI,EAAE,QAAQ,OAAO,IAAI,MAAM,MAAM,EAAG,IAAI,CAAC;AAAA,EAC1E;AACF;AAMO,SAAS,yBAAyB,UAA0B,MAAyC;AAC1G,QAAM,SAAS,IAAI,gBAAgB,IAAI;AACvC,aAAW,QAAQ,OAAO,OAAO,KAAK,EAAG,QAAO,OAAO,IAAI;AAC3D,MAAI,SAAS,SAAU,QAAO,IAAI,MAAM,UAAU,SAAS,QAAQ;AACnE,MAAI,SAAS,QAAQ,SAAS,OAAO,EAAG,QAAO,IAAI,MAAM,MAAM,OAAO,SAAS,IAAI,CAAC;AACpF,MAAI,SAAS,KAAM,QAAO,IAAI,MAAM,MAAM,SAAS,IAAI;AACvD,MAAI,SAAS,OAAQ,QAAO,IAAI,MAAM,QAAQ,SAAS,MAAM;AAC7D,SAAO;AACT;AAWO,SAAS,yBACd,QACA,WACc;AACd,SAAO;AAAA,IACL,UAAU,yBAAyB,MAAM;AAAA,IACzC,UAAU,CAAC,MAAM,YAAY,UAAU,yBAAyB,MAAM,MAAM,GAAG,EAAE,SAAS,SAAS,WAAW,MAAM,CAAC;AAAA,EACvH;AACF;AAMO,SAAS,mBAAiC;AAC/C,QAAM,OAAO,MACX,OAAO,WAAW,cAAc,CAAC,IAAI,yBAAyB,IAAI,gBAAgB,OAAO,SAAS,MAAM,CAAC;AAC3G,QAAM,CAAC,UAAU,WAAW,IAAIA,UAAyB,IAAI;AAE7D,EAAAF,WAAU,MAAM;AACd,UAAM,QAAQ,MAAM,YAAY,KAAK,CAAC;AACtC,WAAO,iBAAiB,YAAY,KAAK;AACzC,WAAO,MAAM,OAAO,oBAAoB,YAAY,KAAK;AAAA,EAC3D,GAAG,CAAC,CAAC;AAEL,QAAM,WAAWD,aAAY,CAAC,MAAsB,YAAoC;AACtF,UAAM,SAAS,yBAAyB,MAAM,IAAI,gBAAgB,OAAO,SAAS,MAAM,CAAC;AACzF,UAAM,QAAQ,OAAO,SAAS;AAC9B,UAAM,MAAM,GAAG,OAAO,SAAS,QAAQ,GAAG,QAAQ,IAAI,KAAK,KAAK,EAAE,GAAG,OAAO,SAAS,IAAI;AACzF,QAAI,SAAS,QAAS,QAAO,QAAQ,aAAa,OAAO,QAAQ,OAAO,IAAI,GAAG;AAAA,QAC1E,QAAO,QAAQ,UAAU,OAAO,QAAQ,OAAO,IAAI,GAAG;AAC3D,gBAAY,IAAI;AAAA,EAClB,GAAG,CAAC,CAAC;AAEL,SAAOE,SAAQ,OAAO,EAAE,UAAU,SAAS,IAAI,CAAC,UAAU,QAAQ,CAAC;AACrE;AAGO,SAAS,gBAAgB,UAA0B,CAAC,GAAiB;AAC1E,QAAM,CAAC,UAAU,WAAW,IAAIC,UAAyB,OAAO;AAChE,QAAM,WAAWH,aAAY,CAAC,SAAyB,YAAY,IAAI,GAAG,CAAC,CAAC;AAC5E,SAAOE,SAAQ,OAAO,EAAE,UAAU,SAAS,IAAI,CAAC,UAAU,QAAQ,CAAC;AACrE;","names":["useCallback","useEffect","useMemo","useState"]}

package/dist/styles.css

@@ -0,0 +1,12 @@
+/*
+ * Tailwind v4 source entry for @marktiderman/genesis-studio.
+ *
+ * Copied to dist/styles.css at build time, so "./" is the published dist/
+ * folder: importing this file makes Tailwind scan the studio's compiled
+ * components for the utility classes they use. Import genesis-ui's too.
+ *
+ *   @import "tailwindcss";
+ *   @import "@marktiderman/genesis-ui/styles.css";
+ *   @import "@marktiderman/genesis-studio/styles.css";
+ */
+@source "./";

package/package.json

@@ -1 +1,65 @@
-{"name":"@marktiderman/genesis-studio","version":"0.0.0","description":"Placeholder so npm Trusted Publishing can be set up. Real releases start at 0.1.0 from CI.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/marktiderman/genesis.git"}}
+{
+  "name": "@marktiderman/genesis-studio",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "description": "Genesis Data Studio — an Airtable-style workspace for a Postgres or Supabase app's own data: a table sidebar and a sheet grid with version-checked, audited single-cell edits, as the signed-in user. Built on genesis-ui's ResourcePage; routing and sign-in come from the host app. Part of the Genesis framework.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marktiderman/genesis.git",
+    "directory": "packages/studio"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@marktiderman/genesis-core": "^1.2.0",
+    "@marktiderman/genesis-ui": "^2.5.0",
+    "@tanstack/react-query": "^5.0.0",
+    "lucide-react": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@marktiderman/genesis-core": "^1.2.0",
+    "@marktiderman/genesis-design-system": "^1.3.1",
+    "@marktiderman/genesis-ui": "^2.5.0",
+    "@tanstack/react-query": "^5.75.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "happy-dom": "^20.9.0",
+    "lucide-react": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsup && cp src/styles.css dist/styles.css && node ../../scripts/check-exports-resolve.mjs",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}