@artkit-ai/react 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,146 @@
-# Temporary Holding Version
+# @artkit-ai/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React layer for [artkit](../../docs/spec.md) artifacts (spec §13): provider, read-only views, kind editor host, assistant-style panel, chat card, approval screen, version diff, hooks and streaming preview.
+
+The React layer never touches a store. It talks to an `ArtifactClient`: HTTP against the `@artkit-ai/node` routes, or an in-process `ArtifactService` for playgrounds, tests and local apps.
+
+## Install
+
+```bash
+pnpm add @artkit-ai/react @artkit-ai/core react react-dom
+# plus the kinds you show, e.g.
+pnpm add @artkit-ai/kind-document
+```
+
+Requires React 19.
+
+## Provider
+
+```tsx
+import { createRegistry } from '@artkit-ai/core';
+import { documentKind } from '@artkit-ai/kind-document';
+import { ArtifactProvider, createHttpClient } from '@artkit-ai/react';
+
+const registry = createRegistry({ kinds: [documentKind] });
+const client = createHttpClient({
+  baseUrl: '/api/artifacts',
+  headers: () => ({ Authorization: `Bearer ${token()}` }),
+});
+
+const loaders = {
+  // Renderers load the first time a kind is shown.
+  renderers: {
+    document: () =>
+      import('@artkit-ai/kind-document/react').then((m) => ({
+        Renderer: m.DocumentRenderer,
+        css: m.documentCss,
+      })),
+  },
+  // Editors load only when the user enters edit mode (spec §13.6).
+  editors: {
+    document: () => import('@artkit-ai/kind-document/edit').then((m) => ({ Editor: m.DocumentEditor })),
+  },
+  // Exporters with runtime 'any' | 'browser' run in the browser; other formats go through the server.
+  exporters: {
+    document: () => import('@artkit-ai/kind-document/export').then((m) => m.documentExporters),
+  },
+};
+
+export function App() {
+  return (
+    <ArtifactProvider
+      registry={registry}
+      client={client}
+      loaders={loaders}
+      locale="pt-BR"
+      exportFormats={{ document: ['pdf'] }}
+    >
+      {/* … */}
+    </ArtifactProvider>
+  );
+}
+```
+
+| Prop                            | Purpose                                                                             |
+| ------------------------------- | ----------------------------------------------------------------------------------- |
+| `registry`                      | Core registry; kinds provide `parsePartial`, `apply`, `project`, `diff`, `lint`.    |
+| `client`                        | `createHttpClient(...)` or `createServiceClient(service, scope)`.                   |
+| `loaders`                       | Lazy `renderers`, `editors`, `exporters` per kind. Read once per kind.              |
+| `locale`                        | UI locale (`pt-BR` and `en` built in). Artifacts keep their own locale for content. |
+| `messages`                      | Extra or overriding UI strings per locale (`{ es: { tabHistory: 'Historial' } }`).  |
+| `theme`, `themes`, `darkThemes` | Application theme, extra artifact themes, explicit dark variants.                   |
+| `colorScheme`                   | `system` (default, follows `prefers-color-scheme`), `light` or `dark`.              |
+| `resolveAssetUrl`, `assets`     | Asset lookup for renderers and for browser exports.                                 |
+| `exportFormats`                 | Formats the server can export, per kind (shown in the export menu).                 |
+| `injectStyles`, `nonce`         | Disable CSS injection, or pass a CSP nonce.                                         |
+
+Without a renderer loader a kind is shown as formatted JSON; without an editor loader `ArtifactEditor` falls back to `ArtifactView`.
+
+## Components
+
+```tsx
+<ArtifactCard artifact={summary} onOpen={(a) => setOpen(a.id)} streaming={isStreaming} />
+<ArtifactPanel id={openId} permission="edit" onClose={() => setOpen(undefined)} />
+<ArtifactView artifact={artifact} />
+<ArtifactView kind="document" partial={streamedJsonOrObject} />
+<ArtifactEditor id={id} groupingWindowMs={600} onCommitted={(r) => console.log(r.version)} />
+<ArtifactApproval id={id} onApproved={…} onRejected={(a, reason) => …} />
+<ArtifactVersionDiff id={id} from={3} to={5} defaultLayout="split" />
+```
+
+- **`ArtifactView`**: read-only by kind. Takes `artifact`, or `id` (+ `version`). `partial` accepts a partial object or the raw JSON text streamed so far (parsed with `parsePartialJson`, then `kind.parsePartial`); it renders with a "provisional" badge and is replaced as soon as a newer committed version arrives (spec §13.4).
+- **`ArtifactEditor`**: hosts the kind editor (see below). `permission="read"`, a missing editor loader or `lockedBy` (another actor holds the lock; `partial` then shows the streaming preview) render the view instead.
+- **`ArtifactPanel`**: View / Code (formatted JSON, read-only) / History tabs, version selector, export menu, status badge and lifecycle actions (submit, approve, reject with reason, publish, archive). Tabs and menus follow the WAI-ARIA keyboard patterns.
+- **`ArtifactCard`**: compact card for chat messages: title, kind, version, status, open action (button or `href`).
+- **`ArtifactApproval`**: diff of the pending version against `meta.publishedVersion` (or the previous version) with approve and reject (reason required by default).
+- **`ArtifactVersionDiff`**: structural `ChangeSummary` list from `kind.diff` plus a highlighted or side-by-side line diff of the full projections.
+
+## Editor host
+
+Kind editors receive `EditorBindings` and only emit operations. `ArtifactEditor` (backed by the framework-free `EditorSession`) provides, for every kind:
+
+1. **Grouping** — operations emitted with `{ kind: 'typing' }` are coalesced within `groupingWindowMs` (default 600 ms, capped at 5 s of continuous typing); discrete operations and the end of continuous gestures flush immediately. Typing is also flushed on blur and unmount.
+2. **Optimistic apply** with the kind's own logic (`applyOperations`); invalid operations are rejected locally. Batches are sent one at a time with `baseVersion`. On rejection the editor rolls back to the last confirmed version and shows the error.
+3. **Undo/redo** (buttons, `Ctrl/⌘+Z`, `Ctrl/⌘+Shift+Z`, `Ctrl+Y`) over the user's own batches. Kinds have no inverse operations, so **undo sends `replace_content` with the content before the batch** (plus `set_title`/`set_theme`/`set_locale` when those changed); each undo/redo is a new version (spec §8.5). When the artifact changed after the batch (e.g. the agent edited it), undo becomes a conflict instead of silently discarding the newer change.
+4. **Concurrent edits** — newer versions arriving while editing rebase the pending local operations. On `VERSION_CONFLICT` (or a rebase that no longer applies) the editor shows what changed and offers **Keep agent version** or **Reapply my edit**.
+5. **Locks** — a `LOCKED` rejection makes the editor read-only until the lock expires; the `lockedBy` prop does the same up front.
+6. **Permissions** — `permission="read" | "edit"` (comment mode is phase 3).
+7. **Accessibility** — keyboard operation, visible focus, live-region announcements (saved, undone, conflict, rejection).
+
+Ids generated by the server for operations without explicit ids match the local ones only when nothing else changed in between; editors should pass explicit ids for new items.
+
+## Hooks
+
+```ts
+const { artifact, loading, error, refresh } = useArtifact(id, { version, initial });
+const { entries, hasMore, loadMore, restore } = useArtifactHistory(id);
+const { apply, pending, error, conflict, retry } = useApplyOperations(id);
+const { exportArtifact, formats, loadFormats, warnings } = useArtifactExport(id);
+```
+
+- `useArtifact` shares a cache per client. Specific versions are immutable and never refetched; the latest version is revalidated on mount and moves forward with every commit made through the hooks/components.
+- `useApplyOperations` sends `baseVersion` (default: latest cached) and an idempotency key; on `VERSION_CONFLICT` it exposes `conflict.changes` and `retry()` on the latest version.
+- `useArtifactExport` exports in the browser when a loaded exporter with runtime `any`/`browser` handles the format, otherwise calls `client.export`, then triggers a download (`download: false` to skip).
+
+## Client
+
+```ts
+createHttpClient({ baseUrl = '/api/artifacts', fetch?, headers?, credentials? });
+createServiceClient(service, scope /* or () => scope */);
+```
+
+Both implement `ArtifactClient`: `list`, `create`, `get`, `read`, `apply`, `preview`, `history`, `restore`, `setStatus(id, action, message?)`, `lock`, `unlock`, `export → { bytes, mimeType, filename, warnings }`. The HTTP client follows the contract in `docs/CONVENTIONS.md` and turns error responses back into `ArtifactError` (`code`, `issues`, `details`; status-based fallback when the body is not a payload). For cross-origin APIs expose `Content-Disposition` and `X-Artkit-Warnings` through `Access-Control-Expose-Headers`.
+
+## Styling
+
+All classes use the `ak-` prefix and colors come from CSS variables (`--ak-color-accent`, `--ak-font-body`…) derived from the artifact and application themes via `themeCssVariables`. The provider injects `<style>` elements (React 19 hoisted and deduplicated, so each is added once) with `artkitCss`, the theme variables (light, plus dark derived automatically or from `darkThemes`) and each loaded kind's CSS. Dark mode follows `prefers-color-scheme` unless `data-theme="light"|"dark"` is set on an ancestor or through `colorScheme`.
+
+Every component accepts `className` and `slots` — per-part `{ className, style }` overrides (e.g. `slots={{ body: { className: 'my-body' } }}`) — so it can be customized without forking. Apps that ship their own CSS can pass `injectStyles={false}` and import `artkitCss`/`themeStyles`.
+
+## i18n
+
+UI strings ship in pt-BR and en (`uiMessages`); `locale` picks the catalog (`pt*` → pt-BR, anything else → en) and `messages` adds or overrides strings for any locale. Dates use `Intl` with the UI locale; artifact content keeps the artifact's own `locale`.
+
+## License
+
+Apache-2.0

