deepspace 0.10.1 → 0.10.3

package/features/{docs/src/DocsPresence.tsx → documents/src/DocumentsPresence.tsx}

@@ -1,6 +1,6 @@
 import { useMemo, useState } from 'react'
 
-export interface DocsPresenceParticipant {
+export interface DocumentsPresenceParticipant {
   clientId: number
   userId: string
   name: string
@@ -12,15 +12,15 @@ export interface DocsPresenceParticipant {
   isSelf?: boolean
 }
 
-export interface DocsPresenceProps {
-  participants: DocsPresenceParticipant[]
+export interface DocumentsPresenceProps {
+  participants: DocumentsPresenceParticipant[]
   typingNames: string[]
 }
 
 const MAX_VISIBLE_AVATARS = 3
 
 /** Stable React keys (Yjs clientId is not used for PresenceRoom peers). */
-function participantKey(p: DocsPresenceParticipant) {
+function participantKey(p: DocumentsPresenceParticipant) {
   return `${p.userId}:${p.isSelf ? 'self' : 'peer'}`
 }
 
@@ -37,14 +37,14 @@ function typingText(names: string[]) {
   return `${names[0]}, ${names[1]}, and ${names.length - 2} more are typing...`
 }
 
-function ParticipantAvatar({ participant, index }: { participant: DocsPresenceParticipant; index: number }) {
+function ParticipantAvatar({ participant, index }: { participant: DocumentsPresenceParticipant; index: number }) {
   const label = `${participant.name}${participant.isSelf ? ' (you)' : ''} - ${
     participant.mode === 'edit' ? 'Editing' : 'Viewing'
   }`
 
   return (
     <span
-      className="docs-presence-avatar"
+      className="documents-presence-avatar"
       style={{ zIndex: 20 - index }}
       title={label}
       aria-label={label}
@@ -58,7 +58,7 @@ function ParticipantAvatar({ participant, index }: { participant: DocsPresencePa
   )
 }
 
-export function DocsPresence({ participants, typingNames }: DocsPresenceProps) {
+export function DocumentsPresence({ participants, typingNames }: DocumentsPresenceProps) {
   const [open, setOpen] = useState(false)
   const visibleParticipants = participants.slice(0, MAX_VISIBLE_AVATARS)
   const hiddenCount = Math.max(0, participants.length - MAX_VISIBLE_AVATARS)
@@ -72,12 +72,12 @@ export function DocsPresence({ participants, typingNames }: DocsPresenceProps) {
   }, [participants.length])
 
   return (
-    <div className="relative flex shrink-0 items-center gap-2" data-testid="docs-presence">
+    <div className="relative flex shrink-0 items-center gap-2" data-testid="documents-presence">
       {message ? (
         <span
           className="hidden max-w-[220px] truncate text-xs sm:inline"
-          style={{ color: 'var(--docs-el-muted)' }}
-          data-testid="docs-typing-indicator"
+          style={{ color: 'var(--documents-el-muted)' }}
+          data-testid="documents-typing-indicator"
         >
           {message}
         </span>
@@ -90,11 +90,11 @@ export function DocsPresence({ participants, typingNames }: DocsPresenceProps) {
         {hiddenCount > 0 ? (
           <button
             type="button"
-            className="docs-presence-more"
+            className="documents-presence-more"
             onClick={() => setOpen((value) => !value)}
             aria-expanded={open}
             aria-label={`View ${hiddenCount} more collaborator${hiddenCount === 1 ? '' : 's'}`}
-            data-testid="docs-presence-more"
+            data-testid="documents-presence-more"
           >
             +{hiddenCount}
           </button>
@@ -105,13 +105,13 @@ export function DocsPresence({ participants, typingNames }: DocsPresenceProps) {
         <div
           className="absolute right-0 top-9 z-50 w-64 rounded-xl border p-2 shadow-xl"
           style={{
-            borderColor: 'var(--docs-el-line)',
-            backgroundColor: 'var(--docs-el-surface)',
-            color: 'var(--docs-el-text)',
+            borderColor: 'var(--documents-el-line)',
+            backgroundColor: 'var(--documents-el-surface)',
+            color: 'var(--documents-el-text)',
           }}
-          data-testid="docs-presence-popover"
+          data-testid="documents-presence-popover"
         >
-          <p className="px-2 pb-2 text-xs font-medium" style={{ color: 'var(--docs-el-muted)' }}>
+          <p className="px-2 pb-2 text-xs font-medium" style={{ color: 'var(--documents-el-muted)' }}>
             {heading}
           </p>
           <ul className="max-h-72 overflow-y-auto">
@@ -123,7 +123,7 @@ export function DocsPresence({ participants, typingNames }: DocsPresenceProps) {
                     {participant.name}
                     {participant.isSelf ? ' (you)' : ''}
                   </p>
-                  <p className="truncate text-xs" style={{ color: 'var(--docs-el-muted)' }}>
+                  <p className="truncate text-xs" style={{ color: 'var(--documents-el-muted)' }}>
                     {participant.mode === 'edit' ? 'Editing' : 'Viewing'}
                     {participant.typing ? ' - typing' : ''}
                   </p>

package/features/{docs → documents}/src/InviteDialog.tsx

@@ -3,7 +3,7 @@ import type { RecordData } from 'deepspace'
 import { useMutations, useQuery, useUser } from 'deepspace'
 import { Mail, ShieldCheck, UserMinus, Users } from 'lucide-react'
 import { Modal, useToast } from '@/components/ui'
-import { parseDocsIdList, type DocsDocumentFields, type InviteAclDiff } from './docs-library-types'
+import { parseDocumentsIdList, type DocumentsDocumentFields, type InviteAclDiff } from './documents-library-types'
 
 interface UserFields {
   email?: string
@@ -16,7 +16,7 @@ type InviteRole = 'viewer' | 'editor'
 interface InviteDialogProps {
   open: boolean
   onOpenChange: (open: boolean) => void
-  doc: RecordData<DocsDocumentFields>
+  doc: RecordData<DocumentsDocumentFields>
   isOwner: boolean
   /**
    * Called after a save mutation that changed the ACL. The parent uses it to
@@ -43,17 +43,17 @@ function initialsFor(name: string): string {
 export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }: InviteDialogProps) {
   const { user } = useUser()
   const { records: users } = useQuery<UserFields>('users')
-  const { put } = useMutations<DocsDocumentFields>('documents')
+  const { put } = useMutations<DocumentsDocumentFields>('documents')
   const toast = useToast()
   const [email, setEmail] = useState('')
   const [role, setRole] = useState<InviteRole>('editor')
   const [saving, setSaving] = useState(false)
 
   const collaborators = useMemo(
-    () => parseDocsIdList(doc.data.collaborators),
+    () => parseDocumentsIdList(doc.data.collaborators),
     [doc.data.collaborators],
   )
-  const editors = useMemo(() => parseDocsIdList(doc.data.editors), [doc.data.editors])
+  const editors = useMemo(() => parseDocumentsIdList(doc.data.editors), [doc.data.editors])
 
   const ownerRecord = useMemo(
     () => users.find((u) => u.recordId === doc.data.ownerId),
@@ -71,8 +71,8 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
   if (!isOwner) return null
 
   const saveAccess = async (nextCollaborators: string[], nextEditors: string[]) => {
-    const prevCollaborators = parseDocsIdList(doc.data.collaborators)
-    const prevEditors = parseDocsIdList(doc.data.editors)
+    const prevCollaborators = parseDocumentsIdList(doc.data.collaborators)
+    const prevEditors = parseDocumentsIdList(doc.data.editors)
     const nextCollabList = uniqueIds(nextCollaborators)
     const nextCollabSet = new Set(nextCollabList)
     const nextEditorList = uniqueIds(nextEditors).filter((id) => nextCollabSet.has(id))
@@ -151,7 +151,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
     'Owner'
 
   return (
-    <Modal open={open} onClose={() => onOpenChange(false)} size="lg" className="docs-feature-scope">
+    <Modal open={open} onClose={() => onOpenChange(false)} size="lg" className="documents-feature-scope">
       <Modal.Header>
         <Modal.Title>Share document</Modal.Title>
         <Modal.Description>
@@ -160,10 +160,10 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
       </Modal.Header>
 
       <Modal.Body className="space-y-5">
-        <div className="rounded-xl border p-3" style={{ borderColor: 'var(--docs-el-line)' }}>
+        <div className="rounded-xl border p-3" style={{ borderColor: 'var(--documents-el-line)' }}>
           <label
             className="mb-2 block text-xs font-semibold uppercase tracking-wide"
-            style={{ color: 'var(--docs-el-muted)' }}
+            style={{ color: 'var(--documents-el-muted)' }}
           >
             Add people
           </label>
@@ -171,7 +171,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
             <div className="relative min-w-0 flex-1">
               <Mail
                 className="pointer-events-none absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2"
-                style={{ color: 'var(--docs-el-muted)' }}
+                style={{ color: 'var(--documents-el-muted)' }}
               />
               <input
                 value={email}
@@ -181,14 +181,14 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                 }}
                 placeholder="person@gmail.com"
                 className="h-10 w-full rounded-lg border bg-transparent pl-9 pr-3 text-sm outline-none focus-visible:ring-2 focus-visible:ring-ring/30"
-                style={{ borderColor: 'var(--docs-el-line)', color: 'var(--docs-el-text)' }}
+                style={{ borderColor: 'var(--documents-el-line)', color: 'var(--documents-el-text)' }}
               />
             </div>
             <select
               value={role}
               onChange={(e) => setRole(e.target.value as InviteRole)}
               className="h-10 rounded-lg border bg-transparent px-3 text-sm font-medium outline-none focus-visible:ring-2 focus-visible:ring-ring/30"
-              style={{ borderColor: 'var(--docs-el-line)', color: 'var(--docs-el-text)' }}
+              style={{ borderColor: 'var(--documents-el-line)', color: 'var(--documents-el-text)' }}
             >
               <option value="editor">Editor</option>
               <option value="viewer">Viewer</option>
@@ -198,7 +198,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
               onClick={() => void addInvite()}
               disabled={saving || !email.trim()}
               className="h-10 rounded-lg px-4 text-sm font-semibold text-white transition-opacity hover:opacity-90 disabled:cursor-not-allowed disabled:opacity-50"
-              style={{ backgroundColor: 'var(--docs-el-accent)' }}
+              style={{ backgroundColor: 'var(--documents-el-accent)' }}
             >
               Add
             </button>
@@ -207,21 +207,21 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
 
         <div>
           <div className="mb-3 flex items-center gap-2">
-            <Users className="h-4 w-4" style={{ color: 'var(--docs-el-muted)' }} />
+            <Users className="h-4 w-4" style={{ color: 'var(--documents-el-muted)' }} />
             <h3 className="text-sm font-semibold">People with access</h3>
           </div>
 
           <div className="space-y-2">
             <div
               className="flex items-center gap-3 rounded-xl border p-3"
-              style={{ borderColor: 'var(--docs-el-line)' }}
+              style={{ borderColor: 'var(--documents-el-line)' }}
             >
               <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-full bg-black/5 text-xs font-bold dark:bg-white/10">
                 {initialsFor(ownerName)}
               </div>
               <div className="min-w-0 flex-1">
                 <div className="truncate text-sm font-medium">{ownerName}</div>
-                <div className="truncate text-xs" style={{ color: 'var(--docs-el-muted)' }}>
+                <div className="truncate text-xs" style={{ color: 'var(--documents-el-muted)' }}>
                   {ownerRecord?.data.email ?? user?.email ?? 'Owner'}
                 </div>
               </div>
@@ -238,7 +238,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                 <div
                   key={u.recordId}
                   className="flex items-center gap-3 rounded-xl border p-3"
-                  style={{ borderColor: 'var(--docs-el-line)' }}
+                  style={{ borderColor: 'var(--documents-el-line)' }}
                 >
                   {u.data.imageUrl ? (
                     <img
@@ -253,7 +253,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                   )}
                   <div className="min-w-0 flex-1">
                     <div className="truncate text-sm font-medium">{name}</div>
-                    <div className="truncate text-xs" style={{ color: 'var(--docs-el-muted)' }}>
+                    <div className="truncate text-xs" style={{ color: 'var(--documents-el-muted)' }}>
                       {u.data.email ?? 'No email'}
                     </div>
                   </div>
@@ -264,7 +264,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                     }
                     disabled={saving}
                     className="h-8 rounded-lg border bg-transparent px-2 text-xs font-medium outline-none"
-                    style={{ borderColor: 'var(--docs-el-line)', color: 'var(--docs-el-text)' }}
+                    style={{ borderColor: 'var(--documents-el-line)', color: 'var(--documents-el-text)' }}
                   >
                     <option value="editor">Editor</option>
                     <option value="viewer">Viewer</option>
@@ -285,7 +285,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
             {collaboratorRecords.length === 0 ? (
               <p
                 className="rounded-xl border p-3 text-sm"
-                style={{ color: 'var(--docs-el-muted)' }}
+                style={{ color: 'var(--documents-el-muted)' }}
               >
                 Only the owner can access this document.
               </p>

package/features/{docs → documents}/src/LibrarySidebar.tsx

@@ -1,5 +1,5 @@
 /**
- * Etheris-style library sidebar — nav + folders (docs2-aligned UI).
+ * Etheris-style library sidebar — nav + folders (documents2-aligned UI).
  */
 
 import {
@@ -23,9 +23,9 @@ import {
   Trash2,
   Users,
 } from 'lucide-react'
-import type { DocFolderFields, LibraryNavSelection } from './docs-library-types'
+import type { DocFolderFields, LibraryNavSelection } from './documents-library-types'
 
-const SIDEBAR_COLLAPSED_KEY = 'deepspace-docs-library-sidebar-collapsed'
+const SIDEBAR_COLLAPSED_KEY = 'deepspace-documents-library-sidebar-collapsed'
 
 export function readSidebarCollapsed(): boolean {
   if (typeof window === 'undefined') return false
@@ -70,8 +70,8 @@ function NavRow({
         title={collapsed ? label : undefined}
         className={`flex h-9 min-w-0 flex-1 items-center gap-0 rounded-md pl-0.5 pr-0 text-left text-[13px] ${
           active
-            ? 'bg-[color:var(--docs-el-accent)] font-medium text-white shadow-sm'
-            : 'text-[color:var(--docs-el-text)]/80 transition-colors hover:bg-black/[0.04] hover:text-[color:var(--docs-el-text)] dark:hover:bg-white/[0.06]'
+            ? 'bg-[color:var(--documents-el-accent)] font-medium text-white shadow-sm'
+            : 'text-[color:var(--documents-el-text)]/80 transition-colors hover:bg-black/[0.04] hover:text-[color:var(--documents-el-text)] dark:hover:bg-white/[0.06]'
         }`}
       >
         <span className="flex h-9 w-10 shrink-0 items-center justify-center" aria-hidden>
@@ -170,9 +170,9 @@ function SidebarFolderRenameField({
       data-testid={testId}
       className="min-w-0 flex-1 rounded-md border px-2 py-1.5 text-[13px] outline-none focus-visible:ring-2 focus-visible:ring-ring/30"
       style={{
-        borderColor: 'var(--docs-el-line)',
-        backgroundColor: 'var(--docs-el-bg)',
-        color: 'var(--docs-el-text)',
+        borderColor: 'var(--documents-el-line)',
+        backgroundColor: 'var(--documents-el-bg)',
+        color: 'var(--documents-el-text)',
       }}
     />
   )
@@ -249,8 +249,8 @@ export function LibrarySidebar({
         collapsed ? 'w-16' : 'w-64'
       }`}
       style={{
-        borderColor: 'var(--docs-el-line)',
-        backgroundColor: 'color-mix(in srgb, var(--docs-el-surface) 92%, transparent)',
+        borderColor: 'var(--documents-el-line)',
+        backgroundColor: 'color-mix(in srgb, var(--documents-el-surface) 92%, transparent)',
       }}
     >
       <div className="flex h-full min-h-0 flex-col">
@@ -258,7 +258,7 @@ export function LibrarySidebar({
           className={`relative flex min-h-14 w-full min-w-0 items-center overflow-hidden border-b py-3 pl-3.5 ${
             collapsed ? 'pr-2.5' : 'pr-12'
           }`}
-          style={{ borderColor: 'var(--docs-el-line)' }}
+          style={{ borderColor: 'var(--documents-el-line)' }}
         >
           <div
             className={`flex min-w-0 flex-1 items-center gap-2.5 overflow-hidden ${
@@ -270,10 +270,10 @@ export function LibrarySidebar({
               <FileText className="text-blue-600 dark:text-blue-400" size={26} strokeWidth={2} />
             </div>
             <div className="min-w-0">
-              <span className="block truncate text-base font-bold leading-tight tracking-tight text-[color:var(--docs-el-text)]">
+              <span className="block truncate text-base font-bold leading-tight tracking-tight text-[color:var(--documents-el-text)]">
                 Documents
               </span>
-              <span className="block truncate text-[10px] font-semibold uppercase tracking-widest text-[color:var(--docs-el-muted)]/75">
+              <span className="block truncate text-[10px] font-semibold uppercase tracking-widest text-[color:var(--documents-el-muted)]/75">
                 Workspace
               </span>
             </div>
@@ -282,8 +282,8 @@ export function LibrarySidebar({
             type="button"
             data-testid="library-sidebar-collapse"
             onClick={onToggleCollapsed}
-            className="absolute right-2.5 top-1/2 z-10 flex h-8 w-9 -translate-y-1/2 items-center justify-center rounded-md transition-colors hover:bg-black/[0.04] hover:text-[color:var(--docs-el-text)] dark:hover:bg-white/[0.06]"
-            style={{ color: 'var(--docs-el-muted)' }}
+            className="absolute right-2.5 top-1/2 z-10 flex h-8 w-9 -translate-y-1/2 items-center justify-center rounded-md transition-colors hover:bg-black/[0.04] hover:text-[color:var(--documents-el-text)] dark:hover:bg-white/[0.06]"
+            style={{ color: 'var(--documents-el-muted)' }}
             title={collapsed ? 'Show sidebar' : 'Hide sidebar'}
             aria-expanded={!collapsed}
           >
@@ -328,9 +328,9 @@ export function LibrarySidebar({
             collapsed={collapsed}
           />
 
-          <div className="mt-8 border-t pt-3" style={{ borderColor: 'var(--docs-el-line)' }}>
+          <div className="mt-8 border-t pt-3" style={{ borderColor: 'var(--documents-el-line)' }}>
             <span
-              className={`mb-2 block pl-2.5 pr-0 text-[10px] font-bold uppercase tracking-widest text-[color:var(--docs-el-muted)]/80 ${
+              className={`mb-2 block pl-2.5 pr-0 text-[10px] font-bold uppercase tracking-widest text-[color:var(--documents-el-muted)]/80 ${
                 collapsed ? 'pointer-events-none select-none opacity-0' : ''
               }`}
               aria-hidden={collapsed}
@@ -342,10 +342,10 @@ export function LibrarySidebar({
                 renamingFolderId === f.recordId ? (
                   <div
                     key={f.recordId}
-                    className="group flex w-full min-w-0 items-center gap-0.5 rounded-md bg-[color:var(--docs-el-accent)]/10 py-0.5 pl-0.5 dark:bg-[color:var(--docs-el-accent)]/15"
+                    className="group flex w-full min-w-0 items-center gap-0.5 rounded-md bg-[color:var(--documents-el-accent)]/10 py-0.5 pl-0.5 dark:bg-[color:var(--documents-el-accent)]/15"
                   >
                     <span
-                      className="flex h-9 w-10 shrink-0 items-center justify-center text-[color:var(--docs-el-muted)]"
+                      className="flex h-9 w-10 shrink-0 items-center justify-center text-[color:var(--documents-el-muted)]"
                       aria-hidden
                     >
                       <Folder size={14} strokeWidth={1.8} />
@@ -383,7 +383,7 @@ export function LibrarySidebar({
                             e.stopPropagation()
                             onStartRenameFolder(f)
                           }}
-                          className="rounded p-1 text-[color:var(--docs-el-muted)] opacity-0 transition-all hover:bg-black/[0.04] hover:text-[color:var(--docs-el-accent)] group-hover:opacity-100 dark:hover:bg-white/[0.06]"
+                          className="rounded p-1 text-[color:var(--documents-el-muted)] opacity-0 transition-all hover:bg-black/[0.04] hover:text-[color:var(--documents-el-accent)] group-hover:opacity-100 dark:hover:bg-white/[0.06]"
                           title="Rename folder"
                           aria-label={`Rename folder ${f.data.name}`}
                         >
@@ -402,7 +402,7 @@ export function LibrarySidebar({
                               void onDeleteFolder(f.recordId)
                             }
                           }}
-                          className="rounded p-1 text-[color:var(--docs-el-muted)] opacity-0 transition-all hover:bg-red-500/10 hover:text-red-600 group-hover:opacity-100"
+                          className="rounded p-1 text-[color:var(--documents-el-muted)] opacity-0 transition-all hover:bg-red-500/10 hover:text-red-600 group-hover:opacity-100"
                           title="Delete folder"
                           aria-label={`Delete folder ${f.data.name}`}
                         >
@@ -432,9 +432,9 @@ export function LibrarySidebar({
                     data-testid="new-folder-input"
                     className="w-full rounded-md border px-2 py-1.5 text-[13px] outline-none focus-visible:ring-2 focus-visible:ring-ring/30"
                     style={{
-                      borderColor: 'var(--docs-el-line)',
-                      backgroundColor: 'var(--docs-el-bg)',
-                      color: 'var(--docs-el-text)',
+                      borderColor: 'var(--documents-el-line)',
+                      backgroundColor: 'var(--documents-el-bg)',
+                      color: 'var(--documents-el-text)',
                     }}
                   />
                 </div>
@@ -451,7 +451,7 @@ export function LibrarySidebar({
                     if (name) void onCreateFolder(name)
                   }}
                   title={collapsed ? 'New folder' : undefined}
-                  className="flex h-9 w-full min-w-0 items-center gap-0 rounded-md pl-0.5 pr-0 text-left text-[13px] text-[color:var(--docs-el-muted)] transition-colors hover:bg-black/[0.04] hover:text-[color:var(--docs-el-accent)] dark:hover:bg-white/[0.06]"
+                  className="flex h-9 w-full min-w-0 items-center gap-0 rounded-md pl-0.5 pr-0 text-left text-[13px] text-[color:var(--documents-el-muted)] transition-colors hover:bg-black/[0.04] hover:text-[color:var(--documents-el-accent)] dark:hover:bg-white/[0.06]"
                 >
                   <span className="flex h-9 w-10 shrink-0 items-center justify-center" aria-hidden>
                     <FolderPlus className="h-3.5 w-3.5 shrink-0" />

package/features/documents/src/__tests__/documents-presence-access.test.ts

@@ -0,0 +1,71 @@
+import { describe, expect, it } from 'vitest'
+import {
+  deriveDocumentsAccessChange,
+  detectDocumentsAclEvent,
+  isDocumentsOwner,
+  resolveDocumentsAccessRole,
+} from '../use-documents-presence-access'
+
+describe('document access policy', () => {
+  const document = {
+    data: {
+      ownerId: 'owner',
+      collaborators: JSON.stringify(['editor', 'viewer']),
+      editors: JSON.stringify(['editor']),
+    },
+  }
+
+  it('resolves owner, editor, viewer, and no-access roles from the document ACL', () => {
+    expect(resolveDocumentsAccessRole(document, 'owner')).toBe('owner')
+    expect(resolveDocumentsAccessRole(document, 'editor')).toBe('editor')
+    expect(resolveDocumentsAccessRole(document, 'viewer')).toBe('viewer')
+    expect(resolveDocumentsAccessRole(document, 'outsider')).toBe('none')
+    expect(resolveDocumentsAccessRole(document, null)).toBe('none')
+  })
+
+  it('does not expose owner controls while both the document and user are loading', () => {
+    expect(isDocumentsOwner(undefined, undefined)).toBe(false)
+    expect(isDocumentsOwner(document, undefined)).toBe(false)
+    expect(isDocumentsOwner(undefined, 'owner')).toBe(false)
+    expect(isDocumentsOwner(document, 'owner')).toBe(true)
+  })
+
+  it('treats malformed ACL fields as empty lists', () => {
+    const malformed = {
+      data: { ownerId: 'owner', collaborators: '{broken', editors: JSON.stringify('editor') },
+    }
+    expect(resolveDocumentsAccessRole(malformed, 'editor')).toBe('none')
+  })
+
+  it('derives only actionable transitions from the session baseline', () => {
+    expect(deriveDocumentsAccessChange('editor', 'viewer', null)).toBe('downgrade')
+    expect(deriveDocumentsAccessChange('viewer', 'editor', null)).toBe('upgrade')
+    expect(deriveDocumentsAccessChange('viewer', 'none', null)).toBe('revoked')
+    expect(deriveDocumentsAccessChange('owner', 'owner', null)).toBeNull()
+    expect(deriveDocumentsAccessChange(null, 'viewer', { kind: 'downgrade', at: 20 })).toBe('downgrade')
+    expect(deriveDocumentsAccessChange('editor', 'viewer', { kind: 'revoked', at: 20 })).toBe('revoked')
+  })
+
+  it('accepts only a fresh ACL signal addressed to the current user', () => {
+    const state = {
+      aclSignal: {
+        at: 20,
+        removed: ['removed-user'],
+        demoted: ['demoted-user'],
+        promoted: ['promoted-user'],
+      },
+    }
+
+    expect(detectDocumentsAclEvent(state, 'removed-user', 10)).toEqual({ kind: 'revoked', at: 20 })
+    expect(detectDocumentsAclEvent(state, 'demoted-user', 10)).toEqual({
+      kind: 'downgrade',
+      at: 20,
+    })
+    expect(detectDocumentsAclEvent(state, 'promoted-user', 10)).toEqual({
+      kind: 'upgrade',
+      at: 20,
+    })
+    expect(detectDocumentsAclEvent(state, 'other-user', 10)).toBeNull()
+    expect(detectDocumentsAclEvent(state, 'removed-user', 20)).toBeNull()
+  })
+})

package/features/{docs/src/docs-library-types.ts → documents/src/documents-library-types.ts}

@@ -1,6 +1,6 @@
-/** Shared document, ACL, folder, and navigation model for the Docs feature. */
+/** Shared document, ACL, folder, and navigation model for the Documents feature. */
 
-export interface DocsDocumentFields {
+export interface DocumentsDocumentFields {
   title: string
   ownerId: string
   collaborators?: string
@@ -29,7 +29,7 @@ export type LibraryNavSelection =
   | { kind: 'uncategorized' }
   | { kind: 'folder'; folderId: string }
 
-export function parseDocsIdList(raw: string | undefined): string[] {
+export function parseDocumentsIdList(raw: string | undefined): string[] {
   if (!raw) return []
   try {
     const parsed: unknown = JSON.parse(raw)

package/features/{docs/src/docs-schema.ts → documents/src/documents-schema.ts}

@@ -1,11 +1,11 @@
 /**
- * Docs Feature — Record schemas
+ * Documents feature — record schemas
  *
- * `documents`: collaborative docs with optional folder placement.
+ * `documents`: collaborative documents with optional folder placement.
  * `doc_folders`: user-owned folders for library organization.
  */
 
-import type { CollectionSchema } from 'deepspace/worker'
+import type { CollectionSchema } from 'deepspace/schema'
 
 const folderPermissions = {
   viewer: {
@@ -40,7 +40,7 @@ export const docFoldersSchema: CollectionSchema = {
   permissions: folderPermissions,
 }
 
-export const docsSchema: CollectionSchema = {
+export const documentsSchema: CollectionSchema = {
   name: 'documents',
   columns: [
     { name: 'title', storage: 'text', interpretation: 'plain', required: true },
@@ -76,5 +76,5 @@ export const docsSchema: CollectionSchema = {
   },
 }
 
-/** Pass into `schemas` with spread: `[...docsCollections, ...]` */
-export const docsCollections: CollectionSchema[] = [docsSchema, docFoldersSchema]
+/** Pass into `schemas` with spread: `[...documentsCollections, ...]` */
+export const documentsCollections: CollectionSchema[] = [documentsSchema, docFoldersSchema]