@awesome-markdown/board-ui 0.0.0-stage → 2.0.0

package/dist/provider/ProviderContext.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { PersistenceProvider } from '@awesome-markdown/contracts';
+interface ProviderContextProviderProps {
+    provider: PersistenceProvider;
+    children: React.ReactNode;
+}
+/**
+ * Injects a PersistenceProvider instance into the React tree.
+ * Wrap your root component with this to enable useProvider().
+ */
+export declare function ProviderContextProvider({ provider, children, }: ProviderContextProviderProps): React.ReactElement;
+/**
+ * Returns the bound PersistenceProvider. Throws if used outside ProviderContextProvider.
+ */
+export declare function useProvider(): PersistenceProvider;
+export {};
+//# sourceMappingURL=ProviderContext.d.ts.map

package/dist/provider/ProviderContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderContext.d.ts","sourceRoot":"","sources":["../../src/provider/ProviderContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAIvE,UAAU,4BAA4B;IACpC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,QAAQ,GACT,EAAE,4BAA4B,GAAG,KAAK,CAAC,YAAY,CAMnD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,mBAAmB,CAMjD"}

package/dist/provider/ProviderContext.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { createContext, useContext } from 'react';
+const ProviderContext = createContext(null);
+/**
+ * Injects a PersistenceProvider instance into the React tree.
+ * Wrap your root component with this to enable useProvider().
+ */
+export function ProviderContextProvider({ provider, children, }) {
+    return (_jsx(ProviderContext.Provider, { value: provider, children: children }));
+}
+/**
+ * Returns the bound PersistenceProvider. Throws if used outside ProviderContextProvider.
+ */
+export function useProvider() {
+    const ctx = useContext(ProviderContext);
+    if (ctx === null) {
+        throw new Error('useProvider must be used inside a ProviderContextProvider');
+    }
+    return ctx;
+}
+//# sourceMappingURL=ProviderContext.js.map

package/dist/provider/ProviderContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderContext.js","sourceRoot":"","sources":["../../src/provider/ProviderContext.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGzD,MAAM,eAAe,GAAG,aAAa,CAA6B,IAAI,CAAC,CAAC;AAOxE;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,EACR,QAAQ,GACqB;IAC7B,OAAO,CACL,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YACtC,QAAQ,GACgB,CAC5B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/router/RouterAdapter.d.ts

@@ -0,0 +1,43 @@
+import React from 'react';
+/**
+ * Router-agnostic navigation seam for board-ui.
+ *
+ * board-ui never imports a router. Every path it produces is *board-relative*
+ * (`/`, `/boards/:slug`, `/items/:slug?board=…`); the host app maps those onto
+ * its own URL space (e.g. prefixing `/w/:workspace`) inside its adapter.
+ */
+/** Props board-ui passes to `RouterAdapter.Link`. */
+export interface RouterLinkProps {
+    /** Board-relative target path, e.g. `/boards/board-all`. */
+    to: string;
+    children?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    title?: string;
+    'aria-label'?: string;
+    'data-testid'?: string;
+    onMouseEnter?: React.MouseEventHandler<HTMLAnchorElement>;
+    onMouseLeave?: React.MouseEventHandler<HTMLAnchorElement>;
+}
+export interface RouterAdapter {
+    /** Renders an in-app link to a board-relative path. */
+    Link: React.ComponentType<RouterLinkProps>;
+    /** Navigates to a board-relative path (may include a `?query`). */
+    navigate: (to: string) => void;
+    /** Hook: path params of the current route (`slug` for board/item pages). */
+    useParams: () => Record<string, string | undefined>;
+    /** Hook: query-string params of the current location. */
+    useSearchParams: () => URLSearchParams;
+}
+interface RouterAdapterProviderProps {
+    adapter: RouterAdapter;
+    children: React.ReactNode;
+}
+/** Injects the host app's router adapter. Required above any board-ui page. */
+export declare function RouterAdapterProvider({ adapter, children, }: RouterAdapterProviderProps): React.ReactElement;
+/** Returns the bound router adapter. Throws outside `RouterAdapterProvider`. */
+export declare function useRouterAdapter(): RouterAdapter;
+/** Convenience link component that delegates to the adapter's `Link`. */
+export declare function RouterLink(props: RouterLinkProps): React.ReactElement;
+export {};
+//# sourceMappingURL=RouterAdapter.d.ts.map

