newstack 0.1.0__py3-none-any.whl

newstack/data/stacks/python-lib/template/src/{{package_name}}/core.py

@@ -0,0 +1,23 @@
+"""Core helpers for {{ title }}."""
+
+from __future__ import annotations
+
+import re
+
+_WORD_RE = re.compile(r"[A-Za-z0-9']+")
+
+
+def word_count(text: str) -> int:
+    """Return the number of words in *text*."""
+    return len(_WORD_RE.findall(text))
+
+
+def truncate(text: str, limit: int, suffix: str = "…") -> str:
+    """Shorten *text* to at most *limit* characters, appending *suffix* when cut."""
+    if limit < 0:
+        raise ValueError("limit must be >= 0")
+    if len(text) <= limit:
+        return text
+    if limit <= len(suffix):
+        return suffix[:limit]
+    return text[: limit - len(suffix)].rstrip() + suffix

newstack/data/stacks/python-lib/template/tests/test_core.py

@@ -0,0 +1,31 @@
+import pytest
+
+from {{ package_name }} import truncate, word_count
+
+
+def test_version_is_exposed() -> None:
+    import {{ package_name }}
+
+    assert {{ package_name }}.__version__ == "0.1.0"
+
+
+@pytest.mark.parametrize(
+    ("text", "expected"),
+    [("", 0), ("hello", 1), ("hello world", 2), ("it's a test, isn't it?", 5)],
+)
+def test_word_count(text: str, expected: int) -> None:
+    assert word_count(text) == expected
+
+
+def test_truncate_leaves_short_text_alone() -> None:
+    assert truncate("hello", 10) == "hello"
+
+
+def test_truncate_cuts_long_text() -> None:
+    assert truncate("hello world", 8) == "hello w…"
+    assert len(truncate("x" * 100, 20)) == 20
+
+
+def test_truncate_rejects_negative_limit() -> None:
+    with pytest.raises(ValueError):
+        truncate("abc", -1)

newstack/data/stacks/react-vite-ts/stack.json

@@ -0,0 +1,15 @@
+{
+  "name": "react-vite-ts",
+  "title": "React + Vite + TypeScript",
+  "language": "node",
+  "blurb": "SPA with Vitest + Testing Library, typed build, CI",
+  "requires": ["node", "npm", "git"],
+  "default_description": "A React single page application.",
+  "next_steps": ["cd {path}", "npm install", "npm run dev"],
+  "verify": [
+    {"name": "install", "cmd": "npm install --no-audit --no-fund --silent", "tools": ["npm"], "timeout": 900},
+    {"name": "typecheck", "cmd": "npm run typecheck", "tools": ["npm"], "timeout": 300},
+    {"name": "test", "cmd": "npm test", "tools": ["npm"], "timeout": 300},
+    {"name": "build", "cmd": "npm run build", "tools": ["npm"], "timeout": 300}
+  ]
+}

newstack/data/stacks/react-vite-ts/template/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: ["22", "24"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      # no lockfile is shipped yet: run `npm install` once locally and commit
+      # package-lock.json, then switch this to `npm ci` for reproducible installs
+      - run: npm install --no-audit --no-fund
+      - run: npm run typecheck
+      - run: npm test
+      - run: npm run build

newstack/data/stacks/react-vite-ts/template/.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+.vite/
+coverage/
+*.local
+.DS_Store
+npm-debug.log*

newstack/data/stacks/react-vite-ts/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{ year }} {{ author }}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

newstack/data/stacks/react-vite-ts/template/README.md

@@ -0,0 +1,25 @@
+# {{ title }}
+
+{{ description }}
+
+React 19 + TypeScript on Vite, tested with Vitest and Testing Library.
+
+## Develop
+
+```bash
+npm install
+npm run dev      # http://localhost:5173
+```
+
+## Check
+
+```bash
+npm run typecheck   # tsc --noEmit
+npm test            # vitest run
+npm run build       # production bundle in dist/
+```
+
+After the first `npm install`, commit `package-lock.json` and switch CI's install step
+to `npm ci` for reproducible installs.
+
+Generated with [newstack](https://github.com/DawnofGenX/newstack).

newstack/data/stacks/react-vite-ts/template/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{ title }}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

