@peasant-labs/fairtrade 0.0.0

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

@@ -0,0 +1,70 @@
+/**
+ * @typedef {Object} ToastOpts
+ * @property {React.ReactNode} [title]    the title line; defaults to the tone label.
+ * @property {'ok'|'err'} [variant]       tone; defaults per method ('ok' for show()).
+ * @property {React.ComponentType} [icon] override the leading lucide glyph.
+ * @property {number} [duration]          per-toast auto-dismiss ms; 0/Infinity = sticky.
+ * @property {string} [closeLabel]        aria-label for the dismiss button.
+ * @property {string} [id]                supply to dedupe / target with update().
+ */
+/**
+ * ToastProvider — wraps a subtree and renders the fixed stacking host. children that
+ * call useToast() get a stable imperative api (memoised; identity never changes).
+ *
+ * @param {Object} props
+ * @param {React.ReactNode} props.children          the app subtree that may call useToast().
+ * @param {'bottom-right'|'bottom-left'|'top-right'|'top-left'|'bottom-center'|'top-center'} [props.placement='bottom-right']
+ *        which corner the fixed region pins to and the edge new toasts enter from.
+ * @param {number} [props.max=4]                    cap on simultaneously-visible toasts.
+ * @param {number} [props.duration=5000]            default auto-dismiss ms; 0/Infinity = sticky.
+ * @param {boolean} [props.inline=false]            pin the host absolutely inside a relative
+ *        container (for an in-frame doc/story example) instead of fixed to the viewport.
+ */
+export function ToastProvider({ children, placement, max, duration, inline, }: {
+    children: React.ReactNode;
+    placement?: "bottom-right" | "bottom-left" | "top-right" | "top-left" | "bottom-center" | "top-center";
+    max?: number;
+    duration?: number;
+    inline?: boolean;
+}): any;
+/**
+ * useToast — the imperative api object from the nearest ToastProvider. throws a clear
+ * lowercase error when called outside a provider so a missing host is caught in dev.
+ * @returns {{ ok: Function, err: Function, show: Function, dismiss: Function, dismissAll: Function, update: Function, promise: Function }}
+ */
+export function useToast(): {
+    ok: Function;
+    err: Function;
+    show: Function;
+    dismiss: Function;
+    dismissAll: Function;
+    update: Function;
+    promise: Function;
+};
+export default ToastProvider;
+export type ToastOpts = {
+    /**
+     * the title line; defaults to the tone label.
+     */
+    title?: React.ReactNode;
+    /**
+     * tone; defaults per method ('ok' for show()).
+     */
+    variant?: "ok" | "err";
+    /**
+     * override the leading lucide glyph.
+     */
+    icon?: React.ComponentType;
+    /**
+     * per-toast auto-dismiss ms; 0/Infinity = sticky.
+     */
+    duration?: number;
+    /**
+     * aria-label for the dismiss button.
+     */
+    closeLabel?: string;
+    /**
+     * supply to dedupe / target with update().
+     */
+    id?: string;
+};

package/dist/lib/types/ToastHost.stories.d.ts

