@retikz/core 0.3.0-alpha.5 → 0.3.0-beta.2

package/dist/lib/ir/scope.cjs

@@ -26,10 +26,13 @@ var NodeDefaultSchema = require_node.NodeSchema.omit({
 }).strict();
 /**
 * every path 默认样式 schema
-* @description 从 PathSchema 派生，排除 type / children / arrow / arrowDetail（arrow 走独立 arrowDefault 通道，免双入口）
+* @description 从 PathSchema 派生，排除实例专属字段（type / id / children）与 arrow / arrowDetail
+*   （arrow 走独立 arrowDefault 通道，免双入口）。id 是实例水合挂点，作默认会被 stamp 到 scope 内每条 path
+*   造成挂点冲突，故与 NodeDefault 一致排除。
 */
 var PathDefaultSchema = require_path.PathSchema.omit({
 	type: true,
+	id: true,
 	children: true,
 	arrow: true,
 	arrowDetail: true,
@@ -65,18 +68,18 @@ var __registerChildSchema = (schema) => {
 * Scope schema：容器 + 局部 transform + 样式默认挂点
 * @description 直接 `z.object` 让 ChildSchema discriminatedUnion 能识别 `type` 鉴别字段；
 * children 字段内部用 z.lazy 引用 ChildSchema 实现递归，避免直接 `z.lazy(() => z.object(...))` 让外层 union 拒识 type。
-* alpha.2 加：① 级联 graphic state（color + stroke / fill / strokeWidth / opacity / fillOpacity / drawOpacity）；
+* 支持：① 级联 graphic state（color + stroke / fill / strokeWidth / opacity / fillOpacity / drawOpacity）；
 * ② 四通道 every-X 默认（nodeDefault / pathDefault / labelDefault / arrowDefault）；③ resetStyle 继承屏障。
 */
 var ScopeSchema = zod.z.object({
 	type: zod.z.literal("scope").describe("Discriminator marking this child as a scope container."),
 	id: zod.z.string().min(1).optional().describe("Optional reference id; when set, the scope registers a synthetic rectangle bbox node in the **parent** namespace frame so paths / positions can target the scope as a whole. scope.id always registers in the parent frame, regardless of `localNamespace` (it is the external handle)."),
 	localNamespace: zod.z.boolean().optional().describe("When true, the scope creates a local namespace boundary — child node / coordinate / nested-scope ids registered inside do NOT propagate to the parent namespace; external lookups cannot see them. Default false (matches TikZ pgf default: child ids flow up to global). scope.id itself always registers in the parent frame regardless of this flag."),
-	transforms: zod.z.array(require_transform.TransformSchema).optional().describe("Local transforms applied to all scope children; array order = application order (first element applied innermost, matching Scene `GroupPrim.transforms` / SVG transform list). Supports 6 variants; the 4 translate variants are lowered to Cartesian translate at compile time."),
+	transforms: zod.z.array(require_transform.TransformSchema).optional().describe("Local transforms applied to all scope children; array order = application order (first element applied innermost, matching Scene `GroupPrim.transforms` / SVG transform list). Supports 7 variants; the 5 translate variants are lowered to Cartesian translate at compile time."),
 	color: zod.z.string().optional().describe("Cascading master color for all elements in this scope (TikZ scope `color=`). Stroke / fill / text of inner elements default to it unless individually overridden; cascades into edge labels and arrows."),
 	stroke: zod.z.string().optional().describe("Cascading default stroke color for inner nodes and paths; overrides the cascading master color for the stroke channel."),
 	fill: zod.z.union([zod.z.string(), require_paint.PaintSpecSchema]).optional().describe("Cascading default fill (CSS color or PaintSpec: gradient / pattern / image) for inner nodes and paths."),
-	strokeWidth: zod.z.number().optional().describe("Cascading default stroke width (user units) for inner nodes and paths."),
+	strokeWidth: zod.z.number().finite().nonnegative().optional().describe("Cascading default stroke width (user units) for inner nodes and paths."),
 	opacity: zod.z.number().min(0).max(1).optional().describe("Cascading default whole-element opacity 0..1. Replaces (does NOT compound across nested scopes — TikZ default)."),
 	fillOpacity: zod.z.number().min(0).max(1).optional().describe("Cascading default fill opacity 0..1 for inner nodes and paths."),
 	drawOpacity: zod.z.number().min(0).max(1).optional().describe("Cascading default stroke opacity 0..1 (TikZ `draw opacity`) for inner nodes and paths."),
@@ -91,14 +94,14 @@ var ScopeSchema = zod.z.object({
 		"arrow"
 	]))]).optional().describe("Inheritance barrier: drop the outer scope cascade + every-X defaults for the listed channels (or all when true), falling back to the built-in baseline. Only cuts the scope-inheritance axis; labels / arrows still follow their host path / node resolved color (structural relation, not scope inheritance)."),
 	zIndex: zod.z.number().int().finite().optional().describe("Explicit stacking order of this scope as a whole among its sibling IR children. Higher draws on top. Applies to the scope group as a single unit in the parent; does NOT affect how children stack inside the scope. Omitted = 0 = source order."),
-	clip: require_clip.ClipSpecSchema.optional().describe("Clip region (rect / circle / ellipse / polygon, in scope-local coords); when set, all children of this scope are clipped to it. Compiled into a renderer-agnostic ClipResource referenced via the group clipRef."),
+	clip: require_clip.ClipSpecSchema.optional().describe("Clip region (rect / circle / ellipse / polygon, in scope-local coords); when set, node children of this scope are clipped to it. Compiled into a renderer-agnostic ClipResource referenced via the group clipRef. Known limitation: a path child of a scope that ALSO has transforms is currently emitted at the top level (its geometry is already resolved to global coords) and is therefore NOT clipped by this region; tracked for the local-coordinate path-compile rework."),
 	meta: require_json.JsonObjectSchema.optional().describe("Opaque provenance metadata carried by this element (e.g. a Tier 2 lowering tagging which datum / series / layer it came from). Provenance passthrough: preserved verbatim into the Scene primitive(s) this element emits, ignored by renderers, and never interpreted by the compiler — it does not affect layout, connection, style, or bounding box. Must be a JSON object (fully serializable). Not inherited across scopes; not part of the every-X style defaults."),
-	animations: zod.z.array(require_animation.AnimationTrackSchema).optional().describe("Declarative timeline animation tracks for this scope as a whole (applied to its group). Each track animates one renderer-agnostic property over normalized time; the base value is the settled (animation-end) state. Carried verbatim into the emitted group primitive; renderers play them or render the static settled state with a diagnosable warning when unable. Does not affect layout / bounding box; not propagated to child elements; not part of the every-X style defaults."),
+	animations: zod.z.array(require_animation.AnimationTrackSchema).optional().describe("Declarative timeline animation tracks for this scope as a whole (applied to its group). Each track animates one renderer-agnostic property over normalized time; the base value is the settled (animation-end) state. Carried verbatim into the emitted group primitive; renderers play them or render the static settled state with a diagnosable warning when unable. Does not affect layout / bounding box; not propagated to child elements; not part of the every-X style defaults. Known limitation: same as clip — path children of a scope that also has transforms are hoisted to the top level and do not receive these scope animations."),
 	children: zod.z.array(zod.z.lazy(() => {
 		if (!childSchemaRef) throw new Error("ScopeSchema: ChildSchema not registered yet; ensure scene.ts loaded");
 		return childSchemaRef;
 	})).describe("Scope children: nested nodes / paths / coordinates / scopes. Recursive via the parent ChildSchema (registered late to break the IRChild <-> IRScope cycle).")
-}).describe("Scope container: groups child IR elements, applies local transforms, and acts as a style-default anchor (cascading graphic state + every-X defaults + resetStyle barrier). Corresponds to TikZ `\\begin{scope}`.");
+}).strict().describe("Scope container: groups child IR elements, applies local transforms, and acts as a style-default anchor (cascading graphic state + every-X defaults + resetStyle barrier). Corresponds to TikZ `\\begin{scope}`.");
 //#endregion
 exports.ArrowDefaultSchema = ArrowDefaultSchema;
 exports.LabelDefaultSchema = LabelDefaultSchema;