package/dist/router/RouterAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterAdapter.d.ts","sourceRoot":"","sources":["../../src/router/RouterAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAEzD;;;;;;GAMG;AAEH,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAC1D,YAAY,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;IAC3C,mEAAmE;IACnE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,4EAA4E;IAC5E,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACpD,yDAAyD;IACzD,eAAe,EAAE,MAAM,eAAe,CAAC;CACxC;AAID,UAAU,0BAA0B;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,QAAQ,GACT,EAAE,0BAA0B,GAAG,KAAK,CAAC,YAAY,CAIjD;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,aAAa,CAMhD;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAGrE"}

package/dist/router/RouterAdapter.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { createContext, useContext } from 'react';
+const RouterAdapterContext = createContext(null);
+/** Injects the host app's router adapter. Required above any board-ui page. */
+export function RouterAdapterProvider({ adapter, children, }) {
+    return (_jsx(RouterAdapterContext.Provider, { value: adapter, children: children }));
+}
+/** Returns the bound router adapter. Throws outside `RouterAdapterProvider`. */
+export function useRouterAdapter() {
+    const ctx = useContext(RouterAdapterContext);
+    if (ctx === null) {
+        throw new Error('useRouterAdapter must be used inside a RouterAdapterProvider');
+    }
+    return ctx;
+}
+/** Convenience link component that delegates to the adapter's `Link`. */
+export function RouterLink(props) {
+    const { Link } = useRouterAdapter();
+    return _jsx(Link, { ...props });
+}
+//# sourceMappingURL=RouterAdapter.js.map

package/dist/router/RouterAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterAdapter.js","sourceRoot":"","sources":["../../src/router/RouterAdapter.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAmCzD,MAAM,oBAAoB,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAOvE,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,EACpC,OAAO,EACP,QAAQ,GACmB;IAC3B,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YAAG,QAAQ,GAAiC,CAC1F,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC7C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACpC,OAAO,KAAC,IAAI,OAAK,KAAK,GAAI,CAAC;AAC7B,CAAC"}

package/dist/shell/SyncStatusDot.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * 6 px sync-status circle.
+ * No chromatic colors — grayscale tokens only per design spec.
+ * pulling state: pulsing animation.
+ */
+export declare function SyncStatusDot(): React.ReactElement;
+//# sourceMappingURL=SyncStatusDot.d.ts.map

package/dist/shell/SyncStatusDot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncStatusDot.d.ts","sourceRoot":"","sources":["../../src/shell/SyncStatusDot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AA6BnD;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAAC,YAAY,CAuClD"}

package/dist/shell/SyncStatusDot.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { useState, useEffect } from 'react';
+import { useProvider } from '../provider/ProviderContext.js';
+import { isHttpProvider } from '@awesome-markdown/provider-http';
+/**
+ * Maps HTTP connection state to the three sync visual states:
+ * - clean (idle/online)  → static --ink-muted dot
+ * - pulling (connecting/reconnecting) → pulsing --ink dot
+ * - dirty (offline)      → solid --ink dot
+ */
+function stateToSync(s) {
+    if (s === 'connecting' || s === 'reconnecting')
+        return 'pulling';
+    if (s === 'offline')
+        return 'dirty';
+    return 'clean';
+}
+const SYNC_COLORS = {
+    clean: 'var(--ink-muted)',
+    pulling: 'var(--ink)',
+    dirty: 'var(--ink)',
+};
+const SYNC_LABELS = {
+    clean: 'Sync clean',
+    pulling: 'Syncing…',
+    dirty: 'Sync dirty — changes pending',
+};
+/**
+ * 6 px sync-status circle.
+ * No chromatic colors — grayscale tokens only per design spec.
+ * pulling state: pulsing animation.
+ */
+export function SyncStatusDot() {
+    const provider = useProvider();
+    const isHttp = isHttpProvider(provider);
+    const [state, setState] = useState(isHttp ? provider.getConnectionState() : null);
+    useEffect(() => {
+        if (!isHttpProvider(provider)) {
+            setState(null);
+            return;
+        }
+        setState(provider.getConnectionState());
+        const unsub = provider.onConnectionStateChange((s) => setState(s));
+        return unsub;
+    }, [provider]);
+    const syncState = state !== null ? stateToSync(state) : 'clean';
+    const isPulsing = syncState === 'pulling';
+    return (_jsx("span", { style: {
+            display: 'inline-block',
+            width: '6px',
+            height: '6px',
+            borderRadius: '50%',
+            background: SYNC_COLORS[syncState],
+            flexShrink: 0,
+            animation: isPulsing ? 'pulse 1.5s ease-in-out infinite' : undefined,
+        }, "aria-label": SYNC_LABELS[syncState], title: SYNC_LABELS[syncState], "data-testid": "sync-status-dot", "data-sync-state": syncState, "data-connection-state": state ?? 'n/a' }));
+}
+//# sourceMappingURL=SyncStatusDot.js.map

