@aihu/cli

function appAboutAihu(appName: string = 'app'): string

src/pages/about.aihu — a second route, emitted by the `full` template to demonstrate the router resolving more than one page.

function appAihuConfig(): string

aihu.config.ts — kept for server/SSR config; optional for client-only apps.

function appDefaultLayout(): string

src/layouts/default.aihu for Hello World (v1 syntax).

function appDocsGuideAihu(appName: string = 'app'): string

src/pages/guide.aihu — second docs route for the `docs` template.

function appDocsIndexAihu(appName: string = 'app'): string

src/pages/index.aihu for the `docs` template — a docs-flavored landing page.

function appIndexAihu(appName: string = 'app', withCssEngine = false): string

src/pages/index.aihu for Hello World (v1 syntax).

function appIndexHtml(name: string): string

index.html for a new aihu application.

function appMainTs(_name: string): string

src/main.ts entry point for a new aihu app.

function appPackageJson( name: string, pm: PkgManager = 'bun', withCssEngine = false, ): string

package.json for a new aihu application.

function appTsConfig(): string

tsconfig.json for a new aihu application.

function appViteConfig( appName = 'app', withCssEngine = false, shadowMode: ShadowChoice = 'shadow', ): string

vite.config.ts for a new aihu application.

function appVscodeExtensions(): string

.vscode/extensions.json — recommends the aihu language extension.

function appVscodeSettings(): string

.vscode/settings.json — file associations and editor wiring for .aihu.

function componentAihu(name: string): string

A component file for a given component name.

function pageAihu(routePath: string): string

A page file for a given route path.

function pluginIndex(name: string): string

src/index.ts for a new aihu plugin.

function pluginPackageJson(name: string): string

package.json for a new aihu plugin.

function scaffoldApp( name: string, outDir?: string, opts?: { pm?: PkgManager template?: AppTemplate /** `'engine'` includes `@aihu/css-engine` OOTB; `'none'` (default) is the plain scaffold. */ css?: CssChoice /** Shadow mode when css-engine is opted in. Default `'shadow'` (scoped shadow fold). */ shadowMode?: ShadowChoice }, ): ScaffoldResult

Scaffold a new aihu application at `<outDir>/<name>/`.

function scaffoldComponent(name: string, outDir?: string): ScaffoldResult

Scaffold a component file under `src/components/`.

function scaffoldPage(routePath: string, outDir?: string): ScaffoldResult

Scaffold a page file under `src/pages/`.

function scaffoldPlugin(name: string, outDir?: string): ScaffoldResult

Scaffold a plugin package directory.

function toKebab(name: string): string

function toSafe(name: string): string

Convert a project name to a safe JS identifier (for use as rolldown input key or custom-element tag name component).

interface ScaffoldResult {
  /** Files that were written. */
  readonly created: ReadonlyArray<string>
  /** Files skipped because they already existed. */
  readonly skipped: ReadonlyArray<string>
}

type AppTemplate = 'minimal' | 'full' | 'docs' | 'agent'

type CssChoice = 'engine' | 'none'

Out-of-the-box CSS strategy for a scaffolded app.

type PkgManager = 'bun' | 'pnpm' | 'npm' | 'yarn'

type ShadowChoice = 'light' | 'shadow'

Shadow-DOM mode threaded into the compiler when css-engine is opted in.