@bendyline/squisq-editor-react 2.0.1 → 2.1.0

package/src/scene/__tests__/fitScale.test.ts

@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest';
+import { calculateFitScale } from '../fitScale';
+
+describe('calculateFitScale', () => {
+  it('does not enlarge content that already fits', () => {
+    expect(calculateFitScale({ width: 200, height: 100 }, { width: 800, height: 600 })).toBe(1);
+  });
+
+  it('uses the smaller axis scale so every shape remains visible', () => {
+    expect(calculateFitScale({ width: 1_000, height: 200 }, { width: 500, height: 300 })).toBe(0.5);
+    expect(calculateFitScale({ width: 200, height: 1_000 }, { width: 500, height: 250 })).toBe(
+      0.25,
+    );
+  });
+
+  it('falls back to 100% until dimensions are measurable', () => {
+    expect(calculateFitScale({ width: 0, height: 100 }, { width: 500, height: 300 })).toBe(1);
+  });
+});

package/src/scene/__tests__/useScenePanZoom.test.ts

@@ -44,7 +44,7 @@ describe('useScenePanZoom', () => {
     act(() => result.current.zoomAt(100, 0, 0));
     expect(result.current.transform.scale).toBeLessThanOrEqual(8);
     act(() => result.current.zoomAt(0.0001, 0, 0));
-    expect(result.current.transform.scale).toBeGreaterThanOrEqual(0.1);
+    expect(result.current.transform.scale).toBeGreaterThanOrEqual(0.02);
   });
 
   it('reset returns to identity', () => {
@@ -88,6 +88,33 @@ describe('useScenePanZoom', () => {
     expect(result.current.transform.scale).toBeCloseTo(1.6, 5);
   });
 
+  it('fitBox can cap fit at 100% without enlarging small content', () => {
+    const { result } = renderHook(() => useScenePanZoom());
+    act(() =>
+      result.current.fitBox(
+        { x: 25, y: 50, width: 100, height: 80 },
+        { width: 800, height: 600 },
+        20,
+        1,
+      ),
+    );
+    expect(result.current.transform.scale).toBe(1);
+    expect(result.current.viewportToScreen(75, 90)).toEqual({ x: 400, y: 300 });
+  });
+
+  it('fitBox may shrink below the manual zoom floor to keep all content visible', () => {
+    const { result } = renderHook(() => useScenePanZoom());
+    act(() =>
+      result.current.fitBox(
+        { x: 0, y: 0, width: 10_000, height: 10_000 },
+        { width: 400, height: 300 },
+        20,
+        1,
+      ),
+    );
+    expect(result.current.transform.scale).toBeCloseTo(0.026, 5);
+  });
+
   it('screenToViewport and viewportToScreen are inverses', () => {
     const { result } = renderHook(() => useScenePanZoom());
     act(() => {

package/src/scene/fitScale.ts

@@ -0,0 +1,17 @@
+export interface SceneSize {
+  width: number;
+  height: number;
+}
+
+/**
+ * Scale content so it is wholly visible, without enlarging it past the
+ * supplied maximum (100% by default). Invalid or not-yet-measured dimensions
+ * fall back to 100%.
+ */
+export function calculateFitScale(content: SceneSize, container: SceneSize, maxScale = 1): number {
+  if (content.width <= 0 || content.height <= 0 || container.width <= 0 || container.height <= 0) {
+    return Math.min(1, maxScale);
+  }
+
+  return Math.min(maxScale, container.width / content.width, container.height / content.height);
+}

package/src/scene/hooks/useScenePanZoom.ts

@@ -13,6 +13,7 @@
  */
 
 import { useCallback, useRef, useState } from 'react';
+import { calculateFitScale } from '../fitScale';
 
 export interface SceneTransform {
   /** Translation in screen pixels. */
@@ -25,7 +26,7 @@ export interface SceneTransform {
 export const IDENTITY_TRANSFORM: SceneTransform = Object.freeze({ tx: 0, ty: 0, scale: 1 });
 
 /** Clamp scale to a sensible range so a single accidental wheel doesn't escape. */
-const MIN_SCALE = 0.1;
+const MIN_SCALE = 0.02;
 const MAX_SCALE = 8;
 
 export interface UseScenePanZoomResult {
@@ -45,13 +46,14 @@ export interface UseScenePanZoomResult {
   reset: () => void;
   /**
    * Fit a viewport-unit bounding box into a container of `containerSize`
-   * screen pixels, with optional padding (also in screen pixels). When
-   * the box is empty, no-ops.
+   * screen pixels, with optional padding (also in screen pixels) and an
+   * optional maximum scale. When the box is empty, no-ops.
    */
   fitBox: (
     box: { x: number; y: number; width: number; height: number },
     containerSize: { width: number; height: number },
     padding?: number,
+    maxScale?: number,
   ) => void;
   /** Convert a screen-pixel point (container-relative) → viewport units. */
   screenToViewport: (sx: number, sy: number) => { x: number; y: number };
@@ -104,12 +106,17 @@ export function useScenePanZoom(
       box: { x: number; y: number; width: number; height: number },
       containerSize: { width: number; height: number },
       padding = 24,
+      maxScale = MAX_SCALE,
     ) => {
       if (box.width <= 0 || box.height <= 0) return;
       if (containerSize.width <= 0 || containerSize.height <= 0) return;
       const availW = Math.max(1, containerSize.width - padding * 2);
       const availH = Math.max(1, containerSize.height - padding * 2);
-      const scale = clamp(Math.min(availW / box.width, availH / box.height), MIN_SCALE, MAX_SCALE);
+      const scale = calculateFitScale(
+        { width: box.width, height: box.height },
+        { width: availW, height: availH },
+        Math.min(MAX_SCALE, Math.max(Number.EPSILON, maxScale)),
+      );
       // Center the box in the container.
       const scaledW = box.width * scale;
       const scaledH = box.height * scale;

package/src/scene/scene.css

@@ -266,6 +266,18 @@
   border-color: #cbd5e1;
 }
 
+.squisq-scene-action--active,
+.squisq-scene-action--active:hover:not(:disabled) {
+  background: #e0e7ff;
+  border-color: #4f46e5;
+  color: #4338ca;
+}
+
+.squisq-scene-action-popover-anchor {
+  position: relative;
+  display: inline-flex;
+}
+
 .squisq-scene-action:focus-visible {
   outline: 2px solid #6366f1;
   outline-offset: 1px;
@@ -322,7 +334,9 @@
 }
 
 .squisq-editor-shell[data-theme='dark'] .squisq-scene-tool--active,
-.squisq-editor-shell[data-theme='dark'] .squisq-scene-tool--active:hover {
+.squisq-editor-shell[data-theme='dark'] .squisq-scene-tool--active:hover,
+.squisq-editor-shell[data-theme='dark'] .squisq-scene-action--active,
+.squisq-editor-shell[data-theme='dark'] .squisq-scene-action--active:hover:not(:disabled) {
   background: #312e81;
   border-color: #818cf8;
   color: #f8fafc;
@@ -350,7 +364,8 @@
   padding: 12px;
 }
 .squisq-scene-block-max > .squisq-diagram-canvas,
-.squisq-scene-block-max > .squisq-scene-stage {
+.squisq-scene-block-max > .squisq-scene-stage,
+.squisq-scene-block-max > .squisq-mermaid-canvas {
   flex: 1;
   min-width: 0;
   min-height: 0;
@@ -403,6 +418,12 @@
   right: calc(100% + 6px);
 }
 
+.squisq-scene-side-toolbar .squisq-scene-action-popover-anchor > [role='dialog'] {
+  top: 0;
+  left: auto;
+  right: calc(100% + 6px);
+}
+
 /* ── Narrow-width fallback bar ─────────────────────────────────
    When SceneSideToolbar measures that the right gutter can't hold the 180px
    column, it renders the same toolbar as an in-flow horizontal bar above the
@@ -420,7 +441,68 @@
   margin: 0;
 }
 
-/* ── Maximize button ──────────────────────────────────────── */
+/* ── View controls + maximize ─────────────────────────────── */
+
+.squisq-scene-view-controls {
+  position: absolute;
+  top: 8px;
+  left: 8px;
+  z-index: 10;
+  display: inline-flex;
+  align-items: center;
+  overflow: hidden;
+  border: 1px solid var(--squisq-border, #e2e8f0);
+  border-radius: 6px;
+  background: var(--squisq-surface, #ffffff);
+  color: var(--squisq-text, #1e293b);
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.08);
+}
+
+.squisq-scene-view-controls button,
+.squisq-scene-view-scale {
+  box-sizing: border-box;
+  min-width: 32px;
+  height: 32px;
+  padding: 0 8px;
+  border: 0;
+  border-right: 1px solid var(--squisq-border, #e2e8f0);
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  line-height: 32px;
+  text-align: center;
+}
+
+.squisq-scene-view-controls button {
+  cursor: pointer;
+}
+
+.squisq-scene-view-controls button:last-child {
+  border-right: 0;
+}
+
+.squisq-scene-view-controls button:hover,
+.squisq-scene-view-fit[data-active='true'] {
+  background: var(--squisq-surface-hover, #f1f5f9);
+}
+
+.squisq-scene-view-fit[data-active='true'] {
+  color: #4338ca;
+  font-weight: 600;
+}
+
+.squisq-editor-shell[data-theme='dark'] .squisq-scene-view-controls {
+  background: #111827;
+  border-color: #475569;
+  color: #e5e7eb;
+}
+
+.squisq-editor-shell[data-theme='dark'] .squisq-scene-view-controls button:hover,
+.squisq-editor-shell[data-theme='dark'] .squisq-scene-view-fit[data-active='true'] {
+  background: #312e81;
+  color: #f8fafc;
+}
 
 .squisq-scene-maximize-btn {
   position: absolute;

package/src/styles/code-snippet.css

@@ -0,0 +1,76 @@
+/* Monaco inset for ordinary explicit-language Markdown code fences. */
+
+.squisq-wysiwyg-editor pre.squisq-code-snippet-fence-hidden {
+  display: none;
+}
+
+.squisq-code-snippet-widget-host {
+  margin: 0.75rem 0 1.25rem;
+}
+
+.squisq-code-snippet-shell {
+  box-sizing: border-box;
+  display: flex;
+  width: 100%;
+  height: 240px;
+  min-height: 128px;
+  max-height: 70vh;
+  flex-direction: column;
+  overflow: hidden;
+  resize: vertical;
+  border: 1px solid var(--squisq-border, #d1d5db);
+  border-radius: 8px;
+  background: var(--squisq-surface, #ffffff);
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
+}
+
+.squisq-code-snippet-header {
+  box-sizing: border-box;
+  display: flex;
+  min-height: 34px;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 0 10px;
+  border-bottom: 1px solid var(--squisq-border, #d1d5db);
+  background: var(--squisq-surface-muted, #f8fafc);
+  color: var(--squisq-text-muted, #64748b);
+  font-family: var(--squisq-ux-font, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif);
+  font-size: 12px;
+  user-select: none;
+}
+
+.squisq-code-snippet-title {
+  display: inline-flex;
+  min-width: 0;
+  align-items: center;
+  gap: 7px;
+  color: var(--squisq-text, #334155);
+  font-weight: 600;
+}
+
+.squisq-code-snippet-header code {
+  overflow: hidden;
+  color: inherit;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.squisq-code-snippet-editor {
+  position: relative;
+  min-height: 0;
+  flex: 1;
+  overflow: hidden;
+}
+
+.squisq-code-snippet-loading {
+  display: flex;
+  width: 100%;
+  height: 100%;
+  align-items: center;
+  justify-content: center;
+  color: var(--squisq-text-muted, #64748b);
+  font-family: var(--squisq-ux-font, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif);
+  font-size: 12px;
+}

package/src/styles/editor.css

@@ -359,6 +359,119 @@
   min-width: 0;
 }
 
+/* Host-triggered Find mode. It occupies the toolbar's flexible middle lane,
+   leaving the view tabs on its left and the normal right-side host/settings
+   controls on its right. */
+.squisq-find-toolbar {
+  display: flex;
+  align-items: center;
+  flex: 1 1 auto;
+  gap: 3px;
+  min-width: 180px;
+  padding: 4px 6px;
+}
+
+.squisq-find-field {
+  display: flex;
+  align-items: center;
+  flex: 0 1 420px;
+  min-width: 130px;
+  height: 28px;
+  border: 1px solid #9ca3af;
+  border-radius: 5px;
+  background: #ffffff;
+  color: #6b7280;
+  box-sizing: border-box;
+}
+
+.squisq-find-field:focus-within {
+  border-color: #2563eb;
+  box-shadow: 0 0 0 1px #2563eb;
+}
+
+.squisq-find-field > i {
+  margin-left: 8px;
+  color: #6b7280;
+  font-size: 11px;
+}
+
+.squisq-find-input {
+  flex: 1 1 auto;
+  min-width: 32px;
+  height: 100%;
+  padding: 0 7px;
+  border: 0;
+  outline: 0;
+  background: transparent;
+  color: #111827;
+  font: inherit;
+  font-size: 12.5px;
+}
+
+.squisq-find-input::-webkit-search-cancel-button {
+  display: none;
+}
+
+.squisq-find-count {
+  flex: 0 0 auto;
+  padding-right: 7px;
+  color: #6b7280;
+  font-size: 11px;
+  white-space: nowrap;
+}
+
+.squisq-find-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  padding: 0;
+  border: 0;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--squisq-toolbar-icon);
+  cursor: pointer;
+}
+
+.squisq-find-button:hover:not(:disabled) {
+  background: rgba(0, 0, 0, 0.08);
+  color: #111827;
+}
+
+.squisq-find-button:disabled {
+  opacity: 0.35;
+  cursor: default;
+}
+
+.squisq-find-close {
+  margin-left: 2px;
+}
+
+/* Shared by Tiptap decorations, Monaco inline decorations, and the fallback
+   used when a preview webview lacks the CSS Custom Highlight API. */
+.squisq-find-match {
+  border-radius: 2px;
+  background: #fde68a !important;
+  color: #111827 !important;
+}
+
+.squisq-find-match--selected {
+  background: #f59e0b !important;
+  box-shadow: 0 0 0 1px #b45309;
+}
+
+@container squisq-toolbar (max-width: 680px) {
+  .squisq-find-toolbar {
+    min-width: 120px;
+    padding-right: 2px;
+  }
+
+  .squisq-find-count {
+    display: none;
+  }
+}
+
 /* Contextual groups (template/transition pickers, table controls) sit at the
    end of the actions row. When measurement marks one as clipped it moves into
    the ··· overflow menu; hide the cropped inline original rather than painting
@@ -703,8 +816,178 @@
   border-top-color: #374151;
 }
 
+.squisq-code-snippet-menu {
+  width: 220px;
+  max-height: min(440px, calc(100vh - 16px));
+  overflow-y: auto;
+}
+
+.squisq-code-snippet-language {
+  justify-content: space-between;
+  gap: 16px;
+}
+
+.squisq-code-snippet-language code {
+  overflow: hidden;
+  color: #9ca3af;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace;
+  font-size: 11px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 /* ─── Template Picker (toolbar) ──────────────────────── */
 
+.squisq-mermaid-type-menu {
+  width: min(520px, calc(100vw - 16px));
+  max-height: min(600px, calc(100vh - 16px));
+  padding: 0 8px 10px;
+  overflow-y: auto;
+}
+
+.squisq-mermaid-type-menu-heading {
+  position: sticky;
+  z-index: 1;
+  top: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  margin: 0 -8px 4px;
+  padding: 12px 14px 10px;
+  color: #111827;
+  background: #fff;
+  border-bottom: 1px solid #e5e7eb;
+}
+
+.squisq-mermaid-type-menu-heading strong {
+  font-size: 14px;
+}
+
+.squisq-mermaid-type-menu-heading span {
+  color: #6b7280;
+  font-size: 11px;
+  line-height: 1.35;
+}
+
+.squisq-mermaid-type-section + .squisq-mermaid-type-section {
+  margin-top: 4px;
+}
+
+.squisq-mermaid-type-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 6px;
+}
+
+.squisq-mermaid-type-card {
+  display: grid;
+  grid-template-columns: 82px minmax(0, 1fr);
+  align-items: center;
+  min-width: 0;
+  padding: 8px;
+  color: #1f2937;
+  font: inherit;
+  text-align: left;
+  background: #f9fafb;
+  border: 1px solid #e5e7eb;
+  border-radius: 7px;
+  cursor: pointer;
+}
+
+.squisq-mermaid-type-card:hover,
+.squisq-mermaid-type-card:focus-visible {
+  color: #1d4ed8;
+  background: #eff6ff;
+  border-color: #93c5fd;
+  outline: none;
+}
+
+.squisq-mermaid-type-thumbnail {
+  display: flex;
+  height: 48px;
+  align-items: center;
+  justify-content: center;
+  padding: 3px;
+  color: currentcolor;
+}
+
+.squisq-mermaid-type-thumbnail svg {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+
+.squisq-mermaid-type-copy,
+.squisq-mermaid-type-title {
+  min-width: 0;
+}
+
+.squisq-mermaid-type-copy {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+}
+
+.squisq-mermaid-type-title {
+  display: flex;
+  align-items: center;
+  gap: 5px;
+  font-size: 12px;
+  font-weight: 650;
+}
+
+.squisq-mermaid-type-description {
+  display: -webkit-box;
+  overflow: hidden;
+  color: #6b7280;
+  font-size: 10px;
+  line-height: 1.3;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+}
+
+.squisq-mermaid-type-badge {
+  flex: none;
+  padding: 1px 4px;
+  color: #92400e;
+  font-size: 8px;
+  font-weight: 700;
+  letter-spacing: 0.03em;
+  text-transform: uppercase;
+  background: #fef3c7;
+  border-radius: 999px;
+}
+
+.squisq-mermaid-type-menu[data-theme='dark'] .squisq-mermaid-type-menu-heading {
+  color: #f9fafb;
+  background: #1f2937;
+  border-bottom-color: #374151;
+}
+
+.squisq-mermaid-type-menu[data-theme='dark'] .squisq-mermaid-type-menu-heading span,
+.squisq-mermaid-type-menu[data-theme='dark'] .squisq-mermaid-type-description {
+  color: #9ca3af;
+}
+
+.squisq-mermaid-type-menu[data-theme='dark'] .squisq-mermaid-type-card {
+  color: #e5e7eb;
+  background: #111827;
+  border-color: #374151;
+}
+
+.squisq-mermaid-type-menu[data-theme='dark'] .squisq-mermaid-type-card:hover,
+.squisq-mermaid-type-menu[data-theme='dark'] .squisq-mermaid-type-card:focus-visible {
+  color: #bfdbfe;
+  background: #1e3a5f;
+  border-color: #3b82f6;
+}
+
+@media (max-width: 620px) {
+  .squisq-mermaid-type-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
 .squisq-template-picker {
   display: flex;
   align-items: center;
@@ -1990,6 +2273,7 @@
   /* Body font follows the active squisq theme when one is selected; the
      fallback inherits from the host page when it isn't. */
   font-family: var(--squisq-theme-body-font, inherit);
+  font-size: var(--squisq-write-text-size, inherit);
   /* Explicit caret color so the blinking insertion point stays visible
      even when an ancestor (e.g. a DocBlocks shell with the OS in dark
      mode) inherits a near-white color into the editor. Without this
@@ -2069,6 +2353,15 @@
   margin: 1.6em 0 0.3em;
 }
 
+/* ProseMirror gives an empty text block a trailing <br> so its caret remains
+   visible. Heading controls are siblings of the editable content span, so an
+   uncontained break would temporarily push those controls onto a second line
+   after a Markdown heading shortcut. Keep the break's caret line inside a
+   zero-width inline box until the first heading character replaces it. */
+.squisq-heading-content:has(> br.ProseMirror-trailingBreak:only-child) {
+  display: inline-block;
+}
+
 /* The first block in the document has nothing above it — don't push the top of
    the editor down with the section-break margin. (The editable ProseMirror node
    itself carries the `squisq-wysiwyg-editor` class, so its blocks are direct
@@ -2078,8 +2371,10 @@
 }
 
 .squisq-wysiwyg-editor p {
-  margin: 0.5em 0;
-  line-height: 1.7;
+  /* Slightly roomier paragraph separators make authored blank lines easier
+     to scan without turning each paragraph into a separate card. */
+  margin: 0.625em 0;
+  line-height: var(--squisq-write-line-spacing, 1.7);
 }
 
 .squisq-wysiwyg-editor blockquote {
@@ -2745,6 +3040,31 @@
   --squisq-toolbar-icon: #9ca3af;
 }
 
+.squisq-editor-shell[data-theme='dark'] .squisq-find-field {
+  border-color: #4b5563;
+  background: #111827;
+  color: #9ca3af;
+}
+
+.squisq-editor-shell[data-theme='dark'] .squisq-find-field:focus-within {
+  border-color: #60a5fa;
+  box-shadow: 0 0 0 1px #60a5fa;
+}
+
+.squisq-editor-shell[data-theme='dark'] .squisq-find-input {
+  color: #f9fafb;
+}
+
+.squisq-editor-shell[data-theme='dark'] .squisq-find-input::placeholder,
+.squisq-editor-shell[data-theme='dark'] .squisq-find-count {
+  color: #9ca3af;
+}
+
+.squisq-editor-shell[data-theme='dark'] .squisq-find-button:hover:not(:disabled) {
+  background: rgba(255, 255, 255, 0.1);
+  color: #f9fafb;
+}
+
 .squisq-editor-shell[data-theme='dark'] .squisq-toolbar-view-tabs {
   background: #111827;
   border-right-color: rgba(255, 255, 255, 0.15);

package/src/styles/index.css

@@ -12,6 +12,8 @@
 @import './image-edit-affordance.css';
 @import './diagram.css';
 @import './ascii-diagram.css';
+@import './mermaid-diagram.css';
+@import './code-snippet.css';
 @import './tree-view.css';
 @import './ascii-timeline.css';
 @import '../scene/scene.css';