@peasant-labs/fairtrade 0.0.0

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

@@ -0,0 +1,130 @@
+export default meta;
+export const Playground: {};
+export namespace Default {
+    namespace args {
+        export { Inbox as icon };
+        export let title: string;
+        export let message: string;
+    }
+}
+export namespace WithAction {
+    export namespace args_1 {
+        export { Plus as icon };
+        let title_1: string;
+        export { title_1 as title };
+        let message_1: string;
+        export { message_1 as message };
+        export let action: any;
+    }
+    export { args_1 as args };
+}
+export namespace NoMessage {
+    export namespace args_2 {
+        export { Compass as icon };
+        let title_2: string;
+        export { title_2 as title };
+        let message_2: any;
+        export { message_2 as message };
+    }
+    export { args_2 as args };
+}
+export namespace NoResults {
+    export namespace args_3 {
+        export { Search as icon };
+        let title_3: string;
+        export { title_3 as title };
+        let message_3: string;
+        export { message_3 as message };
+        let action_1: any;
+        export { action_1 as action };
+    }
+    export { args_3 as args };
+}
+export namespace NoMembers {
+    export namespace args_4 {
+        export { Users as icon };
+        let title_4: string;
+        export { title_4 as title };
+        let message_4: string;
+        export { message_4 as message };
+        let action_2: any;
+        export { action_2 as action };
+    }
+    export { args_4 as args };
+}
+export namespace ErrorState {
+    export namespace args_5 {
+        export { ShieldAlert as icon };
+        let title_5: string;
+        export { title_5 as title };
+        let message_5: string;
+        export { message_5 as message };
+        let action_3: any;
+        export { action_3 as action };
+    }
+    export { args_5 as args };
+}
+export namespace NoIcon {
+    export namespace args_6 {
+        export let icon: any;
+        let title_6: string;
+        export { title_6 as title };
+        let message_6: string;
+        export { message_6 as message };
+    }
+    export { args_6 as args };
+}
+export namespace ActionViaChildren {
+    export namespace args_7 {
+        export { Plus as icon };
+        let title_7: string;
+        export { title_7 as title };
+        let message_7: string;
+        export { message_7 as message };
+    }
+    export { args_7 as args };
+    export function render(args: any): any;
+}
+declare namespace meta {
+    let title_8: string;
+    export { title_8 as title };
+    export { EmptyState as component };
+    export let tags: string[];
+    export let decorators: Function[];
+    export namespace argTypes {
+        export namespace icon_1 {
+            let control: boolean;
+        }
+        export { icon_1 as icon };
+        export namespace title_9 {
+            let control_1: string;
+            export { control_1 as control };
+        }
+        export { title_9 as title };
+        export namespace message_8 {
+            let control_2: string;
+            export { control_2 as control };
+        }
+        export { message_8 as message };
+        export namespace action_4 {
+            let control_3: boolean;
+            export { control_3 as control };
+        }
+        export { action_4 as action };
+    }
+    export namespace args_8 {
+        export { Inbox as icon };
+        let title_10: string;
+        export { title_10 as title };
+        let message_9: string;
+        export { message_9 as message };
+    }
+    export { args_8 as args };
+}
+import { Inbox } from 'lucide-react';
+import { Plus } from 'lucide-react';
+import { Compass } from 'lucide-react';
+import { Search } from 'lucide-react';
+import { Users } from 'lucide-react';
+import { ShieldAlert } from 'lucide-react';
+import EmptyState from './EmptyState.jsx';

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

