@retikz/core 0.2.0-alpha.8 → 0.2.0-alpha.9

package/dist/es/ir/path/step.js

@@ -1,7 +1,7 @@
 import { PositionSchema } from "../position/position.js";
+import { TargetSchema } from "./target.js";
 import { FontSchema } from "../font.js";
 import { JsonObjectSchema } from "../json.js";
-import { TargetSchema } from "./target.js";
 import { z } from "zod";
 //#region src/ir/path/step.ts
 /**

package/dist/es/ir/path/target.d.ts

@@ -104,7 +104,7 @@ export declare const TargetSchema: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNum
 }, {
     of: string | [number, number] | import('..').PolarPosition;
     offset: [number, number];
-}>]>;
+}>, z.ZodLazy<z.ZodType<import('..').IRBetweenPosition, z.ZodTypeDef, import('..').IRBetweenPosition>>]>;
 /** 路径端点：直接坐标 [x, y]、极坐标、节点 id 字符串、相对偏移对象 */
 export type IRTarget = z.infer<typeof TargetSchema>;
 /** 相对前一 step 终点的偏移；不更新 prevEnd（TikZ `(+x, +y)`） */

package/dist/es/ir/path/target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMpE,eAAO,MAAM,eAAe;;;;;;;;;IAiBsF,CAAC;AAEnH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASmE,CAAC;AAEjG,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;EAQ9B,CAAC;AAEJ,eAAO,MAAM,8BAA8B;;;;;;EAQxC,CAAC;AAEJ,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWtB,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEpD,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEpE,2CAA2C;AAC3C,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMpE,eAAO,MAAM,eAAe;;;;;;;;;IAiBsF,CAAC;AAEnH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASmE,CAAC;AAEjG,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;EAQ9B,CAAC;AAEJ,eAAO,MAAM,8BAA8B;;;;;;EAQxC,CAAC;AAEJ,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wGAatB,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEpD,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEpE,2CAA2C;AAC3C,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/es/ir/path/target.js

@@ -2,6 +2,7 @@ import { PositionSchema } from "../position/position.js";
 import { PolarPositionSchema } from "../position/polar-position.js";
 import { OffsetPositionSchema } from "../position/offset-position.js";
 import { RECT_ANCHORS } from "../../geometry/rect.js";
+import { BetweenPositionSchema } from "../position/between-position.js";
 import { z } from "zod";
 //#region src/ir/path/target.ts
 /** 9 个命名 anchor（复用 geometry/rect.ts，避免两套常量） */
@@ -32,7 +33,8 @@ var TargetSchema = z.union([
 	NodeTargetSchema,
 	RelativeTargetSchema,
 	RelativeAccumulateTargetSchema,
-	OffsetPositionSchema
-]).describe("Path endpoint: Cartesian [x, y], polar position, node target object ({ id, anchor?, offset? }), relative offset object ({ relative } / { relativeAccumulate }), or offset position ({ of, offset } mirroring TikZ `calc`) resolved at compile time. Node id string shorthand is React DSL only (parsed to a node target object before reaching the IR).");
+	OffsetPositionSchema,
+	z.lazy(() => BetweenPositionSchema)
+]).describe("Path endpoint: Cartesian [x, y], polar position, node target object ({ id, anchor?, offset? }), relative offset object ({ relative } / { relativeAccumulate }), offset position ({ of, offset } mirroring TikZ `calc`), or between position ({ between: [A, B], t } proportional point) — all resolved at compile time. Node id string shorthand is React DSL only (parsed to a node target object before reaching the IR).");
 //#endregion
 export { AnchorRefSchema, NodeTargetSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, TargetSchema };

