@altertable/data-app 0.59.1

package/docs/react.md

@@ -0,0 +1,248 @@
+# React
+
+Import hooks, components, and UI helpers from `@altertable/data-app/react`.
+Import `@altertable/data-app/react/styles.css` once in the browser entry.
+React 19.2 or newer and React DOM 19.2 or newer are peer dependencies.
+
+`mountDataApp({ config, component })` mounts into `#root`, sets the document
+title and language, attaches navigation to an available iframe transport, and
+installs `DataAppProvider`. When mounting through another
+framework, wrap the app in `DataAppProvider` yourself.
+
+## Find UI by task
+
+All of these APIs are exported from `/react`. Each component's stylesheet lives beside its implementation.
+
+| Task                                              | Start here                                                                                                                                                                                                       | Related APIs                                                                                                                                                                                                                                       |
+| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Primary request and page shell                    | [DataApp](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/DataApp.tsx)                                                                                                                          | AppLayout, AppHeader, AppToolbar, AppFooter, AppScope, ThemeToggle                                                                                                                                                                                 |
+| Initial connection check                          | [GettingStarted](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/GettingStarted.tsx)                                                                                                            | Pair with `connectionCheck()` from `/contract`                                                                                                                                                                                                     |
+| Arrange content                                   | [Grid](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/Grid.tsx), [Stack](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/Stack.tsx)                                           | DataWidget                                                                                                                                                                                                                                         |
+| Show a key number                                 | [MetricWidget](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/MetricWidget.tsx)                                                                                                                | ComparisonVisual                                                                                                                                                                                                                                   |
+| Show charts and collections                       | [VisualizationWidget](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/VisualizationWidget.tsx), [TableWidget](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/TableWidget.tsx) | DataTable, Ranking, Breakdown, chartColor                                                                                                                                                                                                          |
+| Handle a request's loading, error, and stale data | [DataSection](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/DataSection.tsx)                                                                                                                  | DataBoundary, DataViewToast, EmptyState, StatusPanel, Skeleton                                                                                                                                                                                     |
+| Show freshness and refresh                        | [UpdatedAt](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/UpdatedAt.tsx), [AppToolbar](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/AppToolbar.tsx)                       | RefreshRegion, LiveControl                                                                                                                                                                                                                         |
+| Bind filters to the URL                           | [variables](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/variables.ts), [DateRangePicker](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/DateRangePicker.tsx)              | Combobox, PeriodSummary, Tabs, useViewTab                                                                                                                                                                                                          |
+| Search a loaded collection                        | [searchItems](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/searchItems.ts), [SearchMatch](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/SearchMatch.tsx)                  | SearchField                                                                                                                                                                                                                                        |
+| Explain context, glossary, and queries            | [AboutData](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/AboutData.tsx), [DataContext](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/data-context.ts)                     | [GlossaryDefinition](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/GlossaryDefinition.tsx), GlossaryExplanation, [defineDataIdentifiers](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/data-identifiers.tsx) |
+| Present loaded findings                           | [PresentStory](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/PresentStory.tsx)                                                                                                                | StoryFinding                                                                                                                                                                                                                                       |
+| Build custom controls and overlays                | [Button](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/Button.tsx), [Sheet](https://github.com/altertable-ai/data-app/blob/main/src/react/ui/Sheet.tsx)                                       | IconButton, Tooltip, HelpPopover, Kbd                                                                                                                                                                                                              |
+
+## Bound views and widgets
+
+| Definition        | Runtime owns                                                                                                                                     |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `defineOperation` | Input/output validation, check inputs, query limits and cancellation; `query(name, sql)` accepts registered names and records executed evidence. |
+| `defineDataView`  | URL variables, operation input, emptiness and the primary date binding. `useView` connects the result and controls to `DataApp`.                 |
+| `DataApp`         | Header, variable bar, refresh state, stale-result notice and dimming, default inspection empty states.                                           |
+| `view.content`    | One loading/ready layout. `result.select` never evaluates loading data; `result.metric` binds comparisons to the displayed input.                |
+| `context.metric`  | Label, numeric format, glossary evidence and optional direction of improvement.                                                                  |
+| `WidgetViewTabs`  | Valid, unique selection IDs and a required empty state per tab.                                                                                  |
+
+SQL and business definitions belong to the app. Hosted adapters authorize every request; local development can use the CLI proxy. SQL disclosure also requires server permission.
+
+A measured zero and unavailable data have different meanings. Metric readings use `null` for an unavailable previous value. The app defines whether a result is empty. `Breakdown` shows parts of a total; `Ranking` scales against its largest value. Percent formats accept ratios.
+
+## Bind a view
+
+```tsx
+import { createDataClient } from '@altertable/data-app/client';
+import {
+  createDataHooks,
+  dateRangeVariable,
+  DataApp,
+  Grid,
+  MetricWidget,
+  VisualizationWidget,
+  Ranking,
+} from '@altertable/data-app/react';
+import type { operations } from '#app/operations.ts';
+import { calendar } from '#app/contracts.ts';
+import { dataContext, actions } from '#app/data-context.tsx';
+import config from '#config';
+
+const period = dateRangeVariable({
+  key: 'period',
+  contract: calendar,
+  comparison: true,
+  defaultValue: { kind: 'preset', id: 'last-30' },
+});
+const { defineDataView, useView } =
+  createDataHooks(createDataClient<typeof operations>());
+const activityView = defineDataView({
+  operation: 'activity',
+  variables: { period },
+  input: ({ period }) => period,
+  date: { variable: 'period', input: input => input },
+  isEmpty: data => data.features.length === 0,
+  empty: { title: 'No activity in this range' },
+});
+const featureEvidence = dataContext.evidence({
+  id: 'feature-use',
+  queryNames: [dataContext.queryNames.activity],
+});
+const content = activityView.content(result => (
+  <Grid columns={2}>
+    <MetricWidget
+      metric={actions}
+      reading={result.metric(data => ({
+        current: data.count,
+        previous: data.previousCount,
+      }))}
+    />
+    <VisualizationWidget
+      title="Feature use"
+      evidence={featureEvidence}
+      reading={result.select(data => data.features)}
+      isEmpty={features => features.length === 0}
+      empty={{ title: 'No features' }}
+      skeleton={{ variant: 'ranking', rows: 6 }}
+    >
+      {features => <Ranking items={features} />}
+    </VisualizationWidget>
+  </Grid>
+));
+function App() {
+  const activity = useView(activityView);
+  return (
+    <DataApp
+      config={config}
+      dataContext={dataContext}
+      request={activity}
+      {...content}
+    />
+  );
+}
+```
+
+The `date` binding identifies the controlling variable and extracts its range from the operation input. Nested inputs use, for example, `input: (input) => input.period`. The runtime rejects mappings that silently change the selected range or comparison. Non-date views supply `describeInput`; date views can override it when other inputs also need describing.
+
+The shared calendar lives in a browser-safe module:
+
+```ts
+import { defineDateRangeContract } from '@altertable/data-app/contract';
+export const calendar = defineDateRangeContract({
+  minDate: '2026-01-01',
+  maxRangeDays: 90,
+  timeZone: 'UTC',
+});
+// Server operation: input: calendar.parseRequest
+```
+
+`useView` generates controls for date, text and fixed-option select variables; custom controls use `result.variables.bind(name)`. `input` chooses which variables reach the operation, so local search can stay local. The callback in `view.content` receives the displayed result, including its original input during refreshes and failures. Hooks belong in the enclosing component.
+
+`TableWidget` also accepts `reading={result.select((data) => data.rows)}` and optional `skeletonRows`. Columns and empty states are declared once for both loading and ready layouts. Bounded tables default to 10 rows per page with a bottom footer shared with inspection. Set `pagination={{ pageSize: 8 }}` to change the page size or `pagination={false}` to show all rows. Search runs before pagination; the footer counts only the supplied rows. `limit` remains a separate, mutually exclusive display cap. Large catalogs need query-backed pagination with a stable sort and total count.
+
+Bound `VisualizationWidget` and `TableWidget` calls require `evidence` from `context.evidence(...)`. A bound `MetricWidget` gets evidence from its metric definition. Evidence must name at least one glossary entry or query. Static widgets may omit it.
+
+`MetricWidget` and `ComparisonVisual` both accept the same `metric` and `reading`. The comparison is enabled by the displayed result's range. The definition supplies formatting and evidence; a reading cannot override those or provide a second value. `favorableDirection` is optional; changes are neutral until the author defines whether up or down is favorable.
+
+`defineDataContent` remains available for manually managed requests. Its optional `{ date: (input) => rangeRequest }` binds comparison readings. `DataSection` handles independent requests. Low-level widgets, tabs and layout components remain available for custom interfaces.
+
+## Bind evidence
+
+```tsx
+const queries = defineQueryNames({ activity: 'feature-activity' });
+// In the server operation: queryNames: queries
+const identifiers = defineDataIdentifiers({
+  tables: {
+    events: {
+      catalog: 'product_analytics',
+      schema: 'analytics',
+      name: 'events',
+    },
+  },
+  columns: { identity: { table: 'events', name: 'identity_uuid' } },
+});
+const { DataIdentifier } = identifiers;
+const context = createDataContext(queries)({
+  identifiers: identifiers.definitions,
+  description: (
+    <>
+      Explore activity in <DataIdentifier id="tables.events" />.
+    </>
+  ),
+  glossary: {
+    identities: {
+      term: 'Tracked identities',
+      definition: (
+        <>
+          Distinct <DataIdentifier id="columns.events.identity" /> values.
+        </>
+      ),
+      queryNames: [queries.activity],
+    },
+  },
+});
+const evidence = context.evidence({
+  id: 'identities',
+  glossaryIds: ['identities'],
+  queryNames: [queries.activity],
+});
+const actions = context.metric({
+  id: 'actions',
+  glossaryId: 'identities',
+  label: 'Tracked identities',
+  format: { kind: 'count' },
+});
+const finding = context.finding({
+  id: 'activity',
+  headline: 'What people do',
+  visual: <ActivityChart />,
+  evidence: { id: 'activity-evidence', queryNames: [queries.activity] },
+});
+```
+
+Import `defineQueryNames` from `/contract` and the context/identifier factories from `/react`. Use the same registry in `defineOperation({ queryNames: queries, ... })`. Unknown glossary/query references fail type checks and registry validation; the server also validates returned query names. Physical source identity stays in the identifier registry for future linking.
+
+## Authoring constraints
+
+- Date views declare `date: { variable: "period", input: (input) => input }`, or supply `describeInput` for a non-date view.
+- Numeric metrics use `value={count} format={{ kind: "count" }}`. Custom formatted JSX or strings use `content={...}` instead of `value`.
+- Supply `empty` to secondary `DataSection` requests or pass a bound `useView` result. A primary `DataApp` accepts it either from `useView` or as an explicit prop.
+- For alternate views of the same bound result, pass `views={[{ id, label, render }]}` and `viewLabel` to `VisualizationWidget`. Its required `isEmpty` and `empty` apply to the whole result; the widget owns selection. Use `WidgetViewTabs` directly only when views have independent empty states.
+- Variable URL keys cannot use `view`, `about`, `tab`, `present`, or `step`.
+
+## Time views and dimension filters
+
+`createDataHooks(client).defineTimeView` owns the `period` variable, calendar
+controls, and displayed-period label. Declare `time: { contract, defaultValue }`,
+an operation, `isEmpty`, and `empty`. With no additional variables, its default
+input is the calendar request. With additional variables, it is `{ period, ...variables }`.
+Supply an `input` mapper for a different operation shape and `bindings` to extract
+nested period or dimension inputs. Mappings must preserve the selected values.
+
+`dimensionFilter` requires exactly one option source: fixed `options` or a `facet`.
+Use `defineFacetFilter` to bind a facet operation and its typed input. The generated
+`DimensionPicker` preserves cached options during refresh and failure, offers
+missing values separately, and retains selected values absent from a result with
+zero counts. `SelectableBarChart` can share controlled selection with the picker.
+
+## Findings and inspection
+
+`DataWidget` composes a body, toolbar feedback, and footer. Widgets and their
+inspection sheets render the same visual and controls. Keep interactive state
+above both mounts when authoring custom children.
+
+`DataApp.story` receives the displayed snapshot, including its original input
+during refresh or failure. Return one to four `StoryFinding` values with unique
+IDs and registered evidence. `PresentStory` presents those findings directly;
+`context.finding` validates their evidence against the context registry.
+
+### Migration from the earlier runtime
+
+- `DataWidget` replaces the internal `DataPanel` shell and `StorySection` layout.
+- `PresentStory` replaces `PlayStory`; provide `findings` with explicit `evidence`.
+- `context.finding` replaces `context.storyStep`.
+- Table pagination is enabled by default; use `pagination={false}` for complete tables.
+
+## Component gallery
+
+Contributors can preview `/gallery` on the browser fixture server with
+`bun browser-tests/server.ts`. The gallery covers control, widget, request,
+inspection, and narrow-layout defaults. `bun run test:browser` verifies desktop
+and phone interactions. Fixtures are excluded from the published package.
+
+Previous data and evidence are retained only when the input changes within the
+same operation. Switching to another operation shows its own cached response or
+an initial loading/error state; it never inherits another operation's result.

package/docs/releasing.md

@@ -0,0 +1,74 @@
+# Releasing
+
+This repository releases one npm package, `@altertable/data-app`. All public
+entries share its version. Release Please manages `package.json`, the release
+manifest, `CHANGELOG.md`, GitHub tags, and release notes.
+
+## Repository setup
+
+Enable GitHub Actions and allow it to create pull requests. Configure a
+`RELEASE_PLEASE_TOKEN` repository secret with a fine-grained PAT that can write
+repository contents and pull requests. The
+workflow falls back to `GITHUB_TOKEN`, but PRs created or updated with that token
+do not trigger subsequent GitHub Actions workflows. Use the dedicated token
+when requiring CI checks on release PRs.
+
+Configure the npm trusted publisher for `@altertable/data-app`:
+
+| Setting           | Value                                               |
+| ----------------- | --------------------------------------------------- |
+| Provider          | GitHub Actions                                      |
+| Organization      | `altertable-ai`                                     |
+| Repository        | `data-app`                                          |
+| Workflow filename | `release-please.yml`                                |
+| Environment       | Leave empty; the workflow has no GitHub environment |
+
+The publish job grants `id-token: write`, uses npm 11.18.0, and publishes with
+provenance. It uses neither `NPM_TOKEN` nor `NODE_AUTH_TOKEN`. Do not add
+`registry-url` to its `setup-node` step: that creates token authentication
+configuration that interferes with OIDC. See
+[npm trusted publishing](https://docs.npmjs.com/trusted-publishers/).
+
+If the npm package does not exist yet, establish it and configure its trusted
+publisher before expecting automated publication to succeed. Package and npm
+account setup are maintainer actions outside repository CI.
+
+The manifest starts at the imported runtime version `0.59.1`. This records the
+version baseline, not a claim that it is published. Release Please computes the
+next version from release-relevant commits on `main`.
+
+## Release flow
+
+1. Merge Conventional Commits into `main`.
+2. Release Please opens or updates a release PR with the version and changelog.
+3. Review and merge that PR. Release Please creates its `v<version>` tag and
+   GitHub release.
+4. The workflow resolves the tag to a commit SHA and runs the same source,
+   package, and workflow checks against that revision. The publish job checks out
+   that SHA, confirms the tag has not moved, builds, and publishes to npm.
+
+GitHub release creation precedes the publication checks. A failed check blocks
+npm publication and leaves the GitHub release available for a retry.
+
+The publish job checks that the tag matches `package.json`, that the GitHub
+release exists and is not a draft, and that GitHub OIDC is available. An existing
+npm version is skipped. Registry errors other than a missing version stop the
+job rather than being treated as permission to publish.
+
+CodeQL and dependency review are separate workflows. Branch protection can
+require `Source and packed package`, `Validate workflows`, and `Validate PR
+title`, plus the security checks your repository policy requires.
+
+## Retry a failed publication
+
+Run the **Release Please** workflow manually from `main` and enter the existing
+GitHub release tag in its `tag` input. The workflow verifies and publishes that
+tag, rather than the current contents of `main`. Already-published versions are
+skipped, so a retry after a successful publication is safe.
+
+Workflow shell logic lives in `scripts/release/`; Node and Bun versions come
+from `.node-version` and `.bun-version`. The npm version is pinned in
+`scripts/release/setup-npm.sh`.
+
+To validate repository configuration locally, run `bun run check:workflows` and
+`bun run check`. Local checks do not invoke Release Please or publish to npm.

package/docs/server-bun.md

@@ -0,0 +1,26 @@
+# Local Bun server
+
+Import `serveLocalApp` and `localLakehouse` from
+`@altertable/data-app/server/bun`. This entry requires Bun; install `@types/bun`
+when typechecking a Bun app.
+
+```ts
+import { serveLocalApp } from '@altertable/data-app/server/bun';
+import page from './index.html';
+import { operations } from './operations';
+
+serveLocalApp({ page, operations, title: 'Activity' });
+```
+
+The server binds to `127.0.0.1`. Its default port is `25837`, overridable through
+`PORT` or the `port` option. It serves the Bun HTML bundle and operation requests.
+
+`localLakehouse()` reads the CLI proxy URL and token from
+`ALTERTABLE_DATA_PROXY_URL` and `ALTERTABLE_DATA_PROXY_TOKEN`. It also supports
+server-only `ALTERTABLE_LAKEHOUSE_USERNAME` and
+`ALTERTABLE_LAKEHOUSE_PASSWORD`, with an optional `ALTERTABLE_API_BASE`.
+Missing credentials fail the query. Keep these variables out of browser code.
+
+Local serving permits SQL disclosure and does not authenticate hosted viewers.
+Use [the portable server handler](server.md) with per-request authorization when
+hosting an app for other people.

package/docs/server.md

@@ -0,0 +1,47 @@
+# Server
+
+Import `createDataHandler` and the `RequestAccess` type from
+`@altertable/data-app/server`. The handler accepts a Web `Request` and returns a
+`Promise<Response>`. This entry can be imported in Node and Bun without loading
+React or the Bun local-development adapter.
+
+```ts
+import { createDataHandler } from '@altertable/data-app/server';
+import { operations } from './operations';
+
+export const handleDataRequest = createDataHandler(
+  operations,
+  async (request, operation) => {
+    const viewer = await authenticate(request);
+    return {
+      lakehouse: await lakehouseFor(viewer, operation),
+      canDiscloseSql: false,
+    };
+  }
+);
+```
+
+The app supplies `authenticate` and `lakehouseFor`, then routes `/api/data/*`
+requests to the handler. Authorize every viewer and operation, and scope the
+returned lakehouse to the viewer's permitted data. Origin and Fetch Metadata
+checks reject cross-site browser requests; they do not authenticate viewers.
+
+The handler validates operation input and output, enforces query row and duration
+bounds, propagates cancellation, and returns request IDs with errors. SQL is
+disclosed only when both the operation policy and `canDiscloseSql` allow it.
+Keep credentials and operation implementations on the server.
+
+See [operation contracts](contract.md), the [client](client.md), and the
+[local Bun adapter](server-bun.md).
+
+## Request input limits
+
+JSON request bodies are limited to **16,384 encoded bytes**, including multibyte
+UTF-8 content. The handler counts bytes as it reads and cancels remaining
+consumption on overflow; it does not rely on `Content-Length`. Authorization
+runs before reading. Request cancellation interrupts waiting reads. Invalid or
+interrupted bodies return `400/invalid_input`; oversized bodies return
+`413/input_too_large`.
+
+`maxDurationMs` bounds execution after input parsing. It does not add a separate
+body-read deadline. The hosting runtime controls the size of individual chunks.

package/docs/starter-agent-instructions.md

@@ -0,0 +1,51 @@
+# Starter agent instructions
+
+The package ships `AGENTS.md`, public documentation in `docs/`, and declarations
+referenced by its export map. Its agent guide describes package usage and includes
+a separate section for contributors working in the package source repository.
+
+A starter application's `AGENTS.md` owns its file paths, commands, and analysis
+context. Keep it in the consuming app and explicitly direct agents to the
+installed package guide. Dependency instructions are not guaranteed to be loaded
+automatically: for example, [Codex discovers project instructions along the path
+from the project root to its working directory](https://learn.chatgpt.com/docs/agent-configuration/agents-md),
+not by scanning every dependency.
+
+These installed docs replace references to the old vendored `.altertable/runtime`
+layout for apps using this package.
+
+Adapt this template to the starter's actual files and scripts:
+
+```markdown
+# Build this data app
+
+Inspect source data, time coverage, and existing definitions before choosing an
+exploration. Build conclusions from observed results; do not present association
+as cause. Keep copy concise and relevant to the reader.
+
+Read `node_modules/@altertable/data-app/AGENTS.md` first, then
+`node_modules/@altertable/data-app/docs/app-authoring.md`.
+
+| Task                                     | App-owned files                             | Package documentation                  |
+| ---------------------------------------- | ------------------------------------------- | -------------------------------------- |
+| Define queries and inputs                | `src/operations.ts`, shared input contracts | `docs/contract.md`, `docs/server.md`   |
+| Build views, filters, and request states | `src/App.tsx`                               | `docs/react.md`                        |
+| Explain terms and query evidence         | `src/data-context.ts` or `.tsx`             | `docs/react.md#bind-evidence`          |
+| Change identity and brand                | App configuration                           | `docs/config.md`, `docs/appearance.md` |
+| Configure local serving or hosting       | `src/server.ts`                             | `docs/server-bun.md`, `docs/server.md` |
+
+Package documentation paths above are relative to
+`node_modules/@altertable/data-app/`.
+
+Edit app-owned source and import public package entries. Keep SQL and credentials
+on the server, and import operation types with `import type` in browser code.
+Do not edit installed package files. The connectivity screen is scaffolding,
+not an example analysis.
+
+Run the app's typecheck, lint, and build scripts. Inspect its findings and
+interactions at phone and desktop widths, including loading, empty, error, and
+stale states. Verify that the exploration answers the user's question.
+```
+
+The CLI's existing starter remains owned by its repository. Updating its template
+and checks to consume the published package is a separate migration.

package/package.json

@@ -0,0 +1,124 @@
+{
+  "name": "@altertable/data-app",
+  "version": "0.59.1",
+  "description": "Contracts, transport, and React UI for Altertable data apps",
+  "keywords": [
+    "altertable",
+    "analytics",
+    "data-app",
+    "react",
+    "typescript"
+  ],
+  "homepage": "https://github.com/altertable-ai/data-app",
+  "bugs": {
+    "url": "https://github.com/altertable-ai/data-app/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Altertable",
+    "url": "https://altertable.ai"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/altertable-ai/data-app.git"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md",
+    "CONTRIBUTING.md",
+    "AGENTS.md"
+  ],
+  "type": "module",
+  "exports": {
+    "./contract": {
+      "types": "./dist/types/core/contract.d.ts",
+      "import": "./dist/core/contract.js"
+    },
+    "./config": {
+      "types": "./dist/types/core/config.d.ts",
+      "import": "./dist/core/config.js"
+    },
+    "./format": {
+      "types": "./dist/types/core/format.d.ts",
+      "import": "./dist/core/format.js"
+    },
+    "./appearance": {
+      "types": "./dist/types/core/appearance.d.ts",
+      "import": "./dist/core/appearance.js"
+    },
+    "./client": {
+      "types": "./dist/types/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./server": {
+      "types": "./dist/types/server/index.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./server/bun": {
+      "types": "./dist/types/server/local.d.ts",
+      "import": "./dist/local.js"
+    },
+    "./react": {
+      "types": "./dist/types/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./react/styles.css": {
+      "types": "./dist/react.css.d.ts",
+      "default": "./dist/react/index.css"
+    },
+    "./embed": {
+      "types": "./dist/types/embed/index.d.ts",
+      "import": "./dist/embed/index.js"
+    },
+    "./bootstrap": {
+      "default": "./dist/bootstrap.js"
+    },
+    "./react/embed": {
+      "types": "./dist/types/react/embed/index.d.ts",
+      "import": "./dist/react/embed/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "bun run scripts/build.ts && tsc -p tsconfig.build.json && bun run scripts/build-declarations.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint --type-aware src tests scripts browser-tests",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "test": "bun test ./tests",
+    "check": "bun run typecheck && bun run lint && bun run format:check && bun run test && bun run build && bun run test:package",
+    "test:package": "bun run scripts/check-package.ts",
+    "check:workflows": "bash scripts/check-workflows.sh",
+    "test:browser": "playwright test --config browser-tests/playwright.config.ts",
+    "lint:fix": "oxlint --type-aware --fix src tests scripts browser-tests"
+  },
+  "dependencies": {
+    "@floating-ui/react": "0.27.20",
+    "@internationalized/date": "3.12.4",
+    "@tanstack/react-query": "5.104.0",
+    "fuzzysort": "4.0.2",
+    "lucide-react": "1.48.0",
+    "react-aria-components": "1.21.1"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.63.0",
+    "@types/bun": "1.4.2",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "oxfmt": "0.70.0",
+    "oxlint": "1.85.0",
+    "oxlint-tsgolint": "7.0.2003",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "typescript": "7.0.2"
+  },
+  "peerDependencies": {
+    "react": ">=19.2.0",
+    "react-dom": ">=19.2.0"
+  },
+  "packageManager": "bun@1.4.2"
+}