@edv4h/usketch-plugin-mode7 0.2.0

package/dist/mode7-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode7-runtime.js","sourceRoot":"","sources":["../src/mode7-runtime.tsx"],"names":[],"mappings":"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"}

package/dist/mode7-service.d.ts

@@ -0,0 +1,50 @@
+import { type BoundingBox, type ServiceRegistry } from "@edv4h/usketch-shared";
+import type { Camera } from "./mode7-camera.js";
+import type { Look, Mode7Store } from "./mode7-store.js";
+export interface Mode7Api {
+    /** Whether the 3D view is currently on. */
+    isActive(): boolean;
+    enable(): void;
+    disable(): void;
+    toggle(): void;
+    /** The current camera geometry. */
+    getCamera(): Camera;
+    setPitch(deg: number): void;
+    setYaw(deg: number): void;
+    setFov(px: number): void;
+    setHorizon(fraction: number): void;
+    /** Nudge camera fields by deltas (re-clamped). */
+    adjust(delta: Partial<Camera>): void;
+    /** The current appearance (sky / fog). */
+    getLook(): Look;
+    setSky(color: string): void;
+    setFog(density: number): void;
+    setFogColor(color: string): void;
+    /** Restore the camera + look to the plugin's configured defaults. */
+    reset(): void;
+    /** The layer ids currently rendered in 3D. */
+    getTiltLayers(): readonly string[];
+    /** Replace the whole set of tilted layer ids. */
+    setTiltLayers(ids: readonly string[]): void;
+    /** Add/remove one layer id from the tilted set. */
+    toggleTiltLayer(id: string): void;
+    /** Ground draw distance in canvas (world) units (`0` = unlimited). */
+    getDrawDistance(): number;
+    /** Set the ground draw distance in canvas units (`0` = unlimited; hides content beyond). */
+    setDrawDistance(distance: number): void;
+    /** Whether the flat-mode capture-frame overlay is shown. */
+    isCaptureFrameVisible(): boolean;
+    /** Show/hide the capture-frame overlay. */
+    setCaptureFrameVisible(show: boolean): void;
+    /** Flip the capture-frame overlay visibility. */
+    toggleCaptureFrame(): void;
+    /** The world rect captured at the last switch-on, or `null`. */
+    getCaptureRect(): BoundingBox | null;
+    /** Fire on any active/camera/look/tilt-layer/frame change. Returns an unsubscribe. */
+    onChange(listener: () => void): () => void;
+}
+export declare const mode7Service: import("@edv4h/usketch-shared").ServiceHandle<Mode7Api>;
+export declare function createMode7Api(store: Mode7Store): Mode7Api;
+/** Host accessor: `getMode7Api(app.services)?.toggle()`. Undefined when inactive. */
+export declare function getMode7Api(services: ServiceRegistry): Mode7Api | undefined;
+//# sourceMappingURL=mode7-service.d.ts.map

package/dist/mode7-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode7-service.d.ts","sourceRoot":"","sources":["../src/mode7-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,QAAQ;IACxB,2CAA2C;IAC3C,QAAQ,IAAI,OAAO,CAAC;IACpB,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,IAAI,CAAC;IACf,mCAAmC;IACnC,SAAS,IAAI,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kDAAkD;IAClD,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACrC,0CAA0C;IAC1C,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qEAAqE;IACrE,KAAK,IAAI,IAAI,CAAC;IACd,8CAA8C;IAC9C,aAAa,IAAI,SAAS,MAAM,EAAE,CAAC;IACnC,iDAAiD;IACjD,aAAa,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5C,mDAAmD;IACnD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sEAAsE;IACtE,eAAe,IAAI,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,4DAA4D;IAC5D,qBAAqB,IAAI,OAAO,CAAC;IACjC,2CAA2C;IAC3C,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,iDAAiD;IACjD,kBAAkB,IAAI,IAAI,CAAC;IAC3B,gEAAgE;IAChE,cAAc,IAAI,WAAW,GAAG,IAAI,CAAC;IACrC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3C;AAED,eAAO,MAAM,YAAY,yDAAkD,CAAC;AAE5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CA4B1D;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,GAAG,SAAS,CAE3E"}

