@retikz/core 0.2.0-alpha.2 → 0.2.0-alpha.4

package/dist/lib/shapes/diamond.cjs

@@ -0,0 +1,65 @@
+const require__shared = require("./_shared.cjs");
+const require_diamond = require("../geometry/diamond.cjs");
+//#region src/shapes/diamond.ts
+/** 外接框 Rect → Diamond（halfA/halfB = 半宽/半高；顶点在 ±halfA / ±halfB） */
+var toDiamond = (r) => ({
+	x: r.x,
+	y: r.y,
+	halfA: r.width / 2,
+	halfB: r.height / 2,
+	rotate: r.rotate
+});
+/**
+* diamond 注册项
+* @description circumscribe = 内框 ×2（内框 4 顶点落在菱形 4 边上）；几何由外接框半轴派生；
+*   emit 在**轴对齐空间**取 4 顶点出 PathPrim（rotate 由外层 group 施加），与旧 `emitDiamondShape(unrotated(...))` 等价
+*/
+var diamond = {
+	circumscribe: (hw, hh) => ({
+		halfWidth: hw * 2,
+		halfHeight: hh * 2
+	}),
+	boundaryPoint: (r, toward) => require_diamond.diamond.boundaryPoint(toDiamond(r), toward),
+	anchor: (r, name) => {
+		const a = require__shared.asRectAnchor(name);
+		return a ? require_diamond.diamond.anchor(toDiamond(r), a) : void 0;
+	},
+	*emit(r, style, round) {
+		const d = toDiamond(r);
+		const e = require_diamond.diamond.anchor(d, "east");
+		const n = require_diamond.diamond.anchor(d, "north");
+		const w = require_diamond.diamond.anchor(d, "west");
+		const s = require_diamond.diamond.anchor(d, "south");
+		yield {
+			type: "path",
+			commands: [
+				{
+					kind: "move",
+					to: [round(e[0]), round(e[1])]
+				},
+				{
+					kind: "line",
+					to: [round(n[0]), round(n[1])]
+				},
+				{
+					kind: "line",
+					to: [round(w[0]), round(w[1])]
+				},
+				{
+					kind: "line",
+					to: [round(s[0]), round(s[1])]
+				},
+				{ kind: "close" }
+			],
+			fill: style.fill ?? "transparent",
+			fillOpacity: style.fillOpacity,
+			stroke: style.stroke ?? "currentColor",
+			strokeOpacity: style.strokeOpacity,
+			strokeWidth: style.strokeWidth ?? 1,
+			dashPattern: style.dashPattern,
+			opacity: style.opacity
+		};
+	}
+};
+//#endregion
+exports.diamond = diamond;

package/dist/lib/shapes/diamond.d.ts

@@ -0,0 +1,8 @@
+import { ShapeDefinition } from './types';
+/**
+ * diamond 注册项
+ * @description circumscribe = 内框 ×2（内框 4 顶点落在菱形 4 边上）；几何由外接框半轴派生；
+ *   emit 在**轴对齐空间**取 4 顶点出 PathPrim（rotate 由外层 group 施加），与旧 `emitDiamondShape(unrotated(...))` 等价
+ */
+export declare const diamond: ShapeDefinition;
+//# sourceMappingURL=diamond.d.ts.map

package/dist/lib/shapes/diamond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/shapes/diamond.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAW/C;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,eA+BrB,CAAC"}

package/dist/lib/shapes/ellipse.cjs

@@ -0,0 +1,45 @@
+const require_ellipse = require("../geometry/ellipse.cjs");
+const require__shared = require("./_shared.cjs");
+//#region src/shapes/ellipse.ts
+/** 外接框 Rect → Ellipse（rx/ry = 半宽/半高） */
+var toEllipse = (r) => ({
+	x: r.x,
+	y: r.y,
+	rx: r.width / 2,
+	ry: r.height / 2,
+	rotate: r.rotate
+});
+/**
+* ellipse 注册项
+* @description circumscribe = 内框 ×√2（内框 4 顶点落在椭圆周上）；几何由外接框半轴派生；
+*   emit 出 EllipsePrim，与旧 `emitEllipseShape` 逐字段等价
+*/
+var ellipse = {
+	circumscribe: (hw, hh) => ({
+		halfWidth: hw * Math.SQRT2,
+		halfHeight: hh * Math.SQRT2
+	}),
+	boundaryPoint: (r, toward) => require_ellipse.ellipse.boundaryPoint(toEllipse(r), toward),
+	anchor: (r, name) => {
+		const a = require__shared.asRectAnchor(name);
+		return a ? require_ellipse.ellipse.anchor(toEllipse(r), a) : void 0;
+	},
+	*emit(r, style, round) {
+		yield {
+			type: "ellipse",
+			cx: round(r.x),
+			cy: round(r.y),
+			rx: round(r.width / 2),
+			ry: round(r.height / 2),
+			fill: style.fill ?? "transparent",
+			fillOpacity: style.fillOpacity,
+			stroke: style.stroke ?? "currentColor",
+			strokeOpacity: style.strokeOpacity,
+			strokeWidth: style.strokeWidth ?? 1,
+			dashPattern: style.dashPattern,
+			opacity: style.opacity
+		};
+	}
+};
+//#endregion
+exports.ellipse = ellipse;

