@peasant-labs/fairtrade 0.0.0

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

@@ -0,0 +1,47 @@
+/**
+ * the simple prev/next pager (the .pager specimen). a label naming the current page,
+ * flanked by previous/next icon buttons. reuses .pager + .btn.btn-secondary.btn-sm.btn-icon
+ * with no new css. for numbered pagination use a separate component.
+ *
+ * @typedef {Object} PagerProps
+ * @property {number} page - the current (1-based) page number. default 1.
+ * @property {number} total - the total number of pages. default 1.
+ * @property {() => void} [onPrev] - called when the previous button is clicked.
+ * @property {() => void} [onNext] - called when the next button is clicked.
+ * @property {(nextPage: number) => void} [onChange] - called with the new page number on either button (fallback when onPrev/onNext are not given).
+ * @property {string} [label] - aria-label for the whole pager nav. default 'pagination'.
+ *
+ * @param {PagerProps} props
+ */
+export default function Pager({ page, total, onPrev, onNext, onChange, label }: PagerProps): any;
+/**
+ * the simple prev/next pager (the .pager specimen). a label naming the current page,
+ * flanked by previous/next icon buttons. reuses .pager + .btn.btn-secondary.btn-sm.btn-icon
+ * with no new css. for numbered pagination use a separate component.
+ */
+export type PagerProps = {
+    /**
+     * - the current (1-based) page number. default 1.
+     */
+    page: number;
+    /**
+     * - the total number of pages. default 1.
+     */
+    total: number;
+    /**
+     * - called when the previous button is clicked.
+     */
+    onPrev?: () => void;
+    /**
+     * - called when the next button is clicked.
+     */
+    onNext?: () => void;
+    /**
+     * - called with the new page number on either button (fallback when onPrev/onNext are not given).
+     */
+    onChange?: (nextPage: number) => void;
+    /**
+     * - aria-label for the whole pager nav. default 'pagination'.
+     */
+    label?: string;
+};

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

@@ -0,0 +1,100 @@
+export default meta;
+export const Playground: {};
+export namespace Middle {
+    namespace args {
+        let page: number;
+        let total: number;
+        let label: string;
+    }
+}
+export namespace AtStart {
+    export namespace args_1 {
+        let page_1: number;
+        export { page_1 as page };
+        let total_1: number;
+        export { total_1 as total };
+        let label_1: string;
+        export { label_1 as label };
+    }
+    export { args_1 as args };
+}
+export namespace AtEnd {
+    export namespace args_2 {
+        let page_2: number;
+        export { page_2 as page };
+        let total_2: number;
+        export { total_2 as total };
+        let label_2: string;
+        export { label_2 as label };
+    }
+    export { args_2 as args };
+}
+export namespace SinglePage {
+    export namespace args_3 {
+        let page_3: number;
+        export { page_3 as page };
+        let total_3: number;
+        export { total_3 as total };
+        let label_3: string;
+        export { label_3 as label };
+    }
+    export { args_3 as args };
+}
+export namespace Interactive {
+    function render(): any;
+}
+export namespace PrevNextPrecedence {
+    export function render_1(): any;
+    export { render_1 as render };
+}
+declare namespace meta {
+    export let title: string;
+    export { Pager as component };
+    export let tags: string[];
+    export namespace argTypes {
+        export namespace page_4 {
+            namespace control {
+                let type: string;
+                let min: number;
+            }
+        }
+        export { page_4 as page };
+        export namespace total_4 {
+            export namespace control_1 {
+                let type_1: string;
+                export { type_1 as type };
+                let min_1: number;
+                export { min_1 as min };
+            }
+            export { control_1 as control };
+        }
+        export { total_4 as total };
+        export namespace label_4 {
+            let control_2: string;
+            export { control_2 as control };
+        }
+        export { label_4 as label };
+        export namespace onPrev {
+            let action: string;
+        }
+        export namespace onNext {
+            let action_1: string;
+            export { action_1 as action };
+        }
+        export namespace onChange {
+            let action_2: string;
+            export { action_2 as action };
+        }
+    }
+    export namespace args_4 {
+        let page_5: number;
+        export { page_5 as page };
+        let total_5: number;
+        export { total_5 as total };
+        let label_5: string;
+        export { label_5 as label };
+    }
+    export { args_4 as args };
+    export let decorators: ((Story: any) => any)[];
+}
+import Pager from './Pager.jsx';

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

