searchsocket 0.4.0 → 0.5.0

package/dist/plugin-B_npJSux.d.cts

@@ -0,0 +1,36 @@
+import { R as ResolvedSearchSocketConfig, c as SearchSocketConfig } from './types-Dk43uz25.cjs';
+
+interface SearchSocketHandleOptions {
+    configPath?: string;
+    cwd?: string;
+    path?: string;
+    maxBodyBytes?: number;
+    config?: ResolvedSearchSocketConfig;
+    rawConfig?: SearchSocketConfig;
+}
+declare function searchsocketHandle(options?: SearchSocketHandleOptions): ({ event, resolve }: {
+    event: any;
+    resolve: (event: any) => Promise<Response>;
+}) => Promise<Response>;
+
+interface MinimalVitePlugin {
+    name: string;
+    apply?: "build" | "serve";
+    config?: () => Record<string, unknown>;
+    closeBundle?: () => Promise<void> | void;
+}
+interface SearchSocketAutoIndexOptions {
+    cwd?: string;
+    configPath?: string;
+    enabled?: boolean;
+    triggerEnvVar?: string;
+    disableEnvVar?: string;
+    changedOnly?: boolean;
+    force?: boolean;
+    dryRun?: boolean;
+    scope?: string;
+    verbose?: boolean;
+}
+declare function searchsocketVitePlugin(options?: SearchSocketAutoIndexOptions): MinimalVitePlugin;
+
+export { type SearchSocketAutoIndexOptions as S, type SearchSocketHandleOptions as a, searchsocketVitePlugin as b, searchsocketHandle as s };

package/dist/plugin-M-aW0ev6.d.ts

@@ -0,0 +1,36 @@
+import { R as ResolvedSearchSocketConfig, c as SearchSocketConfig } from './types-Dk43uz25.js';
+
+interface SearchSocketHandleOptions {
+    configPath?: string;
+    cwd?: string;
+    path?: string;
+    maxBodyBytes?: number;
+    config?: ResolvedSearchSocketConfig;
+    rawConfig?: SearchSocketConfig;
+}
+declare function searchsocketHandle(options?: SearchSocketHandleOptions): ({ event, resolve }: {
+    event: any;
+    resolve: (event: any) => Promise<Response>;
+}) => Promise<Response>;
+
+interface MinimalVitePlugin {
+    name: string;
+    apply?: "build" | "serve";
+    config?: () => Record<string, unknown>;
+    closeBundle?: () => Promise<void> | void;
+}
+interface SearchSocketAutoIndexOptions {
+    cwd?: string;
+    configPath?: string;
+    enabled?: boolean;
+    triggerEnvVar?: string;
+    disableEnvVar?: string;
+    changedOnly?: boolean;
+    force?: boolean;
+    dryRun?: boolean;
+    scope?: string;
+    verbose?: boolean;
+}
+declare function searchsocketVitePlugin(options?: SearchSocketAutoIndexOptions): MinimalVitePlugin;
+
+export { type SearchSocketAutoIndexOptions as S, type SearchSocketHandleOptions as a, searchsocketVitePlugin as b, searchsocketHandle as s };

package/dist/scroll.cjs