package/dist/lib/shapes/ellipse.d.ts

@@ -0,0 +1,8 @@
+import { ShapeDefinition } from './types';
+/**
+ * ellipse 注册项
+ * @description circumscribe = 内框 ×√2（内框 4 顶点落在椭圆周上）；几何由外接框半轴派生；
+ *   emit 出 EllipsePrim，与旧 `emitEllipseShape` 逐字段等价
+ */
+export declare const ellipse: ShapeDefinition;
+//# sourceMappingURL=ellipse.d.ts.map

package/dist/lib/shapes/ellipse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/shapes/ellipse.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAW/C;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,eAuBrB,CAAC"}

package/dist/lib/shapes/index.cjs

@@ -0,0 +1,14 @@
+require("../geometry/_transform.cjs");
+const require_ellipse = require("./ellipse.cjs");
+const require_circle = require("./circle.cjs");
+const require_diamond = require("./diamond.cjs");
+//#region src/shapes/index.ts
+/** 内置 4 shape 注册项；与 `CompileOptions.shapes` 合并时被同名注入覆盖 */
+var BUILTIN_SHAPES = {
+	rectangle: require("./rectangle.cjs").rectangle,
+	circle: require_circle.circle,
+	ellipse: require_ellipse.ellipse,
+	diamond: require_diamond.diamond
+};
+//#endregion
+exports.BUILTIN_SHAPES = BUILTIN_SHAPES;

package/dist/lib/shapes/index.d.ts

@@ -0,0 +1,14 @@
+import { BuiltinShapeName } from '../ir/node';
+import { circle } from './circle';
+import { diamond } from './diamond';
+import { ellipse } from './ellipse';
+import { rectangle } from './rectangle';
+import { ShapeDefinition } from './types';
+/** 内置 4 shape 注册项；与 `CompileOptions.shapes` 合并时被同名注入覆盖 */
+export declare const BUILTIN_SHAPES: Record<BuiltinShapeName, ShapeDefinition>;
+export { rectangle, circle, ellipse, diamond };
+export type { ShapeDefinition, ShapeStyle } from './types';
+export type { Rect } from '../geometry/rect';
+export type { Position } from '../geometry/point';
+export { worldToLocal, localToWorld } from '../geometry/_transform';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/shapes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shapes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAKpE,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE3D,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/shapes/rectangle.cjs

@@ -0,0 +1,40 @@
+const require_rect = require("../geometry/rect.cjs");
+const require__shared = require("./_shared.cjs");
+//#region src/shapes/rectangle.ts
+/**
+* rectangle 注册项
+* @description circumscribe = identity（视觉边界 = 内框）；boundaryPoint / anchor 直接走 rect 数学层；
+*   emit 出 RectPrim（圆角走 cornerRadius），与旧 `emitRectShape` 逐字段等价
+*/
+var rectangle = {
+	circumscribe: (hw, hh) => ({
+		halfWidth: hw,
+		halfHeight: hh
+	}),
+	boundaryPoint: (r, toward) => require_rect.rect.boundaryPoint(r, toward),
+	anchor: (r, name) => {
+		const a = require__shared.asRectAnchor(name);
+		return a ? require_rect.rect.anchor(r, a) : void 0;
+	},
+	*emit(r, style, round) {
+		const halfW = r.width / 2;
+		const halfH = r.height / 2;
+		yield {
+			type: "rect",
+			x: round(r.x - halfW),
+			y: round(r.y - halfH),
+			width: round(r.width),
+			height: round(r.height),
+			fill: style.fill ?? "transparent",
+			fillOpacity: style.fillOpacity,
+			stroke: style.stroke ?? "currentColor",
+			strokeOpacity: style.strokeOpacity,
+			strokeWidth: style.strokeWidth ?? 1,
+			dashPattern: style.dashPattern,
+			cornerRadius: style.roundedCorners,
+			opacity: style.opacity
+		};
+	}
+};
+//#endregion
+exports.rectangle = rectangle;

