@datakable/react 0.0.0-stage → 1.0.1

package/dist/render-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/render-codes.ts"],"sourcesContent":["import {\n  type DiagnosticMessages,\n  defineDiagnostic,\n  defineSlot,\n  registerOperation,\n} from '@datakable/core'\n\ndeclare module '@datakable/core' {\n  interface DiagnosticCatalog {\n    DK_RENDER_FAILED: {\n      /**\n       * The render operation: `render:cell` (a cell's boundary: a component returned by `cell` /\n       * `invalidCell`) or `render:table` (the body boundary: a component outside the cells).\n       */\n      op: 'render:table' | 'render:cell'\n      /** `render:cell`: the slot whose component threw, `columns[1].cell`. */\n      slot?: string\n      /** `render:cell`: the column id. */\n      column?: string\n      /** `render:cell`: the row's index in the data (the first failure; later ones are deduped). */\n      row?: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n  }\n\n  /** §3.4: React error boundaries, not interceptor chains (nothing runs interceptors on them). */\n  interface Operations {\n    'render:table': { kind: 'sync'; input: undefined; output: undefined }\n    'render:cell': {\n      kind: 'sync'\n      input: { column: string; slot: 'cell' | 'invalidCell'; row: number }\n      output: undefined\n    }\n  }\n}\n\n/**\n * Registers `render:table` / `render:cell` (§3.4: owned by `@datakable/react`, not core). Neither\n * is hot: no interceptor chain runs per cell, so `on: '*'` interceptors get no hot-op warning for\n * them. Idempotent (an identical re-registration is a no-op).\n */\nexport function registerRenderOperations(): void {\n  registerOperation('render:table', { kind: 'sync', hot: false })\n  registerOperation('render:cell', { kind: 'sync', hot: false })\n}\n\n// No @types/node here: declare just what is read.\ndeclare const process: { env: { NODE_ENV?: string } }\n\n/**\n * `columns[i].cell` (§4.1, §10): renders a React node synchronously. A thenable is a contract\n * violation (`DK_CALLBACK_BAD_RETURN`); `<DataTable />` renders `⚠` instead.\n */\nexport const cellSlot = defineSlot({\n  name: 'cell',\n  returns: 'sync',\n  fallback: 'those cells rendered ⚠',\n})\n\n/** `columns[i].invalidCell` (§5.1): renders a flagged cell; same contract as `cell`. */\nexport const invalidCellSlot = defineSlot({\n  name: 'invalidCell',\n  returns: 'sync',\n  fallback: 'those cells rendered ⚠',\n})\n\n/** Message text (§8.2): development builds, or production via `datakable/messages`. */\nexport const renderMessages: DiagnosticMessages<'DK_RENDER_FAILED'> = {\n  DK_RENDER_FAILED: {\n    problem: (d) =>\n      d.op === 'render:cell'\n        ? `a component returned by ${d.slot} (column \"${d.column}\") threw` +\n          `${d.errorName ? ` ${d.errorName}` : ''} while rendering row #${d.row}`\n        : `a component rendered inside the table body threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n          '(outside the cells: a components.Empty / Loading / Error part)',\n    impact: (d) =>\n      d.op === 'render:cell'\n        ? 'that cell renders ⚠; the other cells and rows, the header, search, pagination and the ' +\n          \"table API keep working, and the cell renders again when its row's data or the columns \" +\n          'change'\n        : 'the table body shows the Error state; the header, search and pagination keep working, ' +\n          'and the body renders again on the next row model or Retry',\n    fix: (d) =>\n      d.op === 'render:cell'\n        ? [\n            `find the throwing component in context.cause (passed to onDiagnostic) and make it ` +\n              `total: guard null / undefined / unexpected values of column \"${d.column}\" ` +\n              'instead of throwing',\n            'for your own fallback instead of ⚠, wrap the component in an error boundary inside ' +\n              `${d.slot}`,\n          ]\n        : [\n            'find the throwing component in context.cause (passed to onDiagnostic) and make it ' +\n              'total: guard null / undefined / unexpected values instead of throwing',\n            'a component returned by a column cell / invalidCell is caught per cell (⚠); a throw in ' +\n              'the cell function itself is DK_CALLBACK_FAILED',\n          ],\n  },\n}\n\n/** Codes owned by `<DataTable />` (§8.3, react). Emitted in production too; text behind NODE_ENV. */\nexport const renderDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_RENDER_FAILED',\n      level: 'error',\n      where: (d) =>\n        d.slot ? { kind: 'operation', op: d.op, slot: d.slot } : { kind: 'operation', op: d.op },\n    },\n    // Written out (not an imported flag) so a consumer's bundler folds it while parsing (§8.2).\n    process.env.NODE_ENV !== 'production' && renderMessages.DK_RENDER_FAILED,\n  ),\n]\n"],"mappings":";AAAA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAqCA,SAAS,2BAAiC;AAC/C,oBAAkB,gBAAgB,EAAE,MAAM,QAAQ,KAAK,MAAM,CAAC;AAC9D,oBAAkB,eAAe,EAAE,MAAM,QAAQ,KAAK,MAAM,CAAC;AAC/D;AASO,IAAM,WAAW,WAAW;AAAA,EACjC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AAGM,IAAM,kBAAkB,WAAW;AAAA,EACxC,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AAGM,IAAM,iBAAyD;AAAA,EACpE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MACR,EAAE,OAAO,gBACL,2BAA2B,EAAE,IAAI,aAAa,EAAE,MAAM,WACnD,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE,yBAAyB,EAAE,GAAG,KACrE,mDAAmD,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAE7F,QAAQ,CAAC,MACP,EAAE,OAAO,gBACL,4LAGA;AAAA,IAEN,KAAK,CAAC,MACJ,EAAE,OAAO,gBACL;AAAA,MACE,kJACkE,EAAE,MAAM;AAAA,MAE1E,2FACK,EAAE,IAAI;AAAA,IACb,IACA;AAAA,MACE;AAAA,MAEA;AAAA,IAEF;AAAA,EACR;AACF;AAGO,IAAM,oBAAoB;AAAA,EAC/B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,OAAO,EAAE,MAAM,aAAa,IAAI,EAAE,IAAI,MAAM,EAAE,KAAK,IAAI,EAAE,MAAM,aAAa,IAAI,EAAE,GAAG;AAAA,IAC3F;AAAA;AAAA,IAEA,QAAQ,IAAI,aAAa,gBAAgB,eAAe;AAAA,EAC1D;AACF;","names":[]}

package/dist/styles.css

@@ -0,0 +1 @@
+:where([data-datakable]){--dk-font-size: .875rem;--dk-fg: #1f2328;--dk-muted: #59636e;--dk-bg: #fff;--dk-subtle: #f6f8fa;--dk-border: #d1d9e0;--dk-accent: #0969da;--dk-danger: #d1242f;--dk-danger-bg: #ffebe9;--dk-radius: 6px;--dk-cell-py: .5rem;--dk-cell-px: .75rem;font-size:var(--dk-font-size);color:var(--dk-fg);background:var(--dk-bg);font-variant-numeric:tabular-nums}@media(prefers-color-scheme:dark){:where([data-datakable]){--dk-fg: #f0f6fc;--dk-muted: #9198a1;--dk-bg: #0d1117;--dk-subtle: #151b23;--dk-border: #3d444d;--dk-accent: #4493f8;--dk-danger: #f85149;--dk-danger-bg: #25171c}}:where([data-datakable] table){width:100%;border-collapse:collapse}:where([data-datakable] caption){padding:var(--dk-cell-py) var(--dk-cell-px);color:var(--dk-muted);text-align:start}:where([data-datakable] th,[data-datakable] td){padding:var(--dk-cell-py) var(--dk-cell-px);border-bottom:1px solid var(--dk-border);text-align:start}:where([data-datakable] thead th){background:var(--dk-subtle);font-weight:600;white-space:nowrap}:where([data-datakable] tbody tr:hover){background:var(--dk-subtle)}:where([data-datakable] button){font:inherit;color:inherit;padding:.25rem .625rem;background:var(--dk-bg);border:1px solid var(--dk-border);border-radius:var(--dk-radius);cursor:pointer}:where([data-datakable] button:disabled){opacity:.5;cursor:not-allowed}:where([data-datakable] button:focus-visible,[data-datakable] input:focus-visible){outline:2px solid var(--dk-accent);outline-offset:1px}:where([data-datakable] th[aria-sort] button){font-weight:inherit;padding:0;background:none;border:0}:where([data-datakable] th[aria-sort=ascending],[data-datakable] th[aria-sort=descending]){color:var(--dk-accent)}:where([data-datakable] [data-dk-sort-indicator]){font-size:.75em}:where([data-datakable] [data-dk-search]){display:flex;align-items:center;gap:.5rem;margin-bottom:.5rem}:where([data-datakable] [data-dk-search] input){font:inherit;color:inherit;min-width:12rem;padding:.375rem .625rem;background:var(--dk-bg);border:1px solid var(--dk-border);border-radius:var(--dk-radius)}:where([data-datakable] [data-dk-spinner]){width:1em;height:1em;border:2px solid var(--dk-border);border-top-color:var(--dk-accent);border-radius:50%;animation:dk-spin .7s linear infinite}@keyframes dk-spin{to{transform:rotate(1turn)}}:where([data-datakable] [data-dk-state] td){padding:2rem var(--dk-cell-px);color:var(--dk-muted);text-align:center}:where([data-datakable] tr[data-dk-state]:hover){background:none}:where([data-datakable] [data-dk-state=loading] td){font-style:italic}:where([data-datakable] [data-dk-state=error] td){color:var(--dk-danger)}:where([data-datakable] [data-dk-refresh]){margin-bottom:.5rem;color:var(--dk-muted)}:where([data-datakable] [data-dk-refresh][data-status=error]){padding:.375rem var(--dk-cell-px);color:var(--dk-danger);background:var(--dk-danger-bg);border-radius:var(--dk-radius)}:where([data-datakable][aria-busy=true]:not([data-initial-load=true]) tbody){opacity:.6;transition:opacity .15s}:where([data-datakable] tr[data-invalid=true]){background:var(--dk-danger-bg)}:where([data-datakable] td[data-invalid=true]){color:var(--dk-danger);box-shadow:inset 2px 0 var(--dk-danger)}:where([data-datakable] [data-dk-invalid-marker]){color:var(--dk-danger)}:where([data-datakable] [data-dk-pagination]){display:flex;align-items:center;justify-content:flex-end;gap:.5rem;margin-top:.5rem}:where([data-datakable] [data-dk-page]){color:var(--dk-muted)}@media(prefers-reduced-motion:reduce){:where([data-datakable] [data-dk-spinner]){animation:none;border-color:var(--dk-accent)}:where([data-datakable] *){transition:none}}

package/dist/use-data-table.cjs

@@ -0,0 +1,383 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/use-data-table.ts
+var use_data_table_exports = {};
+__export(use_data_table_exports, {
+  useDataTable: () => useDataTable
+});
+module.exports = __toCommonJS(use_data_table_exports);
+var import_core = require("@datakable/core");
+var import_react = require("react");
+
+// package.json
+var version = "1.0.1";
+
+// src/use-data-table.ts
+var import_codes = require("./codes.cjs");
+(0, import_core.keepDiagnostics)(import_codes.reactDiagnostics);
+var useIsomorphicLayoutEffect = typeof window === "undefined" ? import_react.useEffect : import_react.useLayoutEffect;
+var SYNCED = [
+  "data",
+  "columns",
+  "rowKey",
+  "state",
+  "onStateChange",
+  "interceptors",
+  "onDiagnostic",
+  "fetcher",
+  "rowCount"
+];
+var CALLBACKS = ["onStateChange", "onDiagnostic", "fetcher"];
+var UNSTABLE_AFTER = 2;
+var registered = false;
+function useDataTable(options) {
+  const ref = (0, import_react.useRef)(null);
+  if (ref.current === null) ref.current = createInstance(options);
+  const inst = ref.current;
+  const table = inst.table;
+  const [, rerender] = (0, import_react.useReducer)((n) => n + 1, 0);
+  const subscribe = (0, import_react.useCallback)(
+    (onChange) => {
+      if (inst.table !== table || inst.destroyed) return () => {
+      };
+      return table.subscribe(() => {
+        inst.version++;
+        if (inst.syncing) inst.selfCaused = true;
+        onChange();
+      });
+    },
+    [inst, table]
+  );
+  const getSnapshot = (0, import_react.useCallback)(() => snapshot(inst, table), [inst, table]);
+  const getServerSnapshot = (0, import_react.useCallback)(() => serverSnapshot(inst, table), [inst, table]);
+  const view = (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
+  (0, import_react.useInsertionEffect)(() => checkHydration(inst), [inst]);
+  useIsomorphicLayoutEffect(() => {
+    inst.mounted = true;
+    if (inst.destroyed) {
+      recreate(inst);
+      (0, import_core.startTable)(inst.table);
+      rerender();
+    } else {
+      (0, import_core.startTable)(inst.table);
+      if (snapshot(inst, inst.table) !== view) rerender();
+    }
+    return () => {
+      inst.mounted = false;
+      queueMicrotask(() => {
+        if (inst.mounted || inst.destroyed) return;
+        inst.destroyed = true;
+        inst.table.destroy();
+      });
+    };
+  }, [inst]);
+  useIsomorphicLayoutEffect(() => {
+    inst.latest = options;
+    const selfCaused = inst.selfCaused;
+    inst.selfCaused = false;
+    if (!inst.destroyed) sync(inst, options, selfCaused);
+    deliver(inst);
+  });
+  return view;
+}
+function createInstance(options) {
+  const inst = {
+    table: void 0,
+    destroyed: false,
+    mounted: false,
+    latest: options,
+    synced: options,
+    wrappers: {
+      onStateChange: (updater) => inst.latest.onStateChange(updater),
+      onDiagnostic: (d) => {
+        if (inst.rendering === 0) {
+          ;
+          inst.latest.onDiagnostic?.(d);
+          return;
+        }
+        if (inst.queue === void 0) {
+          inst.queue = [];
+          queueMicrotask(() => deliver(inst));
+        }
+        inst.queue.push(d);
+      },
+      fetcher: (params) => inst.latest.fetcher(params)
+    },
+    queue: void 0,
+    rendering: 0,
+    syncing: false,
+    selfCaused: false,
+    selfData: false,
+    version: 0,
+    view: void 0,
+    server: void 0,
+    hydrating: false,
+    seen: options,
+    unstable: /* @__PURE__ */ new Map(),
+    warned: /* @__PURE__ */ new Set()
+  };
+  if (process.env.NODE_ENV !== "production" && !registered) {
+    registered = true;
+    (0, import_core.registerPackage)("@datakable/react", version);
+  }
+  build(inst, options);
+  return inst;
+}
+function wrapper(inst, k, v) {
+  const w = inst.wrappers[k];
+  if (k === "fetcher") {
+    ;
+    w[import_core.SERVER_SOURCE] = v[import_core.SERVER_SOURCE];
+  }
+  return w;
+}
+function build(inst, options) {
+  const init = { ...options };
+  for (const k of CALLBACKS) {
+    if (typeof options[k] === "function") init[k] = wrapper(inst, k, options[k]);
+  }
+  inst.rendering++;
+  try {
+    inst.table = (0, import_core.createDeferred)(() => (0, import_core.createTable)(init));
+  } finally {
+    inst.rendering--;
+  }
+  inst.synced = options;
+  inst.seen = options;
+  inst.view = void 0;
+  inst.server = void 0;
+}
+function recreate(inst) {
+  build(inst, inst.latest);
+  inst.destroyed = false;
+}
+function snapshot(inst, table) {
+  inst.rendering++;
+  try {
+    const state = table.getState();
+    const rowModel = table.getRowModel();
+    const v = inst.view;
+    if (v && v.table === table && v.version === inst.version) {
+      const value2 = v.value;
+      if (value2.state === state && value2.rowModel === rowModel) return value2;
+    }
+    const value = Object.create(table, {
+      state: { value: state, enumerable: true },
+      rowModel: { value: rowModel, enumerable: true }
+    });
+    inst.view = { table, version: inst.version, value };
+    return value;
+  } finally {
+    inst.rendering--;
+  }
+}
+function serverSnapshot(inst, table) {
+  if (inst.table !== table) return snapshot(inst, table);
+  if (typeof window !== "undefined") inst.hydrating = true;
+  const s = inst.server;
+  if (s && s.table === table) return s.value;
+  const value = snapshot(inst, table);
+  inst.server = { table, value };
+  return value;
+}
+function checkHydration(inst) {
+  if (!inst.hydrating) return;
+  inst.hydrating = false;
+  const server = inst.server;
+  if (!server || server.table !== inst.table) return;
+  const live = snapshot(inst, inst.table);
+  const hydrated = server.value;
+  if (live === hydrated) return;
+  const slices = [];
+  for (const k of /* @__PURE__ */ new Set([...Object.keys(hydrated.state), ...Object.keys(live.state)])) {
+    if (!Object.is(hydrated.state[k], live.state[k])) slices.push(k);
+  }
+  if (slices.length === 0) {
+    if (live.rowModel === hydrated.rowModel) return;
+    slices.push("rows");
+  }
+  inst.rendering++;
+  try {
+    (0, import_core.emitTableDiagnostic)(
+      inst.table,
+      "DK_HYDRATION_MISMATCH",
+      { slices },
+      { trigger: "hydrate", phase: "hydrate" }
+    );
+  } finally {
+    inst.rendering--;
+  }
+}
+function sync(inst, options, selfCaused) {
+  if (process.env.NODE_ENV !== "production") checkUnstable(inst, options);
+  const prev = inst.synced;
+  if (!selfCaused) inst.selfData = false;
+  let partial;
+  for (const k of SYNCED) {
+    const v = options[k];
+    const p = prev[k];
+    if (Object.is(v, p)) continue;
+    let forward = v;
+    switch (k) {
+      case "onStateChange":
+      case "onDiagnostic":
+      case "fetcher": {
+        const on = typeof v === "function";
+        if (on === (typeof p === "function")) continue;
+        forward = on ? wrapper(inst, k, v) : void 0;
+        break;
+      }
+      case "state":
+        if (sameSlices(v, p)) continue;
+        break;
+      case "interceptors":
+        if (sameItems(v, p)) continue;
+        break;
+      case "data":
+        if (isEmpty(v) && sameItems(v, p)) continue;
+        if (selfCaused) {
+          if (inst.selfData || sameRows(v, p)) continue;
+          inst.selfData = true;
+        }
+        break;
+      case "columns":
+        if (selfCaused && sameShape(v, p)) continue;
+        break;
+      case "rowKey":
+        if (selfCaused && typeof v === "function" && typeof p === "function") continue;
+        break;
+    }
+    partial ??= {};
+    partial[k] = forward;
+  }
+  if (partial === void 0) return;
+  inst.syncing = true;
+  try {
+    inst.table.setOptions(partial);
+  } finally {
+    inst.syncing = false;
+  }
+  const synced = { ...prev };
+  for (const k of Object.keys(partial)) synced[k] = options[k];
+  inst.synced = synced;
+}
+function deliver(inst) {
+  const queue = inst.queue;
+  if (queue === void 0) return;
+  inst.queue = void 0;
+  const sink = inst.latest.onDiagnostic;
+  for (const d of queue) {
+    try {
+      sink?.(d);
+    } catch (e) {
+      console.error("[DataKable] onDiagnostic threw", e);
+    }
+  }
+}
+var isObject = (v) => v !== null && typeof v === "object";
+function sameSlices(a, b) {
+  if (!isObject(a) || !isObject(b)) return false;
+  const defined = (o) => Object.keys(o).filter((k) => o[k] !== void 0);
+  const keys = defined(a);
+  if (keys.length !== defined(b).length) return false;
+  for (const k of keys) if (!Object.is(a[k], b[k])) return false;
+  return true;
+}
+var isEmpty = (v) => Array.isArray(v) && v.length === 0;
+function sameItems(a, b) {
+  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) if (!Object.is(a[i], b[i])) return false;
+  return true;
+}
+function sameRows(a, b) {
+  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    const x = a[i];
+    const y = b[i];
+    if (Object.is(x, y)) continue;
+    if (!isObject(x) || !isObject(y)) return false;
+    const keys = Object.keys(x);
+    if (keys.length !== Object.keys(y).length) return false;
+    for (const k of keys) if (!Object.hasOwn(y, k) || !Object.is(x[k], y[k])) return false;
+  }
+  return true;
+}
+var loose = (v) => typeof v === "function" || isObject(v);
+function sameShape(a, b) {
+  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    const x = a[i];
+    const y = b[i];
+    if (Object.is(x, y)) continue;
+    if (!isObject(x) || !isObject(y)) return false;
+    const keys = Object.keys(x);
+    if (keys.length !== Object.keys(y).length) return false;
+    for (const k of keys) {
+      if (!Object.hasOwn(y, k)) return false;
+      const vx = x[k];
+      const vy = y[k];
+      if (Object.is(vx, vy)) continue;
+      if (!(loose(vx) && loose(vy) && typeof vx === typeof vy)) return false;
+    }
+  }
+  return true;
+}
+function changedFeatureOption(a, b) {
+  if (!Array.isArray(a) || !Array.isArray(b) || a === b) return void 0;
+  for (let i = 0; i < a.length; i++) {
+    const f = a[i];
+    const g = b[i];
+    if (!f || !g || f === g || f.name !== g.name) continue;
+    if (!(0, import_core.isOptionsDefinition)(f.options) || !(0, import_core.isOptionsDefinition)(g.options)) continue;
+    const fv = f.options.values;
+    const gv = g.options.values;
+    if (!fv || !gv) continue;
+    for (const k of Object.keys(fv)) {
+      if (typeof fv[k] === "function" && fv[k] !== gv[k]) return `features[${i}].${k}`;
+    }
+  }
+  return void 0;
+}
+function checkUnstable(inst, options) {
+  const seen = inst.seen;
+  inst.seen = options;
+  const changed = (k) => !Object.is(options[k], seen[k]);
+  const fn = (k) => changed(k) && typeof options[k] === "function" && typeof seen[k] === "function";
+  track(inst, "columns", changed("columns") && sameShape(options.columns, seen.columns));
+  track(inst, "data", changed("data") && sameRows(options.data, seen.data));
+  track(inst, "fetcher", fn("fetcher"));
+  track(inst, "rowKey", fn("rowKey"));
+  const option = changedFeatureOption(options.features, seen.features);
+  track(inst, "features", option !== void 0, option);
+}
+function track(inst, key, unstable, option = key) {
+  const n = unstable ? (inst.unstable.get(key) ?? 0) + 1 : 0;
+  inst.unstable.set(key, n);
+  if (n < UNSTABLE_AFTER || inst.warned.has(key)) return;
+  inst.warned.add(key);
+  if (key === "columns") (0, import_core.emitTableDiagnostic)(inst.table, "DK_UNSTABLE_COLUMNS", { renders: n });
+  else (0, import_core.emitTableDiagnostic)(inst.table, "DK_UNSTABLE_OPTION", { option, renders: n });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useDataTable
+});
+//# sourceMappingURL=use-data-table.cjs.map

