duto 0.0.0 → 0.260808.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present, ZUNQ.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,17 +1,26 @@
-### Verify if name exists:
+<h1 align="left">Duto<br/><a href="https://pr.new/attla/duto"><img align="right" src="https://developer.stackblitz.com/img/start_pr_dark_small.svg" alt="Start new PR in StackBlitz Codeflow"></a><a href="https://npmjs.com/package/duto"><img align="right" src="https://img.shields.io/npm/v/duto.svg" alt="npm package"></a></h1>
 
-```bash
-npm view PACKAGE_NAME
-```
+> ⚠️ Duto is under ALFA development — expect updates, rough edges, and occasional breack changes.
+<br/>
 
-ou
+This framework is fully geared towards the serverless world, specifically for static pages.
 
-```bash
-bun info PACKAGE_NAME
-```
+- 💡 SSG
+- ⚡️ Dynamic static routes
+- 📦 Optimized Build
 
-### Publish package
+[Read the Docs to Learn More](https://github.com/attla/duto/blob/main/DOCS.md)
 
-```bash
-bun publish
-```
+## Ecosystem Packages
+
+| Package | Version | Description |
+| -: | :- | :- |
+| [rajt](https://github.com/attla/rajt) | [![rajt version](https://img.shields.io/npm/v/rajt.svg?label=%20)](https://npm.im/rajt) | 🧱 The core of Rajt serverless framework. |
+| [create-rajt](https://github.com/attla/create-rajt) | [![create-rajt version](https://img.shields.io/npm/v/create-rajt.svg?label=%20)](https://npm.im/create-rajt) | 📁 CLI tool for create new Rajt projects, from starter templates. |
+| [forj](https://github.com/attla/forj) | [![forj version](https://img.shields.io/npm/v/forj.svg?label=%20)](https://npm.im/forj) | 🗂️ Just another query builder in typescript |
+| [t0n](https://github.com/attla/t0n) | [![t0n version](https://img.shields.io/npm/v/t0n.svg?label=%20)](https://npm.im/t0n) | 🧰 Collection of elegant typescript resources for web artisans. |
+| [cripta](https://github.com/attla/cripta) | [![cripta version](https://img.shields.io/npm/v/cripta.svg?label=%20)](https://npm.im/cripta) | 🧛 A layer of encryption a little too judicious. |
+
+## License
+
+This package is licensed under the [MIT license](https://github.com/attla/duto/blob/main/LICENSE) © [Zunq](https://zunq.com)

package/package.json

@@ -1,4 +1,58 @@
 {
-"name": "duto",
-"version": "0.0.0"
+  "name": "duto",
+  "description": "Static framework for web artisans",
+  "version": "0.260808.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "files": ["src"],
+  "bin": "./src/cli/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@preact/signals": "^2.9.2",
+    "@swc/core": "^1.15.21",
+    "chokidar": "^3.5.2",
+    "citty": "^0.2.2",
+    "consola": "^3.4.2",
+    "filesize": "^11.0",
+    "pathe": "^2.0",
+    "preact": "^10.29.7",
+    "preact-render-to-string": "^6.6.6",
+    "t0n": "0.x",
+    "vite": "^8.0.0",
+    "wouter-preact": "^3.10.0"
+  },
+  "devDependencies": {
+    "@minify-html/node": "^0.18.1",
+    "@preact/preset-vite": "^2.10.5",
+    "@tailwindcss/vite": "^4.3.1",
+    "@types/node": "^25.9.0",
+    "bun-types": "^1.3.14",
+    "typescript": "^5.9.3"
+  },
+  "packageManager": "bun@1.3.14",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "author": "Zunq <open-source@zunq.com>",
+  "license": "MIT",
+  "homepage": "https://zunq.dev",
+  "repository": "git://github.com/attla/duto",
+  "bugs": "https://github.com/attla/duto/issues",
+  "keywords": [
+    "SSG",
+    "application",
+    "framework",
+    "router",
+    "serverless",
+    "typescript",
+    "cloudflare",
+    "workers",
+    "vercel",
+    "bun"
+  ]
 }

package/src/cli/commands/build.ts

@@ -0,0 +1,74 @@
+import { build } from 'vite'
+import { filesize } from 'filesize'
+import { command } from 't0n/cli'
+import { dim, underline } from 't0n/color'
+import { wait, error, rn, event } from 't0n/log'
+import { meta } from '@/vite-plugin'
+import { getConfig } from '~/utils'
+import type { SummaryMetadata } from '@/types'
+
+export default command({
+	meta: {
+		name: 'build',
+		description: '🗂️  Perform the build for production\n',
+	},
+	args: {
+	},
+  async run({ args }) {
+    global.__hmr = !!args?.hmr
+    wait('Building..')
+
+		try {
+      await build(await getConfig())
+      const st = global?.__st ? Math.ceil(performance.now() - global.__st) : 0
+      const metadata = meta()
+
+      const trunc = (str: string, length: number, width = 35) => length > width ? str.slice(0, width - 3) + '...' : str + (length < width ? ' '.repeat(width - length) : '')
+
+      const format = (row: SummaryMetadata, i: number, max: number, deep: boolean = false) => {
+        let str = (deep ? (i === max - 1 ? '└' : '├') : (i === 0 ? '┌' : (i === max - 1 ? '└' : '├'))) + ' '
+
+        if (!deep) str += (['○', '●', '⌾'][row.type] || '○') + ' '
+        const size = filesize(row.sizeBr || 0)
+        return dim(str + [row.path, size + ' '.repeat(10 - size.length) + filesize(row.size || 0)].map(col => trunc(col, col.length, deep ? 33 : 35)).join(''))
+      }
+
+      rn()
+      console.log('    '+ ['Route', 'Size'].map(col => trunc(dim(underline(col)), col.length)).join(''))
+
+      let i = 0
+      const max = metadata.summary.size
+      for (const [, row] of metadata.summary) {
+        console.log(format(row, i, max))
+
+        if (row.children?.size) {
+          let i2 = 0
+          const max2 = row.children.size
+          for (const [, r] of row.children) {
+            console.log(dim('├   ')+ format(r, i2, max2, true))
+            i2++
+
+            if (i2 > 3 && max2 > 4) {
+              console.log(dim(`    [+${max2 - i2} more paths]`))
+              break
+            }
+          }
+        }
+        i++
+      }
+
+      rn(2)
+      console.log(dim('○ [Static] prerendered as static HTML'))
+      console.log(dim('● [SSG] prerendered as static HTML (uses getStaticProps)'))
+      console.log(dim('⌾ [CSR] rendered on client side (uses getProps)'))
+			rn()
+      event(`Builded successfully${st ? dim(` in ${st} ms`) : ''}`)
+		} catch (e: any) {
+			error(e)
+			// error('Build failed:', e?.message || e)
+			process.exit(0)
+		} finally {
+			rn()
+		}
+	},
+})

package/src/cli/commands/dev-old.ts

@@ -0,0 +1,213 @@
+import { defineCommand } from 'citty'
+import { build, preview } from 'vite'
+import { withPort } from 't0n/port'
+import { error, event, log, rn, wait } from 't0n/log'
+import { getConfig } from '~/utils'
+import { _root } from '@/utils'
+import { watch } from 't0n/cli'
+import { spawn, type ChildProcess } from 'node:child_process'
+
+export const args = {
+  port: {
+    alias: 'p',
+    description: 'Port to listen on',
+    type: 'number',
+    default: 3000,
+  },
+  host: {
+    description: 'Host to forward requests to, defaults to the zone of project',
+    type: 'string',
+    default: 'localhost',
+  },
+}
+
+export default defineCommand({
+  meta: {
+		name: 'dev',
+		description: '🧪  Start dev server\n',
+	}, // @ts-ignore
+	args,
+  async run({ args }) {
+    const config = await getConfig()
+		const desiredPort = args.port ? Number(args.port) : (config?.preview?.port ? Number(config.preview.port) : 3000)
+    const host = args.host ? String(args.host) : (config?.preview?.host ? config.preview.host : 'localhost')
+
+    // const _build = async () => {
+    //   return await build(await getConfig())
+    // }
+
+    // let buildProcess: ChildProcess | null = null
+    // const _build = async () => {
+    //   if (buildProcess) await killProcess(buildProcess)
+
+    //   return new Promise<void>((resolve, reject) => {
+    //     let timeoutId: NodeJS.Timeout | null = null
+
+    //     buildProcess = spawn('duto', ['build'], {
+    //       // stdio: 'ignore',
+    //       stdio: ['inherit', 'ignore', 'inherit', 'ipc'],
+    //       shell: process.platform === 'win32'
+    //     })
+
+    //     buildProcess.on('close', (code) => {
+    //       if (timeoutId) clearTimeout(timeoutId)
+    //       buildProcess = null
+
+    //       if (code === 0) {
+    //         resolve()
+    //       } else {
+    //         reject(new Error(`Build failed with code ${code}`))
+    //       }
+    //     })
+
+    //     buildProcess.on('error', (error) => {
+    //       if (timeoutId) clearTimeout(timeoutId)
+    //       buildProcess = null
+    //       reject(error)
+    //     })
+    //   })
+    // }
+
+		// const killProcess = async (app: ChildProcess | null) => {
+		// 	if (!app) return null
+		// 	// event('Stopping..')
+		// 	try {
+		// 		if (!app?.killed) {
+		// 			app.kill('SIGTERM')
+		// 			await wait(1000)
+
+		// 			if (!app?.killed) { // force kill
+		// 				app.kill('SIGKILL')
+		// 				await wait(1000)
+		// 			}
+		// 		}
+
+		// 		return null
+		// 	} catch (e) {
+		// 		error('Error stopping:', e)
+		// 	}
+
+		// 	return null
+    // }
+
+    let buildProcess: Bun.Subprocess | null = null
+
+    const _build = async () => {
+      if (buildProcess) await killProcess(buildProcess)
+      buildProcess = Bun.spawn(['duto', 'build'], {stdin: 'inherit', stdout: 'ignore', stderr: 'inherit'})
+
+      try {
+        const code = await buildProcess.exited
+
+        if (code !== 0)
+          throw new Error(`Build failed with code ${code}`)
+      } finally {
+        buildProcess = null
+      }
+    }
+
+    const killProcess = async (proc: Bun.Subprocess | null) => {
+      if (!proc || proc.exitCode !== null) return
+
+      try {
+        proc.kill('SIGTERM')
+
+        const exited = await Promise.race([
+          proc.exited.then(() => true),
+          new Promise(r => setTimeout(r, 1000)).then(() => false),
+        ])
+
+        if (!exited && proc.exitCode === null) {
+          proc.kill('SIGKILL')
+          await proc.exited
+        }
+      } catch (e) {
+        error('Error stopping:', e)
+      }
+    }
+
+    withPort(desiredPort, async (port) => {
+      const ignore = [
+        /(^|[\/\\])\.(duto|git|cache|vscode|idea|next|nuxt|nyc_output)([\/\\]|$)/,
+        /(^|[\/\\])(node_modules|tmp|dist|build|out|coverage)([\/\\]|$)/,
+
+        /\.(DS_Store|localized|tmp|temp|log|pid|swp|swo)$/,
+        /(Thumbs\.db|desktop\.ini)$/,
+        /~$/,
+
+        /(^|[\/\\])\.(Spotlight-V100|Trashes)([\/\\]|$)/,
+        /(^|[\/\\])__MACOSX([\/\\]|$)/,
+      ]
+
+      try {
+        await _build()
+
+        const clients = new Set<ReadableStreamDefaultController<string>>()
+        const reload = () => {
+          for (const client of clients)
+            client.enqueue('data: reload\n\n')
+        }
+        Bun.serve({
+          port: 1322,
+
+          fetch(req) {
+            const headers = {
+             'Access-Control-Allow-Origin': '*',
+             'Access-Control-Allow-Methods': 'GET',
+             'Access-Control-Allow-Headers': '*',
+            }
+
+            if (req.method === 'OPTIONS')
+              return new Response(null, { status: 204, headers })
+
+            const { pathname } = new URL(req.url)
+
+            if (pathname !== '/events')
+              return new Response(null, { status: 404, headers })
+
+            const stream = new ReadableStream<string>({
+              start(controller) {
+                clients.add(controller)
+
+                req.signal.addEventListener('abort', () => {
+                  clients.delete(controller)
+                  controller.close()
+                })
+              },
+            })
+
+            return new Response(stream, {
+              headers: {
+                ...headers,
+               'Content-Type': 'text/event-stream',
+               'Cache-Control': 'no-cache',
+               'Connection': 'keep-alive',
+              },
+            })
+          },
+        })
+
+        await preview({ ...config, preview: { port, host } })
+
+        log(`Running on http://${host}:${port}`)
+
+				watch(async () => {
+          await _build()
+          reload()
+				}, '.', _root, (path: string) => {
+          for (const pattern of ignore)
+            if (pattern.test(path)) return true
+
+          return false
+        })
+
+      } catch (e: any) {
+        error(e)
+        process.exit(0)
+      } finally {
+        rn()
+      }
+    })
+
+	},
+})

package/src/cli/commands/dev.ts

@@ -0,0 +1,87 @@
+import { command, watch, killProcess } from 't0n/cli'
+import { dim } from 't0n/color'
+import { error, log, rn } from 't0n/log'
+import { withPort } from 't0n/port'
+import { getMetadata } from '@/meta'
+import { _root } from '@/utils'
+import { getConfig, preview, reload } from '~/utils'
+
+export const args = {
+  port: {
+    alias: 'p',
+    description: 'Port to listen on',
+    type: 'number',
+    default: 3000,
+  },
+  host: {
+    description: 'Host to forward requests to, defaults to the zone of project',
+    type: 'string',
+    default: 'localhost',
+  },
+}
+
+export default command({
+  meta: {
+		name: 'dev',
+		description: '🧪  Start dev server\n',
+	}, // @ts-ignore
+	args,
+  async run({ args }) {
+    const config = await getConfig()
+		const desiredPort = args.port ? Number(args.port) : (config?.preview?.port ? Number(config.preview.port) : 3000)
+    const host = args.host ? String(args.host) : (config?.preview?.host ? String(config.preview.host) : 'localhost')
+
+    let buildProcess: Bun.Subprocess | null = null
+
+    const _build = async () => {
+      if (buildProcess) await killProcess(buildProcess)
+      buildProcess = Bun.spawn(['duto', 'build', '--hmr'], {stdin: 'inherit', stdout: 'ignore', stderr: 'inherit'})
+
+      try {
+        const code = await buildProcess.exited
+
+        if (code !== 0)
+          throw new Error(`Build failed with code ${code}`)
+      } finally {
+        buildProcess = null
+      }
+    }
+
+    withPort(desiredPort, async (port) => {
+      const ignore = [
+        /(^|[\/\\])\.(duto|git|cache|vscode|idea|next|nuxt|nyc_output)([\/\\]|$)/,
+        /(^|[\/\\])(node_modules|tmp|dist|build|out|coverage)([\/\\]|$)/,
+
+        /\.(DS_Store|localized|tmp|temp|log|pid|swp|swo)$/,
+        /(Thumbs\.db|desktop\.ini)$/,
+        /~$/,
+
+        /(^|[\/\\])\.(Spotlight-V100|Trashes)([\/\\]|$)/,
+        /(^|[\/\\])__MACOSX([\/\\]|$)/,
+      ]
+
+      try {
+        await _build()
+        await preview(await getMetadata(config.root as string, config.pagesDir as string), host, port)
+
+        log(`Running on http://${host}:${port}${global?.__st ? dim(` in ${Math.ceil(performance.now() - global.__st)} ms`) : ''}`)
+
+				watch(async () => {
+          await _build()
+          reload()
+				}, '.', _root, (path: string) => {
+          for (const pattern of ignore)
+            if (pattern.test(path)) return true
+
+          return false
+        })
+      } catch (e: any) {
+        error(e)
+        process.exit(0)
+      } finally {
+        rn()
+      }
+    })
+
+	},
+})

package/src/cli/commands/preview.ts

@@ -0,0 +1,33 @@
+import { command } from 't0n/cli'
+import { dim } from 't0n/color'
+import { error, log, rn } from 't0n/log'
+import { withPort } from 't0n/port'
+import { getMetadata } from '@/meta'
+import { _root } from '@/utils'
+import { args } from './dev'
+import { getConfig, preview } from '~/utils'
+
+export default command({
+  meta: {
+		name: 'preview',
+		description: '💻  Locally preview production build\n',
+	}, // @ts-ignore
+	args,
+  async run({ args }) {
+    const config = await getConfig()
+		const desiredPort = args.port ? Number(args.port) : (config?.preview?.port ? Number(config.preview.port) : 3000)
+    const host = args.host ? String(args.host) : (config?.preview?.host ? config.preview.host as string : 'localhost')
+
+    withPort(desiredPort, async (port) => {
+      try {
+        await preview(await getMetadata(config.root as string, config.pagesDir as string), host, port)
+        log(`Running on http://${host}:${port}${global?.__st ? dim(` in ${Math.ceil(performance.now() - global.__st)} ms`) : ''}`)
+      } catch (e: any) {
+        error('Preview failed:', e?.message || e)
+        process.exit(0)
+      } finally {
+        rn()
+      }
+    })
+	},
+})

package/src/cli/index.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env bun
+
+if (!process?.isBun || typeof Bun === 'undefined') {
+  console.error('Error: "Bun" is not available. Please install:')
+  console.log('  curl -fsSL https://bun.sh/install | bash')
+  process.exit(0)
+}
+
+global.__st = performance.now()
+
+import { join } from 'pathe'
+import { cli } from 't0n/cli'
+import { version } from '!/package.json'
+
+if (typeof document === 'undefined' && import.meta.main) {
+  const cmd = (c: string) => join(import.meta.dirname, 'commands', c)
+
+  cli({
+    name: 'duto',
+    description: 'Duto CLI',
+    version,
+    commands: {
+      dev: cmd('dev'),
+      build: cmd('build'),
+      preview: cmd('preview'),
+    }
+  })
+}