package/dist/lib/shapes/rectangle.d.ts

@@ -0,0 +1,8 @@
+import { ShapeDefinition } from './types';
+/**
+ * rectangle 注册项
+ * @description circumscribe = identity（视觉边界 = 内框）；boundaryPoint / anchor 直接走 rect 数学层；
+ *   emit 出 RectPrim（圆角走 cornerRadius），与旧 `emitRectShape` 逐字段等价
+ */
+export declare const rectangle: ShapeDefinition;
+//# sourceMappingURL=rectangle.d.ts.map

package/dist/lib/shapes/rectangle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangle.d.ts","sourceRoot":"","sources":["../../../src/shapes/rectangle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,eA0BvB,CAAC"}

package/dist/lib/shapes/types.d.ts

@@ -0,0 +1,44 @@
+import { Position } from '../geometry/point';
+import { Rect } from '../geometry/rect';
+import { ScenePrimitive } from '../primitive';
+/**
+ * emit 需要的视觉样式子集
+ * @description 从 NodeLayout 的样式字段收敛（不含几何 / 文本）；独立 type，不耦合内部 NodeLayout。
+ *   字段名与 NodeLayout 样式字段一致（单一词汇表）。
+ */
+export type ShapeStyle = {
+    fill?: string;
+    fillOpacity?: number;
+    stroke?: string;
+    strokeOpacity?: number;
+    strokeWidth?: number;
+    dashPattern?: Array<number>;
+    roundedCorners?: number;
+    opacity?: number;
+};
+/**
+ * 一个 shape 的可注册定义：外接 / 边界 / anchor / emit 四件事
+ * @description plain object（factory 友好：`createPolygonShape(6)` 这类普通函数返回它即可）；含函数、
+ *   **不进 IR**，走 `CompileOptions.shapes` 运行时注入。内置 4 shape 也是注册项（无内置特权）。
+ *
+ *   坐标语义两套，第三方最易写错：
+ *   - `boundaryPoint` / `anchor` 收**带 `rotate` 的 Rect**——用 re-export 的 `worldToLocal` / `localToWorld` 写局部系几何。
+ *   - `emit` 收**轴对齐 Rect（rotate=0）**——旋转由编译器在外层 `GroupPrim` 统一施加。
+ */
+export type ShapeDefinition = {
+    /**
+     * 外接：内容半轴（text + padding）→ 外接框半轴。
+     * @description rectangle: identity；circle: √(hw²+hh²) 两轴相等；ellipse: ×√2；diamond: ×2。
+     */
+    circumscribe: (innerHalfWidth: number, innerHalfHeight: number) => {
+        halfWidth: number;
+        halfHeight: number;
+    };
+    /** 中心 → toward 射线 ∩ 边界（rect 带 rotate）。 */
+    boundaryPoint: (rect: Rect, toward: Position) => Position;
+    /** 命名 anchor 世界坐标；shape 不认识的名字返回 `undefined`（调用方据此抛清晰错误）。 */
+    anchor: (rect: Rect, name: string) => Position | undefined;
+    /** 视觉 primitive，**轴对齐空间**（rotate 由编译器外层 GroupPrim 统一施加）。 */
+    emit: (rect: Rect, style: ShapeStyle, round: (n: number) => number) => Iterable<ScenePrimitive>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/shapes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shapes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,YAAY,EAAE,CACZ,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,KACpB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,0CAA0C;IAC1C,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,KAAK,QAAQ,CAAC;IAC1D,6DAA6D;IAC7D,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;IAC3D,4DAA4D;IAC5D,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAAK,QAAQ,CAAC,cAAc,CAAC,CAAC;CACjG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retikz/core",
-  "version": "0.2.0-alpha.2",
+  "version": "0.2.0-alpha.4",
   "description": "retikz v0.1 core: framework-agnostic IR, scene compiler, and pure parsers.",
   "type": "module",
   "author": "Pionpill",