uhuu-components 0.2.80 → 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";
@@ -191,6 +222,9 @@ export interface PrintConfig {
 
 export type PrintConfigMap = Record<string, PrintConfig>;
 
+/** Initial PageEditor zoom preference; fit modes follow layout until manually adjusted. */
+export type PageEditorDefaultZoomMode = "manual" | "fit-width" | "fit-height" | "fit-page";
+
 export interface PageEditorProps {
   templateConfig: Record<string, unknown>;
   payload?: Record<string, unknown>;
@@ -199,6 +233,7 @@ export interface PageEditorProps {
   pageOptions?: unknown[];
   pageFilter?: PageFilterConfig;
   printConfigs?: PrintConfigMap;
+  defaultZoomMode?: PageEditorDefaultZoomMode;
   onItemsChange?: (items: PageEditorItem[], state: PageEditorState) => void;
   onStateChange?: (state: PageEditorState) => void;
   renderOverlay?: (context: {
@@ -317,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;
@@ -350,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,11 +1,19 @@
 {
-  "version": "0.2.80",
+  "version": "0.2.82",
   "name": "uhuu-components",
-  "main": "uhuu-components.umd.js",
+  "main": "uhuu-components.umd.cjs",
   "module": "uhuu-components.es.js",
   "browser": "uhuu-components.es.js",
   "types": "index.d.ts",
   "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./uhuu-components.es.js",
+      "require": "./uhuu-components.umd.cjs",
+      "default": "./uhuu-components.es.js"
+    }
+  },
   "license": "https://uhuu.io/license",
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",