@@ -0,0 +1,115 @@
+export default meta;
+export const Playground: {};
+export namespace Success {
+    function play({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+}
+export namespace Error {
+    export function play_1({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_1 as play };
+}
+export namespace Stacked {
+    export namespace args {
+        let duration: number;
+    }
+    export function play_2({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_2 as play };
+}
+export namespace MaxCap {
+    export namespace args_1 {
+        export let max: number;
+        let duration_1: number;
+        export { duration_1 as duration };
+    }
+    export { args_1 as args };
+    export function play_3({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_3 as play };
+}
+export namespace Sticky {
+    export namespace args_2 {
+        let duration_2: number;
+        export { duration_2 as duration };
+    }
+    export { args_2 as args };
+    export function play_4({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_4 as play };
+}
+export namespace Placements {
+    function render(): any;
+}
+export namespace ReducedMotion {
+    namespace parameters {
+        namespace docs {
+            namespace description {
+                let story: string;
+            }
+        }
+    }
+}
+export namespace PausesOnHover {
+    export namespace args_3 {
+        let duration_3: number;
+        export { duration_3 as duration };
+    }
+    export { args_3 as args };
+    export function play_5({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_5 as play };
+}
+declare namespace meta {
+    export let title: string;
+    export { ToastProvider as component };
+    export let tags: string[];
+    export let decorators: Function[];
+    export namespace argTypes {
+        export namespace placement {
+            let control: string;
+            let options: string[];
+        }
+        export namespace max_1 {
+            export namespace control_1 {
+                export let type: string;
+                export let min: number;
+                let max_2: number;
+                export { max_2 as max };
+            }
+            export { control_1 as control };
+        }
+        export { max_1 as max };
+        export namespace duration_4 {
+            export namespace control_2 {
+                let type_1: string;
+                export { type_1 as type };
+                let min_1: number;
+                export { min_1 as min };
+                let max_3: number;
+                export { max_3 as max };
+                export let step: number;
+            }
+            export { control_2 as control };
+        }
+        export { duration_4 as duration };
+    }
+    export namespace args_4 {
+        let placement_1: string;
+        export { placement_1 as placement };
+        let max_4: number;
+        export { max_4 as max };
+        let duration_5: number;
+        export { duration_5 as duration };
+    }
+    export { args_4 as args };
+    export function render_1(args: any): any;
+    export { render_1 as render };
+}
+import ToastProvider from './ToastHost.jsx';

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

@@ -0,0 +1,24 @@
+/**
+ * ToolCall — one collapsible tool-call row that dispatches on `tool.kind` to its body.
+ *
+ * Collapsed, the row is a real <button> (carries aria-expanded / aria-controls): a tool icon,
+ * the tool name, a one-line arg preview, the duration, and a status word (icon + "ok"/"error",
+ * never color alone). Activating it toggles real open/closed state and reveals the
+ * kind-specific body. An unknown kind keeps the generic wrench icon + the DefaultBody.
+ *
+ * @param {object} props
+ * @param {{kind:string, name:string, args?:object, duration?:number, status?:'ok'|'error'}} props.tool
+ * @param {boolean} [props.defaultOpen=false]  initial open state.
+ * @param {string} [props.className]
+ */
+export default function ToolCall({ tool, defaultOpen, className, ...rest }: {
+    tool: {
+        kind: string;
+        name: string;
+        args?: object;
+        duration?: number;
+        status?: "ok" | "error";
+    };
+    defaultOpen?: boolean;
+    className?: string;
+}): any;

package/dist/lib/types/ToolRenderers.stories.d.ts

@@ -0,0 +1,138 @@
+export default meta;
+export namespace AllTools {
+    function render(): any;
+    function play({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+}
+export namespace Expanded {
+    export function render_1(): any;
+    export { render_1 as render };
+    export function play_1({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_1 as play };
+}
+export namespace BashError {
+    export namespace args {
+        let defaultOpen: boolean;
+        namespace tool {
+            export let kind: string;
+            export let name: string;
+            export let duration: number;
+            export let status: string;
+            export namespace args_1 {
+                let command: string;
+                let output: string;
+                let exitCode: number;
+            }
+            export { args_1 as args };
+        }
+    }
+    export function play_2({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_2 as play };
+}
+export namespace Read {
+    export namespace args_2 {
+        export { readCall as tool };
+        let defaultOpen_1: boolean;
+        export { defaultOpen_1 as defaultOpen };
+    }
+    export { args_2 as args };
+}
+export namespace Edit {
+    export namespace args_3 {
+        export { editCall as tool };
+        let defaultOpen_2: boolean;
+        export { defaultOpen_2 as defaultOpen };
+    }
+    export { args_3 as args };
+}
+export namespace Default {
+    export namespace args_4 {
+        export { defaultCall as tool };
+        let defaultOpen_3: boolean;
+        export { defaultOpen_3 as defaultOpen };
+    }
+    export { args_4 as args };
+}
+export namespace LightTheme {
+    import render_2 = AllTools.render;
+    export { render_2 as render };
+    export namespace globals {
+        let theme: string;
+        namespace backgrounds {
+            let value: string;
+        }
+    }
+}
+declare namespace meta {
+    export let title: string;
+    export { ToolCall as component };
+    export let tags: string[];
+    export let decorators: Function[];
+    export namespace argTypes {
+        export namespace tool_1 {
+            let control: boolean;
+        }
+        export { tool_1 as tool };
+        export namespace defaultOpen_4 {
+            let control_1: string;
+            export { control_1 as control };
+        }
+        export { defaultOpen_4 as defaultOpen };
+    }
+}
+declare namespace readCall {
+    let kind_1: string;
+    export { kind_1 as kind };
+    let name_1: string;
+    export { name_1 as name };
+    let duration_1: number;
+    export { duration_1 as duration };
+    let status_1: string;
+    export { status_1 as status };
+    export namespace args_5 {
+        let file: string;
+        let excerpt: string;
+    }
+    export { args_5 as args };
+}
+declare namespace editCall {
+    let kind_2: string;
+    export { kind_2 as kind };
+    let name_2: string;
+    export { name_2 as name };
+    let duration_2: number;
+    export { duration_2 as duration };
+    let status_2: string;
+    export { status_2 as status };
+    export namespace args_6 {
+        let file_1: string;
+        export { file_1 as file };
+        export let old: string;
+        let _new: string;
+        export { _new as new };
+    }
+    export { args_6 as args };
+}
+declare namespace defaultCall {
+    let kind_3: string;
+    export { kind_3 as kind };
+    let name_3: string;
+    export { name_3 as name };
+    let duration_3: number;
+    export { duration_3 as duration };
+    let status_3: string;
+    export { status_3 as status };
+    export namespace args_7 {
+        let todos: {
+            content: string;
+            status: string;
+        }[];
+    }
+    export { args_7 as args };
+}
+import ToolCall from './ToolRenderers.jsx';

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

@@ -0,0 +1,80 @@
+/**
+ * @typedef {Object} TooltipProps
+ * @property {React.ReactNode} content    short, single-line helper text shown in the .tip-bubble (role=tooltip).
+ * @property {React.ReactElement} children   the trigger: a single focusable, already-named element (e.g. a button or link). it receives aria-describedby pointing at the bubble.
+ * @property {string} [id]                id for the bubble, linked from the trigger via aria-describedby. auto-generated if omitted.
+ */
+export default function Tooltip({ content, children, id }: {
+    content: any;
+    children: any;
+    id: any;
+}): any;
+/**
+ * @typedef {Object} PopoverProps
+ * @property {React.ReactNode} children   the trigger button content (e.g. an icon + label).
+ * @property {string} label               accessible name for the floating dialog (aria-label on .pop-card).
+ * @property {React.ReactNode} [title]    .pop-title text shown in the .pop-head; defaults to `label`.
+ * @property {import('react').ComponentType} [icon]  lucide icon component for the .pop-head; decorative, sized by css (.pop-head .lucide -> --ic-sm).
+ * @property {React.ReactNode} content    the .pop-body content.
+ * @property {React.ReactNode} [footer]   the .pop-foot content (e.g. cancel / confirm buttons).
+ * @property {string} [triggerClassName]  classes for the trigger button. defaults to "btn btn-secondary btn-sm".
+ * @property {string} [id]                id for the .pop-card, linked from the trigger via aria-controls. auto-generated if omitted.
+ */
+export function Popover({ children, label, title, icon: Icon, content, footer, triggerClassName, id, }: {
+    children: any;
+    label: any;
+    title: any;
+    icon: any;
+    content: any;
+    footer: any;
+    triggerClassName?: string;
+    id: any;
+}): any;
+export type TooltipProps = {
+    /**
+     * short, single-line helper text shown in the .tip-bubble (role=tooltip).
+     */
+    content: React.ReactNode;
+    /**
+     * the trigger: a single focusable, already-named element (e.g. a button or link). it receives aria-describedby pointing at the bubble.
+     */
+    children: React.ReactElement;
+    /**
+     * id for the bubble, linked from the trigger via aria-describedby. auto-generated if omitted.
+     */
+    id?: string;
+};
+export type PopoverProps = {
+    /**
+     * the trigger button content (e.g. an icon + label).
+     */
+    children: React.ReactNode;
+    /**
+     * accessible name for the floating dialog (aria-label on .pop-card).
+     */
+    label: string;
+    /**
+     * .pop-title text shown in the .pop-head; defaults to `label`.
+     */
+    title?: React.ReactNode;
+    /**
+     * lucide icon component for the .pop-head; decorative, sized by css (.pop-head .lucide -> --ic-sm).
+     */
+    icon?: any;
+    /**
+     * the .pop-body content.
+     */
+    content: React.ReactNode;
+    /**
+     * the .pop-foot content (e.g. cancel / confirm buttons).
+     */
+    footer?: React.ReactNode;
+    /**
+     * classes for the trigger button. defaults to "btn btn-secondary btn-sm".
+     */
+    triggerClassName?: string;
+    /**
+     * id for the .pop-card, linked from the trigger via aria-controls. auto-generated if omitted.
+     */
+    id?: string;
+};

package/dist/lib/types/Tooltip.stories.d.ts

@@ -0,0 +1,116 @@
+export default meta;
+export namespace Playground {
+    export { headroom as decorators };
+    export { hoverOpen as play };
+}
+export namespace OnButton {
+    export namespace args {
+        let content: string;
+        let children: any;
+    }
+    export { headroom as decorators };
+    export { hoverOpen as play };
+}
+export namespace OnIconButton {
+    export namespace args_1 {
+        let content_1: string;
+        export { content_1 as content };
+        let children_1: any;
+        export { children_1 as children };
+    }
+    export { args_1 as args };
+    export { headroom as decorators };
+    export { hoverOpen as play };
+}
+export namespace LongContent {
+    export namespace args_2 {
+        let content_2: string;
+        export { content_2 as content };
+        let children_2: any;
+        export { children_2 as children };
+    }
+    export { args_2 as args };
+    export { headroom as decorators };
+    export { hoverOpen as play };
+}
+export namespace FocusReveals {
+    export namespace args_3 {
+        let content_3: string;
+        export { content_3 as content };
+        let children_3: any;
+        export { children_3 as children };
+    }
+    export { args_3 as args };
+    export { headroom as decorators };
+    export function play({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+}
+export namespace OnLink {
+    export namespace args_4 {
+        let content_4: string;
+        export { content_4 as content };
+        let children_4: any;
+        export { children_4 as children };
+    }
+    export { args_4 as args };
+    export { headroom as decorators };
+    export function play_1({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_1 as play };
+}
+export namespace PopoverBasic {
+    export { headroom as decorators };
+    export function render(): any;
+    export function play_2({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_2 as play };
+}
+export namespace PopoverOpen {
+    export { headroom as decorators };
+    export function render_1(): any;
+    export { render_1 as render };
+    export function play_3({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_3 as play };
+}
+export namespace PopoverWithState {
+    export { headroom as decorators };
+    export function render_2(): any;
+    export { render_2 as render };
+    export function play_4({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+    export { play_4 as play };
+}
+declare namespace meta {
+    export let title: string;
+    export { Tooltip as component };
+    export let tags: string[];
+    export let decorators: Function[];
+    export namespace argTypes {
+        export namespace content_5 {
+            let control: string;
+        }
+        export { content_5 as content };
+        export namespace id {
+            let control_1: string;
+            export { control_1 as control };
+        }
+    }
+    export namespace args_5 {
+        let content_6: string;
+        export { content_6 as content };
+        let children_5: any;
+        export { children_5 as children };
+    }
+    export { args_5 as args };
+}
+declare const headroom: ((Story: any) => any)[];
+declare function hoverOpen({ canvasElement }: {
+    canvasElement: any;
+}): Promise<void>;
+import Tooltip from './Tooltip.jsx';

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

@@ -0,0 +1,37 @@
+/**
+ * Tour — a portal-rendered spotlight coachmark over real page anchors.
+ *
+ * controlled by `open`; `onClose` fires on esc / skip / scrim-intent, and
+ * `onFinish` fires when "done" is pressed on the last step. internal step index
+ * is owned here and re-armed to 0 each time the tour (re)opens.
+ *
+ * @param {Object} props
+ * @param {TourStep[]} props.steps          ordered steps; each spotlights one anchor
+ * @param {boolean} props.open              whether the tour is mounted / visible
+ * @param {() => void} [props.onClose]      called on esc / skip / scrim (tour dismissed)
+ * @param {() => void} [props.onFinish]     called when "done" is pressed on the last step
+ * @param {(index: number) => void} [props.onStepChange]  notified when the active step changes
+ * @param {string} [props.labelId='tour-title']  id wiring aria-labelledby on the coachmark
+ */
+export default function Tour({ steps, open, onClose, onFinish, onStepChange, labelId, }: {
+    steps: TourStep[];
+    open: boolean;
+    onClose?: () => void;
+    onFinish?: () => void;
+    onStepChange?: (index: number) => void;
+    labelId?: string;
+}): any;
+export type TourStep = {
+    /**
+     * id (or data-tour value) of the element to spotlight
+     */
+    anchorId: string;
+    /**
+     * the coachmark title (display type)
+     */
+    title: React.ReactNode;
+    /**
+     * the coachmark prose body (reading type)
+     */
+    body: React.ReactNode;
+};

package/dist/lib/types/Tour.stories.d.ts

@@ -0,0 +1,39 @@
+export default meta;
+export namespace Default {
+    let name: string;
+    function render(): any;
+    function play({ canvasElement, step }: {
+        canvasElement: any;
+        step: any;
+    }): Promise<void>;
+}
+export namespace ReachesDone {
+    let name_1: string;
+    export { name_1 as name };
+    export function render_1(): any;
+    export { render_1 as render };
+    export function play_1({ canvasElement, step }: {
+        canvasElement: any;
+        step: any;
+    }): Promise<void>;
+    export { play_1 as play };
+}
+export namespace SkipWithEsc {
+    let name_2: string;
+    export { name_2 as name };
+    export function render_2(): any;
+    export { render_2 as render };
+    export function play_2({ canvasElement, step }: {
+        canvasElement: any;
+        step: any;
+    }): Promise<void>;
+    export { play_2 as play };
+}
+declare namespace meta {
+    export let title: string;
+    export { Tour as component };
+    export namespace parameters {
+        let layout: string;
+    }
+}
+import Tour from './Tour.jsx';

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

@@ -0,0 +1,50 @@
+export function PhaseDivider({ label, range, active, stickyTop, onClick, className, ...rest }: {
+    [x: string]: any;
+    label: any;
+    range: any;
+    active?: boolean;
+    stickyTop?: string;
+    onClick: any;
+    className?: string;
+}): any;
+export function Phase({ label, range, active, stickyTop, onLabelClick, children, className, ...rest }: {
+    [x: string]: any;
+    label: any;
+    range: any;
+    active?: boolean;
+    stickyTop?: string;
+    onLabelClick: any;
+    children: any;
+    className?: string;
+}): any;
+export function TaskBoundary({ turn, duration, tools, files, ins, del, className, ...rest }: {
+    [x: string]: any;
+    turn: any;
+    duration: any;
+    tools: any;
+    files: any;
+    ins?: number;
+    del?: number;
+    className?: string;
+}): any;
+export function CheckpointMarker({ hash, message, time, files, ins, del, className, ...rest }: {
+    [x: string]: any;
+    hash: any;
+    message: any;
+    time: any;
+    files: any;
+    ins?: number;
+    del?: number;
+    className?: string;
+}): any;
+export function TurnContextBar({ prompt, ordinal, onNext, nextLabel, stickyTop, onJump, className, ...rest }: {
+    [x: string]: any;
+    prompt: any;
+    ordinal: any;
+    onNext: any;
+    nextLabel?: string;
+    stickyTop?: string;
+    onJump: any;
+    className?: string;
+}): any;
+export default TaskBoundary;