package/dist/shell/SyncStatusDot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncStatusDot.js","sourceRoot":"","sources":["../../src/shell/SyncStatusDot.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE;;;;;GAKG;AACH,SAAS,WAAW,CAAC,CAAkB;IACrC,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,cAAc;QAAE,OAAO,SAAS,CAAC;IACjE,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IACpC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,WAAW,GAAkD;IACjE,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE,YAAY;CACpB,CAAC;AAEF,MAAM,WAAW,GAAkD;IACjE,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,8BAA8B;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAExC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAChC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAC9C,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,SAAS,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,MAAM,SAAS,GAAG,SAAS,KAAK,SAAS,CAAC;IAE1C,OAAO,CACL,eACE,KAAK,EAAE;YACL,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC;YAClC,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,SAAS;SACrE,gBACW,WAAW,CAAC,SAAS,CAAC,EAClC,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,iBACjB,iBAAiB,qBACZ,SAAS,2BACH,KAAK,IAAI,KAAK,GACrC,CACH,CAAC;AACJ,CAAC"}

package/dist/shell/ThemeToggle.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * Theme toggle button — delegates to useTheme() from theme-store.
+ * ☀ = currently light (click to switch to dark)
+ * ☾ = currently dark (click to switch to light)
+ */
+export declare function ThemeToggle(): React.ReactElement;
+//# sourceMappingURL=ThemeToggle.d.ts.map

package/dist/shell/ThemeToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeToggle.d.ts","sourceRoot":"","sources":["../../src/shell/ThemeToggle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,KAAK,CAAC,YAAY,CAuBhD"}

package/dist/shell/ThemeToggle.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { useTheme } from '../state/theme-store.js';
+/**
+ * Theme toggle button — delegates to useTheme() from theme-store.
+ * ☀ = currently light (click to switch to dark)
+ * ☾ = currently dark (click to switch to light)
+ */
+export function ThemeToggle() {
+    const { theme, toggle } = useTheme();
+    return (_jsx("button", { type: "button", onClick: toggle, "aria-label": theme === 'light' ? 'Switch to dark mode' : 'Switch to light mode', title: theme === 'light' ? 'Switch to dark mode' : 'Switch to light mode', "data-testid": "theme-toggle", style: {
+            background: 'none',
+            border: 'none',
+            cursor: 'pointer',
+            color: 'var(--ink-muted)',
+            fontSize: '14px',
+            padding: '2px 4px',
+            lineHeight: 1,
+        }, children: theme === 'light' ? '☀' : '☾' }));
+}
+//# sourceMappingURL=ThemeToggle.js.map

package/dist/shell/ThemeToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeToggle.js","sourceRoot":"","sources":["../../src/shell/ThemeToggle.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IAErC,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,MAAM,gBACH,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,sBAAsB,EAC9E,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,sBAAsB,iBAC7D,cAAc,EAC1B,KAAK,EAAE;YACL,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,kBAAkB;YACzB,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE,CAAC;SACd,YAEA,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GACvB,CACV,CAAC;AACJ,CAAC"}

package/dist/state/theme-store.d.ts