package/dist/cache.d.ts

@@ -0,0 +1,35 @@
+import type { Artifact } from '@artkit-ai/core';
+import type { ArtifactClient } from './client.js';
+export interface CacheEntry {
+    artifact?: Artifact;
+    error?: unknown;
+    loading: boolean;
+}
+/**
+ * Artifact cache shared by the hooks under one provider (spec §13.2). Versions are immutable, so an
+ * entry for a specific version never needs revalidation; the `latest` entry only moves forward and is
+ * revalidated on demand. Listeners are per artifact id so history and editors hear about new commits.
+ */
+export declare class ArtifactCache {
+    private readonly client;
+    private readonly entries;
+    private readonly inflight;
+    private readonly listeners;
+    constructor(client: ArtifactClient);
+    entry(id: string, version?: number): CacheEntry;
+    latest(id: string): Artifact | undefined;
+    subscribe(id: string, listener: () => void): () => void;
+    private notify;
+    private set;
+    /**
+     * Records a known artifact version (commit result, prop, status change). `latest` only moves forward,
+     * except that a status change on the same version replaces it.
+     */
+    put(artifact: Artifact): void;
+    /** Loads unless a fresh value is cached. `force` revalidates `latest` (specific versions never change). */
+    load(id: string, version?: number, force?: boolean): Promise<Artifact>;
+    /** Signals listeners of an id without changing entries (e.g. history must refetch after a restore). */
+    touch(id: string): void;
+}
+export declare function cacheFor(client: ArtifactClient): ArtifactCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;;GAIG;AACH,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAEhE,YAA6B,MAAM,EAAE,cAAc,EAAI;IAEvD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAE9C;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEvC;IAED,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAQtD;IAED,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,GAAG;IAIX;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAe5B;IAED,2GAA2G;IAC3G,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyCnE;IAED,uGAAuG;IACvG,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtB;CACF;AAID,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAO9D"}

