@peasant-labs/fairtrade 0.0.28 → 0.0.30

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/VillageObservations.d.ts

@@ -0,0 +1,87 @@
+/** Metadata-only observation browsing. No effects, storage, routing or network requests.
+ * @param {VillageObservationsProps} props
+ */
+export default function VillageObservations({ accountLabel, villageLabel, domains, collectives, categories, view, categoryId, fetching, fetchDisabled, status, issue, onFetch, onTrack, onViewChange, onCategoryChange, onPageChange, onRestart, }: VillageObservationsProps): import("react").JSX.Element;
+/**
+ * Cooked presentation models. Hosts own wire validation, scope, tokens and policy.
+ */
+export type ObservationIssue = {
+    message: string;
+    retry: string;
+};
+/**
+ * Cooked presentation models. Hosts own wire validation, scope, tokens and policy.
+ */
+export type ObservationDomain = {
+    id: string;
+    label: string;
+    result: string;
+    commit?: string;
+    lastCompletedAt?: string;
+    lastAttemptAt?: string;
+    issue?: ObservationIssue;
+};
+/**
+ * Cooked presentation models. Hosts own wire validation, scope, tokens and policy.
+ */
+export type ObservedCollective = {
+    id: string;
+    name: string;
+    description?: string;
+    reasons: string[];
+    observedAt?: string;
+    state: string;
+    policy?: string;
+    tracking?: boolean;
+};
+/**
+ * Cooked presentation models. Hosts own wire validation, scope, tokens and policy.
+ */
+export type ContributionEvidenceRow = {
+    id: string;
+    title: string;
+    description?: string;
+    outcome: string;
+    occurredAt?: string;
+    details?: Array<{
+        label: string;
+        value: string;
+    }>;
+};
+/**
+ * Cooked presentation models. Hosts own wire validation, scope, tokens and policy.
+ */
+export type ContributionEvidenceCategory = {
+    id: string;
+    label: string;
+    rows: ContributionEvidenceRow[];
+    page: number;
+    pageCount: number;
+    total: number;
+    coverage: string;
+    issue?: ObservationIssue;
+    conflict?: boolean;
+    loading?: boolean;
+};
+/**
+ * Cooked presentation models. Hosts own wire validation, scope, tokens and policy.
+ */
+export type VillageObservationsProps = {
+    accountLabel: string;
+    villageLabel: string;
+    domains: ObservationDomain[];
+    collectives: ObservedCollective[];
+    categories: ContributionEvidenceCategory[];
+    view?: "catalog" | "history";
+    categoryId?: string;
+    fetching?: boolean;
+    fetchDisabled?: boolean;
+    status?: string;
+    issue?: ObservationIssue;
+    onFetch?: () => void;
+    onTrack?: (id: string, tracking: boolean) => void;
+    onViewChange?: (view: "catalog" | "history") => void;
+    onCategoryChange?: (id: string) => void;
+    onPageChange?: (id: string, page: number) => void;
+    onRestart?: (id: string) => void;
+};

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

@@ -2,6 +2,7 @@ export { default as Changes } from "./Changes.jsx";
 export { default as ChangeDetail } from "./ChangeDetail.jsx";
 export { default as CodeMapNavigator } from "./CodeMapNavigator.jsx";
 export { assertTimelineNavigationAction } from "./timelineNavigation.js";
+export { default as VillageObservations } from "../VillageObservations.jsx";
 export { default as SessionLane } from "./SessionLane.jsx";
 export { default as GhostCommitNode } from "./GhostCommitNode.jsx";
 export { default as GhostGroup } from "./GhostGroup.jsx";
@@ -21,6 +22,11 @@ export type InsightKind = import("@peasant-labs/schema").InsightKind;
 export type InsightProvenance = import("@peasant-labs/schema").InsightProvenance;
 export type ReadAttributionState = import("@peasant-labs/schema").ReadAttributionState;
 export type ReadStateGrade = import("@peasant-labs/schema").ReadStateGrade;
+export type VillageObservationsProps = import("../VillageObservations.jsx").VillageObservationsProps;
+export type ObservationDomain = import("../VillageObservations.jsx").ObservationDomain;
+export type ObservedCollective = import("../VillageObservations.jsx").ObservedCollective;
+export type ContributionEvidenceCategory = import("../VillageObservations.jsx").ContributionEvidenceCategory;
+export type ContributionEvidenceRow = import("../VillageObservations.jsx").ContributionEvidenceRow;
 export type CommitRefPayload = import("./types.js").CommitRefPayload;
 export type TimelineSessionPayload = import("./types.js").TimelineSessionPayload;
 export type MapEdgePayload = import("./types.js").MapEdgePayload;

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

@@ -27,9 +27,15 @@ export { default as StatsStrip } from "./StatsStrip.jsx";
 export { default as CopyIconButton } from "./CopyIconButton.jsx";
 export { default as OverflowList } from "./OverflowList.jsx";
 export { default as RepoPicker } from "./RepoPicker.jsx";
+export { default as VillageObservations } from "./VillageObservations.jsx";
 export * from "./transcript/index.js";
 export * from "./transcript/graph/index.js";
 export type TimelineNavigationAction = import("./graph/timelineNavigation.js").TimelineNavigationAction;
+export type VillageObservationsProps = import("./VillageObservations.jsx").VillageObservationsProps;
+export type ObservationDomain = import("./VillageObservations.jsx").ObservationDomain;
+export type ObservedCollective = import("./VillageObservations.jsx").ObservedCollective;
+export type ContributionEvidenceCategory = import("./VillageObservations.jsx").ContributionEvidenceCategory;
+export type ContributionEvidenceRow = import("./VillageObservations.jsx").ContributionEvidenceRow;
 export { default as Button, ButtonGroup, Segmented } from "./Button.jsx";
 export { default as Input, Textarea, Select, Field } from "./Input.jsx";
 export { default as Checkbox, Radio, RadioGroup } from "./Checkbox.jsx";
@@ -41,6 +47,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";