@arbidocs/react 0.5.111 → 0.5.112

package/dist/support/index.js

@@ -0,0 +1,35 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "../useArbi.js";
+import { arbiQueryKeys } from "../query-keys.js";
+function useSupportTickets(options = {}) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys.supportTickets(),
+    queryFn: () => arbi.support.list(),
+    enabled: (options.enabled ?? true) && arbi.isLoggedIn,
+    refetchInterval: 15e3
+  });
+}
+function useSupportTicket(ticketId, options = {}) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys.supportTicket(ticketId ?? 0),
+    queryFn: () => arbi.support.get(ticketId ?? 0),
+    enabled: (options.enabled ?? true) && ticketId !== void 0 && arbi.isLoggedIn,
+    refetchInterval: 15e3
+  });
+}
+function useRateSupportTicket() {
+  const arbi = useArbi();
+  const queries = useQueryClient();
+  return useMutation({
+    mutationFn: ({ ticketId, rating }) => arbi.support.rate(ticketId, rating),
+    onSuccess: () => queries.invalidateQueries({ queryKey: arbiQueryKeys.allSupportTickets() })
+  });
+}
+export {
+  useRateSupportTicket,
+  useSupportTicket,
+  useSupportTickets
+};
+//# sourceMappingURL=index.js.map

package/dist/support/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/support/index.ts"],
+  "sourcesContent": ["/** Personal support resources. Workspace switching never changes ticket ownership. */\nimport { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'\nimport type { SupportRating } from '@arbidocs/sdk/browser'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys } from '../query-keys'\n\nexport function useSupportTickets(options: { enabled?: boolean } = {}) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.supportTickets(),\n    queryFn: () => arbi.support.list(),\n    enabled: (options.enabled ?? true) && arbi.isLoggedIn,\n    refetchInterval: 15000,\n  })\n}\nexport function useSupportTicket(\n  ticketId: number | undefined,\n  options: { enabled?: boolean } = {}\n) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.supportTicket(ticketId ?? 0),\n    queryFn: () => arbi.support.get(ticketId ?? 0),\n    enabled: (options.enabled ?? true) && ticketId !== undefined && arbi.isLoggedIn,\n    refetchInterval: 15000,\n  })\n}\nexport function useRateSupportTicket() {\n  const arbi = useArbi()\n  const queries = useQueryClient()\n  return useMutation({\n    mutationFn: ({ ticketId, rating }: { ticketId: number; rating: SupportRating }) =>\n      arbi.support.rate(ticketId, rating),\n    onSuccess: () => queries.invalidateQueries({ queryKey: arbiQueryKeys.allSupportTickets() }),\n  })\n}\n"],
+  "mappings": "AACA,SAAS,UAAU,aAAa,sBAAsB;AAEtD,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAEvB,SAAS,kBAAkB,UAAiC,CAAC,GAAG;AACrE,QAAM,OAAO,QAAQ;AACrB,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,eAAe;AAAA,IACvC,SAAS,MAAM,KAAK,QAAQ,KAAK;AAAA,IACjC,UAAU,QAAQ,WAAW,SAAS,KAAK;AAAA,IAC3C,iBAAiB;AAAA,EACnB,CAAC;AACH;AACO,SAAS,iBACd,UACA,UAAiC,CAAC,GAClC;AACA,QAAM,OAAO,QAAQ;AACrB,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,cAAc,YAAY,CAAC;AAAA,IACnD,SAAS,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC;AAAA,IAC7C,UAAU,QAAQ,WAAW,SAAS,aAAa,UAAa,KAAK;AAAA,IACrE,iBAAiB;AAAA,EACnB,CAAC;AACH;AACO,SAAS,uBAAuB;AACrC,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU,eAAe;AAC/B,SAAO,YAAY;AAAA,IACjB,YAAY,CAAC,EAAE,UAAU,OAAO,MAC9B,KAAK,QAAQ,KAAK,UAAU,MAAM;AAAA,IACpC,WAAW,MAAM,QAAQ,kBAAkB,EAAE,UAAU,cAAc,kBAAkB,EAAE,CAAC;AAAA,EAC5F,CAAC;AACH;",
+  "names": []
+}

package/dist/tags.js

