react-obsidian-md 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Adriano Araújo (adrianoaraujodsantos@hotmail.com).
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,27 @@
-# Temporary Holding Version
+# react-obsidian-md
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Headless React components for Obsidian.md content: a collapsible **Properties Panel** with persisted state, a **Hover Preview** popover, and the client helpers that fetch a **Preview Payload**. It ships no CSS; style it with your own.
+
+Terms follow the [glossary](../../GLOSSARY.md). Pair it with [`remark-obsidian-md`](../remark-obsidian-md), and with [`fumadocs-obsidian-md`](../fumadocs-obsidian-md) for the Fumadocs side of previews.
+
+## Installation
+
+```sh
+pnpm add react-obsidian-md
+```
+
+`react`, `react-dom` and `remark-obsidian-md` are peer dependencies.
+
+## What it exports
+
+- `ObsidianProvider` / `useObsidian`: context that configures the components.
+- `PropertiesPanel`, `Properties`, `FormattedDate`: render a Note's Frontmatter properties; the panel remembers whether the reader left it open (`PAGE_PROPERTIES_KEY`, `PREVIEW_PROPERTIES_KEY`).
+- `HoverPreview`, `PreviewBody`: open a preview of the Note an internal link points to, nested to any depth.
+- `fetchPreviewPayload`, `slicePreviewHtml`, `previewPayloadUrl`, `PREVIEW_PATH` and the `PreviewPayload` type: the client side of the static Preview Payload described in [ADR 0009](../../docs/adr/0009-static-preview-payload.md).
+- `Collapsible`, `CollapsiblePanel`, `CollapsibleTrigger`, `usePersistedOpen`: the building blocks.
+
+See [`examples/fumadocs`](../../examples/fumadocs) for a complete usage, including styling.
+
+## License
+
+MIT

package/dist/collapsible.d.ts

@@ -0,0 +1,6 @@
+import { Collapsible as CollapsiblePrimitive } from "@base-ui/react/collapsible";
+/** Base UI's Collapsible with stable `data-slot` hooks and no styles. */
+export declare function Collapsible(props: CollapsiblePrimitive.Root.Props): import("react").JSX.Element;
+export declare function CollapsibleTrigger(props: CollapsiblePrimitive.Trigger.Props): import("react").JSX.Element;
+export declare function CollapsiblePanel(props: CollapsiblePrimitive.Panel.Props): import("react").JSX.Element;
+//# sourceMappingURL=collapsible.d.ts.map

package/dist/collapsible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapsible.d.ts","sourceRoot":"","sources":["../src/collapsible.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEjF,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,KAAK,EAAE,oBAAoB,CAAC,IAAI,CAAC,KAAK,+BAEjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,KAAK,+BAI3E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,+BAIvE"}

package/dist/collapsible.js

@@ -0,0 +1,14 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Collapsible as CollapsiblePrimitive } from "@base-ui/react/collapsible";
+/** Base UI's Collapsible with stable `data-slot` hooks and no styles. */
+export function Collapsible(props) {
+    return _jsx(CollapsiblePrimitive.Root, { "data-slot": "collapsible", ...props });
+}
+export function CollapsibleTrigger(props) {
+    return (_jsx(CollapsiblePrimitive.Trigger, { "data-slot": "collapsible-trigger", ...props }));
+}
+export function CollapsiblePanel(props) {
+    return (_jsx(CollapsiblePrimitive.Panel, { "data-slot": "collapsible-content", ...props }));
+}
+//# sourceMappingURL=collapsible.js.map

package/dist/collapsible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapsible.js","sourceRoot":"","sources":["../src/collapsible.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEjF,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,KAAsC;IAChE,OAAO,KAAC,oBAAoB,CAAC,IAAI,iBAAW,aAAa,KAAK,KAAK,GAAI,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAyC;IAC1E,OAAO,CACL,KAAC,oBAAoB,CAAC,OAAO,iBAAW,qBAAqB,KAAK,KAAK,GAAI,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAuC;IACtE,OAAO,CACL,KAAC,oBAAoB,CAAC,KAAK,iBAAW,qBAAqB,KAAK,KAAK,GAAI,CAC1E,CAAC;AACJ,CAAC"}

package/dist/formatted-date.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Numeric date through `Intl.DateTimeFormat` (e.g. `17/02/2026, 11:33` in
+ * pt-BR, `2/17/2026, 11:33 AM` in en-US). The server cannot know the visitor's
+ * locale, so the ISO string renders first and the formatted value swaps in
+ * after hydration: no hydration mismatch, no layout shift.
+ *
+ * `locales` defaults to the browser's locale; `options` replaces the default
+ * numeric format (a datetime still gets its time unless `options` says
+ * otherwise).
+ */
+export declare function FormattedDate({ date, kind, locales, options, }: {
+    date: string;
+    kind: "date" | "datetime";
+    locales?: Intl.LocalesArgument;
+    options?: Intl.DateTimeFormatOptions;
+}): import("react").JSX.Element;
+//# sourceMappingURL=formatted-date.d.ts.map

package/dist/formatted-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatted-date.d.ts","sourceRoot":"","sources":["../src/formatted-date.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC;IAC/B,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC;CACtC,+BA8BA"}

package/dist/formatted-date.js

@@ -0,0 +1,34 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+/**
+ * Numeric date through `Intl.DateTimeFormat` (e.g. `17/02/2026, 11:33` in
+ * pt-BR, `2/17/2026, 11:33 AM` in en-US). The server cannot know the visitor's
+ * locale, so the ISO string renders first and the formatted value swaps in
+ * after hydration: no hydration mismatch, no layout shift.
+ *
+ * `locales` defaults to the browser's locale; `options` replaces the default
+ * numeric format (a datetime still gets its time unless `options` says
+ * otherwise).
+ */
+export function FormattedDate({ date, kind, locales, options, }) {
+    const [text, setText] = useState(date);
+    const optionsKey = JSON.stringify(options ?? null);
+    const localesKey = JSON.stringify(locales ?? null);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: the keys stand for the objects
+    useEffect(() => {
+        // `T00:00` keeps a date-only value in the local day: `new Date("2025-02-03")`
+        // is UTC midnight and would render as the previous day west of UTC.
+        const parsed = kind === "date" ? new Date(`${date}T00:00`) : new Date(date);
+        setText(new Intl.DateTimeFormat(locales, options ?? {
+            year: "numeric",
+            month: "numeric",
+            day: "numeric",
+            ...(kind === "datetime"
+                ? { hour: "numeric", minute: "2-digit" }
+                : {}),
+        }).format(parsed));
+    }, [date, kind, localesKey, optionsKey]);
+    return (_jsx("time", { "data-property-date": kind, dateTime: date, children: text }));
+}
+//# sourceMappingURL=formatted-date.js.map

