@peasant-labs/fairtrade 0.0.41 → 0.0.43

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

@@ -63,8 +63,13 @@ export function AppPage({ children, as: Tag, className, ...rest }: AppPageProps)
  */
 /**
  * @typedef {Object} AppSidebarAccount
- * @property {string} handle   shown as @handle; its first letter fills the square avatar.
+ * @property {string} handle   shown after an at sign; its first letter fills the square avatar. (An at sign
+ *           opening a word here would start a JSDoc tag and drop every property after it from the types.)
  * @property {string} [href]   makes the account row a link.
+ * @property {string} [avatarUrl]  the person's picture in the avatar square, decorative (the handle sits beside
+ *           it); the initial shows instead while it is missing or when it fails to load.
+ * @property {import('./Menu.jsx').MenuItem[]} [items]  makes the account row its own menu (profile, settings, sign
+ *           out), drawn as the same flat row with no caret and opening above the footer. Takes precedence over href.
  */
 /**
  * @typedef {Object} AppSidebarProps
@@ -213,9 +218,24 @@ export type AppSidebarSearch = {
 };
 export type AppSidebarAccount = {
     /**
-     * shown as
+     * shown after an at sign; its first letter fills the square avatar. (An at sign
+     * opening a word here would start a JSDoc tag and drop every property after it from the types.)
      */
     handle: string;
