@peasant-labs/fairtrade 0.0.21 → 0.0.23

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

@@ -0,0 +1,283 @@
+/**
+ * The collectives list: the collectives in a table, the create form, and (with
+ * `onSearchCollectives`) a search for others.
+ *
+ * @param {object} [props]
+ * @param {object} [props.data]
+ * @param {CollectiveRow[]} [props.data.collectives]
+ * @param {string[]} [props.data.linkedOrgs] - github orgs a new collective can link.
+ * @param {string} [props.data.title='collectives']
+ * @param {string} [props.data.deck]
+ * @param {string} [props.data.crumb] - a breadcrumb above the title.
+ * @param {string} [props.data.caption='collectives'] - the table caption, before the count.
+ * @param {string} [props.data.createLabel='new collective']
+ * @param {boolean} [props.data.createBusy]
+ * @param {PolicyChoice[]} [props.data.whoCanPublish] - the create form's join choices.
+ * @param {PolicyChoice[]} [props.data.whoCanRead] - the create form's read choices.
+ * @param {object} [props.actions]
+ * @param {(collective: { name: string, purpose: string, mode: string, access: string, org: string }) => void} [props.actions.onCreateCollective]
+ * @param {(id: string) => void} [props.actions.onOpenCollective]
+ * @param {(query: string) => void} [props.actions.onSearchCollectives]
+ */
+export function CollectivesView({ data, actions }?: {
+    data?: {
+        collectives?: CollectiveRow[];
+        linkedOrgs?: string[];
+        title?: string;
+        deck?: string;
+        crumb?: string;
+        caption?: string;
+        createLabel?: string;
+        createBusy?: boolean;
+        whoCanPublish?: PolicyChoice[];
+        whoCanRead?: PolicyChoice[];
+    };
+    actions?: {
+        onCreateCollective?: (collective: {
+            name: string;
+            purpose: string;
+            mode: string;
+            access: string;
+            org: string;
+        }) => void;
+        onOpenCollective?: (id: string) => void;
+        onSearchCollectives?: (query: string) => void;
+    };
+}): import("react").JSX.Element;
+/**
+ * @typedef {object} CollectiveData
+ * @property {string} [id]
+ * @property {string} name - kept in its case.
+ * @property {string|null} [purpose]
+ * @property {string|null} [description] - the earlier name for `purpose`.
+ * @property {string|null} [linkedGithubOrg] - the earlier name for `org.login`.
+ * @property {string} [role] - the viewer's role; `owner` shows the settings button.
+ * @property {string} [whoCanRead] - the policy in words, for the collective page.
+ * @property {string} [whoCanPublish] - the policy in words, for the collective page.
+ * @property {string} [yourRole] - the viewer's role in words.
+ * @property {string} [mode] - the join policy value, for settings (`open`, `verified_only`, `curated`).
+ * @property {string} [access] - the read policy value, for settings (`members_only`, `contributors`).
+ * @property {string} [memberLeaves] - what happens to a leaving member's transcripts, for settings.
+ * @property {{ value: number|string, label: string }[]} [stats]
+ * @property {number} [transcriptCount] - every transcript, when `transcripts` holds one page of them.
+ * @property {{ login: string, linked?: number, total?: number } | null} [org] - null says nothing is linked; left out, the line is left out.
+ * @property {string} [memberBreakdown]
+ * @property {{ id: string, title: string, harness: string, turns?: number, author?: string, pullRequests?: string[], repo?: string|null, when?: string }[]} [transcripts]
+ * @property {{ handle: string, name?: string, role: string }[]} [members]
+ * @property {number} [memberCount]
+ */
+/**
+ * A collective: its purpose, the boxes that say who can read, who can publish and your role, one
+ * stats line, its transcripts with their pull requests, and a rail with the github org and the
+ * members.
+ *
+ * @param {object} [props]
+ * @param {object} [props.data]
+ * @param {CollectiveData} [props.data.collective]
+ * @param {object[]} [props.data.owners] - RepoPicker owners, for linking repositories.
+ * @param {string[]} [props.data.linkedRepos]
+ * @param {HrefFor} [props.data.hrefFor] - where a link goes; without it links render as buttons.
+ * @param {object} [props.actions]
+ * @param {() => void} [props.actions.onSettings]
+ * @param {() => void} [props.actions.onContribute]
+ * @param {() => void} [props.actions.onReview]
+ * @param {(id: string) => void} [props.actions.onOpenTranscript]
+ * @param {(number: string) => void} [props.actions.onOpenPullRequest]
+ * @param {(diff: { add: string[], remove: string[] }) => void} [props.actions.onLinkRepos]
+ * @param {() => void} [props.actions.onShowMore] - shows the next transcripts; omit it and no button renders.
+ */
+export function CollectiveDetailView({ data, actions }?: {
+    data?: {
+        collective?: CollectiveData;
+        owners?: object[];
+        linkedRepos?: string[];
+        hrefFor?: HrefFor;
+    };
+    actions?: {
+        onSettings?: () => void;
+        onContribute?: () => void;
+        onReview?: () => void;
+        onOpenTranscript?: (id: string) => void;
+        onOpenPullRequest?: (number: string) => void;
+        onLinkRepos?: (diff: {
+            add: string[];
+            remove: string[];
+        }) => void;
+        onShowMore?: () => void;
+    };
+}): import("react").JSX.Element;
+/**
+ * A collective's settings, saved per field. The selects show the collective's own `mode`,
+ * `access` and `memberLeaves` values, or `not set` when the host does not give one. Each change
+ * calls `onCommit` with the field it writes (`mode`, `access`, `memberLeaves`, ...) and the value.
+ *
+ * @param {object} [props]
+ * @param {object} [props.data]
+ * @param {CollectiveData} [props.data.collective]
+ * @param {object[]} [props.data.owners] - RepoPicker owners, for linking repositories.
+ * @param {string[]} [props.data.linkedRepos]
+ * @param {boolean} [props.data.showOnPullRequests]
+ * @param {PolicyChoice[]} [props.data.whoCanPublish]
+ * @param {PolicyChoice[]} [props.data.whoCanRead]
+ * @param {PolicyChoice[]} [props.data.memberLeavesChoices] - defaults to the wire's `user_choice` and `mandatory`.
+ * @param {HrefFor} [props.data.hrefFor]
+ * @param {object} [props.actions]
+ * @param {(key: CollectiveSettingKey, value: unknown) => Promise<unknown>} [props.actions.onCommit] - the one write per change; reject to fail.
+ * @param {(handle: string) => void} [props.actions.onInvite]
+ * @param {(handle: string) => void} [props.actions.onRemoveMember]
+ * @param {(handle: string, role: string) => void} [props.actions.onRoleChange]
+ * @param {(diff: { add: string[], remove: string[] }) => void} [props.actions.onLinkRepos]
+ * @param {() => void} [props.actions.onTransferOwnership]
+ * @param {() => void} [props.actions.onDelete]
+ */
+export function CollectiveSettingsView({ data, actions }?: {
+    data?: {
+        collective?: CollectiveData;
+        owners?: object[];
+        linkedRepos?: string[];
+        showOnPullRequests?: boolean;
+        whoCanPublish?: PolicyChoice[];
+        whoCanRead?: PolicyChoice[];
+        memberLeavesChoices?: PolicyChoice[];
+        hrefFor?: HrefFor;
+    };
+    actions?: {
+        onCommit?: (key: CollectiveSettingKey, value: unknown) => Promise<unknown>;
+        onInvite?: (handle: string) => void;
+        onRemoveMember?: (handle: string) => void;
+        onRoleChange?: (handle: string, role: string) => void;
+        onLinkRepos?: (diff: {
+            add: string[];
+            remove: string[];
+        }) => void;
+        onTransferOwnership?: () => void;
+        onDelete?: () => void;
+    };
+}): import("react").JSX.Element;
+export type CollectiveData = {
+    id?: string;
+    /**
+     * - kept in its case.
+     */
+    name: string;
+    purpose?: string | null;
+    /**
+     * - the earlier name for `purpose`.
+     */
+    description?: string | null;
+    /**
+     * - the earlier name for `org.login`.
+     */
+    linkedGithubOrg?: string | null;
+    /**
+     * - the viewer's role; `owner` shows the settings button.
+     */
+    role?: string;
+    /**
+     * - the policy in words, for the collective page.
+     */
+    whoCanRead?: string;
+    /**
+     * - the policy in words, for the collective page.
+     */
+    whoCanPublish?: string;
+    /**
+     * - the viewer's role in words.
+     */
+    yourRole?: string;
+    /**
+     * - the join policy value, for settings (`open`, `verified_only`, `curated`).
+     */
+    mode?: string;
+    /**
+     * - the read policy value, for settings (`members_only`, `contributors`).
+     */
+    access?: string;
+    /**
+     * - what happens to a leaving member's transcripts, for settings.
+     */
+    memberLeaves?: string;
+    stats?: {
+        value: number | string;
+        label: string;
+    }[];
+    /**
+     * - every transcript, when `transcripts` holds one page of them.
+     */
+    transcriptCount?: number;
+    /**
+     * - null says nothing is linked; left out, the line is left out.
+     */
+    org?: {
+        login: string;
+        linked?: number;
+        total?: number;
+    } | null;
+    memberBreakdown?: string;
+    transcripts?: {
+        id: string;
+        title: string;
+        harness: string;
+        turns?: number;
+        author?: string;
+        pullRequests?: string[];
+        repo?: string | null;
+        when?: string;
+    }[];
+    members?: {
+        handle: string;
+        name?: string;
+        role: string;
+    }[];
+    memberCount?: number;
+};
+export type PolicyChoice = {
+    value: string;
+    /**
+     * - lowercase chrome.
+     */
+    label: string;
+    /**
+     * - one line on what the choice means.
+     */
+    help?: string;
+};
+export type CollectiveRow = {
+    id: string;
+    /**
+     * - kept in its case.
+     */
+    name: string;
+    /**
+     * - the viewer's role; empty when they only see the collective.
+     */
+    role?: string | null;
+    members?: number;
+    transcripts?: number | string;
+    /**
+     * - the linked github org; null says nothing is linked. Leave it
+     * undefined on every row and the github org column is left out.
+     */
+    org?: string | null;
+    /**
+     * - beside the org ("2 of 14 repos").
+     */
+    repos?: string | null;
+    /**
+     * - how members join: `open`, `verified_only` or `curated`.
+     */
+    mode?: string;
+    /**
+     * - a line under the name.
+     */
+    desc?: string | null;
+    /**
+     * - a line under the role ("member for 5mo").
+     */
+    since?: string | null;
+};
+export type HrefFor = (kind: "collectives" | "collective" | "transcript" | "pull-request" | "account", id?: string) => (string | undefined);
+/**
+ * The fields a settings change writes, passed to `onCommit` with the new value.
+ */
+export type CollectiveSettingKey = "name" | "purpose" | "mode" | "access" | "memberLeaves" | "showOnPullRequests";

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

