@lapismd/mira 0.0.4 → 0.1.0

package/dist/preview/components/inline-link.svelte

@@ -0,0 +1,94 @@
+<script lang="ts">
+  import { getContext, type Snippet } from "svelte";
+  import {
+    miraAppearanceContextKey,
+    resolveMiraThemeAttribute,
+    resolveMiraColorModeAttribute,
+    type MiraAppearanceContext,
+  } from "../../internal/appearance-context";
+  import type { HTMLAnchorAttributes } from "svelte/elements";
+  import * as Tooltip from "../../ui/tooltip";
+  import LinkSiteIcon from "./link-site-icon.svelte";
+  import {
+    defaultMiraLinkIconRegistry,
+    parseInlineLinkUrl,
+    type MiraLinkIconRegistry,
+  } from "../../internal/inline-links/registry";
+  let {
+    href = "",
+    label,
+    registry = defaultMiraLinkIconRegistry,
+    children,
+    title,
+    class: className = "",
+    target = "_blank",
+    rel,
+    ref = $bindable(null),
+    tagName: _tagName,
+    sourcePath: _sourcePath,
+    dialog: _dialog,
+    ...rest
+  }: Omit<HTMLAnchorAttributes, "children"> & {
+    registry?: MiraLinkIconRegistry;
+    label?: string;
+    children?: Snippet;
+    ref?: HTMLAnchorElement | null;
+    tagName?: string;
+    sourcePath?: string;
+    dialog?: boolean;
+  } = $props();
+  const safeHref = $derived(parseInlineLinkUrl(href ?? "")?.href);
+  const appearance = getContext<MiraAppearanceContext | undefined>(
+    miraAppearanceContextKey,
+  );
+  const appearanceTheme = $derived(
+    resolveMiraThemeAttribute(appearance?.theme, ref),
+  );
+  const appearanceMode = $derived(
+    resolveMiraColorModeAttribute(appearance?.colorMode, ref),
+  );
+  const showDestination = $derived(
+    Boolean(safeHref && (title || children || (label && label !== href))),
+  );
+  const safeRel = $derived(
+    target === "_blank"
+      ? [
+          ...new Set(`${rel ?? ""} noopener noreferrer`.trim().split(/\s+/u)),
+        ].join(" ")
+      : rel,
+  );
+</script>
+
+<Tooltip.Provider delayDuration={200}>
+  <Tooltip.Root disabled={!showDestination}>
+    <Tooltip.Trigger>
+      {#snippet child({ props })}
+        <a
+          {...props}
+          {...rest}
+          bind:this={ref}
+          class={`mira-inline-link ${className}`.trim()}
+          href={safeHref}
+          {title}
+          {target}
+          rel={safeRel}
+        >
+          {#if safeHref}<LinkSiteIcon href={safeHref} {registry} />{/if}<span
+            >{#if children}{@render children()}{:else}{label || href}{/if}</span
+          >
+        </a>
+      {/snippet}
+    </Tooltip.Trigger>
+    <Tooltip.Content
+      role="tooltip"
+      side="top"
+      sideOffset={6}
+      data-mira-theme={appearanceTheme}
+      data-mira-color-mode={appearanceMode}
+    >
+      {#if title}<span>{title}</span><br />{/if}<span
+        class="mira-inline-link__destination">{safeHref}</span
+      >
+    </Tooltip.Content>
+  </Tooltip.Root>
+</Tooltip.Provider>

package/dist/preview/components/inline-link.svelte.d.ts

@@ -0,0 +1,16 @@
+import { type Snippet } from "svelte";
+import type { HTMLAnchorAttributes } from "svelte/elements";
+import { type MiraLinkIconRegistry } from "../../internal/inline-links/registry";
+type $$ComponentProps = Omit<HTMLAnchorAttributes, "children"> & {
+    registry?: MiraLinkIconRegistry;
+    label?: string;
+    children?: Snippet;
+    ref?: HTMLAnchorElement | null;
+    tagName?: string;
+    sourcePath?: string;
+    dialog?: boolean;
+};
+declare const InlineLink: import("svelte").Component<$$ComponentProps, {}, "ref">;
+type InlineLink = ReturnType<typeof InlineLink>;
+export default InlineLink;
+//# sourceMappingURL=inline-link.svelte.d.ts.map

package/dist/preview/components/inline-link.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-link.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/components/inline-link.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAOlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG5D,OAAO,EAGH,KAAK,oBAAoB,EAC1B,MAAM,sCAAsC,CAAC;AAE/C,KAAK,gBAAgB,GAAI,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,GAAG;IAC/D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AA8DJ,QAAA,MAAM,UAAU,yDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/preview/components/link-destination-tooltip.svelte

@@ -0,0 +1,63 @@
+<script lang="ts">
+  import * as Tooltip from "../../ui/tooltip";
+  let { anchor }: { anchor: HTMLAnchorElement } = $props();
+  const id = $props.id();
+  let open = $state(false);
+  const theme = $derived(
+    anchor.closest<HTMLElement>("[data-mira-theme]")?.dataset.miraTheme,
+  );
+  const colorMode = $derived(
+    anchor.closest<HTMLElement>("[data-mira-color-mode]")?.dataset
+      .miraColorMode,
+  );
+  $effect(() => {
+    const show = () => (open = true);
+    const hide = () => (open = false);
+    const escape = (event: KeyboardEvent) => {
+      if (event.key === "Escape") hide();
+    };
+    anchor.addEventListener("pointerenter", show);
+    anchor.addEventListener("pointerleave", hide);
+    anchor.addEventListener("focus", show);
+    anchor.addEventListener("blur", hide);
+    anchor.addEventListener("keydown", escape);
+    if (anchor.matches(":focus, :hover")) show();
+    return () => {
+      anchor.removeEventListener("pointerenter", show);
+      anchor.removeEventListener("pointerleave", hide);
+      anchor.removeEventListener("focus", show);
+      anchor.removeEventListener("blur", hide);
+      anchor.removeEventListener("keydown", escape);
+    };
+  });
+  $effect(() => {
+    if (!open) return;
+    const previous = anchor.getAttribute("aria-describedby");
+    anchor.setAttribute(
+      "aria-describedby",
+      [previous, id].filter(Boolean).join(" "),
+    );
+    return () => {
+      if (previous) anchor.setAttribute("aria-describedby", previous);
+      else anchor.removeAttribute("aria-describedby");
+    };
+  });
+</script>
+
+<Tooltip.Provider>
+  <Tooltip.Root bind:open>
+    <Tooltip.Content
+      {id}
+      role="tooltip"
+      customAnchor={anchor}
+      side="top"
+      sideOffset={6}
+      data-mira-theme={theme}
+      data-mira-color-mode={colorMode}
+    >
+      {#if anchor.title}<span>{anchor.title}</span><br />{/if}<span
+        class="mira-inline-link__destination">{anchor.href}</span
+      >
+    </Tooltip.Content>
+  </Tooltip.Root>
+</Tooltip.Provider>

package/dist/preview/components/link-destination-tooltip.svelte.d.ts

@@ -0,0 +1,7 @@
+type $$ComponentProps = {
+    anchor: HTMLAnchorElement;
+};
+declare const LinkDestinationTooltip: import("svelte").Component<$$ComponentProps, {}, "">;
+type LinkDestinationTooltip = ReturnType<typeof LinkDestinationTooltip>;
+export default LinkDestinationTooltip;
+//# sourceMappingURL=link-destination-tooltip.svelte.d.ts.map

package/dist/preview/components/link-destination-tooltip.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-destination-tooltip.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/components/link-destination-tooltip.svelte.ts"],"names":[],"mappings":"AAKC,KAAK,gBAAgB,GAAI;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAyDxD,QAAA,MAAM,sBAAsB,sDAAwC,CAAC;AACrE,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACxE,eAAe,sBAAsB,CAAC"}

package/dist/preview/components/link-site-icon.svelte

@@ -0,0 +1,39 @@
+<script lang="ts">
+  import {
+    defaultMiraLinkIconRegistry,
+    type MiraLinkIconRegistry,
+  } from "../../internal/inline-links/registry";
+  let {
+    href,
+    registry = defaultMiraLinkIconRegistry,
+    class: className = "",
+  }: {
+    href: string;
+    registry?: MiraLinkIconRegistry;
+    class?: string;
+  } = $props();
+  const resolved = $derived(registry.resolve(href));
+</script>
+
+{#if resolved?.icon}
+  <svg
+    class={`mira-link-site-icon ${className}`.trim()}
+    data-link-site={resolved.id}
+    viewBox={resolved.icon.viewBox ?? "0 0 24 24"}
+    fill="currentColor"
+    aria-hidden="true"
+    focusable="false"
+  >
+    {#each resolved.icon.paths as path}
+      <path
+        d={path.d}
+        fill={path.fill}
+        stroke={path.stroke}
+        stroke-width={path.strokeWidth}
+        stroke-linecap={path.strokeLinecap}
+        stroke-linejoin={path.strokeLinejoin}
+        fill-rule={path.fillRule}
+      />
+    {/each}
+  </svg>
+{/if}

package/dist/preview/components/link-site-icon.svelte.d.ts

@@ -0,0 +1,10 @@
+import { type MiraLinkIconRegistry } from "../../internal/inline-links/registry";
+type $$ComponentProps = {
+    href: string;
+    registry?: MiraLinkIconRegistry;
+    class?: string;
+};
+declare const LinkSiteIcon: import("svelte").Component<$$ComponentProps, {}, "">;
+type LinkSiteIcon = ReturnType<typeof LinkSiteIcon>;
+export default LinkSiteIcon;
+//# sourceMappingURL=link-site-icon.svelte.d.ts.map

package/dist/preview/components/link-site-icon.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-site-icon.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/components/link-site-icon.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,oBAAoB,EAC1B,MAAM,sCAAsC,CAAC;AAE/C,KAAK,gBAAgB,GAAI;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAqBJ,QAAA,MAAM,YAAY,sDAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/preview/components/link.svelte

@@ -19,6 +19,7 @@
   import { useMarkdownContext } from "../renderer/context.svelte";
   import EditableMarkdownSurface from "../editable-markdown-preview/editable-markdown-surface.svelte";
   import EmbeddedMarkdownPreview from "./embedded-markdown-preview.svelte";
+  import { createAssetUrlLease } from "../asset-url-lease";
 
   type Props = {
     href?: string;
@@ -69,7 +70,9 @@
   const target = $derived(id || href);
   const displayText = $derived(text || label || target);
   const activeSourcePath = $derived(sourcePath || markdown.sourcePath);
-  const parsedTarget = $derived(parseMiraFileTarget(target, activeSourcePath));
+  const parsedTarget = $derived(
+    parseMiraFileTarget(target, activeSourcePath, { decodeUri: !id }),
+  );
   const hasFileAdapter = $derived(Boolean(markdown.fileAdapter));
   const isExternal = $derived(isExternalHref(target));
   const resolvedHref = $derived(
@@ -126,6 +129,14 @@
     ).then(
       (file) => {
         if (!cancelled) {
+          if (
+            resolvedFile?.path === file?.path &&
+            resolvedFile?.name === file?.name &&
+            resolvedFile?.extension === file?.extension &&
+            resolvedFile?.kind === file?.kind
+          ) {
+            return;
+          }
           if (resolvedFile?.path !== file?.path) {
             previewMarkdown = null;
             previewAssetUrl = null;
@@ -174,14 +185,12 @@
     }
 
     let cancelled = false;
-    const markdownPromise = adapter.readMarkdown
-      ? Promise.resolve(adapter.readMarkdown(file))
-      : Promise.resolve(null);
-    const assetPromise = adapter.readAssetUrl
-      ? Promise.resolve(adapter.readAssetUrl(file))
-      : Promise.resolve(null);
+    const markdownPromise = Promise.resolve().then(
+      () => adapter.readMarkdown?.(file) ?? null,
+    );
+    const asset = createAssetUrlLease(adapter, file);
 
-    Promise.all([markdownPromise, assetPromise]).then(
+    Promise.all([markdownPromise, asset.result]).then(
       ([nextMarkdown, nextAssetUrl]) => {
         if (cancelled) {
           return;
@@ -205,6 +214,7 @@
 
     return () => {
       cancelled = true;
+      asset.release();
       stopWatching?.();
     };
   });
@@ -324,7 +334,7 @@
               src={previewAssetUrl}
               alt={resolvedFile.name || displayText}
             />
-          {:else if previewMarkdown}
+          {:else if previewMarkdown !== null}
             {#snippet renderedPreview(value: string)}
               <EmbeddedMarkdownPreview
                 class="mira-link-preview__markdown"

package/dist/preview/components/link.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/components/link.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAqBhD,KAAK,KAAK,GAAG;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1B,CAAC;AAySJ,QAAA,MAAM,IAAI,8CAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}
+{"version":3,"file":"link.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/components/link.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAsBhD,KAAK,KAAK,GAAG;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1B,CAAC;AAmTJ,QAAA,MAAM,IAAI,8CAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}

package/dist/preview/editable-markdown-preview/editable-markdown-surface.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { onDestroy, tick, untrack, type Snippet } from "svelte";
+  import { tick, untrack, type Snippet } from "svelte";
   import type {
     MiraAssetResolver,
     MiraExtension,
@@ -14,6 +14,7 @@
     shouldReturnEditableMarkdownPreviewOnBlur,
   } from "./behavior";
   import EditorSurface from "./editor-surface.svelte";
+  import { attachMarkdownEditingSession } from "./editing-session";
   import {
     SerializedMarkdownWriter,
     type SerializedMarkdownWriterState,
@@ -83,6 +84,7 @@
   let buffer = $state("");
   let pendingOffset = $state<number | null>(null);
   let writerState = $state<SerializedMarkdownWriterState>({
+    readonly: false,
     dirty: false,
     saving: false,
     error: null,
@@ -94,7 +96,7 @@
   let previewScrollRatio = 0;
   let editorScrollRatio = 0;
 
-  const writable = $derived(Boolean(writeMarkdown));
+  const writable = $derived(Boolean(writeMarkdown) && !writerState.readonly);
 
   $effect(() => {
     previewOnChange = writable ? updatePreviewRange : undefined;
@@ -106,15 +108,16 @@
   $effect(() => {
     const write = writeMarkdown;
     const key = sourcePath;
+    const adapter = fileAdapter;
     const initialValue = untrack(() => value);
     key;
 
-    writer?.destroy();
     writer = null;
     buffer = initialValue;
     lastExternalValue = initialValue;
     lastPersistedNotification = initialValue;
     writerState = {
+      readonly: false,
       dirty: false,
       saving: false,
       error: null,
@@ -127,10 +130,13 @@
       return;
     }
 
+    let current = true;
+    let persist = write;
     const activeWriter = new SerializedMarkdownWriter({
       value: initialValue,
-      write,
+      write: (contents) => persist(contents),
       onStateChange(state) {
+        if (!current) return;
         writerState = state;
         buffer = state.value;
         if (state.persistedValue !== lastPersistedNotification) {
@@ -140,9 +146,22 @@
       },
     });
     writer = activeWriter;
+    const attached = attachMarkdownEditingSession({
+      writer: activeWriter,
+      sourcePath: key,
+      register: adapter?.registerEditingSession
+        ? (path, session) => adapter.registerEditingSession?.(path, session)
+        : undefined,
+      bind: adapter?.bindMarkdownEditingSession
+        ? (path, session) => adapter.bindMarkdownEditingSession!(path, session)
+        : undefined,
+      synchronizeProtection: tick,
+    });
+    persist = attached.write ?? write;
 
     return () => {
-      activeWriter.destroy();
+      current = false;
+      attached.detach();
       if (writer === activeWriter) {
         writer = null;
       }
@@ -251,8 +270,8 @@
   }
 
   function updateBuffer(nextValue: string): void {
+    if (!writer?.update(nextValue)) return;
     buffer = nextValue;
-    writer?.update(nextValue);
   }
 
   function updatePreviewRange(
@@ -316,10 +335,6 @@
     await leaveEditing("blur");
     return !editing;
   }
-
-  onDestroy(() => {
-    writer?.destroy();
-  });
 </script>
 
 <div
@@ -342,6 +357,7 @@
     >
       <EditorSurface
         value={buffer}
+        readonly={writerState.readonly}
         {extensions}
         {sourcePath}
         {linkResolver}

package/dist/preview/editable-markdown-preview/editable-markdown-surface.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editable-markdown-surface.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/editable-markdown-preview/editable-markdown-surface.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,KAAK,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,2BAA2B,EAC5B,MAAM,0BAA0B,CAAC;AAalC,KAAK,mBAAmB,GAAG,CACzB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,KACP,IAAI,CAAC;AAEV,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3B,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACrE,CAAC;AAsTJ,QAAA,MAAM,uBAAuB;iBA9CF,OAAO,CAAC,OAAO,CAAC;gBAIjB,OAAO,CAAC,OAAO,CAAC;iCA0C2B,CAAC;AACtE,KAAK,uBAAuB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC1E,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"editable-markdown-surface.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/editable-markdown-preview/editable-markdown-surface.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,KAAK,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,2BAA2B,EAC5B,MAAM,0BAA0B,CAAC;AAclC,KAAK,mBAAmB,GAAG,CACzB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,KACP,IAAI,CAAC;AAEV,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3B,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACrE,CAAC;AAqUJ,QAAA,MAAM,uBAAuB;iBA1CF,OAAO,CAAC,OAAO,CAAC;gBAIjB,OAAO,CAAC,OAAO,CAAC;iCAsC2B,CAAC;AACtE,KAAK,uBAAuB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC1E,eAAe,uBAAuB,CAAC"}

package/dist/preview/editable-markdown-preview/editing-session.d.ts

@@ -0,0 +1,15 @@
+import type { MiraFileAdapter, MiraMarkdownEditingSession } from "../../extensions";
+import type { SerializedMarkdownWriter } from "./serialized-writer";
+/** Retain detached writers until persistence succeeds so external operations can join them. */
+export declare function attachMarkdownEditingSession(options: {
+    writer: SerializedMarkdownWriter;
+    sourcePath?: string;
+    register?: MiraFileAdapter["registerEditingSession"];
+    bind?: MiraFileAdapter["bindMarkdownEditingSession"];
+    synchronizeProtection?: () => Promise<void>;
+}): {
+    session: MiraMarkdownEditingSession;
+    write?: (value: string) => void | Promise<void>;
+    detach(): void;
+};
+//# sourceMappingURL=editing-session.d.ts.map

package/dist/preview/editable-markdown-preview/editing-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing-session.d.ts","sourceRoot":"","sources":["../../../src/preview/editable-markdown-preview/editing-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,0BAA0B,EAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,+FAA+F;AAC/F,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,MAAM,EAAE,wBAAwB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAC,wBAAwB,CAAC,CAAC;IACrD,IAAI,CAAC,EAAE,eAAe,CAAC,4BAA4B,CAAC,CAAC;IACrD,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,GAAG;IACF,OAAO,EAAE,0BAA0B,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,IAAI,IAAI,CAAC;CAChB,CAiGA"}

package/dist/preview/editable-markdown-preview/editing-session.js

@@ -0,0 +1,103 @@
+/** Retain detached writers until persistence succeeds so external operations can join them. */
+export function attachMarkdownEditingSession(options) {
+    const { writer } = options;
+    let detached = false;
+    let remove;
+    let stop;
+    let releaseError;
+    let write;
+    function releaseIfClean() {
+        const state = writer.state;
+        if (!detached || state.dirty || state.saving || state.error !== null)
+            return;
+        try {
+            remove?.();
+            remove = undefined;
+            releaseError = undefined;
+            stop?.();
+            stop = undefined;
+        }
+        catch (error) {
+            releaseError = error ?? new Error("Markdown binding release failed");
+        }
+    }
+    const session = {
+        get dirty() {
+            const state = writer.state;
+            return (state.dirty ||
+                state.saving ||
+                state.error !== null ||
+                releaseError !== undefined);
+        },
+        async flush() {
+            if (!(await writer.flush()))
+                throw writer.state.error ?? new Error("Unable to save Markdown");
+            releaseIfClean();
+            if (releaseError !== undefined)
+                throw releaseError;
+        },
+        async protect() {
+            const release = await writer.protect();
+            try {
+                await options.synchronizeProtection?.();
+                return release;
+            }
+            catch (error) {
+                release();
+                throw error;
+            }
+        },
+        text: {
+            get state() {
+                return writer.state;
+            },
+            subscribe: (listener) => writer.subscribe(listener),
+            async protectRecovery() {
+                const lease = await writer.protectRecovery();
+                try {
+                    await options.synchronizeProtection?.();
+                    return lease;
+                }
+                catch (error) {
+                    lease.release();
+                    throw error;
+                }
+            },
+        },
+    };
+    try {
+        if (options.bind) {
+            if (!options.sourcePath)
+                throw new Error("A Markdown binding requires a stable source path");
+            const binding = options.bind(options.sourcePath, session);
+            if (!binding ||
+                typeof binding.write !== "function" ||
+                typeof binding.release !== "function") {
+                if (typeof binding?.release === "function")
+                    binding.release();
+                throw new Error("Invalid Markdown editing binding");
+            }
+            remove = () => binding.release();
+            write = (value) => binding.write(value);
+        }
+        else if (options.sourcePath)
+            remove = options.register?.(options.sourcePath, session);
+        stop = writer.subscribe(releaseIfClean);
+    }
+    catch (error) {
+        writer.destroy();
+        throw error;
+    }
+    return {
+        session,
+        write,
+        detach() {
+            if (detached)
+                return;
+            detached = true;
+            writer.destroy();
+            // A failed detached save remains discoverable, with the writer's error retained.
+            void session.flush().catch(() => undefined);
+        },
+    };
+}

package/dist/preview/editable-markdown-preview/editor-surface.svelte

@@ -22,6 +22,7 @@
 
   type Props = {
     value: string;
+    readonly?: boolean;
     extensions?: MiraExtension[];
     sourcePath?: string;
     linkResolver?: MiraLinkResolver;
@@ -40,6 +41,7 @@
 
   let {
     value,
+    readonly = false,
     extensions = [],
     sourcePath,
     linkResolver,
@@ -63,13 +65,14 @@
   const resolvedExtensions = $derived(
     resolveMiraExtensions(extensions, {
       mode: "live-preview",
-      readonly: false,
+      readonly,
       sourcePath,
     }),
   );
   const extensionSignature = $derived(
     [
       sourcePath,
+      readonly,
       frontmatterOpen,
       JSON.stringify({ authoring, frontmatterConfig, imageConfig }),
       extensions.map((extension) => extension.name).join(","),
@@ -85,15 +88,17 @@
     return {
       view,
       mode: "live-preview",
-      readonly: false,
+      readonly,
       sourcePath,
       getValue: () => activeEditor?.getValue() ?? value,
       setValue(nextValue) {
+        if (readonly) return;
         activeEditor?.setValue(nextValue);
         onChange?.(nextValue);
       },
       focus: () => activeEditor?.focus(),
       insertMarkdown(markdown, selection) {
+        if (readonly) return;
         activeEditor?.replaceSelection(markdown, selection);
         activeEditor?.focus();
       },
@@ -104,7 +109,7 @@
     return createMiraCodeMirrorExtensions({
       includeBaseExtensions: false,
       mode: "live-preview",
-      readonly: false,
+      readonly,
       lineWrapping: true,
       spellcheck: true,
       blockControls: false,
@@ -122,6 +127,7 @@
       frontmatterConfig,
       runtimeContext: (view) => runtimeContext(codeEditor, view),
       onChange(replacement, from, to) {
+        if (readonly) return;
         codeEditor?.getView()?.dispatch({
           changes: { from, to, insert: replacement },
         });
@@ -212,6 +218,7 @@
   <MiraCodeEditor
     bind:this={codeEditor}
     {value}
+    {readonly}
     extensions={codeMirrorExtensions}
     lineWrapping={true}
     spellcheck={true}
@@ -223,6 +230,8 @@
     height="fill"
     minHeight="100%"
     class="mira-editable-markdown-preview__editor-host"
-    onChange={(nextValue) => onChange?.(nextValue)}
+    onChange={(nextValue) => {
+      if (!readonly) onChange?.(nextValue);
+    }}
   />
 </div>

package/dist/preview/editable-markdown-preview/editor-surface.svelte.d.ts

@@ -1,6 +1,7 @@
 import { type MiraAssetResolver, type MiraExtension, type MiraFileAdapter, type MiraImageConfig, type MiraLinkResolver, type MiraMarkdownAuthoringConfig } from "@lapismd/mira/extensions";
 type Props = {
     value: string;
+    readonly?: boolean;
     extensions?: MiraExtension[];
     sourcePath?: string;
     linkResolver?: MiraLinkResolver;

package/dist/preview/editable-markdown-preview/editor-surface.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor-surface.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/editable-markdown-preview/editor-surface.svelte.ts"],"names":[],"mappings":"AAUA,OAAO,EAGH,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAElB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EACjC,MAAM,0BAA0B,CAAC;AAKlC,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAsLJ,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"editor-surface.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/editable-markdown-preview/editor-surface.svelte.ts"],"names":[],"mappings":"AAUA,OAAO,EAGH,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAElB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EACjC,MAAM,0BAA0B,CAAC;AAKlC,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AA6LJ,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}