package/dist/formatted-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatted-date.js","sourceRoot":"","sources":["../src/formatted-date.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,GAMR;IACC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;IAEnD,0FAA0F;IAC1F,SAAS,CAAC,GAAG,EAAE;QACb,8EAA8E;QAC9E,oEAAoE;QACpE,MAAM,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,OAAO,CACL,IAAI,IAAI,CAAC,cAAc,CACrB,OAAO,EACP,OAAO,IAAI;YACT,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,GAAG,CAAC,IAAI,KAAK,UAAU;gBACrB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;gBACxC,CAAC,CAAC,EAAE,CAAC;SACR,CACF,CAAC,MAAM,CAAC,MAAM,CAAC,CACjB,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzC,OAAO,CACL,qCAA0B,IAAI,EAAE,QAAQ,EAAE,IAAI,YAC3C,IAAI,GACA,CACR,CAAC;AACJ,CAAC"}

package/dist/hover-preview.d.ts

@@ -0,0 +1,13 @@
+import { type ComponentProps, type ReactNode } from "react";
+/**
+ * An internal link that shows a Hover Preview of the Note it points at.
+ * `slug` is the target Note's Slug and `subpath` the link's Subpath (the part
+ * after `#`), which picks the part of the Note the preview shows.
+ */
+export declare function HoverPreview({ href, slug, subpath, children, ...props }: Omit<ComponentProps<"a">, "href"> & {
+    href: string;
+    slug: string[];
+    subpath?: string | undefined;
+    children?: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=hover-preview.d.ts.map

package/dist/hover-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-preview.d.ts","sourceRoot":"","sources":["../src/hover-preview.tsx"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAmEf;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,+BAuGA"}

package/dist/hover-preview.js

@@ -0,0 +1,107 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PreviewCard } from "@base-ui/react/preview-card";
+import { createContext, useCallback, useContext, useEffect, useRef, useState, useSyncExternalStore, } from "react";
+import { PreviewBody } from "./preview-body.js";
+import { fetchPreviewPayload } from "./preview-client.js";
+import { slicePreviewHtml } from "./preview-slice.js";
+import { PREVIEW_PROPERTIES_KEY } from "./properties-keys.js";
+import { useObsidian } from "./provider.js";
+import { slugKey } from "./slug-key.js";
+/**
+ * Lets a preview tell the one that holds it (the link it sits in belongs to
+ * that preview's body) that it closed, so the parent can close too when the
+ * pointer left everything while the nested preview was keeping it open.
+ */
+const ChildClosedContext = createContext(null);
+const OPEN_DELAY = 300;
+const CLOSE_DELAY = 150;
+function PreviewContent({ payload, subpath, }) {
+    const html = slicePreviewHtml(payload.html, subpath);
+    const { renderProperties, previewBodyClassName } = useObsidian();
+    return (_jsxs("div", { "data-hover-preview-content": "", children: [renderProperties({
+                defaultOpen: false,
+                noFlash: false,
+                properties: payload.properties,
+                storageKey: PREVIEW_PROPERTIES_KEY,
+            }), _jsx("div", { className: previewBodyClassName || undefined, "data-hover-preview-body": "", children: _jsx(PreviewBody, { html: html }) })] }));
+}
+const HOVER_QUERY = "(hover: hover)";
+function subscribeHover(onChange) {
+    const query = window.matchMedia(HOVER_QUERY);
+    query.addEventListener("change", onChange);
+    return () => query.removeEventListener("change", onChange);
+}
+/** Touch devices have no hover, so their links stay plain links. */
+function useCanHover() {
+    return useSyncExternalStore(subscribeHover, () => window.matchMedia(HOVER_QUERY).matches, () => true);
+}
+/**
+ * An internal link that shows a Hover Preview of the Note it points at.
+ * `slug` is the target Note's Slug and `subpath` the link's Subpath (the part
+ * after `#`), which picks the part of the Note the preview shows.
+ */
+export function HoverPreview({ href, slug, subpath, children, ...props }) {
+    const { linkComponent: Link, previewPayloadUrl } = useObsidian();
+    const canHover = useCanHover();
+    const [payload, setPayload] = useState(null);
+    const [wantOpen, setWantOpen] = useState(false);
+    const key = slugKey(slug);
+    const notifyParent = useContext(ChildClosedContext);
+    const isOpen = wantOpen && payload !== null;
+    // What the reader's pointer or focus is on: the link or the popup, by
+    // pointer or by focus. The popup's React events also cover the nested
+    // previews portaled out of it, so "inside the popup" means anywhere in the
+    // nested chain, for focus as well as for the pointer.
+    const presence = useRef(new Set());
+    const closeTimer = useRef(undefined);
+    const setPresence = (part, input, present) => {
+        const id = `${part}:${input}`;
+        if (present) {
+            presence.current.add(id);
+            clearTimeout(closeTimer.current);
+        }
+        else {
+            presence.current.delete(id);
+        }
+    };
+    const onChildClosed = useCallback(() => {
+        if (presence.current.size > 0)
+            return;
+        clearTimeout(closeTimer.current);
+        closeTimer.current = setTimeout(() => setWantOpen(false), CLOSE_DELAY);
+    }, []);
+    useEffect(() => () => clearTimeout(closeTimer.current), []);
+    const wasOpen = useRef(false);
+    useEffect(() => {
+        if (wasOpen.current && !isOpen)
+            notifyParent?.();
+        wasOpen.current = isOpen;
+    }, [isOpen, notifyParent]);
+    // Starts on pointer enter or focus, in parallel with the open delay. A
+    // failure opens nothing and is not cached, so the next hover retries.
+    // biome-ignore lint/correctness/useExhaustiveDependencies: `key` identifies `slug`
+    const load = useCallback(() => {
+        fetchPreviewPayload(slug, previewPayloadUrl).then(setPayload, () => setWantOpen(false));
+    }, [key, previewPayloadUrl]);
+    // Leaving before the content has arrived means the preview never opens.
+    const cancelPending = useCallback(() => {
+        if (!payload)
+            setWantOpen(false);
+    }, [payload]);
+    // Hovering or focusing the link starts loading its payload; leaving it
+    // before the payload has arrived cancels the preview.
+    const enter = (input) => {
+        setPresence("trigger", input, true);
+        load();
+    };
+    const leave = (input) => {
+        setPresence("trigger", input, false);
+        cancelPending();
+    };
+    if (!canHover) {
+        return (_jsx(Link, { href: href, ...props, children: children }));
+    }
+    return (_jsxs(PreviewCard.Root, { onOpenChange: (next) => setWantOpen(next), open: isOpen, children: [_jsx(PreviewCard.Trigger, { closeDelay: CLOSE_DELAY, delay: OPEN_DELAY, onBlur: () => leave("focus"), onFocus: () => enter("focus"), onPointerEnter: () => enter("pointer"), onPointerLeave: () => leave("pointer"), render: _jsx(Link, { href: href, ...props }), children: children }), _jsx(PreviewCard.Portal, { children: _jsx(PreviewCard.Positioner, { "data-hover-preview-positioner": "", sideOffset: 8, children: _jsx(PreviewCard.Popup, { "data-hover-preview": "", "data-testid": "hover-preview", onBlur: () => setPresence("popup", "focus", false), onFocus: () => setPresence("popup", "focus", true), onPointerEnter: () => setPresence("popup", "pointer", true), onPointerLeave: () => setPresence("popup", "pointer", false), children: _jsx(ChildClosedContext.Provider, { value: onChildClosed, children: payload && (_jsx(PreviewContent, { payload: payload, subpath: subpath })) }) }) }) })] }));
+}
+//# sourceMappingURL=hover-preview.js.map