package/dist/es/ir/position/between-position.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { PolarPosition } from '../../geometry/polar';
+import { IRNodeTarget } from '../path/target';
+import { IROffsetPosition } from './offset-position';
+import { IRPosition } from './position';
+/**
+ * 自包含端点类型（partway between 的端点）
+ * @description 笛卡尔 / 极坐标 / 节点引用 / offset 定位 / 嵌套 between；**明确排除** path-relative
+ *   （`{ relative }` / `{ relativeAccumulate }`——它们需要"上一段终点"游标，在两点之间取点的语境无意义）。
+ *   自包含让 between 端点不引 `TargetSchema`，避免 `Position` ↔ `Target` schema 成环。
+ */
+export type IRAbsoluteTarget = IRPosition | PolarPosition | IRNodeTarget | IROffsetPosition | IRBetweenPosition;
+/**
+ * 两端点之间按比例 t 取点（lerp）
+ * @description `between` 两端点为 `AbsoluteTarget`（可嵌套 between）；`t ∈ [0,1]`（外插推迟）。
+ *   compile 把两端点各 resolve 成世界坐标后 `lerpPoint(A, B, t)`。对应 TikZ `($(A)!t!(B)$)`。
+ */
+export type IRBetweenPosition = {
+    between: [IRAbsoluteTarget, IRAbsoluteTarget];
+    t: number;
+};
+/** AbsoluteTarget schema（z.lazy 自引用：between 可嵌套 between；NodeTarget 在 lazy thunk 内引用化解跨文件环） */
+export declare const AbsoluteTargetSchema: z.ZodType<IRAbsoluteTarget>;
+/** BetweenPosition schema：`{ between: [AbsoluteTarget, AbsoluteTarget], t: 0..1 }` */
+export declare const BetweenPositionSchema: z.ZodType<IRBetweenPosition>;
+//# sourceMappingURL=between-position.d.ts.map

package/dist/es/ir/position/between-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"between-position.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/between-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,YAAY,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IAC9C,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAQ5D,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAe9D,CAAC"}

package/dist/es/ir/position/between-position.js

@@ -0,0 +1,21 @@
+import { PositionSchema } from "./position.js";
+import { PolarPositionSchema } from "./polar-position.js";
+import { OffsetPositionSchema } from "./offset-position.js";
+import { NodeTargetSchema } from "../path/target.js";
+import { z } from "zod";
+//#region src/ir/position/between-position.ts
+/** AbsoluteTarget schema（z.lazy 自引用：between 可嵌套 between；NodeTarget 在 lazy thunk 内引用化解跨文件环） */
+var AbsoluteTargetSchema = z.lazy(() => z.union([
+	PositionSchema,
+	PolarPositionSchema,
+	NodeTargetSchema,
+	OffsetPositionSchema,
+	BetweenPositionSchema
+]));
+/** BetweenPosition schema：`{ between: [AbsoluteTarget, AbsoluteTarget], t: 0..1 }` */
+var BetweenPositionSchema = z.lazy(() => z.object({
+	between: z.tuple([AbsoluteTargetSchema, AbsoluteTargetSchema]).describe("Two endpoints (AbsoluteTarget each; path-relative excluded)"),
+	t: z.number().min(0).max(1).describe("Proportion along A→B, 0..1 (0 = A, 1 = B); extrapolation not supported")
+}).describe("Proportional point between two endpoints (TikZ `($(A)!t!(B)$)`); resolved to `lerp(A, B, t)` at compile time. Admitted into Node/Coordinate position and path Step.to."));
+//#endregion
+export { AbsoluteTargetSchema, BetweenPositionSchema };

package/dist/es/ir/position/index.d.ts

@@ -2,4 +2,5 @@ export * from './position';
 export * from './polar-position';
 export * from './at-position';
 export * from './offset-position';
+export * from './between-position';
 //# sourceMappingURL=index.d.ts.map

package/dist/es/ir/position/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/es/ir/scene.d.ts

@@ -14,18 +14,69 @@ export type IRChild = IRNode | IRPath | IRCoordinate | IRScope;
  * scope 内嵌 scope 无深度限制（与 polar/offset 嵌套规则一致）
  */
 export declare const ChildSchema: z.ZodType<IRChild>;
