@arbidocs/react 0.5.110 → 0.5.112

package/dist/entities/registry.js

@@ -0,0 +1,385 @@
+import React from "react";
+import { vocabularyNoun } from "./vocabulary.js";
+import {
+  UserStar,
+  Bell,
+  Building2,
+  Contact,
+  Scale,
+  Search,
+  Tags,
+  BookOpen,
+  CaptionsOff,
+  ChevronsDown,
+  CircleUserRound,
+  ClipboardList,
+  Columns3Cog,
+  Eye,
+  EyeOff,
+  FileQuestion,
+  FolderOpen,
+  FolderPlus,
+  Hash,
+  Info,
+  LayoutGrid,
+  LogOut,
+  MessageSquare,
+  MessageSquareLock,
+  MessageSquareMore,
+  MessageSquareOff,
+  MessageSquarePlus,
+  MessageSquareText,
+  MessagesSquare,
+  NotebookPen,
+  NotebookText,
+  CreditCard,
+  Settings2,
+  SquareM,
+  SquarePlus,
+  StickyNote,
+  Upload,
+  User,
+  UserPlus,
+  Users,
+  Wrench
+} from "lucide-react";
+const ENTITY_MAPPINGS = {
+  PRODUCT: {
+    NAMES: {
+      SINGULAR: "ARBI Docs"
+    },
+    ICONS: {
+      DEFAULT: MessageSquareLock
+    }
+  },
+  SECTION: {
+    NAMES: {
+      SINGULAR: "Section"
+    },
+    ICONS: {
+      DEFAULT: ChevronsDown
+    }
+  },
+  WORKSPACE: {
+    NAMES: {
+      SINGULAR: "Workspace",
+      PLURAL: "Workspaces"
+    },
+    ICONS: {
+      DEFAULT: SquareM,
+      NEW: SquarePlus,
+      LIST: LayoutGrid,
+      SETTINGS: Columns3Cog
+    }
+  },
+  CONVERSATION: {
+    NAMES: {
+      SINGULAR: "Thread",
+      PLURAL: "Threads",
+      NEW: "New Thread"
+    },
+    ICONS: {
+      DEFAULT: MessagesSquare,
+      OFF: MessageSquareOff,
+      ACTIVE: MessageSquareText,
+      NEW: MessageSquarePlus,
+      LIST: MessageSquareMore
+    }
+  },
+  DOCUMENT: {
+    NAMES: {
+      SINGULAR: "File",
+      PLURAL: "Files"
+    },
+    ICONS: {
+      DEFAULT: FolderOpen,
+      OFF: CaptionsOff
+    }
+  },
+  VIEWER: {
+    NAMES: {
+      SINGULAR: "Viewer",
+      PLURAL: "Viewers"
+    },
+    ICONS: {
+      DEFAULT: Eye,
+      OFF: EyeOff
+    }
+  },
+  TAG: {
+    NAMES: {
+      SINGULAR: "Field",
+      PLURAL: "Fields"
+    },
+    ICONS: {
+      DEFAULT: Hash,
+      NEW: FolderPlus
+    }
+  },
+  ANNOTATION: {
+    NAMES: {
+      SINGULAR: "Annotation",
+      PLURAL: "Annotations"
+    },
+    ICONS: {
+      DEFAULT: StickyNote,
+      NEW: StickyNote
+    }
+  },
+  // A tag of any kind — what the Tags page lists. TAG stays "Field": the Files page's custom
+  // columns (labels and annotations as document fields) are named after it.
+  ANY_TAG: {
+    NAMES: {
+      SINGULAR: "Tag",
+      PLURAL: "Tags"
+    },
+    ICONS: {
+      DEFAULT: Tags
+    }
+  },
+  // The kinds of TAG (a tag's `kind`): a label files things; an issue is a point in dispute; a
+  // person and an organisation are entities the documents name; a saved search is a stored query.
+  LABEL: {
+    NAMES: {
+      SINGULAR: "Label",
+      PLURAL: "Labels"
+    },
+    ICONS: {
+      DEFAULT: Tags
+    }
+  },
+  ISSUE: {
+    NAMES: {
+      SINGULAR: "Issue",
+      PLURAL: "Issues"
+    },
+    ICONS: {
+      DEFAULT: Scale
+    }
+  },
+  PERSON: {
+    NAMES: {
+      SINGULAR: "Person",
+      PLURAL: "People"
+    },
+    ICONS: {
+      DEFAULT: Contact
+    }
+  },
+  ORGANISATION: {
+    NAMES: {
+      SINGULAR: "Organisation",
+      PLURAL: "Organisations"
+    },
+    ICONS: {
+      DEFAULT: Building2
+    }
+  },
+  SAVED_SEARCH: {
+    NAMES: {
+      SINGULAR: "Saved search",
+      PLURAL: "Saved searches"
+    },
+    ICONS: {
+      DEFAULT: Search
+    }
+  },
+  // A statement the workspace knows — a date, a decision, a preference — written by hand or kept by
+  // the assistant, optionally grounded in source passages (`facts`, fct-*). Distinct from
+  // ANNOTATION, a value attached TO a document; a fact is workspace-scoped and stands alone.
+  FACT: {
+    NAMES: {
+      SINGULAR: "Fact",
+      PLURAL: "Facts"
+    },
+    ICONS: {
+      DEFAULT: NotebookText,
+      NEW: NotebookPen
+    }
+  },
+  USER: {
+    NAMES: {
+      SINGULAR: "User",
+      PLURAL: "Users"
+    },
+    ICONS: {
+      DEFAULT: User,
+      NEW: UserPlus,
+      SETTINGS: Settings2
+    }
+  },
+  WORKSPACEUSER: {
+    NAMES: {
+      SINGULAR: "Member",
+      PLURAL: "Members"
+    },
+    ICONS: {
+      DEFAULT: User,
+      PLURAL: Users,
+      NEW: UserPlus,
+      SETTINGS: Settings2
+    }
+  },
+  CONTACT: {
+    NAMES: {
+      SINGULAR: "Contact",
+      PLURAL: "Contacts"
+    },
+    ICONS: {
+      // A starred person, not an address-book card: contacts here are the
+      // people you talk to, and the star reads as "your people".
+      DEFAULT: UserStar,
+      NEW: UserPlus
+    }
+  },
+  TASK: {
+    NAMES: {
+      SINGULAR: "Job",
+      PLURAL: "Jobs"
+    },
+    ICONS: {
+      DEFAULT: ClipboardList
+    }
+  },
+  PROJECT: {
+    NAMES: {
+      SINGULAR: "Project",
+      PLURAL: "Projects"
+    },
+    ICONS: {
+      DEFAULT: CreditCard
+    }
+  },
+  SKILL: {
+    NAMES: {
+      SINGULAR: "Skill",
+      PLURAL: "Skills"
+    },
+    ICONS: {
+      DEFAULT: Wrench
+    }
+  },
+  ACCOUNT: {
+    NAMES: {
+      SINGULAR: "Account"
+    },
+    ICONS: {
+      DEFAULT: CircleUserRound
+    }
+  },
+  NOTIFICATIONS: {
+    NAMES: {
+      SINGULAR: "Activity",
+      PLURAL: "Activities"
+    },
+    ICONS: {
+      DEFAULT: Bell
+    }
+  },
+  MESSAGE: {
+    NAMES: {
+      SINGULAR: "Message",
+      PLURAL: "Messages"
+    },
+    ICONS: {
+      DEFAULT: MessageSquare
+    }
+  },
+  NOTIFICATION: {
+    NAMES: {
+      SINGULAR: "Notification",
+      PLURAL: "Notifications"
+    },
+    ICONS: {
+      DEFAULT: Bell
+    }
+  },
+  APP: {
+    NAMES: {
+      SINGULAR: "Application",
+      PLURAL: "Applications"
+    },
+    ICONS: {
+      DEFAULT: LayoutGrid,
+      HOME: LayoutGrid,
+      LOGOUT: LogOut,
+      UPLOAD: Upload
+    }
+  },
+  HELP: {
+    NAMES: {
+      SINGULAR: "Help",
+      PLURAL: "Help"
+    },
+    ICONS: {
+      DEFAULT: MessageSquareLock,
+      DOCS: BookOpen,
+      FAQ: FileQuestion,
+      ABOUT: Info
+    }
+  },
+  USERSHIELD: {
+    NAMES: {
+      SINGULAR: "User Shield",
+      PLURAL: "User Shields"
+    },
+    ICONS: {
+      DEFAULT: MessageSquareLock
+    }
+  }
+};
+function configureEntityRegistry(overrides) {
+  for (const [type, def] of Object.entries(overrides)) {
+    const target = ENTITY_MAPPINGS[type];
+    if (!target) continue;
+    if (def?.NAMES) Object.assign(target.NAMES, def.NAMES);
+    if (def?.ICONS) Object.assign(target.ICONS, def.ICONS);
+  }
+}
+const getEntityIcon = (entityType, variant = "DEFAULT") => {
+  const icons = ENTITY_MAPPINGS[entityType]?.ICONS;
+  return icons?.[variant] || icons?.DEFAULT;
+};
+const getEntityLabel = (entityType, form = "SINGULAR") => {
+  const entityMapping = ENTITY_MAPPINGS[entityType];
+  if (!entityMapping) return "";
+  const noun = vocabularyNoun(entityType);
+  const names = noun === void 0 ? entityMapping.NAMES : typeof noun === "string" ? { SINGULAR: noun } : noun;
+  const singularName = names.SINGULAR || "";
+  if (form === "NEW") return names.NEW !== void 0 ? names.NEW : "New " + singularName;
+  if (form === "SHORT")
+    return names.SHORT !== void 0 ? names.SHORT : singularName.substring(0, 3) + ".";
+  if (form === "PLURAL") return names.PLURAL !== void 0 ? names.PLURAL : singularName + "s";
+  return singularName;
+};
+const entityNoun = (entityType, form = "SINGULAR") => getEntityLabel(entityType, form).toLowerCase();
+const EntityIcon = ({ entityType, variant = "DEFAULT", ...props }) => {
+  const IconComponent = getEntityIcon(entityType, variant);
+  return IconComponent ? React.createElement(IconComponent, props) : null;
+};
+const VISIBILITY_ICONS = {
+  PRIVATE: MessageSquareLock,
+  SHARED: Users
+};
+const VisibilityIcon = ({
+  isShared,
+  className,
+  ...props
+}) => {
+  const IconComponent = isShared ? VISIBILITY_ICONS.SHARED : VISIBILITY_ICONS.PRIVATE;
+  return React.createElement(IconComponent, {
+    ...props,
+    className: [isShared ? "text-secondary" : "text-primary", className].filter(Boolean).join(" ")
+  });
+};
+export {
+  ENTITY_MAPPINGS,
+  EntityIcon,
+  VISIBILITY_ICONS,
+  VisibilityIcon,
+  configureEntityRegistry,
+  entityNoun,
+  getEntityIcon,
+  getEntityLabel
+};
+//# sourceMappingURL=registry.js.map

