@graph-knowledge/api 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph-knowledge/api",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Headless Document API for Graph Knowledge - programmatic access to documents, nodes, and elements",
   "license": "MIT",
   "author": "Graph Knowledge Team",

package/src/index.d.ts

@@ -9,7 +9,7 @@ export type { IBatchOperations, BatchUpdateElementInput } from "./lib/interfaces
 export type { ITemplateOperations } from "./lib/interfaces/template-operations.interface";
 export type { IElementTypeValidator, IElementValidatorRegistry } from "./lib/interfaces/element-validator.interface";
 export type { CreateDocumentInput, UpdateDocumentInput, DocumentResult, CreateNodeInput, UpdateNodeInput, NodeResult, CreateTemplateInput } from "./lib/types/api-types";
-export type { BaseElementInput, RectangleInput, TextInput, ConnectorInput, ConnectorAnchor, LineStyle, MarkerType, UmlClassInput, UmlInterfaceInput, UmlComponentInput, UmlPackageInput, UmlArtifactInput, UmlNoteInput, TriangleInput, DiamondInput, HexagonInput, EllipseInput, LineInput, BlockArrowInput, BlockArrowDirection, CustomShapeInput, AnyElementInput, UpdateElementInput } from "./lib/types/element-input-types";
+export type { BaseElementInput, RectangleInput, TextInput, ConnectorInput, ConnectorAnchor, LineStyle, MarkerType, UmlClassInput, UmlInterfaceInput, UmlComponentInput, UmlPackageInput, UmlArtifactInput, UmlNoteInput, TriangleInput, DiamondInput, HexagonInput, EllipseInput, LineInput, BezierCurveInput, BlockArrowInput, BlockArrowDirection, CustomShapeInput, AnyElementInput, UpdateElementInput } from "./lib/types/element-input-types";
 export { GraphKnowledgeAPIError, AuthenticationError, NotFoundError, ValidationError, PermissionError } from "./lib/errors/api-errors";
 export type { Document, GraphNode, GraphElement } from "./lib/models";
 export { CURRENT_DOCUMENT_SCHEMA_VERSION } from "./lib/models";

package/src/lib/constants/element-defaults.js

@@ -20,6 +20,7 @@ exports.DEFAULT_ELEMENT_DIMENSIONS = {
     hexagon: { width: 120, height: 104 },
     ellipse: { width: 150, height: 100 },
     line: { width: 150, height: 0 },
+    "bezier-curve": { width: 150, height: 0 },
     "block-arrow": { width: 150, height: 80 }
 };
 /**

package/src/lib/types/element-input-types.d.ts

@@ -263,6 +263,34 @@ export interface LineInput extends BaseElementInput {
     /** Line style (reuses LineStyle from connectors) */
     lineStyle?: LineStyle;
 }
+/**
+ * Input for creating a cubic bezier curve element.
+ *
+ * The curve is defined by two endpoints and two control points:
+ * - Start point: (x, y)
+ * - End point: (x + width, y + height)
+ * - Control point 1: offset from start (controlPoint1X, controlPoint1Y)
+ * - Control point 2: offset from end (controlPoint2X, controlPoint2Y)
+ *
+ * If control points are omitted, a default S-curve is computed.
+ */
+export interface BezierCurveInput extends BaseElementInput {
+    type: "bezier-curve";
+    /** Stroke color (hex) */
+    strokeColor?: string;
+    /** Stroke width in pixels */
+    strokeWidth?: number;
+    /** Line style */
+    lineStyle?: LineStyle;
+    /** Control point 1 X offset from start */
+    controlPoint1X?: number;
+    /** Control point 1 Y offset from start */
+    controlPoint1Y?: number;
+    /** Control point 2 X offset from end */
+    controlPoint2X?: number;
+    /** Control point 2 Y offset from end */
+    controlPoint2Y?: number;
+}
 /**
  * Direction for block arrow elements.
  */