package/dist/cache.js

@@ -0,0 +1,116 @@
+const EMPTY = Object.freeze({ loading: false });
+const keyOf = (id, version) => `${id}@${version ?? 'latest'}`;
+/**
+ * Artifact cache shared by the hooks under one provider (spec §13.2). Versions are immutable, so an
+ * entry for a specific version never needs revalidation; the `latest` entry only moves forward and is
+ * revalidated on demand. Listeners are per artifact id so history and editors hear about new commits.
+ */
+export class ArtifactCache {
+    client;
+    entries = new Map();
+    inflight = new Map();
+    listeners = new Map();
+    constructor(client) {
+        this.client = client;
+    }
+    entry(id, version) {
+        return this.entries.get(keyOf(id, version)) ?? EMPTY;
+    }
+    latest(id) {
+        return this.entries.get(keyOf(id))?.artifact;
+    }
+    subscribe(id, listener) {
+        const set = this.listeners.get(id) ?? new Set();
+        set.add(listener);
+        this.listeners.set(id, set);
+        return () => {
+            set.delete(listener);
+            if (set.size === 0)
+                this.listeners.delete(id);
+        };
+    }
+    notify(id) {
+        for (const listener of [...(this.listeners.get(id) ?? [])])
+            listener();
+    }
+    set(id, version, entry) {
+        this.entries.set(keyOf(id, version), entry);
+    }
+    /**
+     * Records a known artifact version (commit result, prop, status change). `latest` only moves forward,
+     * except that a status change on the same version replaces it.
+     */
+    put(artifact) {
+        const current = this.latest(artifact.id);
+        const sameVersionChanged = current !== undefined &&
+            artifact.version === current.version &&
+            (artifact.status !== current.status ||
+                artifact.meta.updatedAt !== current.meta.updatedAt ||
+                artifact.meta.publishedVersion !== current.meta.publishedVersion);
+        const known = this.entries.get(keyOf(artifact.id, artifact.version))?.artifact;
+        if (current && !sameVersionChanged && artifact.version <= current.version && known)
+            return;
+        this.set(artifact.id, artifact.version, { artifact, loading: false });
+        if (!current || artifact.version > current.version || sameVersionChanged) {
+            this.set(artifact.id, undefined, { artifact, loading: false });
+        }
+        this.notify(artifact.id);
+    }
+    /** Loads unless a fresh value is cached. `force` revalidates `latest` (specific versions never change). */
+    load(id, version, force = false) {
+        const key = keyOf(id, version);
+        const existing = this.entries.get(key);
+        if (existing?.artifact && (version !== undefined || !force))
+            return Promise.resolve(existing.artifact);
+        const pending = this.inflight.get(key);
+        if (pending)
+            return pending;
+        this.set(id, version, { ...(existing ?? {}), loading: true });
+        this.notify(id);
+        const promise = this.client.get(id, version === undefined ? undefined : { version }).then((artifact) => {
+            this.inflight.delete(key);
+            if (version === undefined) {
+                // A commit may have landed while the request was in flight; never move `latest` backwards.
+                const current = this.latest(id);
+                if (current && current.version > artifact.version) {
+                    this.set(id, undefined, { artifact: current, loading: false });
+                    this.notify(id);
+                    return current;
+                }
+            }
+            this.set(artifact.id, artifact.version, { artifact, loading: false });
+            if (version === undefined)
+                this.set(id, undefined, { artifact, loading: false });
+            else if (!this.latest(id) || this.latest(id).version < artifact.version)
+                this.set(id, undefined, { artifact, loading: false });
+            this.notify(id);
+            return artifact;
+        }, (error) => {
+            this.inflight.delete(key);
+            const previous = this.entries.get(key);
+            this.set(id, version, {
+                ...(previous?.artifact ? { artifact: previous.artifact } : {}),
+                error,
+                loading: false,
+            });
+            this.notify(id);
+            throw error;
+        });
+        this.inflight.set(key, promise);
+        return promise;
+    }
+    /** Signals listeners of an id without changing entries (e.g. history must refetch after a restore). */
+    touch(id) {
+        this.notify(id);
+    }
+}
+const caches = new WeakMap();
+export function cacheFor(client) {
+    let cache = caches.get(client);
+    if (!cache) {
+        cache = new ArtifactCache(client);
+        caches.set(client, cache);
+    }
+    return cache;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,79 @@
+import { type Artifact, ArtifactError, type ArtifactFilter, type ArtifactService, type ArtifactSummary, type BatchResult, type CommitResult, type CreateRequest, type Lock, type Page, type PageRequest, type ProjectionMode, type ReadResult, type Scope, type VersionEntry } from '@artkit-ai/core';
+/** Lifecycle actions accepted by `POST {base}/{id}/status` (spec §15.3). */
+export type StatusAction = 'submit' | 'approve' | 'reject' | 'publish' | 'archive';
+export declare const STATUS_ACTIONS: readonly StatusAction[];
+export interface RequestOptions {
+    signal?: AbortSignal;
+}
+export interface ReadOptions extends RequestOptions {
+    mode?: ProjectionMode;
+    range?: string;
+    maxTokens?: number;
+    cursor?: string;
+    version?: number;
+}
+export interface ApplyInput {
+    baseVersion: number;
+    operations: unknown[];
+    idempotencyKey?: string;
+    message?: string;
+}
+export interface ExportInput extends RequestOptions {
+    format: string;
+    version?: number;
+    options?: Record<string, unknown>;
+}
+export interface ClientExportResult {
+    bytes: Uint8Array;
+    mimeType: string;
+    filename: string;
+    warnings: string[];
+}
+/**
+ * What the React layer talks to (spec §13.3). It never touches a store: credentials and authorization
+ * stay on the server (HTTP client) or in the scope given to an in-process service (service client).
+ */
+export interface ArtifactClient {
+    list(filter?: ArtifactFilter, page?: PageRequest, options?: RequestOptions): Promise<Page<ArtifactSummary>>;
+    create(request: CreateRequest, options?: RequestOptions): Promise<CommitResult>;
+    get(id: string, options?: RequestOptions & {
+        version?: number;
+    }): Promise<Artifact>;
+    read(id: string, options?: ReadOptions): Promise<ReadResult>;
+    apply(id: string, input: ApplyInput, options?: RequestOptions): Promise<CommitResult>;
+    /** Dry run on the current version: diff and lint without committing. */
+    preview(id: string, input: ApplyInput, options?: RequestOptions): Promise<BatchResult>;
+    history(id: string, page?: PageRequest, options?: RequestOptions): Promise<Page<VersionEntry>>;
+    restore(id: string, version: number, message?: string, options?: RequestOptions): Promise<CommitResult>;
+    setStatus(id: string, action: StatusAction, message?: string, options?: RequestOptions): Promise<Artifact>;
+    lock(id: string, options?: RequestOptions & {
+        ttlMs?: number;
+    }): Promise<Lock>;
+    unlock(id: string, lock: Lock, options?: RequestOptions): Promise<void>;
+    /** Current lock, or null when nobody holds one. */
+    getLock(id: string, options?: RequestOptions): Promise<Lock | null>;
+    export(id: string, input: ExportInput): Promise<ClientExportResult>;
+}
+type HeadersSource = HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+export interface HttpClientOptions {
+    /** Base path of the `@artkit-ai/node` routes (default `/api/artifacts`). */
+    baseUrl?: string;
+    /** Custom fetch (auth wrappers, tests, SSR). Defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+    /** Extra headers, or a function returning them per request (e.g. a fresh bearer token). */
+    headers?: HeadersSource;
+    credentials?: RequestCredentials;
+}
+/** Rebuilds an `ArtifactError` from an HTTP error response (`ModelErrorPayload` body, spec CONVENTIONS). */
+export declare function errorFromResponse(response: Response): Promise<ArtifactError>;
+/** Parses `Content-Disposition`, preferring the RFC 5987 `filename*` form. */
+export declare function filenameFromDisposition(header: string | null): string | undefined;
+/** Reference client for the `@artkit-ai/node` routes (HTTP contract in docs/CONVENTIONS.md). */
+export declare function createHttpClient(options?: HttpClientOptions): ArtifactClient;
+/**
+ * Wraps a core `ArtifactService` in-process (playground, tests, local apps). The scope is fixed by the
+ * application, never by the UI; pass a function to resolve it per call (e.g. after a login change).
+ */
+export declare function createServiceClient(service: ArtifactService, scope: Scope | (() => Scope)): ArtifactClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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