package/dist/entities/registry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/entities/registry.tsx"],
+  "sourcesContent": ["/**\n * Entity registry \u2014 the single, canonical source of truth for entity icons and\n * display names across every ARBI app (monolith, clarum, any deployment).\n *\n * Centralises \"what glyph and what word represents a WORKSPACE / DOCUMENT / USER /\n * \u2026\" so rebranding or re-skinning happens in ONE place. The monolith and other\n * deployments layer their own flourishes on top via {@link configureEntityRegistry}\n * (e.g. a custom workspace glyph, or brand names like \"MatterSpace\") without\n * forking this map.\n *\n * Deliberately dependency-light: lucide icon components + plain data. No store,\n * no app `@/` imports. Consumers render via {@link EntityIcon} or read\n * {@link getEntityIcon}/{@link getEntityLabel}.\n */\n\nimport React from 'react'\nimport { vocabularyNoun } from './vocabulary'\nimport {\n  UserStar,\n  Bell,\n  Building2,\n  Contact,\n  Scale,\n  Search,\n  Tags,\n  BookOpen,\n  CaptionsOff,\n  ChevronsDown,\n  CircleUserRound,\n  ClipboardList,\n  Columns3Cog,\n  Eye,\n  EyeOff,\n  FileQuestion,\n  FolderOpen,\n  FolderPlus,\n  Hash,\n  Info,\n  LayoutGrid,\n  LogOut,\n  MessageSquare,\n  MessageSquareLock,\n  MessageSquareMore,\n  MessageSquareOff,\n  MessageSquarePlus,\n  MessageSquareText,\n  MessagesSquare,\n  NotebookPen,\n  NotebookText,\n  CreditCard,\n  Settings2,\n  SquareM,\n  SquarePlus,\n  StickyNote,\n  Upload,\n  User,\n  UserPlus,\n  Users,\n  Wrench,\n} from 'lucide-react'\n\n/** An icon component usable in the registry (lucide icons + custom SVG wrappers). */\nexport type EntityIconComponent = React.ComponentType<\n  React.SVGAttributes<SVGElement> & { size?: number | string; className?: string }\n>\n\n/**\n * Entity Mappings \u2014 naming conventions + icons for every entity in the app.\n *\n * `WORKSPACE.ICONS.DEFAULT` is the generic `SquareM` here; the monolith injects a\n * rotated variant via {@link configureEntityRegistry}. The object is mutated in\n * place by that helper, so existing `ENTITY_MAPPINGS` references stay live.\n */\nexport const ENTITY_MAPPINGS = {\n  PRODUCT: {\n    NAMES: {\n      SINGULAR: 'ARBI Docs',\n    },\n    ICONS: {\n      DEFAULT: MessageSquareLock,\n    },\n  },\n  SECTION: {\n    NAMES: {\n      SINGULAR: 'Section',\n    },\n    ICONS: {\n      DEFAULT: ChevronsDown,\n    },\n  },\n  WORKSPACE: {\n    NAMES: {\n      SINGULAR: 'Workspace',\n      PLURAL: 'Workspaces',\n    },\n    ICONS: {\n      DEFAULT: SquareM,\n      NEW: SquarePlus,\n      LIST: LayoutGrid,\n      SETTINGS: Columns3Cog,\n    },\n  },\n  CONVERSATION: {\n    NAMES: {\n      SINGULAR: 'Thread',\n      PLURAL: 'Threads',\n      NEW: 'New Thread',\n    },\n    ICONS: {\n      DEFAULT: MessagesSquare,\n      OFF: MessageSquareOff,\n      ACTIVE: MessageSquareText,\n      NEW: MessageSquarePlus,\n      LIST: MessageSquareMore,\n    },\n  },\n  DOCUMENT: {\n    NAMES: {\n      SINGULAR: 'File',\n      PLURAL: 'Files',\n    },\n    ICONS: {\n      DEFAULT: FolderOpen,\n      OFF: CaptionsOff,\n    },\n  },\n  VIEWER: {\n    NAMES: {\n      SINGULAR: 'Viewer',\n      PLURAL: 'Viewers',\n    },\n    ICONS: {\n      DEFAULT: Eye,\n      OFF: EyeOff,\n    },\n  },\n  TAG: {\n    NAMES: {\n      SINGULAR: 'Field',\n      PLURAL: 'Fields',\n    },\n    ICONS: {\n      DEFAULT: Hash,\n      NEW: FolderPlus,\n    },\n  },\n  ANNOTATION: {\n    NAMES: {\n      SINGULAR: 'Annotation',\n      PLURAL: 'Annotations',\n    },\n    ICONS: {\n      DEFAULT: StickyNote,\n      NEW: StickyNote,\n    },\n  },\n  // A tag of any kind \u2014 what the Tags page lists. TAG stays \"Field\": the Files page's custom\n  // columns (labels and annotations as document fields) are named after it.\n  ANY_TAG: {\n    NAMES: {\n      SINGULAR: 'Tag',\n      PLURAL: 'Tags',\n    },\n    ICONS: {\n      DEFAULT: Tags,\n    },\n  },\n  // The kinds of TAG (a tag's `kind`): a label files things; an issue is a point in dispute; a\n  // person and an organisation are entities the documents name; a saved search is a stored query.\n  LABEL: {\n    NAMES: {\n      SINGULAR: 'Label',\n      PLURAL: 'Labels',\n    },\n    ICONS: {\n      DEFAULT: Tags,\n    },\n  },\n  ISSUE: {\n    NAMES: {\n      SINGULAR: 'Issue',\n      PLURAL: 'Issues',\n    },\n    ICONS: {\n      DEFAULT: Scale,\n    },\n  },\n  PERSON: {\n    NAMES: {\n      SINGULAR: 'Person',\n      PLURAL: 'People',\n    },\n    ICONS: {\n      DEFAULT: Contact,\n    },\n  },\n  ORGANISATION: {\n    NAMES: {\n      SINGULAR: 'Organisation',\n      PLURAL: 'Organisations',\n    },\n    ICONS: {\n      DEFAULT: Building2,\n    },\n  },\n  SAVED_SEARCH: {\n    NAMES: {\n      SINGULAR: 'Saved search',\n      PLURAL: 'Saved searches',\n    },\n    ICONS: {\n      DEFAULT: Search,\n    },\n  },\n  // A statement the workspace knows \u2014 a date, a decision, a preference \u2014 written by hand or kept by\n  // the assistant, optionally grounded in source passages (`facts`, fct-*). Distinct from\n  // ANNOTATION, a value attached TO a document; a fact is workspace-scoped and stands alone.\n  FACT: {\n    NAMES: {\n      SINGULAR: 'Fact',\n      PLURAL: 'Facts',\n    },\n    ICONS: {\n      DEFAULT: NotebookText,\n      NEW: NotebookPen,\n    },\n  },\n  USER: {\n    NAMES: {\n      SINGULAR: 'User',\n      PLURAL: 'Users',\n    },\n    ICONS: {\n      DEFAULT: User,\n      NEW: UserPlus,\n      SETTINGS: Settings2,\n    },\n  },\n  WORKSPACEUSER: {\n    NAMES: {\n      SINGULAR: 'Member',\n      PLURAL: 'Members',\n    },\n    ICONS: {\n      DEFAULT: User,\n      PLURAL: Users,\n      NEW: UserPlus,\n      SETTINGS: Settings2,\n    },\n  },\n  CONTACT: {\n    NAMES: {\n      SINGULAR: 'Contact',\n      PLURAL: 'Contacts',\n    },\n    ICONS: {\n      // A starred person, not an address-book card: contacts here are the\n      // people you talk to, and the star reads as \"your people\".\n      DEFAULT: UserStar,\n      NEW: UserPlus,\n    },\n  },\n  TASK: {\n    NAMES: {\n      SINGULAR: 'Job',\n      PLURAL: 'Jobs',\n    },\n    ICONS: {\n      DEFAULT: ClipboardList,\n    },\n  },\n  PROJECT: {\n    NAMES: {\n      SINGULAR: 'Project',\n      PLURAL: 'Projects',\n    },\n    ICONS: {\n      DEFAULT: CreditCard,\n    },\n  },\n  SKILL: {\n    NAMES: {\n      SINGULAR: 'Skill',\n      PLURAL: 'Skills',\n    },\n    ICONS: {\n      DEFAULT: Wrench,\n    },\n  },\n  ACCOUNT: {\n    NAMES: {\n      SINGULAR: 'Account',\n    },\n    ICONS: {\n      DEFAULT: CircleUserRound,\n    },\n  },\n  NOTIFICATIONS: {\n    NAMES: {\n      SINGULAR: 'Activity',\n      PLURAL: 'Activities',\n    },\n    ICONS: {\n      DEFAULT: Bell,\n    },\n  },\n  MESSAGE: {\n    NAMES: {\n      SINGULAR: 'Message',\n      PLURAL: 'Messages',\n    },\n    ICONS: {\n      DEFAULT: MessageSquare,\n    },\n  },\n  NOTIFICATION: {\n    NAMES: {\n      SINGULAR: 'Notification',\n      PLURAL: 'Notifications',\n    },\n    ICONS: {\n      DEFAULT: Bell,\n    },\n  },\n  APP: {\n    NAMES: {\n      SINGULAR: 'Application',\n      PLURAL: 'Applications',\n    },\n    ICONS: {\n      DEFAULT: LayoutGrid,\n      HOME: LayoutGrid,\n      LOGOUT: LogOut,\n      UPLOAD: Upload,\n    },\n  },\n  HELP: {\n    NAMES: {\n      SINGULAR: 'Help',\n      PLURAL: 'Help',\n    },\n    ICONS: {\n      DEFAULT: MessageSquareLock,\n      DOCS: BookOpen,\n      FAQ: FileQuestion,\n      ABOUT: Info,\n    },\n  },\n  USERSHIELD: {\n    NAMES: {\n      SINGULAR: 'User Shield',\n      PLURAL: 'User Shields',\n    },\n    ICONS: {\n      DEFAULT: MessageSquareLock,\n    },\n  },\n}\n\n/** The set of registered entity types. */\nexport type EntityType = keyof typeof ENTITY_MAPPINGS\n\n/** Deployment override for a single entity: extra/replacement names and icons. */\nexport interface EntityRegistryOverride {\n  NAMES?: Record<string, string>\n  ICONS?: Record<string, EntityIconComponent>\n}\n\n/**\n * Layer deployment-specific names/icons onto the canonical registry \u2014 call once\n * at app startup. Merges in place (so live `ENTITY_MAPPINGS` refs pick it up) and\n * only touches the keys you pass, e.g.:\n *\n * ```ts\n * configureEntityRegistry({\n *   WORKSPACE: { NAMES: { SINGULAR: 'MatterSpace' }, ICONS: { DEFAULT: RotatedSquareM } },\n * })\n * ```\n */\nexport function configureEntityRegistry(\n  overrides: Partial<Record<EntityType, EntityRegistryOverride>>\n): void {\n  for (const [type, def] of Object.entries(overrides)) {\n    const target = ENTITY_MAPPINGS[type as EntityType] as {\n      NAMES: Record<string, string>\n      ICONS: Record<string, EntityIconComponent>\n    }\n    if (!target) continue\n    if (def?.NAMES) Object.assign(target.NAMES, def.NAMES)\n    if (def?.ICONS) Object.assign(target.ICONS, def.ICONS)\n  }\n}\n\n/**\n * Resolve the icon component for an entity type + variant, falling back to the\n * type's DEFAULT icon for unknown variants.\n */\nexport const getEntityIcon = (\n  entityType: EntityType,\n  variant: string = 'DEFAULT'\n): EntityIconComponent | undefined => {\n  const icons = ENTITY_MAPPINGS[entityType]?.ICONS as\n    Record<string, EntityIconComponent> | undefined\n  return icons?.[variant] || icons?.DEFAULT\n}\n\ninterface EntityNames {\n  SINGULAR: string\n  PLURAL?: string\n  SHORT?: string\n  NEW?: string\n}\n\n/** The forms of an entity's display label. */\nexport type EntityLabelForm = 'SINGULAR' | 'PLURAL' | 'SHORT' | 'NEW'\n\n/**\n * Display label for an entity type. `SINGULAR` (default); `PLURAL`/`SHORT`/`NEW`\n * fall back to derivations of the singular when not explicitly configured. The site's\n * vocabulary (`ArbiHostConfig.vocabulary`) wins over the registry: a site that names only the\n * singular gets every other form derived from it.\n */\nexport const getEntityLabel = (\n  entityType: EntityType,\n  form: EntityLabelForm = 'SINGULAR'\n): string => {\n  const entityMapping = ENTITY_MAPPINGS[entityType]\n  if (!entityMapping) return ''\n  const noun = vocabularyNoun(entityType)\n  const names: EntityNames =\n    noun === undefined\n      ? (entityMapping.NAMES as EntityNames)\n      : typeof noun === 'string'\n        ? { SINGULAR: noun }\n        : noun\n  const singularName = names.SINGULAR || ''\n\n  if (form === 'NEW') return names.NEW !== undefined ? names.NEW : 'New ' + singularName\n  if (form === 'SHORT')\n    return names.SHORT !== undefined ? names.SHORT : singularName.substring(0, 3) + '.'\n  if (form === 'PLURAL') return names.PLURAL !== undefined ? names.PLURAL : singularName + 's'\n  return singularName\n}\n\n/**\n * An entity's word inside a sentence: the label in lower case (\"Rename project\", \"No matters\n * yet\"). Use `getEntityLabel` where the word starts a title or stands alone.\n */\nexport const entityNoun = (\n  entityType: EntityType,\n  form: Exclude<EntityLabelForm, 'NEW' | 'SHORT'> = 'SINGULAR'\n): string => getEntityLabel(entityType, form).toLowerCase()\n\ntype EntityIconProps = {\n  entityType: EntityType\n  variant?: string\n  className?: string\n  size?: number\n  color?: string\n  'data-testid'?: string\n  onClick?: () => void\n} & React.SVGAttributes<SVGElement>\n\n/**\n * Render an entity's icon \u2014 the recommended way to show entity glyphs so all\n * icon choices stay centralised.\n */\nexport const EntityIcon = ({ entityType, variant = 'DEFAULT', ...props }: EntityIconProps) => {\n  const IconComponent = getEntityIcon(entityType, variant)\n  return IconComponent ? React.createElement(IconComponent, props) : null\n}\n\n/** Centralised icons for private/shared visibility states. */\nexport const VISIBILITY_ICONS = {\n  PRIVATE: MessageSquareLock,\n  SHARED: Users,\n}\n\n/** Render the private/shared visibility glyph. */\nexport const VisibilityIcon = ({\n  isShared,\n  className,\n  ...props\n}: {\n  isShared: boolean\n  className?: string\n  size?: number\n  color?: string\n  'data-testid'?: string\n  onClick?: () => void\n} & React.SVGAttributes<SVGElement>) => {\n  const IconComponent = isShared ? VISIBILITY_ICONS.SHARED : VISIBILITY_ICONS.PRIVATE\n  return React.createElement(IconComponent, {\n    ...props,\n    className: [isShared ? 'text-secondary' : 'text-primary', className].filter(Boolean).join(' '),\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/entities/status.js

@@ -0,0 +1,43 @@
+import { jsx } from "react/jsx-runtime";
+import { Badge as DefaultBadge } from "../ui/badge.js";
+const PACKAGE_BADGE_VARIANTS = [
+  "default",
+  "accent",
+  "secondary",
+  "destructive",
+  "outline"
+];
+function isPackageBadgeVariant(v) {
+  return PACKAGE_BADGE_VARIANTS.some((known) => known === v);
+}
+function PackageStatusBadge({ variant, ...rest }) {
+  return /* @__PURE__ */ jsx(DefaultBadge, { variant: isPackageBadgeVariant(variant) ? variant : "outline", ...rest });
+}
+const registry = {
+  variants: {},
+  fallback: "outline",
+  Badge: PackageStatusBadge
+};
+function configureStatusRegistry(map, opts) {
+  Object.assign(registry.variants, map);
+  if (opts?.fallback) registry.fallback = opts.fallback;
+  if (opts?.Badge) registry.Badge = opts.Badge;
+}
+function getStatusVariant(status) {
+  return registry.variants[status] ?? registry.fallback;
+}
+function StatusPill({ status, label, variant, className, testId }) {
+  const Badge = registry.Badge;
+  return /* @__PURE__ */ jsx(Badge, { variant: variant ?? getStatusVariant(status), className, "data-testid": testId, children: label ?? status });
+}
+let RAG_LABELS = { red: "At risk", amber: "Attention", green: "On track" };
+function configureRagLabels(labels) {
+  RAG_LABELS = { ...RAG_LABELS, ...labels };
+}
+export {
+  StatusPill,
+  configureRagLabels,
+  configureStatusRegistry,
+  getStatusVariant
+};
+//# sourceMappingURL=status.js.map

package/dist/entities/status.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/entities/status.tsx"],
+  "sourcesContent": ["/**\n * Status pill + RAG dot \u2014 the generic presentation, with the domain vocabulary\n * INJECTED (never baked in), mirroring the entity registry (`configureEntityRegistry`).\n *\n * A deployment registers its own status\u2192variant vocabulary and, if its Badge has\n * a bespoke skin (brand variants), injects that Badge too \u2014 so each app keeps its\n * exact pill look while sharing one component:\n *\n *   configureStatusRegistry(\n *     { Active: 'success', Privileged: 'brass', \u2026 },   // this firm's vocabulary\n *     { fallback: 'outline', Badge: FirmBadge },        // this firm's Badge skin\n *   )\n */\nimport { type ComponentType, type ReactNode } from 'react'\nimport { Badge as DefaultBadge } from '../ui/badge'\n\n/** A status variant is an opaque string \u2014 its valid values are defined by the\n *  injected Badge (or the default Badge's variants). */\nexport type StatusVariant = string\n\n/** The shape a consumer's Badge must satisfy to be injected as the pill skin. */\nexport interface StatusBadgeProps {\n  variant?: StatusVariant\n  className?: string\n  children?: ReactNode\n  'data-testid'?: string\n}\nexport type StatusBadgeComponent = ComponentType<StatusBadgeProps>\n\n/** The package Badge's own variant vocabulary. Kept as an explicit runtime list so\n *  the default skin can narrow a free-form StatusVariant to a known Badge variant\n *  with a type guard (no cast) \u2014 an unrecognised status just renders as `outline`. */\ntype PackageBadgeVariant = 'default' | 'accent' | 'secondary' | 'destructive' | 'outline'\nconst PACKAGE_BADGE_VARIANTS: readonly PackageBadgeVariant[] = [\n  'default',\n  'accent',\n  'secondary',\n  'destructive',\n  'outline',\n]\nfunction isPackageBadgeVariant(v: string | undefined): v is PackageBadgeVariant {\n  return PACKAGE_BADGE_VARIANTS.some((known) => known === v)\n}\n\n/** Default skin: the package Badge. A firm that registers variants outside this set\n *  injects its own Badge (see `configureStatusRegistry`); here unknown \u2192 `outline`. */\nfunction PackageStatusBadge({ variant, ...rest }: StatusBadgeProps) {\n  return <DefaultBadge variant={isPackageBadgeVariant(variant) ? variant : 'outline'} {...rest} />\n}\n\nconst registry: {\n  variants: Record<string, StatusVariant>\n  fallback: StatusVariant\n  Badge: StatusBadgeComponent\n} = {\n  variants: {},\n  fallback: 'outline',\n  Badge: PackageStatusBadge,\n}\n\n/** Register a firm's status\u2192variant vocabulary (merged in place), and optionally\n *  its fallback variant + its own Badge skin. Mirrors `configureEntityRegistry`. */\nexport function configureStatusRegistry(\n  map: Record<string, StatusVariant>,\n  opts?: { fallback?: StatusVariant; Badge?: StatusBadgeComponent }\n): void {\n  Object.assign(registry.variants, map)\n  if (opts?.fallback) registry.fallback = opts.fallback\n  if (opts?.Badge) registry.Badge = opts.Badge\n}\n\n/** Resolve a status string to its variant (falls back to the registered default). */\nexport function getStatusVariant(status: string): StatusVariant {\n  return registry.variants[status] ?? registry.fallback\n}\n\nexport interface StatusPillProps {\n  status: string\n  label?: string\n  /** Escape hatch: force a variant, skipping the registry. */\n  variant?: StatusVariant\n  className?: string\n  testId?: string\n}\n\n/** A status chip whose look comes from the injected Badge + registered vocabulary. */\nexport function StatusPill({ status, label, variant, className, testId }: StatusPillProps) {\n  const Badge = registry.Badge\n  return (\n    <Badge variant={variant ?? getStatusVariant(status)} className={className} data-testid={testId}>\n      {label ?? status}\n    </Badge>\n  )\n}\n\n// \u2500\u2500 RAG dot \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type Rag = 'red' | 'amber' | 'green'\n\nlet RAG_LABELS: Record<Rag, string> = { red: 'At risk', amber: 'Attention', green: 'On track' }\n\n/** Override the RAG label copy (defaults are seeded so consumers stay identical). */\nexport function configureRagLabels(labels: Partial<Record<Rag, string>>): void {\n  RAG_LABELS = { ...RAG_LABELS, ...labels }\n}\n"],
+  "mappings": "AA+CS;AAjCT,SAAS,SAAS,oBAAoB;AAmBtC,MAAM,yBAAyD;AAAA,EAC7D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACA,SAAS,sBAAsB,GAAiD;AAC9E,SAAO,uBAAuB,KAAK,CAAC,UAAU,UAAU,CAAC;AAC3D;AAIA,SAAS,mBAAmB,EAAE,SAAS,GAAG,KAAK,GAAqB;AAClE,SAAO,oBAAC,gBAAa,SAAS,sBAAsB,OAAO,IAAI,UAAU,WAAY,GAAG,MAAM;AAChG;AAEA,MAAM,WAIF;AAAA,EACF,UAAU,CAAC;AAAA,EACX,UAAU;AAAA,EACV,OAAO;AACT;AAIO,SAAS,wBACd,KACA,MACM;AACN,SAAO,OAAO,SAAS,UAAU,GAAG;AACpC,MAAI,MAAM,SAAU,UAAS,WAAW,KAAK;AAC7C,MAAI,MAAM,MAAO,UAAS,QAAQ,KAAK;AACzC;AAGO,SAAS,iBAAiB,QAA+B;AAC9D,SAAO,SAAS,SAAS,MAAM,KAAK,SAAS;AAC/C;AAYO,SAAS,WAAW,EAAE,QAAQ,OAAO,SAAS,WAAW,OAAO,GAAoB;AACzF,QAAM,QAAQ,SAAS;AACvB,SACE,oBAAC,SAAM,SAAS,WAAW,iBAAiB,MAAM,GAAG,WAAsB,eAAa,QACrF,mBAAS,QACZ;AAEJ;AAMA,IAAI,aAAkC,EAAE,KAAK,WAAW,OAAO,aAAa,OAAO,WAAW;AAGvF,SAAS,mBAAmB,QAA4C;AAC7E,eAAa,EAAE,GAAG,YAAY,GAAG,OAAO;AAC1C;",
+  "names": []
+}