@@ -0,0 +1,204 @@
+import { useCallback } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  tags as tagOps
+} from "@arbidocs/sdk/browser";
+import { useArbi } from "./useArbi.js";
+import { dropTagFromCachedDocuments } from "./documents/documents-cache.js";
+import { startEntityExtraction } from "./entity-extraction.js";
+import { arbiMutationKeys, arbiQueryKeys } from "./hooks.js";
+import {
+  QUEUED_WRITE_RETRY,
+  inWorkspace,
+  primeOnArbi,
+  primeOnClient,
+  useCapturingWorkspace
+} from "./queued-writes.js";
+function workspaceOfTag(qc, tagId) {
+  for (const [key, tags] of qc.getQueriesData({
+    queryKey: arbiQueryKeys.allTags()
+  })) {
+    if (Array.isArray(tags) && tags.some((t) => t.external_id === tagId))
+      return key[2] ?? null;
+  }
+  return null;
+}
+function openWorkspaceId(arbi) {
+  return arbi.hasWorkspace ? arbi.getWorkspaceId() : null;
+}
+function patchWorkspaceTags(qc, workspaceId, reducer) {
+  const key = arbiQueryKeys.tags(workspaceId);
+  const current = qc.getQueryData(key);
+  if (!current) return;
+  const next = reducer(current);
+  if (next !== current) qc.setQueryData(key, next);
+}
+function invalidateTagTables(qc, workspaceId) {
+  return qc.invalidateQueries({ queryKey: arbiQueryKeys.tagLists(workspaceId) });
+}
+function invalidateTagData(qc, workspaceId) {
+  return Promise.all([
+    qc.invalidateQueries({ queryKey: arbiQueryKeys.tags(workspaceId) }),
+    qc.invalidateQueries({ queryKey: arbiQueryKeys.facts(workspaceId) })
+  ]);
+}
+function useInvalidateTagData() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useCallback(() => {
+    const workspaceId = openWorkspaceId(arbi);
+    return workspaceId ? invalidateTagData(qc, workspaceId) : Promise.resolve();
+  }, [arbi, qc]);
+}
+function settleCreatedTag(qc, created) {
+  const workspaceId = created.workspace_ext_id;
+  patchWorkspaceTags(
+    qc,
+    workspaceId,
+    (old) => old.some((t) => t.external_id === created.external_id) ? old : [...old, created]
+  );
+  return invalidateTagTables(qc, workspaceId);
+}
+function settleChangedTag(qc, tag) {
+  const workspaceId = tag.workspace_ext_id;
+  patchWorkspaceTags(
+    qc,
+    workspaceId,
+    (old) => old.map((t) => t.external_id === tag.external_id ? { ...t, ...tag } : t)
+  );
+  return invalidateTagTables(qc, workspaceId);
+}
+const replayableTagMutations = [
+  {
+    mutationKey: arbiMutationKeys.createTag(),
+    // In the workspace it was made in (named on the request), opened for this session first.
+    run: (client, input) => inWorkspace(primeOnClient(client), input.workspaceId, () => tagOps.createTag(client, input)),
+    settle: (qc, created) => settleCreatedTag(qc, created)
+  }
+];
+function useCreateTag() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  const capture = (input) => input.workspaceId || !arbi.hasWorkspace ? input : { ...input, workspaceId: arbi.getWorkspaceId() };
+  return useCapturingWorkspace(
+    useMutation({
+      mutationKey: arbiMutationKeys.createTag(),
+      mutationFn: (input) => inWorkspace(primeOnArbi(arbi), input.workspaceId, () => arbi.tags.create(input)),
+      onSuccess: (created) => settleCreatedTag(qc, created),
+      ...QUEUED_WRITE_RETRY
+    }),
+    capture
+  );
+}
+function useIsCreatingTag() {
+  const qc = useQueryClient();
+  return useCallback(
+    (name) => {
+      const wanted = name.trim().toLowerCase();
+      return qc.getMutationCache().findAll({
+        mutationKey: arbiMutationKeys.createTag(),
+        predicate: (m) => m.state.status === "pending" && m.state.variables?.name.trim().toLowerCase() === wanted
+      }).length > 0;
+    },
+    [qc]
+  );
+}
+function useUpdateTag() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationKey: arbiMutationKeys.updateTag(),
+    mutationFn: ({ tagId, change }) => arbi.tags.update(tagId, change),
+    onSuccess: (tag) => settleChangedTag(qc, tag)
+  });
+}
+function useSetTagValues() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationKey: arbiMutationKeys.updateTag(),
+    mutationFn: ({
+      tagId,
+      values
+    }) => arbi.tags.setValues(tagId, values),
+    onSuccess: (tag) => settleChangedTag(qc, tag)
+  });
+}
+function useDeleteTag() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationKey: arbiMutationKeys.deleteTag(),
+    mutationFn: (tagId) => arbi.tags.delete(tagId),
+    // The tag's own workspace (the cached list holding it), else the one open when it is sent: a
+    // switch while the delete runs must not patch the next workspace's list.
+    onMutate: (tagId) => ({ workspaceId: workspaceOfTag(qc, tagId) ?? openWorkspaceId(arbi) }),
+    onSuccess: (_data, tagId, context) => {
+      dropTagFromCachedDocuments(qc, tagId);
+      const workspaceId = context?.workspaceId;
+      if (!workspaceId) return;
+      patchWorkspaceTags(
+        qc,
+        workspaceId,
+        (old) => old.filter((t) => t.external_id !== tagId).map((t) => t.parent_ext_id === tagId ? { ...t, parent_ext_id: null } : t)
+      );
+      return Promise.all([
+        invalidateTagTables(qc, workspaceId),
+        qc.invalidateQueries({ queryKey: arbiQueryKeys.facts(workspaceId) })
+      ]);
+    }
+  });
+}
+function useExtractEntities() {
+  const arbi = useArbi();
+  return useMutation({
+    mutationKey: arbiMutationKeys.extractEntities(),
+    mutationFn: (docIds) => arbi.tags.extractEntities(docIds),
+    onSuccess: (data) => startEntityExtraction(data.doc_ext_ids)
+  });
+}
+function useTagKindSchema(kind, options) {
+  const arbi = useArbi();
+  const workspaceId = openWorkspaceId(arbi) ?? "";
+  return useQuery({
+    queryKey: arbiQueryKeys.tagKind(workspaceId, kind ?? ""),
+    queryFn: () => arbi.readInWorkspace(workspaceId, () => arbi.tagKinds.get(kind)),
+    enabled: (options?.enabled ?? true) && !!kind && !!workspaceId
+  });
+}
+function useUpdateTagKindSchema() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationKey: arbiMutationKeys.updateTagKindSchema(),
+    mutationFn: ({
+      kind,
+      fields
+    }) => arbi.tagKinds.update(kind, fields),
+    // The workspace open when it is sent (the server writes the open workspace's schema until
+    // the request can name it): a switch meanwhile must not rewrite the next workspace's columns.
+    onMutate: () => ({ workspaceId: openWorkspaceId(arbi) }),
+    onSuccess: (schema, _input, context) => {
+      const workspaceId = context?.workspaceId;
+      if (!workspaceId) return;
+      qc.setQueryData(arbiQueryKeys.tagKind(workspaceId, schema.kind), schema);
+      return invalidateTagData(qc, workspaceId);
+    }
+  });
+}
+export {
+  invalidateTagData,
+  invalidateTagTables,
+  patchWorkspaceTags,
+  replayableTagMutations,
+  useCreateTag,
+  useDeleteTag,
+  useExtractEntities,
+  useInvalidateTagData,
+  useIsCreatingTag,
+  useSetTagValues,
+  useTagKindSchema,
+  useUpdateTag,
+  useUpdateTagKindSchema
+};
+//# sourceMappingURL=tags.js.map