@@ -0,0 +1,17 @@
+type Theme = 'light' | 'dark';
+/**
+ * React hook for theme management.
+ *
+ * - Reads initial value from localStorage, falls back to `prefers-color-scheme`.
+ * - On change: writes `document.documentElement.dataset.theme` and localStorage.
+ * - localStorage unavailable → in-memory only, no error surfaced.
+ *
+ * UC-6: Theme toggles light↔dark, persists to localStorage, hydrates from OS pref.
+ */
+export declare function useTheme(): {
+    theme: Theme;
+    toggle(): void;
+    set(t: Theme): void;
+};
+export {};
+//# sourceMappingURL=theme-store.d.ts.map

package/dist/state/theme-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-store.d.ts","sourceRoot":"","sources":["../../src/state/theme-store.ts"],"names":[],"mappings":"AAEA,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAmC9B;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,IAAI;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,IAAI,IAAI,CAAC;IAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,CAkBhF"}

package/dist/state/theme-store.js

@@ -0,0 +1,58 @@
+import { useState, useEffect, useCallback } from 'react';
+/** Read the persisted theme from localStorage, or null if unavailable. */
+function readStorage() {
+    try {
+        const stored = localStorage.getItem('theme');
+        if (stored === 'light' || stored === 'dark')
+            return stored;
+    }
+    catch {
+        // localStorage unavailable (e.g. private browsing, security policy)
+    }
+    return null;
+}
+/** Write theme to localStorage; silently ignores storage errors. */
+function writeStorage(theme) {
+    try {
+        localStorage.setItem('theme', theme);
+    }
+    catch {
+        // unavailable — in-memory only
+    }
+}
+/** Detect OS colour-scheme preference. */
+function detectOsTheme() {
+    if (typeof window !== 'undefined' && window.matchMedia('(prefers-color-scheme: dark)').matches) {
+        return 'dark';
+    }
+    return 'light';
+}
+/** Apply theme to the document root element. */
+function applyTheme(theme) {
+    document.documentElement.dataset['theme'] = theme;
+}
+/**
+ * React hook for theme management.
+ *
+ * - Reads initial value from localStorage, falls back to `prefers-color-scheme`.
+ * - On change: writes `document.documentElement.dataset.theme` and localStorage.
+ * - localStorage unavailable → in-memory only, no error surfaced.
+ *
+ * UC-6: Theme toggles light↔dark, persists to localStorage, hydrates from OS pref.
+ */
+export function useTheme() {
+    const [theme, setThemeState] = useState(() => readStorage() ?? detectOsTheme());
+    // Sync to DOM on mount and whenever theme changes
+    useEffect(() => {
+        applyTheme(theme);
+        writeStorage(theme);
+    }, [theme]);
+    const toggle = useCallback(() => {
+        setThemeState((t) => (t === 'light' ? 'dark' : 'light'));
+    }, []);
+    const set = useCallback((t) => {
+        setThemeState(t);
+    }, []);
+    return { theme, toggle, set };
+}
+//# sourceMappingURL=theme-store.js.map

package/dist/state/theme-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-store.js","sourceRoot":"","sources":["../../src/state/theme-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAIzD,0EAA0E;AAC1E,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oEAAoE;AACpE,SAAS,YAAY,CAAC,KAAY;IAChC,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,SAAS,aAAa;IACpB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gDAAgD;AAChD,SAAS,UAAU,CAAC,KAAY;IAC9B,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;AACpD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAQ,GAAG,EAAE,CAAC,WAAW,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC;IAEvF,kDAAkD;IAClD,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,MAAM,GAAG,WAAW,CAAC,GAAS,EAAE;QACpC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAQ,EAAQ,EAAE;QACzC,aAAa,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AAChC,CAAC"}

package/dist/state/useBoardRender.d.ts

@@ -0,0 +1,16 @@
+import type { BoardRender, Homeless } from '@awesome-markdown/contracts';
+export type BoardRenderStatus = 'loading' | 'ready' | 'error';
+export interface BoardRenderState {
+    status: BoardRenderStatus;
+    render: BoardRender | null;
+    homeless: Homeless | null;
+    refetch: () => void;
+}
+/**
+ * Fetches the render envelope and homeless list for a board by slug.
+ *
+ * Coalesces rapid SSE change events into a single re-fetch per board
+ * via `useProviderSubscribe` (debounce ~100 ms).
+ */
+export declare function useBoardRender(slug: string): BoardRenderState;
+//# sourceMappingURL=useBoardRender.d.ts.map