package/dist/entities/tag-kinds.js

@@ -0,0 +1,23 @@
+import { getEntityLabel } from "./registry.js";
+const KIND_ENTITY = {
+  label: "LABEL",
+  annotation: "ANNOTATION",
+  search: "SAVED_SEARCH",
+  issue: "ISSUE",
+  person: "PERSON",
+  organisation: "ORGANISATION"
+};
+function tagKindTitle(kind, { plural = false } = {}) {
+  return getEntityLabel(KIND_ENTITY[kind], plural ? "PLURAL" : "SINGULAR");
+}
+function tagKindNouns(kind) {
+  return {
+    singular: tagKindTitle(kind).toLowerCase(),
+    plural: tagKindTitle(kind, { plural: true }).toLowerCase()
+  };
+}
+export {
+  tagKindNouns,
+  tagKindTitle
+};
+//# sourceMappingURL=tag-kinds.js.map

package/dist/entities/tag-kinds.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/entities/tag-kinds.ts"],
+  "sourcesContent": ["/**\n * What each tag kind is called, from the entity registry (so a deployment that renames an entity \u2014\n * an issue to \"Point\", say \u2014 renames it everywhere): `tagKindTitle('person', { plural: true })` is\n * \"People\", `tagKindNouns('label').singular` is \"label\".\n */\n\nimport { getEntityLabel, type EntityType } from './registry'\n\n/** The entity-label registry entry that names each kind (the SDK's `TagKind`s). */\nconst KIND_ENTITY = {\n  label: 'LABEL',\n  annotation: 'ANNOTATION',\n  search: 'SAVED_SEARCH',\n  issue: 'ISSUE',\n  person: 'PERSON',\n  organisation: 'ORGANISATION',\n} as const satisfies Record<string, EntityType>\n\n/** What a tag is: a label, annotation, search, issue, person or organisation. */\ntype TagKind = keyof typeof KIND_ENTITY\n\n/** A kind's name as a heading or option (\"Label\", \"Organisation\", plural \"People\"). */\nexport function tagKindTitle(kind: TagKind, { plural = false } = {}): string {\n  return getEntityLabel(KIND_ENTITY[kind], plural ? 'PLURAL' : 'SINGULAR')\n}\n\n/** Singular / plural nouns for a kind, for running text (\"New label\", \"2 annotations\"). */\nexport function tagKindNouns(kind: TagKind): { singular: string; plural: string } {\n  return {\n    singular: tagKindTitle(kind).toLowerCase(),\n    plural: tagKindTitle(kind, { plural: true }).toLowerCase(),\n  }\n}\n"],
+  "mappings": "AAMA,SAAS,sBAAuC;AAGhD,MAAM,cAAc;AAAA,EAClB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,cAAc;AAChB;AAMO,SAAS,aAAa,MAAe,EAAE,SAAS,MAAM,IAAI,CAAC,GAAW;AAC3E,SAAO,eAAe,YAAY,IAAI,GAAG,SAAS,WAAW,UAAU;AACzE;AAGO,SAAS,aAAa,MAAqD;AAChF,SAAO;AAAA,IACL,UAAU,aAAa,IAAI,EAAE,YAAY;AAAA,IACzC,QAAQ,aAAa,MAAM,EAAE,QAAQ,KAAK,CAAC,EAAE,YAAY;AAAA,EAC3D;AACF;",
+  "names": []
+}

