drawnui-react 0.1.0-preview.11 → 0.1.0-preview.12

package/SKIPPED.md

@@ -62,7 +62,7 @@ DrawnUi name and semantics; nothing here is a redesign, only an omission.
 | Control | Status | Notes |
 |---|---|---|
 | `SkiaLayout` Absolute / Column / Row (+ `SkiaStack`, `SkiaRow`, `SkiaLayer`) | ported | `Spacing`, `Padding`, `Children`/`Views`, `AddSubView`/`RemoveSubView`/`InsertSubView`. |
-| `SkiaLayout` templated (Column only): `ItemsSource` (array), `ItemTemplate` (factory `() => SkiaControl`), `RecyclingTemplate` Enabled/Disabled, `MeasureItemsStrategy` `MeasureFirst` (uniform, O(1) for 100k items) / `MeasureAll`, `ChildrenFactory` (ViewsAdapter pool: `GetOrCreateViewForIndex`, `ReleaseViewAt`), `FirstVisibleIndex`/`LastVisibleIndex`, `DebugString`, `ApplyItemsSource`, `VirtualisationInflated`, `BindingContext`/`ContextIndex` on every control, `SkiaDynamicDrawnCell.SetContent` | ported | Cells realized/bound/arranged/drawn only for the visible viewport (+inflation) each frame. |
+| `SkiaLayout` templated (Column only): `ItemsSource` (array), `ItemTemplate` (factory `() => SkiaControl`), `RecyclingTemplate` Enabled/Disabled, `MeasureItemsStrategy` `MeasureAll` (default, per-item size) / `MeasureFirst` (explicit uniform, O(1) for 100k items), `ChildrenFactory` (ViewsAdapter pool: `GetOrCreateViewForIndex`, `ReleaseViewAt`), `FirstVisibleIndex`/`LastVisibleIndex`, `DebugString`, `ApplyItemsSource`, `VirtualisationInflated`, `BindingContext`/`ContextIndex` on every control, `SkiaDynamicDrawnCell.SetContent` | ported | Cells realized/bound/arranged/drawn only for the visible viewport (+inflation) each frame. |
 | `LoadMoreCommand` / `LoadMoreTopCommand` / `LoadMoreOffset` / `LoadMoreTopOffset` | ported | Callbacks instead of ICommand. Bottom fires once per content extent when within the offset of the end (or when the content underfills the viewport), re-arms when the content grows or the user moves away (>offset+100 pt, >2 s) — C# CheckNeedToLoadMore. Top arms only after the offset left the top edge, fires when it comes back. Not ported: opposite-direction cooldown (`IsOppositeLoadMoreBlocked`), `IInsideViewport.ShouldTriggerLoadMore`. |
 | Structure-preserving `ItemsSource` updates | ported (array diff) | C# listens to `ObservableCollection` Add/Insert; React apps replace the array, so the setter detects **append** (old is a prefix: measured heights kept, tail measured lazily) and **prepend** (old is a suffix: view indices shifted without rebinding, new head measured synchronously up to 200 items, `ItemsInsertedAtStart(px)` lets the `SkiaScroll` move its offset so visible rows stay put — C# head-insert rebase). and **reorder** (same items permuted, the C# `ObservableCollection.Move` case: contexts rebound, the index-keyed measured heights permuted with their items, nothing re-measured, extent and scroll offset unchanged). Any other change rebuilds the structure (heights re-measured, offset kept). Not ported: removals in place, `Replace`. |
 | Templated Row/Grid/Wrap, `Split`, `ItemTemplateSelector`, `ItemTemplatePoolSize`/`ReserveTemplates`, `UsePreparedViews`, `SkiaCachedStack`, measure memo | skipped | |

package/dist/controls/SkiaLayout.d.ts

