@raulmoracode/create 1.0.0

package/dist/config/agents.js

@@ -0,0 +1,224 @@
+export function agentsMd() {
+    return [
+        "# AGENTS.md",
+        "",
+        "## Project guidelines",
+        "",
+        "This project was initially generated with `@raulmoracode/create`.",
+        "",
+        "Treat the current repository state as the source of truth. Do not assume that the original scaffold configuration, dependencies, scripts, or architecture are still unchanged.",
+        "",
+        "Before making changes, inspect the existing codebase and its configuration.",
+        "",
+        "## General principles",
+        "",
+        "- Follow existing project conventions and patterns.",
+        "- Prefer simple, focused solutions over unnecessary abstractions.",
+        "- Reuse existing components, utilities, hooks, and patterns when appropriate.",
+        "- Avoid duplicating functionality that already exists.",
+        "- Keep changes scoped to the requested task.",
+        "- Do not modify unrelated files.",
+        "- Preserve existing user changes.",
+        "- Do not introduce a new library when the existing project can reasonably solve the problem.",
+        "- Do not remove or replace existing dependencies without a clear reason.",
+        "- Do not reintroduce dependencies that have been intentionally removed.",
+        "",
+        "## Dependencies and configuration",
+        "",
+        "Always inspect the current `package.json` before using or adding a dependency.",
+        "",
+        "Do not assume that a dependency is installed because it may have been included in the original scaffold.",
+        "",
+        "Treat the following files as sources of truth for the current project configuration:",
+        "",
+        "- `package.json`",
+        "- `pnpm-lock.yaml`",
+        "- `tsconfig.json`",
+        "- `biome.json`",
+        "- `components.json`",
+        "- `.nvmrc`",
+        "- `.npmrc`",
+        "- framework-specific configuration files",
+        "",
+        "Use the package manager already configured by the project.",
+        "",
+        "Do not change package managers unless explicitly requested.",
+        "",
+        "## Project tooling",
+        "",
+        "This project uses pnpm exclusively. Never use npm or yarn.",
+        "",
+        "Available scripts (see `package.json` for the full list):",
+        "",
+        "- `pnpm dev` — start the development server.",
+        "- `pnpm build` — create a production build.",
+        "- `pnpm test` — run the test suite.",
+        "- `pnpm check` — run the formatter and linter check.",
+        "- `pnpm format` — apply formatting.",
+        "- `pnpm lint` — run the linter.",
+        "",
+        "UI components come from shadcn. Add new components with:",
+        "",
+        "```bash",
+        "pnpm dlx shadcn@latest add <component>",
+        "```",
+        "",
+        "Do not hand-write component files under the shadcn UI directory. Follow `components.json`, including the `@raulmoracode` registry.",
+        "",
+        "## Code style",
+        "",
+        "Follow the existing code style and project structure.",
+        "",
+        "Use the project's configured formatter and linter.",
+        "",
+        "Do not introduce ESLint, Prettier, or another formatting/linting system when an existing project tool already provides that functionality, unless explicitly requested.",
+        "",
+        "Prefer readable and maintainable code over clever implementations.",
+        "",
+        "Avoid unnecessary comments. Add comments when they explain a non-obvious decision or constraint.",
+        "",
+        "## Components and UI",
+        "",
+        "Before creating a new component, check whether an existing component already provides the required functionality.",
+        "",
+        "Prefer composition and reuse over duplicated UI implementations.",
+        "",
+        "If the project uses shadcn, follow the existing shadcn configuration and component conventions.",
+        "",
+        "Do not manually recreate a component when an appropriate existing project component can be reused.",
+        "",
+        "## Architecture",
+        "",
+        "Follow the architecture already present in the repository.",
+        "",
+        "Do not introduce a new architectural pattern solely because it is personally preferred.",
+        "",
+        "When adding functionality:",
+        "",
+        "1. Identify the existing pattern used for similar functionality.",
+        "2. Follow that pattern when appropriate.",
+        "3. Keep the implementation close to the relevant feature.",
+        "4. Avoid creating generic abstractions before they are actually needed.",
+        "",
+        "For framework-specific behavior, follow the conventions of the framework version currently installed in the project.",
+        "",
+        "## Validation",
+        "",
+        "Inspect `package.json` to determine the available scripts before running commands.",
+        "",
+        "After making changes, run the most relevant validation commands for the affected code.",
+        "",
+        "For substantial changes, prefer running:",
+        "",
+        "```bash",
+        "pnpm check",
+        "pnpm test",
+        "pnpm build",
+        "```",
+        "",
+        "Do not claim that a change is complete if the relevant validation has not been performed.",
+        "",
+        "If a validation command fails because of an unrelated pre-existing problem, distinguish that from problems introduced by the current change.",
+        "",
+        "## Git",
+        "",
+        "Never use destructive Git commands unless explicitly requested.",
+        "",
+        "Do not use:",
+        "",
+        "```bash",
+        "git push --force",
+        "git push -f",
+        "git reset --hard",
+        "git clean -fd",
+        "```",
+        "",
+        "Do not rewrite existing history unnecessarily.",
+        "",
+        "Do not discard or overwrite uncommitted user changes.",
+        "",
+        "Before modifying files, be aware of the current Git state when relevant.",
+        "",
+        "Do not commit changes unless explicitly requested.",
+        "",
+        "## Git hooks and commits",
+        "",
+        "Husky manages the Git hooks.",
+        "",
+        "`pre-commit` runs:",
+        "",
+        "```bash",
+        "pnpm check",
+        "pnpm test",
+        "```",
+        "",
+        "`commit-msg` runs Commitlint.",
+        "",
+        "Commits must follow Conventional Commits.",
+        "",
+        "Valid commit examples:",
+        "",
+        "```text",
+        "feat: add user profile",
+        "fix: handle invalid input",
+        "refactor: extract API client",
+        "test: add query client tests",
+        "docs: update project guide",
+        "chore: update dependencies",
+        "```",
+        "",
+        "Do not bypass hooks with `--no-verify` unless explicitly requested.",
+        "",
+        "Keep the project passing:",
+        "",
+        "```bash",
+        "pnpm check",
+        "pnpm test",
+        "pnpm build",
+        "```",
+        "",
+        "## Security",
+        "",
+        "Do not expose, commit, or hard-code secrets, API keys, access tokens, passwords, or credentials.",
+        "",
+        "Never replace environment variables with hard-coded credentials.",
+        "",
+        "Treat `.env` and other environment-specific files as sensitive.",
+        "",
+        "Do not weaken existing security mechanisms merely to make a task easier.",
+        "",
+        "## Dependency changes",
+        "",
+        "Before adding a dependency:",
+        "",
+        "1. Check whether the functionality already exists in the project.",
+        "2. Check whether an existing dependency can provide it.",
+        "3. Consider whether the dependency is actually necessary.",
+        "4. Use the package manager configured by the project.",
+        "5. Keep dependency versions consistent with the project's existing conventions.",
+        "",
+        "Avoid adding dependencies for trivial functionality that can be implemented safely with the existing stack.",
+        "",
+        "## Working with existing code",
+        "",
+        "Do not rewrite working code unnecessarily.",
+        "",
+        "Prefer the smallest change that correctly solves the requested problem.",
+        "",
+        "When modifying existing functionality, preserve its current behavior unless the task explicitly requires changing it.",
+        "",
+        "If the requested change conflicts with an existing architectural decision, inspect the relevant code and configuration before deciding how to proceed.",
+        "",
+        "## Final response",
+        "",
+        "When completing a task, briefly report:",
+        "",
+        "- What was changed.",
+        "- Which files were modified.",
+        "- What validation was performed.",
+        "- Any relevant issues or limitations that remain.",
+        "",
+        "Do not claim tests, builds, or other commands were executed if they were not actually run.",
+        "",
+    ].join("\n");
+}

