@arbidocs/blocks 0.3.185 → 0.4.0

package/dist/facts/FactsToolbar.d.ts

@@ -0,0 +1,53 @@
+import { type ReactNode } from 'react';
+import { type FactsFilterInputLabels, type FactsFilterInputTestIds, type FactsSearchField } from './FactsFilterInput';
+import { type FactsViewMode, type FactsViewToggleLabels } from './FactsViewToggle';
+export interface FactsToolbarLabels {
+    tags: string;
+    newFact: string;
+}
+export declare const DEFAULT_FACTS_TOOLBAR_LABELS: FactsToolbarLabels;
+export interface FactsToolbarTestIds {
+    tab: string;
+    tagsButton: string;
+    newFact: string;
+    filterBar: string;
+    filterBarNav: string;
+}
+export interface FactsToolbarProps {
+    /** Facts matching the current filters (shown beside the glyph). */
+    count: number;
+    /** Solid-fill the count while any filter is narrowing the list. */
+    hasActiveFilters: boolean;
+    filterText: string;
+    onFilterTextChange: (text: string) => void;
+    searchFields: FactsSearchField[];
+    onSearchFieldsChange: (fields: FactsSearchField[]) => void;
+    /** The quick-filter dropdown, embedded inside the filter box. */
+    quickFilter?: ReactNode;
+    /** Open the Labels panel. Omit it to hide the Tags button. */
+    onOpenTags?: () => void;
+    viewMode: FactsViewMode;
+    onViewModeChange: (mode: FactsViewMode) => void;
+    onNewFact: () => void;
+    /** Second row: left slot for the row navigator (portal host for calendar/timeline). */
+    navSlotRef?: (el: HTMLElement | null) => void;
+    /** Table navigator rendered directly in the left slot. */
+    navigator?: ReactNode;
+    /** Second row, right side: per-view controls (Fields, density, zoom). */
+    tools?: ReactNode;
+    /** Smart Search has no toolbar row. */
+    showToolbarRow?: boolean;
+    labels?: Partial<FactsToolbarLabels>;
+    testIds?: Partial<FactsToolbarTestIds>;
+    /** Overrides for the embedded filter box. */
+    filterLabels?: Partial<FactsFilterInputLabels>;
+    filterTestIds?: Partial<FactsFilterInputTestIds>;
+    /** Overrides for the embedded view toggle. */
+    viewToggleLabels?: Partial<FactsViewToggleLabels>;
+    viewToggleTestIdPrefix?: string;
+}
+/**
+ * Facts page header: count tab with filter box and Tags button, the view toggle centred, New fact
+ * on the right (the page's one primary action), and a second row for per-view controls.
+ */
+export declare function FactsToolbar({ count, hasActiveFilters, filterText, onFilterTextChange, searchFields, onSearchFieldsChange, quickFilter, onOpenTags, viewMode, onViewModeChange, onNewFact, navSlotRef, navigator, tools, showToolbarRow, labels, testIds, filterLabels, filterTestIds, viewToggleLabels, viewToggleTestIdPrefix, }: FactsToolbarProps): import("react").JSX.Element;

package/dist/facts/FactsViewToggle.d.ts

@@ -0,0 +1,36 @@
+/**
+ * FactsViewToggle
+ *
+ * Table / Calendar / Timeline switch for the Notes page. (The list view
+ * retired into the table — 'list' stays in the type for old deep links,
+ * which the page maps to 'table'.) Uses the shared
+ * ViewToggle so it matches Documents (Gallery / Table / Review), Home and Smart
+ * Search rather than being a fifth bespoke button group, and sits in the tab
+ * header where every other page puts its views.
+ *
+ * Calendar and Timeline read only the dated notes — a note without a date has
+ * nowhere to sit on either — which the tooltips say rather than the labels.
+ */
+export type FactsViewMode = 'list' | 'table' | 'calendar' | 'gantt' | 'smart_search';
+export interface FactsViewToggleLabels {
+    table: string;
+    calendar: string;
+    timeline: string;
+    smartSearch: string;
+}
+export declare const DEFAULT_FACTS_VIEW_TOGGLE_LABELS: FactsViewToggleLabels;
+export interface FactsViewToggleProps {
+    viewMode: FactsViewMode;
+    onChange: (mode: FactsViewMode) => void;
+    /**
+     * Collapse the labels to icons. Driven by a width measurement of the header
+     * row (see FactsPage) rather than a `@container`, so the toggle can stay
+     * absolutely centred — its position never shifts with the side controls —
+     * while still collapsing when the row actually runs out of room.
+     */
+    collapsed?: boolean;
+    labels?: Partial<FactsViewToggleLabels>;
+    /** Item test ids are `${testIdPrefix}-${mode}-button` (default `facts-layout`). */
+    testIdPrefix?: string;
+}
+export declare function FactsViewToggle({ viewMode, onChange, collapsed, labels, testIdPrefix, }: FactsViewToggleProps): import("react").JSX.Element;

package/dist/facts/fact-date.d.ts