package/dist/mode7-service.js

@@ -0,0 +1,39 @@
+// Host-facing API on the `ctx.services` seam (same convention as dashboard/window-
+// system): thin, typed delegation to the reactive store so a host or another plugin
+// can drive the Mode 7 view without the HUD.
+import { defineService } from "@edv4h/usketch-shared";
+export const mode7Service = defineService("usketch-plugin-mode7");
+export function createMode7Api(store) {
+    return {
+        isActive: () => store.getState().active,
+        enable: () => store.setActive(true),
+        disable: () => store.setActive(false),
+        toggle: () => store.toggle(),
+        getCamera: () => store.getState().camera,
+        setPitch: (deg) => store.setCamera({ pitch: deg }),
+        setYaw: (deg) => store.setCamera({ yaw: deg }),
+        setFov: (px) => store.setCamera({ fov: px }),
+        setHorizon: (fraction) => store.setCamera({ horizon: fraction }),
+        adjust: (delta) => store.adjustCamera(delta),
+        getLook: () => store.getState().look,
+        setSky: (color) => store.setLook({ sky: color }),
+        setFog: (density) => store.setLook({ fog: density }),
+        setFogColor: (color) => store.setLook({ fogColor: color }),
+        reset: () => store.reset(),
+        getTiltLayers: () => store.getState().tiltLayers,
+        setTiltLayers: (ids) => store.setTiltLayers(ids),
+        toggleTiltLayer: (id) => store.toggleTiltLayer(id),
+        getDrawDistance: () => store.getState().drawDistance,
+        setDrawDistance: (distance) => store.setDrawDistance(distance),
+        isCaptureFrameVisible: () => store.getState().showCaptureFrame,
+        setCaptureFrameVisible: (show) => store.setCaptureFrame(show),
+        toggleCaptureFrame: () => store.toggleCaptureFrame(),
+        getCaptureRect: () => store.getState().captureRect,
+        onChange: (listener) => store.subscribe(listener),
+    };
+}
+/** Host accessor: `getMode7Api(app.services)?.toggle()`. Undefined when inactive. */
+export function getMode7Api(services) {
+    return mode7Service.get(services);
+}
+//# sourceMappingURL=mode7-service.js.map

package/dist/mode7-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode7-service.js","sourceRoot":"","sources":["../src/mode7-service.ts"],"names":[],"mappings":"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"}

package/dist/mode7-store.d.ts

