@glissade/scene 0.18.0-pre.1 → 0.18.0-pre.2

package/dist/layout.d.ts

@@ -55,7 +55,29 @@ declare class Layout extends Group {
   };
   protected draw(out: DisplayListBuilder, ctx: EvalContext): void;
 }
+/**
+ * Stack-ergonomic props — a more DISCOVERABLE surface over {@link LayoutProps}.
+ * Everything `Layout` accepts (id, position, opacity, width/height, gap,
+ * padding, justify, children, …) passes through unchanged; the only difference
+ * from constructing `Layout` directly is the defaulting `Stack()` applies.
+ */
+interface StackProps extends LayoutProps {}
+/**
+ * Thin convenience factory over the Yoga-backed {@link Layout} node — NOT a new
+ * class and NOT new signals, so a `Stack` inherits Layout's memoized, pure,
+ * dependency-tracked resolve verbatim: `Stack(props)` and the equivalent
+ * hand-written `Layout({...})` produce identical child positions.
+ *
+ * Stack-ergonomic defaults (the ONLY divergence from `Layout`):
+ * - `direction` defaults to `'column'` (the common vertical stack; Layout's own
+ *   default is `'row'`).
+ * - `align` defaults to `'start'` — a true left edge for a label column (the
+ *   dogfooding use case). This DIVERGES from `Layout`'s `'center'` default.
+ *
+ * Every other prop passes straight through to `Layout`.
+ */
+declare function Stack(props?: StackProps): Layout;
 /** Load Yoga (wasm) and register it as the active LayoutEngine. Idempotent. */
 declare function loadYogaLayoutEngine(): Promise<LayoutEngine>;
 //#endregion
-export { Layout, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, LayoutProps, type LayoutResult, getLayoutEngine, loadYogaLayoutEngine, setLayoutEngine };
+export { Layout, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, LayoutProps, type LayoutResult, Stack, StackProps, getLayoutEngine, loadYogaLayoutEngine, setLayoutEngine };

package/dist/layout.js

@@ -149,6 +149,27 @@ var Layout = class extends Group {
 		}
 	}
 };
+/**
+* Thin convenience factory over the Yoga-backed {@link Layout} node — NOT a new
+* class and NOT new signals, so a `Stack` inherits Layout's memoized, pure,
+* dependency-tracked resolve verbatim: `Stack(props)` and the equivalent
+* hand-written `Layout({...})` produce identical child positions.
+*
+* Stack-ergonomic defaults (the ONLY divergence from `Layout`):
+* - `direction` defaults to `'column'` (the common vertical stack; Layout's own
+*   default is `'row'`).
+* - `align` defaults to `'start'` — a true left edge for a label column (the
+*   dogfooding use case). This DIVERGES from `Layout`'s `'center'` default.
+*
+* Every other prop passes straight through to `Layout`.
+*/
+function Stack(props = {}) {
+	return new Layout({
+		...props,
+		direction: props.direction ?? "column",
+		align: props.align ?? "start"
+	});
+}
 function initProp(sig, init) {
 	if (typeof init === "function") sig.bindSource(init);
 	else if (init !== void 0) sig.set(init);
@@ -213,4 +234,4 @@ async function loadYogaLayoutEngine() {
 	return engine;
 }
 //#endregion
-export { Layout, LayoutEngineMissingError, getLayoutEngine, loadYogaLayoutEngine, setLayoutEngine };
+export { Layout, LayoutEngineMissingError, Stack, getLayoutEngine, loadYogaLayoutEngine, setLayoutEngine };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.18.0-pre.1",
+  "version": "0.18.0-pre.2",
   "description": "glissade scene graph: nodes, transforms, DisplayList emission. Renderer-agnostic; zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {
@@ -27,7 +27,7 @@
   ],
   "dependencies": {
     "yoga-layout": "^3.2.1",
-    "@glissade/core": "0.18.0-pre.1"
+    "@glissade/core": "0.18.0-pre.2"
   },
   "repository": {
     "type": "git",