@lapismd/mira 0.0.5 → 0.1.1

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

@@ -1 +1 @@
-{"version":3,"file":"image.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/components/image.svelte.ts"],"names":[],"mappings":"AAaE,KAAK,KAAK,GAAG;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC/B,CAAC;AAgNJ,QAAA,MAAM,KAAK,8CAAwC,CAAC;AACpD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,eAAe,KAAK,CAAC"}
+{"version":3,"file":"image.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/components/image.svelte.ts"],"names":[],"mappings":"AAcE,KAAK,KAAK,GAAG;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC/B,CAAC;AAqNJ,QAAA,MAAM,KAAK,8CAAwC,CAAC;AACpD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,eAAe,KAAK,CAAC"}

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

@@ -131,9 +131,10 @@
     }
 
     let current = true;
+    let persist = write;
     const activeWriter = new SerializedMarkdownWriter({
       value: initialValue,
-      write,
+      write: (contents) => persist(contents),
       onStateChange(state) {
         if (!current) return;
         writerState = state;
@@ -151,8 +152,12 @@
       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 () => {
       current = false;

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,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;AAgUJ,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"}
+{"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

@@ -5,9 +5,11 @@ 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

@@ -1 +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,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,GAAG;IAAE,OAAO,EAAE,0BAA0B,CAAC;IAAC,MAAM,IAAI,IAAI,CAAA;CAAE,CA6C1D"}
+{"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

@@ -3,18 +3,38 @@ 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;
+            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");
-            if (detached && remove) {
-                remove();
-                remove = undefined;
-            }
+            releaseIfClean();
+            if (releaseError !== undefined)
+                throw releaseError;
         },
         async protect() {
             const release = await writer.protect();
@@ -27,10 +47,42 @@ export function attachMarkdownEditingSession(options) {
                 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.sourcePath)
+        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();
@@ -38,6 +90,7 @@ export function attachMarkdownEditingSession(options) {
     }
     return {
         session,
+        write,
         detach() {
             if (detached)
                 return;

package/dist/preview/editable-markdown-preview/serialized-writer.d.ts

@@ -1,11 +1,5 @@
-export type SerializedMarkdownWriterState = {
-    readonly: boolean;
-    dirty: boolean;
-    saving: boolean;
-    error: Error | null;
-    value: string;
-    persistedValue: string;
-};
+import type { MiraMarkdownRecoveryLease, MiraMarkdownTextState } from "../../extensions/markdown-editing";
+export type SerializedMarkdownWriterState = MiraMarkdownTextState;
 type Options = {
     value: string;
     write: (value: string) => void | Promise<void>;
@@ -22,11 +16,15 @@ export declare class SerializedMarkdownWriter {
     private persistedValue;
     private saving;
     private protections;
+    private recoveries;
+    private readonly listeners;
     private destroyed;
     private error;
     constructor(options: Options);
     get state(): SerializedMarkdownWriterState;
     update(value: string): boolean;
+    subscribe(listener: (state: SerializedMarkdownWriterState) => void): () => void;
+    protectRecovery(): Promise<MiraMarkdownRecoveryLease>;
     protect(): Promise<() => void>;
     replaceExternal(value: string): boolean;
     flush(): Promise<boolean>;

package/dist/preview/editable-markdown-preview/serialized-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialized-writer.d.ts","sourceRoot":"","sources":["../../../src/preview/editable-markdown-preview/serialized-writer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,OAAO,GAAG;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IAEzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAA2B;IAE1D,OAAO,CAAC,KAAK,CAA8C;IAE3D,OAAO,CAAC,YAAY,CAAiC;IAErD,OAAO,CAAC,KAAK,CAAS;IAEtB,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,KAAK,CAAsB;gBAEvB,OAAO,EAAE,OAAO;IAS5B,IAAI,KAAK,IAAI,6BAA6B,CASzC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IASxB,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IAoBpC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAYjC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB/B,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,QAAQ;YAYF,WAAW;IA0BzB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,IAAI;CAGb"}
+{"version":3,"file":"serialized-writer.d.ts","sourceRoot":"","sources":["../../../src/preview/editable-markdown-preview/serialized-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,mCAAmC,CAAC;AAC3C,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAElE,KAAK,OAAO,GAAG;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IAEzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAA2B;IAE1D,OAAO,CAAC,KAAK,CAA8C;IAE3D,OAAO,CAAC,YAAY,CAAiC;IAErD,OAAO,CAAC,KAAK,CAAS;IAEtB,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAEtB;IAEJ,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,KAAK,CAAsB;gBAEvB,OAAO,EAAE,OAAO;IAS5B,IAAI,KAAK,IAAI,6BAA6B,CASzC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQ9B,SAAS,CACP,QAAQ,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,IAAI,GACvD,MAAM,IAAI;IAQP,eAAe,IAAI,OAAO,CAAC,yBAAyB,CAAC;IA2CrD,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IAoBpC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAiBjC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IA0B/B,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,QAAQ;YAYF,WAAW;IA2BzB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,IAAI;CAIb"}

package/dist/preview/editable-markdown-preview/serialized-writer.js

@@ -8,6 +8,8 @@ export class SerializedMarkdownWriter {
     persistedValue;
     saving = false;
     protections = 0;
+    recoveries = 0;
+    listeners = new Set();
     destroyed = false;
     error = null;
     constructor(options) {
@@ -32,11 +34,63 @@ export class SerializedMarkdownWriter {
         if (this.protections > 0 || this.destroyed)
             return false;
         this.value = value;
-        this.error = null;
         this.schedule();
         this.emit();
         return true;
     }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.state);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    async protectRecovery() {
+        this.protections++;
+        this.recoveries++;
+        let active = true;
+        const release = () => {
+            if (!active)
+                return;
+            active = false;
+            this.protections--;
+            this.recoveries--;
+            this.emit();
+        };
+        const assertHeld = () => {
+            if (!active)
+                throw new Error("Markdown recovery lease expired");
+            if (this.saving)
+                throw new Error("Markdown recovery must settle persistence first");
+        };
+        try {
+            this.clearTimer();
+            this.emit();
+            const flight = this.flushPromise;
+            if (flight)
+                await flight;
+            return {
+                acceptLocal: () => {
+                    assertHeld();
+                    this.persistedValue = this.value;
+                    this.error = null;
+                    this.emit();
+                },
+                useExternal: (value) => {
+                    assertHeld();
+                    this.value = value;
+                    this.persistedValue = value;
+                    this.error = null;
+                    this.emit();
+                },
+                release,
+            };
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+    }
     async protect() {
         this.protections++;
         this.emit();
@@ -59,7 +113,10 @@ export class SerializedMarkdownWriter {
         }
     }
     replaceExternal(value) {
-        if (this.state.dirty || this.saving) {
+        if (this.recoveries > 0 ||
+            this.state.dirty ||
+            this.saving ||
+            this.error !== null) {
             return false;
         }
         this.value = value;
@@ -70,6 +127,8 @@ export class SerializedMarkdownWriter {
     }
     async flush() {
         this.clearTimer();
+        if (this.recoveries > 0)
+            return false;
         if (this.flushPromise) {
             const saved = await this.flushPromise;
             if (!saved) {
@@ -77,7 +136,14 @@ export class SerializedMarkdownWriter {
             }
             return this.state.dirty ? this.flush() : true;
         }
-        this.flushPromise = this.flushLatest();
+        // Reserve the flight before notifying subscribers, which may request recovery.
+        let resolve;
+        let reject;
+        this.flushPromise = new Promise((done, fail) => {
+            resolve = done;
+            reject = fail;
+        });
+        void this.flushLatest().then(resolve, reject);
         try {
             return await this.flushPromise;
         }
@@ -89,13 +155,13 @@ export class SerializedMarkdownWriter {
         this.destroyed = true;
         this.clearTimer();
         this.emit();
-        if (this.state.dirty) {
+        if (this.state.dirty || this.error !== null) {
             void this.flush();
         }
     }
     schedule() {
         this.clearTimer();
-        if (!this.state.dirty) {
+        if (!this.state.dirty && this.error === null) {
             return;
         }
         this.timer = setTimeout(() => {
@@ -104,7 +170,9 @@ export class SerializedMarkdownWriter {
         }, this.delay);
     }
     async flushLatest() {
-        while (this.value !== this.persistedValue) {
+        while (this.value !== this.persistedValue || this.error !== null) {
+            if (this.recoveries > 0)
+                return false;
             const snapshot = this.value;
             this.saving = true;
             this.error = null;
@@ -134,5 +202,7 @@ export class SerializedMarkdownWriter {
     }
     emit() {
         this.onStateChange?.(this.state);
+        for (const listener of this.listeners)
+            listener(this.state);
     }
 }