@@ -0,0 +1,74 @@
+import type { BoundingBox } from "@edv4h/usketch-shared";
+import { type Camera } from "./mode7-camera.js";
+/** Appearance settings, independent of the camera geometry. */
+export interface Look {
+    /** Sky backdrop color (CSS) painted behind the tilted plane. */
+    sky: string;
+    /** Fog density near the horizon, 0..1 (0 = no fog). */
+    fog: number;
+    /** Fog color (CSS). */
+    fogColor: string;
+}
+export declare const DEFAULT_LOOK: Look;
+/** Default ground draw distance in canvas units: extends the ground a bit past the
+ *  viewport so the 3D view opens on a proper receding plane (not just the box). */
+export declare const DEFAULT_DRAW_DISTANCE = 1500;
+/**
+ * Layers tilted by default: essentially everything on the board EXCEPT the persistent
+ * UI chrome that must stay flat/readable (vim status line / which-key / help, the side
+ * panel, the presentation overlay) — plus the plugin's own overlays + the HUD, which
+ * are always excluded from the picker. The set is runtime-selectable via the HUD, so
+ * this is only the starting selection. Ids not present on a given board are ignored.
+ */
+export declare const DEFAULT_TILT_LAYER_IDS: readonly string[];
+export interface Mode7State {
+    active: boolean;
+    camera: Camera;
+    look: Look;
+    /** Layer ids currently rendered in 3D (user-selectable at runtime). */
+    tiltLayers: string[];
+    /** How far the ground is drawn, in **canvas (world) units** measured forward from the
+     *  near edge (`0` = unlimited / no clip; a positive value hides content beyond it). */
+    drawDistance: number;
+    /** Whether to draw the "capture frame" overlay in flat mode (HUD toggle). */
+    showCaptureFrame: boolean;
+    /**
+     * The world-space rectangle the 3D ground plane covers, snapshotted at the moment
+     * the view was last switched on (`null` before the first switch / seed). Shapes
+     * outside it don't appear in the initial 3D view — the frame makes that visible.
+     * The runtime sets this (it needs the canvas pixel size); the store only holds it.
+     */
+    captureRect: BoundingBox | null;
+}
+export interface Mode7Init {
+    active?: boolean;
+    camera?: Partial<Camera>;
+    look?: Partial<Look>;
+    tiltLayers?: readonly string[];
+    drawDistance?: number;
+    showCaptureFrame?: boolean;
+}
+export interface Mode7Store {
+    getState(): Mode7State;
+    subscribe(cb: () => void): () => void;
+    setActive(active: boolean): void;
+    toggle(): void;
+    setCamera(patch: Partial<Camera>): void;
+    adjustCamera(delta: Partial<Camera>): void;
+    setLook(patch: Partial<Look>): void;
+    /** Replace the whole set of tilted layer ids. */
+    setTiltLayers(ids: readonly string[]): void;
+    /** Add/remove one layer id from the tilted set. */
+    toggleTiltLayer(id: string): void;
+    /** Set the ground draw distance in canvas units (`0` = unlimited; clamped `>= 0`). */
+    setDrawDistance(distance: number): void;
+    /** Show/hide the flat-mode capture-frame overlay. */
+    setCaptureFrame(show: boolean): void;
+    /** Flip the capture-frame overlay visibility. */
+    toggleCaptureFrame(): void;
+    /** Store the captured world rect (called by the runtime; `null` clears it). */
+    setCaptureRect(rect: BoundingBox | null): void;
+    reset(): void;
+}
+export declare function createMode7Store(init?: Mode7Init): Mode7Store;
+//# sourceMappingURL=mode7-store.d.ts.map

package/dist/mode7-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode7-store.d.ts","sourceRoot":"","sources":["../src/mode7-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,KAAK,MAAM,EAA6C,MAAM,mBAAmB,CAAC;AAE3F,+DAA+D;AAC/D,MAAM,WAAW,IAAI;IACpB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,YAAY,EAAE,IAAyD,CAAC;AAErF;mFACmF;AACnF,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAQ1C;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EA6BnD,CAAC;AAEF,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;2FACuF;IACvF,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,IAAI,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACtC,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,MAAM,IAAI,IAAI,CAAC;IACf,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3C,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,iDAAiD;IACjD,aAAa,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5C,mDAAmD;IACnD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sFAAsF;IACtF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,qDAAqD;IACrD,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,iDAAiD;IACjD,kBAAkB,IAAI,IAAI,CAAC;IAC3B,+EAA+E;IAC/E,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/C,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,SAAc,GAAG,UAAU,CA2FjE"}

package/dist/mode7-store.js