newstack/data/stacks/react-vite-ts/template/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "{{ npm_name }}",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "description": "{{ description }}",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^6.1.2",
+    "jsdom": "^30.1.3",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.5",
+    "vitest": "^5.0.5"
+  }
+}

newstack/data/stacks/react-vite-ts/template/src/App.test.tsx

@@ -0,0 +1,20 @@
+import { cleanup, fireEvent, render, screen } from "@testing-library/react";
+import { afterEach, describe, expect, it } from "vitest";
+
+import App from "./App";
+
+afterEach(cleanup);
+
+describe("App", () => {
+  it("renders the project heading", () => {
+    render(<App />);
+    expect(screen.getByRole("heading", { level: 1 }).textContent).toContain("{{ title }}");
+  });
+
+  it("increments the counter", () => {
+    render(<App />);
+    expect(screen.getByText("Count: 0")).toBeTruthy();
+    fireEvent.click(screen.getByRole("button", { name: /increment/i }));
+    expect(screen.getByText("Count: 1")).toBeTruthy();
+  });
+});

newstack/data/stacks/react-vite-ts/template/src/App.tsx

@@ -0,0 +1,15 @@
+import { useState } from "react";
+
+export default function App() {
+  const [count, setCount] = useState(0);
+
+  return (
+    <main className="app">
+      <h1>{{ title }}</h1>
+      <p>Count: {count}</p>
+      <button type="button" onClick={() => setCount((value) => value + 1)}>
+        Increment
+      </button>
+    </main>
+  );
+}

newstack/data/stacks/react-vite-ts/template/src/main.tsx

@@ -0,0 +1,16 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+
+import App from "./App";
+import "./styles.css";
+
+const container = document.getElementById("root");
+if (!container) {
+  throw new Error("#root element is missing from index.html");
+}
+
+createRoot(container).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

newstack/data/stacks/react-vite-ts/template/src/styles.css

@@ -0,0 +1,26 @@
+:root {
+  color-scheme: light dark;
+  font-family: system-ui, -apple-system, "Segoe UI", sans-serif;
+  line-height: 1.5;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  display: grid;
+  place-items: center;
+}
+
+.app {
+  text-align: center;
+  padding: 2rem;
+}
+
+button {
+  font: inherit;
+  padding: 0.5rem 1.25rem;
+  border-radius: 0.5rem;
+  border: 1px solid currentColor;
+  background: transparent;
+  cursor: pointer;
+}

newstack/data/stacks/react-vite-ts/template/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src", "vite.config.ts"]
+}

newstack/data/stacks/react-vite-ts/template/vite.config.ts

@@ -0,0 +1,10 @@
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    environment: "jsdom",
+    include: ["src/**/*.test.{ts,tsx}"],
+  },
+});

newstack/data/stacks/static-site/stack.json

@@ -0,0 +1,14 @@
+{
+  "name": "static-site",
+  "title": "Static site",
+  "language": "html",
+  "blurb": "HTML + CSS + JS landing page: node:test suite, GitHub Pages deploy",
+  "requires": ["node", "git"],
+  "default_description": "A static website.",
+  "next_steps": ["cd {path}", "node --test \"tests/**/*.test.mjs\"", "python3 -m http.server 8000"],
+  "verify": [
+    {"name": "test", "cmd": "node --test \"tests/**/*.test.mjs\"", "tools": ["node"], "timeout": 120},
+    {"name": "js-syntax", "cmd": "node --check main.js", "tools": ["node"], "timeout": 120},
+    {"name": "assets", "cmd": "test -f index.html && test -f styles.css && test -f main.js", "tools": [], "timeout": 60}
+  ]
+}

newstack/data/stacks/static-site/template/.github/workflows/deploy-pages.yml

@@ -0,0 +1,30 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/configure-pages@v6
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: .
+      - id: deployment
+        uses: actions/deploy-pages@v5

newstack/data/stacks/static-site/template/.gitignore

@@ -0,0 +1,2 @@
+.DS_Store
+node_modules/

newstack/data/stacks/static-site/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{ year }} {{ author }}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

newstack/data/stacks/static-site/template/README.md

