@particle-academy/react-fancy 5.49.0 → 5.50.0

package/dist/index.d.ts

@@ -131,14 +131,81 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function sanitizeHref(href: string | undefined | null): string | undefined;
 /**
- * Sanitize an HTML string by removing dangerous tags (script, iframe, etc.),
- * event-handler attributes (`onclick`, `onerror`, ...), and dangerous URI
- * schemes in `href`/`src` attributes.
+ * Allowlist options for {@link sanitizeHtml}. Passing ANY options object
+ * (even `{}`) switches from the default blocklist to allowlist mode, where
+ * everything not listed is removed.
+ */
+interface SanitizeHtmlOptions {
+    /**
+     * Tags to keep, e.g. `["p", "a", "strong"]`. A tag that is not listed is
+     * removed but its text and (cleaned) children are kept. Default: none, so
+     * only text survives.
+     *
+     * Some tags are removed WITH their content even when listed, because no
+     * attribute filtering makes them safe: `script`, `style`, `iframe`, `frame`,
+     * `frameset`, `object`, `embed`, `applet`, `link`, `meta`, `base`, `form`,
+     * `title`, `template`, `noscript`, `noembed`, `noframes`, `xmp`,
+     * `plaintext`, `svg` and `math`.
+     */
+    allowedTags?: readonly string[];
+    /**
+     * Attributes to keep. Either one list for every allowed tag, or a map from
+     * tag name to its list, where the key `"*"` applies to every tag. A trailing
+     * `*` matches a prefix (`"data-*"`, `"aria-*"`). Default: none.
+     *
+     * Never kept, even when listed: event handlers (`on*`), `srcdoc` and
+     * `srcset`.
+     */
+    allowedAttributes?: readonly string[] | Readonly<Record<string, readonly string[]>>;
+    /**
+     * URL schemes allowed in URL attributes (`href`, `src`, `action`,
+     * `formaction`, `cite`, `poster`, `background`, `ping`, `xlink:href`), with
+     * the colon: `["https:", "mailto:"]`. A URL attribute whose scheme is not
+     * listed is removed. Default: `["http:", "https:", "mailto:"]`.
+     *
+     * `javascript:` and `vbscript:` are never kept, even when listed.
+     */
+    allowedSchemes?: readonly string[];
+    /**
+     * Keep URLs with no scheme that stay on this site: `/x`, `x/y`, `../x`,
+     * `?q`, `#frag`. Protocol-relative URLs (`//host/x`, and the backslash
+     * spellings a browser treats the same way) leave the site and are always
+     * removed. Default: `false`.
+     */
+    allowRelative?: boolean;
+}
+/**
+ * Sanitize an HTML string.
+ *
+ * **With no options** (the default blocklist): removes dangerous tags (script,
+ * iframe, etc.), event-handler attributes (`onclick`, `onerror`, ...), and
+ * dangerous URI schemes in `href`/`src` attributes. Everything else is kept.
+ * In non-browser environments returns the input unchanged — sanitize on the
+ * server in those cases.
+ *
+ * **With options** (allowlist mode): keeps ONLY the listed tags, attributes and
+ * URL schemes; see {@link SanitizeHtmlOptions}. The allowlist can only narrow:
+ * event handlers, `javascript:` URLs and script-capable tags never survive,
+ * even when listed. In non-browser environments the input is returned as
+ * escaped text (fail closed).
+ *
+ * Uses the browser's `DOMParser`.
+ */
+declare function sanitizeHtml(html: string, options?: SanitizeHtmlOptions): string;
+
+/**
+ * Render markdown (GitHub-flavoured) to sanitised HTML — the same parser and
+ * output `ContentRenderer` uses, so a host never has to import the parser
+ * itself.
+ *
+ * With no `sanitize` options the default blocklist of {@link sanitizeHtml} is
+ * applied; pass allowlist options to keep only what you list:
  *
- * Uses the browser's `DOMParser`. In non-browser environments returns the
- * input unchanged — sanitize on the server in those cases.
+ * ```ts
+ * renderMarkdown(md, { allowedTags: ["p", "strong", "a"], allowedAttributes: ["href"] })
+ * ```
  */
-declare function sanitizeHtml(html: string): string;
+declare function renderMarkdown(markdown: string, sanitize?: SanitizeHtmlOptions): string;
 
 /**
  * One state slot that works controlled or uncontrolled.
@@ -316,4 +383,4 @@ type UseThemeResult = {
  */
 declare function useTheme(): UseThemeResult;
 
-export { type NodeRect, Placement, type ResolvedTheme, THEME_STORAGE_KEY, type ThemePreference, type UseThemeResult, cn, getThemePreference, initTheme, resolveTheme, sanitizeHref, sanitizeHtml, setThemePreference, subscribeTheme, useAnimation, useControllableState, useEscapeKey, useFloatingPosition, useFocusTrap, useId, useNodeRegistry, useOutsideClick, usePanZoom, useTheme };
+export { type NodeRect, Placement, type ResolvedTheme, type SanitizeHtmlOptions, THEME_STORAGE_KEY, type ThemePreference, type UseThemeResult, cn, getThemePreference, initTheme, renderMarkdown, resolveTheme, sanitizeHref, sanitizeHtml, setThemePreference, subscribeTheme, useAnimation, useControllableState, useEscapeKey, useFloatingPosition, useFocusTrap, useId, useNodeRegistry, useOutsideClick, usePanZoom, useTheme };

package/dist/index.js

@@ -19,7 +19,7 @@ export { TimeGrid } from './chunk-7CN7IHES.js';
 export { TimePicker } from './chunk-OTCLBINT.js';
 export { Timeline } from './chunk-7JDVCQXD.js';
 export { Toast, useToast } from './chunk-3AQLEMH7.js';
-export { ReasonTag } from './chunk-62WPAKFS.js';
+export { ReasonTag } from './chunk-UDEEPMQ4.js';
 export { Section } from './chunk-SLJD25VV.js';
 export { Separator } from './chunk-ZLWCZV7R.js';
 export { Sidebar, useSidebar } from './chunk-YD4SXA6K.js';
@@ -31,7 +31,7 @@ export { Pillbox } from './chunk-FSRPZYZZ.js';
 export { Popover, usePopover } from './chunk-6KXAFP2T.js';
 export { Profile } from './chunk-KQQA7JBC.js';
 export { Progress } from './chunk-P7PKK5BO.js';
-export { PromptInput, browserPlatformHints, detectPlatform, modifierKeyLabel } from './chunk-SK4AEUO4.js';
+export { PromptInput, browserPlatformHints, detectPlatform, modifierKeyLabel } from './chunk-XBC3M4BL.js';
 export { PullQuote } from './chunk-NDUEPDNS.js';
 export { QrCode, encodeQr, selectMode } from './chunk-RLE5WYY6.js';
 export { MobileMenu, useMobileMenu } from './chunk-P7F32HIH.js';
@@ -41,39 +41,39 @@ export { Navbar, useNavbar } from './chunk-IWXP2YUP.js';
 export { OtpInput } from './chunk-XDJSFGXW.js';
 export { Pagination } from './chunk-YF2EHBTV.js';
 export { InputTag, contentEditableAdapter, controlledAdapter, inputAdapter, textareaAdapter } from './chunk-Q7O5TLVU.js';
-export { JSON_FIELD_TYPES, JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches } from './chunk-VM5BNL4L.js';
+export { JSON_FIELD_TYPES, JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches } from './chunk-7MJ7VEKE.js';
 export { Input } from './chunk-EEWRLFTI.js';
 export { Select } from './chunk-IECPLOSZ.js';
 export { Switch } from './chunk-NBAHXZHJ.js';
 export { DatePicker } from './chunk-OC75GWX5.js';
 export { Kanban, useKanban } from './chunk-O6E2WC3J.js';
 export { Kbd } from './chunk-TJJ63UJV.js';
