@deernova/style 0.1.0 → 0.2.0

package/README.md

@@ -1,16 +1,19 @@
 # @deernova/style
 
-Versioned Deernova design skill installer and static website template. Requires Node.js 22+. No runtime dependencies.
+Install the Deernova design reference skill into an existing repository. Requires Node.js 22+. No runtime dependencies.
 
 ```sh
-npx @deernova/style@latest install
-npx @deernova/style@latest update
-npx @deernova/style@latest doctor
-npx @deernova/style@latest init ./my-site
+npx @deernova/style@latest install --repo /path/to/project
+npx @deernova/style@latest update --repo /path/to/project
+npx @deernova/style@latest doctor --repo /path/to/project
 ```
 
-Default installation: `.agents/skills/deernova-style` in the current project. Use `--global` for Codex user skills (`$CODEX_HOME/skills` or `~/.codex/skills`), `--agent claude|codex|agents` to choose the agent directory, or `--dir <skills-parent>` for a custom destination. Repeat the same options when updating.
+Run without `--repo` inside your target project to use its current directory. The CLI writes only `.agents/skills/deernova-style/` by default. It does not add application code, CSS imports or package dependencies. The AI uses the installed skill to guide implementation through your project's existing framework and components.
 
-The skill bundles full foundations, component usage and SwiftUI examples, token reference, web/native integration guidance, review criteria, CSS/HTML assets and images. The CLI and website ship the same version and source hash.
+The skill contains the complete Deernova foundations, writing, typography, semantic values, platform density, accessibility, review criteria, component/layout references, SwiftUI examples and visual assets. The documentation website and skill are generated from the same design source.
 
-Updates are explicit: use `@latest update` to fetch the latest release. Locally modified skills are protected; `--force` backs up before replacing them. doctor returns nonzero if missing, modified or out of sync. init refuses nonempty directories. Serve the generated website with any static HTTP server.
+Use `--agent claude|codex|agents` to choose the skill directory, `--dir <skills-parent>` for a custom destination, or `--global` for a user installation. These three destination modes are mutually exclusive. Repeat the same options on update.
+
+Updates are explicit. Modified skills are protected; `--force` backs up before replacing them. doctor returns nonzero if missing, modified or out of sync.
+
+In 0.2.0, `init [existing-repository]` is an alias for skill installation, replacing the 0.1.0 website scaffold command. No separate tokens or UI package is needed.

package/bin/cli.mjs

@@ -1,23 +1,26 @@
 #!/usr/bin/env node
 import { cp, mkdir, readFile, readdir, rename, rm, lstat } from 'node:fs/promises';
-import { resolve, join, dirname } from 'node:path';
+import { resolve, join } from 'node:path';
 import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { createHash } from 'node:crypto';
 const pkg = fileURLToPath(new URL('../',import.meta.url));
-const args=process.argv.slice(2), command=args.shift()||'help';
+const args=process.argv.slice(2); let command=args.shift()||'help';
 const options={};let positional;