@@ -0,0 +1,50 @@
+/**
+ * @typedef {Object} PaginationProps
+ * @property {number} [page]            controlled current page (1-based); pair with onChange.
+ * @property {number} [defaultPage=1]   initial page when uncontrolled.
+ * @property {number} [total]           total number of pages. if omitted it is derived from
+ *                                      totalItems / pageSize.
+ * @property {number} [totalItems]      total item count, used with pageSize to derive `total`.
+ * @property {number} [pageSize=10]     items per page, used with totalItems to derive `total`.
+ * @property {(nextPage: number) => void} [onChange] called with the new 1-based page on any change.
+ * @property {number} [siblingCount=1]  page buttons shown on each side of the current page.
+ * @property {string} [label='pagination'] aria-label for the <nav>.
+ *
+ * @param {PaginationProps} props
+ */
+export default function Pagination({ page, defaultPage, total, totalItems, pageSize, onChange, siblingCount, label, }: PaginationProps): any;
+export type PaginationProps = {
+    /**
+     * controlled current page (1-based); pair with onChange.
+     */
+    page?: number;
+    /**
+     * initial page when uncontrolled.
+     */
+    defaultPage?: number;
+    /**
+     * total number of pages. if omitted it is derived from
+     *            totalItems / pageSize.
+     */
+    total?: number;
+    /**
+     * total item count, used with pageSize to derive `total`.
+     */
+    totalItems?: number;
+    /**
+     * items per page, used with totalItems to derive `total`.
+     */
+    pageSize?: number;
+    /**
+     * called with the new 1-based page on any change.
+     */
+    onChange?: (nextPage: number) => void;
+    /**
+     * page buttons shown on each side of the current page.
+     */
+    siblingCount?: number;
+    /**
+     * aria-label for the <nav>.
+     */
+    label?: string;
+};

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

