@gunkin/uiify 0.0.15-alpha → 0.0.16-alpha

package/dist/components/table-of-contents/scrollspy.js

@@ -0,0 +1,178 @@
+import { getTableOfContentsValue, resolveTableOfContentsId } from "./scrollspy-selection.js";
+import { getTableOfContentsValue as getTableOfContentsValue2, resolveTableOfContentsId as resolveTableOfContentsId2 } from "./scrollspy-selection.js";
+function observeTableOfContents({
+  root,
+  scrollTarget,
+  contentTarget,
+  offset,
+  onValueChange
+}) {
+  const doc = root.ownerDocument;
+  const view = doc.defaultView;
+  let scrollNode = null;
+  let content = null;
+  let host = null;
+  let observer = null;
+  let nodes = [];
+  let positions = /* @__PURE__ */ new Map();
+  let contentEnd = null;
+  let viewportSize = 0;
+  let frame = 0;
+  let generation = 0;
+  let destroyed = false;
+  let last;
+  const resized = /* @__PURE__ */ new Set();
+  const emit = (value) => {
+    if (last !== value) {
+      last = value;
+      onValueChange(value);
+    }
+  };
+  const position = () => {
+    return scrollNode ? scrollNode.scrollTop : view.scrollY;
+  };
+  const update = () => {
+    if (positions.size !== nodes.length || !viewportSize) return;
+    const start = position();
+    emit(
+      getTableOfContentsValue({
+        targets: nodes.flatMap((node) => {
+          const target = positions.get(node);
+          return target ? [target] : [];
+        }),
+        viewportStart: start,
+        viewportEnd: start + viewportSize,
+        offset,
+        contentEnd
+      })
+    );
+  };
+  const scroll = () => {
+    if (!frame)
+      frame = view.requestAnimationFrame(() => {
+        frame = 0;
+        update();
+      });
+  };
+  const schedule = () => {
+    if (frame) view.cancelAnimationFrame(frame);
+    frame = view.requestAnimationFrame(() => {
+      frame = 0;
+      refresh();
+    });
+  };
+  const resize = new view.ResizeObserver(schedule);
+  const mutations = new view.MutationObserver((changes) => {
+    if (changes.some((change) => !root.contains(change.target))) schedule();
+  });
+  const links = new view.MutationObserver(schedule);
+  links.observe(root, {
+    subtree: true,
+    childList: true,
+    attributes: true,
+    attributeFilter: ["href"]
+  });
+  function refresh() {
+    if (destroyed) return;
+    generation++;
+    observer?.disconnect();
+    mutations.disconnect();
+    scrollNode = scrollTarget === void 0 ? null : doc.getElementById(scrollTarget);
+    content = contentTarget === void 0 ? doc.documentElement : doc.getElementById(contentTarget);
+    const nextHost = scrollTarget !== void 0 && !scrollNode ? null : scrollNode ?? view;
+    if (host !== nextHost) {
+      host?.removeEventListener("scroll", scroll);
+      host = nextHost;
+      host?.addEventListener("scroll", scroll, { passive: true });
+    }
+    if (!host || !content) {
+      emit(null);
+      mutations.observe(doc.documentElement, { subtree: true, childList: true });
+      return;
+    }
+    const values = /* @__PURE__ */ new Map();
+    for (const link of root.querySelectorAll('[data-part="link"][href]')) {
+      if (link.closest("[data-uiify-table-of-contents]") !== root) continue;
+      const value = resolveTableOfContentsId(link.getAttribute("href"), doc.URL);
+      const node = value === null ? null : doc.getElementById(value);
+      if (node && content.contains(node)) values.set(node, value);
+    }
+    nodes = [...values.keys()].sort((a, b) => a.compareDocumentPosition(b) & 2 ? 1 : -1);
+    positions = /* @__PURE__ */ new Map();
+    contentEnd = null;
+    viewportSize = 0;
+    if (!nodes.length) emit(null);
+    const current = generation;
+    observer = new view.IntersectionObserver(
+      (entries) => {
+        if (destroyed || generation !== current) return;
+        const start = position();
+        for (const entry of entries) {
+          const rect = entry.boundingClientRect;
+          const origin = entry.rootBounds?.top ?? 0;
+          viewportSize = entry.rootBounds?.height ?? viewportSize;
+          if (entry.target === content) contentEnd = rect.bottom + start - origin;
+          const value = values.get(entry.target);
+          if (value !== void 0)
+            positions.set(entry.target, {
+              value,
+              start: rect.top + start - origin,
+              visible: rect.width > 0 && rect.height > 0
+            });
+        }
+        update();
+      },
+      { root: scrollNode, threshold: [0, 1] }
+    );
+    const observed = /* @__PURE__ */ new Set([content, ...nodes, ...scrollNode ? [scrollNode] : []]);
+    for (const node of resized)
+      if (!observed.has(node)) {
+        resize.unobserve(node);
+        resized.delete(node);
+      }
+    for (const node of observed) {
+      if (node !== scrollNode) observer.observe(node);
+      if (!resized.has(node)) {
+        resize.observe(node);
+        resized.add(node);
+      }
+    }
+    const boundaries = contentTarget !== void 0 ? [content] : new Set(
+      nodes.map((node) => {
+        const parent = node.closest("article, main") ?? node.parentElement;
+        return parent && parent !== doc.body && parent !== doc.documentElement ? parent : node;
+      })
+    );
+    for (const boundary of boundaries)
+      mutations.observe(boundary, {
+        subtree: true,
+        childList: true,
+        attributes: true,
+        attributeFilter: ["id", "hidden", "open", "class", "style"]
+      });
+  }
+  view.addEventListener("resize", schedule);
+  view.addEventListener("hashchange", scroll);
+  refresh();
+  return {
+    refresh,
+    destroy() {
+      destroyed = true;
+      generation++;
+      observer?.disconnect();
+      resize.disconnect();
+      mutations.disconnect();
+      links.disconnect();
+      host?.removeEventListener("scroll", scroll);
+      view.removeEventListener("resize", schedule);
+      view.removeEventListener("hashchange", scroll);
+      if (frame) view.cancelAnimationFrame(frame);
+    }
+  };
+}
+export {
+  getTableOfContentsValue2 as getTableOfContentsValue,
+  observeTableOfContents,
+  resolveTableOfContentsId2 as resolveTableOfContentsId
+};
+//# sourceMappingURL=scrollspy.js.map

