@lark-apaas/coding-template-html-standard-webapp 0.1.0-alpha.20260827110728

package/LICENSE

@@ -0,0 +1,13 @@
+MIT License
+
+Copyright (c) 2024 Lark Technologies Pte. Ltd. and/or its affiliates
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted,provided that the above copyright notice and this permission notice appear in all copies.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
+INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO
+EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
+CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @lark-apaas/coding-template-html-standard-webapp
+
+Buildless HTML template for [miaoda coding](https://code.byted.org/apaas/miaoda-coding) — 面向本地开发的纯 HTML 多页模板（无构建、无依赖、无平台 SDK），产物托管协议 buildless 形态的参考实现。
+
+**Tech stack:** plain HTML · CSS · ES modules
+
+## Usage
+
+This package is consumed by [miaoda-cli](https://code.byted.org/apaas/miaoda-cli). It is not intended to be installed as a runtime dependency — the CLI fetches the tarball, renders `template/` into a user project, then discards the package reference.
+
+## 与 html 模板（妙搭沙箱形态）的区别
+
+- 无 `@lark-apaas/coding-html-devserver` 依赖，也无 package.json——`dev.command` 在 miaoda.json 中直接声明 `npx serve`
+- 无构建：`miaoda.json` 不声明 `build.command`，`build.output: "."` 项目目录直接打包（协议 v0.3 buildless 形态）
+- routes.json 由 lark-cli 打包时扫描 `.html` 文件树生成，工程侧零协议心智
+- Level 1 同源：资源相对路径引用，不消费任何 `MIAODA_*` 环境变量
+
+## Contents
+
+| Path | Purpose |
+|---|---|
+| `template/` | Files copied to the user project at init time |
+| `hooks/` | Lifecycle hooks (no-op) |

package/hooks/after-install.mjs

@@ -0,0 +1,3 @@
+export default async function after_install(ctx) {
+  // no-op
+}

package/hooks/after-render.mjs

@@ -0,0 +1,3 @@
+export default async function after_render(ctx) {
+  // no-op
+}

package/hooks/before-render.mjs

@@ -0,0 +1,3 @@
+export default async function before_render(ctx) {
+  // no-op
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@lark-apaas/coding-template-html-standard-webapp",
+  "version": "0.1.0-alpha.20260827110728",
+  "description": "Buildless HTML template for miaoda local development (no build step, no platform SDK)",
+  "type": "module",
+  "files": [
+    "template",
+    "hooks"
+  ],
+  "scripts": {
+    "validate-manifest": "node ../../../scripts/validate-template.mjs .",
+    "smoke": "node ../../../scripts/smoke-template.mjs .",
+    "prepublishOnly": "pnpm validate-manifest"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "miaoda",
+    "coding-template",
+    "html",
+    "webapp"
+  ],
+  "license": "MIT",
+  "miaodaTemplate": {
+    "schemaVersion": 1,
+    "archType": 4,
+    "hooks": {
+      "beforeRender": "hooks/before-render.mjs",
+      "afterRender": "hooks/after-render.mjs",
+      "afterInstall": "hooks/after-install.mjs"
+    }
+  }
+}

package/template/README.md

@@ -0,0 +1,24 @@
+# 项目技术规范
+
+## 形态
+
+纯 HTML 多页应用，**无构建步骤（buildless）**：`miaoda.json` 未声明 `build.command`，部署时项目目录（`build.output: "."`）直接打包上传，routes.json 由部署工具扫描 `.html` 文件树自动生成。
+
+## 开发
+
+- 启动本地静态服务：`npx -y serve -l 5173 -n .`（即 `miaoda.json` 里 `dev.command` 声明的命令），编辑文件后刷新页面即可
+- 无 package.json、无 node_modules、无依赖安装步骤——`miaoda.json` 即项目的全部声明
+
+## 目录与路由
+
+| 文件 | 访问路径 |
+|------|---------|
+| `index.html` | `/` |
+| `foo/index.html` 或 `foo.html` | `/foo` |
+| `assets/*`（图片 / 数据 / 样式） | 相对路径引用 |
+
+## 资源引用规则（重要）
+
+- 页面与资源之间**必须使用相对路径**引用（`./assets/logo.png`、`../style.css`）
+- **禁止裸根路径**（`src="/foo.js"`）——本地能跑、上线 404
+- 无需消费任何 `MIAODA_*` 环境变量（相对路径在任意部署 base 下都成立）

package/template/_gitignore

@@ -0,0 +1,2 @@
+node_modules
+.DS_Store

package/template/index.html

@@ -0,0 +1,44 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>应用标题</title>
+    <style>
+      :root {
+        color-scheme: light dark;
+        --bg: #0f172a;
+        --fg: #e2e8f0;
+        --accent: #38bdf8;
+      }
+      * { box-sizing: border-box; }
+      body {
+        margin: 0;
+        min-height: 100vh;
+        display: grid;
+        place-items: center;
+        font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+        background: var(--bg);
+        color: var(--fg);
+      }
+      main {
+        text-align: center;
+        padding: 2rem;
+      }
+      h1 { margin: 0 0 0.5rem; font-size: clamp(1.5rem, 4vw, 2.5rem); }
+      p  { margin: 0.25rem 0; opacity: 0.8; }
+      code {
+        padding: 0.1rem 0.4rem;
+        border-radius: 0.3rem;
+        background: rgba(148, 163, 184, 0.2);
+      }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>应用已就绪</h1>
+      <p>编辑 <code>index.html</code> 开始开发，保存后刷新页面即可</p>
+      <p>新增页面：添加 <code>foo/index.html</code>，访问路径即为 <code>/foo</code></p>
+    </main>
+  </body>
+</html>

package/template/miaoda.json

@@ -0,0 +1,10 @@
+{
+  "stack": "html-standard-webapp",
+  "dev": {
+    "command": ["npx", "-y", "serve", "-l", "5173", "-n", "."],
+    "port": 5173
+  },
+  "build": {
+    "output": "."
+  }
+}