package/dist/state/useBoardRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoardRender.d.ts","sourceRoot":"","sources":["../../src/state/useBoardRender.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAIzE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA6C7D"}

package/dist/state/useBoardRender.js

@@ -0,0 +1,53 @@
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { useProvider } from '../provider/ProviderContext.js';
+import { useProviderSubscribe } from './useProviderSubscribe.js';
+/**
+ * Fetches the render envelope and homeless list for a board by slug.
+ *
+ * Coalesces rapid SSE change events into a single re-fetch per board
+ * via `useProviderSubscribe` (debounce ~100 ms).
+ */
+export function useBoardRender(slug) {
+    const provider = useProvider();
+    const [render, setRender] = useState(null);
+    const [homeless, setHomeless] = useState(null);
+    const [status, setStatus] = useState('loading');
+    const slugRef = useRef(slug);
+    slugRef.current = slug;
+    const fetchAll = useCallback(async () => {
+        const currentSlug = slugRef.current;
+        if (currentSlug === '') {
+            setRender(null);
+            setHomeless(null);
+            setStatus('ready');
+            return;
+        }
+        try {
+            const [renderResult, homelessResult] = await Promise.all([
+                provider.getBoardRender(currentSlug),
+                provider.getHomeless(currentSlug),
+            ]);
+            // Discard if slug changed while inflight
+            if (slugRef.current !== currentSlug)
+                return;
+            setRender(renderResult);
+            setHomeless(homelessResult);
+            setStatus('ready');
+        }
+        catch (err) {
+            console.error('Failed to load board render', currentSlug, err);
+            if (slugRef.current === currentSlug) {
+                setStatus('error');
+            }
+        }
+    }, [provider]);
+    useEffect(() => {
+        setRender(null);
+        setHomeless(null);
+        setStatus('loading');
+        void fetchAll();
+    }, [provider, slug, fetchAll]);
+    useProviderSubscribe(() => void fetchAll());
+    return { status, render, homeless, refetch: fetchAll };
+}
+//# sourceMappingURL=useBoardRender.js.map

package/dist/state/useBoardRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoardRender.js","sourceRoot":"","sources":["../../src/state/useBoardRender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAWjE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAkB,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAoB,SAAS,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAEvB,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QACrD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;QACpC,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACvD,QAAQ,CAAC,cAAc,CAAC,WAAW,CAAC;gBACpC,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC;aAClC,CAAC,CAAC;YACH,yCAAyC;YACzC,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW;gBAAE,OAAO;YAC5C,SAAS,CAAC,YAAY,CAAC,CAAC;YACxB,WAAW,CAAC,cAAc,CAAC,CAAC;YAC5B,SAAS,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAC/D,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;gBACpC,SAAS,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,SAAS,CAAC,SAAS,CAAC,CAAC;QACrB,KAAK,QAAQ,EAAE,CAAC;IAClB,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE/B,oBAAoB,CAAC,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACzD,CAAC"}

package/dist/state/useProviderSubscribe.d.ts

@@ -0,0 +1,22 @@
+import type { ProviderEvent } from '@awesome-markdown/contracts';
+type ChangeCallback = (event: ProviderEvent | null) => void;
+/**
+ * Subscribes to all provider change signals and invokes `callback` on each,
+ * debounced by `debounceMs` (default 100 ms).
+ *
+ * Two signal sources are wired:
+ * - `provider.subscribe()` — fires when the http/localstorage provider detects
+ *   a mutation (local API write or provider-fs file-watcher). The `ProviderEvent`
+ *   payload is forwarded to the callback.
+ * - `window` `sync-engine:change` custom event — fired by `conflict-store` when
+ *   the sync-engine SSE (port 7402) broadcasts a change (e.g. after a git pull).
+ *   The callback receives `null` because this path carries no entity metadata.
+ *
+ * The callback is stabilised via `useRef` so callers do not need to memoize it —
+ * the latest closure is always called without re-registering subscriptions.
+ *
+ * Subscriptions are re-established when `provider` or `debounceMs` change.
+ */
+export declare function useProviderSubscribe(callback: ChangeCallback, debounceMs?: number): void;
+export {};
+//# sourceMappingURL=useProviderSubscribe.d.ts.map