@@ -0,0 +1,143 @@
+import { clampCamera, DEFAULT_CAMERA, updateCamera } from "./mode7-camera.js";
+export const DEFAULT_LOOK = { sky: "#0b1026", fog: 0.35, fogColor: "#0b1026" };
+/** Default ground draw distance in canvas units: extends the ground a bit past the
+ *  viewport so the 3D view opens on a proper receding plane (not just the box). */
+export const DEFAULT_DRAW_DISTANCE = 1500;
+/** Clamp a draw distance (canvas units, `>= 0`; non-finite / negative → 0 = unlimited). */
+function clampDistance(n) {
+    if (!Number.isFinite(n) || n < 0)
+        return 0;
+    return n;
+}
+/**
+ * Layers tilted by default: essentially everything on the board EXCEPT the persistent
+ * UI chrome that must stay flat/readable (vim status line / which-key / help, the side
+ * panel, the presentation overlay) — plus the plugin's own overlays + the HUD, which
+ * are always excluded from the picker. The set is runtime-selectable via the HUD, so
+ * this is only the starting selection. Ids not present on a given board are ignored.
+ */
+export const DEFAULT_TILT_LAYER_IDS = [
+    // backgrounds / content
+    "bg-grid",
+    "bg-dots",
+    "island-metaball",
+    "gpu-shapes",
+    "dom-shapes",
+    "usketch-plugin-dashboard:grid-overlay",
+    // shape-attached overlays (selection, connectors, editors) — follow the shapes
+    "comment-badges",
+    "connector-anchor-handles",
+    "__selection-foreground",
+    "connector-endpoints",
+    "connector-label-editor",
+    "usketch-plugin-shape-frame:title-editor",
+    "domain-connector-properties",
+    "unconfirmed-shapes-overlay",
+    // interaction / presence overlays anchored to the board
+    "vim-overlay",
+    "snap-guides",
+    "laser",
+    "freedraw-cursor",
+    "spotlight",
+    "follow-banner",
+    "whistle-indicator",
+    "voice-notes-indicator",
+    "transient",
+    "portal",
+    "usketch-presence-activity",
+];
+export function createMode7Store(init = {}) {
+    const baseCamera = clampCamera({ ...DEFAULT_CAMERA, ...init.camera });
+    const baseLook = { ...DEFAULT_LOOK, ...init.look };
+    let state = {
+        active: init.active ?? false,
+        camera: baseCamera,
+        look: baseLook,
+        tiltLayers: [...(init.tiltLayers ?? DEFAULT_TILT_LAYER_IDS)],
+        drawDistance: clampDistance(init.drawDistance ?? DEFAULT_DRAW_DISTANCE),
+        showCaptureFrame: init.showCaptureFrame ?? false,
+        captureRect: null,
+    };
+    const listeners = new Set();
+    const notify = () => {
+        for (const l of listeners)
+            l();
+    };
+    return {
+        getState: () => state,
+        subscribe(cb) {
+            listeners.add(cb);
+            return () => {
+                listeners.delete(cb);
+            };
+        },
+        setActive(active) {
+            if (state.active === active)
+                return;
+            state = { ...state, active };
+            notify();
+        },
+        toggle() {
+            state = { ...state, active: !state.active };
+            notify();
+        },
+        setCamera(patch) {
+            state = { ...state, camera: updateCamera(state.camera, patch) };
+            notify();
+        },
+        adjustCamera(delta) {
+            state = {
+                ...state,
+                camera: updateCamera(state.camera, {
+                    pitch: state.camera.pitch + (delta.pitch ?? 0),
+                    yaw: state.camera.yaw + (delta.yaw ?? 0),
+                    fov: state.camera.fov + (delta.fov ?? 0),
+                    horizon: state.camera.horizon + (delta.horizon ?? 0),
+                }),
+            };
+            notify();
+        },
+        setLook(patch) {
+            state = { ...state, look: { ...state.look, ...patch } };
+            notify();
+        },
+        setTiltLayers(ids) {
+            state = { ...state, tiltLayers: [...new Set(ids)] };
+            notify();
+        },
+        toggleTiltLayer(id) {
+            const has = state.tiltLayers.includes(id);
+            state = {
+                ...state,
+                tiltLayers: has ? state.tiltLayers.filter((x) => x !== id) : [...state.tiltLayers, id],
+            };
+            notify();
+        },
+        setDrawDistance(distance) {
+            const d = clampDistance(distance);
+            if (state.drawDistance === d)
+                return;
+            state = { ...state, drawDistance: d };
+            notify();
+        },
+        setCaptureFrame(show) {
+            if (state.showCaptureFrame === show)
+                return;
+            state = { ...state, showCaptureFrame: show };
+            notify();
+        },
+        toggleCaptureFrame() {
+            state = { ...state, showCaptureFrame: !state.showCaptureFrame };
+            notify();
+        },
+        setCaptureRect(rect) {
+            state = { ...state, captureRect: rect };
+            notify();
+        },
+        reset() {
+            state = { ...state, camera: baseCamera, look: baseLook };
+            notify();
+        },
+    };
+}
+//# sourceMappingURL=mode7-store.js.map

package/dist/mode7-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode7-store.js","sourceRoot":"","sources":["../src/mode7-store.ts"],"names":[],"mappings":"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"}