-export { MagicWand } from './chunk-JHDO6CRT.js';
+export { MagicWand } from './chunk-FU6R6BZ4.js';
 export { Textarea } from './chunk-DEFGT75G.js';
 import './chunk-PWEZCMIY.js';
 export { DisplayValue } from './chunk-KKWNKBKR.js';
 export { Field } from './chunk-5MU6X3KO.js';
 import './chunk-GFYSELJF.js';
 export { Marquee } from './chunk-RSLZL6VP.js';
-export { MediaViewer, resolveMediaType } from './chunk-MQEV7XEG.js';
+export { MediaViewer, resolveMediaType } from './chunk-YOTCZUNW.js';
 export { VideoViewer } from './chunk-VOGI7GX3.js';
-export { PdfViewer } from './chunk-VKRQHLM5.js';
+export { PdfViewer } from './chunk-VB3QJ6QE.js';
 export { Menu, useMenu } from './chunk-RA2VOQ46.js';
 export { FileBrowser, FileBrowserNewFolder, useFileBrowser, validateFolderName } from './chunk-2KAJ4L7C.js';
 export { FileUpload, useFileUpload } from './chunk-W6RDAZJC.js';
 export { Grid } from './chunk-TM3RTWKI.js';
 import './chunk-CFH6CJQG.js';
-export { ImageViewer } from './chunk-XOWWNG7D.js';
-export { FauxClient } from './chunk-XWXV6HSK.js';
+export { ImageViewer } from './chunk-ASS6EWNI.js';
+export { FauxClient } from './chunk-XZUGREDI.js';
 export { IndexList } from './chunk-UKUNWGL5.js';
 import './chunk-AUTW5O4W.js';
 export { ContextMenu, useContextMenu } from './chunk-SWBF2BXA.js';
 export { Drawer, useDrawer } from './chunk-VFIVF5YO.js';
 export { Dropdown, useDropdown } from './chunk-YQJWD53X.js';
-export { Editor, useEditor } from './chunk-K74R6IEB.js';
+export { Editor, useEditor } from './chunk-PCTZNK2Z.js';
 export { THEME_STORAGE_KEY, getThemePreference, initTheme, resolveTheme, setThemePreference, subscribeTheme, useId, useNodeRegistry, useTheme } from './chunk-FWCREAIT.js';
 export { usePanZoom } from './chunk-CPY7NHXM.js';
-export { ContentRenderer, registerExtension, registerExtensions } from './chunk-GMNMJLZO.js';
+export { ContentRenderer, registerExtension, registerExtensions, renderMarkdown } from './chunk-K6EJLBBQ.js';
 export { Emoji } from './chunk-YTMQ2K64.js';
 export { EmojiSelect } from './chunk-VYHZEQIG.js';
 export { Eyebrow } from './chunk-Y4UPKJN5.js';
@@ -97,8 +97,8 @@ export { Badge } from './chunk-6FCQD2KQ.js';
 export { Brand, BrandMark } from './chunk-FCSR2WVS.js';
 export { Breadcrumbs } from './chunk-TDDWWAM5.js';
 import './chunk-LQ4ICCN2.js';
-export { Action, Button } from './chunk-ZLYOMQ2J.js';
-export { sanitizeHref, sanitizeHtml } from './chunk-QXYO76NZ.js';
+export { Action, Button } from './chunk-KODD54GT.js';
+export { sanitizeHref, sanitizeHtml } from './chunk-6TBRBN7H.js';
 export { EMOJI_CATEGORY_ORDER, EMOJI_DATA, EMOJI_ENTRIES, SKIN_TONES, applyTone, find, hasSkinTones, resolve, search, skinTones } from './chunk-45BBNJQD.js';
 export { Icon, configureIcons, registerIconAddendum, registerIconSet, registerIcons } from './chunk-IVRYSSM7.js';
 export { Calendar } from './chunk-NTMHP7FS.js';

package/dist/json-editor.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkRLC2BE3D_cjs = require('./chunk-RLC2BE3D.cjs');
+var chunkVWBKFQQN_cjs = require('./chunk-VWBKFQQN.cjs');
 require('./chunk-2QIGXSSZ.cjs');
 require('./chunk-AR3JOPGT.cjs');
 require('./chunk-Y52NXM73.cjs');
@@ -14,8 +14,8 @@ require('./chunk-BVRPDMB7.cjs');
 require('./chunk-MSRYJETY.cjs');
 require('./chunk-X7H75WVP.cjs');
 require('./chunk-MOU6O324.cjs');
-require('./chunk-3XJKJQSY.cjs');
-require('./chunk-LRNWD26Z.cjs');
+require('./chunk-FWA4PCW7.cjs');
+require('./chunk-X2FC7ODX.cjs');
 require('./chunk-XCZZVRBY.cjs');
 require('./chunk-QKFOJKVE.cjs');
 require('./chunk-LCNHEYIM.cjs');
@@ -33,47 +33,47 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "JsonEditor", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.JsonEditor; }
+  get: function () { return chunkVWBKFQQN_cjs.JsonEditor; }
 });
 Object.defineProperty(exports, "applyJsonEdit", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.applyJsonEdit; }
+  get: function () { return chunkVWBKFQQN_cjs.applyJsonEdit; }
 });
 Object.defineProperty(exports, "describeEdit", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.describeEdit; }
+  get: function () { return chunkVWBKFQQN_cjs.describeEdit; }
 });
 Object.defineProperty(exports, "findJsonConflicts", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.findJsonConflicts; }
+  get: function () { return chunkVWBKFQQN_cjs.findJsonConflicts; }
 });
 Object.defineProperty(exports, "getAtPath", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.getAtPath; }
+  get: function () { return chunkVWBKFQQN_cjs.getAtPath; }
 });
 Object.defineProperty(exports, "inferType", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.inferType; }
+  get: function () { return chunkVWBKFQQN_cjs.inferType; }
 });
 Object.defineProperty(exports, "parseKeyMap", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.parseKeyMap; }
+  get: function () { return chunkVWBKFQQN_cjs.parseKeyMap; }
 });
 Object.defineProperty(exports, "parsePath", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.parsePath; }
+  get: function () { return chunkVWBKFQQN_cjs.parsePath; }
 });
 Object.defineProperty(exports, "pathToString", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.pathToString; }
+  get: function () { return chunkVWBKFQQN_cjs.pathToString; }
 });
 Object.defineProperty(exports, "resolveKeyRule", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.resolveKeyRule; }
+  get: function () { return chunkVWBKFQQN_cjs.resolveKeyRule; }
 });
 Object.defineProperty(exports, "typeMatches", {
   enumerable: true,
-  get: function () { return chunkRLC2BE3D_cjs.typeMatches; }
+  get: function () { return chunkVWBKFQQN_cjs.typeMatches; }
 });
 //# sourceMappingURL=json-editor.cjs.map
 //# sourceMappingURL=json-editor.cjs.map

package/dist/json-editor.js

@@ -1,4 +1,4 @@
-export { JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches } from './chunk-VM5BNL4L.js';
+export { JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches } from './chunk-7MJ7VEKE.js';
 import './chunk-EEWRLFTI.js';
 import './chunk-IECPLOSZ.js';
 import './chunk-NBAHXZHJ.js';
@@ -12,8 +12,8 @@ import './chunk-F2GAZZVS.js';
 import './chunk-KYZNCVRD.js';
 import './chunk-CF5KRDN4.js';
 import './chunk-6FCQD2KQ.js';
-import './chunk-ZLYOMQ2J.js';
-import './chunk-QXYO76NZ.js';
+import './chunk-KODD54GT.js';
+import './chunk-6TBRBN7H.js';
 import './chunk-45BBNJQD.js';
 import './chunk-IVRYSSM7.js';
 import './chunk-ZXZJYVWP.js';

