@peasant-labs/fairtrade 0.0.39 → 0.0.40

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

@@ -1,3 +1,14 @@
+/**
+ * The words of a wrapped command and the spaces between them, as the line breaks them: a lone "|"
+ * keeps to the word after it, so a pipe never starts or ends a line on its own.
+ * @param {string} command
+ * @returns {Array<{ word: string } | { space: string }>}
+ */
+export function commandWords(command: string): Array<{
+    word: string;
+} | {
+    space: string;
+}>;
 /**
  * CommandBlock — a square `$ command` block: a mono command line with a leading dim `$`, and a copy
  * button that flips to an olive check + the word "copied" for ~1.5s.

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

@@ -6,12 +6,14 @@
  *
  *  redaction:  variant="redaction", pass `matches` = [{ category, confidence, original,
  *              replacement, oldNo, newNo }]. each match is a del→add pair with a category/
- *              confidence badge and a per-match keep/revert button.
+ *              confidence badge and a per-match keep/revert button. `category` is the engine's
+ *              (RedactionCategory: secrets, pii, paths, project) and shows as the engine's label;
+ *              an unknown category (a rule name, a display label) shows an alert and no match.
  *
  * @param {object} props
  * @param {string} props.file - the file path shown in the header (mono, not lowercased)
  * @param {Array<{header?:string, lines:Array<{type:'add'|'del'|'ctx', oldNo?:number|string, newNo?:number|string, text:string}>}>} [props.hunks] - structured hunks (default variant)
- * @param {Array<{category:string, confidence:number, original:string, replacement:string, oldNo?:number|string, newNo?:number|string}>} [props.matches] - redaction matches (redaction variant)
+ * @param {Array<{category:import('@peasant-labs/schema').RedactionCategory, confidence:number, original:string, replacement:string, oldNo?:number|string, newNo?:number|string}>} [props.matches] - redaction matches (redaction variant)
  * @param {'default'|'redaction'} [props.variant='default']
  * @param {string} [props.className]
  */