package/dist/tags.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/tags.ts"],
+  "sourcesContent": ["/**\n * Tags: the open workspace's tag list (`useTags()`), the writes (create, update, delete, values,\n * entity extraction), and tag kinds \u2014 a kind's fields in the workspace are the columns of a table\n * of its tags (`useTagKindSchema('issue')`), whose rows are the tag list filtered by kind with\n * links (`useTags(workspaceId, { kind, include })`).\n *\n * Everything is cached under the workspace's tags (`arbiQueryKeys.tags`). The whole list is kept\n * current in place: every write here patches it ({@link patchWorkspaceTags}, which a host also\n * uses for its own writes that move a tag's counts, e.g. applying it to documents) and refreshes\n * the filtered lists (the tables). Anything that invalidates the workspace's tags (a document batch\n * finishing, {@link useInvalidateTagData} after a doctag or fact change) refreshes them all.\n *\n * Creating a tag can be queued while offline and replayed after a reload: see `offline.ts`.\n *\n * Requires an `ArbiHost` (with an `arbi`) and a React Query client above it.\n */\n\nimport { useCallback } from 'react'\nimport { useMutation, useQuery, useQueryClient, type QueryClient } from '@tanstack/react-query'\nimport type { ArbiClient } from '@arbidocs/client'\nimport {\n  tags as tagOps,\n  type TagChange,\n  type TagFieldDefinition,\n  type TagKind,\n  type TagKindSchema,\n  type TagResponse,\n} from '@arbidocs/sdk/browser'\nimport { useArbi } from './useArbi'\nimport { dropTagFromCachedDocuments } from './documents/documents-cache'\nimport { startEntityExtraction } from './entity-extraction'\nimport { arbiMutationKeys, arbiQueryKeys } from './hooks'\nimport {\n  QUEUED_WRITE_RETRY,\n  inWorkspace,\n  primeOnArbi,\n  primeOnClient,\n  useCapturingWorkspace,\n} from './queued-writes'\n\n/** The workspace open on `arbi`, or `null` (`getWorkspaceId()` throws when none is open). */\n/** The workspace whose cached tag list holds `tagId`, if any. */\nfunction workspaceOfTag(qc: QueryClient, tagId: string): string | null {\n  for (const [key, tags] of qc.getQueriesData<TagResponse[]>({\n    queryKey: arbiQueryKeys.allTags(),\n  })) {\n    if (Array.isArray(tags) && tags.some((t) => t.external_id === tagId))\n      return (key[2] as string | undefined) ?? null\n  }\n  return null\n}\n\nfunction openWorkspaceId(arbi: ReturnType<typeof useArbi>): string | null {\n  return arbi.hasWorkspace ? arbi.getWorkspaceId() : null\n}\n\n/**\n * Apply `reducer` to a workspace's cached tag list (nothing cached: nothing to do). The list is\n * read once, then kept current by these patches; a host's own write that changes a tag (applying\n * it to documents moves its `doctag_count`) patches it here too.\n */\nexport function patchWorkspaceTags(\n  qc: QueryClient,\n  workspaceId: string,\n  reducer: (tags: TagResponse[]) => TagResponse[]\n): void {\n  const key = arbiQueryKeys.tags(workspaceId)\n  const current = qc.getQueryData<TagResponse[]>(key)\n  if (!current) return\n  const next = reducer(current)\n  if (next !== current) qc.setQueryData(key, next)\n}\n\n/** Refetch a workspace's tables of tags (its filtered lists), not the whole list. */\nexport function invalidateTagTables(qc: QueryClient, workspaceId: string): Promise<void> {\n  return qc.invalidateQueries({ queryKey: arbiQueryKeys.tagLists(workspaceId) })\n}\n\n/** Refresh what a tag, doctag or fact change affects: the workspace's tags, tables and facts. */\nexport function invalidateTagData(qc: QueryClient, workspaceId: string): Promise<unknown> {\n  return Promise.all([\n    qc.invalidateQueries({ queryKey: arbiQueryKeys.tags(workspaceId) }),\n    qc.invalidateQueries({ queryKey: arbiQueryKeys.facts(workspaceId) }),\n  ])\n}\n\n/** {@link invalidateTagData} for the open workspace: call it after a doctag or fact write. */\nexport function useInvalidateTagData(): () => Promise<unknown> {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useCallback(() => {\n    const workspaceId = openWorkspaceId(arbi)\n    return workspaceId ? invalidateTagData(qc, workspaceId) : Promise.resolve()\n  }, [arbi, qc])\n}\n\n/**\n * What a new tag is: its name, and optionally kind, format, parent, values, sharing, and the workspace it goes in\n * (absent: the open one).\n */\nexport type CreateTagInput = Parameters<typeof tagOps.createTag>[1]\n\n/** A created tag joins its workspace's list; the tables re-read. */\nfunction settleCreatedTag(qc: QueryClient, created: TagResponse): Promise<void> {\n  const workspaceId = created.workspace_ext_id\n  patchWorkspaceTags(qc, workspaceId, (old) =>\n    old.some((t) => t.external_id === created.external_id) ? old : [...old, created]\n  )\n  return invalidateTagTables(qc, workspaceId)\n}\n\n/** A changed tag replaces its entry in the list; the tables re-read. */\nfunction settleChangedTag(qc: QueryClient, tag: TagResponse): Promise<void> {\n  const workspaceId = tag.workspace_ext_id\n  patchWorkspaceTags(qc, workspaceId, (old) =>\n    old.map((t) => (t.external_id === tag.external_id ? { ...t, ...tag } : t))\n  )\n  return invalidateTagTables(qc, workspaceId)\n}\n\n/**\n * The tag writes a host may queue while offline and replay after a reload (`offline.ts`): each\n * key's request on a bare client, and what its success does to the cache.\n */\nexport const replayableTagMutations = [\n  {\n    mutationKey: arbiMutationKeys.createTag(),\n    // In the workspace it was made in (named on the request), opened for this session first.\n    run: (client: ArbiClient, input: CreateTagInput) =>\n      inWorkspace(primeOnClient(client), input.workspaceId, () => tagOps.createTag(client, input)),\n    settle: (qc: QueryClient, created: TagResponse) => settleCreatedTag(qc, created),\n  },\n] as const\n\n/**\n * Create a tag in the open workspace, or `workspaceId` (`{ name, kind: 'issue' }`, `{ name, parentId }`, \u2026): it is\n * added to the tag list and the tables re-read. Resolves with the new tag. Offline it is held and\n * sent on reconnect (a host that registers `registerArbiMutationDefaults` keeps it across reloads).\n */\nexport function useCreateTag() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  // The workspace is captured when the tag is made, so a create queued offline keeps it.\n  const capture = (input: CreateTagInput): CreateTagInput =>\n    input.workspaceId || !arbi.hasWorkspace\n      ? input\n      : { ...input, workspaceId: arbi.getWorkspaceId() }\n  return useCapturingWorkspace(\n    useMutation({\n      mutationKey: arbiMutationKeys.createTag(),\n      mutationFn: (input: CreateTagInput): Promise<TagResponse> =>\n        inWorkspace(primeOnArbi(arbi), input.workspaceId, () => arbi.tags.create(input)),\n      onSuccess: (created) => settleCreatedTag(qc, created),\n      ...QUEUED_WRITE_RETRY,\n    }),\n    capture\n  )\n}\n\n/**\n * Whether a tag of this name (any case) is being created right now: a second create of the same\n * name (a double Enter) is skipped instead of making a duplicate.\n */\nexport function useIsCreatingTag(): (name: string) => boolean {\n  const qc = useQueryClient()\n  return useCallback(\n    (name: string) => {\n      const wanted = name.trim().toLowerCase()\n      return (\n        qc.getMutationCache().findAll({\n          mutationKey: arbiMutationKeys.createTag(),\n          predicate: (m) =>\n            m.state.status === 'pending' &&\n            (m.state.variables as CreateTagInput | undefined)?.name.trim().toLowerCase() === wanted,\n        }).length > 0\n      )\n    },\n    [qc]\n  )\n}\n\n/** Change a tag (name, format, instruction, parent, sharing, values): patched in the list. */\nexport function useUpdateTag() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationKey: arbiMutationKeys.updateTag(),\n    mutationFn: ({ tagId, change }: { tagId: string; change: TagChange }): Promise<TagResponse> =>\n      arbi.tags.update(tagId, change),\n    onSuccess: (tag) => settleChangedTag(qc, tag),\n  })\n}\n\n/** Merge-patch a tag's values for its kind's fields (`null` clears one); its tables refresh. */\nexport function useSetTagValues() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationKey: arbiMutationKeys.updateTag(),\n    mutationFn: ({\n      tagId,\n      values,\n    }: {\n      tagId: string\n      values: Record<string, unknown>\n    }): Promise<TagResponse> => arbi.tags.setValues(tagId, values),\n    onSuccess: (tag) => settleChangedTag(qc, tag),\n  })\n}\n\n/**\n * Delete a tag: it leaves the list (its sub-tags move to the top level on the server, so the list\n * re-reads them), and the tables and facts re-read. A host that shows the tag on its own items\n * (documents' tags) follows `arbiMutationKeys.deleteTag()` to drop it there.\n */\nexport function useDeleteTag() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationKey: arbiMutationKeys.deleteTag(),\n    mutationFn: (tagId: string) => arbi.tags.delete(tagId),\n    // The tag's own workspace (the cached list holding it), else the one open when it is sent: a\n    // switch while the delete runs must not patch the next workspace's list.\n    onMutate: (tagId) => ({ workspaceId: workspaceOfTag(qc, tagId) ?? openWorkspaceId(arbi) }),\n    onSuccess: (_data, tagId, context) => {\n      // Its pills come off the documents grid in place (and off any open document).\n      dropTagFromCachedDocuments(qc, tagId)\n      const workspaceId = context?.workspaceId\n      if (!workspaceId) return\n      patchWorkspaceTags(qc, workspaceId, (old) =>\n        old\n          .filter((t) => t.external_id !== tagId)\n          .map((t) => (t.parent_ext_id === tagId ? { ...t, parent_ext_id: null } : t))\n      )\n      return Promise.all([\n        invalidateTagTables(qc, workspaceId),\n        qc.invalidateQueries({ queryKey: arbiQueryKeys.facts(workspaceId) }),\n      ])\n    },\n  })\n}\n\n/**\n * Find the people and organisations documents name and link each to its entity tag. Accepted at\n * once with the documents' ids, which show as running (`useEntityExtractionDocIds`) until a\n * `batch_complete` (`entity_extract`) WebSocket message says they are done.\n */\nexport function useExtractEntities() {\n  const arbi = useArbi()\n  return useMutation({\n    mutationKey: arbiMutationKeys.extractEntities(),\n    mutationFn: (docIds: string[]) => arbi.tags.extractEntities(docIds),\n    onSuccess: (data) => startEntityExtraction(data.doc_ext_ids),\n  })\n}\n\n/**\n * A kind's fields in the open workspace (`'issue'`: its issue fields): the columns of a table of\n * that kind's tags. The built-in ones (`is_default`) until the workspace sets its own.\n */\nexport function useTagKindSchema(\n  kind: TagKind | null | undefined,\n  options?: { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  const workspaceId = openWorkspaceId(arbi) ?? ''\n  return useQuery({\n    queryKey: arbiQueryKeys.tagKind(workspaceId, kind ?? ''),\n    queryFn: (): Promise<TagKindSchema> =>\n      arbi.readInWorkspace(workspaceId, () => arbi.tagKinds.get(kind as TagKind)),\n    enabled: (options?.enabled ?? true) && !!kind && !!workspaceId,\n  })\n}\n\n/**\n * Set a kind's fields in full (a field with its `id` keeps its values; one without is new; one\n * left out is removed). The kind's schema and the workspace's tags refresh.\n */\nexport function useUpdateTagKindSchema() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationKey: arbiMutationKeys.updateTagKindSchema(),\n    mutationFn: ({\n      kind,\n      fields,\n    }: {\n      kind: TagKind\n      fields: TagFieldDefinition[]\n    }): Promise<TagKindSchema> => arbi.tagKinds.update(kind, fields),\n    // The workspace open when it is sent (the server writes the open workspace's schema until\n    // the request can name it): a switch meanwhile must not rewrite the next workspace's columns.\n    onMutate: () => ({ workspaceId: openWorkspaceId(arbi) }),\n    onSuccess: (schema, _input, context) => {\n      const workspaceId = context?.workspaceId\n      if (!workspaceId) return\n      qc.setQueryData(arbiQueryKeys.tagKind(workspaceId, schema.kind), schema)\n      return invalidateTagData(qc, workspaceId)\n    },\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/ui/DebouncedInput.js

@@ -0,0 +1,109 @@
+import { jsx } from "react/jsx-runtime";
+import { Input } from "./input.js";
+import { Textarea } from "./textarea.js";
+import { useState, useCallback, useEffect, useRef } from "react";
+function DebouncedInput({
+  value,
+  onChange,
+  disabled,
+  type = "text",
+  multiline = false,
+  className,
+  debounceMs = 500,
+  placeholder,
+  autoResize = true,
+  minHeight = 28,
+  maxHeight = 72
+}) {
+  const [localValue, setLocalValue] = useState(value);
+  const timeoutRef = useRef(void 0);
+  const pendingRef = useRef(null);
+  const textareaRef = useRef(null);
+  const adjustHeight = useCallback(() => {
+    const textarea = textareaRef.current;
+    if (!textarea || !autoResize) return;
+    textarea.style.height = "auto";
+    const newHeight = Math.min(Math.max(textarea.scrollHeight, minHeight), maxHeight);
+    textarea.style.height = `${newHeight}px`;
+  }, [autoResize, minHeight, maxHeight]);
+  useEffect(() => {
+    if (pendingRef.current !== null) return;
+    setLocalValue(value);
+  }, [value]);
+  useEffect(() => {
+    if (multiline) {
+      adjustHeight();
+    }
+  }, [localValue, multiline, adjustHeight]);
+  const onChangeRef = useRef(onChange);
+  useEffect(() => {
+    onChangeRef.current = onChange;
+  }, [onChange]);
+  const flushPendingChange = useCallback(() => {
+    if (pendingRef.current === null) return false;
+    const pending = pendingRef.current;
+    pendingRef.current = null;
+    clearTimeout(timeoutRef.current);
+    onChangeRef.current(pending);
+    return true;
+  }, []);
+  const handleChange = useCallback(
+    (e) => {
+      const newValue = e.target.value;
+      setLocalValue(newValue);
+      pendingRef.current = newValue;
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = setTimeout(() => {
+        pendingRef.current = null;
+        onChangeRef.current(newValue);
+      }, debounceMs);
+    },
+    [debounceMs]
+  );
+  useEffect(
+    () => () => {
+      const pending = pendingRef.current;
+      pendingRef.current = null;
+      clearTimeout(timeoutRef.current);
+      if (pending !== null) onChangeRef.current(pending);
+    },
+    []
+  );
+  const handleBlur = useCallback(() => {
+    flushPendingChange();
+    if (localValue !== value) {
+      setLocalValue(value);
+    }
+  }, [flushPendingChange, localValue, value]);
+  if (multiline) {
+    return /* @__PURE__ */ jsx(
+      Textarea,
+      {
+        ref: textareaRef,
+        value: localValue,
+        onChange: handleChange,
+        onBlur: handleBlur,
+        disabled,
+        className: `resize-y ${className || ""}`,
+        placeholder,
+        style: { minHeight: `${minHeight}px` }
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    Input,
+    {
+      type,
+      value: localValue,
+      onChange: handleChange,
+      onBlur: handleBlur,
+      disabled,
+      className,
+      placeholder
+    }
+  );
+}
+export {
+  DebouncedInput
+};
+//# sourceMappingURL=DebouncedInput.js.map

package/dist/ui/DebouncedInput.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ui/DebouncedInput.tsx"],
+  "sourcesContent": ["/**\n * DebouncedInput Component\n *\n * A text input that debounces onChange calls to reduce API calls.\n * Supports both single-line Input and multi-line Textarea.\n * Reverts to prop value on blur if local value differs (handles validation failures).\n */\n\nimport { Input } from './input'\nimport { Textarea } from './textarea'\nimport { useState, useCallback, useEffect, useRef } from 'react'\n\nexport interface DebouncedInputProps {\n  /** Current value */\n  value: string\n  /** Callback when value changes (debounced) */\n  onChange: (value: string) => void\n  /** Whether the input is disabled */\n  disabled?: boolean\n  /** Input type (text, number, etc.) */\n  type?: string\n  /** Whether to render as textarea */\n  multiline?: boolean\n  /** Additional CSS classes */\n  className?: string\n  /** Debounce delay in milliseconds */\n  debounceMs?: number\n  /** Placeholder text */\n  placeholder?: string\n  /** Auto-resize textarea to fit content (multiline only) */\n  autoResize?: boolean\n  /** Min height in pixels for auto-resize (default: 28, ~1 row) */\n  minHeight?: number\n  /** Max height in pixels for auto-resize (default: 72, ~3 rows) */\n  maxHeight?: number\n}\n\nexport function DebouncedInput({\n  value,\n  onChange,\n  disabled,\n  type = 'text',\n  multiline = false,\n  className,\n  debounceMs = 500,\n  placeholder,\n  autoResize = true,\n  minHeight = 28,\n  maxHeight = 72,\n}: DebouncedInputProps) {\n  const [localValue, setLocalValue] = useState(value)\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined)\n  const pendingRef = useRef<string | null>(null)\n  const textareaRef = useRef<HTMLTextAreaElement>(null)\n\n  // Auto-resize textarea based on content\n  const adjustHeight = useCallback(() => {\n    const textarea = textareaRef.current\n    if (!textarea || !autoResize) return\n\n    // Reset height to measure scrollHeight accurately\n    textarea.style.height = 'auto'\n    // Clamp between min and max\n    const newHeight = Math.min(Math.max(textarea.scrollHeight, minHeight), maxHeight)\n    textarea.style.height = `${newHeight}px`\n  }, [autoResize, minHeight, maxHeight])\n\n  // Sync from the prop (e.g. navigating between items) \u2014 but NEVER while the user\n  // has an uncommitted edit. The documents list refetches in the background, and\n  // an unguarded sync reset the box mid-word: typing \"2000-01-02\" landed as\n  // \"2000-\", losing characters with no indication anything had happened.\n  //\n  // `pendingRef` is set on every keystroke and cleared when the edit commits, so\n  // it is exactly \"the user is mid-edit\". Once committed, syncing resumes, which\n  // keeps the revert-on-rejected-save behaviour intact.\n  useEffect(() => {\n    if (pendingRef.current !== null) return\n    setLocalValue(value)\n  }, [value])\n\n  // Adjust height when value changes\n  useEffect(() => {\n    if (multiline) {\n      adjustHeight()\n    }\n  }, [localValue, multiline, adjustHeight])\n\n  // Timer + not-yet-committed value live in refs, NOT in a useMemo closure.\n  // Callers pass an inline arrow for `onChange`, so a useMemo keyed on it was\n  // rebuilt on every render and lost its `timeoutId`: clearTimeout() then cleared\n  // nothing, and there was no way to flush a pending edit from anywhere else.\n  // Hold the latest onChange without re-arming the timer every render.\n  const onChangeRef = useRef(onChange)\n  useEffect(() => {\n    onChangeRef.current = onChange\n  }, [onChange])\n\n  /** Commit a queued edit immediately. Returns false when nothing was queued. */\n  const flushPendingChange = useCallback(() => {\n    if (pendingRef.current === null) return false\n    const pending = pendingRef.current\n    pendingRef.current = null\n    clearTimeout(timeoutRef.current)\n    onChangeRef.current(pending)\n    return true\n  }, [])\n\n  const handleChange = useCallback(\n    (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => {\n      const newValue = e.target.value\n      setLocalValue(newValue)\n      pendingRef.current = newValue\n      clearTimeout(timeoutRef.current)\n      timeoutRef.current = setTimeout(() => {\n        pendingRef.current = null\n        onChangeRef.current(newValue)\n      }, debounceMs)\n    },\n    [debounceMs]\n  )\n\n  // On unmount, COMMIT a queued edit rather than dropping it. A background\n  // refetch (or navigating away) can replace this input while the debounce is\n  // still armed; the timer and the pending value die with the old instance, and\n  // the fresh one blurs with nothing queued \u2014 so the edit disappeared with no\n  // request at all. Refs are read in cleanup, so this is safe: no state is set on\n  // an unmounted component.\n  useEffect(\n    () => () => {\n      const pending = pendingRef.current\n      pendingRef.current = null\n      clearTimeout(timeoutRef.current)\n      if (pending !== null) onChangeRef.current(pending)\n    },\n    []\n  )\n\n  // Blur COMMITS a queued edit before any revert is considered. Reverting first\n  // silently threw away anything typed inside the debounce window: tab away\n  // quickly and the edit vanished with no request and no error.\n  //\n  // The revert still applies when nothing is queued, which is its actual purpose\n  // \u2014 after a rejected save the prop still holds the last valid value, so\n  // snapping back to it clears the invalid text left in the box.\n  const handleBlur = useCallback(() => {\n    // Commit first, then fall back to the prop. Both steps matter:\n    //  - flushing stops an edit typed inside the debounce window being discarded;\n    //  - snapping back to `value` handles a REJECTED save, where the parent never\n    //    changes the prop (e.g. a malformed date fails validation and no request\n    //    is sent). Without it the box keeps showing text that was never saved.\n    // On a successful save the parent updates `value` from the response and the\n    // sync effect brings the committed value straight back in.\n    flushPendingChange()\n    if (localValue !== value) {\n      setLocalValue(value)\n    }\n  }, [flushPendingChange, localValue, value])\n\n  if (multiline) {\n    return (\n      <Textarea\n        ref={textareaRef}\n        value={localValue}\n        onChange={handleChange}\n        onBlur={handleBlur}\n        disabled={disabled}\n        className={`resize-y ${className || ''}`}\n        placeholder={placeholder}\n        style={{ minHeight: `${minHeight}px` }}\n      />\n    )\n  }\n\n  return (\n    <Input\n      type={type}\n      value={localValue}\n      onChange={handleChange}\n      onBlur={handleBlur}\n      disabled={disabled}\n      className={className}\n      placeholder={placeholder}\n    />\n  )\n}\n"],
+  "mappings": "AAgKM;AAxJN,SAAS,aAAa;AACtB,SAAS,gBAAgB;AACzB,SAAS,UAAU,aAAa,WAAW,cAAc;AA2BlD,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP,YAAY;AAAA,EACZ;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,YAAY;AACd,GAAwB;AACtB,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAClD,QAAM,aAAa,OAAkD,MAAS;AAC9E,QAAM,aAAa,OAAsB,IAAI;AAC7C,QAAM,cAAc,OAA4B,IAAI;AAGpD,QAAM,eAAe,YAAY,MAAM;AACrC,UAAM,WAAW,YAAY;AAC7B,QAAI,CAAC,YAAY,CAAC,WAAY;AAG9B,aAAS,MAAM,SAAS;AAExB,UAAM,YAAY,KAAK,IAAI,KAAK,IAAI,SAAS,cAAc,SAAS,GAAG,SAAS;AAChF,aAAS,MAAM,SAAS,GAAG,SAAS;AAAA,EACtC,GAAG,CAAC,YAAY,WAAW,SAAS,CAAC;AAUrC,YAAU,MAAM;AACd,QAAI,WAAW,YAAY,KAAM;AACjC,kBAAc,KAAK;AAAA,EACrB,GAAG,CAAC,KAAK,CAAC;AAGV,YAAU,MAAM;AACd,QAAI,WAAW;AACb,mBAAa;AAAA,IACf;AAAA,EACF,GAAG,CAAC,YAAY,WAAW,YAAY,CAAC;AAOxC,QAAM,cAAc,OAAO,QAAQ;AACnC,YAAU,MAAM;AACd,gBAAY,UAAU;AAAA,EACxB,GAAG,CAAC,QAAQ,CAAC;AAGb,QAAM,qBAAqB,YAAY,MAAM;AAC3C,QAAI,WAAW,YAAY,KAAM,QAAO;AACxC,UAAM,UAAU,WAAW;AAC3B,eAAW,UAAU;AACrB,iBAAa,WAAW,OAAO;AAC/B,gBAAY,QAAQ,OAAO;AAC3B,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,QAAM,eAAe;AAAA,IACnB,CAAC,MAAiE;AAChE,YAAM,WAAW,EAAE,OAAO;AAC1B,oBAAc,QAAQ;AACtB,iBAAW,UAAU;AACrB,mBAAa,WAAW,OAAO;AAC/B,iBAAW,UAAU,WAAW,MAAM;AACpC,mBAAW,UAAU;AACrB,oBAAY,QAAQ,QAAQ;AAAA,MAC9B,GAAG,UAAU;AAAA,IACf;AAAA,IACA,CAAC,UAAU;AAAA,EACb;AAQA;AAAA,IACE,MAAM,MAAM;AACV,YAAM,UAAU,WAAW;AAC3B,iBAAW,UAAU;AACrB,mBAAa,WAAW,OAAO;AAC/B,UAAI,YAAY,KAAM,aAAY,QAAQ,OAAO;AAAA,IACnD;AAAA,IACA,CAAC;AAAA,EACH;AASA,QAAM,aAAa,YAAY,MAAM;AAQnC,uBAAmB;AACnB,QAAI,eAAe,OAAO;AACxB,oBAAc,KAAK;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,oBAAoB,YAAY,KAAK,CAAC;AAE1C,MAAI,WAAW;AACb,WACE;AAAA,MAAC;AAAA;AAAA,QACC,KAAK;AAAA,QACL,OAAO;AAAA,QACP,UAAU;AAAA,QACV,QAAQ;AAAA,QACR;AAAA,QACA,WAAW,YAAY,aAAa,EAAE;AAAA,QACtC;AAAA,QACA,OAAO,EAAE,WAAW,GAAG,SAAS,KAAK;AAAA;AAAA,IACvC;AAAA,EAEJ;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO;AAAA,MACP,UAAU;AAAA,MACV,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;",
+  "names": []
+}

package/dist/ui/DictateContext.js

@@ -0,0 +1,8 @@
+import { useHostConfigRecord } from "../host/context.js";
+function useDictateContext() {
+  return useHostConfigRecord().dictate ?? null;
+}
+export {
+  useDictateContext
+};
+//# sourceMappingURL=DictateContext.js.map

package/dist/ui/DictateContext.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ui/DictateContext.tsx"],
+  "sourcesContent": ["/**\n * Dictation for every `Input`/`Textarea` with a `dictate` prop, instead of threading a\n * `transcribe` function through each field. A host gives it once, as the host configuration's\n * `dictate` (`<ArbiHost config={{ dictate: { transcribe, onError } }}>`); every `dictate`-enabled\n * field downstream then just works. Without it fields render without a mic button: dictation is a\n * progressive enhancement, never a hard requirement.\n */\n\nimport { useHostConfigRecord } from '../host/context'\n\nexport interface DictateContextValue {\n  transcribe: (blob: Blob) => Promise<string>\n  onError?: (message: string) => void\n}\n\nexport function useDictateContext(): DictateContextValue | null {\n  return (useHostConfigRecord().dictate as DictateContextValue | undefined) ?? null\n}\n"],
+  "mappings": "AAQA,SAAS,2BAA2B;AAO7B,SAAS,oBAAgD;AAC9D,SAAQ,oBAAoB,EAAE,WAA+C;AAC/E;",
+  "names": []
+}

package/dist/ui/IconToggle.js

@@ -0,0 +1,79 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Plus, Minus } from "lucide-react";
+import { Tooltip, TooltipContent, TooltipTrigger } from "./tooltip.js";
+function IconToggle({
+  icon: Icon,
+  isActive,
+  onToggle,
+  colors,
+  inactiveColors,
+  fillWhenActive = false,
+  disabled = false,
+  disabledTooltip,
+  showLabel = false,
+  label,
+  tooltipActive,
+  tooltipInactive,
+  tooltipMixed,
+  isMixed = false,
+  showTooltip = true,
+  "data-testid": dataTestId
+}) {
+  const handleClick = (e) => {
+    e.stopPropagation();
+    onToggle(!isActive);
+  };
+  const { bg: bgColorClass } = colors;
+  const tooltipText = disabled ? disabledTooltip : isMixed ? tooltipMixed : isActive ? tooltipActive : tooltipInactive;
+  const { text: textColorClass } = colors;
+  const button = /* @__PURE__ */ jsx("div", { className: "inline-flex items-center gap-2", children: /* @__PURE__ */ jsxs(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      disabled,
+      "data-testid": dataTestId,
+      "aria-pressed": isMixed ? "mixed" : isActive,
+      "aria-label": label ?? tooltipText,
+      className: `
+          group/toggle relative inline-flex items-center h-4 w-8 rounded-full
+          pointer-coarse:after:absolute pointer-coarse:after:left-1/2 pointer-coarse:after:top-1/2 pointer-coarse:after:size-11 pointer-coarse:after:-translate-x-1/2 pointer-coarse:after:-translate-y-1/2 pointer-coarse:after:content-['']
+          transition-colors cursor-pointer
+          disabled:opacity-50 disabled:cursor-not-allowed
+          ${isActive ? bgColorClass : isMixed ? "bg-muted-foreground" : inactiveColors?.bg ?? "bg-muted"}
+        `,
+      children: [
+        isActive && !disabled && /* @__PURE__ */ jsx("div", { className: "absolute left-0 w-4 h-4 flex items-center justify-center", children: /* @__PURE__ */ jsx(Minus, { className: "w-2.5 h-2.5 text-white/70 hidden group-hover/toggle:block" }) }),
+        !isActive && !disabled && /* @__PURE__ */ jsx("div", { className: "absolute right-0 w-4 h-4 flex items-center justify-center", children: /* @__PURE__ */ jsx(Plus, { className: "w-2.5 h-2.5 text-muted-foreground hidden group-hover/toggle:block" }) }),
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: `
+            absolute h-4 w-4 rounded-full bg-white shadow-sm
+            flex items-center justify-center
+            transition-transform duration-200
+            ${isActive ? "translate-x-4" : "translate-x-0"}
+          `,
+            children: /* @__PURE__ */ jsx(
+              Icon,
+              {
+                className: `w-2.5 h-2.5 ${isActive ? textColorClass : inactiveColors?.text ?? "text-muted-foreground"} ${isActive && fillWhenActive ? "fill-current" : ""}`
+              }
+            )
+          }
+        )
+      ]
+    }
+  ) });
+  return /* @__PURE__ */ jsxs("div", { className: "inline-flex items-center gap-2", children: [
+    showLabel && label && /* @__PURE__ */ jsx("span", { className: "font-semibold text-sm text-primary", children: label }),
+    tooltipText && showTooltip ? /* @__PURE__ */ jsxs(Tooltip, { children: [
+      /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, onFocusCapture: (e) => e.stopPropagation(), children: button }),
+      /* @__PURE__ */ jsx(TooltipContent, { children: /* @__PURE__ */ jsx("p", { children: tooltipText }) })
+    ] }) : button
+  ] });
+}
+export {
+  IconToggle
+};
+//# sourceMappingURL=IconToggle.js.map