@@ -300,7 +328,7 @@ export interface CustomShapeInput extends BaseElementInput {
 /**
  * Union of all element input types.
  */
-export type AnyElementInput = RectangleInput | TextInput | ConnectorInput | UmlClassInput | UmlInterfaceInput | UmlComponentInput | UmlPackageInput | UmlArtifactInput | UmlNoteInput | TriangleInput | DiamondInput | HexagonInput | EllipseInput | LineInput | BlockArrowInput | CustomShapeInput;
+export type AnyElementInput = RectangleInput | TextInput | ConnectorInput | UmlClassInput | UmlInterfaceInput | UmlComponentInput | UmlPackageInput | UmlArtifactInput | UmlNoteInput | TriangleInput | DiamondInput | HexagonInput | EllipseInput | LineInput | BezierCurveInput | BlockArrowInput | CustomShapeInput;
 /**
  * Input for updating an existing element.
  */

package/src/lib/validators/element-type-validators/bezier-curve-validator.d.ts

@@ -0,0 +1,12 @@
+import { IElementTypeValidator } from "../../interfaces/element-validator.interface";
+import { AnyElementInput } from "../../types/element-input-types";
+import { BaseElementValidator } from "./base-element-validator";
+/**
+ * Validator for bezier curve elements.
+ */
+export declare class BezierCurveValidator extends BaseElementValidator implements IElementTypeValidator {
+    readonly elementType = "bezier-curve";
+    validate(input: AnyElementInput): void;
+    private validateLineStyle;
+    private validateNumber;
+}

package/src/lib/validators/element-type-validators/bezier-curve-validator.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BezierCurveValidator = void 0;
+const api_errors_1 = require("../../errors/api-errors");
+const base_element_validator_1 = require("./base-element-validator");
+/**
+ * Validator for bezier curve elements.
+ */
+class BezierCurveValidator extends base_element_validator_1.BaseElementValidator {
+    elementType = "bezier-curve";
+    validate(input) {
+        if (input.type !== "bezier-curve") {
+            throw new api_errors_1.ValidationError(`Expected type "bezier-curve", got "${input.type}"`, "type");
+        }
+        const curveInput = input;
+        // Validate common properties
+        this.validateCommon(curveInput);
+        // Validate stroke properties
+        this.validateColor(curveInput.strokeColor, "strokeColor");
+        this.validateStrokeWidth(curveInput.strokeWidth, "strokeWidth");
+        this.validateLineStyle(curveInput.lineStyle);
+        // Validate control point offsets (must be numbers if provided)
+        this.validateNumber(curveInput.controlPoint1X, "controlPoint1X");
+        this.validateNumber(curveInput.controlPoint1Y, "controlPoint1Y");
+        this.validateNumber(curveInput.controlPoint2X, "controlPoint2X");
+        this.validateNumber(curveInput.controlPoint2Y, "controlPoint2Y");
+    }
+    validateLineStyle(value) {
+        if (value === undefined)
+            return;
+        if (typeof value !== "string") {
+            throw new api_errors_1.ValidationError("lineStyle must be a string", "lineStyle");
+        }
+        const validStyles = ["solid", "dashed", "dotted"];
+        if (!validStyles.includes(value)) {
+            throw new api_errors_1.ValidationError(`lineStyle must be one of: ${validStyles.join(", ")}`, "lineStyle");
+        }
+    }
+    validateNumber(value, field) {
+        if (value === undefined)
+            return;
+        if (typeof value !== "number" || isNaN(value)) {
+            throw new api_errors_1.ValidationError(`${field} must be a valid number`, field);
+        }
+    }
+}
+exports.BezierCurveValidator = BezierCurveValidator;

package/src/lib/validators/element-validator-registry.js

@@ -8,6 +8,7 @@ const connector_validator_1 = require("./element-type-validators/connector-valid
 const uml_validators_1 = require("./element-type-validators/uml-validators");
 const basic_shape_validators_1 = require("./element-type-validators/basic-shape-validators");
 const line_validator_1 = require("./element-type-validators/line-validator");
+const bezier_curve_validator_1 = require("./element-type-validators/bezier-curve-validator");
 const block_arrow_validator_1 = require("./element-type-validators/block-arrow-validator");
 const custom_shape_validator_1 = require("./element-type-validators/custom-shape-validator");
 /**
@@ -39,6 +40,7 @@ class ElementValidatorRegistry {
         this.register(new basic_shape_validators_1.HexagonValidator());
         this.register(new basic_shape_validators_1.EllipseValidator());
         this.register(new line_validator_1.LineValidator());
+        this.register(new bezier_curve_validator_1.BezierCurveValidator());
         this.register(new block_arrow_validator_1.BlockArrowValidator());
     }
     register(validator) {