@@ -31,4 +31,5 @@ export function Manage({ data, actions, demoRoleSwitcher, }?: {
     demoRoleSwitcher?: boolean;
 }): import("react").JSX.Element;
 export { PROVIDER_LABEL, formatProvider, providerLabel } from "./providers.js";
-export { PublishView, CollectivesView, CollectiveDetailView, CollectiveSettingsView, ContributeView } from "../../mockups/inuse/CommonsManage.jsx";
+export { PublishView, ContributeView } from "../../mockups/inuse/CommonsManage.jsx";
+export { CollectivesView, CollectiveDetailView, CollectiveSettingsView } from "./Collectives.jsx";

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

@@ -71,7 +71,7 @@ export type FlowGraph = import("../transcript/graph/engine/index.js").FlowGraph;
 export { default as CodeMap, codeMapPayloadToMapData } from "./CodeMap.jsx";
 export { default as CodeMapComposition, DefaultMapLegend } from "./CodeMapComposition.jsx";
 export { CODE_MAP_STATE_VERSION, CODE_MAP_VIEWPORT_SCALE, isCodeMapViewportScale, codeMapStatesEqual, createCodeMapState, reduceCodeMapState, deriveCodeMapView, deriveTimelineHighlight, resolveEscapeAction } from "./codeMapState.js";
