methanol 0.0.0 → 0.0.1

package/src/public-assets.js

@@ -0,0 +1,73 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import { readdir, stat, copyFile, mkdir } from 'fs/promises'
+import { existsSync } from 'fs'
+import { resolve, dirname, relative } from 'path'
+
+const ensureDir = async (dir) => {
+	await mkdir(dir, { recursive: true })
+}
+
+const copyDir = async (sourceDir, targetDir, onFile) => {
+	await ensureDir(targetDir)
+	const entries = await readdir(sourceDir)
+	for (const entry of entries) {
+		if (entry.startsWith('.')) {
+			continue
+		}
+		const sourcePath = resolve(sourceDir, entry)
+		const targetPath = resolve(targetDir, entry)
+		const stats = await stat(sourcePath)
+		if (stats.isDirectory()) {
+			await copyDir(sourcePath, targetPath, onFile)
+		} else {
+			if (existsSync(targetPath)) {
+				if (onFile) {
+					onFile(sourcePath, targetPath, { skipped: true })
+				}
+				continue
+			}
+			await ensureDir(dirname(targetPath))
+			await copyFile(sourcePath, targetPath)
+			if (onFile) {
+				onFile(sourcePath, targetPath, { skipped: false })
+			}
+		}
+	}
+}
+
+export const copyPublicDir = async ({ sourceDir, targetDir, label = 'public' }) => {
+	if (!sourceDir || !targetDir) return
+	if (!existsSync(sourceDir)) return
+	const resolvedSource = resolve(sourceDir)
+	const resolvedTarget = resolve(targetDir)
+	if (resolvedSource === resolvedTarget) return
+	const created = !existsSync(resolvedTarget)
+	await ensureDir(resolvedTarget)
+	if (created) {
+		console.log(`Methanol: created ${label} directory`)
+	}
+	await copyDir(resolvedSource, resolvedTarget, (sourcePath, targetPath, info) => {
+		const rel = relative(resolvedSource, sourcePath).replace(/\\/g, '/')
+		if (info?.skipped) return
+		console.log(`Methanol: copied ${label}/${rel}`)
+	})
+}

package/src/register-loader.js

@@ -0,0 +1,29 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import { fileURLToPath } from 'node:url'
+import { dirname, resolve } from 'node:path'
+import { register } from 'node:module'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const loaderPath = resolve(__dirname, '../src/node-loader.js')
+
+register(loaderPath, import.meta.url)

package/src/rehype-plugins/link-resolve.js