package/dist/mode7-transform.d.ts

@@ -0,0 +1,56 @@
+import type { Camera } from "./mode7-camera.js";
+export interface TiltTransform {
+    /** `transform` for a tilted layer wrapper (includes its own perspective). */
+    transform: string;
+    /** `transform-origin` — pivots the tilt about the horizon line. */
+    transformOrigin: string;
+}
+/** The full CSS transform (perspective + rotate) for a tilted layer wrapper. */
+export declare function tiltTransform(cam: Camera): TiltTransform;
+/**
+ * Sky backdrop (painted behind the tilted plane): a vertical gradient from the sky
+ * color at the top down to a paler haze that fades out smoothly ACROSS the horizon,
+ * so the ground appears to dissolve into a hazy sky rather than meeting a hard line.
+ * Fully transparent a little below the horizon (the near ground shows through).
+ */
+export declare function skyBackground(sky: string, horizon: number): string;
+/**
+ * Fog overlay (painted in front of the plane): a haze that FADES IN from a little
+ * above the horizon, peaks right at it, and clears toward the bottom (the camera).
+ * The soft top edge (above the horizon) is what covers the ground plane's far edge,
+ * hiding the seam; the fade to the bottom sells atmospheric depth. `density` 0..1
+ * scales the peak alpha; 0 disables it entirely.
+ */
+export declare function fogBackground(color: string, density: number, horizon: number): string;
+/** Peak fog opacity for the overlay element (kept separate so 0 density → no paint). */
+export declare function fogOpacity(density: number): number;
+/**
+ * The `clip-path` for the tilted layer wrappers. The tilt uses `overflow:visible` to
+ * keep the 3D intact, which would otherwise let content float PAST the grid; the clip
+ * bounds the tilted content instead.
+ *
+ * `distance` is the draw distance in **canvas/world units** measured forward from the
+ * near edge (bottom of the viewport). `distance <= 0` means "auto": clip exactly to the
+ * box (`inset(0)` — nothing floats past the grid, no overscan). A positive `distance`
+ * maps to `distance * zoom` screen px at the bottom of the wrapper box:
+ *   - within the box (`distance*zoom < height`) → positive inset (a closer cutoff);
+ *   - beyond the box (`distance*zoom > height`) → NEGATIVE inset, i.e. the clip extends
+ *     above the box so content farther than the viewport is drawn. The background grid
+ *     must be extended to match (see {@link drawDistanceOverscanPx}) or that far content
+ *     would float; `clip-path` keeps the 3D tilt intact (unlike `overflow`, flattening).
+ */
+export declare function drawDistanceClip(distance: number, zoom: number, viewportHeightPx: number): string;
+/**
+ * The px the background grid must extend ABOVE/BEYOND the viewport box to stay under the
+ * content that {@link drawDistanceClip} reveals for a draw `distance` larger than the
+ * viewport. `0` when the distance is auto/within the box (no extension needed). This is
+ * driven into the grid via the `bg-grid:set-overscan` event so grid + shapes end together.
+ */
+export declare function drawDistanceOverscanPx(distance: number, zoom: number, viewportHeightPx: number): number;
+/**
+ * Wrap a CSS color into an rgba() with the given alpha. Handles #rgb/#rrggbb; any
+ * other color string is passed through `color-mix` with transparent so named/hsl
+ * colors still fade (falls back to the raw color if color-mix is unsupported).
+ */
+export declare function rgba(color: string, alpha: number): string;
+//# sourceMappingURL=mode7-transform.d.ts.map

package/dist/mode7-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode7-transform.d.ts","sourceRoot":"","sources":["../src/mode7-transform.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC7B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAKxD;AAUD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKrF;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAcjG;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,GACtB,MAAM,CAIR;AAuBD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYzD"}

package/dist/mode7-transform.js