package/dist/magic-wand.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkI6XHZ3S2_cjs = require('./chunk-I6XHZ3S2.cjs');
+var chunkNAQJF3G6_cjs = require('./chunk-NAQJF3G6.cjs');
 require('./chunk-V6VFSX6V.cjs');
 require('./chunk-7EZBMGEE.cjs');
 require('./chunk-XKDW6B7X.cjs');
@@ -9,8 +9,8 @@ require('./chunk-YLGTDBB2.cjs');
 require('./chunk-VBWRH4UW.cjs');
 require('./chunk-MOU6O324.cjs');
 require('./chunk-M5MUGSON.cjs');
-require('./chunk-3XJKJQSY.cjs');
-require('./chunk-LRNWD26Z.cjs');
+require('./chunk-FWA4PCW7.cjs');
+require('./chunk-X2FC7ODX.cjs');
 require('./chunk-XCZZVRBY.cjs');
 require('./chunk-QKFOJKVE.cjs');
 require('./chunk-KJ22KE56.cjs');
@@ -21,7 +21,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "MagicWand", {
   enumerable: true,
-  get: function () { return chunkI6XHZ3S2_cjs.MagicWand; }
+  get: function () { return chunkNAQJF3G6_cjs.MagicWand; }
 });
 //# sourceMappingURL=magic-wand.cjs.map
 //# sourceMappingURL=magic-wand.cjs.map

package/dist/magic-wand.js

@@ -1,4 +1,4 @@
-export { MagicWand } from './chunk-JHDO6CRT.js';
+export { MagicWand } from './chunk-FU6R6BZ4.js';
 import './chunk-DEFGT75G.js';
 import './chunk-PWEZCMIY.js';
 import './chunk-KKWNKBKR.js';
@@ -7,8 +7,8 @@ import './chunk-GFYSELJF.js';
 import './chunk-IQ4KQJAO.js';
 import './chunk-6FCQD2KQ.js';
 import './chunk-LQ4ICCN2.js';
-import './chunk-ZLYOMQ2J.js';
-import './chunk-QXYO76NZ.js';
+import './chunk-KODD54GT.js';
+import './chunk-6TBRBN7H.js';
 import './chunk-45BBNJQD.js';
 import './chunk-IVRYSSM7.js';
 import './chunk-OL53XYHF.js';

package/dist/media-viewer.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkKST6GW2B_cjs = require('./chunk-KST6GW2B.cjs');
+var chunkNCXH5O4I_cjs = require('./chunk-NCXH5O4I.cjs');
 require('./chunk-TH7VP4CL.cjs');
-require('./chunk-LP3HMRQT.cjs');
-require('./chunk-WBJRFWZE.cjs');
-require('./chunk-DUOZSOSB.cjs');
+require('./chunk-IYVV4RD3.cjs');
+require('./chunk-2KZINS6D.cjs');
+require('./chunk-RU6ZTA4M.cjs');
 require('./chunk-T6YELZPJ.cjs');
 require('./chunk-QW66UHWO.cjs');
 require('./chunk-SNHU2AI4.cjs');
@@ -14,7 +14,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "MediaViewer", {
   enumerable: true,
-  get: function () { return chunkKST6GW2B_cjs.MediaViewer; }
+  get: function () { return chunkNCXH5O4I_cjs.MediaViewer; }
 });
 //# sourceMappingURL=media-viewer.cjs.map
 //# sourceMappingURL=media-viewer.cjs.map

package/dist/media-viewer.js

@@ -1,8 +1,8 @@
-export { MediaViewer } from './chunk-MQEV7XEG.js';
+export { MediaViewer } from './chunk-YOTCZUNW.js';
 import './chunk-VOGI7GX3.js';
-import './chunk-VKRQHLM5.js';
-import './chunk-XOWWNG7D.js';
-import './chunk-XWXV6HSK.js';
+import './chunk-VB3QJ6QE.js';
+import './chunk-ASS6EWNI.js';
+import './chunk-XZUGREDI.js';
 import './chunk-CPY7NHXM.js';
 import './chunk-UIJR26YW.js';
 import './chunk-EDYAXGUM.js';

package/dist/pdf-viewer.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkLP3HMRQT_cjs = require('./chunk-LP3HMRQT.cjs');
-require('./chunk-DUOZSOSB.cjs');
+var chunkIYVV4RD3_cjs = require('./chunk-IYVV4RD3.cjs');
+require('./chunk-RU6ZTA4M.cjs');
 require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
@@ -9,7 +9,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "PdfViewer", {
   enumerable: true,
-  get: function () { return chunkLP3HMRQT_cjs.PdfViewer; }
+  get: function () { return chunkIYVV4RD3_cjs.PdfViewer; }
 });
 //# sourceMappingURL=pdf-viewer.cjs.map
 //# sourceMappingURL=pdf-viewer.cjs.map

package/dist/pdf-viewer.js

@@ -1,5 +1,5 @@
-export { PdfViewer } from './chunk-VKRQHLM5.js';
-import './chunk-XWXV6HSK.js';
+export { PdfViewer } from './chunk-VB3QJ6QE.js';
+import './chunk-XZUGREDI.js';
 import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=pdf-viewer.js.map

package/dist/prompt-input.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkTKDUT7ZA_cjs = require('./chunk-TKDUT7ZA.cjs');
+var chunkIPBEVSSC_cjs = require('./chunk-IPBEVSSC.cjs');
 require('./chunk-AIA5UNQ5.cjs');
 require('./chunk-MSRYJETY.cjs');
 require('./chunk-X7H75WVP.cjs');
 require('./chunk-M5MUGSON.cjs');
-require('./chunk-3XJKJQSY.cjs');
-require('./chunk-LRNWD26Z.cjs');
+require('./chunk-FWA4PCW7.cjs');
+require('./chunk-X2FC7ODX.cjs');
 require('./chunk-XCZZVRBY.cjs');
 require('./chunk-QKFOJKVE.cjs');
 require('./chunk-J2DI6RMR.cjs');
@@ -18,7 +18,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "PromptInput", {
   enumerable: true,
-  get: function () { return chunkTKDUT7ZA_cjs.PromptInput; }
+  get: function () { return chunkIPBEVSSC_cjs.PromptInput; }
 });
 //# sourceMappingURL=prompt-input.cjs.map
 //# sourceMappingURL=prompt-input.cjs.map

package/dist/prompt-input.js

@@ -1,10 +1,10 @@
-export { PromptInput } from './chunk-SK4AEUO4.js';
+export { PromptInput } from './chunk-XBC3M4BL.js';
 import './chunk-TJ66S5K6.js';
 import './chunk-KYZNCVRD.js';
 import './chunk-CF5KRDN4.js';
 import './chunk-LQ4ICCN2.js';
-import './chunk-ZLYOMQ2J.js';
-import './chunk-QXYO76NZ.js';
+import './chunk-KODD54GT.js';
+import './chunk-6TBRBN7H.js';
 import './chunk-45BBNJQD.js';
 import './chunk-IVRYSSM7.js';
 import './chunk-MQ6VGG62.js';

package/dist/reason-tag.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkEEKXWXYO_cjs = require('./chunk-EEKXWXYO.cjs');
+var chunkGCWIZNN2_cjs = require('./chunk-GCWIZNN2.cjs');
 require('./chunk-WKNVZUWZ.cjs');
 require('./chunk-M5MUGSON.cjs');
-require('./chunk-3XJKJQSY.cjs');
-require('./chunk-LRNWD26Z.cjs');
+require('./chunk-FWA4PCW7.cjs');
+require('./chunk-X2FC7ODX.cjs');
 require('./chunk-XCZZVRBY.cjs');
 require('./chunk-QKFOJKVE.cjs');
 require('./chunk-J2DI6RMR.cjs');
