epos-spec 1.3.0 → 1.5.0

package/dist/epos-spec.js

@@ -283,3 +283,4 @@ export {
   epos_spec_default as default,
   parseSpec
 };
+//# sourceMappingURL=epos-spec.js.map

package/dist/epos-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/epos-spec.ts"],"sourcesContent":["import { matchPattern } from 'browser-extension-url-match'\nimport type { Obj } from 'dropcap/types'\nimport { ensureArray, is, safeSync, unique } from 'dropcap/utils'\nimport stripJsonComments from 'strip-json-comments'\n\nexport type Action = true | string\nexport type Path = string\nexport type Match = LocusMatch | TopMatch | FrameMatch\nexport type MatchPattern = UrlMatchPattern | '<all_urls>'\nexport type UrlMatchPattern = string // '*://*.example.com/*'\nexport type Access = 'installer' | 'engine'\nexport type Manifest = Obj\n\nexport type Spec = {\n  name: string\n  icon: string | null\n  title: string | null\n  version: string\n  description: string | null\n  popup: Popup\n  action: Action | null\n  config: Config\n  assets: Path[]\n  targets: Target[]\n  permissions: Permissions\n  manifest: Manifest | null\n}\n\nexport type Popup = {\n  width: number\n  height: number\n}\n\nexport type Config = {\n  access: Access[]\n  preloadAssets: boolean\n  allowMissingModels: boolean\n}\n\nexport type Target = {\n  matches: Match[]\n  resources: Resource[]\n}\n\nexport type LocusMatch = {\n  context: 'locus'\n  value: 'popup' | 'sidePanel' | 'background'\n}\n\nexport type TopMatch = {\n  context: 'top'\n  value: MatchPattern\n}\n\nexport type FrameMatch = {\n  context: 'frame'\n  value: MatchPattern\n}\n\nexport type Resource = {\n  type: 'js' | 'css' | 'lite-js' | 'shadow-css'\n  path: Path\n}\n\nexport type Permissions = {\n  mandatory: Permission[]\n  optional: Permission[]\n}\n\nexport type Permission =\n  | 'background'\n  | 'browsingData'\n  | 'contextMenus'\n  | 'cookies'\n  | 'downloads'\n  | 'notifications'\n  | 'storage'\n\nconst schema = {\n  keys: [\n    '$schema',\n    'name',\n    'version',\n    'icon',\n    'title',\n    'description',\n    'action',\n    'popup',\n    'config',\n    'assets',\n    'targets',\n    'permissions',\n    'manifest',\n  ],\n  name: { min: 2, max: 50, regex: /^[a-z0-9][a-z0-9-]*[a-z0-9]$/ },\n  title: { min: 2, max: 45 },\n  description: { max: 132 },\n  version: { regex: /^(?:\\d{1,5}\\.){0,3}\\d{1,5}$/ },\n  popup: {\n    keys: ['width', 'height'],\n    width: { min: 150, max: 800, default: 380 },\n    height: { min: 150, max: 600 - 8 * 4, default: 600 - 8 * 4 },\n  },\n  config: {\n    keys: ['access', 'preloadAssets', 'allowMissingModels'],\n    access: { default: [], variants: ['installer', 'engine'] },\n    preloadAssets: { default: true },\n    allowMissingModels: { default: false },\n  },\n  target: {\n    keys: ['matches', 'load'],\n  },\n  permissions: [\n    'background',\n    'browsingData',\n    'contextMenus',\n    'cookies',\n    'downloads',\n    'notifications',\n    'storage',\n    'optional:background',\n    'optional:browsingData',\n    'optional:contextMenus',\n    'optional:cookies',\n    'optional:downloads',\n    'optional:notifications',\n    'optional:storage',\n  ],\n}\n\nexport function parseSpec(json: string): Spec {\n  json = stripJsonComments(json)\n  const [spec, error] = safeSync(() => JSON.parse(json))\n  if (error) throw new Error(`Failed to parse JSON: ${error.message}`)\n  if (!is.object(spec)) throw new Error(`Epos spec must be an object`)\n\n  const keys = [...schema.keys, ...schema.target.keys]\n  const badKey = Object.keys(spec).find(key => !keys.includes(key))\n  if (badKey) throw new Error(`Unknown spec key: '${badKey}'`)\n\n  return {\n    name: parseName(spec),\n    icon: parseIcon(spec),\n    title: parseTitle(spec),\n    version: parseVersion(spec),\n    description: parseDescription(spec),\n    popup: parsePopup(spec),\n    action: parseAction(spec),\n    config: parseConfig(spec),\n    assets: parseAssets(spec),\n    targets: parseTargets(spec),\n    permissions: parsePermissions(spec),\n    manifest: parseManifest(spec),\n  }\n}\n\nfunction parseName(spec: Obj) {\n  if (!('name' in spec)) throw new Error(`'name' field is required`)\n\n  const name = spec.name\n  const { min, max, regex } = schema.name\n  if (!is.string(name)) throw new Error(`'name' must be a string`)\n  if (name.length < min) throw new Error(`'name' must be at least ${min} characters`)\n  if (name.length > max) throw new Error(`'name' must be at most ${max} characters`)\n  if (!regex.test(name)) throw new Error(`'name' must match ${regex}`)\n\n  return name\n}\n\nfunction parseIcon(spec: Obj) {\n  if (!('icon' in spec)) return null\n\n  const icon = spec.icon\n  if (!is.string(icon)) throw new Error(`'icon' must be a string`)\n\n  return parsePath(icon)\n}\n\nfunction parseTitle(spec: Obj): string | null {\n  if (!('title' in spec)) return null\n\n  const title = spec.title\n  if (!is.string(title)) throw new Error(`'title' must be a string`)\n\n  const { min, max } = schema.title\n  if (title.length < min) throw new Error(`'title' must be at least ${min} characters`)\n  if (title.length > max) throw new Error(`'title' must be at most ${max} characters`)\n\n  return title\n}\n\nfunction parseVersion(spec: Obj): string {\n  if (!('version' in spec)) return '0.0.0'\n\n  const version = spec.version\n  if (!is.string(version)) throw new Error(`'version' must be a string`)\n  if (!schema.version.regex.test(version)) throw new Error(`'version' must be in format X.Y.Z or X.Y or X`)\n\n  return version\n}\n\nfunction parseDescription(spec: Obj): string | null {\n  if (!('description' in spec)) return null\n\n  const description = spec.description\n  if (!is.string(description)) throw new Error(`'description' must be a string`)\n\n  const { max } = schema.description\n  if (description.length > max) throw new Error(`'description' must be at most ${max} characters`)\n\n  return description\n}\n\nfunction parsePopup(spec: Obj) {\n  const popup = structuredClone(spec.popup ?? {})\n  if (!is.object(popup)) throw new Error(`'popup' must be an object`)\n\n  const { keys, width, height } = schema.popup\n  const badKey = Object.keys(popup).find(key => !keys.includes(key))\n  if (badKey) throw new Error(`Unknown 'popup' key: '${badKey}'`)\n\n  popup.width ??= width.default\n  if (!is.integer(popup.width)) throw new Error(`'popup.width' must be an integer`)\n  if (popup.width < width.min) throw new Error(`'popup.width' must be ≥ ${width.min}`)\n  if (popup.width > width.max) throw new Error(`'popup.width' must be ≤ ${width.max}`)\n\n  popup.height ??= height.default\n  if (!is.integer(popup.height)) throw new Error(`'popup.height' must be an integer`)\n  if (popup.height < height.min) throw new Error(`'popup.height' must be ≥ ${height.min}`)\n  if (popup.height > height.max) throw new Error(`'popup.height' must be ≤ ${height.max}`)\n\n  return popup as Popup\n}\n\nfunction parseAction(spec: Obj): Action | null {\n  const action = spec.action ?? null\n  if (action === null) return null\n  if (action === true) return true\n\n  if (!is.string(action)) throw new Error(`'action' must be a URL or true`)\n  if (!isValidUrl(action)) throw new Error(`Invalid 'action' URL: '${JSON.stringify(action)}'`)\n\n  return action\n}\n\nfunction parseConfig(spec: Obj): Config {\n  const config = spec.config ?? {}\n  if (!is.object(config)) throw new Error(`'config' must be an object`)\n\n  const badKey = Object.keys(config).find(key => !schema.config.keys.includes(key))\n  if (badKey) throw new Error(`Unknown 'config' key: '${badKey}'`)\n\n  const access = config.access ?? schema.config.access.default\n  if (!isArrayOfStrings(access)) throw new Error(`'config.access' must be an array of strings`)\n  const badAccess = access.find(value => !schema.config.access.variants.includes(value))\n  if (badAccess) throw new Error(`Unknown 'config.access' value: '${badAccess}'`)\n\n  const preloadAssets = config.preloadAssets ?? schema.config.preloadAssets.default\n  if (!is.boolean(preloadAssets)) throw new Error(`'config.preloadAssets' must be a boolean`)\n\n  const allowMissingModels = config.allowMissingModels ?? schema.config.allowMissingModels.default\n  if (!is.boolean(allowMissingModels)) throw new Error(`'config.allowMissingModels' must be a boolean`)\n\n  return {\n    access: access as Access[],\n    preloadAssets,\n    allowMissingModels,\n  }\n}\n\nfunction parseAssets(spec: Obj) {\n  const assets = structuredClone(spec.assets ?? [])\n  if (!isArrayOfStrings(assets)) throw new Error(`'assets' must be an array of strings`)\n\n  // Add icon to assets\n  const icon = parseIcon(spec)\n  if (icon) assets.push(icon)\n\n  return unique(assets.map(path => parsePath(path)))\n}\n\nfunction parseTargets(spec: Obj) {\n  const targets = structuredClone(spec.targets ?? [])\n  if (!is.array(targets)) throw new Error(`'targets' must be an array`)\n\n  // Move top-level target to 'targets'\n  if ('matches' in spec || 'load' in spec || 'mode' in spec) {\n    targets.unshift({\n      matches: structuredClone(spec.matches ?? []),\n      load: structuredClone(spec.load ?? []),\n    })\n  }\n\n  return targets.map(target => parseTarget(target))\n}\n\nfunction parseTarget(target: unknown): Target {\n  if (!is.object(target)) throw new Error(`Each target must be an object`)\n\n  const { keys } = schema.target\n  const badKey = Object.keys(target).find(key => !keys.includes(key))\n  if (badKey) throw new Error(`Unknown target key: '${badKey}'`)\n\n  return {\n    matches: parseMatches(target),\n    resources: parseResources(target),\n  }\n}\n\nfunction parseMatches(target: Obj): Match[] {\n  const matches = ensureArray(target.matches ?? [])\n  return matches.map(match => parseMatch(match)).flat()\n}\n\nfunction parseMatch(match: unknown): Match | Match[] {\n  if (!is.string(match)) throw new Error(`Invalid match pattern: '${JSON.stringify(match)}'`)\n\n  if (match === '<popup>') return { context: 'locus', value: 'popup' }\n  if (match === '<sidePanel>') return { context: 'locus', value: 'sidePanel' }\n  if (match === '<background>') return { context: 'locus', value: 'background' }\n\n  const context = match.startsWith('frame:') ? 'frame' : 'top'\n  let pattern = context === 'frame' ? match.replace('frame:', '') : match\n\n  if (pattern === '<allUrls>') return { context, value: '<all_urls>' }\n  if (pattern === '<all_urls>') throw new Error(`Use '<allUrls>' instead of '<all_urls>'`)\n\n  if (pattern.startsWith('exact:')) {\n    return { context, value: parseMatchPattern(pattern.replace('exact:', '')) }\n  }\n\n  // Ensure pattern url has a path: `*://example.com` -> `*://example.com/`\n  const href = pattern.replaceAll('*', 'wildcard--')\n  if (!URL.canParse(href)) throw new Error(`Invalid match pattern: '${match}'`)\n  const url = new URL(href)\n  if (url.pathname === '') url.pathname = '/'\n  pattern = url.href.replaceAll('wildcard--', '*')\n\n  return [\n    { context, value: parseMatchPattern(pattern) },\n    { context, value: parseMatchPattern(`${pattern}?*`) },\n  ]\n}\n\nfunction parseMatchPattern(pattern: string): MatchPattern {\n  const matcher = matchPattern(pattern)\n  if (!matcher.valid) throw new Error(`Invalid match pattern: '${pattern}'`)\n  return pattern\n}\n\nfunction parseResources(target: Obj) {\n  const load = ensureArray(target.load ?? [])\n  if (!isArrayOfStrings(load)) throw new Error(`'load' must be an array of strings`)\n  return load.map(loadEntry => parseResource(loadEntry))\n}\n\nfunction parseResource(loadEntry: string): Resource {\n  const isJs = loadEntry.toLowerCase().endsWith('.js')\n  const isCss = loadEntry.toLowerCase().endsWith('.css')\n  if (!isJs && !isCss) throw new Error(`Invalid 'load' file, must be JS or CSS: '${loadEntry}'`)\n\n  if (loadEntry.startsWith('lite:')) {\n    if (!isJs) throw new Error(`'lite:' resources must be JS files: '${loadEntry}'`)\n    return { path: loadEntry.replace('lite:', ''), type: 'lite-js' }\n  } else if (loadEntry.startsWith('shadow:')) {\n    if (!isCss) throw new Error(`'shadow:' resources must be CSS files: '${loadEntry}'`)\n    return { path: loadEntry.replace('shadow:', ''), type: 'shadow-css' }\n  } else {\n    return { path: loadEntry, type: isJs ? 'js' : 'css' }\n  }\n}\n\nfunction parsePermissions(spec: Obj): Permissions {\n  const permissions = spec.permissions ?? []\n  if (!isArrayOfStrings(permissions)) throw new Error(`'permissions' must be an array of strings`)\n\n  const badPermission = permissions.find(value => !schema.permissions.includes(value))\n  if (badPermission) throw new Error(`Unknown permission: '${badPermission}'`)\n\n  const mandatoryPermissions = new Set<string>()\n  const optionalPermissions = new Set<string>()\n  for (const permission of permissions) {\n    if (permission.startsWith('optional:')) {\n      optionalPermissions.add(permission.replace('optional:', ''))\n    } else {\n      mandatoryPermissions.add(permission)\n    }\n  }\n\n  for (const permission of mandatoryPermissions) {\n    if (optionalPermissions.has(permission)) {\n      throw new Error(`Permission cannot be both mandatory and optional: '${permission}'`)\n    }\n  }\n\n  return {\n    mandatory: [...mandatoryPermissions] as Permission[],\n    optional: [...optionalPermissions] as Permission[],\n  }\n}\n\nfunction parseManifest(spec: Obj): Manifest | null {\n  if (!('manifest' in spec)) return null\n  if (!is.object(spec.manifest)) throw new Error(`'manifest' must be an object`)\n  return spec.manifest\n}\n\n// ---------------------------------------------------------------------------\n// HELPERS\n// ---------------------------------------------------------------------------\n\nfunction isArrayOfStrings(value: unknown) {\n  return is.array(value) && value.every(is.string)\n}\n\nfunction isValidUrl(value: unknown) {\n  if (!is.string(value)) return false\n  return URL.canParse(value)\n}\n\n/**\n * - 'path/to' -> 'path/to'\n * - 'path/to/' -> 'path/to'\n * - '/path/to' -> 'path/to'\n * - 'path//to' -> 'path/to'\n * - 'path/./to' -> 'path/to'\n * - './path/to' -> 'path/to'\n * - 'path/../to' -> 'path/../to'\n * - '../path/to' -> throw\n */\nfunction parsePath(path: string) {\n  const normalizedPath = path\n    .split('/')\n    .filter(path => path && path !== '.')\n    .join('/')\n\n  if (normalizedPath.startsWith('..')) throw new Error(`External paths are not allowed: '${path}'`)\n\n  return normalizedPath\n}\n\nexport default parseSpec\n"],"mappings":"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","names":["path"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epos-spec",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "license": "MIT",
   "author": "imkost",