package/dist/state/useProviderSubscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProviderSubscribe.d.ts","sourceRoot":"","sources":["../../src/state/useProviderSubscribe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,UAAU,SAAM,GACf,IAAI,CAgCN"}

package/dist/state/useProviderSubscribe.js

@@ -0,0 +1,48 @@
+import { useEffect, useRef } from 'react';
+import { useProvider } from '../provider/ProviderContext.js';
+/**
+ * Subscribes to all provider change signals and invokes `callback` on each,
+ * debounced by `debounceMs` (default 100 ms).
+ *
+ * Two signal sources are wired:
+ * - `provider.subscribe()` — fires when the http/localstorage provider detects
+ *   a mutation (local API write or provider-fs file-watcher). The `ProviderEvent`
+ *   payload is forwarded to the callback.
+ * - `window` `sync-engine:change` custom event — fired by `conflict-store` when
+ *   the sync-engine SSE (port 7402) broadcasts a change (e.g. after a git pull).
+ *   The callback receives `null` because this path carries no entity metadata.
+ *
+ * The callback is stabilised via `useRef` so callers do not need to memoize it —
+ * the latest closure is always called without re-registering subscriptions.
+ *
+ * Subscriptions are re-established when `provider` or `debounceMs` change.
+ */
+export function useProviderSubscribe(callback, debounceMs = 100) {
+    const provider = useProvider();
+    // Always holds the latest callback without causing effect re-runs.
+    const callbackRef = useRef(callback);
+    callbackRef.current = callback;
+    const debounceRef = useRef(null);
+    useEffect(() => {
+        const schedule = (event) => {
+            if (debounceRef.current !== null)
+                clearTimeout(debounceRef.current);
+            debounceRef.current = setTimeout(() => {
+                debounceRef.current = null;
+                callbackRef.current(event);
+            }, debounceMs);
+        };
+        const unsubscribe = provider.subscribe((event) => schedule(event));
+        const handleWindowChange = () => schedule(null);
+        window.addEventListener('sync-engine:change', handleWindowChange);
+        return () => {
+            unsubscribe();
+            window.removeEventListener('sync-engine:change', handleWindowChange);
+            if (debounceRef.current !== null) {
+                clearTimeout(debounceRef.current);
+                debounceRef.current = null;
+            }
+        };
+    }, [provider, debounceMs]);
+}
+//# sourceMappingURL=useProviderSubscribe.js.map

package/dist/state/useProviderSubscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProviderSubscribe.js","sourceRoot":"","sources":["../../src/state/useProviderSubscribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAI7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAwB,EACxB,UAAU,GAAG,GAAG;IAEhB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,mEAAmE;IACnE,MAAM,WAAW,GAAG,MAAM,CAAiB,QAAQ,CAAC,CAAC;IACrD,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAE/B,MAAM,WAAW,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IAEvE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,KAA2B,EAAQ,EAAE;YACrD,IAAI,WAAW,CAAC,OAAO,KAAK,IAAI;gBAAE,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACpE,WAAW,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC3B,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC,EAAE,UAAU,CAAC,CAAC;QACjB,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAEnE,MAAM,kBAAkB,GAAG,GAAS,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QAElE,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAC;YACd,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;YACrE,IAAI,WAAW,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACjC,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAClC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/sync/conflict-api.d.ts

@@ -0,0 +1,16 @@
+import type { ConflictState, ResolveDecision, ResolveResponse } from '@awesome-markdown/contracts';
+/**
+ * Fetch the current conflict state from the sync-engine.
+ *
+ * @param base Base URL of the sync-engine HTTP server (resolved by the host app).
+ */
+export declare function fetchConflictState(base: string): Promise<ConflictState | null>;
+/**
+ * Submit resolution decisions to the sync-engine.
+ *
+ * @param base      Base URL of the sync-engine HTTP server.
+ * @param mergeId   The active mergeId.
+ * @param decisions Map of repo-relative path → decision.
+ */
+export declare function submitDecisions(base: string, mergeId: string, decisions: Record<string, ResolveDecision>): Promise<ResolveResponse>;
+//# sourceMappingURL=conflict-api.d.ts.map

