@dpuse/dpuse-development 1.0.124 → 1.0.127

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -69,8 +69,32 @@ jobs:
69
69
  - name: Lint
70
70
  run: npm run lint
71
71
 
72
+ # Only in projects with end-to-end tests. 'vite.config.ts' serves over HTTPS with a certificate from
73
+ # '../../localhost/', which exists only on a developer's machine, so the runner gets a throwaway self-signed one
74
+ # at the same path. 'playwright.config.ts' accepts it on CI.
75
+ - name: Create localhost certificate
76
+ if: hashFiles('playwright.config.ts') != ''
77
+ run: |
78
+ mkdir -p ../../localhost
79
+ openssl req -x509 -newkey rsa:2048 -nodes -days 1 -subj "/CN=localhost" -keyout ../../localhost/localhost+1-key.pem -out ../../localhost/localhost+1.pem
80
+
81
+ # Only in projects with end-to-end tests. Chromium alone, which is all 'playwright.config.ts' runs on CI.
82
+ - name: Install Playwright browsers
83
+ if: hashFiles('playwright.config.ts') != ''
84
+ run: npx playwright install --with-deps chromium
85
+
72
86
  - name: Test
73
87
  run: npm test
74
88
 
89
+ # Only in projects with end-to-end tests, and only when a step fails. Playwright saves a trace of each failed
90
+ # test in 'test-results/', which the runner discards. Kept for a week, to open with 'npx playwright show-trace'.
91
+ - name: Upload Playwright results
92
+ if: failure() && hashFiles('playwright.config.ts') != ''
93
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
94
+ with:
95
+ name: playwright-results
96
+ path: test-results/
97
+ retention-days: 7
98
+
75
99
  - name: Audit
76
100
  run: npm run audit
@@ -71,9 +71,33 @@ jobs:
71
71
  - name: Lint
72
72
  run: npm run lint
73
73
 
74
+ # Only in projects with end-to-end tests. 'vite.config.ts' serves over HTTPS with a certificate from
75
+ # '../../localhost/', which exists only on a developer's machine, so the runner gets a throwaway self-signed one
76
+ # at the same path. 'playwright.config.ts' accepts it on CI.
77
+ - name: Create localhost certificate
78
+ if: hashFiles('playwright.config.ts') != ''
79
+ run: |
80
+ mkdir -p ../../localhost
81
+ openssl req -x509 -newkey rsa:2048 -nodes -days 1 -subj "/CN=localhost" -keyout ../../localhost/localhost+1-key.pem -out ../../localhost/localhost+1.pem
82
+
83
+ # Only in projects with end-to-end tests. Chromium alone, which is all 'playwright.config.ts' runs on CI.
84
+ - name: Install Playwright browsers
85
+ if: hashFiles('playwright.config.ts') != ''
86
+ run: npx playwright install --with-deps chromium
87
+
74
88
  - name: Test
75
89
  run: npm test
76
90
 
91
+ # Only in projects with end-to-end tests, and only when a step fails. Playwright saves a trace of each failed
92
+ # test in 'test-results/', which the runner discards. Kept for a week, to open with 'npx playwright show-trace'.
93
+ - name: Upload Playwright results
94
+ if: failure() && hashFiles('playwright.config.ts') != ''
95
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
96
+ with:
97
+ name: playwright-results
98
+ path: test-results/
99
+ retention-days: 7
100
+
77
101
  # One step for every project: the action publishes to npm, uploads to DPUse, or both, as the module type requires.
78
102
  # Called directly rather than through a package.json script, as a script named 'publish' would be run again by
79
103
  # 'npm publish' itself. The project's own commands, such as 'wrangler', are put on the path first, which
package/README.md CHANGED
@@ -98,12 +98,12 @@ _Note: Sonda's Vite reports currently exclude CSS files, since Vite does not gen
98
98
  |         ↳ 8 smaller files | `▒░░░░░░░░░░░░░░░░░░░` 4.3% · 2.8 kB |
99
99
  |     (inlined worker) | `░░░░░░░░░░░░░░░░░░░░` 0.0% · 17 B |
100
100
  |     (bundler output, whitespace & JSON) | `██░░░░░░░░░░░░░░░░░░` 11.7% · 7.6 kB |
101
- | **dist/utilities-CjhO3pxf.js** | 23.1 kB · gzip 6.4 kB · 23.3% of the build |
102
- |     @dpuse/dpuse-shared → dist/dpuse-shared.es.js | `██████████░░░░░░░░░░` 50.8% · 11.8 kB |
103
- |     src → index.ts | `███████░░░░░░░░░░░░░` 35.8% · 8.3 kB |
101
+ | **dist/utilities-Bqc7DQXv.js** | 23.2 kB · gzip 6.5 kB · 23.4% of the build |
102
+ |     @dpuse/dpuse-shared → dist/dpuse-shared.es.js | `██████████░░░░░░░░░░` 50.9% · 11.8 kB |
103
+ |     src → index.ts | `███████░░░░░░░░░░░░░` 35.7% · 8.3 kB |
104
104
  |     valibot → dist/index.mjs | `░░░░░░░░░░░░░░░░░░░░` 1.7% · 413 B |
105
105
  |     (bundler output, whitespace & JSON) | `██░░░░░░░░░░░░░░░░░░` 11.6% · 2.7 kB |
106
- | **dist/apiReference-D4xooSV0.js** | 8.5 kB · gzip 3.1 kB · 8.5% of the build |
106
+ | **dist/apiReference-C2-jo0bP.js** | 8.5 kB · gzip 3.1 kB · 8.5% of the build |
107
107
  |     src → apiReference.ts | `███████████████████░` 95.1% · 8.0 kB |
108
108
  |     (bundler output, whitespace & JSON) | `█░░░░░░░░░░░░░░░░░░░` 4.9% · 427 B |
109
109
  | **dist/vite.es.js** | 2.5 kB · gzip 1.1 kB · 2.5% of the build |
@@ -166,9 +166,6 @@ This section is updated each time `npm run document` is run. Settings come from
166
166
 