package/dist/ui/IconToggle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ui/IconToggle.tsx"],
+  "sourcesContent": ["/**\n * IconToggle Component\n *\n * Base visual toggle button - switch toggle with +/- on hover\n *\n * DO NOT use directly - use a purpose-named wrapper instead (e.g. a\n * ContactToggle, VisibilityToggle, InChatToggle) so each call site reads as\n * what it does, not as a generic switch.\n */\n\nimport { LucideIcon, Plus, Minus } from 'lucide-react'\nimport { Tooltip, TooltipContent, TooltipTrigger } from './tooltip'\n\ninterface ColorClasses {\n  text: string\n  bg: string\n}\n\nexport interface IconToggleProps {\n  icon: LucideIcon\n  isActive: boolean\n  onToggle: (isActive: boolean) => void\n  colors: ColorClasses\n  inactiveColors?: ColorClasses\n  fillWhenActive?: boolean\n  disabled?: boolean\n  /** Tooltip to show when disabled (e.g., \"You cannot unshare this resource\") */\n  disabledTooltip?: string\n  showLabel?: boolean\n  label?: string\n  tooltipActive?: string\n  tooltipInactive?: string\n  tooltipMixed?: string\n  isMixed?: boolean\n  /** Set to false to disable tooltip (useful when nested inside another tooltip) */\n  showTooltip?: boolean\n  'data-testid'?: string\n}\n\nexport function IconToggle({\n  icon: Icon,\n  isActive,\n  onToggle,\n  colors,\n  inactiveColors,\n  fillWhenActive = false,\n  disabled = false,\n  disabledTooltip,\n  showLabel = false,\n  label,\n  tooltipActive,\n  tooltipInactive,\n  tooltipMixed,\n  isMixed = false,\n  showTooltip = true,\n  'data-testid': dataTestId,\n}: IconToggleProps) {\n  const handleClick = (e: React.MouseEvent) => {\n    e.stopPropagation()\n    onToggle(!isActive)\n  }\n\n  const { bg: bgColorClass } = colors\n\n  const tooltipText = disabled\n    ? disabledTooltip\n    : isMixed\n      ? tooltipMixed\n      : isActive\n        ? tooltipActive\n        : tooltipInactive\n\n  const { text: textColorClass } = colors\n\n  const button = (\n    <div className=\"inline-flex items-center gap-2\">\n      <button\n        type=\"button\"\n        onClick={handleClick}\n        disabled={disabled}\n        data-testid={dataTestId}\n        aria-pressed={isMixed ? 'mixed' : isActive}\n        aria-label={label ?? tooltipText}\n        className={`\n          group/toggle relative inline-flex items-center h-4 w-8 rounded-full\n          pointer-coarse:after:absolute pointer-coarse:after:left-1/2 pointer-coarse:after:top-1/2 pointer-coarse:after:size-11 pointer-coarse:after:-translate-x-1/2 pointer-coarse:after:-translate-y-1/2 pointer-coarse:after:content-['']\n          transition-colors cursor-pointer\n          disabled:opacity-50 disabled:cursor-not-allowed\n          ${isActive ? bgColorClass : isMixed ? 'bg-muted-foreground' : (inactiveColors?.bg ?? 'bg-muted')}\n        `}\n      >\n        {/* Hover icon on the opposite side of thumb - hidden when disabled */}\n        {isActive && !disabled && (\n          <div className=\"absolute left-0 w-4 h-4 flex items-center justify-center\">\n            <Minus className=\"w-2.5 h-2.5 text-white/70 hidden group-hover/toggle:block\" />\n          </div>\n        )}\n        {!isActive && !disabled && (\n          <div className=\"absolute right-0 w-4 h-4 flex items-center justify-center\">\n            <Plus className=\"w-2.5 h-2.5 text-muted-foreground hidden group-hover/toggle:block\" />\n          </div>\n        )}\n        {/* Sliding thumb */}\n        <div\n          className={`\n            absolute h-4 w-4 rounded-full bg-white shadow-sm\n            flex items-center justify-center\n            transition-transform duration-200\n            ${isActive ? 'translate-x-4' : 'translate-x-0'}\n          `}\n        >\n          <Icon\n            className={`w-2.5 h-2.5 ${isActive ? textColorClass : (inactiveColors?.text ?? 'text-muted-foreground')} ${isActive && fillWhenActive ? 'fill-current' : ''}`}\n          />\n        </div>\n      </button>\n    </div>\n  )\n\n  return (\n    <div className=\"inline-flex items-center gap-2\">\n      {showLabel && label && <span className=\"font-semibold text-sm text-primary\">{label}</span>}\n      {tooltipText && showTooltip ? (\n        <Tooltip>\n          <TooltipTrigger asChild onFocusCapture={(e) => e.stopPropagation()}>\n            {button}\n          </TooltipTrigger>\n          <TooltipContent>\n            <p>{tooltipText}</p>\n          </TooltipContent>\n        </Tooltip>\n      ) : (\n        button\n      )}\n    </div>\n  )\n}\n"],
+  "mappings": "AA4EM,SAkBM,KAlBN;AAlEN,SAAqB,MAAM,aAAa;AACxC,SAAS,SAAS,gBAAgB,sBAAsB;AA4BjD,SAAS,WAAW;AAAA,EACzB,MAAM;AAAA,EACN;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AAAA,EACjB,WAAW;AAAA,EACX;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV,cAAc;AAAA,EACd,eAAe;AACjB,GAAoB;AAClB,QAAM,cAAc,CAAC,MAAwB;AAC3C,MAAE,gBAAgB;AAClB,aAAS,CAAC,QAAQ;AAAA,EACpB;AAEA,QAAM,EAAE,IAAI,aAAa,IAAI;AAE7B,QAAM,cAAc,WAChB,kBACA,UACE,eACA,WACE,gBACA;AAER,QAAM,EAAE,MAAM,eAAe,IAAI;AAEjC,QAAM,SACJ,oBAAC,SAAI,WAAU,kCACb;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,SAAS;AAAA,MACT;AAAA,MACA,eAAa;AAAA,MACb,gBAAc,UAAU,UAAU;AAAA,MAClC,cAAY,SAAS;AAAA,MACrB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA,YAKP,WAAW,eAAe,UAAU,wBAAyB,gBAAgB,MAAM,UAAW;AAAA;AAAA,MAIjG;AAAA,oBAAY,CAAC,YACZ,oBAAC,SAAI,WAAU,4DACb,8BAAC,SAAM,WAAU,6DAA4D,GAC/E;AAAA,QAED,CAAC,YAAY,CAAC,YACb,oBAAC,SAAI,WAAU,6DACb,8BAAC,QAAK,WAAU,qEAAoE,GACtF;AAAA,QAGF;AAAA,UAAC;AAAA;AAAA,YACC,WAAW;AAAA;AAAA;AAAA;AAAA,cAIP,WAAW,kBAAkB,eAAe;AAAA;AAAA,YAGhD;AAAA,cAAC;AAAA;AAAA,gBACC,WAAW,eAAe,WAAW,iBAAkB,gBAAgB,QAAQ,uBAAwB,IAAI,YAAY,iBAAiB,iBAAiB,EAAE;AAAA;AAAA,YAC7J;AAAA;AAAA,QACF;AAAA;AAAA;AAAA,EACF,GACF;AAGF,SACE,qBAAC,SAAI,WAAU,kCACZ;AAAA,iBAAa,SAAS,oBAAC,UAAK,WAAU,sCAAsC,iBAAM;AAAA,IAClF,eAAe,cACd,qBAAC,WACC;AAAA,0BAAC,kBAAe,SAAO,MAAC,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAC9D,kBACH;AAAA,MACA,oBAAC,kBACC,8BAAC,OAAG,uBAAY,GAClB;AAAA,OACF,IAEA;AAAA,KAEJ;AAEJ;",
+  "names": []
+}

