@blinkk/root 3.0.5 → 3.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkk/root",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "author": "s@blinkk.com",
   "license": "MIT",
   "engines": {

package/dist/chunk-6P3B7ZXL.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/utils/elements.ts", "../src/render/html-minify.ts", "../src/render/html-pretty.ts", "../src/render/route-trie.ts"],
-  "sourcesContent": ["export const ELEMENT_RE = /^[a-z][\\w-]*-[\\w-]*$/;\nexport const HTML_ELEMENTS_REGEX = /<([a-z][\\w-]*-[\\w-]*)/g;\n\n/**\n * Returns true if the tagName is a valid custom element tag.\n */\nexport function isValidTagName(tagName: string) {\n  return ELEMENT_RE.test(tagName);\n}\n\n/**\n * Returns a list of custom elements used in a src string (e.g. HTML, jsx, lit).\n * NOTE: the impl uses a simple regex, so tagNames used in comments and attr\n * values may be included.\n */\nexport function parseTagNames(src: string): string[] {\n  if (!src) {\n    return [];\n  }\n  const tagNames = new Set<string>();\n  const matches = Array.from(String(src).matchAll(HTML_ELEMENTS_REGEX));\n  for (const match of matches) {\n    const tagName = match[1];\n    tagNames.add(tagName);\n  }\n  return Array.from(tagNames);\n}\n", "import {createRequire} from 'module';\n\nconst require = createRequire(import.meta.url);\nimport type {Options} from 'html-minifier-terser';\n\nconst {minify} = require('html-minifier-terser');\n\nexport type HtmlMinifyOptions = Options;\n\nexport async function htmlMinify(\n  html: string,\n  options?: HtmlMinifyOptions\n): Promise<string> {\n  const minifyOptions = options || {\n    collapseWhitespace: true,\n    removeComments: true,\n    preserveLineBreaks: true,\n  };\n  try {\n    const min = await minify(html, minifyOptions);\n    return min.trimStart();\n  } catch (e) {\n    console.error('failed to minify html:', e);\n    return html;\n  }\n}\n", "import {createRequire} from 'module';\n\nconst require = createRequire(import.meta.url);\nimport type {HTMLBeautifyOptions} from 'js-beautify';\n\nconst beautify = require('js-beautify');\n\nexport type HtmlPrettyOptions = HTMLBeautifyOptions;\n\nexport async function htmlPretty(\n  html: string,\n  options?: HtmlPrettyOptions\n): Promise<string> {\n  const prettyOptions = options || {\n    indent_size: 0,\n    end_with_newline: true,\n    extra_liners: [],\n  };\n  try {\n    const output = beautify.html(html, prettyOptions);\n    return output.trimStart();\n  } catch (e) {\n    console.error('failed to pretty html:', e);\n    return html;\n  }\n}\n", "/**\n * A trie data structure that stores routes. Supports Next-style routing using\n * [param], [...catchall], and [[...optcatchall]] placeholders.\n */\nexport class RouteTrie<T> {\n  private children: Map<string, RouteTrie<T>> = new Map();\n  private paramNodes?: Map<string, ParamNode<T>>;\n  private catchAllNodes?: CatchAllNode<T>;\n  private optCatchAllNodes?: CatchAllNode<T>;\n  private route?: T;\n\n  /**\n   * Adds a route to the trie.\n   */\n  add(path: string, route: T) {\n    path = this.normalizePath(path);\n\n    // If the end was reached, save the value to the node.\n    if (path === '') {\n      this.route = route;\n      return;\n    }\n\n    const [head, tail] = this.splitPath(path);\n\n    if (head.startsWith('[[...') && head.endsWith(']]')) {\n      const paramName = head.slice(5, -2);\n      this.optCatchAllNodes = new CatchAllNode(paramName, route);\n      return;\n    }\n    if (head.startsWith('[...') && head.endsWith(']')) {\n      const paramName = head.slice(4, -1);\n      this.catchAllNodes = new CatchAllNode(paramName, route);\n      return;\n    }\n\n    let nextNode: RouteTrie<T>;\n    if (head.startsWith('[') && head.endsWith(']')) {\n      if (!this.paramNodes) {\n        this.paramNodes = new Map();\n      }\n      const paramName = head.slice(1, -1);\n      if (!this.paramNodes.has(paramName)) {\n        this.paramNodes.set(paramName, new ParamNode(paramName));\n      }\n      nextNode = this.paramNodes.get(paramName)!.trie;\n    } else {\n      nextNode = this.children.get(head)!;\n      if (!nextNode) {\n        nextNode = new RouteTrie();\n        this.children.set(head, nextNode);\n      }\n    }\n    nextNode.add(tail, route);\n  }\n\n  /**\n   * Returns a route mapped to the given path and any parameter values from the\n   * URL.\n   */\n  get(path: string): [T | undefined, Record<string, string>] {\n    const params = {};\n    const route = this.getRoute(path, params);\n    return [route, params];\n  }\n\n  /**\n   * Returns all routes that match the given path and their parameter values.\n   */\n  matchAll(path: string): Array<[T, Record<string, string>]> {\n    const matches: Array<[T, Record<string, string>]> = [];\n    this.collectRoutes(path, {}, matches);\n    return matches;\n  }\n\n  /**\n   * Walks the route trie and calls a callback function for each route.\n   */\n  walk(cb: (urlPath: string, route: T) => Promise<void> | void): Promise<void> {\n    const promises: Array<Promise<void>> = [];\n    const addPromise = (promise: Promise<void> | void) => {\n      if (promise) {\n        promises.push(promise);\n      }\n    };\n    if (this.route) {\n      addPromise(cb('/', this.route));\n    }\n    if (this.paramNodes) {\n      this.paramNodes.forEach((paramChild) => {\n        const param = `[${paramChild.name}]`;\n        paramChild.trie.walk((childPath: string, route: T) => {\n          const paramUrlPath = `/${param}${childPath}`;\n          addPromise(cb(paramUrlPath, route));\n        });\n      });\n    }\n    if (this.catchAllNodes) {\n      const wildcardUrlPath = `/[...${this.catchAllNodes.name}]`;\n      addPromise(cb(wildcardUrlPath, this.catchAllNodes.route));\n    }\n    if (this.optCatchAllNodes) {\n      const wildcardUrlPath = `/[[...${this.optCatchAllNodes.name}]]`;\n      addPromise(cb(wildcardUrlPath, this.optCatchAllNodes.route));\n    }\n    this.children.forEach((childTrie, subpath) => {\n      childTrie.walk((childPath: string, childRoute: T) => {\n        addPromise(cb(`/${subpath}${childPath}`, childRoute));\n      });\n    });\n    return Promise.all(promises).then(() => {});\n  }\n\n  /**\n   * Removes all routes from the trie.\n   */\n  clear() {\n    this.children = new Map();\n    this.paramNodes = undefined;\n    this.catchAllNodes = undefined;\n    this.optCatchAllNodes = undefined;\n    this.route = undefined;\n  }\n\n  private getRoute(\n    urlPath: string,\n    params: Record<string, string>\n  ): T | undefined {\n    urlPath = this.normalizePath(urlPath);\n    if (urlPath === '') {\n      if (this.route) {\n        return this.route;\n      }\n      if (this.optCatchAllNodes) {\n        if (urlPath) {\n          params[this.optCatchAllNodes.name] = urlPath;\n        }\n        return this.optCatchAllNodes.route;\n      }\n      return undefined;\n    }\n\n    const [head, tail] = this.splitPath(urlPath);\n\n    const child = this.children.get(head);\n    if (child) {\n      const route = child.getRoute(tail, params);\n      if (route) {\n        return route;\n      }\n    }\n\n    if (this.paramNodes) {\n      for (const paramChild of this.paramNodes.values()) {\n        const route = paramChild.trie.getRoute(tail, params);\n        if (route) {\n          params[paramChild.name] = head;\n          return route;\n        }\n      }\n    }\n\n    if (this.catchAllNodes) {\n      params[this.catchAllNodes.name] = urlPath;\n      return this.catchAllNodes.route;\n    }\n\n    if (this.optCatchAllNodes) {\n      params[this.optCatchAllNodes.name] = urlPath;\n      return this.optCatchAllNodes.route;\n    }\n\n    return undefined;\n  }\n\n  private collectRoutes(\n    urlPath: string,\n    params: Record<string, string>,\n    results: Array<[T, Record<string, string>]>\n  ) {\n    urlPath = this.normalizePath(urlPath);\n    if (urlPath === '') {\n      if (this.route) {\n        results.push([this.route, {...params}]);\n      }\n      if (this.optCatchAllNodes) {\n        const optParams = {...params};\n        if (urlPath) {\n          optParams[this.optCatchAllNodes.name] = urlPath;\n        }\n        results.push([this.optCatchAllNodes.route, optParams]);\n      }\n      return;\n    }\n\n    const [head, tail] = this.splitPath(urlPath);\n\n    const child = this.children.get(head);\n    if (child) {\n      child.collectRoutes(tail, {...params}, results);\n    }\n\n    if (this.paramNodes) {\n      for (const paramChild of this.paramNodes.values()) {\n        const paramParams = {...params, [paramChild.name]: head};\n        paramChild.trie.collectRoutes(tail, paramParams, results);\n      }\n    }\n\n    if (this.catchAllNodes) {\n      const caParams = {...params, [this.catchAllNodes.name]: urlPath};\n      results.push([this.catchAllNodes.route, caParams]);\n    }\n\n    if (this.optCatchAllNodes) {\n      const ocParams = {...params};\n      if (urlPath) {\n        ocParams[this.optCatchAllNodes.name] = urlPath;\n      }\n      results.push([this.optCatchAllNodes.route, ocParams]);\n    }\n  }\n\n  /**\n   * Normalizes a path for inclusion into the route trie.\n   */\n  private normalizePath(path: string) {\n    // Remove leading/trailing slashes.\n    return path.replace(/^\\/+/g, '').replace(/\\/+$/g, '');\n  }\n\n  /**\n   * Splits the parent directory from its children, e.g.:\n   *\n   *     splitPath(\"foo/bar/baz\") -> [\"foo\", \"bar/baz\"]\n   */\n  private splitPath(path: string): [string, string] {\n    const i = path.indexOf('/');\n    if (i === -1) {\n      return [path, ''];\n    }\n    return [path.slice(0, i), path.slice(i + 1)];\n  }\n}\n\n/**\n * A node in the RouteTrie for a :param child.\n */\nclass ParamNode<T> {\n  readonly name: string;\n  readonly trie: RouteTrie<T> = new RouteTrie();\n\n  constructor(name: string) {\n    this.name = name;\n  }\n}\n\n/**\n * A node in the RouteTrie for a *wildcard child.\n */\nclass CatchAllNode<T> {\n  readonly name: string;\n  readonly route: T;\n\n  constructor(name: string, route: T) {\n    this.name = name;\n    this.route = route;\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["require", "createRequire", "require"]
-}