-export { GraphAppShell, GraphSectionNav, GRAPH_APP_SECTIONS } from "../inuse/InUseShell.jsx";
+export { GraphAppShell, GraphSectionNav, LOCAL_APP_SECTIONS, GRAPH_APP_SECTIONS } from "../inuse/InUseShell.jsx";
 export { buildChangesGraph, humanizeAge } from "./changeGraph.js";
 export { DOI_WEIGHTS, DEBT_VIEWED, COVERAGE_CAP, RECENCY_HALF_LIFE_DAYS, RANK_FLOOR, RANK_CAP, SCENT_TAGS, debtState, debt, coverage, hunkClears, partialReadHoverText, debtHoverText, scentTagsFor, rankMapNodesIntrinsic, deriveRankedRows, rankMapNodes, gateRankedRows } from "./ranking.js";
 export { assertChangeDetailPayloadEnums, assertChangeDiffPayloadEnums, assertCodeMapPayloadEnums, MAP_NODE_KINDS, CHANGE_BINDINGS, EDGE_VIOLATION_KINDS, FILE_CHANGE_STATUSES, DIFF_LINE_KINDS } from "./types.js";

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

@@ -23,6 +23,10 @@ export { default as PromptDigest } from "./PromptDigest.jsx";
 export { default as ToolCallRenderer } from "./ToolRenderers.jsx";
 export { default as Tour } from "./Tour.jsx";
 export { default as FacetRail } from "./FacetRail.jsx";