package/dist/entities/tag-types.js

@@ -0,0 +1,44 @@
+import {
+  SquareCheckBig,
+  NotebookPen,
+  List,
+  Hash,
+  Search,
+  Folder,
+  Calendar,
+  Bot
+} from "lucide-react";
+const TAG_TYPE_LABELS = {
+  checkbox: "Label",
+  select: "Choice",
+  number: "Number",
+  text: "Text",
+  folder: "Folder",
+  search: "Saved Search",
+  date: "Date",
+  assistant: "AI Assistant"
+};
+const TAG_TYPE_ICONS = {
+  checkbox: SquareCheckBig,
+  select: List,
+  number: Hash,
+  text: NotebookPen,
+  folder: Folder,
+  search: Search,
+  date: Calendar,
+  assistant: Bot
+};
+function getTagTypeIcon(type) {
+  return TAG_TYPE_ICONS[type ?? "text"] || NotebookPen;
+}
+function getTagTypeLabel(type) {
+  const t = type ?? "text";
+  return TAG_TYPE_LABELS[t] || t;
+}
+export {
+  TAG_TYPE_ICONS,
+  TAG_TYPE_LABELS,
+  getTagTypeIcon,
+  getTagTypeLabel
+};
+//# sourceMappingURL=tag-types.js.map