@@ -17,7 +17,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "ReasonTag", {
   enumerable: true,
-  get: function () { return chunkEEKXWXYO_cjs.ReasonTag; }
+  get: function () { return chunkGCWIZNN2_cjs.ReasonTag; }
 });
 //# sourceMappingURL=reason-tag.cjs.map
 //# sourceMappingURL=reason-tag.cjs.map

package/dist/reason-tag.js

@@ -1,8 +1,8 @@
-export { ReasonTag } from './chunk-62WPAKFS.js';
+export { ReasonTag } from './chunk-UDEEPMQ4.js';
 import './chunk-6KXAFP2T.js';
 import './chunk-LQ4ICCN2.js';
-import './chunk-ZLYOMQ2J.js';
-import './chunk-QXYO76NZ.js';
+import './chunk-KODD54GT.js';
+import './chunk-6TBRBN7H.js';
 import './chunk-45BBNJQD.js';
 import './chunk-IVRYSSM7.js';
 import './chunk-MQ6VGG62.js';

package/docs/ContentRenderer.md

@@ -91,3 +91,39 @@ registerExtension({
 ```tsx
 <ContentRenderer value="# Title\n\nParagraph with **bold** text." format="markdown" />
 ```
+
+## Markdown and sanitising without the component
+
+`renderMarkdown(markdown, sanitize?)` returns the same HTML `ContentRenderer`
+renders, already sanitised, so a host never imports the markdown parser itself.
+
+`sanitizeHtml(html)` is a blocklist: it strips what can run (script, iframe,
+event handlers, `javascript:` URLs, ...) and keeps the rest. Pass options and it
+becomes an **allowlist** that keeps only what you list:
+
+```ts
+import { renderMarkdown, sanitizeHtml, type SanitizeHtmlOptions } from "@particle-academy/react-fancy";
+
+const CHAT_PROSE: SanitizeHtmlOptions = {
+  allowedTags: ["p", "br", "strong", "em", "a", "ul", "ol", "li", "code", "pre"],
+  allowedAttributes: ["href", "title"],         // or { "*": ["title"], a: ["href"], span: ["data-*"] }
+  allowedSchemes: ["https:", "http:", "mailto:"], // the default
+  allowRelative: true,                           // /x, ../x, ?q, #frag; never //host. Default false
+};
+
+renderMarkdown(md, CHAT_PROSE);       // same as sanitizeHtml(renderMarkdown(md), CHAT_PROSE)
+sanitizeHtml(html, CHAT_PROSE);
+```
+
+| Rule | Allowlist mode |
+|------|----------------|
+| Tag not listed | removed, its text and cleaned children kept |
+| `script`, `style`, `iframe`, `frame(set)`, `object`, `embed`, `applet`, `link`, `meta`, `base`, `form`, `title`, `template`, `noscript`, `noembed`, `noframes`, `xmp`, `plaintext`, `svg`, `math` | removed WITH content, even when listed |
+| Attribute not listed | removed |
+| `on*`, `srcdoc`, `srcset` | removed, even when listed |
+| URL attribute with an unlisted scheme | removed |
+| `javascript:`, `vbscript:` | removed, even when listed |
+| Comments | removed |
+| No DOM (SSR) | input returned as escaped text (fails closed) |
+
+The allowlist can only narrow: nothing you list widens past the blocklist.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/react-fancy",
-  "version": "5.49.0",
+  "version": "5.50.0",
   "description": "React UI component library for Human+ UX — controlled, agent-bridgeable primitives",
   "repository": {
     "type": "git",

package/dist/chunk-DUOZSOSB.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/FauxClient/FauxClient.tsx"],"names":["forwardRef","useRef","useState","useControllableState","useLayoutEffect","useEffect","useCallback","jsxs","cn","Fragment","jsx"],"mappings":";;;;;;;AAKA,IAAM,UAAA,GAAa,CAAC,aAAA,EAAe,cAAA,EAAgB,cAAc,CAAA;AAGjE,IAAM,SAAA,GAAY,IAAA;AAElB,IAAM,KAAA,GAAQ,CAAC,CAAA,EAAW,GAAA,EAAa,GAAA,KAAgB,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,CAAC,CAAC,CAAA;AAa9E,IAAM,UAAA,GAAaA,gBAAA;AAAA,EACxB,CACE;AAAA,IACE,OAAA,GAAU,SAAA;AAAA,IACV,GAAA;AAAA,IACA,IAAA;AAAA,IACA,IAAA,GAAO,IAAA;AAAA,IACP,KAAA;AAAA,IACA,KAAA,GAAQ,KAAA;AAAA,IACR,QAAA,GAAW,KAAA;AAAA,IACX,IAAA,EAAM,cAAA;AAAA,IACN,WAAA,GAAc,CAAA;AAAA,IACd,YAAA;AAAA,IACA,OAAA,GAAU,GAAA;AAAA,IACV,OAAA,GAAU,CAAA;AAAA,IACV,kBAAA;AAAA,IACA,IAAA,GAAO,KAAA;AAAA,IACP,SAAA,GAAY,IAAA;AAAA,IACZ,SAAA;AAAA,IACA,YAAA;AAAA,IACA,aAAA;AAAA,IACA,QAAA;AAAA,IACA,GAAG;AAAA,KAEL,GAAA,KACG;AACH,IAAA,MAAM,MAAA,GAAS,OAAO,KAAA,KAAU,QAAA;AAChC,IAAA,MAAM,OAAA,GAAUC,aAA8B,IAAI,CAAA;AAClD,IAAA,MAAM,WAAA,GAAcA,aAAuB,IAAI,CAAA;AAC/C,IAAA,MAAM,QAAA,GAAWA,aAAuB,IAAI,CAAA;AAC5C,IAAA,MAAM,CAAC,KAAK,MAAM,CAAA,GAAIC,eAAS,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,CAAC,CAAA;AACpE,IAAA,MAAM,CAAC,aAAA,EAAe,gBAAgB,CAAA,GAAIA,eAA6B,MAAS,CAAA;AAEhF,IAAA,MAAM,WAAW,QAAA,KAAa,IAAA,IAAS,OAAO,QAAA,KAAa,QAAA,IAAY,SAAS,IAAA,KAAS,KAAA;AACzF,IAAA,MAAM,iBAAiB,QAAA,KAAa,IAAA,IAAS,OAAO,QAAA,KAAa,QAAA,IAAY,SAAS,UAAA,KAAe,KAAA;AACrG,IAAA,MAAM,CAAC,IAAA,EAAM,OAAO,IAAIC,sCAAA,CAAqB,cAAA,EAAgB,aAAa,YAAY,CAAA;AACtF,IAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAID,eAAS,KAAK,CAAA;AAElD,IAAAE,qBAAA,CAAgB,MAAM;AACpB,MAAA,IAAI,CAAC,MAAA,EAAQ;AACb,MAAA,MAAM,WAAW,WAAA,CAAY,OAAA;AAC7B,MAAA,MAAM,QAAQ,QAAA,CAAS,OAAA;AACvB,MAAA,IAAI,CAAC,QAAA,IAAY,CAAC,KAAA,EAAO;AACzB,MAAA,IAAI,OAAO,mBAAmB,WAAA,EAAa;AAE3C,MAAA,MAAM,UAAU,MAAM;AACpB,QAAA,MAAM,QAAQ,QAAA,CAAS,WAAA;AACvB,QAAA,MAAA,CAAO,KAAA,KAAU,QAAS,KAAA,IAAS,KAAA,GAAQ,IAAI,KAAA,GAAQ,KAAA,GAAQ,IAAK,KAAK,CAAA;AAEzE,QAAA,gBAAA,CAAiB,MAAM,YAAY,CAAA;AAAA,MACrC,CAAA;AAEA,MAAA,OAAA,EAAQ;AACR,MAAA,MAAM,EAAA,GAAK,IAAI,cAAA,CAAe,OAAO,CAAA;AACrC,MAAA,EAAA,CAAG,QAAQ,QAAQ,CAAA;AACnB,MAAA,EAAA,CAAG,QAAQ,KAAK,CAAA;AAChB,MAAA,OAAO,MAAM,GAAG,UAAA,EAAW;AAAA,IAC7B,CAAA,EAAG,CAAC,MAAA,EAAQ,KAAA,EAAO,KAAK,CAAC,CAAA;AAIzB,IAAAC,eAAA,CAAU,MAAM;AACd,MAAA,IAAI,CAAC,cAAA,IAAkB,OAAO,QAAA,KAAa,WAAA,EAAa;AACxD,MAAA,MAAM,OAAO,MAAM;AACjB,QAAA,MAAM,KAAK,QAAA,CAAS,iBAAA,IAAqB,IAAA,IAAQ,QAAA,CAAS,sBAAsB,OAAA,CAAQ,OAAA;AACxF,QAAA,aAAA,CAAc,EAAE,CAAA;AAChB,QAAA,kBAAA,GAAqB,EAAE,CAAA;AAAA,MACzB,CAAA;AACA,MAAA,QAAA,CAAS,gBAAA,CAAiB,oBAAoB,IAAI,CAAA;AAClD,MAAA,OAAO,MAAM,QAAA,CAAS,mBAAA,CAAoB,kBAAA,EAAoB,IAAI,CAAA;AAAA,IACpE,CAAA,EAAG,CAAC,cAAA,EAAgB,kBAAkB,CAAC,CAAA;AAEvC,IAAA,MAAM,gBAAA,GAAmBC,kBAAY,MAAM;AACzC,MAAA,MAAM,KAAK,OAAA,CAAQ,OAAA;AACnB,MAAA,IAAI,CAAC,EAAA,IAAM,OAAO,QAAA,KAAa,WAAA,EAAa;AAC5C,MAAA,IAAI,QAAA,CAAS,iBAAA,KAAsB,EAAA,EAAI,KAAK,SAAS,cAAA,IAAiB;AAAA,WACjE,KAAK,GAAG,iBAAA,IAAoB;AAAA,IACnC,CAAA,EAAG,EAAE,CAAA;AAEL,IAAA,MAAM,MAAA,GAAS,CAAC,MAAA,KAAmB;AAEjC,MAAA,OAAA,CAAQ,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,IAAA,GAAO,MAAA,GAAS,GAAG,CAAA,GAAI,GAAA,EAAK,OAAA,EAAS,OAAO,CAAC,CAAA;AAAA,IACxE,CAAA;AAEA,IAAA,MAAM,OAAA,GAAU,CAAC,EAAA,KAA8B;AAC7C,MAAA,OAAA,CAAQ,OAAA,GAAU,EAAA;AAClB,MAAA,IAAI,OAAO,GAAA,KAAQ,UAAA,EAAY,GAAA,CAAI,EAAE,CAAA;AAAA,WAAA,IAC5B,GAAA,MAAS,OAAA,GAAU,EAAA;AAAA,IAC9B,CAAA;AAEA,IAAA,MAAM,YAAY,OAAA,KAAY,SAAA;AAC9B,IAAA,MAAM,WAAW,OAAA,KAAY,QAAA;AAE7B,IAAA,MAAM,WAAA,GAAc,YAAY,IAAA,GAAO,CAAA;AACvC,IAAA,MAAM,YAAY,GAAA,GAAM,WAAA;AACxB,IAAA,MAAM,SAAS,WAAA,KAAgB,CAAA;AAC/B,IAAA,MAAM,cAAc,QAAA,IAAY,cAAA;AAYhC,IAAA,MAAM,cAAc,WAAA,mBAClBC,eAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,uCAAA,EAAsC,EAAA;AAAA,QACtC,SAAA,EAAWC,oBAAA;AAAA,UACT,iGAAA;AAAA,UACA,+FAAA;AAAA,UACA,YACI,wCAAA,GACA;AAAA,SACN;AAAA,QAEC,QAAA,EAAA;AAAA,UAAA,QAAA,oBACCD,eAAA,CAAAE,mBAAA,EAAA,EACE,QAAA,EAAA;AAAA,4BAAAC,cAAA;AAAA,cAAC,QAAA;AAAA,cAAA;AAAA,gBACC,IAAA,EAAK,QAAA;AAAA,gBACL,uCAAA,EAAsC,EAAA;AAAA,gBACtC,YAAA,EAAW,UAAA;AAAA,gBACX,KAAA,EAAM,UAAA;AAAA,gBACN,UAAU,IAAA,IAAQ,OAAA;AAAA,gBAClB,OAAA,EAAS,MAAM,MAAA,CAAO,CAAA,GAAI,SAAS,CAAA;AAAA,gBACnC,SAAA,EAAW,cAAc,SAAS,CAAA;AAAA,gBAElC,yCAAC,WAAA,EAAA,EAAY;AAAA;AAAA,aACf;AAAA,4BACAH,eAAA;AAAA,cAAC,QAAA;AAAA,cAAA;AAAA,gBACC,IAAA,EAAK,QAAA;AAAA,gBACL,yCAAA,EAAwC,EAAA;AAAA,gBACxC,YAAA,EAAW,YAAA;AAAA,gBACX,KAAA,EAAM,YAAA;AAAA,gBACN,OAAA,EAAS,MAAM,OAAA,CAAQ,CAAC,CAAA;AAAA,gBACxB,SAAA,EAAWC,oBAAA,CAAG,aAAA,CAAc,SAAS,GAAG,kEAAkE,CAAA;AAAA,gBAEzG,QAAA,EAAA;AAAA,kBAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AAAA,kBAAE;AAAA;AAAA;AAAA,aAC1B;AAAA,4BACAE,cAAA;AAAA,cAAC,QAAA;AAAA,cAAA;AAAA,gBACC,IAAA,EAAK,QAAA;AAAA,gBACL,sCAAA,EAAqC,EAAA;AAAA,gBACrC,YAAA,EAAW,SAAA;AAAA,gBACX,KAAA,EAAM,SAAA;AAAA,gBACN,UAAU,IAAA,IAAQ,OAAA;AAAA,gBAClB,OAAA,EAAS,MAAM,MAAA,CAAO,SAAS,CAAA;AAAA,gBAC/B,SAAA,EAAW,cAAc,SAAS,CAAA;AAAA,gBAElC,yCAAC,UAAA,EAAA,EAAW;AAAA;AAAA;AACd,WAAA,EACF,CAAA;AAAA,UAED,cAAA,oBACCA,cAAA;AAAA,YAAC,QAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,QAAA;AAAA,cACL,yCAAA,EAAwC,EAAA;AAAA,cACxC,YAAA,EAAY,aAAa,kBAAA,GAAqB,aAAA;AAAA,cAC9C,cAAA,EAAc,UAAA;AAAA,cACd,KAAA,EAAO,aAAa,kBAAA,GAAqB,aAAA;AAAA,cACzC,OAAA,EAAS,gBAAA;AAAA,cACT,SAAA,EAAW,cAAc,SAAS,CAAA;AAAA,cAEjC,QAAA,EAAA,UAAA,mBAAaA,cAAA,CAAC,kBAAA,EAAA,EAAmB,CAAA,kCAAM,cAAA,EAAA,EAAe;AAAA;AAAA;AACzD;AAAA;AAAA,KAEJ,GACE,IAAA;AAEJ,IAAA,uBACEH,eAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA,EAAK,OAAA;AAAA,QACL,8BAAA,EAA6B,EAAA;AAAA,QAC7B,iBAAA,EAAiB,cAAA,GAAiB,MAAA,CAAO,UAAU,CAAA,GAAI,MAAA;AAAA,QACvD,SAAA,EAAWC,oBAAA;AAAA,UACT,sEAAA;AAAA,UACA,SAAA,IAAa,mEAAA;AAAA,UACb,QAAA,IAAY,8EAAA;AAAA,UACZ,YAAY,MAAA,IAAU,wDAAA;AAAA;AAAA;AAAA,UAAA,CAGrB,QAAQ,UAAA,KAAe,eAAA;AAAA,UACxB,IAAA,IAAQ,QAAA;AAAA,UACR,UAAA,IAAc,cAAA;AAAA,UACd;AAAA,SACF;AAAA,QACC,GAAG,IAAA;AAAA,QAEH,QAAA,EAAA;AAAA,UAAA,SAAA,oBACCD,eAAA;AAAA,YAAC,KAAA;AAAA,YAAA;AAAA,cACC,SAAA,EAAWC,oBAAA;AAAA,gBACT,0KAAA;AAAA,gBACA;AAAA,eACF;AAAA,cAEC,QAAA,EAAA;AAAA,gBAAA,IAAA,mCACE,KAAA,EAAA,EAAI,SAAA,EAAU,yBACZ,QAAA,EAAA,UAAA,CAAW,GAAA,CAAI,CAAC,KAAA,EAAO,CAAA,qBACtBE,cAAA,CAAC,MAAA,EAAA,EAAa,WAAWF,oBAAA,CAAG,8BAAA,EAAgC,KAAK,CAAA,EAAA,EAAtD,CAAyD,CACrE,CAAA,EACH,CAAA;AAAA,gBAED,OAAO,IAAA,oBAAQE,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,2BAA2B,QAAA,EAAA,GAAA,EAAI,CAAA;AAAA,gBAC9D,QAAQ,IAAA,oBAAQA,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,6CAA6C,QAAA,EAAA,IAAA,EAAK,CAAA;AAAA,gBAClF,WAAA,oBAAeA,cAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAWF,oBAAA,CAAG,GAAA,IAAO,IAAA,IAAQ,IAAA,IAAQ,IAAA,IAAQ,SAAS,CAAA,EAAI,QAAA,EAAA,WAAA,EAAY;AAAA;AAAA;AAAA,WAC7F;AAAA,0BAGFE,cAAA;AAAA,YAAC,KAAA;AAAA,YAAA;AAAA,cACC,GAAA,EAAK,WAAA;AAAA,cACL,SAAA,EAAWF,oBAAA;AAAA,gBACT,UAAA;AAAA;AAAA,gBAEA,SAAS,eAAA,GAAkB,iBAAA;AAAA,gBAAA,CAC1B,QAAQ,UAAA,KAAe,gBAAA;AAAA,gBACxB;AAAA,eACF;AAAA,cAEA,KAAA,EAAO,MAAA,IAAU,CAAC,UAAA,IAAc,aAAA,KAAkB,SAAY,EAAE,MAAA,EAAQ,aAAA,GAAgB,GAAA,EAAI,GAAI,MAAA;AAAA,cAE/F,QAAA,EAAA,MAAA;AAAA;AAAA,gCAECE,cAAA;AAAA,kBAAC,KAAA;AAAA,kBAAA;AAAA,oBACC,KAAA,EACE,aAAA,KAAkB,MAAA,IAAa,KAAA,KAAU,SACrC,EAAE,KAAA,EAAO,KAAA,GAAQ,SAAA,EAAW,MAAA,EAAQ,aAAA,GAAgB,SAAA,EAAW,QAAA,EAAU,YAAW,GACpF,MAAA;AAAA,oBAGN,QAAA,kBAAAA,cAAA;AAAA,sBAAC,KAAA;AAAA,sBAAA;AAAA,wBACC,GAAA,EAAK,QAAA;AAAA,wBACL,sCAAA,EAAqC,EAAA;AAAA,wBACrC,SAAA,EAAU,uCAAA;AAAA,wBACV,OAAO,EAAE,KAAA,EAAO,SAAA,EAAW,CAAA,MAAA,EAAS,SAAS,CAAA,CAAA,CAAA,EAAI;AAAA,wBAEhD;AAAA;AAAA;AACH;AAAA;AACF,kCAEAA,cAAA;AAAA,gBAAC,KAAA;AAAA,gBAAA;AAAA,kBACC,sCAAA,EAAqC,EAAA;AAAA,kBACrC,SAAA,EAAWF,oBAAA,CAAA,CAAI,IAAA,IAAQ,UAAA,KAAe,QAAQ,CAAA;AAAA,kBAG9C,OAAO,MAAA,GAAS,EAAE,MAAM,MAAA,CAAO,WAAW,GAAE,GAAI,MAAA;AAAA,kBAE/C;AAAA;AAAA;AACH;AAAA,WAEJ;AAAA,UAEC,eAAe,CAAC,SAAA,mCACd,KAAA,EAAA,EAAI,SAAA,EAAU,mDAAmD,QAAA,EAAA,WAAA,EAAY;AAAA;AAAA;AAAA,KAElF;AAAA,EAEJ;AACF;AAEA,UAAA,CAAW,WAAA,GAAc,YAAA;AAGzB,SAAS,cAAc,KAAA,EAAwB;AAC7C,EAAA,OAAOA,oBAAA;AAAA,IACL,0HAAA;AAAA,IACA,gFAAA;AAAA,IACA,QACI,yFAAA,GACA;AAAA,GACN;AACF;AAEA,SAAS,WAAA,GAAc;AACrB,EAAA,uCACG,KAAA,EAAA,EAAI,KAAA,EAAM,MAAK,MAAA,EAAO,IAAA,EAAK,SAAQ,WAAA,EAAY,IAAA,EAAK,QAAO,MAAA,EAAO,cAAA,EAAe,aAAY,GAAA,EAAI,aAAA,EAAc,SAAQ,cAAA,EAAe,OAAA,EAAQ,eAAY,MAAA,EACzJ,QAAA,EAAA;AAAA,oBAAAE,cAAA,CAAC,YAAO,EAAA,EAAG,IAAA,EAAK,EAAA,EAAG,IAAA,EAAK,GAAE,GAAA,EAAI,CAAA;AAAA,oBAC9BA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,gBAAA,EAAiB,CAAA;AAAA,oBACzBA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,SAAA,EAAU;AAAA,GAAA,EACpB,CAAA;AAEJ;AAEA,SAAS,UAAA,GAAa;AACpB,EAAA,uCACG,KAAA,EAAA,EAAI,KAAA,EAAM,MAAK,MAAA,EAAO,IAAA,EAAK,SAAQ,WAAA,EAAY,IAAA,EAAK,QAAO,MAAA,EAAO,cAAA,EAAe,aAAY,GAAA,EAAI,aAAA,EAAc,SAAQ,cAAA,EAAe,OAAA,EAAQ,eAAY,MAAA,EACzJ,QAAA,EAAA;AAAA,oBAAAA,cAAA,CAAC,YAAO,EAAA,EAAG,IAAA,EAAK,EAAA,EAAG,IAAA,EAAK,GAAE,GAAA,EAAI,CAAA;AAAA,oBAC9BA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,gBAAA,EAAiB,CAAA;AAAA,oBACzBA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,SAAA,EAAU,CAAA;AAAA,oBAClBA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,SAAA,EAAU;AAAA,GAAA,EACpB,CAAA;AAEJ;AAGA,SAAS,cAAA,GAAiB;AACxB,EAAA,uCACG,KAAA,EAAA,EAAI,KAAA,EAAM,MAAK,MAAA,EAAO,IAAA,EAAK,SAAQ,WAAA,EAAY,IAAA,EAAK,QAAO,MAAA,EAAO,cAAA,EAAe,aAAY,GAAA,EAAI,aAAA,EAAc,SAAQ,cAAA,EAAe,OAAA,EAAQ,eAAY,MAAA,EACzJ,QAAA,EAAA;AAAA,oBAAAA,cAAA,CAAC,MAAA,EAAA,EAAK,GAAE,wBAAA,EAAyB,CAAA;AAAA,oBACjCA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,0BAAA,EAA2B,CAAA;AAAA,oBACnCA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,yBAAA,EAA0B,CAAA;AAAA,oBAClCA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,2BAAA,EAA4B;AAAA,GAAA,EACtC,CAAA;AAEJ;AAEA,SAAS,kBAAA,GAAqB;AAC5B,EAAA,uCACG,KAAA,EAAA,EAAI,KAAA,EAAM,MAAK,MAAA,EAAO,IAAA,EAAK,SAAQ,WAAA,EAAY,IAAA,EAAK,QAAO,MAAA,EAAO,cAAA,EAAe,aAAY,GAAA,EAAI,aAAA,EAAc,SAAQ,cAAA,EAAe,OAAA,EAAQ,eAAY,MAAA,EACzJ,QAAA,EAAA;AAAA,oBAAAA,cAAA,CAAC,MAAA,EAAA,EAAK,GAAE,wBAAA,EAAyB,CAAA;AAAA,oBACjCA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,0BAAA,EAA2B,CAAA;AAAA,oBACnCA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,yBAAA,EAA0B,CAAA;AAAA,oBAClCA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,2BAAA,EAA4B;AAAA,GAAA,EACtC,CAAA;AAEJ","file":"chunk-DUOZSOSB.cjs","sourcesContent":["import { forwardRef, useCallback, useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport { cn } from \"../../utils/cn\";\nimport { useControllableState } from \"../../hooks/use-controllable-state\";\nimport type { FauxClientProps } from \"./FauxClient.types\";\n\nconst DOT_COLORS = [\"bg-rose-300\", \"bg-amber-300\", \"bg-green-300\"];\n\n/** One click of the zoom bar. Matches `ImageViewer`, so the kit zooms one way. */\nconst ZOOM_STEP = 1.25;\n\nconst clamp = (n: number, min: number, max: number) => Math.min(max, Math.max(min, n));\n\n/**\n * A frame that mimics a browser window or device, rendering **real UI** inside.\n * With a logical `width` + `scale=\"fit\"` it renders a full-size page/app and\n * scales it down to fit any container (live thumbnails, device mockups) — the\n * content is real and interactive, just zoomed.\n *\n * Omit `width` for chrome around natural-size content (e.g. a code/preview card).\n *\n * `controls` adds a zoom bar and a full-screen button, for content that has to be\n * READ rather than glanced at: a slide or a sheet shrunk to fit a panel.\n */\nexport const FauxClient = forwardRef<HTMLDivElement, FauxClientProps>(\n  (\n    {\n      variant = \"browser\",\n      url,\n      meta,\n      dots = true,\n      width,\n      scale = \"fit\",\n      controls = false,\n      zoom: controlledZoom,\n      defaultZoom = 1,\n      onZoomChange,\n      minZoom = 0.5,\n      maxZoom = 4,\n      onFullscreenChange,\n      fill = false,\n      applyZoom = true,\n      className,\n      barClassName,\n      bodyClassName,\n      children,\n      ...rest\n    },\n    ref,\n  ) => {\n    const scaled = typeof width === \"number\";\n    const rootRef = useRef<HTMLDivElement | null>(null);\n    const viewportRef = useRef<HTMLDivElement>(null);\n    const stageRef = useRef<HTMLDivElement>(null);\n    const [fit, setFit] = useState(typeof scale === \"number\" ? scale : 1);\n    const [naturalHeight, setNaturalHeight] = useState<number | undefined>(undefined);\n\n    const showZoom = controls === true || (typeof controls === \"object\" && controls.zoom !== false);\n    const showFullscreen = controls === true || (typeof controls === \"object\" && controls.fullscreen !== false);\n    const [zoom, setZoom] = useControllableState(controlledZoom, defaultZoom, onZoomChange);\n    const [fullscreen, setFullscreen] = useState(false);\n\n    useLayoutEffect(() => {\n      if (!scaled) return;\n      const viewport = viewportRef.current;\n      const stage = stageRef.current;\n      if (!viewport || !stage) return;\n      if (typeof ResizeObserver === \"undefined\") return;\n\n      const measure = () => {\n        const avail = viewport.clientWidth;\n        setFit(scale === \"fit\" ? (width && width > 0 ? avail / width : 1) : scale);\n        // offsetHeight is the pre-transform layout height (CSS transforms don't affect it).\n        setNaturalHeight(stage.offsetHeight);\n      };\n\n      measure();\n      const ro = new ResizeObserver(measure);\n      ro.observe(viewport);\n      ro.observe(stage);\n      return () => ro.disconnect();\n    }, [scaled, scale, width]);\n\n    // Full screen is the browser's state, not ours: follow it, so Esc and the\n    // browser's own exit leave the button telling the truth.\n    useEffect(() => {\n      if (!showFullscreen || typeof document === \"undefined\") return;\n      const sync = () => {\n        const on = document.fullscreenElement != null && document.fullscreenElement === rootRef.current;\n        setFullscreen(on);\n        onFullscreenChange?.(on);\n      };\n      document.addEventListener(\"fullscreenchange\", sync);\n      return () => document.removeEventListener(\"fullscreenchange\", sync);\n    }, [showFullscreen, onFullscreenChange]);\n\n    const toggleFullscreen = useCallback(() => {\n      const el = rootRef.current;\n      if (!el || typeof document === \"undefined\") return;\n      if (document.fullscreenElement === el) void document.exitFullscreen?.();\n      else void el.requestFullscreen?.();\n    }, []);\n\n    const zoomBy = (factor: number) => {\n      // Rounded so ten clicks in and ten out land back on 100%, not 99.99%.\n      setZoom(clamp(Math.round(zoom * factor * 100) / 100, minZoom, maxZoom));\n    };\n\n    const setRefs = (el: HTMLDivElement | null) => {\n      rootRef.current = el;\n      if (typeof ref === \"function\") ref(el);\n      else if (ref) ref.current = el;\n    };\n\n    const isBrowser = variant === \"browser\";\n    const isDevice = variant === \"device\";\n    // The zoom the FRAME applies: none when the content zooms itself.\n    const appliedZoom = applyZoom ? zoom : 1;\n    const effective = fit * appliedZoom;\n    const zoomed = appliedZoom !== 1;\n    const hasControls = showZoom || showFullscreen;\n\n    /*\n     * Out of the way until wanted: hidden, and revealed when the pointer is over\n     * the frame or focus is inside it (keyboard). Always shown where there is no\n     * hover to reveal it (touch), or it could never be reached.\n     *\n     * In the browser chrome it sits in the address bar, inline. On a device or a\n     * bare frame there is no chrome, so it floats top-right as a slim strip: the\n     * bottom corners belong to the content (a slide viewer's page count lives\n     * there).\n     */\n    const controlsBar = hasControls ? (\n      <div\n        data-react-fancy-faux-client-controls=\"\"\n        className={cn(\n          \"pointer-events-auto flex shrink-0 items-center gap-px opacity-0 transition-opacity duration-150\",\n          \"group-hover/faux-client:opacity-100 focus-within:opacity-100 [@media(hover:none)]:opacity-100\",\n          isBrowser\n            ? \"-my-1 text-zinc-400 dark:text-zinc-500\"\n            : \"rounded-full bg-zinc-900/60 px-1 py-0.5 text-white/80 shadow-sm backdrop-blur-sm\",\n        )}\n      >\n        {showZoom && (\n          <>\n            <button\n              type=\"button\"\n              data-react-fancy-faux-client-zoom-out=\"\"\n              aria-label=\"Zoom out\"\n              title=\"Zoom out\"\n              disabled={zoom <= minZoom}\n              onClick={() => zoomBy(1 / ZOOM_STEP)}\n              className={controlButton(isBrowser)}\n            >\n              <ZoomOutIcon />\n            </button>\n            <button\n              type=\"button\"\n              data-react-fancy-faux-client-zoom-reset=\"\"\n              aria-label=\"Reset zoom\"\n              title=\"Reset zoom\"\n              onClick={() => setZoom(1)}\n              className={cn(controlButton(isBrowser), \"w-auto min-w-[2.25rem] px-1 font-sans text-[10.5px] tabular-nums\")}\n            >\n              {Math.round(zoom * 100)}%\n            </button>\n            <button\n              type=\"button\"\n              data-react-fancy-faux-client-zoom-in=\"\"\n              aria-label=\"Zoom in\"\n              title=\"Zoom in\"\n              disabled={zoom >= maxZoom}\n              onClick={() => zoomBy(ZOOM_STEP)}\n              className={controlButton(isBrowser)}\n            >\n              <ZoomInIcon />\n            </button>\n          </>\n        )}\n        {showFullscreen && (\n          <button\n            type=\"button\"\n            data-react-fancy-faux-client-fullscreen=\"\"\n            aria-label={fullscreen ? \"Exit full screen\" : \"Full screen\"}\n            aria-pressed={fullscreen}\n            title={fullscreen ? \"Exit full screen\" : \"Full screen\"}\n            onClick={toggleFullscreen}\n            className={controlButton(isBrowser)}\n          >\n            {fullscreen ? <ExitFullscreenIcon /> : <FullscreenIcon />}\n          </button>\n        )}\n      </div>\n    ) : null;\n\n    return (\n      <div\n        ref={setRefs}\n        data-react-fancy-faux-client=\"\"\n        data-fullscreen={showFullscreen ? String(fullscreen) : undefined}\n        className={cn(\n          \"group/faux-client relative overflow-hidden bg-white dark:bg-zinc-900\",\n          isBrowser && \"rounded-2xl border border-zinc-200 shadow-xl dark:border-zinc-800\",\n          isDevice && \"rounded-[2rem] border-[10px] border-zinc-800 shadow-2xl dark:border-zinc-700\",\n          variant === \"bare\" && \"rounded-lg border border-zinc-200 dark:border-zinc-800\",\n          // Fill (or full screen): the frame takes its parent's height and its\n          // body takes whatever the chrome leaves.\n          (fill || fullscreen) && \"flex flex-col\",\n          fill && \"h-full\",\n          fullscreen && \"rounded-none\",\n          className,\n        )}\n        {...rest}\n      >\n        {isBrowser && (\n          <div\n            className={cn(\n              \"flex items-center gap-2 border-b border-zinc-200 bg-zinc-50 px-3.5 py-2.5 font-mono text-[11.5px] text-zinc-500 dark:border-zinc-800 dark:bg-zinc-950 dark:text-zinc-400\",\n              barClassName,\n            )}\n          >\n            {dots && (\n              <div className=\"mr-1.5 flex gap-[5px]\">\n                {DOT_COLORS.map((color, i) => (\n                  <span key={i} className={cn(\"h-[9px] w-[9px] rounded-full\", color)} />\n                ))}\n              </div>\n            )}\n            {url != null && <span className=\"min-w-0 flex-1 truncate\">{url}</span>}\n            {meta != null && <span className=\"shrink-0 text-zinc-400 dark:text-zinc-500\">{meta}</span>}\n            {hasControls && <div className={cn(url == null && meta == null && \"ml-auto\")}>{controlsBar}</div>}\n          </div>\n        )}\n\n        <div\n          ref={viewportRef}\n          className={cn(\n            \"relative\",\n            // Zoomed in, the content is bigger than the frame: scroll to it.\n            zoomed ? \"overflow-auto\" : \"overflow-hidden\",\n            (fill || fullscreen) && \"min-h-0 flex-1\",\n            bodyClassName,\n          )}\n          // The frame keeps its FIT height whatever the zoom; zooming scrolls.\n          style={scaled && !fullscreen && naturalHeight !== undefined ? { height: naturalHeight * fit } : undefined}\n        >\n          {scaled ? (\n            // A sizer the size of the zoomed content, so the scrollbars are right.\n            <div\n              style={\n                naturalHeight !== undefined && width !== undefined\n                  ? { width: width * effective, height: naturalHeight * effective, position: \"relative\" }\n                  : undefined\n              }\n            >\n              <div\n                ref={stageRef}\n                data-react-fancy-faux-client-content=\"\"\n                className=\"absolute left-0 top-0 origin-top-left\"\n                style={{ width, transform: `scale(${effective})` }}\n              >\n                {children}\n              </div>\n            </div>\n          ) : (\n            <div\n              data-react-fancy-faux-client-content=\"\"\n              className={cn((fill || fullscreen) && \"h-full\")}\n              // CSS `zoom` rather than a transform: it changes layout size, so the\n              // content reflows and the viewport scrolls to all of it.\n              style={zoomed ? { zoom: String(appliedZoom) } : undefined}\n            >\n              {children}\n            </div>\n          )}\n        </div>\n\n        {hasControls && !isBrowser && (\n          <div className=\"pointer-events-none absolute right-2 top-2 z-10\">{controlsBar}</div>\n        )}\n      </div>\n    );\n  },\n);\n\nFauxClient.displayName = \"FauxClient\";\n\n/** Ghost icon buttons: no box of their own, so the bar reads as part of the frame. */\nfunction controlButton(inBar: boolean): string {\n  return cn(\n    \"flex h-6 w-6 items-center justify-center rounded-full transition-colors disabled:pointer-events-none disabled:opacity-30\",\n    \"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500/50\",\n    inBar\n      ? \"hover:bg-zinc-900/5 hover:text-zinc-700 dark:hover:bg-white/10 dark:hover:text-zinc-200\"\n      : \"hover:bg-white/15 hover:text-white\",\n  );\n}\n\nfunction ZoomOutIcon() {\n  return (\n    <svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden=\"true\">\n      <circle cx=\"11\" cy=\"11\" r=\"7\" />\n      <path d=\"m20 20-3.5-3.5\" />\n      <path d=\"M8 11h6\" />\n    </svg>\n  );\n}\n\nfunction ZoomInIcon() {\n  return (\n    <svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden=\"true\">\n      <circle cx=\"11\" cy=\"11\" r=\"7\" />\n      <path d=\"m20 20-3.5-3.5\" />\n      <path d=\"M8 11h6\" />\n      <path d=\"M11 8v6\" />\n    </svg>\n  );\n}\n\n/** Inline, like `Input`'s reveal icons: a frame should not need an icon set configured. */\nfunction FullscreenIcon() {\n  return (\n    <svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden=\"true\">\n      <path d=\"M8 3H5a2 2 0 0 0-2 2v3\" />\n      <path d=\"M21 8V5a2 2 0 0 0-2-2h-3\" />\n      <path d=\"M3 16v3a2 2 0 0 0 2 2h3\" />\n      <path d=\"M16 21h3a2 2 0 0 0 2-2v-3\" />\n    </svg>\n  );\n}\n\nfunction ExitFullscreenIcon() {\n  return (\n    <svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden=\"true\">\n      <path d=\"M8 3v3a2 2 0 0 1-2 2H3\" />\n      <path d=\"M21 8h-3a2 2 0 0 1-2-2V3\" />\n      <path d=\"M3 16h3a2 2 0 0 1 2 2v3\" />\n      <path d=\"M16 21v-3a2 2 0 0 1 2-2h3\" />\n    </svg>\n  );\n}\n"]}