@@ -0,0 +1,123 @@
+/** The full CSS transform (perspective + rotate) for a tilted layer wrapper. */
+export function tiltTransform(cam) {
+    return {
+        transform: `perspective(${round(cam.fov)}px) rotateX(${round(cam.pitch)}deg) rotateZ(${round(cam.yaw)}deg)`,
+        transformOrigin: `50% ${round(cam.horizon * 100)}%`,
+    };
+}
+/**
+ * Vertical blend band (in % of viewport height) straddling the horizon. The sky and
+ * fog gradients fade THROUGH the horizon over this band instead of stopping hard at
+ * it — otherwise the tilted plane's far edge (layers only paint the finite 2D
+ * viewport rect) shows as a crisp horizontal seam. A soft band hazes that edge away.
+ */
+const HORIZON_SOFT = 8;
+/**
+ * Sky backdrop (painted behind the tilted plane): a vertical gradient from the sky
+ * color at the top down to a paler haze that fades out smoothly ACROSS the horizon,
+ * so the ground appears to dissolve into a hazy sky rather than meeting a hard line.
+ * Fully transparent a little below the horizon (the near ground shows through).
+ */
+export function skyBackground(sky, horizon) {
+    const h = round(clamp01(horizon) * 100);
+    const mid = round(Math.min(h * 0.5, h - HORIZON_SOFT));
+    const hazeTop = round(clamp(h - HORIZON_SOFT, 0, 100));
+    const clearBottom = round(clamp(h + HORIZON_SOFT, 0, 100));
+    return `linear-gradient(to bottom, ${sky} 0%, ${sky} ${mid}%, ${haze(sky)} ${hazeTop}%, transparent ${clearBottom}%)`;
+}
+/**
+ * Fog overlay (painted in front of the plane): a haze that FADES IN from a little
+ * above the horizon, peaks right at it, and clears toward the bottom (the camera).
+ * The soft top edge (above the horizon) is what covers the ground plane's far edge,
+ * hiding the seam; the fade to the bottom sells atmospheric depth. `density` 0..1
+ * scales the peak alpha; 0 disables it entirely.
+ */
+export function fogBackground(color, density, horizon) {
+    const h = round(clamp01(horizon) * 100);
+    const a = clamp01(density);
+    const fadeInTop = round(clamp(h - HORIZON_SOFT, 0, 100));
+    return `linear-gradient(to bottom, transparent ${fadeInTop}%, ${rgba(color, a)} ${h}%, transparent 100%)`;
+}
+/** Peak fog opacity for the overlay element (kept separate so 0 density → no paint). */
+export function fogOpacity(density) {
+    return clamp01(density);
+}
+/**
+ * The `clip-path` for the tilted layer wrappers. The tilt uses `overflow:visible` to
+ * keep the 3D intact, which would otherwise let content float PAST the grid; the clip
+ * bounds the tilted content instead.
+ *
+ * `distance` is the draw distance in **canvas/world units** measured forward from the
+ * near edge (bottom of the viewport). `distance <= 0` means "auto": clip exactly to the
+ * box (`inset(0)` — nothing floats past the grid, no overscan). A positive `distance`
+ * maps to `distance * zoom` screen px at the bottom of the wrapper box:
+ *   - within the box (`distance*zoom < height`) → positive inset (a closer cutoff);
+ *   - beyond the box (`distance*zoom > height`) → NEGATIVE inset, i.e. the clip extends
+ *     above the box so content farther than the viewport is drawn. The background grid
+ *     must be extended to match (see {@link drawDistanceOverscanPx}) or that far content
+ *     would float; `clip-path` keeps the 3D tilt intact (unlike `overflow`, flattening).
+ */
+export function drawDistanceClip(distance, zoom, viewportHeightPx) {
+    if (!(distance > 0) || !(zoom > 0) || !(viewportHeightPx > 0)) {
+        return "inset(0% 0% 0% 0%)"; // auto → clip to the box
+    }
+    const bandPx = distance * zoom;
+    if (bandPx <= viewportHeightPx) {
+        // Within the viewport: keep only the near band; sides stay at the box.
+        return `inset(${round((1 - bandPx / viewportHeightPx) * 100)}% 0% 0% 0%)`;
+    }
+    // Beyond the viewport: extend equally on ALL sides so the far ground fans out
+    // (not just a box-wide strip). The grid overscans to match; the canvas container
+    // clips whatever runs off-screen. Negative inset grows the clip region past the box.
+    const over = round(bandPx - viewportHeightPx);
+    return `inset(${-over}px ${-over}px ${-over}px ${-over}px)`;
+}
+/**
+ * The px the background grid must extend ABOVE/BEYOND the viewport box to stay under the
+ * content that {@link drawDistanceClip} reveals for a draw `distance` larger than the
+ * viewport. `0` when the distance is auto/within the box (no extension needed). This is
+ * driven into the grid via the `bg-grid:set-overscan` event so grid + shapes end together.
+ */
+export function drawDistanceOverscanPx(distance, zoom, viewportHeightPx) {
+    if (!(distance > 0) || !(zoom > 0) || !(viewportHeightPx > 0))
+        return 0;
+    const bandPx = distance * zoom;
+    return bandPx > viewportHeightPx ? Math.ceil(bandPx - viewportHeightPx) : 0;
+}
+// ── helpers ──
+function round(n) {
+    return Math.round(n * 1000) / 1000;
+}
+function clamp01(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.min(1, Math.max(0, n));
+}
+function clamp(n, lo, hi) {
+    if (!Number.isFinite(n))
+        return lo;
+    return Math.min(hi, Math.max(lo, n));
+}
+/** A translucent version of the sky color for the horizon haze band. */
+function haze(sky) {
+    return rgba(sky, 0.35);
+}
+/**
+ * Wrap a CSS color into an rgba() with the given alpha. Handles #rgb/#rrggbb; any
+ * other color string is passed through `color-mix` with transparent so named/hsl
+ * colors still fade (falls back to the raw color if color-mix is unsupported).
+ */
+export function rgba(color, alpha) {
+    const a = clamp01(alpha);
+    const hex = color.trim().match(/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/);
+    if (hex) {
+        const h = hex[1];
+        const full = h.length === 3 ? h.replace(/(.)/g, "$1$1") : h;
+        const r = Number.parseInt(full.slice(0, 2), 16);
+        const g = Number.parseInt(full.slice(2, 4), 16);
+        const b = Number.parseInt(full.slice(4, 6), 16);
+        return `rgba(${r}, ${g}, ${b}, ${a})`;
+    }
+    return `color-mix(in srgb, ${color} ${round(a * 100)}%, transparent)`;
+}
+//# sourceMappingURL=mode7-transform.js.map