@@ -0,0 +1,193 @@
+export default meta;
+export const Playground: {};
+export namespace ShortRange {
+    namespace args {
+        let total: number;
+        let defaultPage: number;
+        let label: string;
+    }
+}
+export namespace LongRange {
+    export namespace args_1 {
+        let total_1: number;
+        export { total_1 as total };
+        let defaultPage_1: number;
+        export { defaultPage_1 as defaultPage };
+        let label_1: string;
+        export { label_1 as label };
+    }
+    export { args_1 as args };
+}
+export namespace FromItems {
+    export namespace args_2 {
+        let total_2: any;
+        export { total_2 as total };
+        export let totalItems: number;
+        export let pageSize: number;
+        let defaultPage_2: number;
+        export { defaultPage_2 as defaultPage };
+        let label_2: string;
+        export { label_2 as label };
+    }
+    export { args_2 as args };
+}
+export namespace AtFirstPage {
+    export namespace args_3 {
+        let total_3: number;
+        export { total_3 as total };
+        let defaultPage_3: number;
+        export { defaultPage_3 as defaultPage };
+        let label_3: string;
+        export { label_3 as label };
+    }
+    export { args_3 as args };
+}
+export namespace AtLastPage {
+    export namespace args_4 {
+        let total_4: number;
+        export { total_4 as total };
+        let defaultPage_4: number;
+        export { defaultPage_4 as defaultPage };
+        let label_4: string;
+        export { label_4 as label };
+    }
+    export { args_4 as args };
+}
+export namespace WideWindow {
+    export namespace args_5 {
+        let total_5: number;
+        export { total_5 as total };
+        let defaultPage_5: number;
+        export { defaultPage_5 as defaultPage };
+        export let siblingCount: number;
+        let label_5: string;
+        export { label_5 as label };
+    }
+    export { args_5 as args };
+}
+export namespace Collapsed {
+    export namespace args_6 {
+        let total_6: number;
+        export { total_6 as total };
+        let defaultPage_6: number;
+        export { defaultPage_6 as defaultPage };
+        let label_6: string;
+        export { label_6 as label };
+    }
+    export { args_6 as args };
+    export namespace parameters {
+        namespace viewport {
+            let defaultViewport: string;
+        }
+    }
+}
+export namespace Controlled {
+    export namespace args_7 {
+        let total_7: number;
+        export { total_7 as total };
+        let siblingCount_1: number;
+        export { siblingCount_1 as siblingCount };
+        let label_7: string;
+        export { label_7 as label };
+    }
+    export { args_7 as args };
+    export function render(args: any): any;
+    export function play({ canvasElement, args }: {
+        canvasElement: any;
+        args: any;
+    }): Promise<void>;
+}
+export namespace ControlledFrozen {
+    export namespace args_8 {
+        let total_8: number;
+        export { total_8 as total };
+        let siblingCount_2: number;
+        export { siblingCount_2 as siblingCount };
+        export let page: number;
+        let label_8: string;
+        export { label_8 as label };
+    }
+    export { args_8 as args };
+    export function play_1({ canvasElement, args }: {
+        canvasElement: any;
+        args: any;
+    }): Promise<void>;
+    export { play_1 as play };
+}
+export namespace ClickPage {
+    export namespace args_9 {
+        let total_9: number;
+        export { total_9 as total };
+        let defaultPage_7: number;
+        export { defaultPage_7 as defaultPage };
+        let siblingCount_3: number;
+        export { siblingCount_3 as siblingCount };
+        let label_9: string;
+        export { label_9 as label };
+    }
+    export { args_9 as args };
+    export function play_2({ canvasElement, args }: {
+        canvasElement: any;
+        args: any;
+    }): Promise<void>;
+    export { play_2 as play };
+}
+declare namespace meta {
+    export let title: string;
+    export { Pagination as component };
+    export let tags: string[];
+    export namespace argTypes {
+        export namespace page_1 {
+            let control: string;
+        }
+        export { page_1 as page };
+        export namespace defaultPage_8 {
+            let control_1: string;
+            export { control_1 as control };
+        }
+        export { defaultPage_8 as defaultPage };
+        export namespace total_10 {
+            let control_2: string;
+            export { control_2 as control };
+        }
+        export { total_10 as total };
+        export namespace totalItems_1 {
+            let control_3: string;
+            export { control_3 as control };
+        }
+        export { totalItems_1 as totalItems };
+        export namespace pageSize_1 {
+            let control_4: string;
+            export { control_4 as control };
+        }
+        export { pageSize_1 as pageSize };
+        export namespace siblingCount_4 {
+            let control_5: string;
+            export { control_5 as control };
+            export let options: number[];
+        }
+        export { siblingCount_4 as siblingCount };
+        export namespace label_10 {
+            let control_6: string;
+            export { control_6 as control };
+        }
+        export { label_10 as label };
+        export namespace onChange {
+            let action: string;
+        }
+    }
+    export namespace args_10 {
+        let total_11: number;
+        export { total_11 as total };
+        let defaultPage_9: number;
+        export { defaultPage_9 as defaultPage };
+        let siblingCount_5: number;
+        export { siblingCount_5 as siblingCount };
+        let label_11: string;
+        export { label_11 as label };
+        let onChange_1: import("storybook/test").Mock<(...args: any[]) => any>;
+        export { onChange_1 as onChange };
+    }
+    export { args_10 as args };
+}
+import Pagination from './Pagination.jsx';

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