package/dist/hover-preview.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { Collapsible, CollapsiblePanel, CollapsibleTrigger, } from "./collapsible.js";
+export { FormattedDate } from "./formatted-date.js";
+export { HoverPreview } from "./hover-preview.js";
+export { PreviewBody } from "./preview-body.js";
+export { fetchPreviewPayload } from "./preview-client.js";
+export { slicePreviewHtml } from "./preview-slice.js";
+export { PREVIEW_PATH, PREVIEW_SLUG_ATTR, PREVIEW_SUBPATH_ATTR, type PreviewPayload, previewPayloadUrl, } from "./preview-types.js";
+export { Properties, type PropertiesIcons } from "./properties.js";
+export { PAGE_PROPERTIES_KEY, PREVIEW_PROPERTIES_KEY, } from "./properties-keys.js";
+export { PropertiesPanel } from "./properties-panel.js";
+export { type ObsidianContextValue, ObsidianProvider, type PreviewPropertiesProps, useObsidian, } from "./provider.js";
+export { slugFromKey, slugKey } from "./slug-key.js";
+export { persistedOpenScript, usePersistedOpen } from "./use-persisted-open.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,cAAc,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,KAAK,oBAAoB,EACzB,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { Collapsible, CollapsiblePanel, CollapsibleTrigger, } from "./collapsible.js";
+export { FormattedDate } from "./formatted-date.js";
+export { HoverPreview } from "./hover-preview.js";
+export { PreviewBody } from "./preview-body.js";
+export { fetchPreviewPayload } from "./preview-client.js";
+export { slicePreviewHtml } from "./preview-slice.js";
+export { PREVIEW_PATH, PREVIEW_SLUG_ATTR, PREVIEW_SUBPATH_ATTR, previewPayloadUrl, } from "./preview-types.js";
+export { Properties } from "./properties.js";
+export { PAGE_PROPERTIES_KEY, PREVIEW_PROPERTIES_KEY, } from "./properties-keys.js";
+export { PropertiesPanel } from "./properties-panel.js";
+export { ObsidianProvider, useObsidian, } from "./provider.js";
+export { slugFromKey, slugKey } from "./slug-key.js";
+export { persistedOpenScript, usePersistedOpen } from "./use-persisted-open.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EAEpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAEL,gBAAgB,EAEhB,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/preview-body.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Renders a Preview Payload's body (already cut to the link's Subpath) as
+ * React elements, so its links can be Hover Previews themselves.
+ */
+export declare function PreviewBody({ html }: {
+    html: string;
+}): JSX.Element;
+//# sourceMappingURL=preview-body.d.ts.map

package/dist/preview-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-body.d.ts","sourceRoot":"","sources":["../src/preview-body.tsx"],"names":[],"mappings":"AAiDA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,eAOrD"}

package/dist/preview-body.js

@@ -0,0 +1,34 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { fromHtml } from "hast-util-from-html";
+import { toJsxRuntime } from "hast-util-to-jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { HoverPreview } from "./hover-preview.js";
+import { PREVIEW_SLUG_ATTR, PREVIEW_SUBPATH_ATTR } from "./preview-types.js";
+import { useObsidian } from "./provider.js";
+import { slugFromKey } from "./slug-key.js";
+/**
+ * A link in a preview's body. The payload builder marks the links that
+ * resolve to a Vault Note with the target's Slug, so those become a nested
+ * Hover Preview; every other link uses the provider's link component.
+ */
+function PreviewLink({ [PREVIEW_SLUG_ATTR]: slug, [PREVIEW_SUBPATH_ATTR]: subpath, href, children, ...props }) {
+    const { linkComponent: Link } = useObsidian();
+    if (!slug || !href) {
+        return (_jsx(Link, { href: href, ...props, children: children }));
+    }
+    return (_jsx(HoverPreview, { ...props, href: href, slug: slugFromKey(slug), subpath: subpath, children: children }));
+}
+/**
+ * Renders a Preview Payload's body (already cut to the link's Subpath) as
+ * React elements, so its links can be Hover Previews themselves.
+ */
+export function PreviewBody({ html }) {
+    return toJsxRuntime(fromHtml(html, { fragment: true }), {
+        Fragment,
+        jsx,
+        jsxs,
+        components: { a: PreviewLink },
+    });
+}
+//# sourceMappingURL=preview-body.js.map

package/dist/preview-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-body.js","sourceRoot":"","sources":["../src/preview-body.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C;;;;GAIG;AACH,SAAS,WAAW,CAAC,EACnB,CAAC,iBAAiB,CAAC,EAAE,IAAI,EACzB,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAC/B,IAAI,EACJ,QAAQ,EACR,GAAG,KAAK,EACI;IACZ,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IAC9C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,CACL,KAAC,IAAI,IAAC,IAAI,EAAE,IAAc,KAAM,KAAK,YAClC,QAAQ,GACJ,CACR,CAAC;IACJ,CAAC;IACD,OAAO,CACL,KAAC,YAAY,OACP,KAAK,EACT,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,EACvB,OAAO,EAAE,OAAO,YAEf,QAAQ,GACI,CAChB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAoB;IACpD,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;QACtD,QAAQ;QACR,GAAG;QACH,IAAI;QACJ,UAAU,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE;KAC/B,CAAC,CAAC;AACL,CAAC"}

package/dist/preview-client.d.ts

