uxml-preview 0.6.1 → 0.7.0

package/dist/known-divergences.d.ts

@@ -1,9 +1,9 @@
 /**
  * Differences from Unity that measurement has confirmed and that fixing the
- * renderer cannot close. `docs/accuracy.md` describes 16 divergent values;
+ * renderer cannot close. `docs/accuracy.md` describes 14 divergent values;
  * all but one class of them are listed below.
  *
- * The 1px cases (3 values) are excluded on purpose: they sit inside the
+ * The 1px cases (2 values) are excluded on purpose: they sit inside the
  * golden tests' own 0.5px-tighter-than-plan tolerance. That is a test
  * judgement parameter, not a rendering limitation — listing it here would
  * tell a host to worry about a difference the renderer did not actually make.

package/dist/layout/yoga.d.ts

@@ -1,5 +1,6 @@
 import { ElementNode, NodeId, Warning } from '../model/types';
 import { ComputedStyle, DeclarationLocator } from '../style/resolve';
+import { Theme } from '../controls/theme';
 import { FaceInfo } from '../render/measure';
 /**
  * Purpose:      load the Yoga WebAssembly module.
@@ -36,6 +37,8 @@ export interface TextContext {
 }
 export type MeasureText = (text: string, context: TextContext, availableWidth: number) => TextMetrics;
 export interface LayoutOptions {
+    /** Built-in theme; defaults to 'runtime'. */
+    theme?: Theme;
     fonts?: ReadonlyMap<ComputedStyle, {
         family: string;
         faceInfo?: FaceInfo;
@@ -68,8 +71,12 @@ export interface LayoutPart {
     name: string;
     /** The element whose control built it. */
     owner: NodeId;
+    /** Index in this owner’s laid-out parts, null for the owner itself. */
+    parent?: number | null;
+    /** Present for a measured text leaf; wrappers omit it. Text is entity-decoded. */
+    text?: string;
     box: LayoutBox;
-    /** Fixed styling, with `builtin-theme` provenance on every value. */
+    /** Cascade output, including inheritance, theme and author rules. */
     style: ComputedStyle;
 }
 export interface LayoutTree {
@@ -77,7 +84,7 @@ export interface LayoutTree {
     boxes: ReadonlyMap<NodeId, LayoutBox>;
     /**
      * Parts each element's control built, outermost first. The element's own
-     * children were laid out inside the last one.
+     * children were laid out inside the last wrapper; text parts are leading siblings.
      */
     parts: ReadonlyMap<NodeId, readonly LayoutPart[]>;
     /** Elements that were laid out, parents before children. */
@@ -92,7 +99,9 @@ export interface LayoutTree {
 /**
  * Purpose:      build a Yoga tree, compute layout, hand back boxes in panel
  *               coordinates.
- * Deps/Effects: creates Yoga nodes; the returned tree owns them until disposed.
+ * Deps/Effects: owns created Yoga nodes until returning the tree, which owns
+ *               them until disposed; on any failure frees all roots and rethrows.
+ *               Calls host measureText and appends measurement warnings.
  * Requires:     `loadLayoutEngine()` must have resolved.
  */
 export declare function layoutDocument(root: ElementNode, styles: ReadonlyMap<NodeId, ComputedStyle>, 

package/dist/render/fonts.d.ts

@@ -10,12 +10,13 @@ export type ResolveFont = (path: string, form: 'url' | 'resource') => string | R
  * Purpose:      resolve font assets for measurement and painting, applying Unity's
  *               documented but unmeasured -unity-font-definition precedence.
  * Deps/Effects: calls the host hook once per distinct (path, form) per invocation.
+ *               Element and part styles share the cache and declaration warnings.
  * Ensures:      filters only not-rendered property warnings for processed font
  *               declarations, keyed by property, source document and offset
  *               (or node when no offset exists). Unresolved assets replace those
  *               warnings with one asset-unresolved warning per declaration.
  */
-export declare function resolveFonts(styles: ReadonlyMap<NodeId, ComputedStyle>, warnings: readonly Warning[], locate: DeclarationLocator, resolve?: ResolveFont): {
+export declare function resolveFonts(styles: ReadonlyMap<NodeId, ComputedStyle>, warnings: readonly Warning[], locate: DeclarationLocator, resolve?: ResolveFont, partStyles?: ReadonlyMap<NodeId, ReadonlyMap<string, ComputedStyle>>): {
     fonts: Map<ComputedStyle, ResolvedFont>;
     warnings: Warning[];
 };

package/dist/render/measure.d.ts

@@ -6,8 +6,16 @@ export interface FaceInfo {
     lineHeight?: number;
 }
 export declare const EDITOR_DEFAULT_FACE_INFO: FaceInfo;
-export declare function textHeight(lines: number, fontSize: number, face: FaceInfo, paragraphBreaks?: number, paragraphSpacing?: number): number;
+export declare function textHeight(lines: number, fontSize: number, face: FaceInfo, paragraphBreaks?: number, paragraphSpacing?: number, generator?: 'standard' | 'advanced'): number;
 export declare function fontList(family?: string): string;
+/**
+ * Purpose:      share the canvas-derived host face between measurement and painting.
+ * Deps/Effects: probes current canvas font metrics on every call so asynchronously loaded
+ *               fonts are reflected; sets the supplied context's font or creates a canvas.
+ * Ensures:      missing canvas metrics retain the editor fallback.
+ */
+export declare function hostFontFace(doc: Document | undefined, family: string, fontStyle?: string, context?: CanvasRenderingContext2D | null): FaceInfo;
+export declare const CJK_BREAK: RegExp;
 /**
  * Purpose:      measure text with a canvas when one is available.
  * Deps/Effects: creates one offscreen canvas and reuses it.

package/dist/render/paint.d.ts

@@ -1,3 +1,4 @@
+import { Theme } from '../controls/theme';
 import { FaceInfo } from './measure';
 import { ElementNode, NodeId, Warning } from '../model/types';
 import { ComputedStyle } from '../style/resolve';
@@ -23,6 +24,8 @@ export interface PaintResult {
 }
 export interface PaintOptions extends CssMapOptions {
     document: Document;
+    checkedNodes?: ReadonlySet<NodeId>;
+    theme?: Theme;
     fonts?: ReadonlyMap<ComputedStyle, {
         family: string;
         faceInfo?: FaceInfo;

package/dist/style/resolve.d.ts

@@ -1,4 +1,5 @@
 import { ElementNode, NodeId, StyleOrigin, UxmlDocument, Warning } from '../model/types';
+import { Theme } from '../controls/theme';
 import { Specificity } from './specificity';
 export interface ComputedValue {
     /** `var()` already substituted. Otherwise exactly as the author wrote it. */
@@ -7,6 +8,8 @@ export interface ComputedValue {
 }
 export type ComputedStyle = ReadonlyMap<string, ComputedValue>;
 export interface ResolveOptions {
+    /** Built-in theme; defaults to 'runtime'. */
+    theme?: Theme;
     /**
      * Pseudo-classes to treat as active on every element, e.g. `new Set(['hover'])`.
      *
@@ -30,6 +33,8 @@ export interface ResolveOptions {
     states?: Readonly<Record<string, readonly string[]>>;
 }
 export interface ResolveResult {
+    /** @internal Resolved Checked bits shared by styling and the substitute check glyph. */
+    checkedNodes: ReadonlySet<NodeId>;
     /** @internal Element matches collected during this cascade, keyed by sheet and item. */
     matchedNodes: ReadonlyMap<string, readonly NodeId[]>;
     styles: ReadonlyMap<NodeId, ComputedStyle>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uxml-preview",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Render Unity UI Toolkit UXML/USS in a browser without the Unity Editor. Laid out by Yoga, the engine UI Toolkit uses; reference Unity 6.3 LTS, measured against real Unity. Byte-exact round trips.",
   "keywords": [
     "unity",
@@ -67,7 +67,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:roundtrip": "vitest run tests/roundtrip",
-    "test:text": "node tests/text-cohort/run.mjs && node tests/text-cohort/paint.mjs",
+    "test:text": "node tests/text-cohort/run.mjs && node tests/text-cohort/paint.mjs && node tests/text-cohort/paint-r15.mjs && node tests/text-cohort/measure-real.mjs",
     "test:golden": "vitest run tests/golden --passWithNoTests",
     "golden:emit": "node --experimental-strip-types --no-warnings scripts/emit-golden-cases.mjs",
     "template:emit": "node --experimental-strip-types --no-warnings scripts/emit-template-cases.mjs",