hokit 2.0.0 → 2.1.0

package/dist/cli/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import{a as e,i as t,n,r,t as i}from"../watch-BO-aYzLX.js";switch(process.argv[2]){case`build`:await e();break;case`doctor`:await r();break;case`lint`:await n();break;case`watch`:await i();break;case`docs`:await t();break;default:console.log(`
+import{a as e,i as t,n,o as r,r as i,t as a}from"../init-DyPLSOkt.js";switch(process.argv[2]){case`init`:await a(process.argv.find(e=>e.startsWith(`--`))?.replace(`--`,``)??`empty`);break;case`build`:await r();break;case`doctor`:await t();break;case`lint`:await i();break;case`watch`:await n();break;case`docs`:await e();break;default:console.log(`
 Hokit
 
 Usage:

package/dist/index.d.ts

@@ -61,4 +61,7 @@ declare class HokitError extends Error {
   constructor(title: string, sections?: Record<string, string | string[]>);
 }
 //#endregion
-export { Build, BuildConfig, BuildOptions, HokitError, KnownScope, Module, ModuleOptions, Scope, Snippet, SnippetOptions, build, compile, defineConfig, discover, docs, doctor, lint, scopes, watchMode };
+//#region src/init/init.d.ts
+declare function init(template?: "empty" | "react"): Promise<void>;
+//#endregion
+export { Build, BuildConfig, BuildOptions, HokitError, KnownScope, Module, ModuleOptions, Scope, Snippet, SnippetOptions, build, compile, defineConfig, discover, docs, doctor, init, lint, scopes, watchMode };

package/dist/index.js

@@ -1 +1 @@
-import{_ as e,a as t,c as n,d as r,f as i,g as a,h as o,i as s,l as c,m as l,n as u,o as d,p as f,r as p,s as m,t as h,u as g}from"./watch-BO-aYzLX.js";function _(e){return e}const v=c({output:i()});function y(e){return r(v,e),t=>{o.set(t,e)}}const b=c({scopes:g(m(i())),tags:g(m(i()))});function x(e){return r(b,e),t=>{a.set(t,e)}}const S=c({name:i(),prefix:i(),body:m(i()),description:g(i()),template:g(n())});function C(t){return r(S,t),(n,r)=>{let i=n.constructor,a=e.get(i)??[];a.push({propertyKey:r,options:t}),e.set(i,a)}}const w=[`typescript`,`typescriptreact`,`javascript`,`javascriptreact`,`html`,`json`,`swift`,`kotlin`,`rust`,`go`,`python`,`java`,`c`,`cpp`,`dart`,`ruby`,`php`,`lua`,`elixir`,`zig`,`toml`,`yaml`,`markdown`];export{y as Build,d as HokitError,x as Module,C as Snippet,t as build,l as compile,_ as defineConfig,f as discover,s as docs,p as doctor,u as lint,w as scopes,h as watchMode};
+import{_ as e,a as t,c as n,d as r,f as i,g as a,h as o,i as s,l as c,m as l,n as u,o as d,p as f,r as p,s as m,t as h,u as g,v as _}from"./init-DyPLSOkt.js";function v(e){return e}const y=g({output:f()});function b(e){return i(y,e),t=>{a.set(t,e)}}const x=g({scopes:r(n(f())),tags:r(n(f()))});function S(t){return i(x,t),n=>{e.set(n,t)}}const C=g({name:f(),prefix:f(),body:n(f()),description:r(f()),template:r(c())});function w(e){return i(C,e),(t,n)=>{let r=t.constructor,i=_.get(r)??[];i.push({propertyKey:n,options:e}),_.set(r,i)}}const T=[`typescript`,`typescriptreact`,`javascript`,`javascriptreact`,`html`,`json`,`swift`,`kotlin`,`rust`,`go`,`python`,`java`,`c`,`cpp`,`dart`,`ruby`,`php`,`lua`,`elixir`,`zig`,`toml`,`yaml`,`markdown`];export{b as Build,m as HokitError,S as Module,w as Snippet,d as build,o as compile,v as defineConfig,l as discover,t as docs,s as doctor,h as init,p as lint,T as scopes,u as watchMode};

package/dist/{watch-BO-aYzLX.js → init-DyPLSOkt.js}

@@ -4,4 +4,75 @@ import e from"node:fs/promises";import t from"node:path";import{pathToFileURL as
 `;for(let[e]of M){let n=N(e);t+=`# ${e.name}\n\n`,t+="```json\n",t+=JSON.stringify(n,null,2),t+=`
 \`\`\`
 
-`}await e.writeFile(`SNIPPETS.md`,t),$.success(`Generated SNIPPETS.md`)}async function Kt(){if(await xt(await Rt()),M.size===0){$.info(`No modules found.`);return}$.success(`Discovered ${M.size} module(s).`);let e=[...j.values()].reduce((e,t)=>e+t.length,0);$.success(`Loaded ${e} snippet(s).`),Vt(),$.success(`No duplicate names.`),Ut(),$.success(`No duplicate prefixes.`),Ht(),$.success(`No duplicate outputs.`)}async function qt(){await Kt()}async function Jt(){await Wt(),b(process.cwd(),{recursive:!0},async(e,t)=>{$.info(`Change detected: ${t}`);try{await Wt()}catch(e){console.error(e)}})}export{j as _,Wt as a,Mt as c,It as d,Ft as f,A as g,M as h,Gt as i,Nt as l,N as m,qt as n,Bt as o,xt as p,Kt as r,jt as s,Jt as t,Pt as u};
+`}await e.writeFile(`SNIPPETS.md`,t),$.success(`Generated SNIPPETS.md`)}async function Kt(){if(await xt(await Rt()),M.size===0){$.info(`No modules found.`);return}$.success(`Discovered ${M.size} module(s).`);let e=[...j.values()].reduce((e,t)=>e+t.length,0);$.success(`Loaded ${e} snippet(s).`),Vt(),$.success(`No duplicate names.`),Ut(),$.success(`No duplicate prefixes.`),Ht(),$.success(`No duplicate outputs.`)}async function qt(){await Kt()}async function Jt(){await Wt(),b(process.cwd(),{recursive:!0},async(e,t)=>{$.info(`Change detected: ${t}`);try{await Wt()}catch(e){console.error(e)}})}async function Yt(){let t=`hokit.config.ts`;try{await e.access(t),$.info(`Skipped hokit.config.ts`);return}catch{}await e.writeFile(t,`import { defineConfig } from "hokit"
+
+export default defineConfig({
+    cwd: "src/modules",
+    pattern:
+        "**/*.module.ts"
+
+})`),$.success(`Created hokit.config.ts`)}const Xt={empty:{name:`empty`,filename:`example.module.ts`,content:`import {
+    Build,
+    Module,
+    Snippet
+} from "hokit"
+
+@Build({
+    output:
+        "dist/snippets/example.json"
+})
+@Module({
+    scopes: [
+        "typescript"
+    ]
+})
+export class ExampleModule {
+    @Snippet({
+        name:
+            "Example snippet",
+        prefix:
+            "example",
+        body: [
+            "$0"
+        ]
+    })
+    public example!: void
+}`},react:{name:`react`,filename:`react.module.ts`,content:`import {
+    Build,
+    Module,
+    Snippet
+} from "hokit"
+
+
+@Build({
+    output:
+        "dist/snippets/react.json"
+})
+
+
+@Module({
+    scopes: [
+        "typescriptreact"
+    ],
+    tags: [
+        "react",
+        "web"
+    ]
+})
+
+
+export class ReactModule {
+    @Snippet({
+        name:
+            "React Functional Component",
+        prefix:
+            "rfc",
+        description:
+            "Creates a React component.",
+         body: [
+            "$0"
+        ]
+
+    })
+    public rfc!: void
+}`}};async function Zt(n){let r=Xt[n],i=t.join(`src/modules`,r.filename);try{await e.access(i),$.info(`Skipped ${i}`);return}catch{}await e.mkdir(`src/modules`,{recursive:!0}),await e.writeFile(i,r.content),$.success(`Created ${i}`)}async function Qt(){let t=`tsconfig.json`;try{await e.access(t),$.info(`Skipped tsconfig.json`);return}catch{}await e.writeFile(t,JSON.stringify({compilerOptions:{target:`ES2022`,module:`ESNext`,moduleResolution:`Bundler`,strict:!0,experimentalDecorators:!0,skipLibCheck:!0}},null,4)),$.success(`Created tsconfig.json`)}async function $t(){try{let t=await e.readFile(`package.json`,`utf8`),n=JSON.parse(t);n.scripts??={},Object.assign(n.scripts,{build:`hokit build`,lint:`hokit lint`,doctor:`hokit doctor`,watch:`hokit watch`,docs:`hokit docs`}),await e.writeFile(`package.json`,JSON.stringify(n,null,4)),$.success(`Updated package.json`)}catch{$.info(`Skipped package.json`)}}async function en(e=`empty`){await Yt(),await Qt(),await Zt(e),await $t(),$.success(`Hokit initialized.`)}export{A as _,Gt as a,jt as c,Pt as d,It as f,M as g,N as h,Kt as i,Mt as l,xt as m,Jt as n,Wt as o,Ft as p,qt as r,Bt as s,en as t,Nt as u,j as v};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hokit",
-    "version": "2.0.0",
+    "version": "2.1.0",
     "description": "A type-safe snippet registry and compiler for VSCode and Cursor.",
     "keywords": [
         "cursor",

package/readme.md

@@ -18,29 +18,53 @@
 - 🎨 Colorful diagnostics
 - ⚡ Built for Bun and modern TypeScript
 
----
+## Project Initialization
 
-## Installation
+Hokit provides a CLI initializer to quickly create a ready-to-use project structure.
 
-Using Bun:
+After installing Hokit:
 
 ```bash
 bun add -D hokit
 ```
 
-Using npm:
+initialize your project:
 
 ```bash
-npm install -D hokit
+bunx hokit init
 ```
 
-Using pnpm:
+## Templates
+
+Hokit supports project templates to bootstrap different snippet collections.
+
+### Empty Template
+
+Create a minimal snippet module:
 
 ```bash
-pnpm add -D hokit
+bunx hokit init --empty
 ```
 
----
+Generated file:
+
+```txt
+src/modules/example.module.ts
+```
+
+### React Template
+
+Create a React snippet module:
+
+```bash
+hokit init --react
+```
+
+Generated file:
+
+```txt
+src/modules/react.module.ts
+```
 
 ## Project structure
 
@@ -59,8 +83,6 @@ dist/
 hokit.config.ts
 ```
 
----
-
 ## Configuration
 
 Create a `hokit.config.ts` file:
@@ -86,8 +108,6 @@ export default defineConfig({
 | `include` | Explicit include patterns         | `undefined`        |
 | `exclude` | Ignore patterns                   | `undefined`        |
 
----
-
 ## Creating modules
 
 A module groups snippets that share metadata.
@@ -132,8 +152,6 @@ export class ReactModule {
 }
 ```
 
----
-
 ## Decorators
 
 ### `@Build`
@@ -181,8 +199,6 @@ Defines an individual snippet.
 })
 ```
 
----
-
 ## Available scopes
 
 ```ts
@@ -212,8 +228,6 @@ type Scope =
     | "markdown"
 ```
 
----
-
 ## CLI
 
 ### Build
@@ -230,8 +244,6 @@ Output:
 ✔ Generated dist/snippets/react.json
 ```
 
----
-
 ### Doctor
 
 Runs diagnostics.
@@ -250,8 +262,6 @@ Example output:
 ✔ No duplicate outputs.
 ```
 
----
-
 ### Lint
 
 Runs validations.
@@ -260,8 +270,6 @@ Runs validations.
 hokit lint
 ```
 
----
-
 ### Watch
 
 Rebuilds automatically on file changes.
@@ -277,8 +285,6 @@ Output:
 ✔ Generated dist/snippets/react.json
 ```
 
----
-
 ### Docs
 
 Generates documentation.
@@ -293,8 +299,6 @@ Generates:
 SNIPPETS.md
 ```
 
----
-
 ## Validation
 
 Hokit validates your project in two ways:
@@ -333,8 +337,6 @@ Found in:
   • AnotherModule.rfc
 ```
 
----
-
 #### Duplicate prefixes
 
 ```txt
@@ -348,8 +350,6 @@ Found in:
   • AnotherModule.rfc
 ```
 
----
-
 #### Duplicate outputs
 
 ```txt
@@ -360,8 +360,6 @@ Found in:
   • AnotherModule
 ```
 
----
-
 ## Generated output
 
 The following snippet:
@@ -392,8 +390,6 @@ Generates:
 }
 ```
 
----
-
 ## Why Hokit?
 
 Traditional snippet JSON quickly becomes difficult to maintain.
@@ -414,8 +410,6 @@ Inspired by:
 - Drizzle
 - Vite
 
----
-
 ## License
 
 MIT