@nimbalyst/extension-sdk 0.3.0 → 0.5.0

package/dist/useCollaborativeEditor.d.ts

@@ -29,29 +29,16 @@
  * }
  * ```
  *
- * Bootstrap-race safety: if two clients both open an empty document, both
- * will call `initializeFromContent` and their CRDT updates merge. To avoid
- * duplicate elements your seeded shared types MUST use **content-derived
- * stable IDs** (e.g. element `id` from the file), not random IDs. The same
- * input yields the same Y.Doc state; merged duplicates collapse.
+ * Bootstrap-race safety: two clients seeding the same file must assign the
+ * same keys, so seed identity must be deterministic from stable file data or
+ * order, not random. In a keyed structured document, assign each key once and
+ * never recompute it from mutable content; changing it replaces the shared
+ * type and loses its history and concurrent edits.
  */
 import * as Y from 'yjs';
 import type { CollaborationStatus, CollaboratorInfo, EditorHost } from './types/editor.js';
 import type { CollabCodec } from './types/collab.js';
-/**
- * Origin tag used when the SDK wraps `initializeFromContent` in a Y.Doc
- * transaction. Extension bindings can compare a transaction's origin
- * against this to suppress their own change handlers during seeding
- * (otherwise the binding would echo the seed back into local-edit state).
- *
- * ```ts
- * yDoc.on('update', (update, origin) => {
- *   if (origin === COLLAB_INIT_ORIGIN) return;
- *   // ... apply remote change
- * });
- * ```
- */
-export declare const COLLAB_INIT_ORIGIN: unique symbol;
+export { COLLAB_INIT_ORIGIN } from './collab/origins.js';
 /** Context passed to the binding factory (`bind` / `createBinding`). */
 export interface CollabBindContext {
     yDoc: Y.Doc;
@@ -62,11 +49,7 @@ export interface CollabBindContext {
         color: string;
     };
 }
-export type CollabBindResult = {
-    destroy: () => void;
-} | Promise<{
-    destroy: () => void;
-}>;
+export type CollabBindResult = CollaborativeBindingHandle | Promise<CollaborativeBindingHandle>;
 /**
  * Preferred config: pass the SAME pure {@link CollabCodec} the extension
  * registered via `context.services.collab.registerContentAdapter(...)`, plus
@@ -119,8 +102,9 @@ export interface UseCollaborativeEditorLegacyConfig {
     /**
      * @deprecated Provide `seedFromFile` on the codec. Populate the Y.Doc from
      * raw file content when this client is first. Called inside a
-     * `yDoc.transact(..., COLLAB_INIT_ORIGIN)`. Use content-derived stable IDs
-     * (see file-level docs) to keep the bootstrap race deterministic.
+     * `yDoc.transact(..., COLLAB_INIT_ORIGIN)`. Seed keys deterministically from
+     * the file so concurrent seeds converge. In keyed structured documents,
+     * never recompute an assigned key from mutable content.
      */
     initializeFromContent(yDoc: Y.Doc, content: string | ArrayBuffer): void;
     onSeedOutcome?(outcome: {
@@ -129,6 +113,17 @@ export interface UseCollaborativeEditorLegacyConfig {
     }): void;
 }
 export type UseCollaborativeEditorConfig = UseCollaborativeEditorCodecConfig | UseCollaborativeEditorLegacyConfig;
+/**
+ * What a binding factory returns. `syncNow` is optional and opt-in: a binding
+ * that debounces its local pushes should expose it so the hook can register it
+ * as the host's pending-content drain (see
+ * `CollaborationContext.registerContentFlush`). Bindings that write through to
+ * the Y.Doc synchronously can omit it.
+ */
+export interface CollaborativeBindingHandle {
+    destroy: () => void;
+    syncNow?: () => void | Promise<void>;
+}
 export interface UseCollaborativeEditorResult {
     /** True when `host.collaboration` is defined. */
     isCollaborative: boolean;
@@ -143,9 +138,7 @@ export interface UseCollaborativeEditorResult {
      * The binding handle once the binding factory has run, or `null` until
      * collaboration is ready / when not collab.
      */
-    binding: {
-        destroy: () => void;
-    } | null;
+    binding: CollaborativeBindingHandle | null;
     /**
      * Non-null when the first-open seed failed or its flush was not confirmed by
      * the server. Hosts read this to surface the failure (pending-seed toast)

package/dist/useCollaborativeEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCollaborativeEditor.d.ts","sourceRoot":"","sources":["../src/useCollaborativeEditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAEV,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,eAAkC,CAAC;AAElE,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;IACZ,SAAS,EAAE,OAAO,uBAAuB,EAAE,SAAS,CAAC;IACrD,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iCAAiC;IAChD,kFAAkF;IAClF,KAAK,EAAE,WAAW,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAE/C;;;;OAIG;IACH,aAAa,CAAC,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,kCAAkC;IACjD,kDAAkD;IAClD,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAExD;;;OAGG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,qBAAqB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAExE,aAAa,CAAC,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,MAAM,4BAA4B,GACpC,iCAAiC,GACjC,kCAAkC,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IAC3C,iDAAiD;IACjD,eAAe,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,MAAM,EAAE,mBAAmB,CAAC;IAC5B;;;OAGG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C;;;OAGG;IACH,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxC;;;;OAIG;IACH,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAyCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAC5D,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,4BAA4B,GACnC,4BAA4B,CAgL9B"}
+{"version":3,"file":"useCollaborativeEditor.d.ts","sourceRoot":"","sources":["../src/useCollaborativeEditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAEV,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;IACZ,SAAS,EAAE,OAAO,uBAAuB,EAAE,SAAS,CAAC;IACrD,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,MAAM,gBAAgB,GACxB,0BAA0B,GAC1B,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iCAAiC;IAChD,kFAAkF;IAClF,KAAK,EAAE,WAAW,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAE/C;;;;OAIG;IACH,aAAa,CAAC,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,kCAAkC;IACjD,kDAAkD;IAClD,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAExD;;;OAGG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC;IAE/B;;;;;;OAMG;IACH,qBAAqB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAExE,aAAa,CAAC,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,MAAM,4BAA4B,GACpC,iCAAiC,GACjC,kCAAkC,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,4BAA4B;IAC3C,iDAAiD;IACjD,eAAe,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,MAAM,EAAE,mBAAmB,CAAC;IAC5B;;;OAGG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C;;;OAGG;IACH,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC3C;;;;OAIG;IACH,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAyCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAC5D,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,4BAA4B,GACnC,4BAA4B,CAoM9B"}

package/dist/useCollaborativeEditor.js

@@ -29,28 +29,16 @@
  * }
  * ```
  *