package/dist/ui/VerifiedToggle.js

@@ -0,0 +1,38 @@
+import { jsx } from "react/jsx-runtime";
+import { CheckCircle2 } from "lucide-react";
+import { IconToggle } from "./IconToggle.js";
+const COLORS = {
+  text: "text-green-text",
+  bg: "bg-green-text"
+};
+function VerifiedToggle({
+  verified,
+  onToggle,
+  disabled = false,
+  showLabel = true,
+  showTooltip = true,
+  tooltipActive,
+  tooltipInactive,
+  "data-testid": dataTestId
+}) {
+  return /* @__PURE__ */ jsx(
+    IconToggle,
+    {
+      icon: CheckCircle2,
+      isActive: verified,
+      onToggle,
+      colors: COLORS,
+      disabled,
+      showLabel,
+      label: "Verified",
+      showTooltip,
+      tooltipActive: tooltipActive || "Verified by a human \u2014 click to unverify",
+      tooltipInactive: tooltipInactive || "Not verified \u2014 click to verify",
+      "data-testid": dataTestId
+    }
+  );
+}
+export {
+  VerifiedToggle
+};
+//# sourceMappingURL=VerifiedToggle.js.map

package/dist/ui/VerifiedToggle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ui/VerifiedToggle.tsx"],
+  "sourcesContent": ["/**\n * VerifiedToggle Component\n *\n * Switch-style toggle for a fact's human-verified (`confirmed`) state \u2014 the\n * same IconToggle affordance the VisibilityToggle uses for sharing, so\n * \"Verified\" reads as a toggle in the facts table rather than a radio/checkbox.\n */\n\nimport { CheckCircle2 } from 'lucide-react'\nimport { IconToggle } from './IconToggle'\n\ninterface VerifiedToggleProps {\n  verified: boolean\n  /** Called with the desired next state (true = verify, false = unverify). */\n  onToggle: (shouldVerify: boolean) => void\n  disabled?: boolean\n  showLabel?: boolean\n  /** Set to false to disable the tooltip (e.g. when nested in another tooltip). */\n  showTooltip?: boolean\n  tooltipActive?: string\n  tooltipInactive?: string\n  'data-testid'?: string\n}\n\nconst COLORS = {\n  text: 'text-green-text',\n  bg: 'bg-green-text',\n}\n\nexport function VerifiedToggle({\n  verified,\n  onToggle,\n  disabled = false,\n  showLabel = true,\n  showTooltip = true,\n  tooltipActive,\n  tooltipInactive,\n  'data-testid': dataTestId,\n}: VerifiedToggleProps) {\n  return (\n    <IconToggle\n      icon={CheckCircle2}\n      isActive={verified}\n      onToggle={onToggle}\n      colors={COLORS}\n      disabled={disabled}\n      showLabel={showLabel}\n      label=\"Verified\"\n      showTooltip={showTooltip}\n      tooltipActive={tooltipActive || 'Verified by a human \u2014 click to unverify'}\n      tooltipInactive={tooltipInactive || 'Not verified \u2014 click to verify'}\n      data-testid={dataTestId}\n    />\n  )\n}\n"],
+  "mappings": "AAwCI;AAhCJ,SAAS,oBAAoB;AAC7B,SAAS,kBAAkB;AAe3B,MAAM,SAAS;AAAA,EACb,MAAM;AAAA,EACN,IAAI;AACN;AAEO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,cAAc;AAAA,EACd;AAAA,EACA;AAAA,EACA,eAAe;AACjB,GAAwB;AACtB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAM;AAAA,MACN,UAAU;AAAA,MACV;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA,OAAM;AAAA,MACN;AAAA,MACA,eAAe,iBAAiB;AAAA,MAChC,iBAAiB,mBAAmB;AAAA,MACpC,eAAa;AAAA;AAAA,EACf;AAEJ;",
+  "names": []
+}