@@ -0,0 +1,80 @@
+/**
+ * @typedef {Object} PolicyOption
+ * @property {string} value                 the value submitted / matched when selected.
+ * @property {import('react').ReactNode} label     the bold option label (mono).
+ * @property {import('react').ReactNode} [rationale] one-line plain-prose explanation (body font).
+ * @property {boolean} [disabled]           native disabled state for this option.
+ */
+/**
+ * @typedef {Object} PolicySelectProps
+ * @property {import('react').ReactNode} label   the field label above the control (mono, lowercase chrome).
+ * @property {string} name                       form name; the shared radio group name in the radio variant.
+ * @property {string} [value]                    controlled selected value; pair with onChange.
+ * @property {string} [defaultValue]             initial value for uncontrolled use.
+ * @property {(value: string) => void} [onChange] called with the next value on selection.
+ * @property {PolicyOption[]} options            the choices to render (each {value,label,rationale}).
+ * @property {'radio'|'select'} [variant='radio'] layout: a rationale-per-row radio group, or a native select.
+ * @property {import('react').ReactNode} [hint]  optional one-line helper beneath the label.
+ * @property {string} [id]                       id for the control / radiogroup; auto-generated when omitted.
+ */
+/**
+ * A governance policy selector. See PolicySelectProps.
+ * @param {PolicySelectProps} props
+ */
+export default function PolicySelect({ label, name, value, defaultValue, onChange, options, variant, hint, id, }: PolicySelectProps): any;
+export type PolicyOption = {
+    /**
+     * the value submitted / matched when selected.
+     */
+    value: string;
+    /**
+     * the bold option label (mono).
+     */
+    label: any;
+    /**
+     * one-line plain-prose explanation (body font).
+     */
+    rationale?: any;
+    /**
+     * native disabled state for this option.
+     */
+    disabled?: boolean;
+};
+export type PolicySelectProps = {
+    /**
+     * the field label above the control (mono, lowercase chrome).
+     */
+    label: any;
+    /**
+     * form name; the shared radio group name in the radio variant.
+     */
+    name: string;
+    /**
+     * controlled selected value; pair with onChange.
+     */
+    value?: string;
+    /**
+     * initial value for uncontrolled use.
+     */
+    defaultValue?: string;
+    /**
+     * called with the next value on selection.
+     */
+    onChange?: (value: string) => void;
+    /**
+     * the choices to render (each {value,label,rationale}).
+     */
+    options: PolicyOption[];
+    /**
+     * layout: a rationale-per-row radio group, or a native select.
+     */
+    variant?: "radio" | "select";
+    /**
+     * optional one-line helper beneath the label.
+     */
+    hint?: any;
+    /**
+     * id for the control / radiogroup; auto-generated when omitted.
+     */
+    id?: string;
+};

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