@@ -0,0 +1,21 @@
+# {{ title }}
+
+{{ description }}
+
+Zero-build static site: plain HTML, CSS and JavaScript. Push to `main` and the
+included workflow publishes it to GitHub Pages.
+
+## Preview locally
+
+```bash
+python3 -m http.server 8000
+# or: npx serve .
+```
+
+## Publish
+
+1. Push this repository to GitHub.
+2. Settings → Pages → Source: **GitHub Actions**.
+3. The next push to `main` deploys it.
+
+Generated with [newstack](https://github.com/DawnofGenX/newstack).

newstack/data/stacks/static-site/template/index.html

@@ -0,0 +1,34 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{ title }}</title>
+    <meta name="description" content="{{ description }}" />
+    <link rel="stylesheet" href="styles.css" />
+  </head>
+  <body>
+    <header class="hero">
+      <h1>{{ title }}</h1>
+      <p>{{ description }}</p>
+      <a class="cta" href="#learn-more">Get started</a>
+    </header>
+
+    <main id="learn-more">
+      <section>
+        <h2>Fast by default</h2>
+        <p>No build step, no dependencies, no framework. Just files.</p>
+      </section>
+      <section>
+        <h2>Deploy on push</h2>
+        <p>The included workflow publishes this page to GitHub Pages.</p>
+      </section>
+    </main>
+
+    <footer>
+      <p>&copy; <span id="year"></span> {{ author }}</p>
+    </footer>
+
+    <script src="main.js"></script>
+  </body>
+</html>

newstack/data/stacks/static-site/template/main.js

@@ -0,0 +1,15 @@
+const year = document.getElementById("year");
+if (year) {
+  year.textContent = String(new Date().getFullYear());
+}
+
+for (const link of document.querySelectorAll('a[href^="#"]')) {
+  link.addEventListener("click", (event) => {
+    const targetId = link.getAttribute("href");
+    if (!targetId || targetId === "#") return;
+    const target = document.querySelector(targetId);
+    if (!target) return;
+    event.preventDefault();
+    target.scrollIntoView({ behavior: "smooth", block: "start" });
+  });
+}

newstack/data/stacks/static-site/template/styles.css

@@ -0,0 +1,74 @@
+:root {
+  --bg: #0b0d12;
+  --fg: #e8eaf0;
+  --muted: #9aa3b2;
+  --accent: #6ee7b7;
+  color-scheme: dark;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, "Segoe UI", sans-serif;
+  background: var(--bg);
+  color: var(--fg);
+  line-height: 1.6;
+}
+
+.hero {
+  min-height: 70vh;
+  display: grid;
+  align-content: center;
+  justify-items: start;
+  gap: 1rem;
+  padding: 4rem 8vw;
+}
+
+.hero h1 {
+  font-size: clamp(2.5rem, 6vw, 4.5rem);
+  margin: 0;
+  letter-spacing: -0.02em;
+}
+
+.hero p {
+  color: var(--muted);
+  font-size: 1.25rem;
+  max-width: 40ch;
+  margin: 0;
+}
+
+.cta {
+  margin-top: 1rem;
+  display: inline-block;
+  padding: 0.7rem 1.4rem;
+  border-radius: 999px;
+  background: var(--accent);
+  color: #06231a;
+  font-weight: 600;
+  text-decoration: none;
+}
+
+main {
+  display: grid;
+  gap: 2rem;
+  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+  padding: 2rem 8vw 4rem;
+}
+
+main h2 {
+  margin-bottom: 0.25rem;
+}
+
+main p {
+  color: var(--muted);
+  margin-top: 0;
+}
+
+footer {
+  padding: 2rem 8vw;
+  color: var(--muted);
+  border-top: 1px solid #1c212c;
+}

newstack/data/stacks/static-site/template/tests/site.test.mjs

@@ -0,0 +1,22 @@
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import { test } from "node:test";
+
+const read = (name) => readFile(new URL(`../${name}`, import.meta.url), "utf8");
+
+test("index.html is a complete document", async () => {
+  const html = await read("index.html");
+  assert.match(html, /<!doctype html>/i);
+  assert.match(html, /<title>.+<\/title>/);
+  assert.match(html, /<main[^>]*>/);
+  assert.match(html, /href="styles\.css"/);
+  assert.match(html, /src="main\.js"/);
+});
+
+test("styles.css styles the hero block", async () => {
+  assert.match(await read("styles.css"), /\.hero\s*\{/);
+});
+
+test("main.js wires the footer year", async () => {
+  assert.match(await read("main.js"), /getElementById\("year"\)/);
+});