package/dist/components/table-of-contents/scrollspy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/table-of-contents/scrollspy.ts"],"sourcesContent":["import { getTableOfContentsValue, resolveTableOfContentsId } from \"./scrollspy-selection.js\";\nimport type {\n  TableOfContentsObserver,\n  TableOfContentsObserverOptions,\n  TableOfContentsTargetSnapshot,\n} from \"./types.js\";\nexport { getTableOfContentsValue, resolveTableOfContentsId } from \"./scrollspy-selection.js\";\n\nexport function observeTableOfContents({\n  root,\n  scrollTarget,\n  contentTarget,\n  offset,\n  onValueChange,\n}: TableOfContentsObserverOptions): TableOfContentsObserver {\n  const doc = root.ownerDocument;\n  const view = doc.defaultView!;\n  let scrollNode: HTMLElement | null = null;\n  let content: HTMLElement | null = null;\n  let host: EventTarget | null = null;\n  let observer: IntersectionObserver | null = null;\n  let nodes: HTMLElement[] = [];\n  let positions = new Map<Element, TableOfContentsTargetSnapshot>();\n  let contentEnd: number | null = null;\n  let viewportSize = 0;\n  let frame = 0;\n  let generation = 0;\n  let destroyed = false;\n  let last: string | null | undefined;\n  const resized = new Set<Element>();\n  const emit = (value: string | null) => {\n    if (last !== value) {\n      last = value;\n      onValueChange(value);\n    }\n  };\n  const position = () => {\n    // banned-read-ok: A scroll offset is the required input, not a layout measurement; geometry comes from observers.\n    return scrollNode ? scrollNode.scrollTop : view.scrollY;\n  };\n  const update = () => {\n    if (positions.size !== nodes.length || !viewportSize) return;\n    const start = position();\n    emit(\n      getTableOfContentsValue({\n        targets: nodes.flatMap((node) => {\n          const target = positions.get(node);\n          return target ? [target] : [];\n        }),\n        viewportStart: start,\n        viewportEnd: start + viewportSize,\n        offset,\n        contentEnd,\n      }),\n    );\n  };\n  const scroll = () => {\n    if (!frame)\n      frame = view.requestAnimationFrame(() => {\n        frame = 0;\n        update();\n      });\n  };\n  const schedule = () => {\n    if (frame) view.cancelAnimationFrame(frame);\n    frame = view.requestAnimationFrame(() => {\n      frame = 0;\n      refresh();\n    });\n  };\n  const resize = new view.ResizeObserver(schedule);\n  const mutations = new view.MutationObserver((changes) => {\n    if (changes.some((change) => !root.contains(change.target))) schedule();\n  });\n  const links = new view.MutationObserver(schedule);\n  links.observe(root, {\n    subtree: true,\n    childList: true,\n    attributes: true,\n    attributeFilter: [\"href\"],\n  });\n  function refresh() {\n    if (destroyed) return;\n    generation++;\n    observer?.disconnect();\n    mutations.disconnect();\n    scrollNode = scrollTarget === undefined ? null : doc.getElementById(scrollTarget);\n    content = contentTarget === undefined ? doc.documentElement : doc.getElementById(contentTarget);\n    const nextHost = scrollTarget !== undefined && !scrollNode ? null : (scrollNode ?? view);\n    if (host !== nextHost) {\n      host?.removeEventListener(\"scroll\", scroll);\n      host = nextHost;\n      host?.addEventListener(\"scroll\", scroll, { passive: true });\n    }\n    if (!host || !content) {\n      emit(null);\n      mutations.observe(doc.documentElement, { subtree: true, childList: true });\n      return;\n    }\n    const values = new Map<HTMLElement, string>();\n    for (const link of root.querySelectorAll('[data-part=\"link\"][href]')) {\n      if (link.closest(\"[data-uiify-table-of-contents]\") !== root) continue;\n      const value = resolveTableOfContentsId(link.getAttribute(\"href\")!, doc.URL);\n      const node = value === null ? null : doc.getElementById(value);\n      if (node && content.contains(node)) values.set(node, value!);\n    }\n    nodes = [...values.keys()].sort((a, b) => (a.compareDocumentPosition(b) & 2 ? 1 : -1));\n    positions = new Map();\n    contentEnd = null;\n    viewportSize = 0;\n    if (!nodes.length) emit(null);\n    const current = generation;\n    observer = new view.IntersectionObserver(\n      (entries) => {\n        if (destroyed || generation !== current) return;\n        const start = position();\n        for (const entry of entries) {\n          const rect = entry.boundingClientRect;\n          const origin = entry.rootBounds?.top ?? 0;\n          viewportSize = entry.rootBounds?.height ?? viewportSize;\n          if (entry.target === content) contentEnd = rect.bottom + start - origin;\n          const value = values.get(entry.target as HTMLElement);\n          if (value !== undefined)\n            positions.set(entry.target, {\n              value,\n              start: rect.top + start - origin,\n              visible: rect.width > 0 && rect.height > 0,\n            });\n        }\n        update();\n      },\n      { root: scrollNode, threshold: [0, 1] },\n    );\n    const observed = new Set<Element>([content, ...nodes, ...(scrollNode ? [scrollNode] : [])]);\n    for (const node of resized)\n      if (!observed.has(node)) {\n        resize.unobserve(node);\n        resized.delete(node);\n      }\n    for (const node of observed) {\n      if (node !== scrollNode) observer.observe(node);\n      if (!resized.has(node)) {\n        resize.observe(node);\n        resized.add(node);\n      }\n    }\n    const boundaries =\n      contentTarget !== undefined\n        ? [content]\n        : new Set(\n            nodes.map((node) => {\n              const parent = node.closest(\"article, main\") ?? node.parentElement;\n              return parent && parent !== doc.body && parent !== doc.documentElement\n                ? parent\n                : node;\n            }),\n          );\n    for (const boundary of boundaries)\n      mutations.observe(boundary, {\n        subtree: true,\n        childList: true,\n        attributes: true,\n        attributeFilter: [\"id\", \"hidden\", \"open\", \"class\", \"style\"],\n      });\n  }\n  view.addEventListener(\"resize\", schedule);\n  view.addEventListener(\"hashchange\", scroll);\n  refresh();\n  return {\n    refresh,\n    destroy() {\n      destroyed = true;\n      generation++;\n      observer?.disconnect();\n      resize.disconnect();\n      mutations.disconnect();\n      links.disconnect();\n      host?.removeEventListener(\"scroll\", scroll);\n      view.removeEventListener(\"resize\", schedule);\n      view.removeEventListener(\"hashchange\", scroll);\n      if (frame) view.cancelAnimationFrame(frame);\n    },\n  };\n}\n"],"mappings":"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","names":["getTableOfContentsValue","resolveTableOfContentsId"]}

