methanol 0.0.0 → 0.0.2

package/src/preview-server.js

@@ -0,0 +1,58 @@
+/* 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 { resolve } from 'path'
+import { mergeConfig, preview as vitePreview } from 'vite'
+import { state, cli } from './state.js'
+import { resolveUserViteConfig } from './config.js'
+import { methanolPreviewRoutingPlugin } from './vite-plugins.js'
+
+export const runVitePreview = async () => {
+	const baseConfig = {
+		configFile: false,
+		root: state.PAGES_DIR,
+		base: './',
+		build: {
+			outDir: state.DIST_DIR
+		}
+	}
+	const userConfig = await resolveUserViteConfig('preview')
+	const finalConfig = userConfig ? mergeConfig(baseConfig, userConfig) : baseConfig
+	if (cli.CLI_PORT != null) {
+		finalConfig.preview = { ...(finalConfig.preview || {}), port: cli.CLI_PORT }
+	}
+	if (cli.CLI_HOST !== null) {
+		finalConfig.preview = { ...(finalConfig.preview || {}), host: cli.CLI_HOST }
+	}
+	const outDir = finalConfig.build?.outDir || state.DIST_DIR
+	const distDir = resolve(state.ROOT_DIR, outDir)
+	const notFoundPath = resolve(distDir, '404.html')
+	const previewPlugins = Array.isArray(finalConfig.plugins) ? [...finalConfig.plugins] : []
+	previewPlugins.push(methanolPreviewRoutingPlugin(distDir, notFoundPath))
+	finalConfig.plugins = previewPlugins
+	if (!existsSync(distDir)) {
+		console.error(`Dist directory not found: ${distDir}`)
+		console.error('Run a production build before previewing.')
+		process.exit(1)
+	}
+	const server = await vitePreview(finalConfig)
+	server.printUrls()
+}

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,116 @@
+/* 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, relative, isAbsolute } from 'path'
+import { isElement } from 'hast-util-is-element'
+import { visit } from 'unist-util-visit'
+import { state } from '../state.js'
+
+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 isWithinRoot = (root, targetPath) => {
+	if (!root) return false
+	const relPath = relative(root, targetPath)
+	if (relPath === '') return true
+	if (relPath.startsWith('..') || relPath.startsWith('..\\')) return false
+	if (isAbsolute(relPath)) return false
+	return true
+}
+
+const hasExistingSource = (baseDir, pathWithoutSuffix, extension, root) => {
+	const targetPath = resolveCandidate(baseDir, `${pathWithoutSuffix}${extension}`)
+	if (root && !isWithinRoot(root, targetPath)) {
+		return false
+	}
+	return existsSync(targetPath)
+}
+
+const resolvePagesRoot = (filePath) => {
+	const roots = [state.PAGES_DIR, state.THEME_PAGES_DIR].filter(Boolean).map((dir) => resolve(dir))
+	if (!roots.length) return null
+	if (!filePath) return roots[0]
+	const resolvedFile = resolve(filePath)
+	for (const root of roots) {
+		if (isWithinRoot(root, resolvedFile)) {
+			return root
+		}
+	}
+	return roots[0]
+}
+
+export const linkResolve = () => {
+	return (tree, file) => {
+		const baseDir = file?.path ? dirname(file.path) : file?.cwd || process.cwd()
+		const pagesRoot = resolvePagesRoot(file?.path || null)
+		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, pagesRoot)
+			} else if (/\.html$/i.test(extension)) {
+				shouldStrip =
+					hasExistingSource(baseDir, withoutExtension, extension, pagesRoot) ||
+					hasExistingSource(baseDir, withoutExtension, '.md', pagesRoot) ||
+					hasExistingSource(baseDir, withoutExtension, '.mdx', pagesRoot)
+			}
+
+			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 }
+}