+    /**
+     * makes the account row a link.
+     */
+    href?: string;
+    /**
+     * the person's picture in the avatar square, decorative (the handle sits beside
+     * it); the initial shows instead while it is missing or when it fails to load.
+     */
+    avatarUrl?: string;
+    /**
+     * makes the account row its own menu (profile, settings, sign
+     * out), drawn as the same flat row with no caret and opening above the footer. Takes precedence over href.
+     */
+    items?: import("./Menu.jsx").MenuItem[];
 };
 export type AppSidebarProps = {
     /**

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

@@ -21,8 +21,12 @@
  * @param {React.ComponentType<any>} [props.icon]   icon-only trigger: the glyph replaces the label and the caret
  * @param {string} [props.ariaLabel]               the trigger's accessible name; required with `icon`, and the menu's name
  * @param {'sm'|'md'} [props.size='md']             `sm` uses the compact control height (header rows)
+ * @param {'bottom'|'top'} [props.side='bottom']    which side of the trigger the popout opens on; `top` for a
+ *        trigger at the foot of a column (a sidebar's account row)
+ * @param {string} [props.triggerClassName]         a host-drawn trigger: these classes replace the button's own,
+ *        and the caret is left out, so a row can be its own menu trigger
  */
-export default function Menu({ label, items, align, caption, defaultOpen, icon: TriggerIcon, ariaLabel, size }: {
+export default function Menu({ label, items, align, caption, defaultOpen, icon: TriggerIcon, ariaLabel, size, side, triggerClassName }: {
     label?: React.ReactNode;
     items?: MenuItem[];
     align?: "start" | "end";
@@ -31,6 +35,8 @@ export default function Menu({ label, items, align, caption, defaultOpen, icon:
     icon?: React.ComponentType<any>;
     ariaLabel?: string;
     size?: "sm" | "md";
+    side?: "bottom" | "top";
+    triggerClassName?: string;
 }): import("react").JSX.Element;
 export type MenuItem = {
     /**

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, }: ExploreSurfaceProps): import("react").JSX.Element;
+export default function Explore({ data, className, 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

@@ -95,6 +95,12 @@ export type ExploreSurfaceProps = {
     transcriptHref?: (transcript: ExploreTranscriptPayload) => string;
     profileHref?: (owner: ExploreOwnerPayload) => string;
     collectiveHref?: (collective: CollectiveResultPayload) => string;
+    /**
+     * 2 by default: the page title ("explore transcripts", a transcript's title, a
+     * profile's name) is an h2 in a host page. 1 when the host mounts Explore as the whole page: that title is
+     * the page's h1 and every heading under it moves up one level.
+     */
+    headingLevel?: 1 | 2;
 };
 /**
  * The AUTHENTICATED VIEWER's role in a collective — a CollectiveRole, OR the

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

@@ -53,8 +53,10 @@
  * @param {import('./codeMapState.js').CodeMapState} [props.state] canonical controlled state
  * @param {Partial<import('./codeMapState.js').CodeMapState>} [props.defaultState] initial canonical uncontrolled state
  * @param {(state:import('./codeMapState.js').CodeMapState)=>void} [props.onStateChange]
+ * @param {'measured'|'unknown'} [props.lineCounts='measured'] passed to the navigator: 'unknown' leaves out every row's
+ *        "N lines" figure when the host knows the payload's line counts were not measured
  */
-export default function CodeMapComposition({ payload, zoom, onZoomChange, selectedId, onSelect, onExpand, highlightedIds, nodeDeltas, structureEdgeDeltas, height, ariaLabel, canvasSlot, rail, toolbar, sheetTitle, sheetMeta, railSide, legend, canvasWrapperClassName, canvasWrapperStyle, className, presentation, navigatorSlot, onPresentationChange, viewport, onViewportChange, state, defaultState, onStateChange, }: {
+export default function CodeMapComposition({ payload, zoom, onZoomChange, selectedId, onSelect, onExpand, highlightedIds, nodeDeltas, structureEdgeDeltas, height, ariaLabel, canvasSlot, rail, toolbar, sheetTitle, sheetMeta, railSide, legend, canvasWrapperClassName, canvasWrapperStyle, className, presentation, navigatorSlot, onPresentationChange, viewport, onViewportChange, state, defaultState, onStateChange, lineCounts, }: {
     payload?: import("./types.js").CodeMapPayload;
     zoom?: {
         level: "project" | "package" | "file";
@@ -98,6 +100,7 @@ export default function CodeMapComposition({ payload, zoom, onZoomChange, select
     state?: import("./codeMapState.js").CodeMapState;
     defaultState?: Partial<import("./codeMapState.js").CodeMapState>;
     onStateChange?: (state: import("./codeMapState.js").CodeMapState) => void;
+    lineCounts?: "measured" | "unknown";
 }): import("react").JSX.Element;
 /**
  * The persistent legend explaining the canvas's four orthogonal visual channels

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

@@ -17,8 +17,11 @@
  * @param {(id:string)=>void} [props.onOpenMap]
  * @param {(action:import('./codeMapState.js').CodeMapAction)=>void} [props.onStateAction]
  * @param {string} [props.ariaLabel='code map navigator']
+ * @param {'measured'|'unknown'} [props.lineCounts='measured'] whether the payload's line counts were measured.
+ *        'unknown' (the host could not read the project's languages, so every loc is an unmeasured 0) leaves the
+ *        "N lines" figure out of every row instead of stating a false 0; a measured 0 still reads "0 lines".
  */
-export default function CodeMapNavigator({ payload, grain, expandedIds, onExpandedIdsChange, selectedId, onSelect, focusedId, onFocusChange, filter, onFilterChange, onOpenMap, onStateAction, ariaLabel, }: {
+export default function CodeMapNavigator({ payload, grain, expandedIds, onExpandedIdsChange, selectedId, onSelect, focusedId, onFocusChange, filter, onFilterChange, onOpenMap, onStateAction, ariaLabel, lineCounts, }: {
     payload: import("./types.js").CodeMapPayload;
     grain?: "project" | "package" | "file";
     expandedIds?: Iterable<string>;
@@ -32,4 +35,5 @@ export default function CodeMapNavigator({ payload, grain, expandedIds, onExpand
     onOpenMap?: (id: string) => void;
     onStateAction?: (action: import("./codeMapState.js").CodeMapAction) => void;
     ariaLabel?: string;
+    lineCounts?: "measured" | "unknown";
 }): import("react").JSX.Element;

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

@@ -80,7 +80,7 @@ export function deriveCodeMapView(payload: import("./types.js").CodeMapPayload |
  * @property {CodeMapRankMode} rankMode - ranked-entry-list scoring mode.
  * @property {string|null} scentFilter - one `SCENT_TAGS` member, or null for no filter.
  */
-/** @typedef {{node:import('./types.js').MapNodePayload, depth:number, parentId:string|null, childIds:string[], hasChildren:boolean, canExpand:boolean, forcedOpen:boolean, expanded:boolean}} CodeMapNavigatorRow */
+/** @typedef {{node:import('./types.js').MapNodePayload, depth:number, parentId:string|null, childIds:string[], hasChildren:boolean, canExpand:boolean, forcedOpen:boolean, openByGrain:boolean, expanded:boolean}} CodeMapNavigatorRow */
 /** @typedef {{orderedIds:string[], rootIds:string[], childIdsByParent:Record<string,string[]>, depthById:Record<string,number>}} CodeMapHierarchy */
 /** @typedef {{allNodes:import('./types.js').MapNodePayload[], nodes:import('./types.js').MapNodePayload[], visibleIds:string[], selectedId:string|null, grain:CodeMapGrain, expandedIds:string[], viewport:CodeMapViewport|null, hierarchy:CodeMapHierarchy}} CodeMapCanvasView */
 /** @typedef {{state:CodeMapState, rows:CodeMapNavigatorRow[], focusedId:string|null, selected:import('./types.js').MapNodePayload|null, staleSelectedId:string|null, canvas:CodeMapCanvasView}} CodeMapView */
@@ -212,6 +212,7 @@ export type CodeMapNavigatorRow = {
     hasChildren: boolean;
     canExpand: boolean;
     forcedOpen: boolean;
+    openByGrain: boolean;
     expanded: boolean;
 };
 export type CodeMapHierarchy = {

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

@@ -0,0 +1,15 @@
+/**
+ * @param {unknown} level - the composite's `headingLevel` prop.
+ * @param {string} component - the composite's name, for the error.
+ * @returns {1|2}
+ */
+export function pageHeadingLevel(level: unknown, component: string): 1 | 2;
+/**
+ * The tag for a heading drawn `depth` levels under the composite's title (0 is the title itself).
+ * @param {1|2} pageLevel
+ * @param {number} depth
+ * @returns {'h1'|'h2'|'h3'|'h4'|'h5'|'h6'}
+ */
+export function headingTag(pageLevel: 1 | 2, depth: number): "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+/** The page-title levels a composite accepts. */
+export const PAGE_HEADING_LEVELS: readonly number[];

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, showTail, showOutcome, showSearchTrigger, pullRequests, }: 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, headingLevel, }: 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/TurnCard.d.ts

@@ -13,8 +13,10 @@
  * @param {boolean} [props.compact]
  * @param {boolean} [props.expandAll]
  * @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
  */
-export default function TurnCard({ turn, active, openTools, toggleTool, onCopyAnchor, copied, registerRef, onLabel, renderActions, savedLabel, compact, expandAll, revealRequest, }: {
+export default function TurnCard({ turn, active, openTools, toggleTool, onCopyAnchor, copied, registerRef, onLabel, renderActions, savedLabel, compact, expandAll, revealRequest, headingLevel, }: {
     turn?: TurnVM;
     active?: boolean;
     openTools?: Record<string, boolean>;
@@ -31,5 +33,6 @@ export default function TurnCard({ turn, active, openTools, toggleTool, onCopyAn
     compact?: boolean;
     expandAll?: boolean;
     revealRequest?: number;
+    headingLevel?: number;
 }): import("react").JSX.Element;
 export type TurnVM = import("./view-model.js").TurnVM;

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

@@ -230,6 +230,10 @@ export type TranscriptViewerProps = {
      * 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;
+    /**
+     * default 2: the transcript's title is an h2 in a host page; 1 when the host mounts the viewer as the whole page, so the title is the page's h1 and the phase and turn headings move up one level
+     */
+    headingLevel?: 1 | 2;
     /**
      * host-owned node rendered under the meta row (a pull request list and its own "show all" control); omitted renders nothing
      */