@@ -8,7 +8,7 @@ import { SkiaGridStructure } from "./GridStructure";
  *
  * Templated mode (ItemsSource + ItemTemplate) is a Column only: cells are created through the ViewsAdapter for
  * the indexes inside the visible viewport (+ VirtualisationInflated), everything else is arithmetic —
- * MeasureFirst measures one cell and assumes uniform size, MeasureAll measures every item once.
+ * MeasureAll (default) measures every item once, MeasureFirst measures one cell and assumes uniform size.
  */
 export declare class SkiaLayout extends SkiaControl {
     /** Layout type. SkiaShape redeclares it as ShapeType (any shape value lays out as Absolute), like the C# hidden Type. */
@@ -33,6 +33,7 @@ export declare class SkiaLayout extends SkiaControl {
     DynamicColumns: boolean;
     /** Templated Grid: fill column-major (top to bottom, then next column) instead of row-major (C# Invert). */
     Invert: boolean;
+    /** Default MeasureAll (DrawnUi 1.10.6.20): every item keeps its own size; MeasureFirst is explicit uniform rows. */
     MeasureItemsStrategy: MeasuringStrategy;
     /** Realized views per item (Disabled) or a recycled pool for the visible range (Enabled). */
     readonly ChildrenFactory: ViewsAdapter;
@@ -41,7 +42,7 @@ export declare class SkiaLayout extends SkiaControl {
     private itemsSource?;
     private itemTemplate?;
     private structureDirty;
-    /** Per-item heights in pixels (MeasureAll) or a single uniform height (MeasureFirst). */
+    /** Per-item heights in pixels (MeasureAll, the default) or a single uniform height (MeasureFirst). */
     private itemHeights;
     private uniformHeight;
     private measuredWidthPx;

package/dist/controls/SkiaLayout.js

@@ -8,7 +8,7 @@ import { SkiaGridStructure } from "./GridStructure";
  *
  * Templated mode (ItemsSource + ItemTemplate) is a Column only: cells are created through the ViewsAdapter for
  * the indexes inside the visible viewport (+ VirtualisationInflated), everything else is arithmetic —
- * MeasureFirst measures one cell and assumes uniform size, MeasureAll measures every item once.
+ * MeasureAll (default) measures every item once, MeasureFirst measures one cell and assumes uniform size.
  */
 export class SkiaLayout extends SkiaControl {
     /** Layout type. SkiaShape redeclares it as ShapeType (any shape value lays out as Absolute), like the C# hidden Type. */
@@ -35,7 +35,8 @@ export class SkiaLayout extends SkiaControl {
     DynamicColumns = false;
     /** Templated Grid: fill column-major (top to bottom, then next column) instead of row-major (C# Invert). */
     Invert = false;
-    MeasureItemsStrategy = "MeasureFirst";
+    /** Default MeasureAll (DrawnUi 1.10.6.20): every item keeps its own size; MeasureFirst is explicit uniform rows. */
+    MeasureItemsStrategy = "MeasureAll";
     /** Realized views per item (Disabled) or a recycled pool for the visible range (Enabled). */
     ChildrenFactory = new ViewsAdapter(this);
     FirstVisibleIndex = -1;
@@ -43,7 +44,7 @@ export class SkiaLayout extends SkiaControl {
     itemsSource;
     itemTemplate;
     structureDirty = true;
-    /** Per-item heights in pixels (MeasureAll) or a single uniform height (MeasureFirst). */
+    /** Per-item heights in pixels (MeasureAll, the default) or a single uniform height (MeasureFirst). */
     itemHeights = [];
     uniformHeight = 0;
     measuredWidthPx = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drawnui-react",
-  "version": "0.1.0-preview.11",
+  "version": "0.1.0-preview.12",
   "description": "DrawnUi for React: the DrawnUi (.NET) drawn-UI engine in TypeScript on CanvasKit (Skia WASM). Same controls, same PascalCase API as DrawnUi.Net.",
   "license": "MIT",
   "author": "Nick Kovalsky (AppoMobi)",