@peasant-labs/fairtrade 0.0.50 → 0.0.52

package/dist/lib/share.js

@@ -1,6 +1,6 @@
 import { _ as e, c as t, g as n, h as r, m as i, p as a, v as o } from "./time-CpVBzcqQ.js";
 import { r as s } from "./format-B3uT2wzU.js";
-import { c, l, t as u } from "./adapter-CVKibszh.js";
+import { c, l, t as u } from "./adapter-VlAohr64.js";
 import { jsx as d, jsxs as f } from "react/jsx-runtime";
 //#region public/tokens.json
 var p = {
@@ -61,12 +61,12 @@ var p = {
 	},
 	rule: {
 		$type: "color",
-		$value: "#4f4a40",
+		$value: "#403d35",
 		$extensions: { "fairtrade.theme": { light: "#b3ab96" } }
 	},
 	"rule-strong": {
 		$type: "color",
-		$value: "#857f72",
+		$value: "#767165",
 		$extensions: { "fairtrade.theme": { light: "#7f7762" } }
 	},
 	"focus-ring": {

package/dist/lib/tokens.css

@@ -77,8 +77,8 @@
   --ink-3: #b3ad9f;
   --ink-4: #a19b8e;
   --ink-5: #615b50;
-  --rule: #4f4a40;
-  --rule-strong: #857f72;
+  --rule: #403d35;
+  --rule-strong: #767165;
   --focus-ring: #d6ae66;
   --amber: #d6ae66;
   --amber-bright: #ebc98c;

package/dist/lib/tokens.json

@@ -103,7 +103,7 @@
     },
     "rule": {
       "$type": "color",
-      "$value": "#4f4a40",
+      "$value": "#403d35",
       "$extensions": {
         "fairtrade.theme": {
           "light": "#b3ab96"
@@ -112,7 +112,7 @@
     },
     "rule-strong": {
       "$type": "color",
-      "$value": "#857f72",
+      "$value": "#767165",
       "$extensions": {
         "fairtrade.theme": {
           "light": "#7f7762"

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

@@ -1,7 +1,7 @@
 /**
  * The shared app sidebar, in one order for every app: the brand mark with a collapse handle on the
- * column's edge, the shortcuts (search, the docs and community, the app's links that leave it), the
- * app's own pages, then the footer row (the account on the left, the settings gear and the theme
+ * column's edge, the app's own pages, then shortcuts (search, the docs and outside links)
+ * above the footer row (the account on the left, the settings gear and the theme
  * toggle on the right). A sticky resizable column on desktop
  * that collapses to an icon rail; a top bar plus an opaque drawer below 768px.
  * @param {AppSidebarProps} props
@@ -27,8 +27,7 @@ export function AppPage({ children, as: Tag, className, ...rest }: AppPageProps)
  * @property {string} [href]     where the app lives. An app without an href is omitted, unless it has a tag.
  * @property {string} [tag]      a short note after the label. With no href the entry is shown as text, not a link.
  * @property {boolean} [soon]    a place that does not exist yet: shown as text, aria-disabled, with a 'soon' note
- *                               and no hover or press. The switcher always ends with community as soon unless
- *                               `apps` names a community entry of its own.
+ *                               and no hover or press. Community entries are hidden until that surface is available.
  * @property {string} [target]   default '_blank': another app opens in a new tab.
  * @property {string} [rel]      default 'noopener noreferrer' when the target is '_blank'.
  */
@@ -79,9 +78,9 @@ export function AppPage({ children, as: Tag, className, ...rest }: AppPageProps)
  * @property {string} [currentId]                   the id of the current item (aria-current="page").
  * @property {string} [homeHref]                    the brand links here.
  * @property {string} [brand]                       the brand's accessible name and tooltip, default 'peasant'.
- * @property {AppSidebarSearch} [search]           the app's search, the first shortcut under the brand.
+ * @property {AppSidebarSearch} [search]           the app's search, the first shortcut above the footer.
  * @property {AppSidebarItem[]} [elsewhere]         the app's links that leave it (collectives online, from the local app),
- *                                                  listed in the shortcuts after the docs and community. An `external`
+ *                                                  listed in the shortcuts after the docs. An `external`
  *                                                  item in `groups` moves there too.
  * @property {string} [settingsHref]                the app's settings: a gear in the footer, current when currentId is
  *                                                  'settings'. A `settings` item in `groups` becomes the gear instead.
@@ -117,7 +116,7 @@ export function AppPage({ children, as: Tag, className, ...rest }: AppPageProps)
  * @property {import('react').ElementType} [as]     the element, default 'div'.
  * @property {string} [className]
  */
-/** The app switcher's default entries, in order: the docs (community as soon follows by itself).
+/** The app switcher's default entries, in order: the docs.
  * Online and local are never in a switcher, in any app. Consumers map their hrefs in.
  * @type {ReadonlyArray<Readonly<AppSidebarApp>>} */
 export const APP_SIDEBAR_APPS: ReadonlyArray<Readonly<AppSidebarApp>>;
@@ -140,8 +139,7 @@ export type AppSidebarApp = {
     tag?: string;
     /**
      * a place that does not exist yet: shown as text, aria-disabled, with a 'soon' note
-     *     and no hover or press. The switcher always ends with community as soon unless
-     *     `apps` names a community entry of its own.
+     *     and no hover or press. Community entries are hidden until that surface is available.
      */
     soon?: boolean;
     /**
@@ -265,12 +263,12 @@ export type AppSidebarProps = {
      */
     brand?: string;
     /**
-     * the app's search, the first shortcut under the brand.
+     * the app's search, the first shortcut above the footer.
      */
     search?: AppSidebarSearch;
     /**
      * the app's links that leave it (collectives online, from the local app),
-     *          listed in the shortcuts after the docs and community. An `external`
+     *          listed in the shortcuts after the docs. An `external`
      *          item in `groups` moves there too.
      */
     elsewhere?: AppSidebarItem[];

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

@@ -3,12 +3,12 @@
  */
 /**
  * a single avatar tile: initials, or a photo with the initials as the fallback beneath it.
- * the base .avatar is 18px (inline meta); size scales it up for standalone use.
+ * the base .avatar is 24px (inline identity); size scales it up for standalone use.
  *
  * @param {object} props
  * @param {string} props.name - the person's name; used as the accessible label and to derive initials when none are given.
  * @param {string} [props.initials] - explicit initials to render; defaults to the first letters of `name`.
- * @param {AvatarSize} [props.size] - one of 'sm' | 'md' | 'lg' (24 / 32 / 44px). omit for the bare 18px base.
+ * @param {AvatarSize} [props.size] - one of 'sm' | 'md' | 'lg' (24 / 32 / 44px). omit for the 24px base.
  * @param {string} [props.src] - optional photo url; when set the tile becomes an .av-img with the photo over the initials.
  * @param {boolean} [props.more] - render the amber "+N overflow" tile (.av-more); `initials` carries the "+5" text.
  * @param {string} [props.className] - extra class names appended after the avatar classes.

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

@@ -9,4 +9,4 @@ export default function Dialog({ open, onClose, title, labelId, children, footer
     size?: string;
     className?: string;
     dismissible?: boolean;
-}): import("react").JSX.Element;
+}): any;

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

@@ -59,7 +59,7 @@ export function Field({ label, lock: LockIcon, hint, error, id, children }: {
  * @param {string} [props.id] - input id; auto-generated + associated with the label when omitted.
  * @returns {JSX.Element}
  */
-export default function Input({ label, lock, hint, error, invalid, iconLeft: IconLeft, type, readOnly, disabled, value, defaultValue, onChange, id, ...rest }: {
+export default function Input({ label, lock, hint, error, invalid, iconLeft: IconLeft, type, readOnly, disabled, value, defaultValue, onChange, id, className, ...rest }: {
     label?: React.ReactNode;
     lock?: React.ComponentType<{
         size?: number;
@@ -98,7 +98,7 @@ export default function Input({ label, lock, hint, error, invalid, iconLeft: Ico
  * @param {string} [props.id] - id; auto-generated + associated with the label when omitted.
  * @returns {JSX.Element}
  */
-export function Textarea({ label, lock, hint, error, invalid, rows, readOnly, disabled, value, defaultValue, onChange, id, ...rest }: {
+export function Textarea({ label, lock, hint, error, invalid, rows, readOnly, disabled, value, defaultValue, onChange, id, className, ...rest }: {
     label?: React.ReactNode;
     lock?: React.ComponentType<{
         size?: number;
@@ -137,7 +137,7 @@ export function Textarea({ label, lock, hint, error, invalid, rows, readOnly, di
  * @param {string} [props.id] - id; auto-generated + associated with the label when omitted.
  * @returns {JSX.Element}
  */
-export function Select({ label, lock, hint, error, invalid, options, children, disabled, value, defaultValue, onChange, id, ...rest }: {
+export function Select({ label, lock, hint, error, invalid, options, children, disabled, value, defaultValue, onChange, id, className, ...rest }: {
     label?: React.ReactNode;
     lock?: React.ComponentType<{
         size?: number;

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

@@ -14,4 +14,4 @@ export default function OverflowList({ items, limit, label, noun, empty, classNa
     noun?: [string, string];
     empty?: import("react").ReactNode;
     className?: string;
-}): string | number | bigint | boolean | import("react").JSX.Element | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode>>;
+}): string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode>> | import("react").JSX.Element;

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

@@ -7,10 +7,11 @@
  * @param {(diff: { add: string[], remove: string[] }) => void} props.onSave
  * @param {string} [props.title='link repositories']
  * @param {import('react').ReactNode} [props.description] - one line under the title.
+ * @param {boolean} [props.inline=false] - show the repository controls directly in the containing page.
  * @param {boolean} [props.saving=false] - the host's write is in flight.
  * @param {string} [props.error] - the host's write failed; shown in a role="alert" line.
  */
-export default function RepoPicker({ open, onClose, owners, initialSelected, onSave, title, description, saving, error }: {
+export default function RepoPicker({ open, onClose, owners, initialSelected, onSave, title, description, saving, error, inline }: {
     open: boolean;
     onClose: () => void;
     owners: RepoPickerOwner[];
@@ -21,6 +22,7 @@ export default function RepoPicker({ open, onClose, owners, initialSelected, onS
     }) => void;
     title?: string;
     description?: import("react").ReactNode;
+    inline?: boolean;
     saving?: boolean;
     error?: string;
 }): import("react").JSX.Element;

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

@@ -11,7 +11,7 @@
  * @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
+ * @property {boolean} [stateMarker=false] show the on/off word beside the switch; off where the
  *           host already says the state (a settings row).
  */
 /**

package/dist/lib/types/commons/Explore.d.ts

@@ -2,5 +2,5 @@
  * @typedef {import('./types.js').ExploreSurfaceProps} ExploreSurfaceProps
  */
 /** @param {ExploreSurfaceProps} props */
-export default function Explore({ data, className, onFiltersChange, onOpenTranscript, onOpenProfile, onOpenCollective, transcriptHref, profileHref, collectiveHref, headingLevel, }: ExploreSurfaceProps): import("react").JSX.Element;
+export default function Explore({ data, className, title, resultsFooter, defaultLayout, onFiltersChange, onOpenTranscript, onOpenProfile, onOpenCollective, transcriptHref, profileHref, collectiveHref, headingLevel, }: ExploreSurfaceProps): import("react").JSX.Element;
 export type ExploreSurfaceProps = import("./types.js").ExploreSurfaceProps;

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

@@ -88,6 +88,18 @@ export type ExploreFilters = {
 export type ExploreSurfaceProps = {
     data: ExplorePayload;
     className?: string;
+    /**
+     * Browse title; null when the host already supplies its heading.
+     */
+    title?: import("react").ReactNode;
+    /**
+     * Additional session groups after the results and pagination, inside the result column.
+     */
+    resultsFooter?: import("react").ReactNode;
+    /**
+     * Initial result layout; grid by default. Users can still switch views.
+     */
+    defaultLayout?: "grid" | "list";
     onFiltersChange?: (filters: ExploreFilters) => void;
     onOpenTranscript?: (transcript: ExploreTranscriptPayload) => void;
     onOpenProfile?: (owner: ExploreOwnerPayload) => void;

package/dist/lib/types/transcript/IntegrityBadge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @param {object} props
+ * @param {number} [props.headingLevel=2]  the panel heading's level, one under the viewer title
+ * @param {boolean} [props.folded=false]  the host has folded the badge out of view; an open panel closes
+ */
+export default function IntegrityBadge({ headingLevel, folded }: {
+    headingLevel?: number;
+    folded?: boolean;
+}): import("react").JSX.Element;
+/**
+ * The flagged-turn mark: the warning glyph and a word. On a turn head or a system row the heading
+ * carries the accessible name, so the mark is `aria-hidden`; in a work group, which has no heading
+ * of its own, it stays readable.
+ * @param {object} props
+ * @param {string} [props.text]  the word beside the glyph
+ * @param {boolean} [props.decorative=true]  hide the whole mark from assistive technology
+ */
+export function IntegrityMark({ text, decorative }: {
+    text?: string;
+    decorative?: boolean;
+}): import("react").JSX.Element;

package/dist/lib/types/transcript/TranscriptViewer.d.ts

@@ -1,7 +1,7 @@
 /**
  * @param {TranscriptViewerProps} props
  */
-export default function TranscriptViewer({ viewModel, capabilities, callbacks, theme: themeProp, onThemeChange, graphSlot, activeTab: activeTabProp, onTabChange, viewMode: viewModeProp, onViewModeChange, sidebarLayout: sidebarLayoutProp, onSidebarLayoutChange, zen: zenProp, onZenChange, readerWidth: readerWidthProp, onReaderWidthChange, leftRailOpen: leftRailOpenProp, onLeftRailOpenChange, rightRailOpen: rightRailOpenProp, onRightRailOpenChange, openTools: openToolsProp, onOpenToolsChange, earlierHistoryOpen: earlierHistoryOpenProp, onEarlierHistoryOpenChange, initialPosition: initialPositionProp, activeTurn: activeTurnProp, onActiveTurnChange, search: searchProp, onSearchChange, filters: filtersProp, onFiltersChange, savedLabels: savedLabelsProp, onSavedLabelsChange, shareOpen: shareOpenProp, onShareOpenChange, moreOpen: moreOpenProp, onMoreOpenChange, breadcrumb, breadcrumbContext, beforeHeader, LinkComponent, renderTurnPanel, renderTurnActions, anchorHref, headerActions, utilityActions, streamPrelude, showTail, showOutcome, showSearchTrigger, footer, presentation, subtitle, pullRequests, headingLevel, }: TranscriptViewerProps): import("react").JSX.Element;
+export default function TranscriptViewer({ viewModel, capabilities, callbacks, theme: themeProp, onThemeChange, graphSlot, activeTab: activeTabProp, onTabChange, viewMode: viewModeProp, onViewModeChange, sidebarLayout: sidebarLayoutProp, onSidebarLayoutChange, zen: zenProp, onZenChange, readerWidth: readerWidthProp, onReaderWidthChange, leftRailOpen: leftRailOpenProp, onLeftRailOpenChange, rightRailOpen: rightRailOpenProp, onRightRailOpenChange, openTools: openToolsProp, onOpenToolsChange, earlierHistoryOpen: earlierHistoryOpenProp, onEarlierHistoryOpenChange, initialPosition: initialPositionProp, activeTurn: activeTurnProp, onActiveTurnChange, search: searchProp, onSearchChange, filters: filtersProp, onFiltersChange, savedLabels: savedLabelsProp, onSavedLabelsChange, shareOpen: shareOpenProp, onShareOpenChange, moreOpen: moreOpenProp, onMoreOpenChange, breadcrumb, breadcrumbContext, beforeHeader, LinkComponent, renderTurnPanel, renderTurnActions, anchorHref, headerActions, utilityActions, streamPrelude, showTail, showOutcome, showSearchTrigger, footer, presentation, subtitle, pullRequests, headingLevel, integrity, transcriptContentHash, contentHash, }: TranscriptViewerProps): import("react").JSX.Element;
 export const READER_FULL: "full";
 export type TranscriptViewerProps = import("./state-capabilities.js").TranscriptViewerProps;
 export type TranscriptFilters = import("./state-capabilities.js").TranscriptFilters;

package/dist/lib/types/transcript/TurnCard.d.ts

@@ -16,6 +16,10 @@
  * @param {number} [props.revealRequest] explicit search navigation sequence
  * @param {number} [props.headingLevel=4] the turn heading's level: h4 under a viewer whose title is an h2, h3 under one
  *        whose title is the page's h1
+ * @param {boolean} [props.flagged=false] the integrity check marked this turn: the article takes `is-flagged`, the
+ *        heading gains a hidden suffix naming the flag, and a visible mark shows in the head (or the system row's
+ *        trailing cluster, or the start of a ledger detail turn's work block)
+ * @param {ReadonlySet<number>} [props.flaggedPositions] source positions marked in a work group this card renders
  * @param {'classic' | 'ledger'} [props.presentation='classic'] chrome presentation. `ledger` leads with a
  *        square role well and the role word, groups the turn's tool calls into one work panel, and renders a
  *        system turn as a compact row; absent, the classic card renders exactly as before. In ledger the head
@@ -25,7 +29,7 @@
  *        `renderActions` and `renderTurnPanel` keep rendering on every role, so a host extension is never
  *        dropped by the presentation switch.
  */
-export default function TurnCard({ turn, active, onSelect, openTools, toggleTool, onCopyAnchor, copied, registerRef, onLabel, renderActions, savedLabel, compact, expandAll, revealRequest, headingLevel, modelActions, actionReveal, registerActionRef, suppressWork, presentation, }: {
+export default function TurnCard({ turn, active, onSelect, openTools, toggleTool, onCopyAnchor, copied, registerRef, onLabel, renderActions, savedLabel, compact, expandAll, revealRequest, headingLevel, modelActions, actionReveal, registerActionRef, suppressWork, presentation, flagged, flaggedPositions, }: {
     turn?: TurnVM;
     active?: boolean;
     onSelect?: (turnIndex: number) => void;
@@ -44,6 +48,8 @@ export default function TurnCard({ turn, active, onSelect, openTools, toggleTool
     expandAll?: boolean;
     revealRequest?: number;
     headingLevel?: number;
+    flagged?: boolean;
+    flaggedPositions?: ReadonlySet<number>;
     presentation?: "classic" | "ledger";
 }): import("react").JSX.Element;
 export type TurnVM = import("./view-model.js").TurnVM;

package/dist/lib/types/transcript/WorkGroup.d.ts

@@ -12,12 +12,14 @@ export default function TranscriptWorkGroup({ tools, thinking, openTools, onTogg
     onToggle?: (id: string) => void;
     expandAll?: boolean;
 }): import("react").JSX.Element;
-export function ModelActions({ turns, openTools, onToggle, expandAll, compact, reveal, registerActionRef }: {
+export function ModelActions({ turns, openTools, onToggle, expandAll, compact, flaggedPositions, cardTurn, reveal, registerActionRef }: {
     turns?: any[];
     openTools?: {};
     onToggle?: () => void;
     expandAll?: boolean;
     compact?: boolean;
+    flaggedPositions: any;
+    cardTurn: any;
     reveal: any;
     registerActionRef?: () => void;
 }): import("react").JSX.Element;

package/dist/lib/types/transcript/integrity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @param {unknown} integrity  the served integrity value; its presence is the flag
+ * @param {unknown} transcriptContentHash  the detail response's transcript content hash
+ * @param {unknown} contentHash  the hash of the rendered content, when the host has one
+ * @returns {{ positions: ReadonlySet<number> } | null} null draws nothing; otherwise the badge
+ *   draws, and positions are marked only when both hashes are non-empty and equal
+ */
+export function integrityView(integrity: unknown, transcriptContentHash: unknown, contentHash: unknown): {
+    positions: ReadonlySet<number>;
+} | null;
+/**
+ * Pure view of a transcript's served integrity flag. The host passes the served value as it
+ * arrived, the detail response's content hash, and the content hash of the rendered content.
+ * Nothing here knows how the flag was decided.
+ */
+/** @typedef {import('@peasant-labs/schema').VillageTranscriptIntegrity} VillageTranscriptIntegrity */
+/**
+ * Every string the integrity badge, its help panel and the flagged-turn mark show. This object is
+ * the single place to edit that wording: change a value here and every surface follows. The tests
+ * read the strings from this object rather than repeating them, so a reworded value needs no test
+ * edit. They do guard that the key set stays the same, that no value names a rule, a field or the
+ * service behind the check, and that no value uses an em dash or a middle dot. The badge's
+ * accessible name (helpName) must contain its visible label (badgeLabel).
+ */
+export const INTEGRITY_COPY: Readonly<{
+    badgeLabel: "suspicious transcript";
+    helpName: "what does suspicious transcript mean?";
+    panelHeading: "about this flag";
+    panelBody: "This transcript has likely been edited after it was recorded, according to our automated detection systems.";
+    panelOtherTools: "Custom tools, plugins or hooks used during the session can create false positives.";
+    statusText: "This transcript has been flagged by an automated check and was likely modified after initially recorded.";
+    turnMark: "flagged";
+    turnName: ", flagged by an automated check";
+    groupMark: "includes a flagged turn";
+}>;
+export type VillageTranscriptIntegrity = import("@peasant-labs/schema").VillageTranscriptIntegrity;

package/dist/lib/types/transcript/state-capabilities.d.ts

@@ -323,6 +323,18 @@ export type TranscriptViewerBaseProps = {
      * host-owned node rendered under the meta row (a pull request list and its own "show all" control); omitted renders nothing
      */
     pullRequests?: unknown;
+    /**
+     * the served integrity value, passed through untouched. Present and well formed means flagged: the header shows the badge in every presentation and width. Absent, null or malformed renders nothing
+     */
+    integrity?: import("@peasant-labs/schema").VillageTranscriptIntegrity | null;
+    /**
+     * the detail response's `transcript.content_hash`, the content `integrity.flagged_turns` refer to
+     */
+    transcriptContentHash?: string | null;
+    /**
+     * the bare hash of the content `viewModel` was cooked from (the content route's `Village-Content-Hash` header). Turns are marked only when it equals `transcriptContentHash` and both are non-empty
+     */
+    contentHash?: string | null;
 };
 /**
  * The full legacy trail and the ancestor-only context are alternative contracts.

package/dist/lib/types/transcript/view-model.d.ts

@@ -311,6 +311,10 @@ export type TurnVM = {
      * whether this index is unambiguous in its partition
      */
     sourceIndexUnique?: boolean;
+    /**
+     * position in payload.turns, the value VillageTranscriptIntegrity.flagged_turns refers to; main turns only
+     */
+    sourcePosition?: number;
     /**
      * partition-scoped stable rendering key
      */

package/dist/lib/types/transcript/work-summary.d.ts

@@ -1,3 +1,12 @@
+/**
+ * True when a turn has words of its own, so it draws a card (a turn that is only work is inline detail).
+ * @param {{ displayContent?: unknown, content?: unknown } | null | undefined} turn
+ * @returns {boolean}
+ */
+export function turnHasProse(turn: {
+    displayContent?: unknown;
+    content?: unknown;
+} | null | undefined): boolean;
 /**
  * Summarize one turn's tool calls.
  * @param {ToolCallVM[]} [tools]

package/dist/lib/types/ui/transcript/view-model.d.ts

@@ -311,6 +311,10 @@ export type TurnVM = {
      * whether this index is unambiguous in its partition
      */
     sourceIndexUnique?: boolean;
+    /**
+     * position in payload.turns, the value VillageTranscriptIntegrity.flagged_turns refers to; main turns only
+     */
+    sourcePosition?: number;
     /**
      * partition-scoped stable rendering key
      */