@@ -0,0 +1,22 @@
+export interface FactDateFields {
+    /** `YYYY-MM-DD`. Empty means the fact has no date at all. */
+    date: string;
+    /** `HH:MM`. Empty means `date` is a whole day, not an instant. */
+    time: string;
+    /** IANA zone `time` is expressed in. Only meaningful (and only sent) when `time` is set. */
+    timezone: string;
+    /** `YYYY-MM-DD` end of a range. Empty means a single day/instant, not a span. */
+    endDate: string;
+    /** `HH:MM` paired with `endDate`, only offered once `time` is set. */
+    endTime: string;
+}
+export declare const EMPTY_FACT_DATE_FIELDS: FactDateFields;
+/** Editable fields from a stored fact's date span — the inverse of `factDateFieldsToSpan`. */
+export declare function factDateSpanToFields(dateStart: string | null | undefined, dateEnd: string | null | undefined, timezone: string | null | undefined): FactDateFields;
+/** A fact's date span for the API — the inverse of `factDateSpanToFields`. `null`s
+ *  clear the span entirely; a bare date (no time) stays timezone-agnostic. */
+export declare function factDateFieldsToSpan(fields: FactDateFields): {
+    date: string | null;
+    date_end: string | null;
+    timezone: string | null;
+};

package/dist/facts/fact-text.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A fact's text is written in the rich markdown editor, which encodes
+ * otherwise-insignificant whitespace as HTML character references so it survives
+ * markdown's round-trip — a trailing space becomes ` `, a tab `	`, and
+ * so on. The editor decodes them back when it re-renders, but anything that
+ * shows the raw text (the grid cell, its tooltip) prints the reference verbatim,
+ * so a fact reads like `This is a fact. ` instead of `This is a fact.`.
+ *
+ * {@link decodeWhitespaceEntities} turns those references back into the
+ * characters they stand for. Only WHITESPACE code points are decoded, so the
+ * result is safe both to store as markdown (an escaped `*` or `<` is never
+ * turned back into active syntax) and to show as plain text.
+ */
+export declare function decodeWhitespaceEntities(text: string | null | undefined): string;

package/dist/facts/factColumns.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Column definitions for the Facts grid. Every column has an explicit `colId` (AG Grid persists
+ * column state by id: see CLAUDE.md). The app supplies behaviour and app-specific cells through
+ * slots; the structure, widths, sorting, filters and presentational cells live here.
+ */
+import type { ReactNode } from 'react';
+import type { ColDef, ICellRendererParams, IHeaderParams, ValueGetterParams } from 'ag-grid-community';
+export interface FactColumnLabels {
+    pinnedHeaderTooltip: string;
+    pinnedTitle: string;
+    unpinnedTitle: string;
+    unpin: string;
+    pin: string;
+    fact: string;
+    dates: string;
+    dateTitle: string;
+    labels: string;
+    verified: string;
+    verifiedTooltip: string;
+    shared: string;
+    sharedTooltip: string;
+    createdBy: string;
+    sources: string;
+    /** Tooltip of the Sources cell for `count` cited documents. */
+    sourcedFrom: (count: number) => string;
+    createdAt: string;
+    updated: string;
+    id: string;
+}
+export declare const DEFAULT_FACT_COLUMN_LABELS: FactColumnLabels;
+export interface FactColumnTestIds {
+    pinned: (factId: string) => string;
+    text: (factId: string) => string;
+    date: (factId: string) => string;
+}
+/** The fields of a fact the grid reads. Callers' richer types are accepted as-is. */
+export interface FactRowView {
+    external_id: string;
+    text: string;
+    pinned: boolean;
+    confirmed: boolean;
+    shared: boolean;
+    date_start?: string | null;
+    date_end?: string | null;
+    timezone?: string | null;
+    tags?: Array<{
+        name: string;
+    }> | null;
+    citations?: unknown[] | null;
+    created_by_ext_id?: string | null;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+export interface FactColumnSlots<T extends FactRowView> {
+    onTogglePin: (fact: T) => void;
+    /** Custom header (persistent filter button) for the columns that use one. */
+    renderHeader: (params: IHeaderParams, colId: string) => ReactNode;
+    /** Row action menu, shown at the right edge of the Fact cell. */
+    renderRowActions: (fact: T, params: ICellRendererParams<T>) => ReactNode;
+    /** Inline label picker for the Labels cell. */
+    renderLabels: (fact: T, params: ICellRendererParams<T>) => ReactNode;
+    /** The Verified switch. */
+    renderVerified: (fact: T) => ReactNode;
+    /** The Shared switch. */
+    renderShared: (fact: T) => ReactNode;
+    /** The creator avatar. */
+    renderCreator: (fact: T, params: ICellRendererParams<T>) => ReactNode;
+    /** Sort/filter value for the Created by column (the creator's display name). */
+    getCreatorName: (params: ValueGetterParams<T>) => string;
+    /** Friendly display of an ISO timestamp (Created at / Updated). */
+    formatDate: (iso: string) => string;
+    labels?: Partial<FactColumnLabels>;
+    testIds?: Partial<FactColumnTestIds>;
+}
+/**
+ * Date-filter params for a column whose value is an ISO string. AG Grid hands the comparator a JS
+ * `Date` from the picker and the raw cell value; this compares UTC day components so a filter
+ * never shifts a date by a day for viewers west of UTC.
+ */
+export declare const ISO_DATE_FILTER_PARAMS: {
+    browserDatePicker: boolean;
+    comparator: (filterDate: Date, cellValue: unknown) => number;
+};
+/** How many source documents a fact cites (the Sources column counts documents, not passages). */
+export declare function sourceDocCount(fact: Pick<FactRowView, 'citations'> | undefined): number;
+/** Default left-to-right order; default-hidden columns trail. Every colId must be listed. */
+export declare const DEFAULT_FACT_COLUMN_ORDER: readonly ["pinned", "text", "sources", "tags", "date", "confirmed", "shared", "created_by", "created_at", "updated_at", "note_id"];
+export declare function createFactColumns<T extends FactRowView>(slots: FactColumnSlots<T>): ColDef<T>[];