create-nodebuilderjs 0.0.0-stage → 0.1.1

package/index.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+// bun create nodebuilderjs [dir] [--title "Meu App"] [--no-install] [--no-git]
+// Plain JS (not TS) so it runs under both `bun create` and `npm create`.
+import { spawnSync } from "node:child_process";
+import { cpSync, existsSync, readdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const { version } = JSON.parse(readFileSync(join(here, "package.json"), "utf8"));
+
+const { values: opts, positionals } = parseArgs({
+  allowPositionals: true,
+  options: {
+    title: { type: "string" },
+    "no-install": { type: "boolean" },
+    "no-git": { type: "boolean" },
+    help: { type: "boolean", short: "h" },
+  },
+});
+
+if (opts.help) {
+  console.log(`uso: bun create nodebuilderjs [pasta] [--title "Meu App"] [--no-install] [--no-git]`);
+  process.exit(0);
+}
+
+let dir = positionals[0];
+if (!dir) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  dir = (await rl.question("Nome do projeto: (meu-app) ")).trim() || "meu-app";
+  rl.close();
+}
+const target = resolve(dir);
+if (existsSync(target) && readdirSync(target).length) {
+  console.error(`A pasta ${dir} já existe e não está vazia.`);
+  process.exit(1);
+}
+
+const name = basename(target).toLowerCase().replace(/[^a-z0-9._-]/g, "-");
+const title = opts.title ?? basename(target).replace(/[-_.]+/g, " ").replace(/^\w/, (c) => c.toUpperCase());
+const appId = `dev.nodebuilder.${name.replace(/[^a-z0-9]/g, "_")}`;
+
+cpSync(join(here, "template"), target, { recursive: true });
+// npm drops .gitignore from published packages, so the template ships it as _gitignore.
+renameSync(join(target, "_gitignore"), join(target, ".gitignore"));
+
+const fill = (file) => {
+  const path = join(target, file);
+  writeFileSync(path, readFileSync(path, "utf8").replaceAll("{{title}}", title).replaceAll("{{appId}}", appId));
+};
+["src/App.tsx", "README.md"].forEach(fill);
+
+const pkg = {
+  name,
+  version: "0.1.0",
+  private: true,
+  type: "module",
+  scripts: {
+    start: "bun src/main.tsx",
+    dev: "bun --watch src/main.tsx",
+    test: "bun test",
+    typecheck: "tsc --noEmit",
+    package: `nodebuilder package src/main.tsx --title "${title}" --app-id ${appId}`,
+  },
+  dependencies: { "@nodebuilderjs/core": `^${version}` },
+  devDependencies: { "@types/bun": "^1.4.2", typescript: "7.0.2" },
+};
+writeFileSync(join(target, "package.json"), `${JSON.stringify(pkg, null, 2)}\n`);
+
+const run = (cmd, args) => spawnSync(cmd, args, { cwd: target, stdio: "inherit" }).status === 0;
+const hasBun = spawnSync("bun", ["--version"], { stdio: "ignore" }).status === 0;
+
+if (!opts["no-install"]) {
+  if (!hasBun) console.warn("Bun não encontrado: instale em https://bun.sh e rode `bun install`.");
+  else if (!run("bun", ["install"])) console.warn("`bun install` falhou; rode de novo dentro da pasta.");
+}
+if (!opts["no-git"] && spawnSync("git", ["--version"], { stdio: "ignore" }).status === 0) {
+  run("git", ["init", "-q"]);
+}
+
+const cd = relative(process.cwd(), target) || ".";
+console.log(`
+Pronto! ${title} criado em ${cd}
+
+  cd ${cd}
+  bun run dev        # abre a janela e recarrega ao salvar
+  bun test           # testes sem janela
+  bun run package    # AppImage, .deb, .rpm e .tar.gz em dist/
+`);

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "create-nodebuilderjs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Cria um app nodebuilder: bun create nodebuilderjs meu-app",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/felipebrgs1/nodebuilderjs.git",
+    "directory": "packages/create-nodebuilderjs"
+  },
+  "homepage": "https://github.com/felipebrgs1/nodebuilderjs#readme",
+  "bugs": "https://github.com/felipebrgs1/nodebuilderjs/issues",
+  "bin": {
+    "create-nodebuilderjs": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "template"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/template/AGENTS.md

@@ -0,0 +1,29 @@
+# AGENTS.md
+
+App nodebuilder: UI nativa para Linux em TSX, **sem DOM e sem React**. Leia antes de mudar código.
+
+## Comandos
+- `bun run dev` abre o app; `bun test` roda os testes sem janela; `bun run typecheck` checa tipos.
+- Antes de concluir: `bun run typecheck && bun test`.
+
+## Modelo (igual ao SolidJS, não ao React)
+- **Componentes rodam uma vez.** Não há re-render nem hooks. Estado é `createSignal`;
+  derivados são `createMemo`; efeitos são `createEffect` (+ `onCleanup`).
+- **Só funções são reativas.** `<Text>{count}</Text>` ou `text={() => ...}` atualizam;
+  `<Text>{count()}</Text>` é lido uma vez e nunca muda. O mesmo vale para estilo:
+  `background={() => (ativo() ? "#3584e4" : "#0000")}`.
+- Listas: `<For each={lista}>{(item) => ...}</For>` (chave por referência). Condicional:
+  `<Show when={() => ...} fallback={...}>`.
+
+## Widgets e estilo
+- `Window` (raiz, uma por app), `Column`/`Row`/`Box`, `Scroll`, `Text`, `Button`, `TextField`,
+  `Checkbox`, `Card`, `Divider`, `Spacer`. Tudo vem de `@nodebuilderjs/core`.
+- Estilo são props planas, não CSS: `padding`, `gap`, `grow`, `align`, `justify`, `width`,
+  `height`, `background`, `radius`, `borderWidth`, `borderColor`, `color`, `fontSize`, `bold`.
+  Layout é flexbox; `align` padrão é `stretch`. `color`, `fontSize` e `bold` são herdados.
+- Cores padrão em `theme` (`theme.text.secondary`, `theme.accent.base`...).
+- Não existem `className`, `style={{}}`, `div`, `span`, `onChange` de DOM nem `useState`.
+
+## Testes
+- `@nodebuilderjs/core/testing`: `mount(() => <App />)`, `findByText(root, "texto")`,
+  `click(node)` (sobe até o pai clicável). Métricas de texto falsas: 8 px por caractere.

package/template/README.md

@@ -0,0 +1,14 @@
+# {{title}}
+
+App desktop nativo para Linux feito com [nodebuilder](https://www.npmjs.com/package/@nodebuilderjs/core):
+componentes TSX com reatividade estilo SolidJS, desenhados por um núcleo nativo (Wayland/X11 + GLES).
+
+```sh
+bun run dev        # abre a janela e reinicia ao salvar
+bun start          # roda uma vez
+bun test           # testes sem janela (test/)
+bun run typecheck  # TypeScript 7
+bun run package    # AppImage, .deb, .rpm e .tar.gz em dist/
+```
+
+Requisitos: Linux com Wayland ou X11, [Bun](https://bun.sh) 1.4+.

package/template/_gitignore

@@ -0,0 +1,2 @@
+node_modules/
+dist/

package/template/src/App.tsx

@@ -0,0 +1,24 @@
+import { Button, Column, Row, Text, Window, createSignal, theme } from "@nodebuilderjs/core";
+
+export function App() {
+  const [count, setCount] = createSignal(0);
+  const times = () => `Você clicou ${count()} ${count() === 1 ? "vez" : "vezes"}`;
+
+  return (
+    <Window title="{{title}}" appId="{{appId}}" width={480} height={360}>
+      <Column grow={1} align="center" justify="center" gap={16} padding={24}>
+        <Text fontSize={24} bold>
+          {"{{title}}"}
+        </Text>
+        <Text color={theme.text.secondary}>{times}</Text>
+        <Row gap={8}>
+          <Button label="Zerar" variant="flat" onClick={() => setCount(0)} />
+          <Button label="Clique aqui" variant="primary" onClick={() => setCount((c) => c + 1)} />
+        </Row>
+        <Text fontSize={12} color={theme.text.secondary}>
+          Edite src/App.tsx e salve: o bun run dev reabre a janela.
+        </Text>
+      </Column>
+    </Window>
+  );
+}

package/template/src/main.tsx

@@ -0,0 +1,4 @@
+import { run } from "@nodebuilderjs/core";
+import { App } from "./App.js";
+
+run(() => <App />);

package/template/test/App.test.tsx

@@ -0,0 +1,14 @@
+import { expect, test } from "bun:test";
+import { click, findByText, mount } from "@nodebuilderjs/core/testing";
+import { App } from "../src/App.js";
+
+test("o botão conta os cliques", () => {
+  const { root } = mount(() => <App />);
+  expect(findByText(root, "Você clicou 0 vezes")).toBeDefined();
+
+  click(findByText(root, "Clique aqui")!);
+  expect(findByText(root, "Você clicou 1 vez")).toBeDefined();
+
+  click(findByText(root, "Zerar")!);
+  expect(findByText(root, "Você clicou 0 vezes")).toBeDefined();
+});

package/template/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "jsxImportSource": "@nodebuilderjs/core",
+    "skipLibCheck": true,
+    "types": ["bun"]
+  },
+  "include": ["src", "test"]
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.