package/dist/config/biome.js

@@ -0,0 +1,30 @@
+export function biomeConfig() {
+    return `${JSON.stringify({
+        $schema: "./node_modules/@biomejs/biome/configuration_schema.json",
+        files: {
+            includes: ["**", "!dist", "!.next"],
+        },
+        formatter: {
+            enabled: true,
+            indentStyle: "space",
+            indentWidth: 2,
+        },
+        assist: {
+            enabled: true,
+            actions: {
+                source: {
+                    organizeImports: "on",
+                },
+            },
+        },
+        linter: {
+            enabled: true,
+            rules: {
+                a11y: {
+                    noSvgWithoutTitle: "off",
+                    noAmbiguousAnchorText: "off",
+                },
+            },
+        },
+    }, null, 2)}\n`;
+}

package/dist/config/branding.js

@@ -0,0 +1,2 @@
+export const SITE_TITLE = "raulmoracode";
+export const FAVICON_URL = "https://cdn.raulmoracode.com/icons/favicon.ico";

package/dist/config/commitlint.js

@@ -0,0 +1,8 @@
+export function commitlintConfig() {
+    return [
+        "export default {",
+        '  extends: ["@commitlint/config-conventional"],',
+        "};",
+        "",
+    ].join("\n");
+}

package/dist/config/components.js