@@ -13,16 +13,14 @@
     "release": "sh -c 'npm version ${1:-minor} && npm run build && npm publish' --"
   },
   "exports": {
-    ".": "./dist/epos-spec.js",
-    "./ts": "./src/epos-spec.ts"
+    ".": "./dist/epos-spec.js"
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "dependencies": {
     "browser-extension-url-match": "^1.2.0",
-    "dropcap": "^1.0.0",
+    "dropcap": "^1.4.0",
     "strip-json-comments": "^5.0.3"
   }
 }

package/src/epos-spec.ts

@@ -1,442 +0,0 @@
-import { matchPattern } from 'browser-extension-url-match'
-import type { Obj } from 'dropcap/types'
-import { ensureArray, is, safeSync, unique } from 'dropcap/utils'
-import stripJsonComments from 'strip-json-comments'
-
-export type Action = true | string
-export type Path = string
-export type Match = LocusMatch | TopMatch | FrameMatch
-export type MatchPattern = UrlMatchPattern | '<all_urls>'
-export type UrlMatchPattern = string // '*://*.example.com/*'
-export type Access = 'installer' | 'engine'
-export type Manifest = Obj
-
-export type Spec = {
-  name: string
-  icon: string | null
-  title: string | null
-  version: string
-  description: string | null
-  popup: Popup
-  action: Action | null
-  config: Config
-  assets: Path[]
-  targets: Target[]
-  permissions: Permissions
-  manifest: Manifest | null
-}
-
-export type Popup = {
-  width: number
-  height: number
-}
-
-export type Config = {
-  access: Access[]
-  preloadAssets: boolean
-  allowMissingModels: boolean
-}
-
-export type Target = {
-  matches: Match[]
-  resources: Resource[]
-}
-
-export type LocusMatch = {
-  context: 'locus'
-  value: 'popup' | 'sidePanel' | 'background'
-}
-
-export type TopMatch = {
-  context: 'top'
-  value: MatchPattern
-}
-
-export type FrameMatch = {
-  context: 'frame'
-  value: MatchPattern
-}
-
-export type Resource = {
-  type: 'js' | 'css' | 'lite-js' | 'shadow-css'
-  path: Path
-}
-
-export type Permissions = {
-  mandatory: Permission[]
-  optional: Permission[]
-}
-
-export type Permission =
-  | 'background'
-  | 'browsingData'
-  | 'contextMenus'
-  | 'cookies'
-  | 'downloads'
-  | 'notifications'
-  | 'storage'
-
-const schema = {
-  keys: [
-    '$schema',
-    'name',
-    'version',
-    'icon',
-    'title',
-    'description',
-    'action',
-    'popup',
-    'config',
-    'assets',
-    'targets',
-    'permissions',
-    'manifest',
-  ],
-  name: { min: 2, max: 50, regex: /^[a-z0-9][a-z0-9-]*[a-z0-9]$/ },
-  title: { min: 2, max: 45 },
-  description: { max: 132 },
-  version: { regex: /^(?:\d{1,5}\.){0,3}\d{1,5}$/ },
-  popup: {
-    keys: ['width', 'height'],
-    width: { min: 150, max: 800, default: 380 },
-    height: { min: 150, max: 600 - 8 * 4, default: 600 - 8 * 4 },
-  },
-  config: {
-    keys: ['access', 'preloadAssets', 'allowMissingModels'],
-    access: { default: [], variants: ['installer', 'engine'] },
-    preloadAssets: { default: true },
-    allowMissingModels: { default: false },
-  },
-  target: {
-    keys: ['matches', 'load'],
-  },
-  permissions: [
-    'background',
-    'browsingData',
-    'contextMenus',
-    'cookies',
-    'downloads',
-    'notifications',
-    'storage',
-    'optional:background',
-    'optional:browsingData',
-    'optional:contextMenus',
-    'optional:cookies',
-    'optional:downloads',
-    'optional:notifications',
-    'optional:storage',
-  ],
-}
-
-export function parseSpec(json: string): Spec {
-  json = stripJsonComments(json)
-  const [spec, error] = safeSync(() => JSON.parse(json))
-  if (error) throw new Error(`Failed to parse JSON: ${error.message}`)
-  if (!is.object(spec)) throw new Error(`Epos spec must be an object`)
-
-  const keys = [...schema.keys, ...schema.target.keys]
-  const badKey = Object.keys(spec).find(key => !keys.includes(key))
-  if (badKey) throw new Error(`Unknown spec key: '${badKey}'`)
-
-  return {
-    name: parseName(spec),
-    icon: parseIcon(spec),
-    title: parseTitle(spec),
-    version: parseVersion(spec),
-    description: parseDescription(spec),
-    popup: parsePopup(spec),
-    action: parseAction(spec),
-    config: parseConfig(spec),
-    assets: parseAssets(spec),
-    targets: parseTargets(spec),
-    permissions: parsePermissions(spec),
-    manifest: parseManifest(spec),
-  }
-}
-
-function parseName(spec: Obj) {
-  if (!('name' in spec)) throw new Error(`'name' field is required`)
-
-  const name = spec.name
-  const { min, max, regex } = schema.name
-  if (!is.string(name)) throw new Error(`'name' must be a string`)
-  if (name.length < min) throw new Error(`'name' must be at least ${min} characters`)
-  if (name.length > max) throw new Error(`'name' must be at most ${max} characters`)
-  if (!regex.test(name)) throw new Error(`'name' must match ${regex}`)
-
-  return name
-}
-
-function parseIcon(spec: Obj) {
-  if (!('icon' in spec)) return null
-
-  const icon = spec.icon
-  if (!is.string(icon)) throw new Error(`'icon' must be a string`)
-
-  return parsePath(icon)
-}
-
-function parseTitle(spec: Obj): string | null {
-  if (!('title' in spec)) return null
-
-  const title = spec.title
-  if (!is.string(title)) throw new Error(`'title' must be a string`)
-
-  const { min, max } = schema.title
-  if (title.length < min) throw new Error(`'title' must be at least ${min} characters`)
-  if (title.length > max) throw new Error(`'title' must be at most ${max} characters`)
-
-  return title
-}
-
-function parseVersion(spec: Obj): string {
-  if (!('version' in spec)) return '0.0.0'
-
-  const version = spec.version
-  if (!is.string(version)) throw new Error(`'version' must be a string`)
-  if (!schema.version.regex.test(version)) throw new Error(`'version' must be in format X.Y.Z or X.Y or X`)
-
-  return version
-}
-
-function parseDescription(spec: Obj): string | null {
-  if (!('description' in spec)) return null
-
-  const description = spec.description
-  if (!is.string(description)) throw new Error(`'description' must be a string`)
-
-  const { max } = schema.description
-  if (description.length > max) throw new Error(`'description' must be at most ${max} characters`)
-
-  return description
-}
-
-function parsePopup(spec: Obj) {
-  const popup = structuredClone(spec.popup ?? {})
-  if (!is.object(popup)) throw new Error(`'popup' must be an object`)
-
-  const { keys, width, height } = schema.popup
-  const badKey = Object.keys(popup).find(key => !keys.includes(key))
-  if (badKey) throw new Error(`Unknown 'popup' key: '${badKey}'`)
-
-  popup.width ??= width.default
-  if (!is.integer(popup.width)) throw new Error(`'popup.width' must be an integer`)
-  if (popup.width < width.min) throw new Error(`'popup.width' must be ≥ ${width.min}`)
-  if (popup.width > width.max) throw new Error(`'popup.width' must be ≤ ${width.max}`)
-
-  popup.height ??= height.default
-  if (!is.integer(popup.height)) throw new Error(`'popup.height' must be an integer`)
-  if (popup.height < height.min) throw new Error(`'popup.height' must be ≥ ${height.min}`)
-  if (popup.height > height.max) throw new Error(`'popup.height' must be ≤ ${height.max}`)
-
-  return popup as Popup
-}
-
-function parseAction(spec: Obj): Action | null {
-  const action = spec.action ?? null
-  if (action === null) return null
-  if (action === true) return true
-
-  if (!is.string(action)) throw new Error(`'action' must be a URL or true`)
-  if (!isValidUrl(action)) throw new Error(`Invalid 'action' URL: '${JSON.stringify(action)}'`)
-
-  return action
-}
-
-function parseConfig(spec: Obj): Config {
-  const config = spec.config ?? {}
-  if (!is.object(config)) throw new Error(`'config' must be an object`)
-
-  const badKey = Object.keys(config).find(key => !schema.config.keys.includes(key))
-  if (badKey) throw new Error(`Unknown 'config' key: '${badKey}'`)
-
-  const access = config.access ?? schema.config.access.default
-  if (!isArrayOfStrings(access)) throw new Error(`'config.access' must be an array of strings`)
-  const badAccess = access.find(value => !schema.config.access.variants.includes(value))
-  if (badAccess) throw new Error(`Unknown 'config.access' value: '${badAccess}'`)
-
-  const preloadAssets = config.preloadAssets ?? schema.config.preloadAssets.default
-  if (!is.boolean(preloadAssets)) throw new Error(`'config.preloadAssets' must be a boolean`)
-
-  const allowMissingModels = config.allowMissingModels ?? schema.config.allowMissingModels.default
-  if (!is.boolean(allowMissingModels)) throw new Error(`'config.allowMissingModels' must be a boolean`)
-
-  return {
-    access: access as Access[],
-    preloadAssets,
-    allowMissingModels,
-  }
-}
-
-function parseAssets(spec: Obj) {
-  const assets = structuredClone(spec.assets ?? [])
-  if (!isArrayOfStrings(assets)) throw new Error(`'assets' must be an array of strings`)
-
-  // Add icon to assets
-  const icon = parseIcon(spec)
-  if (icon) assets.push(icon)
-
-  return unique(assets.map(path => parsePath(path)))
-}
-
-function parseTargets(spec: Obj) {
-  const targets = structuredClone(spec.targets ?? [])
-  if (!is.array(targets)) throw new Error(`'targets' must be an array`)
-
-  // Move top-level target to 'targets'
-  if ('matches' in spec || 'load' in spec || 'mode' in spec) {
-    targets.unshift({
-      matches: structuredClone(spec.matches ?? []),
-      load: structuredClone(spec.load ?? []),
-    })
-  }
-
-  return targets.map(target => parseTarget(target))
-}
-
-function parseTarget(target: unknown): Target {
-  if (!is.object(target)) throw new Error(`Each target must be an object`)
-
-  const { keys } = schema.target
-  const badKey = Object.keys(target).find(key => !keys.includes(key))
-  if (badKey) throw new Error(`Unknown target key: '${badKey}'`)
-
-  return {
-    matches: parseMatches(target),
-    resources: parseResources(target),
-  }
-}
-
-function parseMatches(target: Obj): Match[] {
-  const matches = ensureArray(target.matches ?? [])
-  return matches.map(match => parseMatch(match)).flat()
-}
-
-function parseMatch(match: unknown): Match | Match[] {
-  if (!is.string(match)) throw new Error(`Invalid match pattern: '${JSON.stringify(match)}'`)
-
-  if (match === '<popup>') return { context: 'locus', value: 'popup' }
-  if (match === '<sidePanel>') return { context: 'locus', value: 'sidePanel' }
-  if (match === '<background>') return { context: 'locus', value: 'background' }
-
-  const context = match.startsWith('frame:') ? 'frame' : 'top'
-  let pattern = context === 'frame' ? match.replace('frame:', '') : match
-
-  if (pattern === '<allUrls>') return { context, value: '<all_urls>' }
-  if (pattern === '<all_urls>') throw new Error(`Use '<allUrls>' instead of '<all_urls>'`)
-
-  if (pattern.startsWith('exact:')) {
-    return { context, value: parseMatchPattern(pattern.replace('exact:', '')) }
-  }
-
-  // Ensure pattern url has a path: `*://example.com` -> `*://example.com/`
-  const href = pattern.replaceAll('*', 'wildcard--')
-  if (!URL.canParse(href)) throw new Error(`Invalid match pattern: '${match}'`)
-  const url = new URL(href)
-  if (url.pathname === '') url.pathname = '/'
-  pattern = url.href.replaceAll('wildcard--', '*')
-
-  return [
-    { context, value: parseMatchPattern(pattern) },
-    { context, value: parseMatchPattern(`${pattern}?*`) },
-  ]
-}
-
-function parseMatchPattern(pattern: string): MatchPattern {
-  const matcher = matchPattern(pattern)
-  if (!matcher.valid) throw new Error(`Invalid match pattern: '${pattern}'`)
-  return pattern
-}
-
-function parseResources(target: Obj) {
-  const load = ensureArray(target.load ?? [])
-  if (!isArrayOfStrings(load)) throw new Error(`'load' must be an array of strings`)
-  return load.map(loadEntry => parseResource(loadEntry))
-}
-
-function parseResource(loadEntry: string): Resource {
-  const isJs = loadEntry.toLowerCase().endsWith('.js')
-  const isCss = loadEntry.toLowerCase().endsWith('.css')
-  if (!isJs && !isCss) throw new Error(`Invalid 'load' file, must be JS or CSS: '${loadEntry}'`)
-
-  if (loadEntry.startsWith('lite:')) {
-    if (!isJs) throw new Error(`'lite:' resources must be JS files: '${loadEntry}'`)
-    return { path: loadEntry.replace('lite:', ''), type: 'lite-js' }
-  } else if (loadEntry.startsWith('shadow:')) {
-    if (!isCss) throw new Error(`'shadow:' resources must be CSS files: '${loadEntry}'`)
-    return { path: loadEntry.replace('shadow:', ''), type: 'shadow-css' }
-  } else {
-    return { path: loadEntry, type: isJs ? 'js' : 'css' }
-  }
-}
-
-function parsePermissions(spec: Obj): Permissions {
-  const permissions = spec.permissions ?? []
-  if (!isArrayOfStrings(permissions)) throw new Error(`'permissions' must be an array of strings`)
-
-  const badPermission = permissions.find(value => !schema.permissions.includes(value))
-  if (badPermission) throw new Error(`Unknown permission: '${badPermission}'`)
-
-  const mandatoryPermissions = new Set<string>()
-  const optionalPermissions = new Set<string>()
-  for (const permission of permissions) {
-    if (permission.startsWith('optional:')) {
-      optionalPermissions.add(permission.replace('optional:', ''))
-    } else {
-      mandatoryPermissions.add(permission)
-    }
-  }
-
-  for (const permission of mandatoryPermissions) {
-    if (optionalPermissions.has(permission)) {
-      throw new Error(`Permission cannot be both mandatory and optional: '${permission}'`)
-    }
-  }
-
-  return {
-    mandatory: [...mandatoryPermissions] as Permission[],
-    optional: [...optionalPermissions] as Permission[],
-  }
-}
-
-function parseManifest(spec: Obj): Manifest | null {
-  if (!('manifest' in spec)) return null
-  if (!is.object(spec.manifest)) throw new Error(`'manifest' must be an object`)
-  return spec.manifest
-}
-
-// ---------------------------------------------------------------------------
-// HELPERS
-// ---------------------------------------------------------------------------
-
-function isArrayOfStrings(value: unknown) {
-  return is.array(value) && value.every(is.string)
-}
-
-function isValidUrl(value: unknown) {
-  if (!is.string(value)) return false
-  return URL.canParse(value)
-}
-
-/**
- * - 'path/to' -> 'path/to'
- * - 'path/to/' -> 'path/to'
- * - '/path/to' -> 'path/to'
- * - 'path//to' -> 'path/to'
- * - 'path/./to' -> 'path/to'
- * - './path/to' -> 'path/to'
- * - 'path/../to' -> 'path/../to'
- * - '../path/to' -> throw
- */
-function parsePath(path: string) {
-  const normalizedPath = path
-    .split('/')
-    .filter(path => path && path !== '.')
-    .join('/')
-
-  if (normalizedPath.startsWith('..')) throw new Error(`External paths are not allowed: '${path}'`)
-
-  return normalizedPath
-}
-
-export default parseSpec