@peasant-labs/fairtrade 0.0.27 → 0.0.29

package/dist/lib/types/DataTable.d.ts

@@ -2,8 +2,8 @@
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -47,11 +47,14 @@
  * @param {DataTableColumnFilters} [props.defaultColumnFilters=[]] initial column filters.
  * @param {(next: DataTableColumnFilters) => void} [props.onColumnFiltersChange] next filters.
  * @param {DataTablePagination} [props.pagination] controlled pagination (zero-based pageIndex).
- * @param {DataTablePagination} [props.defaultPagination] defaults to pageIndex 0, pageSize 10.
+ * @param {DataTablePagination} [props.defaultPagination] enables local pagination with this initial state.
  * @param {(next: DataTablePagination) => void} [props.onPaginationChange] next pagination.
  * @param {number} [props.rowCount] host total for host-sliced data: pagination stays manual (the page count comes from rowCount) and sorting stays local, while search and column filters still apply to the rows given; with a partial window and an active filter the footer reports the loaded rows, never the host total.
+ * @param {(controls: Parameters<typeof import('./DataTableControls.jsx').DataTableToolbar>[0]) => React.ReactNode} [props.toolbar] optional controls; render DataTableToolbar or importer-owned content.
+ * @param {(controls: Parameters<typeof DataTablePaginationControls>[0]) => React.ReactNode} [props.footer] optional footer; replaces the default pager when pagination is enabled.
+ * @param {React.CSSProperties['maxHeight']} [props.maxHeight] explicit inner scroll bound; natural height when omitted.
  */