@@ -0,0 +1,9 @@
+import type { PreviewPayload } from "./preview-types.js";
+/**
+ * Fetches the Preview Payload of the Note published under `slug` from the URL
+ * `payloadUrl` builds. The first call per Slug downloads it; later calls in the
+ * session, whatever Subpath the link carried, share that one request. A failed
+ * request is forgotten so a later hover can retry.
+ */
+export declare function fetchPreviewPayload(slug: readonly string[], payloadUrl: (slug: readonly string[]) => string): Promise<PreviewPayload>;
+//# sourceMappingURL=preview-client.d.ts.map

package/dist/preview-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-client.d.ts","sourceRoot":"","sources":["../src/preview-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,UAAU,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,GAC9C,OAAO,CAAC,cAAc,CAAC,CAgBzB"}

package/dist/preview-client.js

@@ -0,0 +1,27 @@
+import { slugKey } from "./slug-key.js";
+const cache = new Map();
+/**
+ * Fetches the Preview Payload of the Note published under `slug` from the URL
+ * `payloadUrl` builds. The first call per Slug downloads it; later calls in the
+ * session, whatever Subpath the link carried, share that one request. A failed
+ * request is forgotten so a later hover can retry.
+ */
+export function fetchPreviewPayload(slug, payloadUrl) {
+    const key = slugKey(slug);
+    const cached = cache.get(key);
+    if (cached)
+        return cached;
+    const request = fetch(payloadUrl(slug))
+        .then((response) => {
+        if (!response.ok)
+            throw new Error(`Preview failed: ${response.status}`);
+        return response.json();
+    })
+        .catch((error) => {
+        cache.delete(key);
+        throw error;
+    });
+    cache.set(key, request);
+    return request;
+}
+//# sourceMappingURL=preview-client.js.map

package/dist/preview-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-client.js","sourceRoot":"","sources":["../src/preview-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAuB,EACvB,UAA+C;IAE/C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;SACpC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjB,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACxE,OAAO,QAAQ,CAAC,IAAI,EAA6B,CAAC;IACpD,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACL,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/preview-slice.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cuts the part of a Note's rendered body that a link's Subpath points at.
+ * `subpath` is the raw hash without `#`: a heading anchor (`alpha-heading`) or
+ * a Block ID (`^blockid`). A heading selects itself and everything up to the
+ * next heading of the same or higher level; a Block ID selects the one element
+ * carrying `id="^blockid"` (a list item stays inside its list). When there is
+ * no Subpath, or its anchor is not found, the whole Note comes back. Pure and
+ * DOM-free: the input string is never mutated.
+ */
+export declare function slicePreviewHtml(html: string, subpath: string | undefined): string;
+//# sourceMappingURL=preview-slice.d.ts.map

package/dist/preview-slice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-slice.d.ts","sourceRoot":"","sources":["../src/preview-slice.ts"],"names":[],"mappings":"AAwCA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,CAyBR"}

package/dist/preview-slice.js

@@ -0,0 +1,67 @@
+import { fromHtml } from "hast-util-from-html";
+import { toHtml } from "hast-util-to-html";
+const HEADING = /^h([1-6])$/;
+function headingLevel(node) {
+    if (node.type !== "element")
+        return undefined;
+    const match = HEADING.exec(node.tagName);
+    return match ? Number(match[1]) : undefined;
+}
+function decode(subpath) {
+    try {
+        return decodeURIComponent(subpath);
+    }
+    catch {
+        return subpath;
+    }
+}
+/** Finds the element with the given id, with the list of siblings holding it. */
+function findElementById(parent, id) {
+    const children = parent.children;
+    for (let index = 0; index < children.length; index++) {
+        const node = children[index];
+        if (node?.type !== "element")
+            continue;
+        if (node.properties.id === id)
+            return { siblings: children, index, parent };
+        const inner = findElementById(node, id);
+        if (inner)
+            return inner;
+    }
+    return null;
+}
+/**
+ * Cuts the part of a Note's rendered body that a link's Subpath points at.
+ * `subpath` is the raw hash without `#`: a heading anchor (`alpha-heading`) or
+ * a Block ID (`^blockid`). A heading selects itself and everything up to the
+ * next heading of the same or higher level; a Block ID selects the one element
+ * carrying `id="^blockid"` (a list item stays inside its list). When there is
+ * no Subpath, or its anchor is not found, the whole Note comes back. Pure and
+ * DOM-free: the input string is never mutated.
+ */
+export function slicePreviewHtml(html, subpath) {
+    if (!subpath)
+        return html;
+    const tree = fromHtml(html, { fragment: true });
+    const anchor = decode(subpath);
+    const hit = findElementById(tree, anchor) ?? findElementById(tree, subpath);
+    if (!hit)
+        return html;
+    const node = hit.siblings[hit.index];
+    const level = headingLevel(node);
+    if (level !== undefined && !anchor.startsWith("^")) {
+        let end = hit.index + 1;
+        while (end < hit.siblings.length) {
+            const next = headingLevel(hit.siblings[end]);
+            if (next !== undefined && next <= level)
+                break;
+            end++;
+        }
+        return toHtml(hit.siblings.slice(hit.index, end));
+    }
+    if (node.tagName === "li" && hit.parent.type === "element") {
+        return toHtml({ ...hit.parent, children: [node] });
+    }
+    return toHtml(node);
+}
+//# sourceMappingURL=preview-slice.js.map

package/dist/preview-slice.js.map

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

package/dist/preview-types.d.ts

@@ -0,0 +1,19 @@
+/** One Note, prepared at build time for Hover Previews (see ADR 0001). */
+export type PreviewPayload = {
+    title: string;
+    /** Structured data from `getFrontmatter`; the Properties Panel renders it. */
+    properties: unknown;
+    /** The Note's body as rendered HTML, without Frontmatter. */
+    html: string;
+};
+/**
+ * Attributes the payload builder puts on a link that can be previewed: the
+ * target Note's Slug (as a `slugKey`) and the link's Subpath.
+ */
+export declare const PREVIEW_SLUG_ATTR = "data-preview-slug";
+export declare const PREVIEW_SUBPATH_ATTR = "data-preview-subpath";
+/** Where Preview Payloads are served from. */
+export declare const PREVIEW_PATH = "/api/preview/";
+/** URL of the Preview Payload for the Note published under `slug`. */
+export declare function previewPayloadUrl(slug: readonly string[]): string;
+//# sourceMappingURL=preview-types.d.ts.map

package/dist/preview-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-types.d.ts","sourceRoot":"","sources":["../src/preview-types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,8CAA8C;AAC9C,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEjE"}