-for(let i=0;i<args.length;i++){const a=args[i];if(['--global','--force'].includes(a))options[a.slice(2)]=true;else if(['--dir','--agent'].includes(a)){if(!args[i+1]||args[i+1].startsWith('--'))throw Error(`${a} needs a value`);options[a.slice(2)]=args[++i];}else if(a.startsWith('-'))throw Error(`Unknown option: ${a}`);else if(positional)throw Error('Too many arguments');else positional=a;}
+for(let i=0;i<args.length;i++){const a=args[i];if(['--global','--force'].includes(a))options[a.slice(2)]=true;else if(['--dir','--agent','--repo'].includes(a)){if(!args[i+1]||args[i+1].startsWith('--'))throw Error(`${a} needs a value`);options[a.slice(2)]=args[++i];}else if(a.startsWith('-'))throw Error(`Unknown option: ${a}`);else if(positional)throw Error('Too many arguments');else positional=a;}
 async function exists(p){try{return await lstat(p);}catch(e){if(e.code==='ENOENT')return null;throw e;}}
 async function main(){
- if(['help','--help','-h'].includes(command)){console.log(`deernova-style install|update|doctor [--global] [--agent codex|claude|agents] [--dir <skills-parent>] [--force]\ndeernova-style init <empty-directory>\ndeernova-style version\nDefault: project .agents/skills/deernova-style. --global defaults to CODEX_HOME/skills.\nupdate installs the version bundled in this CLI; use npx @deernova/style@latest update to fetch latest.\n--force keeps a timestamped backup before replacing a locally modified skill.`);return;}
+ if(['help','--help','-h'].includes(command)){console.log(`deernova-style install|update|doctor [--repo <existing-repository>] [--global] [--agent codex|claude|agents] [--dir <skills-parent>] [--force]\ndeernova-style init [existing-repository]  (alias for install --repo)\ndeernova-style version\nInstalls design reference files only; does not add app code or package dependencies. Default: project .agents/skills/deernova-style. --global defaults to CODEX_HOME/skills.\nupdate installs the version bundled in this CLI; use npx @deernova/style@latest update to fetch latest.\n--force keeps a timestamped backup before replacing a locally modified skill.`);return;}
  const manifest=JSON.parse(await readFile(join(pkg,'skill/manifest.json'),'utf8'));
  if(command==='version'){console.log(manifest.version);return;}
- if(command==='init'){if(!positional)throw Error('Usage: deernova-style init <empty-directory>');const dest=resolve(positional);const stat=await exists(dest);if(stat&&(!stat.isDirectory()||(await readdir(dest)).length))throw Error('Destination must be an empty directory');await mkdir(dest,{recursive:true});await cp(join(pkg,'template'),dest,{recursive:true});console.log(`Created Deernova website v${manifest.version} at ${dest}\nServe with any static HTTP server.`);return;}
+ if(command==='init'){if(options.repo&&positional)throw Error('Specify the repository once');options.repo=positional||options.repo||process.cwd();positional=undefined;command='install';}
  if(!['install','update','doctor'].includes(command))throw Error(`Unknown command: ${command}`);
- if(positional)throw Error('Use --dir to specify a skills parent directory');
+ if(positional)throw Error('Use --repo to specify a repository or --dir to specify a skills parent');
+ if([options.repo,options.global,options.dir].filter(Boolean).length>1)throw Error('--repo, --global and --dir are mutually exclusive');
+ const repo=resolve(options.repo||process.cwd());
+ if(!options.global&&!options.dir&&!(await exists(repo))?.isDirectory())throw Error('Repository must be an existing directory');
  const agent=options.agent||(options.global?'codex':'agents');if(!['codex','claude','agents'].includes(agent))throw Error('Agent must be codex, claude or agents');
- const base=options.dir?resolve(options.dir):options.global?(agent==='codex'?join(process.env.CODEX_HOME||join(homedir(),'.codex'),'skills'):join(homedir(),'.'+agent,'skills')):resolve('.'+agent,'skills');
+ const base=options.dir?resolve(options.dir):options.global?(agent==='codex'?join(process.env.CODEX_HOME||join(homedir(),'.codex'),'skills'):join(homedir(),'.'+agent,'skills')):join(repo,'.'+agent,'skills');
  const dest=join(base,'deernova-style');const state=await exists(dest);
  if(state?.isSymbolicLink()||(state&&!state.isDirectory()))throw Error('Destination is not a regular directory');
  let installed=null;try{installed=JSON.parse(await readFile(join(dest,'manifest.json'),'utf8'));}catch{}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deernova/style",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "engines": {
     "node": ">=22"
@@ -13,8 +13,7 @@
   },
   "files": [
     "bin",
-    "skill",
-    "template"
+    "skill"
   ],
-  "description": "Deernova design skill installer and website template CLI"
+  "description": "Install the Deernova design reference skill into an existing repository"
 }

package/skill/SKILL.md

@@ -5,12 +5,14 @@ description: Apply Deernova's monochrome design language to Deernova apps, websi
 
 # Deernova Style
 
+Use this skill as the design reference for the repository in which it is installed. Read its guidelines when creating, modifying or reviewing that repository’s interface. Apply the principles through the project’s existing technology and components; do not install a component library or replace the architecture merely to follow this skill.
+
 Build coherent Deernova interfaces using the versioned resources bundled with this skill. Preserve the user's product, platform, framework and requested scope. The HTML previews demonstrate appearance; they are not production SwiftUI components or proof of functional behavior.
 
 ## Start with the relevant source
 
 - Read [foundations](references/foundations.md) for principles, writing, layout, platform behavior, motion and accessibility.
-- Read [tokens](references/tokens.md) when choosing semantic values. Exact structured values and typography live in `assets/design/tokens.json`; use `assets/design/tokens.css` for web projects.
+- Read [tokens](references/tokens.md) when choosing semantic values. Exact structured values and typography live in `assets/design/tokens.json`; the CSS in `assets/design/tokens.css` is a reference implementation, not a mandatory dependency.
 - Search [components](references/components.md) for the component being implemented, then inspect `assets/design/components/<Name>/preview.html` for its anatomy and variants. Native implementation examples live in that component's README.
 - For web implementation and validation, read [web](references/web.md). For native implementation, read [native](references/native.md).
 - For design review, read [review](references/review.md). Report concrete mismatches and locations; do not redesign unrelated screens.
@@ -33,4 +35,4 @@ Cards use thin borders without floating shadows. System-native controls and glas
 
 ## Version and updates
 