package/dist/entities/tag-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/entities/tag-types.ts"],
+  "sourcesContent": ["/**\n * Tag-type presentation primitives \u2014 the brand-neutral icon and label maps that\n * back the shared `TagEntity` pill. Kept in their own module (not the component\n * file) so app-side wrappers can import them to build their own store-coupled\n * tooltip content without pulling in a component, and so the component file stays\n * fast-refresh friendly.\n */\n\nimport {\n  SquareCheckBig,\n  StickyNote,\n  NotebookPen,\n  List,\n  Hash,\n  Search,\n  Folder,\n  Calendar,\n  Bot,\n} from 'lucide-react'\n\n/**\n * Human-readable tag type names. \"Annotation\" names the whole kind (every non-label field), so\n * each format is called by what it is: a checkbox tag is a label, a select one a choice.\n */\nexport const TAG_TYPE_LABELS: Record<string, string> = {\n  checkbox: 'Label',\n  select: 'Choice',\n  number: 'Number',\n  text: 'Text',\n  folder: 'Folder',\n  search: 'Saved Search',\n  date: 'Date',\n  assistant: 'AI Assistant',\n}\n\n/** Icon mapping for tag types. */\nexport const TAG_TYPE_ICONS: Record<string, typeof StickyNote> = {\n  checkbox: SquareCheckBig,\n  select: List,\n  number: Hash,\n  text: NotebookPen,\n  folder: Folder,\n  search: Search,\n  date: Calendar,\n  assistant: Bot,\n}\n\n/** Resolve the icon component for a tag type, with the `text` (NotebookPen) fallback.\n * Annotations share the NotebookPen mark used by the AI Annotate bulk action, so\n * the table column and the batch bar name the same thing the same way. */\nexport function getTagTypeIcon(type?: string | null): typeof StickyNote {\n  return TAG_TYPE_ICONS[type ?? 'text'] || NotebookPen\n}\n\n/** Resolve the human-readable label for a tag type, falling back to the raw type. */\nexport function getTagTypeLabel(type?: string | null): string {\n  const t = type ?? 'text'\n  return TAG_TYPE_LABELS[t] || t\n}\n"],
+  "mappings": "AAQA;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMA,MAAM,kBAA0C;AAAA,EACrD,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,WAAW;AACb;AAGO,MAAM,iBAAoD;AAAA,EAC/D,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,WAAW;AACb;AAKO,SAAS,eAAe,MAAyC;AACtE,SAAO,eAAe,QAAQ,MAAM,KAAK;AAC3C;AAGO,SAAS,gBAAgB,MAA8B;AAC5D,QAAM,IAAI,QAAQ;AAClB,SAAO,gBAAgB,CAAC,KAAK;AAC/B;",
+  "names": []
+}