package/dist/preview-types.js

@@ -0,0 +1,13 @@
+/**
+ * Attributes the payload builder puts on a link that can be previewed: the
+ * target Note's Slug (as a `slugKey`) and the link's Subpath.
+ */
+export const PREVIEW_SLUG_ATTR = "data-preview-slug";
+export const PREVIEW_SUBPATH_ATTR = "data-preview-subpath";
+/** Where Preview Payloads are served from. */
+export const PREVIEW_PATH = "/api/preview/";
+/** URL of the Preview Payload for the Note published under `slug`. */
+export function previewPayloadUrl(slug) {
+    return `${PREVIEW_PATH}${slug.map(encodeURIComponent).join("/")}`;
+}
+//# sourceMappingURL=preview-types.js.map

package/dist/preview-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-types.js","sourceRoot":"","sources":["../src/preview-types.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,8CAA8C;AAC9C,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;AAE5C,sEAAsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACvD,OAAO,GAAG,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/properties-keys.d.ts

@@ -0,0 +1,4 @@
+/** localStorage keys remembering the Properties Panel state; one per surface. */
+export declare const PAGE_PROPERTIES_KEY = "properties-panel:page";
+export declare const PREVIEW_PROPERTIES_KEY = "properties-panel:preview";
+//# sourceMappingURL=properties-keys.d.ts.map

package/dist/properties-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties-keys.d.ts","sourceRoot":"","sources":["../src/properties-keys.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAC3D,eAAO,MAAM,sBAAsB,6BAA6B,CAAC"}

package/dist/properties-keys.js

@@ -0,0 +1,4 @@
+/** localStorage keys remembering the Properties Panel state; one per surface. */
+export const PAGE_PROPERTIES_KEY = "properties-panel:page";
+export const PREVIEW_PROPERTIES_KEY = "properties-panel:preview";
+//# sourceMappingURL=properties-keys.js.map

package/dist/properties-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties-keys.js","sourceRoot":"","sources":["../src/properties-keys.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC"}