@@ -0,0 +1,185 @@
+'use strict';
+
+// src/sveltekit/scroll-to-text.ts
+var HIGHLIGHT_CLASS = "ssk-highlight";
+var HIGHLIGHT_DURATION = 2e3;
+var HIGHLIGHT_MARKER_ATTR = "data-ssk-highlight-marker";
+var HIGHLIGHT_NAME = "ssk-search-match";
+var styleInjected = false;
+function ensureHighlightStyle() {
+  if (styleInjected || typeof document === "undefined") return;
+  styleInjected = true;
+  const style = document.createElement("style");
+  style.textContent = `
+    @keyframes ssk-highlight-fade {
+      0%   { background-color: rgba(16, 185, 129, 0.18); }
+      100% { background-color: transparent; }
+    }
+    .${HIGHLIGHT_CLASS} {
+      animation: ssk-highlight-fade ${HIGHLIGHT_DURATION}ms ease-out forwards;
+      border-radius: 4px;
+    }
+    ::highlight(${HIGHLIGHT_NAME}) {
+      background-color: rgba(16, 185, 129, 0.18);
+    }
+  `;
+  document.head.appendChild(style);
+}
+var IGNORED_TAGS = /* @__PURE__ */ new Set(["SCRIPT", "STYLE", "NOSCRIPT", "TEMPLATE"]);
+function buildTextMap(root) {
+  const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
+    acceptNode(node) {
+      const parent = node.parentElement;
+      if (!parent || IGNORED_TAGS.has(parent.tagName)) return NodeFilter.FILTER_REJECT;
+      return NodeFilter.FILTER_ACCEPT;
+    }
+  });
+  const chunks = [];
+  let text = "";
+  let current;
+  while (current = walker.nextNode()) {
+    const value = current.nodeValue ?? "";
+    if (!value) continue;
+    chunks.push({ node: current, start: text.length, end: text.length + value.length });
+    text += value;
+  }
+  return { text, chunks };
+}
+function normalize(text) {
+  return text.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function buildNeedleRegex(needle) {
+  const tokenParts = needle.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (tokenParts.length > 1) {
+    const pattern = tokenParts.map(escapeRegExp).join("[^\\p{L}\\p{N}]+");
+    return new RegExp(pattern, "iu");
+  }
+  if (tokenParts.length === 1) {
+    return new RegExp(escapeRegExp(tokenParts[0]), "iu");
+  }
+  if (!needle) return null;
+  return new RegExp(escapeRegExp(needle).replace(/\s+/g, "\\s+"), "i");
+}
+function buildLenientRegex(needle) {
+  const tokenParts = needle.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (tokenParts.length <= 1) return null;
+  const pattern = tokenParts.map(escapeRegExp).join("[^\\p{L}\\p{N}]*");
+  return new RegExp(pattern, "iu");
+}
+function findMatch(fullText, needle) {
+  const regex = buildNeedleRegex(needle);
+  if (regex) {
+    const m = regex.exec(fullText);
+    if (m && typeof m.index === "number") {
+      return { start: m.index, end: m.index + m[0].length };
+    }
+  }
+  const lenient = buildLenientRegex(needle);
+  if (lenient) {
+    const m = lenient.exec(fullText);
+    if (m && typeof m.index === "number") {
+      return { start: m.index, end: m.index + m[0].length };
+    }
+  }
+  return null;
+}
+function resolveRange(map, offsets) {
+  let startChunk;
+  let endChunk;
+  for (const chunk of map.chunks) {
+    if (!startChunk && offsets.start >= chunk.start && offsets.start < chunk.end) {
+      startChunk = chunk;
+    }
+    if (offsets.end > chunk.start && offsets.end <= chunk.end) {
+      endChunk = chunk;
+    }
+    if (startChunk && endChunk) break;
+  }
+  if (!startChunk || !endChunk) return null;
+  const range = document.createRange();
+  range.setStart(startChunk.node, offsets.start - startChunk.start);
+  range.setEnd(endChunk.node, offsets.end - endChunk.start);
+  return range;
+}
+function hasCustomHighlightAPI() {
+  return typeof CSS !== "undefined" && typeof CSS.highlights !== "undefined";
+}
+var highlightTimer = null;
+function highlightWithCSS(range) {
+  ensureHighlightStyle();
+  const hl = new globalThis.Highlight(range);
+  CSS.highlights.set(HIGHLIGHT_NAME, hl);
+  if (highlightTimer) clearTimeout(highlightTimer);
+  highlightTimer = setTimeout(() => {
+    CSS.highlights.delete(HIGHLIGHT_NAME);
+    highlightTimer = null;
+  }, HIGHLIGHT_DURATION);
+}
+function unwrapMarker(marker) {
+  if (!marker.isConnected) return;
+  const parent = marker.parentNode;
+  if (!parent) return;
+  while (marker.firstChild) parent.insertBefore(marker.firstChild, marker);
+  parent.removeChild(marker);
+  if (parent instanceof Element) parent.normalize();
+}
+function highlightWithDOM(range) {
+  ensureHighlightStyle();
+  try {
+    const marker = document.createElement("span");
+    marker.classList.add(HIGHLIGHT_CLASS);
+    marker.setAttribute(HIGHLIGHT_MARKER_ATTR, "true");
+    range.surroundContents(marker);
+    setTimeout(() => unwrapMarker(marker), HIGHLIGHT_DURATION);
+    return marker;
+  } catch {
+    const ancestor = range.commonAncestorContainer;
+    const el = ancestor instanceof Element ? ancestor : ancestor.parentElement;
+    if (el) {
+      el.classList.add(HIGHLIGHT_CLASS);
+      setTimeout(() => el.classList.remove(HIGHLIGHT_CLASS), HIGHLIGHT_DURATION);
+      return el;
+    }
+    return document.body;
+  }
+}
+function scrollToRange(range) {
+  const rect = range.getBoundingClientRect();
+  window.scrollTo({
+    top: window.scrollY + rect.top - window.innerHeight / 3,
+    behavior: "smooth"
+  });
+}
+function scrollIntoViewIfPossible(el) {
+  if (typeof el.scrollIntoView === "function") {
+    el.scrollIntoView({ behavior: "smooth", block: "start" });
+  }
+}
+function searchsocketScrollToText(navigation) {
+  if (typeof document === "undefined") return;
+  const params = navigation.to?.url.searchParams;
+  const raw = params?.get("_sskt") ?? params?.get("_ssk");
+  if (!raw) return;
+  const needle = normalize(raw);
+  if (!needle) return;
+  const map = buildTextMap(document.body);
+  const offsets = findMatch(map.text, needle);
+  if (!offsets) return;
+  const range = resolveRange(map, offsets);
+  if (!range) return;
+  if (hasCustomHighlightAPI()) {
+    highlightWithCSS(range);
+    scrollToRange(range);
+  } else {
+    const marker = highlightWithDOM(range);
+    const target = typeof marker.scrollIntoView === "function" ? marker : marker.parentElement;
+    if (target) scrollIntoViewIfPossible(target);
+  }
+}
+
+exports.searchsocketScrollToText = searchsocketScrollToText;
+//# sourceMappingURL=scroll.cjs.map
+//# sourceMappingURL=scroll.cjs.map

package/dist/scroll.d.cts

@@ -0,0 +1,42 @@
+/**
+ * SvelteKit scroll-to-text helper for search result navigation.
+ *
+ * When a visitor arrives on a page via a search result link that contains
+ * a `_sskt` (text target) or `_ssk` (section title) query parameter, this
+ * hook finds matching text in the document, scrolls it into view, and briefly
+ * highlights it.
+ *
+ * Uses a TreeWalker-based text map to match across split DOM nodes (e.g.
+ * `<em>Install</em>ation`), and the CSS Custom Highlight API when available
+ * for non-destructive highlighting that avoids DOM mutation.
+ *
+ * Usage in a SvelteKit layout:
+ * ```svelte
+ * <script>
+ *   import { afterNavigate } from '$app/navigation';
+ *   import { searchsocketScrollToText } from 'searchsocket/sveltekit';
+ *   afterNavigate(searchsocketScrollToText);
+ * </script>
+ * ```
+ */
+/** Minimal representation of SvelteKit's `AfterNavigate` parameter. */
+interface AfterNavigateParam {
+    to: {
+        url: URL;
+    } | null;
+}
+/**
+ * A function compatible with SvelteKit's `afterNavigate` callback.
+ *
+ * Reads `_sskt` (preferred) or `_ssk` from the destination URL, walks text
+ * nodes in document order via a TreeWalker text map, and scrolls/highlights
+ * the first match. Matches can span multiple DOM text nodes.
+ *
+ * Uses the CSS Custom Highlight API when available for non-destructive
+ * highlighting, with a DOM mutation fallback for older browsers.
+ *
+ * Silent no-op when no target parameter is present or no match is found.
+ */
+declare function searchsocketScrollToText(navigation: AfterNavigateParam): void;
+
+export { type AfterNavigateParam, searchsocketScrollToText };

package/dist/scroll.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SvelteKit scroll-to-text helper for search result navigation.
+ *
+ * When a visitor arrives on a page via a search result link that contains
+ * a `_sskt` (text target) or `_ssk` (section title) query parameter, this
+ * hook finds matching text in the document, scrolls it into view, and briefly
+ * highlights it.
+ *
+ * Uses a TreeWalker-based text map to match across split DOM nodes (e.g.
+ * `<em>Install</em>ation`), and the CSS Custom Highlight API when available
+ * for non-destructive highlighting that avoids DOM mutation.
+ *
+ * Usage in a SvelteKit layout:
+ * ```svelte
+ * <script>
+ *   import { afterNavigate } from '$app/navigation';
+ *   import { searchsocketScrollToText } from 'searchsocket/sveltekit';
+ *   afterNavigate(searchsocketScrollToText);
+ * </script>
+ * ```
+ */
+/** Minimal representation of SvelteKit's `AfterNavigate` parameter. */
+interface AfterNavigateParam {
+    to: {
+        url: URL;
+    } | null;
+}
+/**
+ * A function compatible with SvelteKit's `afterNavigate` callback.
+ *
+ * Reads `_sskt` (preferred) or `_ssk` from the destination URL, walks text
+ * nodes in document order via a TreeWalker text map, and scrolls/highlights
+ * the first match. Matches can span multiple DOM text nodes.
+ *
+ * Uses the CSS Custom Highlight API when available for non-destructive
+ * highlighting, with a DOM mutation fallback for older browsers.
+ *
+ * Silent no-op when no target parameter is present or no match is found.
+ */
+declare function searchsocketScrollToText(navigation: AfterNavigateParam): void;
+
+export { type AfterNavigateParam, searchsocketScrollToText };

package/dist/scroll.js

@@ -0,0 +1,183 @@
+// src/sveltekit/scroll-to-text.ts
+var HIGHLIGHT_CLASS = "ssk-highlight";
+var HIGHLIGHT_DURATION = 2e3;
+var HIGHLIGHT_MARKER_ATTR = "data-ssk-highlight-marker";
+var HIGHLIGHT_NAME = "ssk-search-match";
+var styleInjected = false;
+function ensureHighlightStyle() {
+  if (styleInjected || typeof document === "undefined") return;
+  styleInjected = true;
+  const style = document.createElement("style");
+  style.textContent = `
+    @keyframes ssk-highlight-fade {
+      0%   { background-color: rgba(16, 185, 129, 0.18); }
+      100% { background-color: transparent; }
+    }
+    .${HIGHLIGHT_CLASS} {
+      animation: ssk-highlight-fade ${HIGHLIGHT_DURATION}ms ease-out forwards;
+      border-radius: 4px;
+    }
+    ::highlight(${HIGHLIGHT_NAME}) {
+      background-color: rgba(16, 185, 129, 0.18);
+    }
+  `;
+  document.head.appendChild(style);
+}
+var IGNORED_TAGS = /* @__PURE__ */ new Set(["SCRIPT", "STYLE", "NOSCRIPT", "TEMPLATE"]);
+function buildTextMap(root) {
+  const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
+    acceptNode(node) {
+      const parent = node.parentElement;
+      if (!parent || IGNORED_TAGS.has(parent.tagName)) return NodeFilter.FILTER_REJECT;
+      return NodeFilter.FILTER_ACCEPT;
+    }
+  });
+  const chunks = [];
+  let text = "";
+  let current;
+  while (current = walker.nextNode()) {
+    const value = current.nodeValue ?? "";
+    if (!value) continue;
+    chunks.push({ node: current, start: text.length, end: text.length + value.length });
+    text += value;
+  }
+  return { text, chunks };
+}
+function normalize(text) {
+  return text.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function buildNeedleRegex(needle) {
+  const tokenParts = needle.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (tokenParts.length > 1) {
+    const pattern = tokenParts.map(escapeRegExp).join("[^\\p{L}\\p{N}]+");
+    return new RegExp(pattern, "iu");
+  }
+  if (tokenParts.length === 1) {
+    return new RegExp(escapeRegExp(tokenParts[0]), "iu");
+  }
+  if (!needle) return null;
+  return new RegExp(escapeRegExp(needle).replace(/\s+/g, "\\s+"), "i");
+}
+function buildLenientRegex(needle) {
+  const tokenParts = needle.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (tokenParts.length <= 1) return null;
+  const pattern = tokenParts.map(escapeRegExp).join("[^\\p{L}\\p{N}]*");
+  return new RegExp(pattern, "iu");
+}
+function findMatch(fullText, needle) {
+  const regex = buildNeedleRegex(needle);
+  if (regex) {
+    const m = regex.exec(fullText);
+    if (m && typeof m.index === "number") {
+      return { start: m.index, end: m.index + m[0].length };
+    }
+  }
+  const lenient = buildLenientRegex(needle);
+  if (lenient) {
+    const m = lenient.exec(fullText);
+    if (m && typeof m.index === "number") {
+      return { start: m.index, end: m.index + m[0].length };
+    }
+  }
+  return null;
+}
+function resolveRange(map, offsets) {
+  let startChunk;
+  let endChunk;
+  for (const chunk of map.chunks) {
+    if (!startChunk && offsets.start >= chunk.start && offsets.start < chunk.end) {
+      startChunk = chunk;
+    }
+    if (offsets.end > chunk.start && offsets.end <= chunk.end) {
+      endChunk = chunk;
+    }
+    if (startChunk && endChunk) break;
+  }
+  if (!startChunk || !endChunk) return null;
+  const range = document.createRange();
+  range.setStart(startChunk.node, offsets.start - startChunk.start);
+  range.setEnd(endChunk.node, offsets.end - endChunk.start);
+  return range;
+}
+function hasCustomHighlightAPI() {
+  return typeof CSS !== "undefined" && typeof CSS.highlights !== "undefined";
+}
+var highlightTimer = null;
+function highlightWithCSS(range) {
+  ensureHighlightStyle();
+  const hl = new globalThis.Highlight(range);
+  CSS.highlights.set(HIGHLIGHT_NAME, hl);
+  if (highlightTimer) clearTimeout(highlightTimer);
+  highlightTimer = setTimeout(() => {
+    CSS.highlights.delete(HIGHLIGHT_NAME);
+    highlightTimer = null;
+  }, HIGHLIGHT_DURATION);
+}
+function unwrapMarker(marker) {
+  if (!marker.isConnected) return;
+  const parent = marker.parentNode;
+  if (!parent) return;
+  while (marker.firstChild) parent.insertBefore(marker.firstChild, marker);
+  parent.removeChild(marker);
+  if (parent instanceof Element) parent.normalize();
+}
+function highlightWithDOM(range) {
+  ensureHighlightStyle();
+  try {
+    const marker = document.createElement("span");
+    marker.classList.add(HIGHLIGHT_CLASS);
+    marker.setAttribute(HIGHLIGHT_MARKER_ATTR, "true");
+    range.surroundContents(marker);
+    setTimeout(() => unwrapMarker(marker), HIGHLIGHT_DURATION);
+    return marker;
+  } catch {
+    const ancestor = range.commonAncestorContainer;
+    const el = ancestor instanceof Element ? ancestor : ancestor.parentElement;
+    if (el) {
+      el.classList.add(HIGHLIGHT_CLASS);
+      setTimeout(() => el.classList.remove(HIGHLIGHT_CLASS), HIGHLIGHT_DURATION);
+      return el;
+    }
+    return document.body;
+  }
+}
+function scrollToRange(range) {
+  const rect = range.getBoundingClientRect();
+  window.scrollTo({
+    top: window.scrollY + rect.top - window.innerHeight / 3,
+    behavior: "smooth"
+  });
+}
+function scrollIntoViewIfPossible(el) {
+  if (typeof el.scrollIntoView === "function") {
+    el.scrollIntoView({ behavior: "smooth", block: "start" });
+  }
+}
+function searchsocketScrollToText(navigation) {
+  if (typeof document === "undefined") return;
+  const params = navigation.to?.url.searchParams;
+  const raw = params?.get("_sskt") ?? params?.get("_ssk");
+  if (!raw) return;
+  const needle = normalize(raw);
+  if (!needle) return;
+  const map = buildTextMap(document.body);
+  const offsets = findMatch(map.text, needle);
+  if (!offsets) return;
+  const range = resolveRange(map, offsets);
+  if (!range) return;
+  if (hasCustomHighlightAPI()) {
+    highlightWithCSS(range);
+    scrollToRange(range);
+  } else {
+    const marker = highlightWithDOM(range);
+    const target = typeof marker.scrollIntoView === "function" ? marker : marker.parentElement;
+    if (target) scrollIntoViewIfPossible(target);
+  }
+}
+
+export { searchsocketScrollToText };
+//# sourceMappingURL=scroll.js.map
+//# sourceMappingURL=scroll.js.map