@@ -27,7 +29,7 @@ export default function DiffView({ file, hunks, matches, variant, className, ...
         }>;
     }>;
     matches?: Array<{
-        category: string;
+        category: import("@peasant-labs/schema").RedactionCategory;
         confidence: number;
         original: string;
         replacement: string;

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

@@ -4,15 +4,19 @@
  * @param {object} props
  * @param {PublishState} props.state
  * @param {number} [props.collectives] - how many collectives can read it (published, new-turns, publishing); left out of the words when omitted.
- * @param {number} [props.newTurns] - turns recorded since the last publish (new-turns).
+ * @param {number} [props.newTurns] - turns recorded since the last publish (new-turns); the label says "needs update".
  * @param {string} [props.collective] - the collective(s) the project's auto-publish rule targets (auto-publish).
+ * @param {'public'|'private'} [props.visibility] - published: who can find it beyond its collectives, as the host knows
+ *        it. "published, public" and "published, private" are said only from this; without it a transcript no
+ *        collective reads is just "published".
  * @param {string} [props.className]
  */
-export function PublishStateLabel({ state, collectives, newTurns, collective, className, ...rest }: {
+export function PublishStateLabel({ state, collectives, newTurns, collective, visibility, className, ...rest }: {
     state: PublishState;
     collectives?: number;
     newTurns?: number;
     collective?: string;
+    visibility?: "public" | "private";
     className?: string;
 }): import("react").JSX.Element;
 /**
@@ -25,16 +29,18 @@ export function PublishStateLabel({ state, collectives, newTurns, collective, cl
  * @param {number} [props.collectives]
  * @param {number} [props.newTurns]
  * @param {string} [props.collective]
+ * @param {'public'|'private'} [props.visibility]
  * @param {() => void} [props.onAction] - the one button. omit it and no button renders.
  * @param {string} [props.actionLabel] - replaces the state's default label.
  * @param {import('./Menu.jsx').MenuItem[]} [props.moreItems] - an optional overflow menu after the button.
  * @param {string} [props.className]
  */
-export function PublishBar({ state, collectives, newTurns, collective, onAction, actionLabel, moreItems, className, ...rest }: {
+export function PublishBar({ state, collectives, newTurns, collective, visibility, onAction, actionLabel, moreItems, className, ...rest }: {
     state: PublishState;
     collectives?: number;
     newTurns?: number;
     collective?: string;
+    visibility?: "public" | "private";
     onAction?: () => void;
     actionLabel?: string;
     moreItems?: import("./Menu.jsx").MenuItem[];
@@ -96,7 +102,7 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * checkbox, then the done state with the village link. The host drives `state`; the popup never
  * advances on its own.
  *
- * States: `connect` (this computer is not signed in to village), `waiting-github` (after continue
+ * States: `connect` (this computer is not signed in to peasant online), `waiting-github` (after continue
  * with github), `checking` (the redaction check is running), `scan-failed` (publish is off,
  * re-scan stays on), `no-collective` (signed in, in no collective), `ready`, `publishing`,
  * `stopped` (a named step failed; the host names any changes already applied), `done`, `waits-approval` (done, and
@@ -108,7 +114,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?: import('./Redaction.jsx').RedactionMatch[], matchCount?: number, total?: number, failure?: string, failureDetail?: string, failureAction?: { label: string, onSelect: () => void, busy?: boolean } }} [props.scan] - the host's scan result. `failure` is one plain line; `failureAction` is a button in the failure box (the one action that fixes it); `failureDetail`, the actionable detail (what, why, where, the fix), shows as pre-wrapped mono text behind a "details" disclosure in the failure box. `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, failureDetail?: string, failureAction?: { label: string, onSelect: () => void, busy?: boolean }, note?: { line: string, detail?: string } }} [props.scan] - the host's scan result. `note` is a quiet line under a finished scan's count (what the scanned copy leaves out, and why), with its detail behind a "details" disclosure; it is information, not an alert, and publishing stays on. `failure` is one plain line; `failureAction` is a button in the failure box (the one action that fixes it); `failureDetail`, the actionable detail (what, why, where, the fix), shows as pre-wrapped mono text behind a "details" disclosure in the failure box. `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]
@@ -125,13 +131,18 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * @param {string} [props.primaryLabel] - replaces the derived primary label.
  * @param {() => void} [props.onPublish]
  * @param {() => void} [props.onConnect] - `continue with github`.
- * @param {string} [props.joinHref] - `create or join one on village`.
+ * @param {string} [props.joinHref] - `create or join one on peasant online`.
  * @param {string} [props.stoppedAt] - the step that failed, in words ("setting who can read it").
+ * @param {string} [props.stoppedDetail] - stopped state: the host's actionable detail, pre-wrapped mono text behind a
+ *        "details" disclosure in the stopped box.
+ * @param {{ line: string, detail?: string, onRetry?: () => void, busy?: boolean }} [props.accessFailure] - the
+ *        collectives could not be read. "who can read it" shows the line, a retry for that read and the detail in
+ *        place of the access list and picker, and publishing stays off. The dialog's state stays the host's.
  * @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, checking, changes, access, onRemove, onRestore, picker, autoPublish, accessSummary, primaryLabel, onPublish, onConnect, joinHref, stoppedAt, onRecover, onRetry, done, }: {
+export function PublishDialog({ open, onClose, title, mode, state, scan, onRescan, checking, changes, access, onRemove, onRestore, picker, autoPublish, accessSummary, primaryLabel, onPublish, onConnect, joinHref, stoppedAt, stoppedDetail, accessFailure, onRecover, onRetry, done, }: {
     open: boolean;
     onClose: () => void;
     title: string;
@@ -148,6 +159,10 @@ export function PublishDialog({ open, onClose, title, mode, state, scan, onResca
             onSelect: () => void;
             busy?: boolean;
         };
+        note?: {
+            line: string;
+            detail?: string;
+        };
     };
     onRescan?: () => void;
     checking?: {
@@ -176,6 +191,13 @@ export function PublishDialog({ open, onClose, title, mode, state, scan, onResca
     onConnect?: () => void;
     joinHref?: string;
     stoppedAt?: string;
+    stoppedDetail?: string;
+    accessFailure?: {
+        line: string;
+        detail?: string;
+        onRetry?: () => void;
+        busy?: boolean;
+    };
     onRecover?: () => void;
     onRetry?: () => void;
     done?: {

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

@@ -11,11 +11,13 @@
  * @property {React.ComponentType<{size?: number}>} [stateIcon] override icon for the
  *           .sw-state marker; defaults to CircleCheck (on) / Circle (off).
  * @property {string} [id]              id for the control; links the label's `for`.
+ * @property {boolean} [stateMarker=true] show the on/off word beside the switch; off where the
+ *           host already says the state (a settings row).
  */
 /**
  * @param {SwitchProps} props
  */
-export default function Switch({ checked, defaultChecked, onChange, disabled, busy, label, onText, offText, stateIcon: StateIcon, id, }: SwitchProps): import("react").JSX.Element;
+export default function Switch({ checked, defaultChecked, onChange, disabled, busy, label, onText, offText, stateIcon: StateIcon, id, stateMarker, }: SwitchProps): import("react").JSX.Element;
 export type SwitchProps = {
     /**
      * controlled on/off state; pair with onChange.
@@ -60,4 +62,9 @@ export type SwitchProps = {
      * id for the control; links the label's `for`.
      */
     id?: string;
+    /**
+     * show the on/off word beside the switch; off where the
+     * host already says the state (a settings row).
+     */
+    stateMarker?: boolean;
 };

package/dist/lib/types/analytics/format.d.ts

@@ -1,5 +1,6 @@
 /**
- * Compact token count: 1234 → "1.2k", 62_000 → "62k", 1_234_567 → "1.23M".
+ * Compact token count, the library's one count format: 1234 → "1.2k", 62_000 → "62k",
+ * 1_234_567 → "1.2M", 66_731_500_000 → "66.7B". A negative count is not a count and reads "—".
  * @param {number | null | undefined} n
  * @returns {string}
  */

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

@@ -1,4 +1,35 @@
-/** Compact counts use one decimal place and lowercase magnitude suffixes. */
-export function formatCount(value: any): string;
-/** Calendar dates are stable across host locales; date-only inputs stay on their UTC day. */
-export function formatDate(value: any): string;
+/**
+ * Compact count, one decimal at most: 999 → "999", 1234 → "1.2k", 66_731_500_000 → "66.7B".
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatCount(value: unknown): string;
+/**
+ * Exact grouped integer: 272000 → "272,000". A bigint or a string of digits stays exact past the
+ * JS-safe range; any other value is rounded.
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatInteger(value: unknown): string;
+/**
+ * A cost in US dollars at cents: "$0.30", "$1,234.56", "$0.00" for zero, "<$0.01" for a positive
+ * amount under one cent. Accepts the recorded decimal string as it arrives.
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatCost(value: unknown): string;
+/**
+ * A decimal at fixed places: 0.99 → "0.99", 0.5 with 2 places → "0.50".
+ * @param {unknown} value
+ * @param {number} places
+ * @returns {string}
+ */
+export function formatDecimal(value: unknown, places: number): string;
+/**
+ * Calendar dates are stable across host locales; date-only inputs stay on their UTC day.
+ * @param {string | number | Date} value
+ * @returns {string}
+ */
+export function formatDate(value: string | number | Date): string;
+/** What every formatter shows for a missing or unreadable value. */
+export const MISSING_NUMBER: "\u2014";

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

@@ -55,6 +55,7 @@ export { default as Breadcrumb, Steps } from "./Breadcrumb.jsx";
 export { default as Tooltip, Popover } from "./Tooltip.jsx";
 export { Avatar, AvatarGroup, Kbd, KbdChord, Tag } from "./Avatar.jsx";
 export { default as BrandMark, resolveBrand } from "./BrandMark.jsx";
+export { formatCount, formatInteger, formatCost, formatDecimal, MISSING_NUMBER } from "./format.js";
 export { providerAccent, providerDisplayName } from "./provider-policy.js";
 export { Skeleton, Progress, Spinner, Toast, FeedbackPanel } from "./Feedback.jsx";
 export { DataTableToolbar, DataTablePaginationControls } from "./DataTableControls.jsx";