package/dist/sync/conflict-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-api.d.ts","sourceRoot":"","sources":["../../src/sync/conflict-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAErC;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAOpF;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GACzC,OAAO,CAAC,eAAe,CAAC,CAe1B"}

package/dist/sync/conflict-api.js

@@ -0,0 +1,35 @@
+/**
+ * Fetch the current conflict state from the sync-engine.
+ *
+ * @param base Base URL of the sync-engine HTTP server (resolved by the host app).
+ */
+export async function fetchConflictState(base) {
+    const resp = await fetch(`${base}/sync/conflict/state`, {
+        signal: AbortSignal.timeout(5_000),
+    });
+    if (!resp.ok)
+        return null;
+    const body = (await resp.json());
+    return body.conflict ?? null;
+}
+/**
+ * Submit resolution decisions to the sync-engine.
+ *
+ * @param base      Base URL of the sync-engine HTTP server.
+ * @param mergeId   The active mergeId.
+ * @param decisions Map of repo-relative path → decision.
+ */
+export async function submitDecisions(base, mergeId, decisions) {
+    const resp = await fetch(`${base}/sync/conflict/resolve`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ mergeId, decisions }),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!resp.ok) {
+        const err = (await resp.json().catch(() => ({ message: resp.statusText })));
+        throw new Error(err.message ?? err.error ?? `HTTP ${resp.status}`);
+    }
+    return resp.json();
+}
+//# sourceMappingURL=conflict-api.js.map

package/dist/sync/conflict-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-api.js","sourceRoot":"","sources":["../../src/sync/conflict-api.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,sBAAsB,EAAE;QACtD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAuC,CAAC;IACvE,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,OAAe,EACf,SAA0C;IAE1C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,wBAAwB,EAAE;QACxD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAC5C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAGzE,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,EAA8B,CAAC;AACjD,CAAC"}

package/dist/sync/conflict-store.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import type { ConflictState, ResolveDecision } from '@awesome-markdown/contracts';
+export interface ConflictStoreState {
+    activeConflict: ConflictState | null;
+    submitting: boolean;
+    error: string | null;
+}
+interface ConflictContextValue extends ConflictStoreState {
+    isPathAffected: (filePath: string) => boolean;
+    /** Returns true if any conflicted path contains the given item ID. */
+    isItemAffected: (itemId: string) => boolean;
+    decisionFor: (filePath: string) => ResolveDecision | null;
+    resolve: (decisions: Record<string, ResolveDecision>) => Promise<void>;
+    dismissError: () => void;
+}
+interface ConflictProviderProps {
+    /**
+     * Base URL of the sync-engine HTTP server (e.g. `http://localhost:7402` or a
+     * same-origin proxy path such as `/sync-engine`). Hosts without a
+     * sync-engine simply don't mount `ConflictProvider`.
+     */
+    syncEngineUrl: string;
+    children: React.ReactNode;
+}
+/**
+ * Provides the conflict store to the component tree.
+ *
+ * On mount:
+ *  1. Fetches GET /sync/conflict/state to hydrate any in-flight conflict.
+ *  2. Subscribes to SSE events (conflict / synced) via EventSource.
+ *
+ * The EventSource is reconnect-safe: duplicate `conflict` events for the same
+ * mergeId are coalesced (idempotent set-state).
+ */
+export declare function ConflictProvider({ syncEngineUrl, children, }: ConflictProviderProps): React.ReactElement;
+/** Access the conflict store. Must be used inside <ConflictProvider>. */
+export declare function useConflict(): ConflictContextValue;
+/**
+ * Like useConflict but returns null when not inside <ConflictProvider>.
+ * Useful for components that are also rendered outside a provider (e.g. tests).
+ */
+export declare function useOptionalConflict(): ConflictContextValue | null;
+export {};
+//# sourceMappingURL=conflict-store.d.ts.map

package/dist/sync/conflict-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-store.d.ts","sourceRoot":"","sources":["../../src/sync/conflict-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAOlF,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAwCD,UAAU,oBAAqB,SAAQ,kBAAkB;IACvD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,sEAAsE;IACtE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,eAAe,GAAG,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAQD,UAAU,qBAAqB;IAC7B;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,aAAa,EACb,QAAQ,GACT,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAgI5C;AAED,yEAAyE;AACzE,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,IAAI,CAEjE"}