@@ -0,0 +1,130 @@
+export default meta;
+export namespace DataAccess {
+    namespace args {
+        export let label: string;
+        export let name: string;
+        export let variant: string;
+        export { DATA_ACCESS as options };
+        export let defaultValue: string;
+    }
+}
+export namespace Acceptance {
+    export namespace args_1 {
+        let label_1: string;
+        export { label_1 as label };
+        let name_1: string;
+        export { name_1 as name };
+        let variant_1: string;
+        export { variant_1 as variant };
+        export { ACCEPTANCE as options };
+        let defaultValue_1: string;
+        export { defaultValue_1 as defaultValue };
+    }
+    export { args_1 as args };
+}
+export namespace Retention {
+    export namespace args_2 {
+        let label_2: string;
+        export { label_2 as label };
+        let name_2: string;
+        export { name_2 as name };
+        let variant_2: string;
+        export { variant_2 as variant };
+        export let hint: string;
+        export { RETENTION as options };
+        let defaultValue_2: string;
+        export { defaultValue_2 as defaultValue };
+    }
+    export { args_2 as args };
+}
+export namespace Select {
+    export namespace args_3 {
+        let label_3: string;
+        export { label_3 as label };
+        let name_3: string;
+        export { name_3 as name };
+        let variant_3: string;
+        export { variant_3 as variant };
+        export { DATA_ACCESS as options };
+        let defaultValue_3: string;
+        export { defaultValue_3 as defaultValue };
+    }
+    export { args_3 as args };
+}
+export namespace WithDisabledOption {
+    export namespace args_4 {
+        let label_4: string;
+        export { label_4 as label };
+        let name_4: string;
+        export { name_4 as name };
+        let variant_4: string;
+        export { variant_4 as variant };
+        export let options: {
+            value: string;
+            label: string;
+            rationale: string;
+        }[];
+        let defaultValue_4: string;
+        export { defaultValue_4 as defaultValue };
+    }
+    export { args_4 as args };
+}
+export namespace Selects {
+    export namespace args_5 {
+        let label_5: string;
+        export { label_5 as label };
+        let name_5: string;
+        export { name_5 as name };
+        let variant_5: string;
+        export { variant_5 as variant };
+        export { DATA_ACCESS as options };
+    }
+    export { args_5 as args };
+    export function render(args: any): any;
+    export function play({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+}
+declare namespace meta {
+    export let title: string;
+    export { PolicySelect as component };
+    export let tags: string[];
+    export let decorators: Function[];
+    export namespace argTypes {
+        export namespace variant_6 {
+            export let control: string;
+            let options_1: string[];
+            export { options_1 as options };
+        }
+        export { variant_6 as variant };
+        export namespace label_6 {
+            let control_1: string;
+            export { control_1 as control };
+        }
+        export { label_6 as label };
+        export namespace hint_1 {
+            let control_2: string;
+            export { control_2 as control };
+        }
+        export { hint_1 as hint };
+        export namespace onChange {
+            let action: string;
+        }
+    }
+}
+declare const DATA_ACCESS: {
+    value: string;
+    label: string;
+    rationale: string;
+}[];
+declare const ACCEPTANCE: {
+    value: string;
+    label: string;
+    rationale: string;
+}[];
+declare const RETENTION: {
+    value: string;
+    label: string;
+    rationale: string;
+}[];
+import PolicySelect from './PolicySelect.jsx';

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

@@ -0,0 +1,83 @@
+/**
+ * ProviderIcon — the real brand mark for a harness, single-color via currentColor.
+ *
+ * decorative by default (it is paired with a name in every composite below). pass
+ * `label` to make a STANDALONE mark informative (role="img" + the provider name).
+ * pass `accent` to tint the mark with its provider accent instead of inheriting
+ * the surrounding text color — but remember the accent is never the sole signal.
+ *
+ * @param {object} props
+ * @param {'claude-code'|'gemini-cli'|'codex'|'opencode'|'cursor'} props.harness
+ * @param {number} [props.size] explicit px; omit to inherit the contextual icon size.
+ * @param {boolean} [props.accent] tint with PROVIDER_ACCENT[harness] (default: currentColor).
+ * @param {boolean|string} [props.label] true → the provider name as aria-label; a string overrides.
+ * @param {string} [props.className] extra classes appended after `pv-icon`.
+ * @returns {JSX.Element|null} null when `harness` is unknown.
+ */
+export function ProviderIcon({ harness, size, accent, label, className, ...rest }: {
+    harness: "claude-code" | "gemini-cli" | "codex" | "opencode" | "cursor";
+    size?: number;
+    accent?: boolean;
+    label?: boolean | string;
+    className?: string;
+}): JSX.Element | null;
+/**
+ * ProviderTag — a square hairline chip: the real mark + the lowercase harness slug.
+ *
+ * the system's chip look (mono, hairline border, radius 0, lowercase chrome). the
+ * mark sits to the left of the slug so the chip is never color-only: even fully
+ * monochrome it names the provider in words. pass `accent` to tint the mark.
+ *
+ * @param {object} props
+ * @param {'claude-code'|'gemini-cli'|'codex'|'opencode'|'cursor'} props.harness
+ * @param {boolean} [props.accent] tint the mark with the provider accent (default: ink).
+ * @param {string} [props.className]
+ * @returns {JSX.Element|null}
+ */
+export function ProviderTag({ harness, accent, className, ...rest }: {
+    harness: "claude-code" | "gemini-cli" | "codex" | "opencode" | "cursor";
+    accent?: boolean;
+    className?: string;
+}): JSX.Element | null;
+/**
+ * ProviderName — mark + the harness slug as a plain inline label (no chip border).
+ *
+ * the in-prose form: use it inline in a sentence or a table cell. pass `accent` to
+ * tint BOTH the mark and the slug with the provider accent (the slug gets a
+ * non-color cue regardless — it is real text, so it is readable mono-color too).
+ *
+ * @param {object} props
+ * @param {'claude-code'|'gemini-cli'|'codex'|'opencode'|'cursor'} props.harness
+ * @param {boolean} [props.accent] tint mark + label with the provider accent.
+ * @param {string} [props.className]
+ * @returns {JSX.Element|null}
+ */
+export function ProviderName({ harness, accent, className, ...rest }: {
+    harness: "claude-code" | "gemini-cli" | "codex" | "opencode" | "cursor";
+    accent?: boolean;
+    className?: string;
+}): JSX.Element | null;
+/**
+ * AccentLegend — the per-provider accent map, documented as a UI.
+ *
+ * one row per harness: the real mark, the provider name, and the accent swatch
+ * with its token name written out. the swatch is the LAST column on purpose —
+ * the mark + name already identify the provider, so the legend reads correctly
+ * with the color stripped (the neuroinclusive rule made visible).
+ *
+ * @param {object} props
+ * @param {string} [props.className]
+ * @returns {JSX.Element}
+ */
+export function AccentLegend({ className, ...rest }: {
+    className?: string;
+}): JSX.Element;
+export const HARNESSES: string[];
+export const PROVIDER_ACCENT: {
+    'claude-code': string;
+    'gemini-cli': string;
+    codex: string;
+    opencode: string;
+    cursor: string;
+};
+export default ProviderIcon;