167
167
  This project is working towards the [OpenSSF Best Practices](https://www.bestpractices.dev) Passing badge, a self-certification covering security policy, vulnerability reporting, build processes, code quality, and more. Currently the [OpenSSF Scorecard](https://scorecard.dev) provides an independent automated assessment of the project's security practices and is an ongoing area of improvement.
168
168
 
169
- > [!NOTE]
170
- > Apart from the Best Practices badge above, the remaining Scorecard gaps need multi-person review or a pull-request workflow, which this solo-maintained project doesn't use.
171
-
172
169
  ### Reporting Vulnerabilities
173
170
 
174
171
  Please do not open public GitHub issues for security vulnerabilities. Use [GitHub private vulnerability reporting](https://github.com/dpuse/dpuse-development/security/advisories/new) instead. See [SECURITY.md](./SECURITY.md) for the full disclosure policy, contact details, and expected response times.
@@ -1,4 +1,4 @@
1
- import { A as e, x as t, y as n } from "./utilities-CjhO3pxf.js";
1
+ import { A as e, x as t, y as n } from "./utilities-Bqc7DQXv.js";
2
2
  import r from "node:path";
3
3
  import i from "typescript";
4
4
  //#region src/utilities/apiReference.ts
@@ -1 +1 @@
1
- {"version":3,"file":"apiReference-D4xooSV0.js","names":["writeTextFile","readJSONFile","logStepHeader","path","ts","TOPIC_GROUPING_MINIMUM","GENERAL_TOPIC","EXPORT_KINDS","API_REFERENCE_INTRO","writeAPIReference","stepIcon","apiReferencePath","entryPoints","resolveEntryPoints","program","sourcePath","readCompilerOptions","checker","fieldGroupOwners","mapFieldGroupOwners","sections","sourceFile","importPath","buildSection","listExports","packageName","packageJSON","exportsField","exportEntries","subpath","target","typesPath","\"types\"","configPath","fileName","config","moduleSymbol","symbol","resolveAlias","exportedSymbol","entry","describeExport","formatExportName","readDescription","readTopic","a","b","resolvePath","unresolvedPath","folder","segment","letter","signature","isSchema","name","formatParameter","parameter","formatOrigin","formatConstantType","description","declaration","variableDeclaration","initializer","isWrittenAs","typeNode","formatTypeNode","clauses","clause","formatCode","type","typeAlias","schemaName","findSchemaName","fields","findSchemaFields","parents","findSchemaParents","parent","group","property","resolveObjectLiteral","owner","typeName","candidates","typeAliases","statement","listFieldGroups","owners","groupCandidates","fewestAdded","addedFieldCount","tied","ownGroup","spreadGroups","argument","isTypeReferenceNamed","returnTypeArgument","fieldsQuery","schema","resolveInitializer","node","declarationName","parameterDeclaration","isOptional","typeText","formatParameterName","names","element","topics","entries","compareTopics","buildKindLists","topicSections","topic","items","kind","formatEntry","headingLevel","detailCode","detail","firstLine","origin","text"],"sources":["../src/utilities/apiReference.ts"],"sourcesContent":["// ── External Dependencies & Registrations\nimport type { PackageJson } from 'type-fest';\nimport path from 'node:path';\nimport ts from 'typescript';\n\n// ── Local Framework\nimport { logStepHeader, readJSONFile, writeTextFile } from '@/utilities';\n\n// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\ninterface ExportEntry {\n description: string | undefined;\n detail: string; // What follows the name in code, such as a function's parameters or a constant's type.\n kind: ExportKind;\n name: string;\n origin: string;\n topic: string; // The folder the export is declared in, such as 'Component › Module › Connector'.\n}\n\ntype ExportKind = 'Classes' | 'Constants' | 'Functions' | 'Schemas' | 'Types';\n\n// ── Constants ────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// An import path whose exports come from at least this many folders is listed by folder, so a package with one entry\n// point for everything still reads as topics rather than one long list.\nconst TOPIC_GROUPING_MINIMUM = 3;\n\n// Declared directly in the source folder, rather than in a topic folder within it.\nconst GENERAL_TOPIC = 'General';\n\n// In the order each import path's section lists them.\nconst EXPORT_KINDS: ExportKind[] = ['Functions', 'Classes', 'Constants', 'Schemas', 'Types'];\n\nconst API_REFERENCE_INTRO = 'Every export, grouped by import path. This file is updated each time `npm run document` is run, and with each release.';\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Lists the exports of each import path in package.json 'exports', read from the TypeScript source the path's types are\n// built from. Paths without types, such as a shared config file, are left out. This module is loaded only when the API\n// reference is written, as TypeScript is an optional peer.\nexport async function writeAPIReference(stepIcon: string, apiReferencePath: string): Promise<void> {\n logStepHeader(`${stepIcon} Write '${apiReferencePath}'`);\n\n const packageJSON = await readJSONFile<PackageJson>('package.json');\n const entryPoints = resolveEntryPoints(packageJSON);\n if (entryPoints.length === 0) throw new Error(\"package.json 'exports' must name at least one import path with types to document the API reference.\");\n\n // Absolute paths, as TypeScript keeps the working directory it first saw, so relative ones could resolve against a\n // folder the process has since left.\n const program = ts.createProgram(\n entryPoints.map(({ sourcePath }) => path.resolve(sourcePath)),\n readCompilerOptions()\n );\n const checker = program.getTypeChecker();\n const fieldGroupOwners = mapFieldGroupOwners(program, checker);\n\n const sections = entryPoints.map(({ importPath, sourcePath }) => {\n const sourceFile = program.getSourceFile(path.resolve(sourcePath));\n if (sourceFile === undefined) throw new Error(`Unable to read '${sourcePath}', the source of '${importPath}'.`);\n return buildSection(importPath, listExports(checker, sourceFile, fieldGroupOwners));\n });\n\n await writeTextFile(apiReferencePath, `# API Reference\\n\\n${API_REFERENCE_INTRO}\\n\\n${sections.join('\\n\\n')}\\n`);\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// The types path of each export, such as './dist/types/src/errors/index.d.ts', mirrors its source file\n// ('src/errors/index.ts'), so the source is found by stripping the output folder and swapping the extension.\nfunction resolveEntryPoints(packageJSON: PackageJson): { importPath: string; sourcePath: string }[] {\n const packageName = packageJSON.name ?? '';\n const exportsField = packageJSON.exports;\n const exportEntries = exportsField != null && typeof exportsField === 'object' && !Array.isArray(exportsField) ? Object.entries(exportsField) : [];\n\n const entryPoints: { importPath: string; sourcePath: string }[] = [];\n for (const [subpath, target] of exportEntries) {\n const typesPath = target != null && typeof target === 'object' && !Array.isArray(target) ? target['types'] : undefined;\n if (typeof typesPath !== 'string') continue;\n const importPath = subpath === '.' ? packageName : `${packageName}${subpath.slice(1)}`;\n const sourcePath = typesPath.replace(/^\\.\\/dist\\/types\\//, '').replace(/\\.d\\.ts$/, '.ts');\n entryPoints.push({ importPath, sourcePath });\n }\n return entryPoints;\n}\n\n// Uses the project's own tsconfig, so '@/' and other path aliases resolve as they do in the build.\nfunction readCompilerOptions(): ts.CompilerOptions {\n const configPath = ts.findConfigFile(process.cwd(), (fileName) => ts.sys.fileExists(fileName));\n if (configPath === undefined) return { module: ts.ModuleKind.ESNext, moduleResolution: ts.ModuleResolutionKind.Bundler, target: ts.ScriptTarget.ESNext };\n\n const { config } = ts.readConfigFile(configPath, (fileName) => ts.sys.readFile(fileName)) as { config: unknown };\n return ts.parseJsonConfigFileContent(config, ts.sys, process.cwd()).options;\n}\n\nfunction listExports(checker: ts.TypeChecker, sourceFile: ts.SourceFile, fieldGroupOwners: Map<ts.ObjectLiteralExpression, string>): ExportEntry[] {\n const moduleSymbol = checker.getSymbolAtLocation(sourceFile);\n const exportedSymbols = moduleSymbol === undefined ? [] : checker.getExportsOfModule(moduleSymbol);\n\n const entries = exportedSymbols.flatMap((exportedSymbol) => {\n const symbol = resolveAlias(checker, exportedSymbol);\n const entry = describeExport(checker, formatExportName(exportedSymbol, symbol), symbol, fieldGroupOwners);\n return entry === undefined ? [] : { ...entry, description: readDescription(checker, symbol), topic: readTopic(symbol) };\n });\n return entries.toSorted((a, b) => a.name.localeCompare(b.name));\n}\n\n// Named from the folders between 'src' and the file declaring the export: 'component/module/connector' reads as\n// 'Component › Module › Connector', with camel-case names split into words.\nfunction readTopic(symbol: ts.Symbol): string {\n const fileName = symbol.declarations?.[0]?.getSourceFile().fileName;\n if (fileName === undefined) return GENERAL_TOPIC;\n\n // TypeScript reports files with symbolic links resolved (on macOS, '/var' is really '/private/var'), so the source\n // folder is resolved the same way before the two are compared.\n const resolvePath = (unresolvedPath: string): string => ts.sys.realpath?.(unresolvedPath) ?? unresolvedPath;\n const folder = path.relative(resolvePath(path.join(process.cwd(), 'src')), resolvePath(path.dirname(fileName)));\n return folder === '' || folder.startsWith('..')\n ? GENERAL_TOPIC\n : folder\n .split(path.sep)\n .map((segment) => segment.replaceAll(/([a-z])([A-Z])/g, '$1 $2').replace(/^./, (letter) => letter.toUpperCase()))\n .join(' › ');\n}\n\n// Functions include constants holding a function, as with arrow functions. Schemas are the constants named '…Schema'.\nfunction describeExport(\n checker: ts.TypeChecker,\n name: string,\n symbol: ts.Symbol,\n fieldGroupOwners: Map<ts.ObjectLiteralExpression, string>\n): Omit<ExportEntry, 'description' | 'topic'> | undefined {\n const isValue = (symbol.flags & (ts.SymbolFlags.Function | ts.SymbolFlags.Variable)) !== 0;\n const [signature] = isValue ? checker.getSignaturesOfType(checker.getTypeOfSymbol(symbol), ts.SignatureKind.Call) : [];\n const isSchema = name.endsWith('Schema');\n\n if (signature !== undefined && !isSchema) {\n const parameters = signature.parameters.map((parameter) => formatParameter(checker, parameter));\n return { detail: `(${parameters.join(', ')})`, kind: 'Functions', name, origin: '' };\n }\n if ((symbol.flags & ts.SymbolFlags.Class) !== 0) return { detail: '', kind: 'Classes', name, origin: formatOrigin(checker, symbol, fieldGroupOwners) };\n if (isSchema && (symbol.flags & ts.SymbolFlags.Variable) !== 0) return { detail: '', kind: 'Schemas', name, origin: '' };\n if ((symbol.flags & ts.SymbolFlags.Variable) !== 0) return { detail: `: ${formatConstantType(checker, symbol)}`, kind: 'Constants', name, origin: '' };\n const isType = (symbol.flags & (ts.SymbolFlags.Enum | ts.SymbolFlags.Interface | ts.SymbolFlags.TypeAlias)) !== 0;\n return isType ? { detail: '', kind: 'Types', name, origin: formatOrigin(checker, symbol, fieldGroupOwners) } : undefined;\n}\n\n// The summary of the '/** … */' comment above the item, on one line. Tags such as '@param' are left out, and '//'\n// comments, which are notes for maintainers, are never read.\nfunction readDescription(checker: ts.TypeChecker, symbol: ts.Symbol): string | undefined {\n const description = ts.displayPartsToString(symbol.getDocumentationComment(checker)).replaceAll(/\\s+/g, ' ').trim();\n return description === '' ? undefined : description;\n}\n\n// The type as written, on the declaration or in an 'as' on its value, which keeps the names it was written with. Where\n// none is written, the inferred type is widened, so 'MAX_COUNT = 3' reads as 'number' rather than '3'.\nfunction formatConstantType(checker: ts.TypeChecker, symbol: ts.Symbol): string {\n const declaration = symbol.valueDeclaration;\n const variableDeclaration = declaration !== undefined && ts.isVariableDeclaration(declaration) ? declaration : undefined;\n const initializer = variableDeclaration?.initializer;\n const isWrittenAs = initializer !== undefined && ts.isAsExpression(initializer) && !ts.isConstTypeReference(initializer.type); // 'as const' names no type.\n const typeNode = variableDeclaration?.type ?? (isWrittenAs ? initializer.type : undefined);\n return typeNode === undefined ? checker.typeToString(checker.getBaseTypeOfLiteralType(checker.getTypeOfSymbol(symbol)), declaration) : formatTypeNode(typeNode);\n}\n\n// What a type or class comes from: the schema it is inferred from, and what it extends or implements, such as\n// ' (extends DPUseError)'. A type inferred from a schema has no 'extends' clause, so its parent is found from the schema\n// instead. The parent is named even when it is not exported, as it is still what the type inherits from.\nfunction formatOrigin(checker: ts.TypeChecker, symbol: ts.Symbol, fieldGroupOwners: Map<ts.ObjectLiteralExpression, string>): string {\n const heritageClauses = (symbol.declarations ?? []).flatMap((declaration) =>\n ts.isClassDeclaration(declaration) || ts.isInterfaceDeclaration(declaration) ? [...(declaration.heritageClauses ?? [])] : []\n );\n const clauses = heritageClauses.map((clause) => {\n const keyword = clause.token === ts.SyntaxKind.ExtendsKeyword ? 'extends' : 'implements';\n return `${keyword} ${clause.types.map((type) => formatCode(formatTypeNode(type))).join(', ')}`;\n });\n\n const typeAlias = symbol.declarations?.find((declaration) => ts.isTypeAliasDeclaration(declaration));\n const schemaName = typeAlias === undefined ? undefined : findSchemaName(typeAlias);\n if (typeAlias !== undefined && schemaName !== undefined) {\n clauses.push(`inferred from ${formatCode(schemaName.getText())}`);\n const fields = findSchemaFields(checker, typeAlias);\n const parents = fields === undefined ? [] : findSchemaParents(checker, fields, typeAlias.name.text, fieldGroupOwners);\n if (parents.length > 0) clauses.push(`extends ${parents.map((parent) => formatCode(parent)).join(', ')}`);\n }\n return clauses.length === 0 ? '' : ` (${clauses.join(', ')})`;\n}\n\n// A schema inherits by spreading in a group of fields, as in 'strictObject({ ...moduleConfigCoreFields, … })'. Where\n// the type owns the group it spreads, as 'ModuleConfig' owns 'moduleConfigCoreFields', its parent is found in that\n// group's own spreads.\nfunction findSchemaParents(checker: ts.TypeChecker, fields: ts.ObjectLiteralExpression, typeName: string, fieldGroupOwners: Map<ts.ObjectLiteralExpression, string>): string[] {\n return fields.properties.flatMap((property) => {\n const group = ts.isSpreadAssignment(property) ? resolveObjectLiteral(checker, property.expression) : undefined;\n if (group === undefined) return [];\n const owner = fieldGroupOwners.get(group);\n if (owner === typeName) return findSchemaParents(checker, group, typeName, fieldGroupOwners);\n return owner === undefined ? [] : [owner];\n });\n}\n\n// A field group is not a type, so it is named by the type whose schema adds the fewest fields to it. Where two types\n// tie, the group is left unnamed rather than guessed at.\nfunction mapFieldGroupOwners(program: ts.Program, checker: ts.TypeChecker): Map<ts.ObjectLiteralExpression, string> {\n const candidates = new Map<ts.ObjectLiteralExpression, { addedFieldCount: number; typeName: string }[]>();\n const typeAliases = program\n .getSourceFiles()\n .filter((sourceFile) => !sourceFile.isDeclarationFile && !program.isSourceFileFromExternalLibrary(sourceFile))\n .flatMap((sourceFile) => sourceFile.statements.filter((statement) => ts.isTypeAliasDeclaration(statement)));\n\n for (const typeAlias of typeAliases) {\n for (const { addedFieldCount, group } of listFieldGroups(checker, typeAlias)) {\n candidates.set(group, [...(candidates.get(group) ?? []), { addedFieldCount, typeName: typeAlias.name.text }]);\n }\n }\n\n const owners = new Map<ts.ObjectLiteralExpression, string>();\n for (const [group, groupCandidates] of candidates) {\n const fewestAdded = Math.min(...groupCandidates.map(({ addedFieldCount }) => addedFieldCount));\n const [owner, ...tied] = groupCandidates.filter(({ addedFieldCount }) => addedFieldCount === fewestAdded);\n if (owner !== undefined && tied.length === 0) owners.set(group, owner.typeName);\n }\n return owners;\n}\n\n// Each field group a type's schema is built from, with the number of fields the schema adds to it.\nfunction listFieldGroups(checker: ts.TypeChecker, typeAlias: ts.TypeAliasDeclaration): { addedFieldCount: number; group: ts.ObjectLiteralExpression }[] {\n const fields = findSchemaFields(checker, typeAlias);\n if (fields === undefined) return [];\n\n // Fields declared under a name of their own, rather than written inside the schema, are a group themselves.\n const ownGroup = ts.isVariableDeclaration(fields.parent) ? [{ addedFieldCount: 0, group: fields }] : [];\n const spreadGroups = fields.properties.flatMap((property) => {\n const group = ts.isSpreadAssignment(property) ? resolveObjectLiteral(checker, property.expression) : undefined;\n return group === undefined ? [] : [{ addedFieldCount: fields.properties.length - 1, group }];\n });\n return [...ownGroup, ...spreadGroups];\n}\n\n// The schema a type is inferred from, written either as 'InferOutput<typeof schema>' or, where the schema is built in\n// place from a group of fields, as 'InferOutput<ReturnType<typeof strictObject<typeof fields>>>'.\nfunction findSchemaName(typeAlias: ts.TypeAliasDeclaration): ts.EntityName | undefined {\n const [argument] = isTypeReferenceNamed(typeAlias.type, 'InferOutput') ? (typeAlias.type.typeArguments ?? []) : [];\n if (argument === undefined) return undefined;\n if (ts.isTypeQueryNode(argument)) return argument.exprName;\n\n const [returnTypeArgument] = isTypeReferenceNamed(argument, 'ReturnType') ? (argument.typeArguments ?? []) : [];\n const [fieldsQuery] = returnTypeArgument !== undefined && ts.isTypeQueryNode(returnTypeArgument) ? (returnTypeArgument.typeArguments ?? []) : [];\n return fieldsQuery !== undefined && ts.isTypeQueryNode(fieldsQuery) ? fieldsQuery.exprName : undefined;\n}\n\n// The fields of the schema a type is inferred from: those passed to 'strictObject({ … })', or the group of fields itself.\nfunction findSchemaFields(checker: ts.TypeChecker, typeAlias: ts.TypeAliasDeclaration): ts.ObjectLiteralExpression | undefined {\n const schemaName = findSchemaName(typeAlias);\n const schema = schemaName === undefined ? undefined : resolveInitializer(checker, schemaName);\n if (schema === undefined) return undefined;\n if (ts.isObjectLiteralExpression(schema)) return schema;\n\n const [fields] = ts.isCallExpression(schema) ? schema.arguments : [];\n return fields === undefined ? undefined : resolveObjectLiteral(checker, fields);\n}\n\nfunction isTypeReferenceNamed(node: ts.TypeNode, name: string): node is ts.TypeReferenceNode {\n if (!ts.isTypeReferenceNode(node)) return false;\n const typeName = ts.isQualifiedName(node.typeName) ? node.typeName.right : node.typeName;\n return typeName.text === name;\n}\n\nfunction resolveObjectLiteral(checker: ts.TypeChecker, node: ts.Node): ts.ObjectLiteralExpression | undefined {\n if (ts.isObjectLiteralExpression(node)) return node;\n const initializer = resolveInitializer(checker, node);\n return initializer !== undefined && ts.isObjectLiteralExpression(initializer) ? initializer : undefined;\n}\n\n// The value a name was declared with, following imports back to the declaration.\nfunction resolveInitializer(checker: ts.TypeChecker, name: ts.Node): ts.Expression | undefined {\n const symbol = checker.getSymbolAtLocation(name);\n const declaration = symbol === undefined ? undefined : resolveAlias(checker, symbol).valueDeclaration;\n return declaration !== undefined && ts.isVariableDeclaration(declaration) ? declaration.initializer : undefined;\n}\n\nfunction resolveAlias(checker: ts.TypeChecker, symbol: ts.Symbol): ts.Symbol {\n return (symbol.flags & ts.SymbolFlags.Alias) === 0 ? symbol : checker.getAliasedSymbol(symbol);\n}\n\n// A default export is imported under any name, so the name it has where it is declared is shown alongside.\nfunction formatExportName(exportedSymbol: ts.Symbol, symbol: ts.Symbol): string {\n if (exportedSymbol.name !== 'default') return exportedSymbol.name;\n const declarationName = symbol.declarations?.map((declaration) => ts.getNameOfDeclaration(declaration)?.getText()).find((name) => name !== undefined);\n return declarationName === undefined || declarationName === 'default' ? 'default' : `default (${declarationName})`;\n}\n\n// A parameter that can be left out, being optional or having a default, is marked with '?'. Its type is as written, or\n// inferred where none is, as with a default value.\nfunction formatParameter(checker: ts.TypeChecker, parameter: ts.Symbol): string {\n const declaration = parameter.valueDeclaration;\n const parameterDeclaration = declaration !== undefined && ts.isParameter(declaration) ? declaration : undefined;\n const isOptional = parameterDeclaration?.questionToken !== undefined || parameterDeclaration?.initializer !== undefined;\n const typeText = parameterDeclaration?.type === undefined ? checker.typeToString(checker.getTypeOfSymbol(parameter), declaration) : formatTypeNode(parameterDeclaration.type);\n const name = parameterDeclaration === undefined ? parameter.name : formatParameterName(parameterDeclaration.name);\n return `${name}${isOptional ? '?' : ''}: ${typeText}`;\n}\n\n// A destructured parameter has no name of its own, so TypeScript calls it '__0'. It is shown by the names it unpacks\n// instead, as '{ allowedLicenses, moduleLevel }', leaving out their defaults.\nfunction formatParameterName(name: ts.BindingName): string {\n if (ts.isIdentifier(name)) return name.text;\n const names = name.elements.flatMap((element) =>\n ts.isBindingElement(element) ? [(element.dotDotDotToken === undefined ? '' : '...') + formatParameterName(element.name)] : []\n );\n return ts.isObjectBindingPattern(name) ? `{ ${names.join(', ')} }` : `[${names.join(', ')}]`;\n}\n\n// A type written across several lines is shown on one.\nfunction formatTypeNode(typeNode: ts.TypeNode): string {\n return typeNode.getText().replaceAll(/\\s+/g, ' ');\n}\n\nfunction buildSection(importPath: string, entries: ExportEntry[]): string {\n const topics = [...new Set(entries.map((entry) => entry.topic))].toSorted(compareTopics);\n if (topics.length < TOPIC_GROUPING_MINIMUM) return [`## ${importPath}`, ...buildKindLists(entries, '###')].join('\\n\\n');\n\n const topicSections = topics.map((topic) =>\n [\n `### ${topic}`,\n ...buildKindLists(\n entries.filter((entry) => entry.topic === topic),\n '####'\n )\n ].join('\\n\\n')\n );\n return [`## ${importPath}`, ...topicSections].join('\\n\\n');\n}\n\n// General comes first, as it holds what the whole package shares; the rest are alphabetical.\nfunction compareTopics(a: string, b: string): number {\n const isEitherGeneral = a === GENERAL_TOPIC || b === GENERAL_TOPIC;\n return isEitherGeneral ? Number(b === GENERAL_TOPIC) - Number(a === GENERAL_TOPIC) : a.localeCompare(b);\n}\n\nfunction buildKindLists(entries: ExportEntry[], headingLevel: string): string[] {\n return EXPORT_KINDS.flatMap((kind) => {\n const items = entries.filter((entry) => entry.kind === kind).map((entry) => formatEntry(entry));\n return items.length === 0 ? [] : `${headingLevel} ${kind}\\n\\n${items.join('\\n')}`;\n });\n}\n\n// The name and what follows it are code, shown on a shaded background, with only the name bold so it stands out from\n// its parameters or type. The description is a quote nested in the item, which indents every line of it and shows it\n// in lighter text, so the names can be read straight down the left.\nfunction formatEntry({ description, detail, name, origin }: ExportEntry): string {\n const detailCode = detail === '' ? '' : formatCode(detail);\n const firstLine = `- **${formatCode(name)}**${detailCode}${origin}`;\n return description === undefined ? firstLine : `${firstLine}\\n > ${description}`;\n}\n\nfunction formatCode(text: string): string {\n return `\\`${text}\\``;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"apiReference-C2-jo0bP.js","names":["writeTextFile","readJSONFile","logStepHeader","path","ts","TOPIC_GROUPING_MINIMUM","GENERAL_TOPIC","EXPORT_KINDS","API_REFERENCE_INTRO","writeAPIReference","stepIcon","apiReferencePath","entryPoints","resolveEntryPoints","program","sourcePath","readCompilerOptions","checker","fieldGroupOwners","mapFieldGroupOwners","sections","sourceFile","importPath","buildSection","listExports","packageName","packageJSON","exportsField","exportEntries","subpath","target","typesPath","\"types\"","configPath","fileName","config","moduleSymbol","symbol","resolveAlias","exportedSymbol","entry","describeExport","formatExportName","readDescription","readTopic","a","b","resolvePath","unresolvedPath","folder","segment","letter","signature","isSchema","name","formatParameter","parameter","formatOrigin","formatConstantType","description","declaration","variableDeclaration","initializer","isWrittenAs","typeNode","formatTypeNode","clauses","clause","formatCode","type","typeAlias","schemaName","findSchemaName","fields","findSchemaFields","parents","findSchemaParents","parent","group","property","resolveObjectLiteral","owner","typeName","candidates","typeAliases","statement","listFieldGroups","owners","groupCandidates","fewestAdded","addedFieldCount","tied","ownGroup","spreadGroups","argument","isTypeReferenceNamed","returnTypeArgument","fieldsQuery","schema","resolveInitializer","node","declarationName","parameterDeclaration","isOptional","typeText","formatParameterName","names","element","topics","entries","compareTopics","buildKindLists","topicSections","topic","items","kind","formatEntry","headingLevel","detailCode","detail","firstLine","origin","text"],"sources":["../src/utilities/apiReference.ts"],"sourcesContent":["// ── External Dependencies & Registrations\nimport type { PackageJson } from 'type-fest';\nimport path from 'node:path';\nimport ts from 'typescript';\n\n// ── Local Framework\nimport { logStepHeader, readJSONFile, writeTextFile } from '@/utilities';\n\n// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\ninterface ExportEntry {\n description: string | undefined;\n detail: string; // What follows the name in code, such as a function's parameters or a constant's type.\n kind: ExportKind;\n name: string;\n origin: string;\n topic: string; // The folder the export is declared in, such as 'Component › Module › Connector'.\n}\n\ntype ExportKind = 'Classes' | 'Constants' | 'Functions' | 'Schemas' | 'Types';\n\n// ── Constants ────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// An import path whose exports come from at least this many folders is listed by folder, so a package with one entry\n// point for everything still reads as topics rather than one long list.\nconst TOPIC_GROUPING_MINIMUM = 3;\n\n// Declared directly in the source folder, rather than in a topic folder within it.\nconst GENERAL_TOPIC = 'General';\n\n// In the order each import path's section lists them.\nconst EXPORT_KINDS: ExportKind[] = ['Functions', 'Classes', 'Constants', 'Schemas', 'Types'];\n\nconst API_REFERENCE_INTRO = 'Every export, grouped by import path. This file is updated each time `npm run document` is run, and with each release.';\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Lists the exports of each import path in package.json 'exports', read from the TypeScript source the path's types are\n// built from. Paths without types, such as a shared config file, are left out. This module is loaded only when the API\n// reference is written, as TypeScript is an optional peer.\nexport async function writeAPIReference(stepIcon: string, apiReferencePath: string): Promise<void> {\n logStepHeader(`${stepIcon} Write '${apiReferencePath}'`);\n\n const packageJSON = await readJSONFile<PackageJson>('package.json');\n const entryPoints = resolveEntryPoints(packageJSON);\n if (entryPoints.length === 0) throw new Error(\"package.json 'exports' must name at least one import path with types to document the API reference.\");\n\n // Absolute paths, as TypeScript keeps the working directory it first saw, so relative ones could resolve against a\n // folder the process has since left.\n const program = ts.createProgram(\n entryPoints.map(({ sourcePath }) => path.resolve(sourcePath)),\n readCompilerOptions()\n );\n const checker = program.getTypeChecker();\n const fieldGroupOwners = mapFieldGroupOwners(program, checker);\n\n const sections = entryPoints.map(({ importPath, sourcePath }) => {\n const sourceFile = program.getSourceFile(path.resolve(sourcePath));\n if (sourceFile === undefined) throw new Error(`Unable to read '${sourcePath}', the source of '${importPath}'.`);\n return buildSection(importPath, listExports(checker, sourceFile, fieldGroupOwners));\n });\n\n await writeTextFile(apiReferencePath, `# API Reference\\n\\n${API_REFERENCE_INTRO}\\n\\n${sections.join('\\n\\n')}\\n`);\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// The types path of each export, such as './dist/types/src/errors/index.d.ts', mirrors its source file\n// ('src/errors/index.ts'), so the source is found by stripping the output folder and swapping the extension.\nfunction resolveEntryPoints(packageJSON: PackageJson): { importPath: string; sourcePath: string }[] {\n const packageName = packageJSON.name ?? '';\n const exportsField = packageJSON.exports;\n const exportEntries = exportsField != null && typeof exportsField === 'object' && !Array.isArray(exportsField) ? Object.entries(exportsField) : [];\n\n const entryPoints: { importPath: string; sourcePath: string }[] = [];\n for (const [subpath, target] of exportEntries) {\n const typesPath = target != null && typeof target === 'object' && !Array.isArray(target) ? target['types'] : undefined;\n if (typeof typesPath !== 'string') continue;\n const importPath = subpath === '.' ? packageName : `${packageName}${subpath.slice(1)}`;\n const sourcePath = typesPath.replace(/^\\.\\/dist\\/types\\//, '').replace(/\\.d\\.ts$/, '.ts');\n entryPoints.push({ importPath, sourcePath });\n }\n return entryPoints;\n}\n\n// Uses the project's own tsconfig, so '@/' and other path aliases resolve as they do in the build.\nfunction readCompilerOptions(): ts.CompilerOptions {\n const configPath = ts.findConfigFile(process.cwd(), (fileName) => ts.sys.fileExists(fileName));\n if (configPath === undefined) return { module: ts.ModuleKind.ESNext, moduleResolution: ts.ModuleResolutionKind.Bundler, target: ts.ScriptTarget.ESNext };\n\n const { config } = ts.readConfigFile(configPath, (fileName) => ts.sys.readFile(fileName)) as { config: unknown };\n return ts.parseJsonConfigFileContent(config, ts.sys, process.cwd()).options;\n}\n\nfunction listExports(checker: ts.TypeChecker, sourceFile: ts.SourceFile, fieldGroupOwners: Map<ts.ObjectLiteralExpression, string>): ExportEntry[] {\n const moduleSymbol = checker.getSymbolAtLocation(sourceFile);\n const exportedSymbols = moduleSymbol === undefined ? [] : checker.getExportsOfModule(moduleSymbol);\n\n const entries = exportedSymbols.flatMap((exportedSymbol) => {\n const symbol = resolveAlias(checker, exportedSymbol);\n const entry = describeExport(checker, formatExportName(exportedSymbol, symbol), symbol, fieldGroupOwners);\n return entry === undefined ? [] : { ...entry, description: readDescription(checker, symbol), topic: readTopic(symbol) };\n });\n return entries.toSorted((a, b) => a.name.localeCompare(b.name));\n}\n\n// Named from the folders between 'src' and the file declaring the export: 'component/module/connector' reads as\n// 'Component › Module › Connector', with camel-case names split into words.\nfunction readTopic(symbol: ts.Symbol): string {\n const fileName = symbol.declarations?.[0]?.getSourceFile().fileName;\n if (fileName === undefined) return GENERAL_TOPIC;\n\n // TypeScript reports files with symbolic links resolved (on macOS, '/var' is really '/private/var'), so the source\n // folder is resolved the same way before the two are compared.\n const resolvePath = (unresolvedPath: string): string => ts.sys.realpath?.(unresolvedPath) ?? unresolvedPath;\n const folder = path.relative(resolvePath(path.join(process.cwd(), 'src')), resolvePath(path.dirname(fileName)));\n return folder === '' || folder.startsWith('..')\n ? GENERAL_TOPIC\n : folder\n .split(path.sep)\n .map((segment) => segment.replaceAll(/([a-z])([A-Z])/g, '$1 $2').replace(/^./, (letter) => letter.toUpperCase()))\n .join(' › ');\n}\n\n// Functions include constants holding a function, as with arrow functions. Schemas are the constants named '…Schema'.\nfunction describeExport(\n checker: ts.TypeChecker,\n name: string,\n symbol: ts.Symbol,\n fieldGroupOwners: Map<ts.ObjectLiteralExpression, string>\n): Omit<ExportEntry, 'description' | 'topic'> | undefined {\n const isValue = (symbol.flags & (ts.SymbolFlags.Function | ts.SymbolFlags.Variable)) !== 0;\n const [signature] = isValue ? checker.getSignaturesOfType(checker.getTypeOfSymbol(symbol), ts.SignatureKind.Call) : [];\n const isSchema = name.endsWith('Schema');\n\n if (signature !== undefined && !isSchema) {\n const parameters = signature.parameters.map((parameter) => formatParameter(checker, parameter));\n return { detail: `(${parameters.join(', ')})`, kind: 'Functions', name, origin: '' };\n }\n if ((symbol.flags & ts.SymbolFlags.Class) !== 0) return { detail: '', kind: 'Classes', name, origin: formatOrigin(checker, symbol, fieldGroupOwners) };\n if (isSchema && (symbol.flags & ts.SymbolFlags.Variable) !== 0) return { detail: '', kind: 'Schemas', name, origin: '' };\n if ((symbol.flags & ts.SymbolFlags.Variable) !== 0) return { detail: `: ${formatConstantType(checker, symbol)}`, kind: 'Constants', name, origin: '' };\n const isType = (symbol.flags & (ts.SymbolFlags.Enum | ts.SymbolFlags.Interface | ts.SymbolFlags.TypeAlias)) !== 0;\n return isType ? { detail: '', kind: 'Types', name, origin: formatOrigin(checker, symbol, fieldGroupOwners) } : undefined;\n}\n\n// The summary of the '/** … */' comment above the item, on one line. Tags such as '@param' are left out, and '//'\n// comments, which are notes for maintainers, are never read.\nfunction readDescription(checker: ts.TypeChecker, symbol: ts.Symbol): string | undefined {\n const description = ts.displayPartsToString(symbol.getDocumentationComment(checker)).replaceAll(/\\s+/g, ' ').trim();\n return description === '' ? undefined : description;\n}\n\n// The type as written, on the declaration or in an 'as' on its value, which keeps the names it was written with. Where\n// none is written, the inferred type is widened, so 'MAX_COUNT = 3' reads as 'number' rather than '3'.\nfunction formatConstantType(checker: ts.TypeChecker, symbol: ts.Symbol): string {\n const declaration = symbol.valueDeclaration;\n const variableDeclaration = declaration !== undefined && ts.isVariableDeclaration(declaration) ? declaration : undefined;\n const initializer = variableDeclaration?.initializer;\n const isWrittenAs = initializer !== undefined && ts.isAsExpression(initializer) && !ts.isConstTypeReference(initializer.type); // 'as const' names no type.\n const typeNode = variableDeclaration?.type ?? (isWrittenAs ? initializer.type : undefined);\n return typeNode === undefined ? checker.typeToString(checker.getBaseTypeOfLiteralType(checker.getTypeOfSymbol(symbol)), declaration) : formatTypeNode(typeNode);\n}\n\n// What a type or class comes from: the schema it is inferred from, and what it extends or implements, such as\n// ' (extends DPUseError)'. A type inferred from a schema has no 'extends' clause, so its parent is found from the schema\n// instead. The parent is named even when it is not exported, as it is still what the type inherits from.\nfunction formatOrigin(checker: ts.TypeChecker, symbol: ts.Symbol, fieldGroupOwners: Map<ts.ObjectLiteralExpression, string>): string {\n const heritageClauses = (symbol.declarations ?? []).flatMap((declaration) =>\n ts.isClassDeclaration(declaration) || ts.isInterfaceDeclaration(declaration) ? [...(declaration.heritageClauses ?? [])] : []\n );\n const clauses = heritageClauses.map((clause) => {\n const keyword = clause.token === ts.SyntaxKind.ExtendsKeyword ? 'extends' : 'implements';\n return `${keyword} ${clause.types.map((type) => formatCode(formatTypeNode(type))).join(', ')}`;\n });\n\n const typeAlias = symbol.declarations?.find((declaration) => ts.isTypeAliasDeclaration(declaration));\n const schemaName = typeAlias === undefined ? undefined : findSchemaName(typeAlias);\n if (typeAlias !== undefined && schemaName !== undefined) {\n clauses.push(`inferred from ${formatCode(schemaName.getText())}`);\n const fields = findSchemaFields(checker, typeAlias);\n const parents = fields === undefined ? [] : findSchemaParents(checker, fields, typeAlias.name.text, fieldGroupOwners);\n if (parents.length > 0) clauses.push(`extends ${parents.map((parent) => formatCode(parent)).join(', ')}`);\n }\n return clauses.length === 0 ? '' : ` (${clauses.join(', ')})`;\n}\n\n// A schema inherits by spreading in a group of fields, as in 'strictObject({ ...moduleConfigCoreFields, … })'. Where\n// the type owns the group it spreads, as 'ModuleConfig' owns 'moduleConfigCoreFields', its parent is found in that\n// group's own spreads.\nfunction findSchemaParents(checker: ts.TypeChecker, fields: ts.ObjectLiteralExpression, typeName: string, fieldGroupOwners: Map<ts.ObjectLiteralExpression, string>): string[] {\n return fields.properties.flatMap((property) => {\n const group = ts.isSpreadAssignment(property) ? resolveObjectLiteral(checker, property.expression) : undefined;\n if (group === undefined) return [];\n const owner = fieldGroupOwners.get(group);\n if (owner === typeName) return findSchemaParents(checker, group, typeName, fieldGroupOwners);\n return owner === undefined ? [] : [owner];\n });\n}\n\n// A field group is not a type, so it is named by the type whose schema adds the fewest fields to it. Where two types\n// tie, the group is left unnamed rather than guessed at.\nfunction mapFieldGroupOwners(program: ts.Program, checker: ts.TypeChecker): Map<ts.ObjectLiteralExpression, string> {\n const candidates = new Map<ts.ObjectLiteralExpression, { addedFieldCount: number; typeName: string }[]>();\n const typeAliases = program\n .getSourceFiles()\n .filter((sourceFile) => !sourceFile.isDeclarationFile && !program.isSourceFileFromExternalLibrary(sourceFile))\n .flatMap((sourceFile) => sourceFile.statements.filter((statement) => ts.isTypeAliasDeclaration(statement)));\n\n for (const typeAlias of typeAliases) {\n for (const { addedFieldCount, group } of listFieldGroups(checker, typeAlias)) {\n candidates.set(group, [...(candidates.get(group) ?? []), { addedFieldCount, typeName: typeAlias.name.text }]);\n }\n }\n\n const owners = new Map<ts.ObjectLiteralExpression, string>();\n for (const [group, groupCandidates] of candidates) {\n const fewestAdded = Math.min(...groupCandidates.map(({ addedFieldCount }) => addedFieldCount));\n const [owner, ...tied] = groupCandidates.filter(({ addedFieldCount }) => addedFieldCount === fewestAdded);\n if (owner !== undefined && tied.length === 0) owners.set(group, owner.typeName);\n }\n return owners;\n}\n\n// Each field group a type's schema is built from, with the number of fields the schema adds to it.\nfunction listFieldGroups(checker: ts.TypeChecker, typeAlias: ts.TypeAliasDeclaration): { addedFieldCount: number; group: ts.ObjectLiteralExpression }[] {\n const fields = findSchemaFields(checker, typeAlias);\n if (fields === undefined) return [];\n\n // Fields declared under a name of their own, rather than written inside the schema, are a group themselves.\n const ownGroup = ts.isVariableDeclaration(fields.parent) ? [{ addedFieldCount: 0, group: fields }] : [];\n const spreadGroups = fields.properties.flatMap((property) => {\n const group = ts.isSpreadAssignment(property) ? resolveObjectLiteral(checker, property.expression) : undefined;\n return group === undefined ? [] : [{ addedFieldCount: fields.properties.length - 1, group }];\n });\n return [...ownGroup, ...spreadGroups];\n}\n\n// The schema a type is inferred from, written either as 'InferOutput<typeof schema>' or, where the schema is built in\n// place from a group of fields, as 'InferOutput<ReturnType<typeof strictObject<typeof fields>>>'.\nfunction findSchemaName(typeAlias: ts.TypeAliasDeclaration): ts.EntityName | undefined {\n const [argument] = isTypeReferenceNamed(typeAlias.type, 'InferOutput') ? (typeAlias.type.typeArguments ?? []) : [];\n if (argument === undefined) return undefined;\n if (ts.isTypeQueryNode(argument)) return argument.exprName;\n\n const [returnTypeArgument] = isTypeReferenceNamed(argument, 'ReturnType') ? (argument.typeArguments ?? []) : [];\n const [fieldsQuery] = returnTypeArgument !== undefined && ts.isTypeQueryNode(returnTypeArgument) ? (returnTypeArgument.typeArguments ?? []) : [];\n return fieldsQuery !== undefined && ts.isTypeQueryNode(fieldsQuery) ? fieldsQuery.exprName : undefined;\n}\n\n// The fields of the schema a type is inferred from: those passed to 'strictObject({ … })', or the group of fields itself.\nfunction findSchemaFields(checker: ts.TypeChecker, typeAlias: ts.TypeAliasDeclaration): ts.ObjectLiteralExpression | undefined {\n const schemaName = findSchemaName(typeAlias);\n const schema = schemaName === undefined ? undefined : resolveInitializer(checker, schemaName);\n if (schema === undefined) return undefined;\n if (ts.isObjectLiteralExpression(schema)) return schema;\n\n const [fields] = ts.isCallExpression(schema) ? schema.arguments : [];\n return fields === undefined ? undefined : resolveObjectLiteral(checker, fields);\n}\n\nfunction isTypeReferenceNamed(node: ts.TypeNode, name: string): node is ts.TypeReferenceNode {\n if (!ts.isTypeReferenceNode(node)) return false;\n const typeName = ts.isQualifiedName(node.typeName) ? node.typeName.right : node.typeName;\n return typeName.text === name;\n}\n\nfunction resolveObjectLiteral(checker: ts.TypeChecker, node: ts.Node): ts.ObjectLiteralExpression | undefined {\n if (ts.isObjectLiteralExpression(node)) return node;\n const initializer = resolveInitializer(checker, node);\n return initializer !== undefined && ts.isObjectLiteralExpression(initializer) ? initializer : undefined;\n}\n\n// The value a name was declared with, following imports back to the declaration.\nfunction resolveInitializer(checker: ts.TypeChecker, name: ts.Node): ts.Expression | undefined {\n const symbol = checker.getSymbolAtLocation(name);\n const declaration = symbol === undefined ? undefined : resolveAlias(checker, symbol).valueDeclaration;\n return declaration !== undefined && ts.isVariableDeclaration(declaration) ? declaration.initializer : undefined;\n}\n\nfunction resolveAlias(checker: ts.TypeChecker, symbol: ts.Symbol): ts.Symbol {\n return (symbol.flags & ts.SymbolFlags.Alias) === 0 ? symbol : checker.getAliasedSymbol(symbol);\n}\n\n// A default export is imported under any name, so the name it has where it is declared is shown alongside.\nfunction formatExportName(exportedSymbol: ts.Symbol, symbol: ts.Symbol): string {\n if (exportedSymbol.name !== 'default') return exportedSymbol.name;\n const declarationName = symbol.declarations?.map((declaration) => ts.getNameOfDeclaration(declaration)?.getText()).find((name) => name !== undefined);\n return declarationName === undefined || declarationName === 'default' ? 'default' : `default (${declarationName})`;\n}\n\n// A parameter that can be left out, being optional or having a default, is marked with '?'. Its type is as written, or\n// inferred where none is, as with a default value.\nfunction formatParameter(checker: ts.TypeChecker, parameter: ts.Symbol): string {\n const declaration = parameter.valueDeclaration;\n const parameterDeclaration = declaration !== undefined && ts.isParameter(declaration) ? declaration : undefined;\n const isOptional = parameterDeclaration?.questionToken !== undefined || parameterDeclaration?.initializer !== undefined;\n const typeText = parameterDeclaration?.type === undefined ? checker.typeToString(checker.getTypeOfSymbol(parameter), declaration) : formatTypeNode(parameterDeclaration.type);\n const name = parameterDeclaration === undefined ? parameter.name : formatParameterName(parameterDeclaration.name);\n return `${name}${isOptional ? '?' : ''}: ${typeText}`;\n}\n\n// A destructured parameter has no name of its own, so TypeScript calls it '__0'. It is shown by the names it unpacks\n// instead, as '{ allowedLicenses, moduleLevel }', leaving out their defaults.\nfunction formatParameterName(name: ts.BindingName): string {\n if (ts.isIdentifier(name)) return name.text;\n const names = name.elements.flatMap((element) =>\n ts.isBindingElement(element) ? [(element.dotDotDotToken === undefined ? '' : '...') + formatParameterName(element.name)] : []\n );\n return ts.isObjectBindingPattern(name) ? `{ ${names.join(', ')} }` : `[${names.join(', ')}]`;\n}\n\n// A type written across several lines is shown on one.\nfunction formatTypeNode(typeNode: ts.TypeNode): string {\n return typeNode.getText().replaceAll(/\\s+/g, ' ');\n}\n\nfunction buildSection(importPath: string, entries: ExportEntry[]): string {\n const topics = [...new Set(entries.map((entry) => entry.topic))].toSorted(compareTopics);\n if (topics.length < TOPIC_GROUPING_MINIMUM) return [`## ${importPath}`, ...buildKindLists(entries, '###')].join('\\n\\n');\n\n const topicSections = topics.map((topic) =>\n [\n `### ${topic}`,\n ...buildKindLists(\n entries.filter((entry) => entry.topic === topic),\n '####'\n )\n ].join('\\n\\n')\n );\n return [`## ${importPath}`, ...topicSections].join('\\n\\n');\n}\n\n// General comes first, as it holds what the whole package shares; the rest are alphabetical.\nfunction compareTopics(a: string, b: string): number {\n const isEitherGeneral = a === GENERAL_TOPIC || b === GENERAL_TOPIC;\n return isEitherGeneral ? Number(b === GENERAL_TOPIC) - Number(a === GENERAL_TOPIC) : a.localeCompare(b);\n}\n\nfunction buildKindLists(entries: ExportEntry[], headingLevel: string): string[] {\n return EXPORT_KINDS.flatMap((kind) => {\n const items = entries.filter((entry) => entry.kind === kind).map((entry) => formatEntry(entry));\n return items.length === 0 ? [] : `${headingLevel} ${kind}\\n\\n${items.join('\\n')}`;\n });\n}\n\n// The name and what follows it are code, shown on a shaded background, with only the name bold so it stands out from\n// its parameters or type. The description is a quote nested in the item, which indents every line of it and shows it\n// in lighter text, so the names can be read straight down the left.\nfunction formatEntry({ description, detail, name, origin }: ExportEntry): string {\n const detailCode = detail === '' ? '' : formatCode(detail);\n const firstLine = `- **${formatCode(name)}**${detailCode}${origin}`;\n return description === undefined ? firstLine : `${firstLine}\\n > ${description}`;\n}\n\nfunction formatCode(text: string): string {\n return `\\`${text}\\``;\n}\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { C as e, D as t, E as n, M as r, O as i, S as a, T as o, _ as s, a as c, b as l, c as u, d, f, g as p, h as m, i as h, j as g, k as _, l as v, m as ee, n as te, o as ne, p as y, r as re, s as ie, t as ae, u as oe, v as b, w as x, x as S, y as C } from "./utilities-CjhO3pxf.js";
1
+ import { C as e, D as t, E as n, M as r, O as i, S as a, T as o, _ as s, a as c, b as l, c as u, d, f, g as p, h as m, i as h, j as g, k as _, l as v, m as ee, n as te, o as ne, p as y, r as re, s as ie, t as ae, u as oe, v as b, w as x, x as S, y as C } from "./utilities-Bqc7DQXv.js";
2
2
  import { SHIPPED_PACKAGES_FILE_NAME as se } from "./vite.es.js";
3
3
  import { existsSync as ce, promises as w } from "node:fs";
4
4
  import T from "node:path";
@@ -256,7 +256,7 @@ var Be = "<!-- SUPPORTED_ACTIONS_START -->", Ve = "<!-- SUPPORTED_ACTIONS_END --
256
256
  async function Ge() {
257
257
  try {
258
258
  s("Document Actions"), C("1️⃣ Insert actions description and table into 'README.md'");
259
- let e = (await S("config.json")).actionNames ?? [], t = r(e), n = g(e), i = `## Supported Actions\n\n${He}\n\n${Ue[t]} ${We}\n\n${n}`;
259
+ let e = (await S("config.json")).actionNames ?? [], t = g(e), n = r(e), i = `## Supported Actions\n\n${He}\n\n${Ue[t]} ${We}\n\n${n}`;
260
260
  await _(i, Be, Ve), b("Actions documented");
261
261
  } catch (e) {
262
262
  console.error("❌ Error documenting actions", e), process.exit(1);
@@ -1065,7 +1065,7 @@ var H = "API_REFERENCE.md";
1065
1065
  async function kn() {
1066
1066
  try {
1067
1067
  s("Document API Reference");
1068
- let { writeAPIReference: e } = await import("./apiReference-D4xooSV0.js");
1068
+ let { writeAPIReference: e } = await import("./apiReference-C2-jo0bP.js");
1069
1069
  await e("1️⃣ ", H), b("API reference documented");
1070
1070
  } catch (e) {
1071
1071
  console.error("❌ Error documenting API reference", e), process.exit(1);