package/dist/properties-panel.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from "react";
+/**
+ * Collapsible shell around the Properties rows. Remembers its state in
+ * `localStorage` under `storageKey`; each surface (page, preview) uses its own.
+ *
+ * The root carries `data-open`, which the inline no-flash script sets before
+ * React has hydrated. The panel stays mounted when closed, so style the closed
+ * state from `[data-properties-panel][data-open="false"]` (for example
+ * `display: none` on `[data-properties-content]`).
+ */
+export declare function PropertiesPanel({ children, storageKey, defaultOpen, noFlash, label, expandIcon, }: {
+    children: ReactNode;
+    storageKey: string;
+    defaultOpen: boolean;
+    /** Skip the inline script where the panel is only rendered on the client. */
+    noFlash?: boolean;
+    /** The trigger's text. */
+    label?: ReactNode;
+    /** Icon slot for the expand/collapse control; there is no default. */
+    expandIcon?: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=properties-panel.d.ts.map

package/dist/properties-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties-panel.d.ts","sourceRoot":"","sources":["../src/properties-panel.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,OAAO,CAAC;AAS9C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,UAAU,EACV,WAAW,EACX,OAAc,EACd,KAAoB,EACpB,UAAU,GACX,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sEAAsE;IACtE,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB,+BAoCA"}

package/dist/properties-panel.js

@@ -0,0 +1,24 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useId } from "react";
+import { Collapsible, CollapsiblePanel, CollapsibleTrigger, } from "./collapsible.js";
+import { persistedOpenScript, usePersistedOpen } from "./use-persisted-open.js";
+/**
+ * Collapsible shell around the Properties rows. Remembers its state in
+ * `localStorage` under `storageKey`; each surface (page, preview) uses its own.
+ *
+ * The root carries `data-open`, which the inline no-flash script sets before
+ * React has hydrated. The panel stays mounted when closed, so style the closed
+ * state from `[data-properties-panel][data-open="false"]` (for example
+ * `display: none` on `[data-properties-content]`).
+ */
+export function PropertiesPanel({ children, storageKey, defaultOpen, noFlash = true, label = "Properties", expandIcon, }) {
+    const id = useId();
+    const [open, setOpen] = usePersistedOpen(storageKey, defaultOpen);
+    return (_jsxs(_Fragment, { children: [_jsx("div", { "data-open": open, "data-properties-panel": "", id: id, suppressHydrationWarning: true, children: _jsxs(Collapsible, { onOpenChange: setOpen, open: open, children: [_jsxs(CollapsibleTrigger, { "data-properties-trigger": "", children: [expandIcon ? (_jsx("span", { "aria-hidden": true, "data-properties-expand-icon": "", children: expandIcon })) : null, label] }), _jsx(CollapsiblePanel, { "data-properties-content": "", keepMounted: true, children: children })] }) }), noFlash ? (_jsx("script", { 
+                // biome-ignore lint/security/noDangerouslySetInnerHtml: no-flash script, content is built from constants
+                dangerouslySetInnerHTML: {
+                    __html: persistedOpenScript(id, storageKey),
+                } })) : null] }));
+}
+//# sourceMappingURL=properties-panel.js.map

package/dist/properties-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties-panel.js","sourceRoot":"","sources":["../src/properties-panel.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAkB,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,UAAU,EACV,WAAW,EACX,OAAO,GAAG,IAAI,EACd,KAAK,GAAG,YAAY,EACpB,UAAU,GAWX;IACC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAElE,OAAO,CACL,8BACE,2BACa,IAAI,2BACO,EAAE,EACxB,EAAE,EAAE,EAAE,EACN,wBAAwB,kBAExB,MAAC,WAAW,IAAC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,aAC5C,MAAC,kBAAkB,+BAAyB,EAAE,aAC3C,UAAU,CAAC,CAAC,CAAC,CACZ,mEAA8C,EAAE,YAC7C,UAAU,GACN,CACR,CAAC,CAAC,CAAC,IAAI,EACP,KAAK,IACa,EACrB,KAAC,gBAAgB,+BAAyB,EAAE,EAAC,WAAW,kBACrD,QAAQ,GACQ,IACP,GACV,EACL,OAAO,CAAC,CAAC,CAAC,CACT;gBACE,yGAAyG;gBACzG,uBAAuB,EAAE;oBACvB,MAAM,EAAE,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC;iBAC5C,GACD,CACH,CAAC,CAAC,CAAC,IAAI,IACP,CACJ,CAAC;AACJ,CAAC"}

package/dist/properties.d.ts

@@ -0,0 +1,42 @@
+import type { ComponentProps, ComponentType, ReactNode } from "react";
+import type { FrontmatterDate, PropertyType } from "remark-obsidian-md";
+/** The property types the panel infers, mirroring Obsidian's. */
+type InferredType = Extract<PropertyType, "text" | "multitext" | "number" | "checkbox" | "date" | "datetime" | "tags" | "aliases">;
+/**
+ * Icon slots: one per property type, `unknown` for the rest, `expand` for the
+ * expand/collapse control and `checked` for a checked checkbox.
+ */
+export type PropertiesIcons = Partial<Record<InferredType | "unknown" | "expand" | "checked", ReactNode>>;
+type LinkComponent = ComponentType<ComponentProps<"a"> & {
+    href: string;
+}>;
+/**
+ * The Properties Panel: a collapsible list of a Note's Frontmatter, as
+ * produced by `getFrontmatter`. Headless: it emits `data-properties-*` and
+ * `data-property-*` attributes and no classes, so all styling comes from your
+ * CSS, and icons arrive through the `icons` slots.
+ */
+export declare function Properties({ properties, storageKey, defaultOpen, noFlash, hiddenKeys, icons, label, linkComponent, dateLocales, dateOptions, renderDate, }: {
+    properties: unknown;
+    /** localStorage key remembering the open state; one per surface. */
+    storageKey?: string;
+    defaultOpen?: boolean;
+    /** Emit the inline script that applies the stored state before hydration. */
+    noFlash?: boolean;
+    /** Frontmatter keys to leave out (for example ones a framework consumes). */
+    hiddenKeys?: readonly string[];
+    /** Icon slots per property type, plus `expand`; none by default. */
+    icons?: PropertiesIcons;
+    /** The panel trigger's text; defaults to "Properties". */
+    label?: ReactNode;
+    /** Component for Vault-internal links; defaults to a plain `<a>`. */
+    linkComponent?: LinkComponent | "a";
+    /** `Intl` locales for dates; defaults to the browser's. */
+    dateLocales?: Intl.LocalesArgument;
+    /** `Intl.DateTimeFormat` options for dates; defaults to a numeric format. */
+    dateOptions?: Intl.DateTimeFormatOptions;
+    /** Replaces the date rendering entirely. */
+    renderDate?: (value: FrontmatterDate) => ReactNode;
+}): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=properties.d.ts.map

package/dist/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../src/properties.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACb,MAAM,oBAAoB,CAAC;AAM5B,iEAAiE;AACjE,KAAK,YAAY,GAAG,OAAO,CACzB,YAAY,EACV,MAAM,GACN,WAAW,GACX,QAAQ,GACR,UAAU,GACV,MAAM,GACN,UAAU,GACV,MAAM,GACN,SAAS,CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CACnC,MAAM,CAAC,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,EAAE,SAAS,CAAC,CACnE,CAAC;AAsEF,KAAK,aAAa,GAAG,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AA2F3E;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,UAAU,EACV,UAAgC,EAChC,WAAkB,EAClB,OAAc,EACd,UAAU,EACV,KAAK,EACL,KAAK,EACL,aAAmB,EACnB,WAAW,EACX,WAAW,EACX,UAAU,GACX,EAAE;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,oEAAoE;IACpE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qEAAqE;IACrE,aAAa,CAAC,EAAE,aAAa,GAAG,GAAG,CAAC;IACpC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC;IACnC,6EAA6E;IAC7E,WAAW,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC;IACzC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,SAAS,CAAC;CACpD,sCAqEA"}

package/dist/properties.js

@@ -0,0 +1,137 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { FormattedDate } from "./formatted-date.js";
+import { PAGE_PROPERTIES_KEY } from "./properties-keys.js";
+import { PropertiesPanel } from "./properties-panel.js";
+/** Reserved frontmatter keys Obsidian types itself (case-insensitive). */
+const RESERVED_TYPES = {
+    aliases: "aliases",
+    cssclasses: "multitext",
+    tags: "tags",
+};
+function isLink(value) {
+    return typeof value === "object" && value !== null && "label" in value;
+}
+function isDate(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "date" in value &&
+        "kind" in value);
+}
+/** An empty frontmatter value (`Etiquetas:` → null, `tags: []`, blank text). */
+function isEmpty(value) {
+    return (value === null ||
+        value === undefined ||
+        (typeof value === "string" && value.trim() === "") ||
+        (Array.isArray(value) && value.length === 0));
+}
+/** Plain nested objects are rare in vaults; render them flat as `key: value`. */
+function toText(value) {
+    if (isLink(value))
+        return value.label;
+    if (isDate(value))
+        return value.date;
+    if (Array.isArray(value))
+        return value.map((item) => toText(item)).join(", ");
+    if (typeof value === "object" && value !== null) {
+        return Object.entries(value)
+            .map(([key, item]) => `${key}: ${toText(item)}`)
+            .join(", ");
+    }
+    return String(value);
+}
+/**
+ * Mirrors Obsidian's property type inference: reserved keys first, then the
+ * value's shape. Declared types from `.obsidian/types.json` are intentionally
+ * not consulted.
+ */
+function inferType(key, value) {
+    const reserved = RESERVED_TYPES[key.toLowerCase()];
+    if (reserved)
+        return reserved;
+    if (value === null || value === undefined)
+        return "text";
+    if (Array.isArray(value))
+        return "multitext";
+    if (typeof value === "boolean")
+        return "checkbox";
+    if (typeof value === "number")
+        return "number";
+    if (isDate(value))
+        return value.kind;
+    if (isLink(value) || typeof value === "string")
+        return "text";
+    return "unknown";
+}
+/** Obsidian shows tags with a leading `#`, even when the YAML omits it. */
+function tagLabel(value) {
+    const text = isLink(value) ? value.label : toText(value);
+    return `#${text.replace(/^#/, "")}`;
+}
+function Value({ value, type, options, }) {
+    if (value === null || value === undefined)
+        return null;
+    if (Array.isArray(value)) {
+        return value
+            .filter((item) => item !== null && item !== undefined)
+            .map((item, index) => (
+        // biome-ignore lint/suspicious/noArrayIndexKey: build-time static values with no stable identity
+        _jsx("span", { "data-properties-item": "", children: _jsx(Value, { options: options, type: type, value: item }) }, index)));
+    }
+    if (isLink(value)) {
+        const isTag = type === "tags";
+        const label = isTag ? tagLabel(value) : value.label;
+        const marks = {
+            ...(isTag ? { "data-property-tag": "" } : {}),
+            ...("unresolved" in value ? { "data-unresolved": "" } : {}),
+        };
+        if (value.url === undefined) {
+            return (_jsx("span", { "data-property-link": "unresolved", ...marks, children: label }));
+        }
+        if (value.url.startsWith("/")) {
+            const Link = options.linkComponent;
+            return (_jsx(Link, { "data-property-link": "internal", href: value.url, ...marks, children: label }));
+        }
+        return (_jsx("a", { "data-property-link": "external", href: value.url, rel: "noreferrer", target: "_blank", ...marks, children: label }));
+    }
+    if (isDate(value))
+        return options.renderDate(value);
+    if (typeof value === "boolean") {
+        return (_jsx("span", { "aria-label": value ? "true" : "false", "data-checked": value, "data-property-checkbox": "", role: "img", children: value ? options.checkedIcon : null }));
+    }
+    if (type === "tags") {
+        return _jsx("span", { "data-property-tag": "", children: tagLabel(value) });
+    }
+    if (typeof value === "number") {
+        return _jsx("span", { "data-property-number": "", children: toText(value) });
+    }
+    return _jsx(_Fragment, { children: toText(value) });
+}
+/**
+ * The Properties Panel: a collapsible list of a Note's Frontmatter, as
+ * produced by `getFrontmatter`. Headless: it emits `data-properties-*` and
+ * `data-property-*` attributes and no classes, so all styling comes from your
+ * CSS, and icons arrive through the `icons` slots.
+ */
+export function Properties({ properties, storageKey = PAGE_PROPERTIES_KEY, defaultOpen = true, noFlash = true, hiddenKeys, icons, label, linkComponent = "a", dateLocales, dateOptions, renderDate, }) {
+    if (typeof properties !== "object" ||
+        properties === null ||
+        Array.isArray(properties)) {
+        return null;
+    }
+    const hidden = new Set(hiddenKeys);
+    const rows = Object.entries(properties).filter(([key, value]) => !hidden.has(key) && !isEmpty(value));
+    if (rows.length === 0)
+        return null;
+    const options = {
+        linkComponent,
+        checkedIcon: icons?.checked,
+        renderDate: renderDate ??
+            ((value) => (_jsx(FormattedDate, { date: value.date, kind: value.kind, ...(dateLocales !== undefined ? { locales: dateLocales } : {}), ...(dateOptions !== undefined ? { options: dateOptions } : {}) }))),
+    };
+    return (_jsx(PropertiesPanel, { defaultOpen: defaultOpen, expandIcon: icons?.expand, label: label, noFlash: noFlash, storageKey: storageKey, children: _jsx("div", { "data-properties-list": "", children: rows.map(([key, value]) => {
+                const type = inferType(key, value);
+                const icon = icons?.[type];
+                return (_jsxs("div", { "data-properties-row": "", "data-property-key": key, "data-property-type": type, children: [_jsxs("div", { "data-properties-key": "", children: [icon ? (_jsx("span", { "aria-hidden": true, "data-properties-type-icon": "", children: icon })) : null, _jsx("span", { "data-properties-name": "", title: key, children: key })] }), _jsx("div", { "data-properties-value": "", children: _jsx(Value, { options: options, type: type, value: value }) })] }, key));
+            }) }) }));
+}
+//# sourceMappingURL=properties.js.map