+export { default as StatsStrip } from "./StatsStrip.jsx";
+export { default as CopyIconButton } from "./CopyIconButton.jsx";
+export { default as OverflowList } from "./OverflowList.jsx";
+export { default as RepoPicker } from "./RepoPicker.jsx";
 export * from "./transcript/index.js";
 export * from "./transcript/graph/index.js";
 export type TimelineNavigationAction = import("./graph/timelineNavigation.js").TimelineNavigationAction;
@@ -53,9 +57,11 @@ export { default as RailShell, RailSection, SplitRail } from "./RailShell.jsx";
 export { default as ProviderIcon, ProviderTag, ProviderName, AccentLegend, PROVIDER_ACCENT } from "./ProviderIcon.jsx";
 export { default as EvidenceCaption, EvidenceTarget } from "./EvidenceCaption.jsx";
 export { PhaseDivider, Phase, TaskBoundary, CheckpointMarker, TurnContextBar } from "./TranscriptMarkers.jsx";
-export { default as ConnectionPill, DataState, TeachingEmptyState } from "./ConnectionState.jsx";
+export { default as ConnectionPill, DataState, TeachingEmptyState, LocalOfflineBanner } from "./ConnectionState.jsx";
 export { default as SignInProviders, HandleClaim, OnboardingCard } from "./SignIn.jsx";
 export { default as CliSteps, CommandBlock, GettingStarted } from "./CliOnboard.jsx";
 export { StatTile, StatGrid, GovTile, ProviderBars } from "./StatTiles.jsx";
+export { PublishStateLabel, PublishBar, AccessList, CollectivePicker, PublishDialog, PUBLISH_STATES, PUBLISH_DIALOG_STATES } from "./Publish.jsx";
+export { SettingRow, SettingGroup, SETTING_ROW_STATES } from "./Settings.jsx";
 export { default as VisibilitySegmented, VisibilityEye, ScopeChip, FocusedModeToggle } from "./VisibilityControl.jsx";
-export { default as InUseShell, GraphAppShell, GraphSectionNav, IN_USE_APPS, GRAPH_APP_SECTIONS } from "./inuse/InUseShell.jsx";
+export { default as InUseShell, GraphAppShell, GraphSectionNav, IN_USE_APPS, LOCAL_APP_SECTIONS, GRAPH_APP_SECTIONS } from "./inuse/InUseShell.jsx";

package/dist/lib/types/inuse/InUseShell.d.ts