@@ -0,0 +1,36 @@
+export const RAULMORACODE_REGISTRY_NAME = "@raulmoracode";
+export const RAULMORACODE_REGISTRY_URL = "https://registry.raulmoracode.com/r/{name}.json";
+export function componentsJson(options) {
+    return `${JSON.stringify({
+        $schema: "https://ui.shadcn.com/schema.json",
+        style: "new-york",
+        rsc: options.rsc,
+        tsx: true,
+        tailwind: {
+            css: options.tailwindCssPath,
+            baseColor: "neutral",
+            cssVariables: true,
+        },
+        aliases: {
+            components: "@/components",
+            ui: "@/components/ui",
+            lib: "@/lib",
+            hooks: "@/hooks",
+            utils: "@/lib/utils",
+        },
+        registries: {
+            [RAULMORACODE_REGISTRY_NAME]: RAULMORACODE_REGISTRY_URL,
+        },
+    }, null, 2)}\n`;
+}
+export function utilsTs() {
+    return [
+        'import { clsx, type ClassValue } from "clsx";',
+        'import { twMerge } from "tailwind-merge";',
+        "",
+        "export function cn(...inputs: ClassValue[]) {",
+        "  return twMerge(clsx(inputs));",
+        "}",
+        "",
+    ].join("\n");
+}

package/dist/config/editorconfig.js

@@ -0,0 +1,14 @@
+export function editorconfigContent() {
+    return [
+        "root = true",
+        "",
+        "[*]",
+        "charset = utf-8",
+        "end_of_line = lf",
+        "indent_style = space",
+        "indent_size = 2",
+        "insert_final_newline = true",
+        "trim_trailing_whitespace = true",
+        "",
+    ].join("\n");
+}

package/dist/config/husky.js

@@ -0,0 +1,14 @@
+import { FULL_TECH_SELECTION } from "./tech.js";
+export function huskyPreCommit(selection = FULL_TECH_SELECTION) {
+    const lines = [];
+    if (selection.biome) {
+        lines.push("pnpm check");
+    }
+    if (selection.testing) {
+        lines.push("pnpm test");
+    }
+    return [...lines, ""].join("\n");
+}
+export function huskyCommitMsg() {
+    return ['pnpm exec commitlint --edit "$1"', ""].join("\n");
+}

package/dist/config/npmrc.js

@@ -0,0 +1,3 @@
+export function npmrcContent() {
+    return `@raulmoracode:registry=https://npm.pkg.github.com\n//npm.pkg.github.com/:_authToken=\${GH_TOKEN}\n`;
+}

package/dist/config/nvmrc.js

@@ -0,0 +1,4 @@
+export const NODE_VERSION = "24";
+export function nvmrcContent() {
+    return `${NODE_VERSION}\n`;
+}

package/dist/config/pnpm-workspace.js