package/dist/properties.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,34 @@
+import { type ComponentProps, type ComponentType, type ReactNode } from "react";
+type LinkComponent = ComponentType<ComponentProps<"a"> & {
+    href: string;
+}>;
+/** What a Hover Preview hands over to render a Note's Properties Panel. */
+export type PreviewPropertiesProps = {
+    properties: unknown;
+    storageKey: string;
+    defaultOpen: boolean;
+    noFlash: boolean;
+};
+export type ObsidianContextValue = {
+    /** The component every link in a preview renders; a plain `<a>` by default. */
+    linkComponent?: LinkComponent | "a";
+    /** Builds the URL a Note's Preview Payload is fetched from. */
+    previewPayloadUrl?: (slug: readonly string[]) => string;
+    /**
+     * Class for the container of a preview's body, for stylesheets scoped to a
+     * Rendered Container (such as `markdown-rendered`). None by default.
+     */
+    previewBodyClassName?: string;
+    /** Renders the Properties Panel in a preview (for icons, hidden keys). */
+    renderProperties?: (props: PreviewPropertiesProps) => ReactNode;
+};
+/**
+ * Supplies framework-specific pieces to Hover Previews, however deeply nested:
+ * the link component, the Preview Payload URL and the Properties Panel.
+ */
+export declare function ObsidianProvider({ children, ...value }: ObsidianContextValue & {
+    children?: ReactNode;
+}): import("react").JSX.Element;
+export declare function useObsidian(): Required<ObsidianContextValue>;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAIf,KAAK,aAAa,GAAG,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE3E,2EAA2E;AAC3E,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,aAAa,GAAG,GAAG,CAAC;IACpC,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;IACxD;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,SAAS,CAAC;CACjE,CAAC;AAIF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,+BAMjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAAC,oBAAoB,CAAC,CAY5D"}

package/dist/provider.js

