@t8/docsgen 0.1.20 → 0.1.22

package/.biomeincludes

@@ -0,0 +1 @@
+!schema.json

package/dist/bin.js

@@ -548,7 +548,7 @@ function getTitle(ctx, { cover, originalContent, withPackageURL } = {}) {
 
 // src/bin/toFileContent.ts
 function toFileContent(x) {
-  return `${x.replace(/\s+(<\/(head|body)>)/g, "\n$1").trim()}
+  return `${x.replace(/\s+(\r?\n *<\/(script|link|head|body)>)/g, "$1").trim()}
 `;
 }
 

package/package.json

@@ -1,18 +1,19 @@
 {
   "name": "@t8/docsgen",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "",
   "main": "dist/bin.js",
   "bin": {
     "docsgen": "dist/bin.js"
   },
   "scripts": {
-    "build": "npx npm-run-all clean build-bin -s build-css",
+    "build": "npx npm-run-all clean build-bin -p build-css",
     "build-bin": "npx esbuild ./src/bin/run.ts --bundle --outfile=dist/bin.js --platform=node --external:jsdom --external:markdown-it",
     "build-css": "node -e \"require('node:fs').cpSync('src/css', 'dist/css', { force: true, recursive: true });\"",
+    "build-schema": "npx ts-json-schema-generator -p src/types/Config.ts -t Config -o schema.json --minify",
     "clean": "node -e \"require('node:fs').rmSync('dist', { force: true, recursive: true });\"",
     "prepublishOnly": "npm run build",
-    "preversion": "npx npm-run-all typecheck shape build",
+    "preversion": "npx npm-run-all typecheck build-schema shape build",
     "shape": "npx codeshape",
     "typecheck": "tsc --noEmit"
   },

package/schema.json

@@ -0,0 +1 @@
+{"$ref":"#/definitions/Config","$schema":"http://json-schema.org/draft-07/schema#","definitions":{"Config":{"additionalProperties":false,"properties":{"append":{"$ref":"#/definitions/ContentInjectionMap%3C(%22head%22%7C%22body%22)%3E"},"backstory":{"description":"Backstory link URL to be added to the front page.","type":"string"},"baseColor":{"type":"string"},"cname":{"description":"Content of the './CNAME' file.","type":"string"},"contentDir":{"description":"Generated section content directory.","type":"string"},"description":{"type":"string"},"dir":{"type":"string"},"entries":{"items":{"$ref":"#/definitions/EntryConfig"},"type":"array"},"favicon":{"description":"Favicon URL.","type":"string"},"faviconType":{"type":"string"},"htmlTitle":{"type":"string"},"id":{"type":"string"},"jsorg":{"description":"As a boolean, it means whether to add the '<package_name>.js.org' domain to the './CNAME' file.\n\nAs a string, it sets the '<jsorg_value>.js.org' domain to the './CNAME' file.","type":["boolean","string"]},"mainBranch":{"type":"string"},"name":{"type":"string"},"nav":{"description":"URL of an HTML file inserted into the navigation bar.","type":"string"},"npm":{"type":"string"},"redirect":{"description":"Redirection URL.","type":"string"},"remove":{"description":"Whether to remove the GitHub Pages branch and quit.","type":"boolean"},"repo":{"type":"string"},"root":{"description":"Main page root path.","type":"string"},"scope":{"description":"Scope URL.","type":"string"},"singlePage":{"description":"Whether to show all sections on a single page.","type":"boolean"},"source":{"type":"string"},"targetBranch":{"description":"Target branch.","examples":["gh-pages"],"type":"string"},"targetId":{"type":"string"},"theme":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"ymid":{"type":["number","string"]}},"type":"object"},"ContentInjectionMap<(\"head\"|\"body\")>":{"additionalProperties":false,"properties":{"body":{"anyOf":[{"type":"string"},{"additionalProperties":false,"properties":{"content":{"type":"string"},"pages":{"items":{"$ref":"#/definitions/Page"},"type":"array"}},"type":"object"},{"items":{"anyOf":[{"type":"string"},{"not":{}},{"additionalProperties":false,"properties":{"content":{"type":"string"},"pages":{"items":{"$ref":"#/definitions/Page"},"type":"array"}},"type":"object"}]},"type":"array"}]},"head":{"anyOf":[{"type":"string"},{"additionalProperties":false,"properties":{"content":{"type":"string"},"pages":{"items":{"$ref":"#/definitions/Page"},"type":"array"}},"type":"object"},{"items":{"anyOf":[{"type":"string"},{"not":{}},{"additionalProperties":false,"properties":{"content":{"type":"string"},"pages":{"items":{"$ref":"#/definitions/Page"},"type":"array"}},"type":"object"}]},"type":"array"}]}},"type":"object"},"EntryConfig":{"additionalProperties":false,"properties":{"append":{"$ref":"#/definitions/ContentInjectionMap%3C(%22head%22%7C%22body%22)%3E"},"backstory":{"description":"Backstory link URL to be added to the front page.","type":"string"},"baseColor":{"type":"string"},"cname":{"description":"Content of the './CNAME' file.","type":"string"},"contentDir":{"description":"Generated section content directory.","type":"string"},"description":{"type":"string"},"dir":{"type":"string"},"favicon":{"description":"Favicon URL.","type":"string"},"faviconType":{"type":"string"},"htmlTitle":{"type":"string"},"id":{"type":"string"},"jsorg":{"description":"As a boolean, it means whether to add the '<package_name>.js.org' domain to the './CNAME' file.\n\nAs a string, it sets the '<jsorg_value>.js.org' domain to the './CNAME' file.","type":["boolean","string"]},"mainBranch":{"type":"string"},"name":{"type":"string"},"nav":{"description":"URL of an HTML file inserted into the navigation bar.","type":"string"},"npm":{"type":"string"},"redirect":{"description":"Redirection URL.","type":"string"},"remove":{"description":"Whether to remove the GitHub Pages branch and quit.","type":"boolean"},"repo":{"type":"string"},"root":{"description":"Main page root path.","type":"string"},"scope":{"description":"Scope URL.","type":"string"},"singlePage":{"description":"Whether to show all sections on a single page.","type":"boolean"},"source":{"type":"string"},"targetBranch":{"description":"Target branch.","examples":["gh-pages"],"type":"string"},"theme":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"ymid":{"type":["number","string"]}},"type":"object"},"Page":{"enum":["index","start","section","redirect"],"type":"string"}}}

package/src/bin/getConfig.ts

@@ -1,5 +1,5 @@
 import { parseArgs } from "args-json";
-import type { BinConfig } from "../types/BinConfig";
+import type { Config } from "../types/Config";
 import type { EntryConfig } from "../types/EntryConfig";
 import type { PackageMetadata } from "../types/PackageMetadata";
 import { fetchText } from "./fetchText";
@@ -41,17 +41,17 @@ async function reviseConfig(config: EntryConfig) {
   return deriveMissingProps(await addMetadata(config));
 }
 
-let config: BinConfig | null = null;
+let config: Config | null = null;
 
-export async function getConfig(): Promise<BinConfig> {
+export async function getConfig(): Promise<Config> {
   if (config) return config;
 
-  let localConfig: BinConfig = {};
+  let localConfig: Config = {};
 
   try {
     localConfig = JSON.parse(
       await fetchText("./docsgen.config.json"),
-    ) as BinConfig;
+    ) as Config;
   } catch {}
 
   let targetId: string | undefined;
@@ -65,7 +65,7 @@ export async function getConfig(): Promise<BinConfig> {
     root: "/",
     contentDir: "x",
     ...localConfig,
-    ...parseArgs<BinConfig>(args),
+    ...parseArgs<Config>(args),
   };
 
   if (config.entries)

package/src/bin/toConfig.ts

@@ -1,8 +1,8 @@
-import type { BinConfig } from "../types/BinConfig";
+import type { Config } from "../types/Config";
 import type { PackageMetadata } from "../types/PackageMetadata";
 import { toRepoURL } from "./toRepoURL";
 
-export function toConfig(metadata: PackageMetadata): Partial<BinConfig> {
+export function toConfig(metadata: PackageMetadata): Partial<Config> {
   let { name, description, version, repository } = metadata;
 
   return {

package/src/bin/toFileContent.ts

@@ -1,3 +1,3 @@
 export function toFileContent(x: string) {
-  return `${x.replace(/\s+(<\/(head|body)>)/g, "\n$1").trim()}\n`;
+  return `${x.replace(/\s+(\r?\n *<\/(script|link|head|body)>)/g, "$1").trim()}\n`;
 }

package/src/types/{BinConfig.ts → Config.ts}

@@ -1,6 +1,6 @@
 import type { EntryConfig } from "./EntryConfig";
 
-export type BinConfig = EntryConfig & {
+export type Config = EntryConfig & {
   targetId?: string;
   entries?: EntryConfig[];
 };

package/src/types/Context.ts

@@ -1,4 +1,4 @@
-import type { BinConfig } from "./BinConfig";
+import type { Config } from "./Config";
 import type { EntryConfig } from "./EntryConfig";
 
-export type Context = Omit<BinConfig, "entries"> & EntryConfig;
+export type Context = Omit<Config, "entries"> & EntryConfig;