@pilotiq/pilotiq 0.8.1 → 0.9.0

package/dist/react/index.d.ts

@@ -8,10 +8,12 @@ export { PendingSuggestionsContext, usePendingSuggestions, usePendingSuggestions
 export { registerPendingSuggestionApplier, getPendingSuggestionApplier, type PendingSuggestionApplier, } from './PendingSuggestionApplierRegistry.js';
 export { CollabRoomContext, useCollabRoom, type CollabRoom, } from './CollabRoomContext.js';
 export { registerCollabExtensions, getCollabExtensions, type CollabExtensionFactory, type CollabExtensionFactoryArgs, } from './CollabExtensionFactoryRegistry.js';
-export { registerFormCollabBinding, getFormCollabBinding, type FormCollabBinding, type FormCollabBindingFactory, type FormCollabBindingFactoryArgs, } from './FormCollabBindingRegistry.js';
+export { registerFormCollabBinding, getFormCollabBinding, type FormCollabBinding, type FormCollabBindingFactory, type FormCollabBindingFactoryArgs, type TextBinding, type TextDelta, } from './FormCollabBindingRegistry.js';
+export { registerFieldPresenceComponent, getFieldPresenceComponent, type FieldPresenceProps, } from './FieldPresenceRegistry.js';
+export { registerFieldFocusReporter, getFieldFocusReporter, type FieldFocusReporter, type FieldFocusEvent, } from './FieldFocusReporterRegistry.js';
 export { registerRecordWrapper, getRecordWrapper, type RecordWrapperProps, } from './RecordWrapperRegistry.js';
 export { RecordWrapperGate, type RecordWrapperGateProps, } from './RecordWrapperGate.js';
-export { parseRecordEditUrl, type RecordEditIdentity } from './parseRecordEditUrl.js';
+export { parseRecordPageUrl, parseRecordEditUrl, type RecordPageIdentity, type RecordPageRole, type RecordEditIdentity, } from './parseRecordEditUrl.js';
 export { registerWidgetRenderer, getWidgetRenderer, type WidgetRendererProps, } from './widgetRegistry.js';
 export { FormStateProvider, useFieldState, useFormState, type FormStateApi, type FormStateProviderProps, type UseFieldStateResult, } from './FormStateContext.js';
 export { parseFormDataToNested } from './formStateHelpers.js';

package/dist/react/index.d.ts.map

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

package/dist/react/index.js

@@ -9,9 +9,11 @@ export { registerPendingSuggestionApplier, getPendingSuggestionApplier, } from '
 export { CollabRoomContext, useCollabRoom, } from './CollabRoomContext.js';
 export { registerCollabExtensions, getCollabExtensions, } from './CollabExtensionFactoryRegistry.js';
 export { registerFormCollabBinding, getFormCollabBinding, } from './FormCollabBindingRegistry.js';
+export { registerFieldPresenceComponent, getFieldPresenceComponent, } from './FieldPresenceRegistry.js';
+export { registerFieldFocusReporter, getFieldFocusReporter, } from './FieldFocusReporterRegistry.js';
 export { registerRecordWrapper, getRecordWrapper, } from './RecordWrapperRegistry.js';
 export { RecordWrapperGate, } from './RecordWrapperGate.js';
-export { parseRecordEditUrl } from './parseRecordEditUrl.js';
+export { parseRecordPageUrl, parseRecordEditUrl, } from './parseRecordEditUrl.js';
 export { registerWidgetRenderer, getWidgetRenderer, } from './widgetRegistry.js';
 export { FormStateProvider, useFieldState, useFormState, } from './FormStateContext.js';
 export { parseFormDataToNested } from './formStateHelpers.js';

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsB,MAAM,eAAe,CAAA;AAC5D,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,UAAU,GAEX,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,cAAc,EAEd,UAAU,GAEX,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAA2B,MAAM,eAAe,CAAA;AAChG,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAA4B,MAAM,6BAA6B,CAAA;AACjH,OAAO,EACL,gCAAgC,EAChC,2BAA2B,GAE5B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,GAI9B,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,gCAAgC,EAChC,2BAA2B,GAE5B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EACL,iBAAiB,EACjB,aAAa,GAEd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAGpB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GAIrB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GAEjB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,iBAAiB,GAElB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,kBAAkB,EAA2B,MAAM,yBAAyB,CAAA;AACrF,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAElB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,GAIb,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAmB,MAAM,eAAe,CAAA;AAE9E,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAExD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GAId,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,uBAAuB,GAGxB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,YAAY,GAEb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAY,oBAAoB,CAAA;AACxD,OAAO,EACL,iBAAiB,EACjB,eAAe,GAGhB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAW,gBAAgB,CAAA;AAE/C,OAAO,EACL,eAAe,GAKhB,MAAM,sBAAsB,CAAA;AAG7B,iHAAiH;AACjH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,mBAAmB;AACnB,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAyC,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/dist/react/parseRecordEditUrl.d.ts

@@ -1,12 +1,13 @@
 /**
- * Parses a pilotiq URL into a record-edit identity, or returns `null`
- * for any URL that isn't a record-bound edit page.
+ * URL → record-page identity parser. Used by `RecordWrapperGate` (and any
+ * plugin that wants to reason about record-bound URLs) to decide whether
+ * the current page is a record-edit or record-view route.
  *
  * A URL matches when:
  *   1. it starts with the panel's `basePath`
- *   2. after stripping the prefix it ends with `/edit`
+ *   2. after stripping the prefix it ends with `/edit` or `/view`
  *   3. there are at least three remaining segments (resource slug,
- *      record id, `edit`)
+ *      record id, terminal token)
  *
  * The `resourceSlug` is the slash-joined chain of every segment up to
  * the record id — this gives clustered resources (`${base}/blog/articles/123/edit`)
@@ -14,13 +15,36 @@
  * distinct slugs so two URLs that target different records always
  * produce different room names downstream.
  *
- *   `/admin/articles/123/edit`                      → { resourceSlug: 'articles',                 recordId: '123' }
- *   `/admin/blog/articles/123/edit`                 → { resourceSlug: 'blog/articles',            recordId: '123' }
- *   `/admin/articles/123/comments/456/edit`         → { resourceSlug: 'articles/123/comments',    recordId: '456' }
- *   `/admin/articles/123/comments`                  → null  (no trailing /edit)
- *   `/admin/articles/123/comments/create`           → null  (no record id)
+ *   `/admin/articles/123/edit`                      → { slug: 'articles',              id: '123', role: 'edit' }
+ *   `/admin/articles/123/view`                      → { slug: 'articles',              id: '123', role: 'view' }
+ *   `/admin/blog/articles/123/edit`                 → { slug: 'blog/articles',         id: '123', role: 'edit' }
+ *   `/admin/articles/123/comments/456/edit`         → { slug: 'articles/123/comments', id: '456', role: 'edit' }
+ *   `/admin/articles/123/comments`                  → null  (no trailing /edit or /view)
+ *   `/admin/articles/123/comments/create`           → null  (terminal token isn't edit|view)
  *   `/site/articles/123/edit`                       → null  (basePath mismatch when basePath='/admin')
  */
+/** Page roles `parseRecordPageUrl` recognizes. `'edit'` and `'view'`
+ * are the two record-scoped page roles where collab and other
+ * record-bound plugins want to mount their per-record wrapper. */
+export type RecordPageRole = 'edit' | 'view';
+export interface RecordPageIdentity {
+    resourceSlug: string;
+    recordId: string;
+    /** Which terminal URL segment matched — `'edit'` for the writable edit
+     * page, `'view'` for the read-only view page. Lets the gate decide per
+     * resource whether collab activates on this role (defaults to `'edit'`
+     * only; resources opt into `'view'` for presence-only experiences). */
+    role: RecordPageRole;
+}
+/**
+ * Parse a pilotiq URL into a `{ slug, id, role }` identity. Returns
+ * `null` for any URL that isn't a record-edit or record-view page.
+ */
+export declare function parseRecordPageUrl(currentPath: string, basePath: string): RecordPageIdentity | null;
+/** Legacy alias: parse a URL into an edit-only identity. Returns `null`
+ * for view URLs (and any non-edit URL). Kept for back-compat with the
+ * pre-`parseRecordPageUrl` public API; new code should call
+ * `parseRecordPageUrl` and branch on `role`. */
 export interface RecordEditIdentity {
     resourceSlug: string;
     recordId: string;

package/dist/react/parseRecordEditUrl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseRecordEditUrl.d.ts","sourceRoot":"","sources":["../../src/react/parseRecordEditUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAM,MAAM,CAAA;CACrB;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAK,MAAM,GAClB,kBAAkB,GAAG,IAAI,CAuB3B"}
+{"version":3,"file":"parseRecordEditUrl.d.ts","sourceRoot":"","sources":["../../src/react/parseRecordEditUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;kEAEkE;AAClE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAA;AAE5C,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAM,MAAM,CAAA;IACpB;;;2EAGuE;IACvE,IAAI,EAAU,cAAc,CAAA;CAC7B;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAK,MAAM,GAClB,kBAAkB,GAAG,IAAI,CAyB3B;AAED;;;gDAGgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAM,MAAM,CAAA;CACrB;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAK,MAAM,GAClB,kBAAkB,GAAG,IAAI,CAI3B"}

package/dist/react/parseRecordEditUrl.js

@@ -1,4 +1,34 @@
-export function parseRecordEditUrl(currentPath, basePath) {
+/**
+ * URL → record-page identity parser. Used by `RecordWrapperGate` (and any
+ * plugin that wants to reason about record-bound URLs) to decide whether
+ * the current page is a record-edit or record-view route.
+ *
+ * A URL matches when:
+ *   1. it starts with the panel's `basePath`
+ *   2. after stripping the prefix it ends with `/edit` or `/view`
+ *   3. there are at least three remaining segments (resource slug,
+ *      record id, terminal token)
+ *
+ * The `resourceSlug` is the slash-joined chain of every segment up to
+ * the record id — this gives clustered resources (`${base}/blog/articles/123/edit`)
+ * and nested-relation edits (`${base}/articles/123/comments/456/edit`)
+ * distinct slugs so two URLs that target different records always
+ * produce different room names downstream.
+ *
+ *   `/admin/articles/123/edit`                      → { slug: 'articles',              id: '123', role: 'edit' }
+ *   `/admin/articles/123/view`                      → { slug: 'articles',              id: '123', role: 'view' }
+ *   `/admin/blog/articles/123/edit`                 → { slug: 'blog/articles',         id: '123', role: 'edit' }
+ *   `/admin/articles/123/comments/456/edit`         → { slug: 'articles/123/comments', id: '456', role: 'edit' }
+ *   `/admin/articles/123/comments`                  → null  (no trailing /edit or /view)
+ *   `/admin/articles/123/comments/create`           → null  (terminal token isn't edit|view)
+ *   `/site/articles/123/edit`                       → null  (basePath mismatch when basePath='/admin')
+ */
+const RECOGNIZED_ROLES = ['edit', 'view'];
+/**
+ * Parse a pilotiq URL into a `{ slug, id, role }` identity. Returns
+ * `null` for any URL that isn't a record-edit or record-view page.
+ */
+export function parseRecordPageUrl(currentPath, basePath) {
     if (!currentPath)
         return null;
     // Normalise — trailing slashes on the URL or trailing slashes on
@@ -11,7 +41,8 @@ export function parseRecordEditUrl(currentPath, basePath) {
     const parts = tail.split('/').filter(Boolean);
     if (parts.length < 3)
         return null;
-    if (parts[parts.length - 1] !== 'edit')
+    const terminal = parts[parts.length - 1];
+    if (!RECOGNIZED_ROLES.includes(terminal))
         return null;
     const recordId = parts[parts.length - 2];
     const slugParts = parts.slice(0, parts.length - 2);
@@ -20,6 +51,13 @@ export function parseRecordEditUrl(currentPath, basePath) {
     return {
         resourceSlug: slugParts.join('/'),
         recordId,
+        role: terminal,
     };
 }
+export function parseRecordEditUrl(currentPath, basePath) {
+    const identity = parseRecordPageUrl(currentPath, basePath);
+    if (!identity || identity.role !== 'edit')
+        return null;
+    return { resourceSlug: identity.resourceSlug, recordId: identity.recordId };
+}
 //# sourceMappingURL=parseRecordEditUrl.js.map

package/dist/react/parseRecordEditUrl.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseRecordEditUrl.js","sourceRoot":"","sources":["../../src/react/parseRecordEditUrl.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,QAAmB;IAEnB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAA;IAC7B,iEAAiE;IACjE,2DAA2D;IAC3D,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAEhD,IAAI,WAAW,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAA;IAE3E,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAE7C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACjC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IAEnD,MAAM,QAAQ,GAAM,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAA;IAC5C,MAAM,SAAS,GAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvC,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QACjC,QAAQ;KACT,CAAA;AACH,CAAC"}
+{"version":3,"file":"parseRecordEditUrl.js","sourceRoot":"","sources":["../../src/react/parseRecordEditUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAiBH,MAAM,gBAAgB,GAAkC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAExE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,QAAmB;IAEnB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAA;IAC7B,iEAAiE;IACjE,2DAA2D;IAC3D,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAEhD,IAAI,WAAW,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAA;IAE3E,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAE7C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAA;IACzC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAA0B,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvE,MAAM,QAAQ,GAAM,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAA;IAC5C,MAAM,SAAS,GAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvC,OAAO;QACL,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QACjC,QAAQ;QACR,IAAI,EAAU,QAA0B;KACzC,CAAA;AACH,CAAC;AAWD,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,QAAmB;IAEnB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IAC1D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IACtD,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAA;AAC7E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pilotiq/pilotiq",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "View-based admin panel for RudderJS",
   "license": "MIT",
   "repository": {

package/src/Resource.test.ts

@@ -237,4 +237,48 @@ describe('Resource (static API)', () => {
       assert.equal(await R.canRestore(null, { ownedBy: 'other' }), false)
     })
   })
+
+  describe('collab opt-in', () => {
+    it('omitted static collab → getResolvedCollabConfig returns null', () => {
+      class R extends Resource {}
+      assert.equal(R.getResolvedCollabConfig(), null)
+    })
+
+    it('static collab = false → null (explicit opt-out)', () => {
+      class R extends Resource {
+        static override collab = false as const
+      }
+      assert.equal(R.getResolvedCollabConfig(), null)
+    })
+
+    it('static collab = true → defaults to { pages: [edit], presence: true }', () => {
+      class R extends Resource {
+        static override collab = true as const
+      }
+      assert.deepEqual(R.getResolvedCollabConfig(), {
+        pages:    ['edit'],
+        presence: true,
+      })
+    })
+
+    it('object form merges with defaults', () => {
+      class R extends Resource {
+        static override collab = { pages: ['edit', 'view'] as const }
+      }
+      assert.deepEqual(R.getResolvedCollabConfig(), {
+        pages:    ['edit', 'view'],
+        presence: true,   // default preserved
+      })
+    })
+
+    it('object form can suppress presence', () => {
+      class R extends Resource {
+        static override collab = { presence: false }
+      }
+      assert.deepEqual(R.getResolvedCollabConfig(), {
+        pages:    ['edit'],   // default preserved
+        presence: false,
+      })
+    })
+  })
 })

package/src/Resource.ts

@@ -50,6 +50,33 @@ export type NavigationBadgeColor =
 export type NavigationBadgeHandler =
   () => string | number | undefined | Promise<string | number | undefined>
 
+/**
+ * Per-resource collab configuration. Set via `static collab = true` (the
+ * 90% case — opts the edit page in with presence) or via the object form
+ * for finer control. Omitting `static collab` entirely keeps the resource
+ * collab-free even when the `@pilotiq-pro/collab` plugin is registered.
+ *
+ *   pages    — page roles where collab activates. `'edit'` syncs values +
+ *              presence; `'view'` is presence-only (the page is read-only,
+ *              value-sync would be moot). Defaults to `['edit']`.
+ *   presence — when false, suppress the awareness layer (focus chips,
+ *              cursor positions) while keeping value-sync. Defaults to true.
+ *
+ * Field-level `.collab(false)` always wins over this setting — opting the
+ * resource in then opting individual fields out is the supported shape.
+ */
+export interface ResourceCollabConfig {
+  pages:    ReadonlyArray<'edit' | 'view'>
+  presence: boolean
+}
+
+/** Raw shape accepted by `static collab` before normalization. `true` is a
+ * shorthand for `{ pages: ['edit'], presence: true }`. */
+export type ResourceCollabInput = boolean | {
+  pages?:    ReadonlyArray<'edit' | 'view'>
+  presence?: boolean
+}
+
 /**
  * Abstract Resource base class. **All methods are static** — resources are
  * registered by class, not by instance. Routes look up the class and call
@@ -297,6 +324,37 @@ export abstract class Resource {
     return undefined
   }
 
+  // ─── Realtime collab opt-in ────────────────────────────────
+  // Opt-in per resource. The `@pilotiq-pro/collab` plugin registers the
+  // global singletons (transport, Tiptap extension factory, RecordWrapper
+  // factory); resources with `static collab` unset stay collab-free even
+  // when the plugin is installed. Field-level `.collab(false)` overrides
+  // this setting per field.
+
+  /** Enable collab on this resource. `true` is the 90% case — shorthand
+   * for `{ pages: ['edit'], presence: true }`. Use the object form to
+   * narrow which page roles activate or to suppress presence. Default
+   * `false` (collab off — the WS room is never opened for this resource). */
+  static collab: ResourceCollabInput = false
+
+  /**
+   * Normalize `static collab` into the canonical wire shape, or return
+   * `null` when the resource has opted out. Centralizes the `true` →
+   * defaults expansion and the `{ pages?: … }` merge.
+   *
+   * Result lands on `panelInfo().recordCollab[slug]`; the gate reads it
+   * to decide whether to mount the record wrapper.
+   */
+  static getResolvedCollabConfig(): ResourceCollabConfig | null {
+    const raw = this.collab
+    if (raw === false || raw == null) return null
+    if (raw === true) return { pages: ['edit'], presence: true }
+    return {
+      pages:    raw.pages    ?? ['edit'],
+      presence: raw.presence ?? true,
+    }
+  }
+
   // ─── Plan #10: authorization predicates ────────────────────
   // All async, all default `true`. Routes call them with the resolved
   // user (from `Pilotiq.user(fn)`); the renderer threads the same user

package/src/pageData/navigation.ts

@@ -1,6 +1,6 @@
 import type { Pilotiq, PilotiqConfig } from '../Pilotiq.js'
 import type { Page } from '../Page.js'
-import type { ResourceClass, NavigationBadgeColor } from '../Resource.js'
+import type { ResourceClass, NavigationBadgeColor, ResourceCollabConfig } from '../Resource.js'
 import type { GlobalClass } from '../Global.js'
 import type { ClusterClass } from '../Cluster.js'
 import { resourceBasePath, globalBasePath, pageBasePath } from '../clusterPaths.js'
@@ -194,6 +194,35 @@ export interface PanelInfoRoute {
   url?:      string
 }
 
+/**
+ * Per-resource collab opt-in map, keyed by the URL slug
+ * `parseRecordPageUrl` produces. Non-clustered resource → `getSlug()`;
+ * clustered resource → `${cluster.getSlug()}/${R.getSlug()}`.
+ *
+ * `RecordWrapperGate` reads this map to decide whether the page tree
+ * needs the plugin-registered RecordWrapper (collab room, audit, …)
+ * mounted around the record view/edit content area.
+ *
+ * Nested-relation edit URLs (`/articles/123/comments/456/edit`) have a
+ * dynamic-id segment in the gate's URL slug and don't match here in v1.
+ * Collab on nested-relation edits is a follow-up — top-level resource
+ * edits are the common case and ship now.
+ */
+export type RecordCollabMap = Record<string, ResourceCollabConfig>
+
+function resourceSlugForGate(R: ResourceClass): string {
+  return R.cluster ? `${R.cluster.getSlug()}/${R.getSlug()}` : R.getSlug()
+}
+
+function buildRecordCollabMap(cfg: Readonly<PilotiqConfig>): RecordCollabMap | undefined {
+  const map: RecordCollabMap = {}
+  for (const R of cfg.resources) {
+    const collab = R.getResolvedCollabConfig()
+    if (collab) map[resourceSlugForGate(R)] = collab
+  }
+  return Object.keys(map).length > 0 ? map : undefined
+}
+
 export async function panelInfo(
   pilotiq: Pilotiq,
   req?:    unknown,
@@ -210,6 +239,7 @@ export async function panelInfo(
     buildRightSidebarMeta(cfg, user),
   ])
   const databaseNotifications = buildDatabaseNotificationsMeta(cfg, user)
+  const recordCollab = buildRecordCollabMap(cfg)
   // AI suggestion mode — sparse: omit when 'auto' (the default) so the
   // wire shape stays minimal for panels that don't opt into review mode.
   // Plugin clients (e.g. @pilotiq-pro/ai's `AiClientToolBindings`) read
@@ -225,6 +255,7 @@ export async function panelInfo(
     ...(userMenu ? { userMenu } : {}),
     ...(databaseNotifications ? { databaseNotifications } : {}),
     ...(rightSidebar ? { rightSidebar } : {}),
+    ...(recordCollab ? { recordCollab } : {}),
     ...(Object.keys(renderHooks).length > 0 ? { renderHooks } : {}),
     ...(aiSuggestionsMode !== 'auto' ? { aiSuggestionsMode } : {}),
   }

package/src/pageData.test.ts

@@ -1202,3 +1202,39 @@ describe('tagRichTextMentionUrls — nested Repeater + Builder rows', () => {
     assert.equal(inner.stamped, '/admin/_form/art/mentions')
   })
 })
+
+describe('panelInfo — recordCollab map (resource collab opt-in)', () => {
+  it('absent when no resource opts in', async () => {
+    class Posts extends Resource { static override label = 'Posts' }
+    const info = await panelInfo(Pilotiq.make('T').path('/admin').resources([Posts]))
+    assert.equal((info as { recordCollab?: unknown }).recordCollab, undefined)
+  })
+
+  it('emits an entry for each opted-in resource keyed by URL slug', async () => {
+    class Posts extends Resource {
+      static override label  = 'Posts'
+      static override collab = true as const
+    }
+    class Users extends Resource {
+      static override label  = 'Users'
+      // No collab — should NOT appear in the map.
+    }
+    const info = await panelInfo(Pilotiq.make('T').path('/admin').resources([Posts, Users]))
+    const map = (info as { recordCollab?: Record<string, unknown> }).recordCollab
+    assert.deepEqual(map, {
+      posts: { pages: ['edit'], presence: true },
+    })
+  })
+
+  it('honors object form of static collab (pages + presence override defaults)', async () => {
+    class Posts extends Resource {
+      static override label  = 'Posts'
+      static override collab = { pages: ['edit', 'view'] as const, presence: false }
+    }
+    const info = await panelInfo(Pilotiq.make('T').path('/admin').resources([Posts]))
+    const map = (info as { recordCollab?: Record<string, unknown> }).recordCollab
+    assert.deepEqual(map, {
+      posts: { pages: ['edit', 'view'], presence: false },
+    })
+  })
+})

package/src/react/AppShell.tsx

@@ -10,7 +10,7 @@ import type { RightPanelRegistry } from './right-panel-registry.js'
 import { RightPanelRegistryProvider } from './right-panel-registry.js'
 import { RightSidebarProvider, useRightSidebarOptional } from './RightSidebarContext.js'
 import { RightSidebar } from './RightSidebar.js'
-import { RecordWrapperGate } from './RecordWrapperGate.js'
+import { RecordWrapperGate, type RecordCollabMap } from './RecordWrapperGate.js'
 import { useIsMobile } from './hooks/use-mobile.js'
 import type { NavItem, UserMenuMeta, DatabaseNotificationsMeta, RightSidebarMeta } from '../pageData.js'
 import type { RenderHookMap } from '../RenderHook.js'
@@ -34,6 +34,10 @@ export interface AppShellProps {
      *  `panelInfo()` only ships this when at least one contribution
      *  was registered AND passed the auth gate AND is non-hidden. */
     rightSidebar?: RightSidebarMeta
+    /** Per-resource collab opt-in map — read by `RecordWrapperGate` to
+     *  decide whether to mount the plugin-registered RecordWrapper on
+     *  a record edit/view URL. Absent when no resource opted in. */
+    recordCollab?: RecordCollabMap
     /** Pre-resolved render-hook slots for the panel chrome (body /
      *  topbar / sidebar / user-menu / footer / head). Sparse map —
      *  slots with no registered entries are absent. Built by
@@ -130,6 +134,7 @@ export function AppShell({ layout = 'sidebar', notifications, componentRegistry,
       <RecordWrapperGate
         basePath={props.basePath}
         {...(props.currentPath !== undefined ? { currentPath: props.currentPath } : {})}
+        {...(props.panel.recordCollab !== undefined ? { recordCollab: props.panel.recordCollab } : {})}
       >
         {props.children}
       </RecordWrapperGate>

package/src/react/FieldFocusReporterRegistry.ts

@@ -0,0 +1,37 @@
+/**
+ * Module-level slot for focus / blur callbacks dispatched by pilotiq's
+ * `FieldShell`. A collab plugin (e.g. `@pilotiq-pro/collab`) registers
+ * a reporter at boot; on every controlled-field focus / blur event,
+ * `FieldShell` calls the matching method with `{ fieldName, formId }`
+ * so the plugin can mirror the local user's focus state into Yjs
+ * awareness.
+ *
+ * `FieldShell` skips dispatching for fields opted out via
+ * `Field.collab(false)` AND for dotted-path names (Repeater rows stay
+ * out of F4 presence in v1) — so the reporter never sees those events.
+ */
+export interface FieldFocusEvent {
+  fieldName: string
+  formId:    string
+}
+
+export interface FieldFocusReporter {
+  onFocus(event: FieldFocusEvent): void
+  onBlur(event: FieldFocusEvent):  void
+}
+
+let _reporter: FieldFocusReporter | null = null
+
+/**
+ * Register the reporter. Called once at boot by the collab plugin.
+ * No-op when no plugin registers — `FieldShell` doesn't wire focus
+ * listeners.
+ */
+export function registerFieldFocusReporter(reporter: FieldFocusReporter): void {
+  _reporter = reporter
+}
+
+/** Returns the registered reporter, or `null`. */
+export function getFieldFocusReporter(): FieldFocusReporter | null {
+  return _reporter
+}

package/src/react/FieldPresenceRegistry.ts

@@ -0,0 +1,46 @@
+import type { ComponentType } from 'react'
+
+/**
+ * Props the per-field presence chip receives from `FieldShell` when a
+ * `@pilotiq-pro/collab`-style plugin has registered a component.
+ *
+ * The chip subscribes to the active collab room's awareness state and
+ * renders colored avatars / dots for every remote user currently
+ * focused on this field. Pilotiq core renders it alongside the field's
+ * label; the component owns the awareness lookup so pilotiq stays
+ * Yjs-free.
+ *
+ * Mounted only when:
+ *
+ *   - A collab plugin has registered a component via
+ *     `registerFieldPresenceComponent(...)`,
+ *   - The field hasn't opted out via `Field.collab(false)`, and
+ *   - The field has a stable `name` (dotted-path Repeater rows skip
+ *     presence in v1 — Phase F.5 work).
+ */
+export interface FieldPresenceProps {
+  /** Top-level field name. Dotted-path names are skipped by `FieldShell`. */
+  fieldName: string
+  /**
+   * Stable form identifier — same value the form's `FormStateProvider`
+   * uses. Lets the chip scope presence by form when multiple forms
+   * render on the same record (action modals, etc.).
+   */
+  formId:    string
+}
+
+let _component: ComponentType<FieldPresenceProps> | null = null
+
+/**
+ * Register a component that renders inside `FieldShell`'s label area
+ * for every controlled field. Called once at boot by a collab plugin.
+ * No-op when no plugin registers — `FieldShell` skips the slot.
+ */
+export function registerFieldPresenceComponent(C: ComponentType<FieldPresenceProps>): void {
+  _component = C
+}
+
+/** Returns the registered presence component, or `null`. */
+export function getFieldPresenceComponent(): ComponentType<FieldPresenceProps> | null {
+  return _component
+}

package/src/react/FormCollabBindingRegistry.ts

@@ -1,5 +1,44 @@
+import type { ElementMeta } from '../schema/Element.js'
 import type { CollabRoom } from './CollabRoomContext.js'
 
+/**
+ * Phase F.6 — character-level edit op emitted by `TextLikeInput` and
+ * applied through `TextBinding.applyDelta`. `replace` covers IME / paste
+ * / multi-char selections; `insert` and `delete` cover the single-key
+ * common path. Pilotiq core stays Yjs-free — the binding impl in
+ * `@pilotiq-pro/collab` translates these into `Y.Text.insert / delete`
+ * inside a transaction.
+ */
+export type TextDelta =
+  | { kind: 'insert',  index: number,  text: string }
+  | { kind: 'delete',  index: number,  length: number }
+  | { kind: 'replace', from:  number,  to: number, text: string }
+
+/**
+ * Phase F.6 — per-field character-level CRDT handle. Issued by
+ * `FormCollabBinding.getTextBinding(name)` for text-shaped fields
+ * (`TextField / TextareaField / EmailField / SlugField / MarkdownField`);
+ * returns `null` for non-text fields or text fields opted out via
+ * `.collab(false)`. The surface stays intentionally narrow so pilotiq
+ * core never touches Yjs directly — same posture as `FormCollabBinding`.
+ *
+ *   - `read()` returns the current full string. `TextLikeInput` calls
+ *     this once on mount to seed its controlled value.
+ *   - `applyDelta(delta)` is called from `onInput` events with a single
+ *     `insert / delete / replace` op derived from the input's selection.
+ *   - `observe(fn)` registers a remote-change listener; `fn(next)`
+ *     receives the post-change string. Returns an unsubscribe function.
+ *   - `destroy()` cleans up everything the handle holds. The owning
+ *     `FormCollabBinding.destroy()` is expected to cascade — consumers
+ *     don't need to call this directly.
+ */
+export interface TextBinding {
+  read():     string
+  applyDelta(delta: TextDelta): void
+  observe(fn: (next: string) => void): () => void
+  destroy():  void
+}
+
 /**
  * Binding contract that a collab plugin returns from
  * `registerFormCollabBinding` — wraps a single form's value map in a
@@ -16,8 +55,14 @@ import type { CollabRoom } from './CollabRoomContext.js'
  *   - `subscribe(fn)` registers a listener that fires when REMOTE
  *     changes land; `fn(snapshot)` receives the full updated map.
  *     The provider re-applies this snapshot onto its React state.
+ *   - `getTextBinding(name)` (Phase F.6) returns a `Y.Text`-backed
+ *     handle for text-shaped fields, or `null` for non-text fields and
+ *     text fields opted out via `.collab(false)`. The text/non-text
+ *     allowlist lives in the binding impl — `FormStateProvider` asks
+ *     for every field and routes per-field on the answer.
  *   - `destroy()` is called on unmount — gives the plugin a chance to
- *     remove its CRDT observer.
+ *     remove its CRDT observer. Implementations are expected to cascade
+ *     into every `TextBinding` they issued.
  *
  * `unknown` payloads keep pilotiq core Yjs-free; the binding owns its
  * own type knowledge. Same posture as `CollabExtensionFactory`.
@@ -29,6 +74,12 @@ export interface FormCollabBinding {
   set(name: string, value: unknown): void
   /** Subscribe to remote changes. Returns an unsubscribe function. */
   subscribe(fn: (snapshot: Record<string, unknown>) => void): () => void
+  /** Phase F.6 — per-field text-CRDT handle. Returns `null` for non-text
+   *  fields or text fields opted out via `.collab(false)`. Optional so
+   *  existing F1-era plugins keep type-checking without a no-op stub;
+   *  when absent, every text field stays on today's whole-string LWW
+   *  path (i.e. F.6 character-level CRDT is opt-in by impl). */
+  getTextBinding?(name: string): TextBinding | null
   /** Cleanup hook called when the form unmounts. */
   destroy():    void
 }
@@ -51,6 +102,17 @@ export interface FormCollabBindingFactoryArgs {
    * map already populated and skip.
    */
   initial: Record<string, unknown>
+  /**
+   * Phase F.6 — initial form meta from the server. The binding walks
+   * this once at construction to decide which fields are text-shaped
+   * (`fieldType ∈ { text, textarea, email, slug, markdown }`) and
+   * which have opted out via `.collab(false)`. Text fields get a
+   * dedicated `Y.Text` and route through `getTextBinding`; non-text
+   * fields stay on the `Y.Map`. The meta is captured at mount; later
+   * structural changes from `live()` re-resolves aren't re-walked
+   * (rare in practice — dynamic field add/remove is an F-followup).
+   */
+  formMeta: ElementMeta
 }
 
 export type FormCollabBindingFactory = (args: FormCollabBindingFactoryArgs) => FormCollabBinding