@@ -0,0 +1,39 @@
+/**
+ * EvidenceCaption — the recap sentence assembled from fragments.
+ *
+ * @param {object} props
+ * @param {Array<{text: string, anchorId?: string, label?: string}>} props.fragments
+ *        the ordered fragments. a fragment WITH `anchorId` is a clickable proof link (jumps to the
+ *        <EvidenceTarget id={anchorId}> and flashes it); `label` names the destination for AT
+ *        (defaults to the anchorId). a fragment without `anchorId` is plain prose.
+ * @param {(anchorId: string) => void} [props.onJump] - called with the anchorId when a fragment is
+ *        activated (in addition to the built-in scroll + highlight).
+ * @param {string} [props['aria-label']] - accessible label for the recap region (default: "recap").
+ * @param {string} [props.className]
+ */
+export function EvidenceCaption({ fragments, onJump, "aria-label": ariaLabel, className, ...rest }: {
+    fragments: Array<{
+        text: string;
+        anchorId?: string;
+        label?: string;
+    }>;
+    onJump?: (anchorId: string) => void;
+}): any;
+/**
+ * EvidenceTarget — the proof block a fragment jumps to. it owns the `id` the caption scrolls to and
+ * the `data-ec-flash` attribute the CSS animates on arrival. give it an `eyebrow` (a small mono
+ * anchor label, lowercased chrome) so the reader sees which evidence they landed on.
+ *
+ * @param {object} props
+ * @param {string} props.id - the anchor id; a fragment's `anchorId` points here.
+ * @param {string} [props.eyebrow] - the small anchor label shown above the block (chrome → mono).
+ * @param {React.ReactNode} props.children - the evidence content.
+ * @param {string} [props.className]
+ */
+export function EvidenceTarget({ id, eyebrow, children, className, ...rest }: {
+    id: string;
+    eyebrow?: string;
+    children: React.ReactNode;
+    className?: string;
+}): any;
+export default EvidenceCaption;

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

@@ -0,0 +1,43 @@
+export default meta;
+export namespace Default {
+    function render(args: any): any;
+    namespace args {
+        let onJump: import("storybook/test").Mock<(...args: any[]) => any>;
+    }
+    function play({ args, canvasElement }: {
+        args: any;
+        canvasElement: any;
+    }): Promise<void>;
+}
+export namespace LightTheme {
+    export function render_1(args: any): any;
+    export { render_1 as render };
+    export namespace args_1 {
+        let onJump_1: import("storybook/test").Mock<(...args: any[]) => any>;
+        export { onJump_1 as onJump };
+    }
+    export { args_1 as args };
+    export namespace globals {
+        let theme: string;
+        namespace backgrounds {
+            let value: string;
+        }
+    }
+}
+declare namespace meta {
+    export let title: string;
+    export { EvidenceCaption as component };
+    export let tags: string[];
+    export let decorators: Function[];
+    export namespace argTypes {
+        export namespace fragments {
+            let control: boolean;
+        }
+        export namespace onJump_2 {
+            let control_1: boolean;
+            export { control_1 as control };
+        }
+        export { onJump_2 as onJump };
+    }
+}
+import { EvidenceCaption } from './EvidenceCaption.jsx';

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

@@ -0,0 +1,82 @@
+/**
+ * @typedef {Object} ExplainerProps
+ * @property {React.ReactNode} children            the explanatory PROSE (rendered in var(--font-body)); may contain <Term> words.
+ * @property {React.ReactNode} [title='what am i looking at?']  the toggle-row heading (mono chrome, lowercased by css).
+ * @property {boolean} [defaultOpen=false]         initial open state when nothing is persisted.
+ * @property {string} [storageKey]                 when given, open/closed persists to localStorage under this surface key.
+ * @property {'card'|'inline'} [tone='card']       'card' = bordered panel; 'inline' = a quieter ghost (no fill/border).
+ * @property {string} [className]                  extra class on the root.
+ */
+/**
+ * The "what am i looking at?" block — one per surface. A square "?" / heading toggle row reveals or
+ * hides a short prose body (the heading reads aria-expanded; the body is the toggle's aria-controls
+ * region). The toggle target is the whole row (>= the 24px minimum). Open state persists per surface
+ * when `storageKey` is set. Two tones: a bordered `card` panel, or a quieter `inline` ghost.
+ * It is never a modal and never steals focus.
+ */
+export default function Explainer({ children, title, defaultOpen, storageKey, tone, className, }: {
+    children: any;
+    title?: string;
+    defaultOpen?: boolean;
+    storageKey: any;
+    tone?: string;
+    className?: string;
+}): any;
+/**
+ * @typedef {Object} TermProps
+ * @property {string} def              the plain-language definition shown in the tooltip (mono chrome).
+ * @property {React.ReactNode} children  the inline word(s) to underline.
+ * @property {string} [className]      extra class on the trigger.
+ */
+/**
+ * Inline glossary term: a dotted-underline word that reveals a small square tooltip with its
+ * definition on hover AND keyboard focus (and on tap, for touch). The trigger is a real <button> so
+ * it's reachable and operable from the keyboard; the bubble is wired via aria-describedby so the
+ * definition reinforces — never solely names — the word. A tooltip is reinforcement, so anything
+ * load-bearing must also live in visible copy.
+ */
+export function Term({ def, children, className }: {
+    def: any;
+    children: any;
+    className?: string;
+}): any;
+export type ExplainerProps = {
+    /**
+     * the explanatory PROSE (rendered in var(--font-body)); may contain <Term> words.
+     */
+    children: React.ReactNode;
+    /**
+     * the toggle-row heading (mono chrome, lowercased by css).
+     */
+    title?: React.ReactNode;
+    /**
+     * initial open state when nothing is persisted.
+     */
+    defaultOpen?: boolean;
+    /**
+     * when given, open/closed persists to localStorage under this surface key.
+     */
+    storageKey?: string;
+    /**
+     * 'card' = bordered panel; 'inline' = a quieter ghost (no fill/border).
+     */
+    tone?: "card" | "inline";
+    /**
+     * extra class on the root.
+     */
+    className?: string;
+};
+export type TermProps = {
+    /**
+     * the plain-language definition shown in the tooltip (mono chrome).
+     */
+    def: string;
+    /**
+     * the inline word(s) to underline.
+     */
+    children: React.ReactNode;
+    /**
+     * extra class on the trigger.
+     */
+    className?: string;
+};

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

