@svgsketch/core 1.4.0 → 1.5.0

package/dist/index.d.mts

@@ -1932,6 +1932,28 @@ interface SerializedShape {
          * rendering tree.
          */
         display?: 'none';
+        /**
+         * Passthrough inline CSS declarations the editor doesn't model as
+         * typed state. Holds CSS Custom Properties (`--foo`, CSS Variables 1
+         * §2 — scoped vars cascading to descendants via `var()` references)
+         * and vendor-prefixed CSS (`-inkscape-*`, `-webkit-*`, …) authored
+         * directly on the source element's `style="…"` attribute.
+         *
+         * Round-trip mechanism (`applyPresentationEntry` / `clearPresentationEntry`
+         * in `apps/editor/src/canvas/import-export/ie-shared.ts`):
+         *  - Custom properties live on `el.style` via `setProperty`; browsers
+         *    cascade them natively.
+         *  - Vendor prefixes live in an editor-internal
+         *    `data-svgsketch-vendor-css` attribute (CSSOM `setProperty` drops
+         *    unknown vendor names per CSSOM §6.3.6 step 1); export merges
+         *    them into the visible `style="…"` attribute on serialize.
+         *
+         * Editor-modeled CSS (`fill`, `stroke`, `font-*`, `mix-blend-mode`,
+         * `mask`, etc.) is captured into the dedicated typed slots above and
+         * does NOT appear in this map — keeps a single source of truth per
+         * declaration and avoids round-trip drift.
+         */
+        inlineStyle?: Record<string, string>;
         metadata?: Partial<ShapeMetadata>;
         /**
          * Shape-scoped `<script>` elements (SVG 2 §15.9 allows scripts as
@@ -2483,7 +2505,14 @@ interface SymbolLibraryDef extends LibraryDefBase {
  */
 interface MarkerLibraryDef extends LibraryDefBase {
     kind: 'marker';
-    viewBox: string;
+    /**
+     * SVG 2 §11.6: when omitted, marker contents render directly in the
+     * viewport coordinate system (scaled by markerUnits) rather than being
+     * mapped from viewBox space to the markerWidth × markerHeight viewport.
+     * Editor-authored markers always set this; imported markers preserve
+     * "no viewBox" when the source `<marker>` had none.
+     */
+    viewBox?: string;
     /** X reference point — where the marker's tip aligns with the host vertex. */
     refX: number;
     refY: number;
@@ -2499,6 +2528,12 @@ interface MarkerLibraryDef extends LibraryDefBase {
      * start marker; a number is a fixed rotation in degrees.
      */
     orient: 'auto' | 'auto-start-reverse' | number;
+    /**
+     * SVG 2 §11.6: `'visible'` allows content to render past the
+     * markerWidth × markerHeight viewport (default is `'hidden'`). Captured
+     * from the source `overflow` attr; emitted only when explicitly set.
+     */
+    overflow?: 'visible' | 'hidden';
     /**
      * Inner geometry (authoritative for user markers). Built-ins render from
      * the descriptor registry and carry `shapes: []`.
@@ -4599,8 +4634,18 @@ declare class View extends ShapeBuilder<View> {
     zoomAndPan(value: 'disable' | 'magnify'): View;
     /** SVG `viewTarget` attribute. */
     viewTarget(value: string): View;
-    /** Mark this view as the canonical "home" view of the document. */
-    asHome(value?: boolean): View;
+    /**
+     * No-op kept for backwards compatibility with existing call sites.
+     * The "home view" abstraction was retired — the document's framing
+     * is owned by the root `<svg>` element (via the SDK's `Document`
+     * width/height/viewBox), not by a `<view>` element flagged as
+     * "home." `<view>` is reserved for author-authored named viewports
+     * (SVG 2 §16.3.3).
+     *
+     * @deprecated v3 — pass `width`/`height`/`viewBox` to `Document`
+     *             instead. This shim will be removed in a future major.
+     */
+    asHome(_value?: boolean): View;
 }
 declare class NestedSvg extends ContainerShapeBuilder<NestedSvg> {
     constructor(x?: number, y?: number, width?: number, height?: number);

package/dist/index.d.ts

@@ -1932,6 +1932,28 @@ interface SerializedShape {
          * rendering tree.
          */
         display?: 'none';
+        /**
+         * Passthrough inline CSS declarations the editor doesn't model as
+         * typed state. Holds CSS Custom Properties (`--foo`, CSS Variables 1
+         * §2 — scoped vars cascading to descendants via `var()` references)
+         * and vendor-prefixed CSS (`-inkscape-*`, `-webkit-*`, …) authored
+         * directly on the source element's `style="…"` attribute.
+         *
+         * Round-trip mechanism (`applyPresentationEntry` / `clearPresentationEntry`
+         * in `apps/editor/src/canvas/import-export/ie-shared.ts`):
+         *  - Custom properties live on `el.style` via `setProperty`; browsers
+         *    cascade them natively.
+         *  - Vendor prefixes live in an editor-internal
+         *    `data-svgsketch-vendor-css` attribute (CSSOM `setProperty` drops
+         *    unknown vendor names per CSSOM §6.3.6 step 1); export merges
+         *    them into the visible `style="…"` attribute on serialize.
+         *
+         * Editor-modeled CSS (`fill`, `stroke`, `font-*`, `mix-blend-mode`,
+         * `mask`, etc.) is captured into the dedicated typed slots above and
+         * does NOT appear in this map — keeps a single source of truth per
+         * declaration and avoids round-trip drift.
+         */
+        inlineStyle?: Record<string, string>;
         metadata?: Partial<ShapeMetadata>;
         /**
          * Shape-scoped `<script>` elements (SVG 2 §15.9 allows scripts as
@@ -2483,7 +2505,14 @@ interface SymbolLibraryDef extends LibraryDefBase {
  */
 interface MarkerLibraryDef extends LibraryDefBase {
     kind: 'marker';
-    viewBox: string;
+    /**
+     * SVG 2 §11.6: when omitted, marker contents render directly in the
+     * viewport coordinate system (scaled by markerUnits) rather than being
+     * mapped from viewBox space to the markerWidth × markerHeight viewport.
+     * Editor-authored markers always set this; imported markers preserve
+     * "no viewBox" when the source `<marker>` had none.
+     */
+    viewBox?: string;
     /** X reference point — where the marker's tip aligns with the host vertex. */
     refX: number;
     refY: number;
@@ -2499,6 +2528,12 @@ interface MarkerLibraryDef extends LibraryDefBase {
      * start marker; a number is a fixed rotation in degrees.
      */
     orient: 'auto' | 'auto-start-reverse' | number;
+    /**
+     * SVG 2 §11.6: `'visible'` allows content to render past the
+     * markerWidth × markerHeight viewport (default is `'hidden'`). Captured
+     * from the source `overflow` attr; emitted only when explicitly set.
+     */
+    overflow?: 'visible' | 'hidden';
     /**
      * Inner geometry (authoritative for user markers). Built-ins render from
      * the descriptor registry and carry `shapes: []`.
@@ -4599,8 +4634,18 @@ declare class View extends ShapeBuilder<View> {
     zoomAndPan(value: 'disable' | 'magnify'): View;
     /** SVG `viewTarget` attribute. */
     viewTarget(value: string): View;
-    /** Mark this view as the canonical "home" view of the document. */
-    asHome(value?: boolean): View;
+    /**
+     * No-op kept for backwards compatibility with existing call sites.
+     * The "home view" abstraction was retired — the document's framing
+     * is owned by the root `<svg>` element (via the SDK's `Document`
+     * width/height/viewBox), not by a `<view>` element flagged as
+     * "home." `<view>` is reserved for author-authored named viewports
+     * (SVG 2 §16.3.3).
+     *
+     * @deprecated v3 — pass `width`/`height`/`viewBox` to `Document`
+     *             instead. This shim will be removed in a future major.
+     */
+    asHome(_value?: boolean): View;
 }
 declare class NestedSvg extends ContainerShapeBuilder<NestedSvg> {
     constructor(x?: number, y?: number, width?: number, height?: number);