@@ -1,3 +1,4 @@
+export function navSectionsOf(sections: any): any;
 export default function InUseShell({ apps, defaultApp, activeApp, onAppChange, renderApp, brand, ariaLabel, }: {
     apps?: readonly {
         id: string;
@@ -11,24 +12,19 @@ export default function InUseShell({ apps, defaultApp, activeApp, onAppChange, r
     brand?: string;
     ariaLabel?: string;
 }): import("react").JSX.Element;
-export function GraphAppShell({ sections, activeId, activePrimaryId, onSectionChange, backTo, onBack, children, ariaLabel, }: {
-    sections?: readonly {
-        id: string;
-        label: string;
-    }[];
+export function GraphAppShell({ sections, activeId, activePrimaryId, onSectionChange, backTo, onBack, notice, children, ariaLabel, }: {
+    sections?: readonly Readonly<AppSection>[];
     activeId: any;
     activePrimaryId: any;
     onSectionChange: any;
     backTo: any;
     onBack: any;
+    notice?: any;
     children: any;
     ariaLabel?: string;
 }): import("react").JSX.Element;
 export function GraphSectionNav({ sections, activeId, hrefFor, LinkComponent, onSectionChange, className, itemClassName, activeItemClassName, activeMarker, ariaLabel, }: {
-    sections?: readonly {
-        id: string;
-        label: string;
-    }[];
+    sections?: readonly Readonly<AppSection>[];
     activeId?: any;
     hrefFor?: any;
     LinkComponent?: any;
@@ -44,7 +40,28 @@ export const IN_USE_APPS: readonly {
     mark: string;
     icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
 }[];
+/**
+ * One entry of a section list. `inNav: false` keeps a section out of the section navigation; an
+ * entry without `inNav` is listed. A consumer's own list may carry more fields (an `href`).
+ * @typedef {{ id: string, label: string, inNav?: boolean, title?: string }} AppSection
+ */
+/** @type {ReadonlyArray<Readonly<AppSection>>} */
+export const LOCAL_APP_SECTIONS: ReadonlyArray<Readonly<AppSection>>;
+/**
+ * @deprecated use LOCAL_APP_SECTIONS. The earlier three-section registry, kept with its original
+ * value so a consumer on the old shape keeps working until it re-pins.
+ */
 export const GRAPH_APP_SECTIONS: readonly {
     id: string;
     label: string;
 }[];
+/**
+ * One entry of a section list. `inNav: false` keeps a section out of the section navigation; an
+ * entry without `inNav` is listed. A consumer's own list may carry more fields (an `href`).
+ */
+export type AppSection = {
+    id: string;
+    label: string;
+    inNav?: boolean;
+    title?: string;
+};

package/dist/lib/types/match-query.d.ts

@@ -0,0 +1 @@
+export function matchesQuery(text: any, query: any): boolean;

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, 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, LinkComponent, renderTurnPanel, renderTurnActions, anchorHref, headerActions, streamPrelude, }: TranscriptViewerProps): import("react").JSX.Element;
+export default function TranscriptViewer({ viewModel, capabilities, callbacks, theme: themeProp, onThemeChange, graphSlot, activeTab: activeTabProp, onTabChange, viewMode: viewModeProp, onViewModeChange, 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, LinkComponent, renderTurnPanel, renderTurnActions, anchorHref, headerActions, streamPrelude, showTail, showOutcome, showSearchTrigger, pullRequests, }: TranscriptViewerProps): import("react").JSX.Element;
 export type TranscriptViewerProps = import("./state-capabilities.js").TranscriptViewerProps;
 export type TranscriptFilters = import("./state-capabilities.js").TranscriptFilters;
 export type TraceReadingSnapshot = {

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

@@ -218,6 +218,22 @@ export type TranscriptViewerProps = {
      * host controls or context rendered at the start of the list-mode transcript scroller; omitted in graph mode
      */
     streamPrelude?: unknown;
+    /**
+     * default true: render the composite's share and more menus after `headerActions`; false removes both so the host's own actions stand alone
+     */
+    showTail?: boolean;
+    /**
+     * default true: render the session outcome chip in the meta row when the session carries an outcome
+     */
+    showOutcome?: boolean;
+    /**
+     * default false: render a `search this transcript` button at the end of the tab strip that opens search exactly as ⌘F does; independent of `showTail`
+     */
+    showSearchTrigger?: boolean;
+    /**
+     * host-owned node rendered under the meta row (a pull request list and its own "show all" control); omitted renders nothing
+     */
+    pullRequests?: unknown;
 };
 /**
  * One breadcrumb segment. The last item renders as the current page (no link).