@@ -0,0 +1,24 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, } from "react";
+import { previewPayloadUrl } from "./preview-types.js";
+import { Properties } from "./properties.js";
+const ObsidianContext = createContext({});
+/**
+ * Supplies framework-specific pieces to Hover Previews, however deeply nested:
+ * the link component, the Preview Payload URL and the Properties Panel.
+ */
+export function ObsidianProvider({ children, ...value }) {
+    return (_jsx(ObsidianContext.Provider, { value: value, children: children }));
+}
+export function useObsidian() {
+    const value = useContext(ObsidianContext);
+    return {
+        linkComponent: value.linkComponent ?? "a",
+        previewPayloadUrl: value.previewPayloadUrl ?? previewPayloadUrl,
+        previewBodyClassName: value.previewBodyClassName ?? "",
+        renderProperties: value.renderProperties ??
+            ((props) => (_jsx(Properties, { ...props, linkComponent: value.linkComponent ?? "a" }))),
+    };
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAGL,aAAa,EAEb,UAAU,GACX,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA0B7C,MAAM,eAAe,GAAG,aAAa,CAAuB,EAAE,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,QAAQ,EACR,GAAG,KAAK,EACwC;IAChD,OAAO,CACL,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACnC,QAAQ,GACgB,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC1C,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,GAAG;QACzC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,iBAAiB;QAC/D,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,IAAI,EAAE;QACtD,gBAAgB,EACd,KAAK,CAAC,gBAAgB;YACtB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACV,KAAC,UAAU,OAAK,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,GAAG,GAAI,CACrE,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/slug-key.d.ts

@@ -0,0 +1,5 @@
+/** A Slug as one string, for cache keys and HTML attributes. */
+export declare function slugKey(slug: readonly string[]): string;
+/** The Slug a `slugKey` was made from. */
+export declare function slugFromKey(key: string): string[];
+//# sourceMappingURL=slug-key.d.ts.map

package/dist/slug-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-key.d.ts","sourceRoot":"","sources":["../src/slug-key.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEvD;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD"}

package/dist/slug-key.js

@@ -0,0 +1,9 @@
+/** A Slug as one string, for cache keys and HTML attributes. */
+export function slugKey(slug) {
+    return slug.join("/");
+}
+/** The Slug a `slugKey` was made from. */
+export function slugFromKey(key) {
+    return key.split("/");
+}
+//# sourceMappingURL=slug-key.js.map

package/dist/slug-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-key.js","sourceRoot":"","sources":["../src/slug-key.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,UAAU,OAAO,CAAC,IAAuB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/use-persisted-open.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Open/closed state remembered in `localStorage` under `key` and kept in sync
+ * between tabs (`storage` event) and between components using the same key.
+ *
+ * The server and the hydration pass render `defaultOpen`; the stored value
+ * takes over right after. Pair it with `persistedOpenScript` so the DOM already
+ * shows the stored state before hydration.
+ *
+ * @returns `[open, setOpen]`
+ */
+export declare function usePersistedOpen(key: string, defaultOpen: boolean): readonly [boolean, (open: boolean) => void];
+/**
+ * Inline script body for the no-flash guide: sets `data-open` on the element
+ * with `id` from the stored value, synchronously during HTML parsing.
+ */
+export declare function persistedOpenScript(id: string, key: string): string;
+//# sourceMappingURL=use-persisted-open.d.ts.map

package/dist/use-persisted-open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-persisted-open.d.ts","sourceRoot":"","sources":["../src/use-persisted-open.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,OAAO,GACnB,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,CAoB7C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/use-persisted-open.js

@@ -0,0 +1,58 @@
+"use client";
+import { useCallback, useSyncExternalStore } from "react";
+const OPEN = "1";
+const CLOSED = "0";
+/** Same-tab writes do not fire `storage`, so they announce themselves here. */
+const LOCAL_EVENT = "persisted-open";
+function read(key, defaultOpen) {
+    try {
+        const stored = window.localStorage.getItem(key);
+        if (stored === OPEN)
+            return true;
+        if (stored === CLOSED)
+            return false;
+    }
+    catch {
+        // localStorage can be blocked; fall through to the default.
+    }
+    return defaultOpen;
+}
+function subscribe(onChange) {
+    window.addEventListener("storage", onChange);
+    window.addEventListener(LOCAL_EVENT, onChange);
+    return () => {
+        window.removeEventListener("storage", onChange);
+        window.removeEventListener(LOCAL_EVENT, onChange);
+    };
+}
+/**
+ * Open/closed state remembered in `localStorage` under `key` and kept in sync
+ * between tabs (`storage` event) and between components using the same key.
+ *
+ * The server and the hydration pass render `defaultOpen`; the stored value
+ * takes over right after. Pair it with `persistedOpenScript` so the DOM already
+ * shows the stored state before hydration.
+ *
+ * @returns `[open, setOpen]`
+ */
+export function usePersistedOpen(key, defaultOpen) {
+    const open = useSyncExternalStore(subscribe, () => read(key, defaultOpen), () => defaultOpen);
+    const setOpen = useCallback((next) => {
+        try {
+            window.localStorage.setItem(key, next ? OPEN : CLOSED);
+        }
+        catch {
+            // Not persisted; still notify so the UI reflects the choice.
+        }
+        window.dispatchEvent(new Event(LOCAL_EVENT));
+    }, [key]);
+    return [open, setOpen];
+}
+/**
+ * Inline script body for the no-flash guide: sets `data-open` on the element
+ * with `id` from the stored value, synchronously during HTML parsing.
+ */
+export function persistedOpenScript(id, key) {
+    return `(function(){try{var v=localStorage.getItem(${JSON.stringify(key)});var e=document.getElementById(${JSON.stringify(id)});if(e&&(v==="1"||v==="0"))e.setAttribute("data-open",v==="1"?"true":"false")}catch(e){}})()`;
+}
+//# sourceMappingURL=use-persisted-open.js.map

package/dist/use-persisted-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-persisted-open.js","sourceRoot":"","sources":["../src/use-persisted-open.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE1D,MAAM,IAAI,GAAG,GAAG,CAAC;AACjB,MAAM,MAAM,GAAG,GAAG,CAAC;AAEnB,+EAA+E;AAC/E,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC,SAAS,IAAI,CAAC,GAAW,EAAE,WAAoB;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;IAC9D,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,SAAS,CAAC,QAAoB;IACrC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,WAAoB;IAEpB,MAAM,IAAI,GAAG,oBAAoB,CAC/B,SAAS,EACT,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAC5B,GAAG,EAAE,CAAC,WAAW,CAClB,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,IAAa,EAAE,EAAE;QAChB,IAAI,CAAC;YACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;QACD,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/C,CAAC,EACD,CAAC,GAAG,CAAC,CACN,CAAC;IAEF,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,GAAW;IACzD,OAAO,8CAA8C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,mCAAmC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,8FAA8F,CAAC;AAC9N,CAAC"}

package/package.json

@@ -1,6 +1,71 @@
 {
   "name": "react-obsidian-md",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "author": "Adriano Araújo (adrianoaraujodsantos@hotmail.com)",
+  "description": "Headless React components for Obsidian.md content: a collapsible Properties Panel with persisted state, styled entirely by your own CSS",
+  "license": "MIT",
+  "keywords": [
+    "react",
+    "headless",
+    "obsidian",
+    "properties",
+    "frontmatter",
+    "digital-garden",
+    "remark-obsidian-md"
+  ],
+  "homepage": "https://github.com/adrianoaraujods/obsidian-md/tree/main/packages/react-obsidian-md#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adrianoaraujods/obsidian-md.git",
+    "directory": "packages/react-obsidian-md"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.9.0",
+    "hast-util-from-html": "2.0.3",
+    "hast-util-to-html": "9.0.5",
+    "hast-util-to-jsx-runtime": "2.3.6"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "remark-obsidian-md": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/hast": "^3.0.5",
+    "@types/node": "^25.2.0",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "jsdom": "^27.0.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "remark-obsidian-md": "3.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.5"
+  },
+  "sideEffects": false,
+  "bugs": {
+    "url": "https://github.com/adrianoaraujods/obsidian-md/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "biome check",
+    "format": "biome format --write"
+  }
 }