package/dist/mode7-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode7-transform.js","sourceRoot":"","sources":["../src/mode7-transform.ts"],"names":[],"mappings":"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"}

package/dist/plugin.d.ts

@@ -0,0 +1,27 @@
+import type { UsketchPlugin } from "@edv4h/usketch-shared";
+import type { Camera } from "./mode7-camera.js";
+import { type Look } from "./mode7-store.js";
+import { type Mode7Shortcuts } from "./register-mode7-actions.js";
+export interface Mode7PluginOptions {
+    /** Start with the 3D view already on (default `false`). */
+    enabledInitially?: boolean;
+    /** Initial camera geometry (merged over the defaults). */
+    camera?: Partial<Camera>;
+    /** Initial appearance (sky / fog). */
+    look?: Partial<Look>;
+    /** Initial set of tilted layer ids (default: Shapes + backgrounds). The set is
+     *  also selectable at runtime via the HUD layer picker. */
+    tiltLayerIds?: string[];
+    /** Layer ids the runtime picker must never offer (in addition to the plugin's own
+     *  overlays and the HUD, which are always excluded). */
+    skipLayerIds?: string[];
+    /** Ground draw distance in canvas (world) units (`0` = auto / clip to the viewport;
+     *  larger values extend the ground past it; default `1500`). */
+    drawDistance?: number;
+    /** Start with the flat-mode capture-frame overlay shown (default `false`). */
+    showCaptureFrame?: boolean;
+    /** Keyboard shortcut bindings (opt-in; no defaults). */
+    shortcuts?: Mode7Shortcuts;
+}
+export declare function createMode7Plugin(options?: Mode7PluginOptions): UsketchPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAShD,OAAO,EAAoB,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,6BAA6B,CAAC;AAGxF,MAAM,WAAW,kBAAkB;IAClC,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB;+DAC2D;IAC3D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;4DACwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;oEACgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wDAAwD;IACxD,SAAS,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa,CAuCjF"}

