@peasant-labs/fairtrade 0.0.42 → 0.0.43

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

@@ -63,8 +63,11 @@ 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.
  */
@@ -215,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/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/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
      */