-export default function DataTable({ columns, rows, selectable, disabled, rowKey, defaultSort, sort: sortProp, onSortChange, defaultSelectedKeys, selectedKeys: selectedProp, onSelectionChange, caption, className, search: searchProp, defaultSearch, onSearchChange, columnFilters: filtersProp, defaultColumnFilters, onColumnFiltersChange, pagination: paginationProp, defaultPagination, onPaginationChange, rowCount, }: {
+export default function DataTable({ columns, rows, selectable, disabled, rowKey, defaultSort, sort: sortProp, onSortChange, defaultSelectedKeys, selectedKeys: selectedProp, onSelectionChange, caption, className, search: searchProp, defaultSearch, onSearchChange, columnFilters: filtersProp, defaultColumnFilters, onColumnFiltersChange, pagination: paginationProp, defaultPagination, onPaginationChange, rowCount, toolbar, footer, maxHeight, }: {
     columns: DataTableColumn[];
     rows: any[];
     selectable?: boolean;
@@ -75,13 +78,16 @@ export default function DataTable({ columns, rows, selectable, disabled, rowKey,
     defaultPagination?: DataTablePagination;
     onPaginationChange?: (next: DataTablePagination) => void;
     rowCount?: number;
+    toolbar?: (controls: Parameters<typeof import("./DataTableControls.jsx").DataTableToolbar>[0]) => React.ReactNode;
+    footer?: (controls: Parameters<typeof DataTablePaginationControls>[0]) => React.ReactNode;
+    maxHeight?: React.CSSProperties["maxHeight"];
 }): import("react").JSX.Element;
 /**
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -122,8 +128,8 @@ export type DataTableColumn = {
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -142,8 +148,8 @@ export type DataTableSort = {
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -162,8 +168,8 @@ export type DataTableColumnFilters = {
  * a sortable + selectable data table. square, hairline, mono headers; both themes
  * via tokens. sort + selection state/logic are powered by TanStack Table
  * (@tanstack/react-table, headless) while this component still renders its own markup
- * + token classes. Search, column filters and pagination can each be host-controlled
- * or seeded by defaults. Sorting cycles none -> asc -> desc -> none on a
+ * + token classes. Search and filter controls are opt-in toolbar content. Pagination
+ * is enabled only by explicit pagination/defaultPagination props. Sorting cycles none -> asc -> desc -> none on a
  * sortable header (a real <button>, so it is keyboard-operable), exposes aria-sort on the
  * <th>, and shows a lucide chevron indicator. selection reuses the existing .check-box control:
  * a header checkbox selects/clears all (with an indeterminate middle state) and
@@ -178,3 +184,4 @@ export type DataTablePagination = {
     pageIndex: number;
     pageSize: number;
 };
+import { DataTablePaginationControls } from './DataTableControls.jsx';

package/dist/lib/types/DataTableControls.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Optional table controls. Omit search or columnFilters to leave that control out;
+ * children extend the toolbar with importer-owned actions.
+ * @param {Object} props
+ * @param {{ value: string, onChange: (value: string) => void }} [props.search]
+ * @param {{ columns: import('./DataTable.jsx').DataTableColumn[], value: import('./DataTable.jsx').DataTableColumnFilters, onChange: (value: import('./DataTable.jsx').DataTableColumnFilters) => void }} [props.columnFilters]
+ * @param {boolean} [props.disabled=false]
+ * @param {React.ReactNode} [props.children]
+ */
+export function DataTableToolbar({ search, columnFilters, disabled, children }: {
+    search?: {
+        value: string;
+        onChange: (value: string) => void;
+    };
+    columnFilters?: {
+        columns: import("./DataTable.jsx").DataTableColumn[];
+        value: import("./DataTable.jsx").DataTableColumnFilters;
+        onChange: (value: import("./DataTable.jsx").DataTableColumnFilters) => void;
+    };
+    disabled?: boolean;
+    children?: React.ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Optional pagination/footer presentation, independent of the table's row markup.
+ * @param {Object} props
+ * @param {string} props.countLabel
+ * @param {number} props.pageIndex
+ * @param {number} props.pageCount
+ * @param {boolean} props.canPreviousPage
+ * @param {boolean} props.canNextPage
+ * @param {() => void} props.onPreviousPage
+ * @param {() => void} props.onNextPage
+ * @param {boolean} [props.disabled=false]
+ */
+export function DataTablePaginationControls({ countLabel, pageIndex, pageCount, canPreviousPage, canNextPage, onPreviousPage, onNextPage, disabled }: {
+    countLabel: string;
+    pageIndex: number;
+    pageCount: number;
+    canPreviousPage: boolean;
+    canNextPage: boolean;
+    onPreviousPage: () => void;
+    onNextPage: () => void;
+    disabled?: boolean;
+}): import("react").JSX.Element;

package/dist/lib/types/Publish.d.ts

@@ -108,7 +108,7 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * @param {string} props.title - the session title, kept in its case.
  * @param {'publish'|'update'} [props.mode='publish']
  * @param {PublishDialogState} props.state - one of PUBLISH_DIALOG_STATES.
- * @param {{ matches?: object[], matchCount?: number, total?: number, failure?: string }} [props.scan] - the host's scan result. `matchCount` is the full occurrence count when `matches` contains only examples. Until it carries a
+ * @param {{ matches?: import('./Redaction.jsx').RedactionMatch[], matchCount?: number, total?: number, failure?: string }} [props.scan] - the host's scan result. `matchCount` is the full occurrence count when `matches` contains only examples. Until it carries a
  *        `matches` list, the popup says the transcript is not scanned and keeps publish off. A match with `kept: true` leaves un-redacted, and the
  *        popup says so and opens the matches.
  * @param {() => void} [props.onRescan]
@@ -124,17 +124,18 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * @param {() => void} [props.onConnect] - `continue with github`.
  * @param {string} [props.joinHref] - `create or join one on village`.
  * @param {string} [props.stoppedAt] - the step that failed, in words ("setting who can read it").
- * @param {() => void} [props.onRetry]
+ * @param {() => void} [props.onRecover] - stopped-state prerequisite read/sign-in recovery only; may run before a scan or audience exists, but never with an explicitly refused review. Mutually exclusive with onRetry. Must not publish.
+ * @param {() => void} [props.onRetry] - stopped-state actual publication retry; requires a valid review and audience. Mutually exclusive with onRecover.
  * @param {{ url: string, collectives: string[], pending?: string[], pullRequest?: { number: number, branch: string, href?: string } }} [props.done]
  */
-export function PublishDialog({ open, onClose, title, mode, state, scan, onRescan, changes, access, onRemove, onRestore, picker, autoPublish, accessSummary, primaryLabel, onPublish, onConnect, joinHref, stoppedAt, onRetry, done, }: {
+export function PublishDialog({ open, onClose, title, mode, state, scan, onRescan, changes, access, onRemove, onRestore, picker, autoPublish, accessSummary, primaryLabel, onPublish, onConnect, joinHref, stoppedAt, onRecover, onRetry, done, }: {
     open: boolean;
     onClose: () => void;
     title: string;
     mode?: "publish" | "update";
     state: PublishDialogState;
     scan?: {
-        matches?: object[];
+        matches?: import("./Redaction.jsx").RedactionMatch[];
         matchCount?: number;
         total?: number;
         failure?: string;
@@ -158,6 +159,7 @@ export function PublishDialog({ open, onClose, title, mode, state, scan, onResca
     onConnect?: () => void;
     joinHref?: string;
     stoppedAt?: string;
+    onRecover?: () => void;
     onRetry?: () => void;
     done?: {
         url: string;

package/dist/lib/types/Redaction.d.ts

@@ -1,3 +1,4 @@
+/** @typedef {{id:string, category: import('@peasant-labs/schema').RedactionCategory, confidence:number, before?:string, secret?:string, after:string, kept?:boolean}} RedactionMatch */
 /**
  * RedactionReview — the safe-by-default review surface.
  *
@@ -8,7 +9,7 @@
  *          empty input throws an actionable TypeError before the review renders.
  * @param {(level: 'minimal'|'standard'|'maximum') => void} [props.onLevel]
  *        - called only with an available level on select
- * @param {Array<{id, category: import('./redaction-categories.js').RedactionCategory, confidence:number, before?:string, secret?:string, after:string, kept?:boolean}>} [props.matches]
+ * @param {RedactionMatch[]} [props.matches]
  *        - the flagged matches. `before`/`secret` is the original (one or the other), `after` the
  *          redacted form. `kept` (controlled mode) = the user opted OUT, secret leaves as-is.
  * @param {(id: string, kept: boolean) => void} [props.onToggle] - called when a match is toggled;
@@ -24,15 +25,7 @@ export function RedactionReview({ level, availableLevels, onLevel, matches, onTo
     level?: "minimal" | "standard" | "maximum";
     availableLevels?: readonly ("minimal" | "standard" | "maximum")[];
     onLevel?: (level: "minimal" | "standard" | "maximum") => void;
-    matches?: Array<{
-        id: any;
-        category: import("./redaction-categories.js").RedactionCategory;
-        confidence: number;
-        before?: string;
-        secret?: string;
-        after: string;
-        kept?: boolean;
-    }>;
+    matches?: RedactionMatch[];
     onToggle?: (id: string, kept: boolean) => void;
     scanned?: number;
     total?: number;
@@ -59,3 +52,12 @@ export function WhereDoesThisGo({ destination, sent, private: stays, className,
     className?: string;
 }): import("react").JSX.Element;
 export default RedactionReview;
+export type RedactionMatch = {
+    id: string;
+    category: import("@peasant-labs/schema").RedactionCategory;
+    confidence: number;
+    before?: string;
+    secret?: string;
+    after: string;
+    kept?: boolean;
+};

package/dist/lib/types/index.d.ts

@@ -41,6 +41,7 @@ export { Avatar, AvatarGroup, Kbd, KbdChord, Tag } from "./Avatar.jsx";
 export { default as BrandMark, resolveBrand } from "./BrandMark.jsx";
 export { providerAccent, providerDisplayName } from "./provider-policy.js";
 export { Skeleton, Progress, Spinner, Toast, FeedbackPanel } from "./Feedback.jsx";
+export { DataTableToolbar, DataTablePaginationControls } from "./DataTableControls.jsx";
 export { default as HelperGroup, HelperGroupListItem, HelperThreadRow, useHelperSelection, helperOwnerState, helperSelectionIds, helperOwnerToggle, helperMemberToggle, HELPER_OWNER_STATE } from "./HelperGroup.jsx";
 export { default as Timeline, TimelineItem, ToolCall, ThinkingBlock } from "./Timeline.jsx";
 export { default as ToastProvider, useToast } from "./ToastHost.jsx";
@@ -65,3 +66,4 @@ export { PublishStateLabel, PublishBar, AccessList, CollectivePicker, PublishDia
 export { SettingRow, SettingGroup, SettingStatus, SETTING_ROW_STATES } from "./Settings.jsx";
 export { default as VisibilitySegmented, VisibilityEye, ScopeChip, FocusedModeToggle } from "./VisibilityControl.jsx";
 export { default as InUseShell, GraphAppShell, GraphSectionNav, IN_USE_APPS, LOCAL_APP_SECTIONS, GRAPH_APP_SECTIONS } from "./inuse/InUseShell.jsx";
+export { RedactionCategory, RedactionCategoryLabel, AllRedactionCategories, AllRedactionCategoryLabels, isRedactionCategory, parseRedactionCategory, parseRedactionCategoryLabel, redactionCategoryFromLabel, redactionCategoryLabel } from "@peasant-labs/schema";

package/dist/lib/types/redaction-categories.d.ts

@@ -1,17 +1,2 @@
-/** @typedef {'secrets'|'pii'|'paths'|'project'} RedactionCategory */
-/** @param {unknown} category */
-export function redactionCategoryLabel(category: unknown): any;
 /** @param {unknown} matches */
 export function hasKnownRedactionCategories(matches: unknown): boolean;
-/**
- * Audited JS projection of github.com/peasant-labs/redact/category_string.go:
- * Category.String maps wire categories to these exact rendered labels.
- * Unknown input is never a trusted category or a display-label fallback.
- */
-export const REDACTION_CATEGORY_LABELS: Readonly<{
-    secrets: "CREDENTIAL";
-    pii: "PII";
-    paths: "PATH";
-    project: "INTERNAL";
-}>;
-export type RedactionCategory = "secrets" | "pii" | "paths" | "project";