package/dist/components/table-of-contents/types.d.ts

@@ -0,0 +1,123 @@
+import type { AriaAttributes, CSSProperties, Ref, MouseEventHandler, ElementType, ReactNode } from "react";
+import type { NativeButtonProps, RenderableProps } from "../../core/render.js";
+import type { AnchorAlign, AnchorSide } from "../../core/anchor-position/types.js";
+export type TableOfContentsLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export interface TableOfContentsRootOwnProps {
+    readonly children?: ReactNode;
+}
+export type TableOfContentsRootProps<TAs extends ElementType = "nav"> = RenderableProps<TAs, TableOfContentsRootOwnProps, Record<string, never>, HTMLElement>;
+export interface TableOfContentsTriggerOwnProps {
+    readonly children?: ReactNode;
+    readonly target: string;
+}
+export type TableOfContentsTriggerProps<TAs extends ElementType = "button"> = NativeButtonProps<TAs, TableOfContentsTriggerOwnProps>;
+export interface TableOfContentsRailOwnProps {
+    readonly children?: ReactNode;
+}
+export type TableOfContentsRailProps<TAs extends ElementType = "span"> = RenderableProps<TAs, TableOfContentsRailOwnProps, Record<string, never>, HTMLElement>;
+export interface TableOfContentsIndicatorOwnProps {
+    readonly ref?: Ref<HTMLElement>;
+    readonly style?: CSSProperties;
+    readonly children?: ReactNode;
+    /** Stable target ID matching a Link fragment. */
+    readonly value: string;
+    readonly level?: TableOfContentsLevel;
+    readonly selected?: boolean;
+}
+export type TableOfContentsIndicatorProps<TAs extends ElementType = "span"> = RenderableProps<TAs, TableOfContentsIndicatorOwnProps, {
+    selected: boolean;
+}, HTMLElement>;
+export interface TableOfContentsContentOwnProps {
+    readonly children?: ReactNode;
+    readonly id: string;
+    readonly side?: AnchorSide;
+    readonly align?: AnchorAlign;
+}
+export type TableOfContentsContentProps<TAs extends ElementType = "div"> = RenderableProps<TAs, TableOfContentsContentOwnProps, Record<string, never>, HTMLElement>;
+export interface TableOfContentsListOwnProps {
+    readonly children?: ReactNode;
+}
+export type TableOfContentsListProps<TAs extends ElementType = "div"> = RenderableProps<TAs, TableOfContentsListOwnProps, Record<string, never>, HTMLElement>;
+export interface TableOfContentsLinkOwnProps {
+    readonly style?: CSSProperties;
+    readonly "aria-current"?: AriaAttributes["aria-current"];
+    readonly children?: ReactNode;
+    /** Native same-page anchor; external URLs are not tracked by scrollspy. */
+    readonly href: string;
+    readonly level?: TableOfContentsLevel;
+    readonly selected?: boolean;
+}
+export type TableOfContentsLinkProps<TAs extends ElementType = "a"> = RenderableProps<TAs, TableOfContentsLinkOwnProps, {
+    selected: boolean;
+}, HTMLAnchorElement>;
+export interface TableOfContentsTargetSnapshot {
+    readonly value: string;
+    readonly start: number;
+    readonly visible: boolean;
+}
+export interface TableOfContentsScrollSnapshot {
+    readonly targets: readonly TableOfContentsTargetSnapshot[];
+    readonly viewportStart: number;
+    readonly viewportEnd: number;
+    readonly offset: number;
+    readonly contentEnd: number | null;
+}
+export interface TableOfContentsObserverOptions {
+    readonly root: HTMLElement;
+    readonly scrollTarget?: string | undefined;
+    readonly contentTarget?: string | undefined;
+    readonly offset: number;
+    readonly onValueChange: (value: string | null) => void;
+}
+export interface TableOfContentsObserver {
+    readonly refresh: () => void;
+    readonly destroy: () => void;
+}
+export interface TableOfContentsClientRootOwnProps extends TableOfContentsRootOwnProps {
+    readonly ref?: Ref<HTMLElement>;
+    readonly className?: string;
+    readonly style?: CSSProperties;
+    readonly onClick?: MouseEventHandler<HTMLElement>;
+    readonly scrollSpy?: boolean;
+    /** Scroll-container element ID; omitted tracks the owning window. */
+    readonly scrollTarget?: string;
+    /** Content element ID used for target scope and end-of-content selection. */
+    readonly contentTarget?: string;
+    readonly offset?: number;
+    readonly value?: string | null;
+    readonly defaultValue?: string | null;
+    readonly onValueChange?: (value: string | null) => void;
+    readonly open?: boolean;
+    /** Applied after hydration; the native SSR surface starts closed. */
+    readonly defaultOpen?: boolean;
+    readonly onOpenChange?: (open: boolean) => void;
+    readonly openOnHover?: boolean;
+    readonly openDelay?: number;
+    readonly closeDelay?: number;
+}
+export type TableOfContentsClientRootProps<TAs extends ElementType = "nav"> = RenderableProps<TAs, TableOfContentsClientRootOwnProps, {
+    value: string | null;
+    open: boolean;
+}, HTMLElement>;
+export interface TableOfContentsClientContextValue {
+    readonly value: string | null;
+    readonly open: boolean;
+    readonly documentUrl: string | undefined;
+}
+export interface TableOfContentsInteractionOptions {
+    readonly root: HTMLElement;
+    readonly getOpen: () => boolean;
+    readonly requestOpen: (open: boolean) => void;
+    readonly controlled: boolean;
+    readonly openOnHover: boolean;
+    readonly openDelay: number;
+    readonly closeDelay: number;
+}
+export interface TableOfContentsInteractions {
+    readonly click: (event: MouseEvent) => void;
+    readonly destroy: () => void;
+}
+export interface TableOfContentsPointerOptions {
+    readonly root: HTMLElement;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/table-of-contents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/table-of-contents/types.ts"],"names":[],"mappings":"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"}

package/dist/components/table-of-contents/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/components/table-of-contents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/components/table-of-contents.d.ts

@@ -0,0 +1 @@
+export * from "./table-of-contents/index.js";

package/dist/components/table-of-contents.js

@@ -0,0 +1 @@
+export * from "./table-of-contents/index.js";