- * Bootstrap-race safety: if two clients both open an empty document, both
- * will call `initializeFromContent` and their CRDT updates merge. To avoid
- * duplicate elements your seeded shared types MUST use **content-derived
- * stable IDs** (e.g. element `id` from the file), not random IDs. The same
- * input yields the same Y.Doc state; merged duplicates collapse.
+ * Bootstrap-race safety: two clients seeding the same file must assign the
+ * same keys, so seed identity must be deterministic from stable file data or
+ * order, not random. In a keyed structured document, assign each key once and
+ * never recompute it from mutable content; changing it replaces the shared
+ * type and loses its history and concurrent edits.
  */
 import { useEffect, useRef, useState } from 'react';
 import * as Y from 'yjs';
-/**
- * Origin tag used when the SDK wraps `initializeFromContent` in a Y.Doc
- * transaction. Extension bindings can compare a transaction's origin
- * against this to suppress their own change handlers during seeding
- * (otherwise the binding would echo the seed back into local-edit state).
- *
- * ```ts
- * yDoc.on('update', (update, origin) => {
- *   if (origin === COLLAB_INIT_ORIGIN) return;
- *   // ... apply remote change
- * });
- * ```
- */
-export const COLLAB_INIT_ORIGIN = Symbol('nimbalyst:collab-init');
+import { COLLAB_INIT_ORIGIN } from './collab/origins.js';
+export { COLLAB_INIT_ORIGIN } from './collab/origins.js';
 function defaultIsEmpty(yDoc) {
     // A fully empty Y.Doc encodes to ~2 bytes (header only).
     return Y.encodeStateAsUpdate(yDoc).byteLength <= 2;
@@ -151,92 +139,112 @@ export function useCollaborativeEditor(host, config) {
             return;
         let cancelled = false;
         let handle = null;
+        let starting = false;
+        let unregisterContentFlush = null;
         const tryStart = async () => {
-            if (cancelled || handle)
-                return;
-            if (collab.getStatus() !== 'connected')
+            if (cancelled || handle || starting)
                 return;
             const cfg = resolveConfig(configRef.current);
-            // NEVER seed when the transport skipped payloads it could not decode:
-            // the Y.Doc looking empty then means "content exists but is unreadable
-            // on this client", and seeding would write a default document over the
-            // real content for every client (the "Untitled map" clobber).
-            const undecoded = collab.hasUndecodedContent?.() === true;
-            if (!undecoded && cfg.isEmpty(collab.yDoc)) {
-                try {
-                    const content = await collab.loadInitialContent();
-                    if (cancelled)
-                        return;
-                    // NEVER seed from empty content. A host that has no bytes for this
-                    // document (reopen of an already-shared doc: no in-memory share
-                    // payload, no file) returns ''/empty -- seeding from that writes a
-                    // default document into the shared room and clobbers whatever the
-                    // room's real content is for every client. Fall through to bind:
-                    // the room content (or a teammate's seed) will populate the doc.
-                    if (!hasSeedableContent(content)) {
-                        console.warn('[useCollaborativeEditor] Skipping first-open seed: host returned empty initial content.');
-                    }
-                    // Re-check emptiness in case another client seeded while we were
-                    // awaiting -- they would have raced through the WebSocket and
-                    // applied their update during our await gap. Avoid double-seeding
-                    // in that case; CRDT merge would otherwise insert duplicate
-                    // content unless the seed is fully deterministic.
-                    else if (cfg.isEmpty(collab.yDoc)) {
-                        collab.yDoc.transact(() => {
-                            cfg.seed(collab.yDoc, content);
-                        }, COLLAB_INIT_ORIGIN);
-                        // Durability: the seed the user sees locally must reach the server
-                        // before this provider can tear down. flushWithAck resolves only
-                        // after a server-persisted ack; flushLocalState is the deprecated
-                        // fire-and-forget fallback for older hosts.
-                        const flushed = collab.flushWithAck
-                            ? await collab.flushWithAck()
-                            : (await collab.flushLocalState?.(), true);
-                        if (!flushed) {
-                            const err = new Error('Seed flush was not confirmed by the server before timeout; content may not have persisted.');
-                            console.warn('[useCollaborativeEditor]', err.message);
-                            setSeedError(err);
-                            collab.reportSeedOutcome?.({ ok: false, error: err });
-                            cfg.onSeedOutcome?.({ ok: false, error: err });
+            const connected = collab.getStatus() === 'connected';
+            // A complete local replica can hydrate the Y.Doc before any network is
+            // available. Bind that non-empty document immediately so custom editors
+            // can reopen offline; only first-open seeding requires a live transport.
+            if (!connected && cfg.isEmpty(collab.yDoc))
+                return;
+            starting = true;
+            try {
+                // NEVER seed when the transport skipped payloads it could not decode:
+                // the Y.Doc looking empty then means "content exists but is unreadable
+                // on this client", and seeding would write a default document over the
+                // real content for every client (the "Untitled map" clobber).
+                const undecoded = collab.hasUndecodedContent?.() === true;
+                if (connected && !undecoded && cfg.isEmpty(collab.yDoc)) {
+                    try {
+                        const content = await collab.loadInitialContent();
+                        if (cancelled)
+                            return;
+                        // NEVER seed from empty content. A host that has no bytes for this
+                        // document (reopen of an already-shared doc: no in-memory share
+                        // payload, no file) returns ''/empty -- seeding from that writes a
+                        // default document into the shared room and clobbers whatever the
+                        // room's real content is for every client. Fall through to bind:
+                        // the room content (or a teammate's seed) will populate the doc.
+                        if (!hasSeedableContent(content)) {
+                            console.warn('[useCollaborativeEditor] Skipping first-open seed: host returned empty initial content.');
                         }
-                        else {
-                            setSeedError(null);
-                            collab.reportSeedOutcome?.({ ok: true });
-                            cfg.onSeedOutcome?.({ ok: true });
+                        // Re-check emptiness in case another client seeded while we were
+                        // awaiting -- they would have raced through the WebSocket and
+                        // applied their update during our await gap. Avoid double-seeding
+                        // in that case; CRDT merge would otherwise insert duplicate
+                        // content unless the seed is fully deterministic.
+                        else if (cfg.isEmpty(collab.yDoc)) {
+                            collab.yDoc.transact(() => {
+                                cfg.seed(collab.yDoc, content);
+                            }, COLLAB_INIT_ORIGIN);
+                            // Durability: the seed the user sees locally must reach the server
+                            // before this provider can tear down. flushWithAck resolves only
+                            // after a server-persisted ack; flushLocalState is the deprecated
+                            // fire-and-forget fallback for older hosts.
+                            const flushed = collab.flushWithAck
+                                ? await collab.flushWithAck()
+                                : (await collab.flushLocalState?.(), true);
+                            if (!flushed) {
+                                const err = new Error('Seed flush was not confirmed by the server before timeout; content may not have persisted.');
+                                console.warn('[useCollaborativeEditor]', err.message);
+                                setSeedError(err);
+                                collab.reportSeedOutcome?.({ ok: false, error: err });
+                                cfg.onSeedOutcome?.({ ok: false, error: err });
+                            }
+                            else {
+                                setSeedError(null);
+                                collab.reportSeedOutcome?.({ ok: true });
+                                cfg.onSeedOutcome?.({ ok: true });
+                            }
                         }
                     }
+                    catch (err) {
+                        console.error('[useCollaborativeEditor] Failed to load/seed initial content:', err);
+                        setSeedError(err);
+                        collab.reportSeedOutcome?.({ ok: false, error: err });
+                        cfg.onSeedOutcome?.({ ok: false, error: err });
+                        // Continue with bind -- the doc may still be usable once another
+                        // client seeds it.
+                    }
                 }
-                catch (err) {
-                    console.error('[useCollaborativeEditor] Failed to load/seed initial content:', err);
-                    setSeedError(err);
-                    collab.reportSeedOutcome?.({ ok: false, error: err });
-                    cfg.onSeedOutcome?.({ ok: false, error: err });
-                    // Continue with bind -- the doc may still be usable once another
-                    // client seeds it.
-                }
-            }
-            if (cancelled)
-                return;
-            const created = cfg.bind({
-                yDoc: collab.yDoc,
-                awareness: collab.awareness,
-                user: collab.user,
-            });
-            const resolved = created instanceof Promise ? await created : created;
-            if (cancelled) {
-                // Effect unmounted while we were awaiting the extension's
-                // imperative API. Destroy the freshly-built handle so any
-                // observers/awareness subscriptions inside it get cleaned up.
-                try {
-                    resolved.destroy();
+                if (cancelled)
+                    return;
+                const created = cfg.bind({
+                    yDoc: collab.yDoc,
+                    awareness: collab.awareness,
+                    user: collab.user,
+                });
+                const resolved = created instanceof Promise ? await created : created;
+                if (cancelled) {
+                    // Effect unmounted while we were awaiting the extension's
+                    // imperative API. Destroy the freshly-built handle so any
+                    // observers/awareness subscriptions inside it get cleaned up.
+                    try {
+                        resolved.destroy();
+                    }
+                    catch (err) {
+                        console.error('[useCollaborativeEditor] post-cancel destroy failed:', err);
+                    }
+                    return;
                 }
-                catch (err) {
-                    console.error('[useCollaborativeEditor] post-cancel destroy failed:', err);
+                handle = resolved;
+                // A binding that debounces its local pushes holds the newest edit
+                // outside the CRDT. Hand the host a drain so it can complete a write
+                // before reporting it done -- notably after a mutating AI tool, which
+                // otherwise returns success while the edit is still in the debounce.
+                if (typeof handle.syncNow === 'function') {
+                    const syncNow = handle.syncNow.bind(handle);
+                    unregisterContentFlush = collab.registerContentFlush?.(syncNow) ?? null;
                 }
-                return;
+                setBinding(handle);
+            }
+            finally {
+                starting = false;
             }
-            handle = resolved;
-            setBinding(handle);
         };
         void tryStart();
         const unsubscribe = collab.onStatusChange(() => {
@@ -245,6 +253,8 @@ export function useCollaborativeEditor(host, config) {
         return () => {
             cancelled = true;
             unsubscribe();
+            unregisterContentFlush?.();
+            unregisterContentFlush = null;
             if (handle) {
                 handle.destroy();
                 handle = null;

package/dist/useEditorLifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEditorLifecycle.d.ts","sourceRoot":"","sources":["../src/useEditorLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMhE,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAEnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAExC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAE/C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,CAAC,CAAC;IAEZ,qDAAqD;IACrD,QAAQ,EAAE,CAAC,CAAC;IAEZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC;;;OAGG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IAEnB,wCAAwC;IACxC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IAEd,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE/B,iFAAiF;IACjF,gBAAgB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAE3C,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;CACvB;AAMD,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,EAC3C,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACpC,wBAAwB,CAAC,CAAC,CAAC,CAiS7B"}
+{"version":3,"file":"useEditorLifecycle.d.ts","sourceRoot":"","sources":["../src/useEditorLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMhE,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAEnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAExC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAE/C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,CAAC,CAAC;IAEZ,qDAAqD;IACrD,QAAQ,EAAE,CAAC,CAAC;IAEZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC;;;OAGG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IAEnB,wCAAwC;IACxC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IAEd,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE/B,iFAAiF;IACjF,gBAAgB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAE3C,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;CACvB;AAMD,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,EAC3C,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACpC,wBAAwB,CAAC,CAAC,CAAC,CAmS7B"}

package/dist/useEditorLifecycle.js

@@ -146,6 +146,7 @@ export function useEditorLifecycle(host, options) {
                 }
                 if (!mounted)
                     return;
+                setError(null);
                 setIsLoading(false);
                 optionsRef.current.onLoaded?.();
             }
@@ -204,6 +205,7 @@ export function useEditorLifecycle(host, options) {
                 const parsed = parseContent(newRawContent);
                 lastSavedContentRef.current = newRawContent;
                 opts.applyContent(parsed);
+                setError(null);
                 clearDirty();
                 opts.onExternalChange?.(parsed);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbalyst/extension-sdk",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "SDK for building Nimbalyst extensions",
   "repository": {
     "type": "git",
@@ -29,6 +29,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./collab": {
+      "types": "./dist/collab/index.d.ts",
+      "import": "./dist/collab/index.js"
+    },
     "./vite": {
       "types": "./dist/vite.d.ts",
       "import": "./dist/vite.js"
@@ -44,6 +48,10 @@
     "./file-tree": {
       "types": "./dist/fileDirectoryTree.d.ts",
       "import": "./dist/fileDirectoryTree.js"
+    },
+    "./file-mask": {
+      "types": "./dist/fileMask.d.ts",
+      "import": "./dist/fileMask.js"
     }
   },
   "files": [
@@ -52,10 +60,11 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "node -e \"fs.rmSync('dist',{recursive:true,force:true})\" && tsc",
+    "build": "tsc",
+    "build:clean": "node -e \"fs.rmSync('dist',{recursive:true,force:true});fs.rmSync('.tsbuildinfo',{force:true})\" && tsc",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build:clean"
   },
   "dependencies": {},
   "peerDependencies": {