refactor(src): apply primordials migration via prim mod

Codemod-applied conversion of `Foo.bar(args)` / `obj.method(args)` /
`new Foo(args)` to primordial-shaped calls (`FooBar(args)`,
`FooPrototypeMethod(obj, args)`, `new FooCtor(args)`). 31 rewrites
across 12 files in src/.

Imports primordials from `@socketsecurity/lib/primordials` (consumes
the lib's installed surface, no local primordials.ts here).

Mechanically applied via:
  node ../socket-lib/tools/prim/bin/prim.mts mod --target . --dir src --apply

Audit: 0 surface gaps; remaining 36 covered candidates require
`--include-guessed` (deferred — receiver-name heuristics need
case-by-case typecheck verification on this repo's `PurlInput`
union types).

Author: jdalton

src/compare.ts

@@ -6,7 +6,9 @@
 import {
   ErrorCtor,
   MapCtor,
+  RegExpCtor,
   RegExpPrototypeTest,
+  StringPrototypeCharCodeAt,
   StringPrototypeIncludes,
   StringPrototypeIndexOf,
   StringPrototypeReplace,
@@ -62,7 +64,7 @@ const MAX_WILDCARDS_PER_PATTERN = 32
 function countWildcards(pattern: string): number {
   let count = 0
   for (let i = 0, { length } = pattern; i < length; i += 1) {
-    const code = pattern.charCodeAt(i)
+    const code = StringPrototypeCharCodeAt(pattern, i)
     if (code === 42 /*'*'*/ || code === 63 /*'?'*/) {
       count += 1
     }
@@ -94,7 +96,7 @@ function matchWildcard(pattern: string, value: string): boolean {
     )
 
     // Collapse consecutive .* groups to prevent polynomial backtracking (ReDoS)
-    regex = new RegExp(
+    regex = new RegExpCtor(
       `^${StringPrototypeReplace(regexPattern, /(\.\*)+/g, '.*' as any)}$`,
     )
     if (wildcardRegexCache.size >= WILDCARD_CACHE_MAX) {

src/objects.ts

@@ -6,6 +6,7 @@
 import { LOOP_SENTINEL } from './constants.js'
 import {
   ArrayIsArray,
+  ErrorCtor,
   ObjectFreeze,
   ObjectIsFrozen,
   ReflectOwnKeys,
@@ -34,7 +35,7 @@ function recursiveFreeze<T>(value_: T): T {
   while (pos < queueLength) {
     // Safety check to prevent processing excessively large object graphs
     if (pos === LOOP_SENTINEL) {
-      throw new Error('Object graph too large (exceeds 1,000,000 items).')
+      throw new ErrorCtor('Object graph too large (exceeds 1,000,000 items).')
     }
     const obj = queue[pos++]!
     ObjectFreeze(obj)

src/package-url.ts

@@ -48,6 +48,7 @@ import { isObject, recursiveFreeze } from './objects.js'
 import {
   ArrayIsArray,
   ArrayPrototypeAt,
+  BufferByteLength,
   ErrorCtor,
   JSONParse,
   JSONStringify,
@@ -66,6 +67,7 @@ import {
   StringPrototypeSlice,
   StringPrototypeSplit,
   StringPrototypeStartsWith,
+  SyntaxErrorCtor,
   URLCtor,
   URLSearchParamsCtor,
 } from '@socketsecurity/lib/primordials'
@@ -450,7 +452,7 @@ class PackageURL {
     // Size limit: 1MB to prevent memory exhaustion
     // Check actual byte size, not character length
     const MAX_JSON_SIZE = 1024 * 1024
-    const byteSize = Buffer.byteLength(json, 'utf8')
+    const byteSize = BufferByteLength!(json, 'utf8')
     if (byteSize > MAX_JSON_SIZE) {
       throw new ErrorCtor(
         `JSON string exceeds maximum size limit of ${MAX_JSON_SIZE} bytes`,
@@ -462,7 +464,7 @@ class PackageURL {
       parsed = JSONParse(json)
     } catch (e) {
       // For JSON parsing errors, throw a SyntaxError with the expected message
-      throw new SyntaxError('Failed to parse PackageURL from JSON', {
+      throw new SyntaxErrorCtor('Failed to parse PackageURL from JSON', {
         cause: e,
       })
     }

src/pages/hotlinks.js

@@ -16,6 +16,13 @@
  * the already-highlighted span tree, not the raw text — hljs
  * splits text nodes, so any <a> we wrap before it runs would be
  * blown away. Uses `ns.onHljsReady` from boot.js to gate. */
+
+import {
+  JSONParse,
+  MapCtor,
+  StringPrototypeMatchAll,
+  StringPrototypeStartsWith,
+} from '@socketsecurity/lib/primordials'
 ;(() => {
   const ns = window[Symbol.for('socket-pages')]
   if (!ns) {
@@ -24,10 +31,10 @@
 
   const installSourceLinks = () => {
     const rawAnchors = document.body.getAttribute('data-file-anchors')
-    const anchorByPath = new Map()
+    const anchorByPath = new MapCtor()
     if (rawAnchors) {
       try {
-        const entries = JSON.parse(rawAnchors)
+        const entries = JSONParse(rawAnchors)
         for (const [p, a] of entries) {
           anchorByPath.set(p, a)
         }
@@ -40,7 +47,7 @@
     /* Build a basename-swap fallback so `./compare.js` in source
      * resolves to `compare.ts` on disk. Keyed by `<dir>/<basename>`
      * without extension; value is the primary anchor. */
-    const anchorByStem = new Map()
+    const anchorByStem = new MapCtor()
     for (const [path, anchor] of anchorByPath) {
       const stem = path.replace(/\.[a-z0-9]+$/i, '')
       if (!anchorByStem.has(stem)) {
@@ -49,7 +56,10 @@
     }
 
     const resolveRelPath = (fromPath, ref) => {
-      if (!ref.startsWith('./') && !ref.startsWith('../')) {
+      if (
+        !StringPrototypeStartsWith(ref, './') &&
+        !StringPrototypeStartsWith(ref, '../')
+      ) {
         return null
       }
       const fromDir = fromPath.split('/').slice(0, -1)
@@ -85,7 +95,7 @@
         return
       }
       const matches = []
-      for (const m of text.matchAll(urlRe)) {
+      for (const m of StringPrototypeMatchAll(text, urlRe)) {
         matches.push({
           start: m.index,
           end: m.index + m[0].length,
@@ -94,7 +104,7 @@
           type: 'url',
         })
       }
-      for (const m of text.matchAll(quotedPathRe)) {
+      for (const m of StringPrototypeMatchAll(text, quotedPathRe)) {
         const pathRef = m[2]
         const anchor = filePath ? resolveRelPath(filePath, pathRef) : null
         if (!anchor) {

src/pages/jsdoc-group.js

@@ -14,6 +14,8 @@
  *        [@fileoverview?, @description?, others…]
  *
  * Exposes ns.groupJsdocBlocks(container). */
+
+import { ArrayFrom } from '@socketsecurity/lib/primordials'
 ;(() => {
   const ns = window[Symbol.for('socket-pages')]
   if (!ns) {
@@ -163,7 +165,7 @@
      * iteration wraps one tag's range and jumps the cursor past
      * the new block to pick up the next tag at the same sibling
      * level. Reverse-walking nested the cards inside each other. */
-    const tags = Array.from(container.querySelectorAll('.wt-jsdoc-tag'))
+    const tags = ArrayFrom(container.querySelectorAll('.wt-jsdoc-tag'))
     for (const tagEl of tags) {
       const parent = tagEl.parentElement
       if (!parent || parent.classList.contains('wt-jsdoc-block')) {
@@ -210,7 +212,7 @@
      * @returns / @throws"; the tour inverts this so the
      * description leads the stack and the tagged contract
      * supports it. */
-    const allBlocks = Array.from(container.querySelectorAll('.wt-jsdoc-block'))
+    const allBlocks = ArrayFrom(container.querySelectorAll('.wt-jsdoc-block'))
     /* Drop explicit @description blocks whose body is empty
      * (source was `@description` alone with no following prose,
      * or the prose ran directly into the next tag). Empty cards
@@ -264,7 +266,7 @@
       const descBody = document.createElement('span')
       descBody.className = 'wt-jsdoc-body'
       descBlock.appendChild(descBody)
-      for (const node of Array.from(container.childNodes)) {
+      for (const node of ArrayFrom(container.childNodes)) {
         if (node.nodeType === 1 && node.classList.contains('wt-jsdoc-block')) {
           continue
         }

src/pages/jsdoc-wrap.js

@@ -13,13 +13,19 @@
  * Exposes ns.wrapJsdocTags(container) so the group pass
  * (jsdoc-group.js) can call it in sequence. Kept separate so
  * each file handles one concern. */
+
+import {
+  ArrayFrom,
+  SetCtor,
+  StringPrototypeStartsWith,
+} from '@socketsecurity/lib/primordials'
 ;(() => {
   const ns = window[Symbol.for('socket-pages')]
   if (!ns) {
     return
   }
 
-  const JSDOC_TAGS = new Set([
+  const JSDOC_TAGS = new SetCtor([
     'augments',
     'callback',
     'default',
@@ -68,8 +74,8 @@
       if (code.classList.contains('hljs')) {
         continue
       }
-      const hasLang = Array.from(code.classList).some(c =>
-        c.startsWith('language-'),
+      const hasLang = ArrayFrom(code.classList).some(c =>
+        StringPrototypeStartsWith(c, 'language-'),
       )
       if (!hasLang) {
         /* Default `@example` fences without an explicit language

src/pages/purl-classifiers.js

@@ -14,13 +14,18 @@
  * tokenizer module can hand each code span to the right path:
  * PURL → hand-tokenize; bare ident / URL → .wt-purl (no
  * syntax pass); everything else → hljs as TypeScript. */
+
+import {
+  SetCtor,
+  StringPrototypeStartsWith,
+} from '@socketsecurity/lib/primordials'
 ;(() => {
   const ns = window[Symbol.for('socket-pages')]
   if (!ns) {
     return
   }
 
-  const PURL_TYPES = new Set([
+  const PURL_TYPES = new SetCtor([
     'alpm',
     'apk',
     'bitbucket',
@@ -99,7 +104,7 @@
     return (
       /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) ||
       /^[a-z][a-z0-9+.-]*:\/?$/i.test(trimmed) ||
-      trimmed.startsWith('//')
+      StringPrototypeStartsWith(trimmed, '//')
     )
   }
 })()

src/pages/purl-tokenizer.js

@@ -26,6 +26,8 @@
  * `tokenizeHomepagePills()` walks the index-page surfaces
  * (.wt-contents-summary rows, .wt-intro-line lines) so pills
  * on the homepage share the same language as part-page pills. */
+
+import { StringPrototypeStartsWith } from '@socketsecurity/lib/primordials'
 ;(() => {
   const ns = window[Symbol.for('socket-pages')]
   if (!ns) {
@@ -68,15 +70,15 @@
       emit(/^pkg:/, 'hljs-keyword')
       emit(/^[A-Za-z][A-Za-z0-9.+-]*/, 'hljs-type')
       while (rest.length > 0) {
-        if (rest.startsWith('/')) {
+        if (StringPrototypeStartsWith(rest, '/')) {
           appendPlain('/')
           rest = rest.slice(1)
           const segMatch = rest.match(/^[^/@?#]+/)
           if (segMatch) {
             code.appendChild(span('hljs-attr', segMatch[0]))
             rest = rest.slice(segMatch[0].length)
           }
-        } else if (rest.startsWith('@')) {
+        } else if (StringPrototypeStartsWith(rest, '@')) {
           const m = rest.match(/^@[^?#]+/)
           if (m) {
             code.appendChild(span('hljs-number', m[0]))
@@ -85,7 +87,7 @@
             appendPlain(rest)
             rest = ''
           }
-        } else if (rest.startsWith('?')) {
+        } else if (StringPrototypeStartsWith(rest, '?')) {
           const m = rest.match(/^\?[^#]+/)
           if (m) {
             code.appendChild(span('hljs-string', m[0]))
@@ -94,7 +96,7 @@
             appendPlain(rest)
             rest = ''
           }
-        } else if (rest.startsWith('#')) {
+        } else if (StringPrototypeStartsWith(rest, '#')) {
           code.appendChild(span('hljs-symbol', rest))
           rest = ''
         } else {

src/pages/sections.js

@@ -19,13 +19,20 @@
  *      the topmost intersecting card as "current" in the
  *      file-head menu (NOT the chip panels — those have their
  *      active row baked in at build time). */
+
+import {
+  MapCtor,
+  SetCtor,
+  WeakMapCtor,
+  WeakSetCtor,
+} from '@socketsecurity/lib/primordials'
 ;(() => {
   const ns = window[Symbol.for('socket-pages')]
   if (!ns) {
     return
   }
 
-  const hydratedChips = new WeakSet()
+  const hydratedChips = new WeakSetCtor()
   const hydrateChip = chip => {
     if (hydratedChips.has(chip)) {
       return
@@ -100,7 +107,7 @@
   }
 
   const installSectionTracking = () => {
-    const menusByAnchor = new Map()
+    const menusByAnchor = new MapCtor()
     for (const panel of document.querySelectorAll('.wt-sections-panel')) {
       for (const link of panel.querySelectorAll('a[href^="#"]')) {
         const id = link.getAttribute('href').slice(1)
@@ -119,7 +126,7 @@
       return
     }
 
-    const currentByPanel = new WeakMap()
+    const currentByPanel = new WeakMapCtor()
     const setActive = (panel, id) => {
       if (currentByPanel.get(panel) === id) {
         return
@@ -140,7 +147,7 @@
       }
     }
 
-    const visibleCards = new Set()
+    const visibleCards = new SetCtor()
     const pickCurrentFor = panel => {
       let best = null
       let bestTop = Infinity

src/pages/splitter.js

@@ -5,6 +5,8 @@
  * and pen. All reads of DOM geometry happen once at pointerdown;
  * onMove only writes, with rAF coalescing so multiple pointer
  * frames per refresh collapse into one DOM write. */
+
+import { MathMax } from '@socketsecurity/lib/primordials'
 ;(() => {
   const ns = window[Symbol.for('socket-pages')]
   if (!ns) {
@@ -110,10 +112,7 @@
         dragState.lastPct = pct
       }
       if (pendingClientY !== null && handleHeight > 0) {
-        const y = Math.max(
-          0,
-          Math.min(handleHeight, pendingClientY - handleTop),
-        )
+        const y = MathMax(0, Math.min(handleHeight, pendingClientY - handleTop))
         hotspot.style.transform = `translate3d(-50%, ${y}px, 0)`
       }
       dragState.pendingClientX = null