uhuu-components 0.2.81 → 0.2.82

package/index.d.ts

@@ -50,6 +50,8 @@ export interface StaticFlowUnplaceableItem {
   headerHeight: number;
   requiredHeight: number;
   availableHeight: number;
+  /** Present when the item belongs to a FlowColumns track. */
+  columnId?: string;
   groupKey?: string;
   reason: "item-too-tall" | "item-with-header-too-tall";
 }
@@ -68,12 +70,34 @@ export interface StaticFlowGroupHeaderFragment {
 }
 
 export interface StaticFlowChunk {
+  /** Flattened visual reading order for this page; `layout` preserves parallel track identity. */
   indexes: number[];
   keys: string[];
+  /** Track-local source predecessor for the first item in this continuation fragment. */
+  previousSourceIndex?: number;
   groupHeaders?: StaticFlowGroupHeaderFragment[];
   unplaceable?: StaticFlowUnplaceableItem;
+  layout?: StaticFlowLayoutFragment[];
 }
 
+export interface StaticFlowColumn {
+  id: string;
+  indexes: number[];
+}
+
+export type StaticFlowLayoutNode =
+  | { kind: "item"; index: number }
+  | { kind: "columns"; id: string; columns: StaticFlowColumn[] };
+
+export interface StaticFlowColumnFragment {
+  id: string;
+  chunk: StaticFlowChunk;
+}
+
+export type StaticFlowLayoutFragment =
+  | { kind: "items"; chunk: StaticFlowChunk }
+  | { kind: "columns"; id: string; columns: StaticFlowColumnFragment[] };
+
 export interface StaticFlowMeasurement {
   flowId: string;
   chunks: StaticFlowChunk[];
@@ -93,6 +117,13 @@ export interface StaticFlowPlanInput {
   onUnplaceableItem?: (item: StaticFlowUnplaceableItem) => void;
 }
 
+/** Input for `Static.planFlowColumnChunks`, using globally indexed leaf measurements. */
+export interface StaticFlowColumnPlanInput extends StaticFlowPlanInput {
+  nodes: StaticFlowLayoutNode[];
+  columnHeaderGroupHeights?: Record<string, Record<string, Record<string, number>>>;
+  columnHeaderGroupRepeats?: Record<string, Record<string, Record<string, boolean>>>;
+}
+
 export interface ImageBlockDialog {
   path: string;
   type: "image" | "satellite";
@@ -321,6 +352,41 @@ export interface StaticFlowProps<TItem = unknown> {
   ) => ReactNode;
 }
 
+export interface StaticFlowColumnsRenderContext {
+  /** Stable identity only: column geometry callbacks must be page-invariant. */
+  flowId: string;
+}
+
+export interface StaticFlowColumnsContainerProps {
+  className?: string;
+  /**
+   * Geometry must be identical in measurement and visible output. Vertical group/column margins,
+   * padding, borders, fixed/min/max heights, wrapping, and row-gap are unsupported; put measured
+   * vertical spacing on items instead.
+   */
+  style?: CSSProperties;
+}
+
+export interface StaticFlowColumnsProps<TItem = unknown> extends StaticFlowProps<TItem> {
+  /** One-level story layout. Recursive columns are intentionally unsupported. */
+  layout: StaticFlowLayoutNode[];
+  getColumnGroupProps?: (
+    node: Extract<StaticFlowLayoutNode, { kind: "columns" }>,
+    context: StaticFlowColumnsRenderContext
+  ) => StaticFlowColumnsContainerProps | undefined;
+  getColumnProps?: (
+    node: Extract<StaticFlowLayoutNode, { kind: "columns" }>,
+    column: StaticFlowColumn,
+    context: StaticFlowColumnsRenderContext
+  ) => StaticFlowColumnsContainerProps | undefined;
+  getColumnItemProps?: (
+    node: Extract<StaticFlowLayoutNode, { kind: "columns" }>,
+    column: StaticFlowColumn,
+    itemIndex: number,
+    context: StaticFlowColumnsRenderContext
+  ) => StaticFlowColumnsContainerProps | undefined;
+}
+
 export type HtmlFlowItem = {
   id: string;
   type: string;
@@ -354,7 +420,9 @@ export const Static: {
   FlowArea: ComponentType<StaticFlowAreaProps>;
   FlowPage: ComponentType<StaticFlowPageProps>;
   Flow: <TItem = unknown>(props: StaticFlowProps<TItem>) => ReactElement | null;
+  FlowColumns: <TItem = unknown>(props: StaticFlowColumnsProps<TItem>) => ReactElement | null;
   planFlowChunks: (input?: StaticFlowPlanInput) => StaticFlowChunk[];
+  planFlowColumnChunks: (input?: StaticFlowColumnPlanInput) => StaticFlowChunk[];
   FlowDocument: ComponentType<StaticFlowDocumentProps>;
   markdownToFlowItems: (
     markdown?: string,

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.81",
+  "version": "0.2.82",
   "name": "uhuu-components",
   "main": "uhuu-components.umd.cjs",
   "module": "uhuu-components.es.js",