+/**
+ * 显式视框 schema（覆盖自动算的 layout 范围）
+ * @description 具名四字段（与 Scene.layout / SVG viewBox 同构）；width / height `.positive().finite()`、
+ *   x / y `.finite()` 守 Scene JSON 可序列化。设值时 compile 直接用它作 Scene.layout、忽略 padding。
+ */
+export declare const ViewBoxSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>;
+/** 显式视框 IR 类型 `{ x, y, width, height }` */
+export type IRViewBox = z.infer<typeof ViewBoxSchema>;
 export declare const SceneSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
     type: z.ZodLiteral<"scene">;
     children: z.ZodArray<z.ZodType<IRChild, z.ZodTypeDef, IRChild>, "many">;
+    viewBox: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     type: "scene";
     children: IRChild[];
     version: 1;
+    viewBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
 }, {
     type: "scene";
     children: IRChild[];
     version: 1;
+    viewBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
 }>;
 /** retikz IR 顶层 Scene——可序列化 JSON 形式的绘制描述 */
 export type IR = z.infer<typeof SceneSchema>;

package/dist/es/ir/scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/ir/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,KAAK,OAAO,EAAsC,MAAM,SAAS,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAM1C,CAAC;AAKF,eAAO,MAAM,WAAW;;;;;;;;;;;;EAkBrB,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAE7C,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,EAAG,CAAU,CAAC"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/ir/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,KAAK,OAAO,EAAsC,MAAM,SAAS,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAM1C,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EASvB,CAAC;AAEJ,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEtD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBrB,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAE7C,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,EAAG,CAAU,CAAC"}

package/dist/es/ir/scene.js

@@ -16,12 +16,24 @@ var ChildSchema = z.lazy(() => z.discriminatedUnion("type", [
 	ScopeSchema
 ]).describe("Top-level scene child: a node, a path, a coordinate placeholder, or a scope container; discriminator field is `type`"));
 __registerChildSchema(ChildSchema);
+/**
+* 显式视框 schema（覆盖自动算的 layout 范围）
+* @description 具名四字段（与 Scene.layout / SVG viewBox 同构）；width / height `.positive().finite()`、
+*   x / y `.finite()` 守 Scene JSON 可序列化。设值时 compile 直接用它作 Scene.layout、忽略 padding。
+*/
+var ViewBoxSchema = z.object({
+	x: z.number().finite().describe("ViewBox left-top x"),
+	y: z.number().finite().describe("ViewBox left-top y"),
+	width: z.number().finite().positive().describe("ViewBox width (> 0)"),
+	height: z.number().finite().positive().describe("ViewBox height (> 0)")
+}).describe("Explicit viewBox overriding the auto-computed layout range (fixed size / clipping / multi-figure alignment). When set, Scene.layout uses it directly and padding is ignored.");
 var SceneSchema = z.object({
 	version: z.literal(1).describe("IR major version number; bump only on breaking schema changes"),
 	type: z.literal("scene").describe("Discriminator marking this object as the root scene"),
-	children: z.array(ChildSchema).describe("Top-level children of the scene; nodes register ids that paths can reference")
+	children: z.array(ChildSchema).describe("Top-level children of the scene; nodes register ids that paths can reference"),
+	viewBox: ViewBoxSchema.optional().describe("Optional explicit viewBox; when set, Scene.layout uses it (ignoring padding) instead of the auto-computed bounding box. Omitted = automatic AABB + padding.")
 }).describe("Top-level retikz IR scene — the canonical, JSON-serializable representation of a drawing");
 /** IR 当前主版本号；只在 schema 出现破坏性变更时递增 */
 var CURRENT_IR_VERSION = 1;
 //#endregion
-export { CURRENT_IR_VERSION, ChildSchema, SceneSchema };
+export { CURRENT_IR_VERSION, ChildSchema, SceneSchema, ViewBoxSchema };