@@ -0,0 +1,22 @@
+export default meta;
+export namespace Default {
+    function render(): any;
+    function play({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+}
+export namespace Inline {
+    export function render_1(): any;
+    export { render_1 as render };
+}
+export namespace Terms {
+    export function render_2(): any;
+    export { render_2 as render };
+}
+declare namespace meta {
+    export let title: string;
+    export { Explainer as component };
+    export let tags: string[];
+    export let decorators: Function[];
+}
+import Explainer from './Explainer.jsx';

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

@@ -0,0 +1,13 @@
+export default function FacetRail({ order, onOrder, providers, activeProviders, onProvider, topics, activeTopics, onTopic, onClear, className, ...rest }: {
+    [x: string]: any;
+    order?: string;
+    onOrder: any;
+    providers?: any[];
+    activeProviders?: Set<any>;
+    onProvider: any;
+    topics?: any[];
+    activeTopics?: Set<any>;
+    onTopic: any;
+    onClear: any;
+    className?: string;
+}): any;

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

@@ -0,0 +1,28 @@
+export default meta;
+export namespace Default {
+    function render(): any;
+}
+export namespace Empty {
+    export function render_1(): any;
+    export { render_1 as render };
+}
+export namespace AllActive {
+    export function render_2(): any;
+    export { render_2 as render };
+}
+export namespace TogglesProvider {
+    export function render_3(): any;
+    export { render_3 as render };
+    export function play({ canvasElement }: {
+        canvasElement: any;
+    }): Promise<void>;
+}
+declare namespace meta {
+    export let title: string;
+    export { FacetRail as component };
+    export namespace parameters {
+        let layout: string;
+    }
+    export let tags: string[];
+}
+import FacetRail from './FacetRail.jsx';

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

@@ -0,0 +1,222 @@
+/**
+ * Skeleton — a placeholder block that mirrors the shape of loading content.
+ * @typedef {Object} SkeletonProps
+ * @property {string} [label='loading'] aria-label announcing what is loading.
+ * @property {boolean} [avatar=true]    render the leading 32px avatar block + two
+ *                                      stacked lines (w-40 / w-70) at the top.
+ * @property {number} [lines=2]         number of full-width body lines below the row;
+ *                                      they cycle through w-90 / w-70 widths.
+ * @property {string} [className]       extra classes appended to the .fb-skel root.
+ */
+/**
+ * @param {SkeletonProps} props
+ */
+export function Skeleton({ label, avatar, lines, className }: SkeletonProps): any;
+/**
+ * Progress — a determinate progress bar with a labelled head + tabular percent.
+ * @typedef {Object} ProgressProps
+ * @property {number} [value=0]         current value, 0–100 (clamped); drives the fill
+ *                                      width and aria-valuenow + the displayed percent.
+ * @property {number} [min=0]           aria-valuemin.
+ * @property {number} [max=100]         aria-valuemax.
+ * @property {React.ReactNode} [label]  caption shown at the left of the head row.
+ * @property {string} [ariaLabel]       accessible name for the track (progressbar);
+ *                                      falls back to the string `label` when omitted.
+ * @property {boolean} [showPct=true]   render the tabular percent on the right.
+ * @property {string} [className]       extra classes appended to the .fb-prog root.
+ */
+/**
+ * @param {ProgressProps} props
+ */
+export function Progress({ value, min, max, label, ariaLabel, showPct, className, }: ProgressProps): any;
+/**
+ * Spinner — an inline busy marker: spinning icon + lowercase label, in a live region.
+ * @typedef {Object} SpinnerProps
+ * @property {React.ReactNode} [children] label text beside the icon (the live message).
+ * @property {React.ComponentType} [icon=LoaderCircle] icon component reference; the CSS
+ *                                      spins .lucide only under no-preference + aria-busy.
+ * @property {string} [className]       extra classes appended to the .fb-spin root.
+ */
+/**
+ * @param {SpinnerProps} props
+ */
+export function Spinner({ children, icon: Icon, className }: SpinnerProps): any;
+/**
+ * Toast — a transient notification: icon + title + message + dismiss button.
+ * Render inside an aria-live region (e.g. a wrapper with aria-live="polite") for the
+ * announcement; the toast itself carries role status (ok) or alert (error).
+ * @typedef {Object} ToastProps
+ * @property {'ok'|'err'} [variant='ok'] tone; 'ok' = circle-check/olive + role=status,
+ *                                      'err' = circle-x/clay + role=alert.
+ * @property {React.ReactNode} title    the .fb-toast-title line.
+ * @property {React.ReactNode} [children] the body message (.fb-toast-msg).
+ * @property {React.ComponentType} [icon] override the leading icon component reference.
+ * @property {() => void} [onClose]     called when the dismiss button is clicked; when
+ *                                      omitted the close button is not rendered.
+ * @property {string} [closeLabel='dismiss notification'] aria-label for the close button.
+ * @property {string} [className]       extra classes appended to the .fb-toast root.
+ */
+/**
+ * @param {ToastProps} props
+ */
+export function Toast({ variant, title, children, icon: Icon, onClose, closeLabel, className, }: ToastProps): any;
+/**
+ * FeedbackPanel — a centred inline state surface (loading / error / empty), with an
+ * icon tile, lowercase title and a message. Loading sets aria-busy + role=status;
+ * error sets role=alert; the neutral (empty / resolved) panel has no role.
+ * @typedef {Object} FeedbackPanelProps
+ * @property {'loading'|'error'|'empty'} [variant='empty'] which surface to render; picks
+ *                                      the default icon, role and .is-err styling.
+ * @property {React.ReactNode} [title]  the .fb-panel-title (defaults per variant).
+ * @property {React.ReactNode} [children] the message body (.fb-panel-msg).
+ * @property {React.ComponentType} [icon] override the icon component reference; defaults
+ *                                      to loader-circle / circle-alert / search-x.
+ * @property {string} [className]       extra classes appended to the .fb-panel root.
+ */
+/**
+ * @param {FeedbackPanelProps} props
+ */
+export function FeedbackPanel({ variant, title, children, icon: Icon, className }: FeedbackPanelProps): any;
+export default Spinner;
+/**
+ * Skeleton — a placeholder block that mirrors the shape of loading content.
+ */
+export type SkeletonProps = {
+    /**
+     * aria-label announcing what is loading.
+     */
+    label?: string;
+    /**
+     * render the leading 32px avatar block + two
+     *     stacked lines (w-40 / w-70) at the top.
+     */
+    avatar?: boolean;
+    /**
+     * number of full-width body lines below the row;
+     *          they cycle through w-90 / w-70 widths.
+     */
+    lines?: number;
+    /**
+     * extra classes appended to the .fb-skel root.
+     */
+    className?: string;
+};
+/**
+ * Progress — a determinate progress bar with a labelled head + tabular percent.
+ */
+export type ProgressProps = {
+    /**
+     * current value, 0–100 (clamped); drives the fill
+     *          width and aria-valuenow + the displayed percent.
+     */
+    value?: number;
+    /**
+     * aria-valuemin.
+     */
+    min?: number;
+    /**
+     * aria-valuemax.
+     */
+    max?: number;
+    /**
+     * caption shown at the left of the head row.
+     */
+    label?: React.ReactNode;
+    /**
+     * accessible name for the track (progressbar);
+     *        falls back to the string `label` when omitted.
+     */
+    ariaLabel?: string;
+    /**
+     * render the tabular percent on the right.
+     */
+    showPct?: boolean;
+    /**
+     * extra classes appended to the .fb-prog root.
+     */
+    className?: string;
+};
+/**
+ * Spinner — an inline busy marker: spinning icon + lowercase label, in a live region.
+ */
+export type SpinnerProps = {
+    /**
+     * label text beside the icon (the live message).
+     */
+    children?: React.ReactNode;
+    /**
+     * icon component reference; the CSS
+     * spins .lucide only under no-preference + aria-busy.
+     */
+    icon?: React.ComponentType;
+    /**
+     * extra classes appended to the .fb-spin root.
+     */
+    className?: string;
+};
+/**
+ * Toast — a transient notification: icon + title + message + dismiss button.
+ * Render inside an aria-live region (e.g. a wrapper with aria-live="polite") for the
+ * announcement; the toast itself carries role status (ok) or alert (error).
+ */
+export type ToastProps = {
+    /**
+     * tone; 'ok' = circle-check/olive + role=status,
+     * 'err' = circle-x/clay + role=alert.
+     */
+    variant?: "ok" | "err";
+    /**
+     * the .fb-toast-title line.
+     */
+    title: React.ReactNode;
+    /**
+     * the body message (.fb-toast-msg).
+     */
+    children?: React.ReactNode;
+    /**
+     * override the leading icon component reference.
+     */
+    icon?: React.ComponentType;
+    /**
+     * called when the dismiss button is clicked; when
+     *      omitted the close button is not rendered.
+     */
+    onClose?: () => void;
+    /**
+     * aria-label for the close button.
+     */
+    closeLabel?: string;
+    /**
+     * extra classes appended to the .fb-toast root.
+     */
+    className?: string;
+};
+/**
+ * FeedbackPanel — a centred inline state surface (loading / error / empty), with an
+ * icon tile, lowercase title and a message. Loading sets aria-busy + role=status;
+ * error sets role=alert; the neutral (empty / resolved) panel has no role.
+ */
+export type FeedbackPanelProps = {
+    /**
+     * which surface to render; picks
+     * the default icon, role and .is-err styling.
+     */
+    variant?: "loading" | "error" | "empty";
+    /**
+     * the .fb-panel-title (defaults per variant).
+     */
+    title?: React.ReactNode;
+    /**
+     * the message body (.fb-panel-msg).
+     */
+    children?: React.ReactNode;
+    /**
+     * override the icon component reference; defaults
+     * to loader-circle / circle-alert / search-x.
+     */
+    icon?: React.ComponentType;
+    /**
+     * extra classes appended to the .fb-panel root.
+     */
+    className?: string;
+};

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

@@ -0,0 +1,81 @@
+export default meta;
+export const Playground: {};
+export namespace SpinnerDefault {
+    function render(): any;
+}
+export namespace SkeletonLoading {
+    export function render_1(): any;
+    export { render_1 as render };
+}
+export namespace SkeletonNoAvatar {
+    export function render_2(): any;
+    export { render_2 as render };
+}
+export namespace ProgressBar {
+    export function render_3(): any;
+    export { render_3 as render };
+}
+export namespace ProgressEmpty {
+    export function render_4(): any;
+    export { render_4 as render };
+}
+export namespace ProgressComplete {
+    export function render_5(): any;
+    export { render_5 as render };
+}
+export namespace ToastOk {
+    export function render_6(): any;
+    export { render_6 as render };
+}
+export namespace ToastError {
+    export function render_7(): any;
+    export { render_7 as render };
+}
+export namespace ToastCustomIcon {
+    export function render_8(): any;
+    export { render_8 as render };
+}
+export namespace PanelEmpty {
+    export function render_9(): any;
+    export { render_9 as render };
+}
+export namespace PanelLoading {
+    export function render_10(): any;
+    export { render_10 as render };
+}
+export namespace PanelError {
+    export function render_11(): any;
+    export { render_11 as render };
+}
+export namespace ProgressNoPct {
+    export function render_12(): any;
+    export { render_12 as render };
+}
+export namespace SkeletonAvatarOnly {
+    export function render_13(): any;
+    export { render_13 as render };
+}
+export namespace SpinnerCustomIcon {
+    export function render_14(): any;
+    export { render_14 as render };
+}
+export namespace ToastNoClose {
+    export function render_15(): any;
+    export { render_15 as render };
+}
+declare namespace meta {
+    export let title: string;
+    export { Spinner as component };
+    export let tags: string[];
+    export let decorators: Function[];
+    export namespace argTypes {
+        namespace children {
+            let control: string;
+        }
+    }
+    export namespace args {
+        let children_1: string;
+        export { children_1 as children };
+    }
+}
+import { Spinner } from './Feedback.jsx';