package/dist/entities/vocabulary.js

@@ -0,0 +1,12 @@
+let vocabulary = {};
+function configureEntityVocabulary(next) {
+  vocabulary = next;
+}
+function vocabularyNoun(entityType) {
+  return vocabulary[entityType];
+}
+export {
+  configureEntityVocabulary,
+  vocabularyNoun
+};
+//# sourceMappingURL=vocabulary.js.map

package/dist/entities/vocabulary.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/entities/vocabulary.ts"],
+  "sourcesContent": ["/**\n * A site's own words for the entities (`ArbiHostConfig.vocabulary`): `{ PROJECT: 'Matter' }` makes\n * every kit say \"Matter\", \"Matters\", \"New matter\" where the defaults say \"Project\". The vertical\n * nouns live only in the site's config; the kits read them through `getEntityLabel` /\n * `entityNoun`, at render time, so the host's vocabulary is in place before any kit renders.\n *\n * Dependency-free (no icons), so `<ArbiHost>` can apply it without growing its import graph.\n */\n\n/** An entity's word: the singular (\"Matter\"), or each form where a derived one would be wrong. */\nexport type EntityNoun =\n  string | { SINGULAR: string; PLURAL?: string; SHORT?: string; NEW?: string }\n\n/** A site's words, keyed by entity type (`PROJECT`, `WORKSPACE`, \u2026). */\nexport type EntityVocabulary = Partial<Record<string, EntityNoun>>\n\nlet vocabulary: EntityVocabulary = {}\n\n/** Set the site's vocabulary (replacing any earlier one). `<ArbiHost>` calls it with `config.vocabulary`. */\nexport function configureEntityVocabulary(next: EntityVocabulary): void {\n  vocabulary = next\n}\n\n/** The site's word for an entity type, if it has one. */\nexport function vocabularyNoun(entityType: string): EntityNoun | undefined {\n  return vocabulary[entityType]\n}\n"],
+  "mappings": "AAgBA,IAAI,aAA+B,CAAC;AAG7B,SAAS,0BAA0B,MAA8B;AACtE,eAAa;AACf;AAGO,SAAS,eAAe,YAA4C;AACzE,SAAO,WAAW,UAAU;AAC9B;",
+  "names": []
+}