-`manifest.json` identifies the package version and source hash. Website, CSS and skill references are generated together from the repository's `design/` source. Update through `npx @deernova/style@latest update` in the same project; for global installations append `--global` and the same agent choice. This is an explicit update, not a background network service. Preserve local changes; the CLI refuses to overwrite them unless `--force` is requested, in which case it keeps a backup. Never edit generated references as the upstream source.
+`manifest.json` identifies the package version and source hash. The documentation website and skill references are generated together from the repository's `design/` source. Update through `npx @deernova/style@latest update` in the same project; for global installations append `--global` and the same agent choice. This is an explicit update, not a background network service. Preserve local changes; the CLI refuses to overwrite them unless `--force` is requested, in which case it keeps a backup. Never edit generated references as the upstream source.

package/skill/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.1.0",
-  "sourceHash": "277411693f87d8b2b805a12f90482ef52a45f52dbfe51a2e607b683f0a1119b9",
+  "version": "0.2.0",
+  "sourceHash": "ae37962bf6e58ec00bd9089080b42648d21e4b802e0587fb350c7ae95a763d7d",
   "components": [
     "Banner",
     "Button",

package/skill/references/web.md

@@ -1,8 +1,8 @@
 # Web implementation
 
-Install matching versions of `@deernova/tokens` and `@deernova/ui`. Import tokens.css before components.css. The CSS component namespace is `dn-` (migrated from Paperlight's `pl-`). The UI package provides CSS and HTML examples, not React components or JavaScript behavior.
+Read the repository’s existing framework, styles and components first. Translate Deernova’s semantic values and visual principles into that system. No npm style or UI package is required. The bundled HTML/CSS files are visual references; their `dn-` class names are not an interface that consuming projects must adopt.
 
-For framework-neutral implementations, copy the required CSS from `assets/design/`, and derive semantic markup from the relevant preview. Ensure buttons submit only intentionally, fields have labels, dialogs manage focus and Escape, and segmented controls expose their selected state. Preview-only static elements must receive real product behavior before shipping.
+Use `assets/design/tokens.json` and the relevant previews to make implementation decisions. Copy selected reference CSS only if it fits the user’s task and project conventions; do not add an entire stylesheet or scaffold application code just because the skill is installed. Ensure buttons submit only intentionally, fields have labels, dialogs manage focus and Escape, and segmented controls expose their selected state. Preview-only static elements must receive real product behavior before shipping.
 
 `data-theme="light"` or `data-theme="dark"` on the root overrides system theme; removing it follows the system. Persist preferences only if appropriate. Honor prefers-reduced-motion and prefers-reduced-transparency with stable and opaque fallbacks. Do not layer glass over reading content.
 

package/template/app.js

@@ -1,7 +0,0 @@
-const theme = document.querySelector('#theme');
-try { theme.value = localStorage.getItem('deernova-theme') || 'system'; } catch {}
-function applyTheme(){const value=theme.value; if(value==='system')document.documentElement.removeAttribute('data-theme');else document.documentElement.dataset.theme=value;document.querySelectorAll('iframe').forEach(f=>{f.src=f.src.split('#')[0]+(value==='system'?'':'#'+value);});try{localStorage.setItem('deernova-theme',value);}catch{}}
-theme.addEventListener('change',applyTheme);applyTheme();
-const search=document.querySelector('#search');search.addEventListener('input',()=>{const q=search.value.trim().toLowerCase();let n=0;document.querySelectorAll('.component').forEach(c=>{c.hidden=!c.dataset.search.toLowerCase().includes(q);if(!c.hidden)n++;});document.querySelector('#results').textContent=q?`找到 ${n} 个组件`:'';});search.addEventListener('keydown',e=>{if(e.key==='Enter')document.querySelector('#components').scrollIntoView();});
-let timer;document.querySelectorAll('[data-copy]').forEach(b=>b.addEventListener('click',async()=>{const toast=document.querySelector('#toast');try{await navigator.clipboard.writeText(b.dataset.copy);toast.textContent='已复制 '+b.dataset.copy;}catch{toast.textContent='请手动复制：'+b.dataset.copy;}toast.classList.add('show');clearTimeout(timer);timer=setTimeout(()=>toast.classList.remove('show'),3000);}));
-const observer=new IntersectionObserver(entries=>{for(const e of entries)if(e.isIntersecting){document.querySelectorAll('nav>a').forEach(a=>{const active=a.hash==='#'+e.target.id;a.classList.toggle('active',active);if(active)a.setAttribute('aria-current','location');else a.removeAttribute('aria-current');});}},{rootMargin:'-10% 0px -70% 0px'});document.querySelectorAll('main>section').forEach(s=>observer.observe(s));