package/dist/use-data-table.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-data-table.ts","../package.json"],"sourcesContent":["'use client'\n\nimport {\n  type AnyFeature,\n  type ApiOf,\n  type ColumnDef,\n  type CreateTableOptions,\n  createDeferred,\n  createTable,\n  type Diagnostic,\n  emitTableDiagnostic,\n  type InvalidRowsMode,\n  isOptionsDefinition,\n  keepDiagnostics,\n  type RowModel,\n  registerPackage,\n  type SchemaRow,\n  SERVER_SOURCE,\n  startTable,\n  type Table,\n  type TableSchema,\n  type TableState,\n  type TableStateFor,\n} from '@datakable/core'\nimport {\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useInsertionEffect,\n  useLayoutEffect,\n  useReducer,\n  useRef,\n  useSyncExternalStore,\n} from 'react'\nimport { version } from '../package.json'\nimport { reactDiagnostics } from './codes'\n\n// Registers the (development-only) definitions where they are emitted, so bundlers keep them.\nkeepDiagnostics(reactDiagnostics)\n\n// No @types/node here: declare just what is read.\ndeclare const process: { env: { NODE_ENV?: string } }\n\n/** No layout effects on the server (React 18 warns about them there). */\nconst useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect\n\n/**\n * `useDataTable` options: `createTable`'s (§3.2), with `cell` / `invalidCell` returning a\n * `ReactNode` (§10). Read once, at creation: `features`, `schema`, `invalidRows`, `initialState`,\n * `name`, `timeout`, `strict`, `diagnostics`. Every other option follows the latest render.\n */\nexport type UseDataTableOptions<\n  T,\n  S extends TableState = TableState,\n  Sch = undefined,\n  M extends InvalidRowsMode = 'drop',\n> = Omit<CreateTableOptions<T, S, Sch, M>, 'columns'> & {\n  /**\n   * Compared by reference (§10): a new array tells the table the columns changed. Define them\n   * outside the component or memoise them (`DK_UNSTABLE_COLUMNS` in development).\n   */\n  columns?: readonly ColumnDef<SchemaRow<T, Sch>, ReactNode>[]\n}\n\n/**\n * What `useDataTable` returns: the table (its methods and the installed features' APIs) with the\n * `state` and `rowModel` of this render. A new object whenever the table notifies, so it can be a\n * dependency of `useMemo` / `memo` children; the same object while nothing changed.\n */\nexport type UseDataTableResult<\n  T,\n  S extends TableState = TableState,\n  M extends InvalidRowsMode = 'drop',\n  In = T,\n  Api = unknown,\n> = Table<T, S, M, In> &\n  Api & {\n    /** The state snapshot of this render (`getState()`). */\n    readonly state: S\n    /** The row model of this render (`getRowModel()`, §6.6): rows, counts, status. */\n    readonly rowModel: RowModel<T, M>\n  }\n\ntype Options = Record<string, unknown> & { features?: readonly AnyFeature[] }\ntype AnyTable = Table<unknown, TableState> & Record<string, unknown>\ntype Callback = (arg: never) => unknown\n\n/** Options forwarded through `setOptions` when they change; the rest are read once (§3.4). */\nconst SYNCED = [\n  'data',\n  'columns',\n  'rowKey',\n  'state',\n  'onStateChange',\n  'interceptors',\n  'onDiagnostic',\n  'fetcher',\n  'rowCount',\n] as const\n\n/** Given to the table as stable wrappers that call the latest prop (latest-ref). */\nconst CALLBACKS = ['onStateChange', 'onDiagnostic', 'fetcher'] as const\ntype CallbackKey = (typeof CALLBACKS)[number]\n\n/** Renders in a row with a new reference before `DK_UNSTABLE_*` is reported. */\nconst UNSTABLE_AFTER = 2\n\ninterface Instance {\n  table: AnyTable\n  destroyed: boolean\n  mounted: boolean\n  /** The options of the latest committed render (what the wrappers call). */\n  latest: Options\n  /** The option values the table has (user values; callbacks count by presence). */\n  synced: Options\n  readonly wrappers: Record<CallbackKey, Callback>\n  /** `onDiagnostic` calls made while rendering, delivered after the commit. */\n  queue: Diagnostic[] | undefined\n  rendering: number\n  /** Inside the hook's own `setOptions` call. */\n  syncing: boolean\n  /** That call notified: the next commit is the re-render it caused. */\n  selfCaused: boolean\n  /**\n   * `data` was forwarded in a self-caused re-render. Rows that differ on every render (nested\n   * objects, computed fields) would otherwise ingest → notify → re-render forever: the next\n   * self-caused re-render keeps the data the table has.\n   */\n  selfData: boolean\n  /** Notifications seen; part of the view cache key (a notification is never silent, §6.6). */\n  version: number\n  view: { table: AnyTable; version: number; value: object } | undefined\n  /**\n   * SSR (§7.2): the view of `table` at its creation — initial state, controlled state and data /\n   * initialData, no async result (the table is created deferred). `getServerSnapshot`.\n   */\n  server: { table: AnyTable; value: object } | undefined\n  /** React read `getServerSnapshot` on the client: this render hydrates server HTML. */\n  hydrating: boolean\n  // Dev: DK_UNSTABLE_* bookkeeping.\n  /** The options of the previous committed render. */\n  seen: Options\n  unstable: Map<string, number>\n  warned: Set<string>\n}\n\nlet registered = false\n\n/**\n * Binds a table to a component (§10): the table is created once per component instance and\n * destroyed on unmount; renders read it through `useSyncExternalStore` (with\n * `getServerSnapshot`), and options are synced with `table.setOptions` in a layout effect, never\n * during render.\n *\n * - `features` (and the other read-once options) are read at creation: a new inline `features`\n *   array never recreates the table.\n * - `fetcher`, `onStateChange` and `onDiagnostic` may be inline functions: the table always calls\n *   the latest one, and a new reference never refetches (call `refetch()` when a value the fetcher\n *   reads changes).\n * - `columns`, `data` and a `rowKey` function are compared by reference: memoise them.\n * - Controlled slices (§3.2): pass `state` and `onStateChange`; changes come back through `state`.\n * - SSR (§7.2): rendering starts no async work. The fetcher's first request and a `searchFn` for an\n *   initial query start after the commit (`status: 'pending'` until then; `DK_SSR_ASYNC_DEFERRED`\n *   on the server), unless `initialData` already holds their result. `initialState` (e.g. parsed\n *   from the URL) applies on the server: client-mode features filter / search / sort the HTML.\n *   `getServerSnapshot` is the view at creation; a table that changed before the hydration commit\n *   reports `DK_HYDRATION_MISMATCH`.\n *\n * `@datakable/react` installs no features by default; `datakable`'s `useDataTable` installs the\n * default preset.\n */\nexport function useDataTable<\n  T,\n  S extends TableState = never,\n  const Fs extends readonly AnyFeature[] = [],\n  const Sch extends TableSchema | undefined = undefined,\n  const M extends InvalidRowsMode = 'drop',\n>(\n  options: UseDataTableOptions<T, TableStateFor<S, Fs, SchemaRow<T, Sch>>, Sch, M> & {\n    features?: Fs\n  },\n): UseDataTableResult<\n  SchemaRow<T, Sch>,\n  TableStateFor<S, Fs, SchemaRow<T, Sch>>,\n  M,\n  [Sch] extends [TableSchema] ? unknown : T,\n  ApiOf<Fs, SchemaRow<T, Sch>>\n>\nexport function useDataTable(options: Options): unknown {\n  const ref = useRef<Instance | null>(null)\n  // Created during the first render (React keeps the ref across the StrictMode double render),\n  // deferred: its async work (fetcher, searchFn) starts in the mount effect, never on the server.\n  if (ref.current === null) ref.current = createInstance(options)\n  const inst = ref.current\n  const table = inst.table\n  const [, rerender] = useReducer((n: number) => n + 1, 0)\n\n  const subscribe = useCallback(\n    (onChange: () => void) => {\n      // Replaced or destroyed meanwhile (`<Activity>`): nothing to subscribe to.\n      if (inst.table !== table || inst.destroyed) return () => {}\n      return table.subscribe(() => {\n        inst.version++\n        if (inst.syncing) inst.selfCaused = true\n        onChange()\n      })\n    },\n    [inst, table],\n  )\n  const getSnapshot = useCallback(() => snapshot(inst, table), [inst, table])\n  const getServerSnapshot = useCallback(() => serverSnapshot(inst, table), [inst, table])\n  const view = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot)\n\n  // Hydration commit (§7.2): before any layout effect can change the table, the snapshot React\n  // hydrated with must still be the live one, else React replaces the server HTML at once.\n  useInsertionEffect(() => checkHydration(inst), [inst])\n\n  useIsomorphicLayoutEffect(() => {\n    inst.mounted = true\n    // Destroyed while hidden (`<Activity>`): a new table, from the latest options.\n    if (inst.destroyed) {\n      recreate(inst)\n      startTable(inst.table)\n      rerender()\n    } else {\n      // The deferred fetch / searchFn starts now; its status shows before paint.\n      startTable(inst.table)\n      if (snapshot(inst, inst.table) !== view) rerender()\n    }\n    return () => {\n      inst.mounted = false\n      // Deferred: the StrictMode effect re-run mounts again synchronously and keeps the table.\n      queueMicrotask(() => {\n        if (inst.mounted || inst.destroyed) return\n        inst.destroyed = true\n        inst.table.destroy()\n      })\n    }\n  }, [inst])\n\n  useIsomorphicLayoutEffect(() => {\n    inst.latest = options\n    const selfCaused = inst.selfCaused\n    inst.selfCaused = false\n    if (!inst.destroyed) sync(inst, options, selfCaused)\n    deliver(inst)\n  })\n\n  return view\n}\n\nfunction createInstance(options: Options): Instance {\n  const inst: Instance = {\n    table: undefined as unknown as AnyTable,\n    destroyed: false,\n    mounted: false,\n    latest: options,\n    synced: options,\n    wrappers: {\n      onStateChange: (updater) => (inst.latest.onStateChange as Callback)(updater),\n      onDiagnostic: (d: Diagnostic) => {\n        if (inst.rendering === 0) {\n          ;(inst.latest.onDiagnostic as ((d: Diagnostic) => void) | undefined)?.(d)\n          return\n        }\n        if (inst.queue === undefined) {\n          inst.queue = []\n          // Delivered by the next layout effect, or here when this render never commits.\n          queueMicrotask(() => deliver(inst))\n        }\n        inst.queue.push(d)\n      },\n      fetcher: (params) => (inst.latest.fetcher as Callback)(params),\n    },\n    queue: undefined,\n    rendering: 0,\n    syncing: false,\n    selfCaused: false,\n    selfData: false,\n    version: 0,\n    view: undefined,\n    server: undefined,\n    hydrating: false,\n    seen: options,\n    unstable: new Map(),\n    warned: new Set(),\n  }\n  // The version checks are development-only (§8.5): production bundles no registry.\n  if (process.env.NODE_ENV !== 'production' && !registered) {\n    registered = true\n    registerPackage('@datakable/react', version)\n  }\n  build(inst, options)\n  return inst\n}\n\n/**\n * The stable wrapper of callback `k`. The fetcher's also carries the server source of the user's\n * `withFetcher` fetcher (§7.1), which is what makes the table load through it.\n */\nfunction wrapper(inst: Instance, k: CallbackKey, v: unknown): Callback {\n  const w = inst.wrappers[k]\n  if (k === 'fetcher') {\n    ;(w as unknown as Record<symbol, unknown>)[SERVER_SOURCE] = (v as Record<symbol, unknown>)[\n      SERVER_SOURCE\n    ]\n  }\n  return w\n}\n\nfunction build(inst: Instance, options: Options) {\n  const init: Options = { ...options }\n  for (const k of CALLBACKS) {\n    if (typeof options[k] === 'function') init[k] = wrapper(inst, k, options[k])\n  }\n  inst.rendering++\n  try {\n    // Deferred (§7.2): rendering starts no fetch / searchFn (none at all on the server, where\n    // effects never run); the mount effect starts it.\n    inst.table = createDeferred(() => createTable(init as never)) as unknown as AnyTable\n  } finally {\n    inst.rendering--\n  }\n  inst.synced = options\n  inst.seen = options\n  inst.view = undefined\n  inst.server = undefined\n}\n\nfunction recreate(inst: Instance) {\n  build(inst, inst.latest)\n  inst.destroyed = false\n}\n\n/** The view of the table's snapshot, cached on (table, state, row model, notifications). */\nfunction snapshot(inst: Instance, table: AnyTable): object {\n  inst.rendering++\n  try {\n    const state = table.getState()\n    const rowModel = table.getRowModel()\n    const v = inst.view\n    if (v && v.table === table && v.version === inst.version) {\n      const value = v.value as { state: unknown; rowModel: unknown }\n      if (value.state === state && value.rowModel === rowModel) return value\n    }\n    const value = Object.create(table, {\n      state: { value: state, enumerable: true },\n      rowModel: { value: rowModel, enumerable: true },\n    }) as object\n    inst.view = { table, version: inst.version, value }\n    return value\n  } finally {\n    inst.rendering--\n  }\n}\n\n/**\n * `getServerSnapshot` (§7.2): the view of the table at its creation. React reads it on the server\n * and while hydrating, so both render the same snapshot; async work never ran in it.\n */\nfunction serverSnapshot(inst: Instance, table: AnyTable): object {\n  if (inst.table !== table) return snapshot(inst, table)\n  // On the client React reads it only to hydrate.\n  if (typeof window !== 'undefined') inst.hydrating = true\n  const s = inst.server\n  if (s && s.table === table) return s.value\n  const value = snapshot(inst, table)\n  inst.server = { table, value }\n  return value\n}\n\n/** `DK_HYDRATION_MISMATCH`: what differs between the hydrated (server) view and the live one. */\nfunction checkHydration(inst: Instance) {\n  if (!inst.hydrating) return\n  inst.hydrating = false\n  const server = inst.server\n  if (!server || server.table !== inst.table) return\n  const live = snapshot(inst, inst.table) as { state: TableState; rowModel: unknown }\n  const hydrated = server.value as { state: TableState; rowModel: unknown }\n  if (live === hydrated) return\n  const slices: string[] = []\n  for (const k of new Set([...Object.keys(hydrated.state), ...Object.keys(live.state)])) {\n    if (!Object.is(hydrated.state[k], live.state[k])) slices.push(k)\n  }\n  if (slices.length === 0) {\n    if (live.rowModel === hydrated.rowModel) return\n    slices.push('rows')\n  }\n  // Delivered to onDiagnostic by the layout effect (no update during the commit).\n  inst.rendering++\n  try {\n    emitTableDiagnostic(\n      inst.table,\n      'DK_HYDRATION_MISMATCH',\n      { slices },\n      { trigger: 'hydrate', phase: 'hydrate' },\n    )\n  } finally {\n    inst.rendering--\n  }\n}\n\n/**\n * Forwards the changed options with one `setOptions` call. In the re-render caused by that call,\n * values recomputed from the same inputs (same-shape `columns`, `data` with equal rows, a `rowKey`\n * function) are not forwarded again: an inline `columns` / `data` would otherwise loop. A `data`\n * that still differs is forwarded at most once per chain of self-caused re-renders, so rows that\n * are new on every render (`data: [{ … }]` with nested objects) re-ingest but never hang.\n */\nfunction sync(inst: Instance, options: Options, selfCaused: boolean) {\n  // Written out (not a module-level flag) so bundlers fold it while parsing (§8.2).\n  if (process.env.NODE_ENV !== 'production') checkUnstable(inst, options)\n  const prev = inst.synced\n  if (!selfCaused) inst.selfData = false\n  let partial: Record<string, unknown> | undefined\n  for (const k of SYNCED) {\n    const v = options[k]\n    const p = prev[k]\n    if (Object.is(v, p)) continue\n    let forward: unknown = v\n    switch (k) {\n      case 'onStateChange':\n      case 'onDiagnostic':\n      case 'fetcher': {\n        const on = typeof v === 'function'\n        if (on === (typeof p === 'function')) continue\n        forward = on ? wrapper(inst, k, v) : undefined\n        break\n      }\n      case 'state':\n        if (sameSlices(v, p)) continue\n        break\n      case 'interceptors':\n        if (sameItems(v, p)) continue\n        break\n      case 'data':\n        // Two empty arrays hold nothing to ingest (e.g. an inline `data: []` with a fetcher).\n        if (isEmpty(v) && sameItems(v, p)) continue\n        if (selfCaused) {\n          if (inst.selfData || sameRows(v, p)) continue\n          inst.selfData = true\n        }\n        break\n      case 'columns':\n        if (selfCaused && sameShape(v, p)) continue\n        break\n      case 'rowKey':\n        if (selfCaused && typeof v === 'function' && typeof p === 'function') continue\n        break\n    }\n    partial ??= {}\n    partial[k] = forward\n  }\n  if (partial === undefined) return\n  inst.syncing = true\n  try {\n    inst.table.setOptions(partial)\n  } finally {\n    inst.syncing = false\n  }\n  const synced = { ...prev }\n  for (const k of Object.keys(partial)) synced[k] = options[k]\n  inst.synced = synced\n}\n\n/** Delivers the `onDiagnostic` calls queued while rendering. */\nfunction deliver(inst: Instance) {\n  const queue = inst.queue\n  if (queue === undefined) return\n  inst.queue = undefined\n  const sink = inst.latest.onDiagnostic as ((d: Diagnostic) => void) | undefined\n  for (const d of queue) {\n    try {\n      sink?.(d)\n    } catch (e) {\n      // Like a failing sink in the hub: the logger never breaks the table.\n      console.error('[DataKable] onDiagnostic threw', e)\n    }\n  }\n}\n\n// --- comparisons ---------------------------------------------------------------------------------\n\nconst isObject = (v: unknown): v is Record<string, unknown> => v !== null && typeof v === 'object'\n\n/** Controlled slices: the same defined slices, each `Object.is`-equal. */\nfunction sameSlices(a: unknown, b: unknown): boolean {\n  if (!isObject(a) || !isObject(b)) return false\n  const defined = (o: Record<string, unknown>) => Object.keys(o).filter((k) => o[k] !== undefined)\n  const keys = defined(a)\n  if (keys.length !== defined(b).length) return false\n  for (const k of keys) if (!Object.is(a[k], b[k])) return false\n  return true\n}\n\nconst isEmpty = (v: unknown) => Array.isArray(v) && v.length === 0\n\n/** Two arrays with the same items (by reference). */\nfunction sameItems(a: unknown, b: unknown): boolean {\n  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false\n  for (let i = 0; i < a.length; i++) if (!Object.is(a[i], b[i])) return false\n  return true\n}\n\n/**\n * Two arrays of equal rows: each pair the same reference, or objects with the same own keys and\n * `Object.is`-equal values (`data: rows.map((r) => ({ ...r }))` recomputed in a re-render).\n */\nfunction sameRows(a: unknown, b: unknown): boolean {\n  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false\n  for (let i = 0; i < a.length; i++) {\n    const x: unknown = a[i]\n    const y: unknown = b[i]\n    if (Object.is(x, y)) continue\n    if (!isObject(x) || !isObject(y)) return false\n    const keys = Object.keys(x)\n    if (keys.length !== Object.keys(y).length) return false\n    for (const k of keys) if (!Object.hasOwn(y, k) || !Object.is(x[k], y[k])) return false\n  }\n  return true\n}\n\nconst loose = (v: unknown) => typeof v === 'function' || isObject(v)\n\n/**\n * Column arrays of the same shape: same length, same keys per column and equal primitive values;\n * functions and nested objects (`format`, `cell`, `filter`, …) may be new references.\n */\nfunction sameShape(a: unknown, b: unknown): boolean {\n  if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false\n  for (let i = 0; i < a.length; i++) {\n    const x: unknown = a[i]\n    const y: unknown = b[i]\n    if (Object.is(x, y)) continue\n    if (!isObject(x) || !isObject(y)) return false\n    const keys = Object.keys(x)\n    if (keys.length !== Object.keys(y).length) return false\n    for (const k of keys) {\n      if (!Object.hasOwn(y, k)) return false\n      const vx = x[k]\n      const vy = y[k]\n      if (Object.is(vx, vy)) continue\n      if (!(loose(vx) && loose(vy) && typeof vx === typeof vy)) return false\n    }\n  }\n  return true\n}\n\n// --- dev: DK_UNSTABLE_COLUMNS / DK_UNSTABLE_OPTION -----------------------------------------------\n\n/** The first function option of a feature that is a new reference: `features[i].<option>`. */\nfunction changedFeatureOption(a: unknown, b: unknown): string | undefined {\n  if (!Array.isArray(a) || !Array.isArray(b) || a === b) return undefined\n  for (let i = 0; i < a.length; i++) {\n    const f = a[i] as AnyFeature | undefined\n    const g = b[i] as AnyFeature | undefined\n    if (!f || !g || f === g || f.name !== g.name) continue\n    if (!isOptionsDefinition(f.options) || !isOptionsDefinition(g.options)) continue\n    const fv = f.options.values\n    const gv = g.options.values\n    if (!fv || !gv) continue\n    for (const k of Object.keys(fv)) {\n      if (typeof fv[k] === 'function' && fv[k] !== gv[k]) return `features[${i}].${k}`\n    }\n  }\n  return undefined\n}\n\n/** Counts renders in a row that pass a new reference for the same thing; reports each once. */\nfunction checkUnstable(inst: Instance, options: Options) {\n  const seen = inst.seen\n  inst.seen = options\n  const changed = (k: string) => !Object.is(options[k], seen[k])\n  const fn = (k: string) =>\n    changed(k) && typeof options[k] === 'function' && typeof seen[k] === 'function'\n  track(inst, 'columns', changed('columns') && sameShape(options.columns, seen.columns))\n  track(inst, 'data', changed('data') && sameRows(options.data, seen.data))\n  track(inst, 'fetcher', fn('fetcher'))\n  track(inst, 'rowKey', fn('rowKey'))\n  const option = changedFeatureOption(options.features, seen.features)\n  track(inst, 'features', option !== undefined, option)\n}\n\nfunction track(inst: Instance, key: string, unstable: boolean, option = key) {\n  const n = unstable ? (inst.unstable.get(key) ?? 0) + 1 : 0\n  inst.unstable.set(key, n)\n  if (n < UNSTABLE_AFTER || inst.warned.has(key)) return\n  inst.warned.add(key)\n  if (key === 'columns') emitTableDiagnostic(inst.table, 'DK_UNSTABLE_COLUMNS', { renders: n })\n  else emitTableDiagnostic(inst.table, 'DK_UNSTABLE_OPTION', { option, renders: n })\n}\n","{\n  \"name\": \"@datakable/react\",\n  \"version\": \"1.0.1\",\n  \"description\": \"React bindings for DataKable — useDataTable hook and DataTable component.\",\n  \"license\": \"MIT\",\n  \"author\": \"Supakit Kitjanabumrungsak\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/Ink01101011/datakable.git\",\n    \"directory\": \"packages/react\"\n  },\n  \"homepage\": \"https://github.com/Ink01101011/datakable#readme\",\n  \"bugs\": \"https://github.com/Ink01101011/datakable/issues\",\n  \"keywords\": [\n    \"react\",\n    \"datatable\",\n    \"table\",\n    \"data-grid\",\n    \"typescript\",\n    \"type-safe\",\n    \"headless\"\n  ],\n  \"type\": \"module\",\n  \"sideEffects\": [\n    \"./dist/styles.css\"\n  ],\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"import\": {\n        \"types\": \"./dist/index.d.ts\",\n        \"default\": \"./dist/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/index.d.cts\",\n        \"default\": \"./dist/index.cjs\"\n      }\n    },\n    \"./styles.css\": \"./dist/styles.css\",\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"typecheck\": \"tsc -p tsconfig.json\",\n    \"check:pkg\": \"publint --strict && attw --pack . --profile node16 --exclude-entrypoints styles.css && node scripts/check-catalog.mjs\",\n    \"check:catalog\": \"node scripts/check-catalog.mjs\"\n  },\n  \"dependencies\": {\n    \"@datakable/core\": \"workspace:^\"\n  },\n  \"peerDependencies\": {\n    \"react\": \">=18\"\n  }\n}\n"],"mappings":"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","names":["value"]}