package/dist/entity-extraction.js

@@ -0,0 +1,25 @@
+import { create } from "zustand";
+const useEntityExtractionStore = create(() => ({ docIds: [] }));
+function update(docIds, running) {
+  if (!docIds.length) return;
+  useEntityExtractionStore.setState((state) => {
+    const ids = new Set(state.docIds);
+    docIds.forEach((id) => running ? ids.add(id) : ids.delete(id));
+    return { docIds: [...ids] };
+  });
+}
+function startEntityExtraction(docIds) {
+  update(docIds, true);
+}
+function finishEntityExtraction(docIds) {
+  update(docIds, false);
+}
+function useEntityExtractionDocIds() {
+  return useEntityExtractionStore((state) => state.docIds);
+}
+export {
+  finishEntityExtraction,
+  startEntityExtraction,
+  useEntityExtractionDocIds
+};
+//# sourceMappingURL=entity-extraction.js.map

package/dist/entity-extraction.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/entity-extraction.ts"],
+  "sourcesContent": ["/**\n * The documents whose people and organisations are being found (`useExtractEntities`), from the\n * request until the live connection says the batch is done (`batch_complete`, `entity_extract`):\n * the package's WebSocket (`ArbiWebSocketProvider`) ends it, and a host on its own connection calls\n * `finishEntityExtraction` from its handler.\n */\n\nimport { create } from 'zustand'\n\nconst useEntityExtractionStore = create<{ docIds: readonly string[] }>(() => ({ docIds: [] }))\n\nfunction update(docIds: readonly string[], running: boolean): void {\n  if (!docIds.length) return\n  useEntityExtractionStore.setState((state) => {\n    const ids = new Set(state.docIds)\n    docIds.forEach((id) => (running ? ids.add(id) : ids.delete(id)))\n    return { docIds: [...ids] }\n  })\n}\n\n/** The documents an extraction was started on are running. */\nexport function startEntityExtraction(docIds: readonly string[]): void {\n  update(docIds, true)\n}\n\n/** The extraction of these documents is done. */\nexport function finishEntityExtraction(docIds: readonly string[]): void {\n  update(docIds, false)\n}\n\n/** The documents being extracted now. */\nexport function useEntityExtractionDocIds(): readonly string[] {\n  return useEntityExtractionStore((state) => state.docIds)\n}\n"],
+  "mappings": "AAOA,SAAS,cAAc;AAEvB,MAAM,2BAA2B,OAAsC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE;AAE7F,SAAS,OAAO,QAA2B,SAAwB;AACjE,MAAI,CAAC,OAAO,OAAQ;AACpB,2BAAyB,SAAS,CAAC,UAAU;AAC3C,UAAM,MAAM,IAAI,IAAI,MAAM,MAAM;AAChC,WAAO,QAAQ,CAAC,OAAQ,UAAU,IAAI,IAAI,EAAE,IAAI,IAAI,OAAO,EAAE,CAAE;AAC/D,WAAO,EAAE,QAAQ,CAAC,GAAG,GAAG,EAAE;AAAA,EAC5B,CAAC;AACH;AAGO,SAAS,sBAAsB,QAAiC;AACrE,SAAO,QAAQ,IAAI;AACrB;AAGO,SAAS,uBAAuB,QAAiC;AACtE,SAAO,QAAQ,KAAK;AACtB;AAGO,SAAS,4BAA+C;AAC7D,SAAO,yBAAyB,CAAC,UAAU,MAAM,MAAM;AACzD;",
+  "names": []
+}