package/dist/plugin.js

@@ -0,0 +1,44 @@
+import { CAPTURE_FRAME_LAYER_ID, CAPTURE_LAYER_ID, FOG_LAYER_ID, SKY_LAYER_ID, setupMode7Runtime, } from "./mode7-runtime.js";
+import { createMode7Api, mode7Service } from "./mode7-service.js";
+import { createMode7Store } from "./mode7-store.js";
+import { registerMode7Actions } from "./register-mode7-actions.js";
+import { registerMode7Hud } from "./register-mode7-hud.js";
+export function createMode7Plugin(options = {}) {
+    const store = createMode7Store({
+        active: options.enabledInitially ?? false,
+        camera: options.camera,
+        look: options.look,
+        tiltLayers: options.tiltLayerIds,
+        drawDistance: options.drawDistance,
+        showCaptureFrame: options.showCaptureFrame,
+    });
+    const api = createMode7Api(store);
+    // Layers the picker must never tilt (tilting the HUD or our own overlays makes
+    // no sense and could hide the very controls used to turn the view off).
+    const excludedLayerIds = [
+        SKY_LAYER_ID,
+        FOG_LAYER_ID,
+        CAPTURE_LAYER_ID,
+        CAPTURE_FRAME_LAYER_ID,
+        "debug-hud",
+        ...(options.skipLayerIds ?? []),
+    ];
+    return {
+        id: "usketch-plugin-mode7",
+        name: "Mode 7 (3D ビュー)",
+        setup(ctx) {
+            const stopRuntime = setupMode7Runtime(ctx, store);
+            const stopActions = registerMode7Actions(ctx, api, options.shortcuts);
+            const stopHud = registerMode7Hud(ctx, api, store, excludedLayerIds);
+            // Provide the service LAST so a failed earlier step can't leak it.
+            const unprovideService = mode7Service.provide(ctx.services, api);
+            return () => {
+                unprovideService();
+                stopHud();
+                stopActions();
+                stopRuntime();
+            };
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAQA,OAAO,EACN,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,iBAAiB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAa,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAuB,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAwB3D,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAuB,EAAE;IACjE,MAAM,KAAK,GAAG,gBAAgB,CAAC;QAC9B,MAAM,EAAE,OAAO,CAAC,gBAAgB,IAAI,KAAK;QACzC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,YAAY;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;KAC1C,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAClC,+EAA+E;IAC/E,wEAAwE;IACxE,MAAM,gBAAgB,GAAG;QACxB,YAAY;QACZ,YAAY;QACZ,gBAAgB;QAChB,sBAAsB;QACtB,WAAW;QACX,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;KAC/B,CAAC;IAEF,OAAO;QACN,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE,iBAAiB;QACvB,KAAK,CAAC,GAAkB;YACvB,MAAM,WAAW,GAAG,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,WAAW,GAAG,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;YACpE,mEAAmE;YACnE,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAEjE,OAAO,GAAG,EAAE;gBACX,gBAAgB,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,CAAC;gBACd,WAAW,EAAE,CAAC;YACf,CAAC,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/register-mode7-actions.d.ts

@@ -0,0 +1,8 @@
+import type { PluginContext } from "@edv4h/usketch-shared";
+import type { Mode7Api } from "./mode7-service.js";
+export type Mode7ActionKey = "toggle" | "pitch-up" | "pitch-down" | "yaw-left" | "yaw-right" | "fov-narrow" | "fov-wide" | "reset" | "capture-frame";
+/** Host shortcut overrides: a combo string binds the action; omitting a key leaves
+ *  it unbound (there are no built-in defaults). `null` is also treated as unbound. */
+export type Mode7Shortcuts = Partial<Record<Mode7ActionKey, string | null>>;
+export declare function registerMode7Actions(ctx: PluginContext, api: Mode7Api, shortcuts?: Mode7Shortcuts): () => void;
+//# sourceMappingURL=register-mode7-actions.d.ts.map