@@ -0,0 +1,85 @@
+export const PNPM_MINIMUM_RELEASE_AGE = 10080;
+export function pnpmWorkspaceYaml() {
+    return `minimumReleaseAge: ${PNPM_MINIMUM_RELEASE_AGE}\n`;
+}
+const DEPENDENCY_SECTIONS = [
+    "dependencies",
+    "devDependencies",
+    "optionalDependencies",
+    "peerDependencies",
+];
+export function collectLockedPackages(tree) {
+    const found = new Set();
+    const visit = (node) => {
+        if (!node || typeof node !== "object") {
+            return;
+        }
+        const record = node;
+        for (const section of DEPENDENCY_SECTIONS) {
+            const deps = record[section];
+            if (!deps || typeof deps !== "object") {
+                continue;
+            }
+            for (const [name, child] of Object.entries(deps)) {
+                if (!child || typeof child !== "object") {
+                    continue;
+                }
+                const version = child.version;
+                if (typeof version === "string" && version.length > 0) {
+                    found.add(`${name}@${version}`);
+                }
+                visit(child);
+            }
+        }
+    };
+    if (Array.isArray(tree)) {
+        for (const project of tree) {
+            visit(project);
+        }
+    }
+    else {
+        visit(tree);
+    }
+    return [...found].sort();
+}
+export function mergePnpmWorkspaceYaml(existing, excludePackages = []) {
+    const releaseLine = `minimumReleaseAge: ${PNPM_MINIMUM_RELEASE_AGE}`;
+    const base = !existing || existing.trim() === "" ? "" : existing;
+    const lines = base === "" ? [] : base.split("\n");
+    while (lines.length > 0 && (lines[lines.length - 1]?.trim() ?? "") === "") {
+        lines.pop();
+    }
+    const preserved = [];
+    const existingExcludes = [];
+    let inExcludeBlock = false;
+    for (const line of lines) {
+        if (/^minimumReleaseAge\s*:/.test(line)) {
+            continue;
+        }
+        if (/^minimumReleaseAgeExclude\s*:/.test(line)) {
+            inExcludeBlock = true;
+            continue;
+        }
+        if (inExcludeBlock) {
+            const item = /^\s*-\s*(.+?)\s*$/.exec(line);
+            if (item?.[1]) {
+                existingExcludes.push(item[1]);
+                continue;
+            }
+            if (line.trim() === "") {
+                continue;
+            }
+            inExcludeBlock = false;
+        }
+        preserved.push(line);
+    }
+    const excludes = [...new Set([...existingExcludes, ...excludePackages])];
+    const out = [releaseLine, ...preserved];
+    if (excludes.length > 0) {
+        out.push("minimumReleaseAgeExclude:");
+        for (const pkg of excludes) {
+            out.push(`  - '${pkg}'`);
+        }
+    }
+    return `${out.join("\n")}\n`;
+}

package/dist/config/query.js

@@ -0,0 +1,16 @@
+export function queryClientConfig() {
+    return [
+        'import { QueryClient } from "@tanstack/react-query";',
+        "",
+        "export const queryClient = new QueryClient({",
+        "  defaultOptions: {",
+        "    queries: {",
+        "      staleTime: 60 * 1000,",
+        "      gcTime: 5 * 60 * 1000,",
+        "      retry: false,",
+        "    },",
+        "  },",
+        "});",
+        "",
+    ].join("\n");
+}

package/dist/config/tailwind.js

@@ -0,0 +1,31 @@
+export function tailwindCss() {
+    return '@import "tailwindcss";\n';
+}
+export function viteTailwindConfig() {
+    return [
+        'import { fileURLToPath, URL } from "node:url";',
+        'import { defineConfig } from "vite";',
+        'import react from "@vitejs/plugin-react";',
+        'import tailwindcss from "@tailwindcss/vite";',
+        "",
+        "export default defineConfig({",
+        "  plugins: [react(), tailwindcss()],",
+        "  resolve: {",
+        "    alias: {",
+        '      "@": fileURLToPath(new URL("./src", import.meta.url)),',
+        "    },",
+        "  },",
+        "});",
+        "",
+    ].join("\n");
+}
+export function nextPostcssConfig() {
+    return [
+        "const config = {",
+        '  plugins: ["@tailwindcss/postcss"],',
+        "};",
+        "",
+        "export default config;",
+        "",
+    ].join("\n");
+}

package/dist/config/tech.js