@@ -0,0 +1,89 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import { existsSync } from 'fs'
+import { dirname, resolve } from 'path'
+import { isElement } from 'hast-util-is-element'
+import { visit } from 'unist-util-visit'
+
+const extensionRegex = /\.(mdx?|html)$/i
+
+const isRelativeHref = (href) => {
+	if (typeof href !== 'string') return false
+	if (!href) return false
+	if (href.startsWith('#') || href.startsWith('?') || href.startsWith('/')) return false
+	if (href.startsWith('//')) return false
+	if (/^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(href)) return false
+	return true
+}
+
+const splitHref = (href) => {
+	const cutIndex = href.search(/[?#]/)
+	if (cutIndex === -1) {
+		return { path: href, suffix: '' }
+	}
+	return { path: href.slice(0, cutIndex), suffix: href.slice(cutIndex) }
+}
+
+const resolveCandidate = (baseDir, targetPath) => resolve(baseDir, targetPath)
+
+const hasExistingSource = (baseDir, pathWithoutSuffix, extension) => {
+	const targetPath = `${pathWithoutSuffix}${extension}`
+	return existsSync(resolveCandidate(baseDir, targetPath))
+}
+
+export const linkResolve = () => {
+	return (tree, file) => {
+		const baseDir = file?.path ? dirname(file.path) : file?.cwd || process.cwd()
+		visit(tree, (node) => {
+			if (!isElement(node) || node.tagName !== 'a') {
+				return
+			}
+			const href = node.properties?.href
+			if (!isRelativeHref(href)) {
+				return
+			}
+
+			const { path, suffix } = splitHref(href)
+			const match = path.match(extensionRegex)
+			if (!match) {
+				return
+			}
+			const extension = match[0]
+			const withoutExtension = path.replace(extensionRegex, '')
+
+			let shouldStrip = false
+			if (/\.mdx?$/i.test(extension)) {
+				shouldStrip = hasExistingSource(baseDir, withoutExtension, extension)
+			} else if (/\.html$/i.test(extension)) {
+				shouldStrip =
+					hasExistingSource(baseDir, withoutExtension, extension) ||
+					hasExistingSource(baseDir, withoutExtension, '.md') ||
+					hasExistingSource(baseDir, withoutExtension, '.mdx')
+			}
+
+			if (!shouldStrip) {
+				return
+			}
+
+			node.properties.href = withoutExtension + suffix
+		})
+	}
+}

package/src/rehype-plugins/methanol-ctx.js

@@ -0,0 +1,89 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import { extname } from 'path'
+
+function createConst(name, init) {
+	return {
+		type: 'VariableDeclaration',
+		kind: 'const',
+		declarations: [
+			{
+				type: 'VariableDeclarator',
+				id: { type: 'Identifier', name },
+				init
+			}
+		]
+	}
+}
+
+function argumentMember(name) {
+	return {
+		type: 'MemberExpression',
+		object: {
+			type: 'MemberExpression',
+			object: { type: 'Identifier', name: 'arguments' },
+			property: { type: 'Literal', value: 0 },
+			computed: true,
+			optional: false
+		},
+		property: { type: 'Identifier', name },
+		computed: false,
+		optional: false
+	}
+}
+
+const ctxFrontmatter = {
+	type: 'ChainExpression',
+	expression: {
+		type: 'MemberExpression',
+		object: {
+			type: 'MemberExpression',
+			object: { type: 'Identifier', name: 'ctx' },
+			property: { type: 'Identifier', name: 'page' },
+			computed: false,
+			optional: false
+		},
+		property: { type: 'Identifier', name: 'frontmatter' },
+		computed: false,
+		optional: true
+	}
+}
+
+export function methanolCtx() {
+	return (tree, file) => {
+		// const filePath = file?.path || ''
+
+		tree.children.unshift({
+			type: 'mdxjsEsm',
+			data: {
+				estree: {
+					type: 'Program',
+					sourceType: 'module',
+					body: [
+						createConst('rawHTML', argumentMember('rawHTML')),
+						createConst('ctx', argumentMember('ctx')),
+						createConst('frontmatter', ctxFrontmatter)
+					]
+				}
+			}
+		})
+	}
+}

package/src/renderer.js

@@ -0,0 +1,25 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import { createHTMLRenderer } from 'refui/html'
+
+const HTMLRenderer = createHTMLRenderer()
+
+export { HTMLRenderer }

package/src/rewind.js

@@ -0,0 +1,117 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import fnv1a from '@sindresorhus/fnv1a'
+import JSON5 from 'json5'
+
+const utf8Buffer = new Uint8Array(128)
+
+const alphabet = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!?*:+-=._/[]{}()<>%#$^|~`'"
+const base = alphabet.length
+function compress(num) {
+	let result = ''
+	while (num > 0) {
+		result = alphabet[num % base] + result
+		num = Math.floor(num / base)
+	}
+	return result
+}
+
+function hash(str, size = 32) {
+	return compress(Number(fnv1a(str, { size, utf8Buffer })))
+}
+
+export function env(parentEnv) {
+	const registry = {}
+	const keyPathRegistry = {}
+	let parent = parentEnv || null
+
+	let renderCount = 0
+
+	function client(info) {
+		const { clientPath, staticComponent, exportName } = info
+
+		let key = null
+		let _clientPath = clientPath
+		do {
+			_clientPath += '\0'
+			key = hash(_clientPath)
+		} while (keyPathRegistry[key] && keyPathRegistry[key] !== clientPath)
+
+		const component = ({ children: childrenProp, ...props }, ...children) => {
+			const id = renderCount++
+			const idStr = id.toString(16)
+			const script = `$$rwnd(${JSON.stringify(key)},${id},${Object.keys(props).length ? JSON5.stringify(props) : '{}'})`
+
+			return (R) => {
+				return [
+					R.createAnchor(`{${idStr}}`, true),
+					R.c(
+						staticComponent,
+						props,
+						R.createAnchor(`[${idStr}[`, true),
+						...children,
+						R.createAnchor(`]${idStr}]`, true)
+					),
+					R.c('script', null, R.rawHTML(script))
+				]
+			}
+		}
+
+		registry[exportName] = [key, info.clientPath]
+		keyPathRegistry[key] = info.clientPath
+
+		return component
+	}
+
+	function invalidate(exportName) {
+		if (!registry[exportName]) {
+			return
+		}
+		const [key] = registry[exportName]
+		delete registry[exportName]
+		delete keyPathRegistry[key]
+	}
+
+	function setParent(nextParent) {
+		parent = nextParent || null
+	}
+
+	function getMergedRegistry() {
+		return Object.assign({}, parent?.registry, registry)
+	}
+
+	function genRegistryScript() {
+		return `({
+	${Object.values(getMergedRegistry()).map(([key, path]) => `${JSON.stringify(key)}: () => import(${JSON.stringify(path)})`).join(`,
+	`)}
+})`
+	}
+
+	return {
+		client,
+		invalidate,
+		genRegistryScript,
+		setParent,
+		get registry() {
+			return getMergedRegistry()
+		}
+	}
+}

package/src/stage-logger.js

@@ -0,0 +1,59 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+const now = () => (typeof performance !== 'undefined' ? performance.now() : Date.now())
+
+export const createStageLogger = (enabled) => {
+	let lastLength = 0
+	const isTty = Boolean(process.stdout && process.stdout.isTTY)
+	const writeLine = (text, newline) => {
+		if (!process.stdout || !process.stdout.write) {
+			if (newline) {
+				console.log(text)
+			}
+			return
+		}
+		if (!isTty) {
+			if (newline) {
+				console.log(text)
+			}
+			return
+		}
+		const padding = lastLength > text.length ? ' '.repeat(lastLength - text.length) : ''
+		const clearLine = '\u001b[2K'
+		process.stdout.write(`${clearLine}\r${text}${padding}${newline ? '\n' : ''}`)
+		lastLength = text.length
+	}
+	const start = (label) => {
+		if (!enabled) return null
+		writeLine(`${label}...`, false)
+		return { label, start: now() }
+	}
+	const update = (token, message) => {
+		if (!enabled || !token || !message) return
+		writeLine(message, false)
+	}
+	const end = (token) => {
+		if (!enabled || !token) return
+		const duration = Math.round(now() - token.start)
+		writeLine(`${token.label}...\t${duration}ms`, true)
+	}
+	return { start, update, end }
+}

package/src/state.js

@@ -0,0 +1,159 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import { resolve } from 'path'
+import yargs from 'yargs/yargs'
+import { hideBin } from 'yargs/helpers'
+
+const PROJECT_ROOT = resolve('.')
+
+const withCommonOptions = (y) =>
+	y
+		.positional('input', {
+			describe: 'Pages directory',
+			type: 'string',
+			nargs: 1
+		})
+		.positional('output', {
+			describe: 'Output directory',
+			type: 'string',
+			nargs: 1
+		})
+		.option('input', {
+			alias: 'i',
+			describe: 'Pages directory',
+			type: 'string',
+			requiresArg: true,
+			nargs: 1
+		})
+		.option('components', {
+			describe: 'Components directory',
+			type: 'string',
+			requiresArg: true,
+			nargs: 1
+		})
+		.option('assets', {
+			describe: 'Assets/public directory',
+			type: 'string',
+			requiresArg: true,
+			nargs: 1
+		})
+		.option('output', {
+			alias: 'o',
+			describe: 'Output directory',
+			type: 'string',
+			requiresArg: true,
+			nargs: 1
+		})
+		.option('config', {
+			alias: 'c',
+			describe: 'Config file path',
+			type: 'string',
+			requiresArg: true,
+			nargs: 1
+		})
+		.option('site-name', {
+			describe: 'Site name override',
+			type: 'string',
+			requiresArg: true,
+			nargs: 1
+		})
+		.option('port', {
+			describe: 'Port for dev/preview',
+			type: 'number',
+			requiresArg: true,
+			nargs: 1
+		})
+		.option('host', {
+			describe: 'Host for dev/preview',
+			type: 'string',
+			coerce: (value) => {
+				if (value == null) return null
+				if (value === true || value === '' || value === 'true') return true
+				return value
+			}
+		})
+		.option('intermediate-dir', {
+			describe: 'Write intermediate HTML output to a directory',
+			type: 'string',
+			requiresArg: true,
+			nargs: 1
+		})
+		.option('emit-intermediate', {
+			describe: 'Emit intermediate HTML output to the default build dir',
+			type: 'boolean',
+			default: false
+		})
+
+const parser = yargs(hideBin(process.argv))
+	.scriptName('methanol')
+	.usage('Usage: $0 <command> [options]')
+	.command('dev [input]', 'Start the Methanol dev server', withCommonOptions)
+	.command('build [input] [output]', 'Build the static site', withCommonOptions)
+	.command('serve [input] [output]', 'Serve the production build', withCommonOptions)
+	.command('preview [input] [output]', false, withCommonOptions)
+	.help()
+	.wrap(null)
+
+const argv = parser.parseSync()
+
+export const cli = {
+	argv,
+	command: argv._[0] ? String(argv._[0]) : null,
+	showHelp: () => parser.showHelp(),
+	CLI_INTERMEDIATE_DIR: argv['intermediate-dir'] || null,
+	CLI_EMIT_INTERMEDIATE: Boolean(argv['emit-intermediate']),
+	CLI_HOST: argv.host ?? null,
+	CLI_PORT: typeof argv.port === 'number' ? argv.port : null,
+	CLI_PAGES_DIR: argv.input || null,
+	CLI_COMPONENTS_DIR: argv.components || null,
+	CLI_ASSETS_DIR: argv.assets || null,
+	CLI_OUTPUT_DIR: argv.output || null,
+	CLI_CONFIG_PATH: argv.config || null,
+	CLI_SITE_NAME: argv['site-name'] || null
+}
+
+export const state = {
+	PROJECT_ROOT,
+	ROOT_DIR: PROJECT_ROOT,
+	SITE_NAME: 'Methanol Site',
+	PAGES_DIR: resolve(PROJECT_ROOT, 'pages'),
+	COMPONENTS_DIR: resolve(PROJECT_ROOT, 'components'),
+	STATIC_DIR: resolve(PROJECT_ROOT, 'public'),
+	BUILD_DIR: resolve(PROJECT_ROOT, 'build'),
+	DIST_DIR: resolve(PROJECT_ROOT, 'dist'),
+	VIRTUAL_HTML_OUTPUT_ROOT: PROJECT_ROOT,
+	INTERMEDIATE_DIR: null,
+	THEME_COMPONENTS_DIR: null,
+	THEME_PAGES_DIR: null,
+	THEME_PUBLIC_DIR: null,
+	THEME_ENV: null,
+	USER_THEME: null,
+	USER_VITE_CONFIG: null,
+	USER_MDX_CONFIG: null,
+	USER_PUBLIC_OVERRIDE: false,
+	RESOURCES: [],
+	PAGEFIND_ENABLED: false,
+	PAGEFIND_OPTIONS: null,
+	PAGEFIND_BUILD_OPTIONS: null,
+	CURRENT_MODE: 'production',
+	RESOLVED_MDX_CONFIG: undefined,
+	RESOLVED_VITE_CONFIG: undefined
+}

package/src/virtual-module/inject.js

@@ -0,0 +1,30 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import { createDOMRenderer } from 'refui/dom'
+import { defaults } from 'refui/browser'
+import { lazy } from 'refui'
+import { init } from '/.methanol_virtual_module/loader.js'
+
+const reg = import('/.methanol_virtual_module/registry.js')
+
+const R = createDOMRenderer(defaults)
+
+reg.then((m) => init(m.registry, R))