@@ -0,0 +1,83 @@
+export const TECH_IDS = [
+    "tailwind",
+    "shadcn",
+    "tanstack-query",
+    "zustand",
+    "forms",
+    "registry",
+    "biome",
+    "testing",
+    "husky",
+    "vscode",
+];
+export const TECH_OPTIONS = [
+    { id: "tailwind", label: "Tailwind CSS", hint: "Estilos con Tailwind 4" },
+    {
+        id: "shadcn",
+        label: "shadcn",
+        hint: "components.json + cn() (requiere Tailwind)",
+    },
+    {
+        id: "tanstack-query",
+        label: "TanStack Query",
+        hint: "QueryClient + provider",
+    },
+    { id: "zustand", label: "Zustand", hint: "Estado global" },
+    {
+        id: "forms",
+        label: "React Hook Form + Zod",
+        hint: "Formularios con validación",
+    },
+    {
+        id: "registry",
+        label: "Registro @raulmoracode",
+        hint: ".npmrc + @raulmoracode/icons",
+    },
+    {
+        id: "biome",
+        label: "Biome",
+        hint: "Formato, lint y scripts check/format/lint",
+    },
+    {
+        id: "testing",
+        label: "Testing",
+        hint: "Vitest + Testing Library y script test",
+    },
+    {
+        id: "husky",
+        label: "Husky + Commitlint",
+        hint: "Git hooks y Conventional Commits",
+    },
+    {
+        id: "vscode",
+        label: "VS Code",
+        hint: ".vscode/settings.json + extensions.json",
+    },
+];
+export const FULL_TECH_SELECTION = {
+    tailwind: true,
+    shadcn: true,
+    "tanstack-query": true,
+    zustand: true,
+    forms: true,
+    registry: true,
+    biome: true,
+    testing: true,
+    husky: true,
+    vscode: true,
+};
+export function resolveTechSelection(input) {
+    const selection = { ...input };
+    const notes = [];
+    if (selection.shadcn && !selection.tailwind) {
+        selection.tailwind = true;
+        notes.push("shadcn necesita Tailwind CSS: se mantiene Tailwind.");
+    }
+    return { selection, notes };
+}
+export function applyPrivateAccess(selection, hasPrivateAccess) {
+    if (hasPrivateAccess) {
+        return selection;
+    }
+    return { ...selection, registry: false };
+}

package/dist/config/testing.js

@@ -0,0 +1,26 @@
+export function vitestConfig() {
+    return [
+        'import { defineConfig } from "vitest/config";',
+        "",
+        "export default defineConfig({",
+        "  test: {",
+        '    environment: "jsdom",',
+        "  },",
+        "});",
+        "",
+    ].join("\n");
+}
+export function smokeTest() {
+    return [
+        'import { render, screen } from "@testing-library/react";',
+        'import { describe, expect, it } from "vitest";',
+        "",
+        'describe("testing setup", () => {',
+        '  it("renders with the jsdom environment", () => {',
+        "    render(<h1>raulmoracode</h1>);",
+        '    expect(screen.getByRole("heading", { name: "raulmoracode" })).toBeDefined();',
+        "  });",
+        "});",
+        "",
+    ].join("\n");
+}

package/dist/config/vscode.js

@@ -0,0 +1,39 @@
+export function vscodeSettings() {
+    return `${JSON.stringify({
+        "editor.defaultFormatter": "biomejs.biome",
+        "editor.formatOnSave": true,
+        "editor.codeActionsOnSave": {
+            "quickfix.biome": "explicit",
+            "source.organizeImports.biome": "explicit",
+        },
+        "[javascript]": {
+            "editor.defaultFormatter": "biomejs.biome",
+        },
+        "[javascriptreact]": {
+            "editor.defaultFormatter": "biomejs.biome",
+        },
+        "[typescript]": {
+            "editor.defaultFormatter": "biomejs.biome",
+        },
+        "[typescriptreact]": {
+            "editor.defaultFormatter": "biomejs.biome",
+        },
+        "[json]": {
+            "editor.defaultFormatter": "biomejs.biome",
+        },
+        "[jsonc]": {
+            "editor.defaultFormatter": "biomejs.biome",
+        },
+        "editor.insertSpaces": true,
+        "editor.tabSize": 2,
+        "editor.detectIndentation": false,
+        "files.trimTrailingWhitespace": true,
+        "files.insertFinalNewline": true,
+        "js/ts.tsdk.path": "node_modules/typescript/lib",
+    }, null, 2)}\n`;
+}
+export function vscodeExtensions() {
+    return `${JSON.stringify({
+        recommendations: ["biomejs.biome"],
+    }, null, 2)}\n`;
+}

package/dist/frameworks/index.js

@@ -0,0 +1,9 @@
+import { nextFramework } from "./next.js";
+import { viteFramework } from "./vite.js";
+export const frameworks = {
+    vite: viteFramework,
+    next: nextFramework,
+};
+export function getFramework(id) {
+    return frameworks[id];
+}