@quadratz/qz-scaff 1.0.3

package/README.md

@@ -0,0 +1,9 @@
+# qz-scaff
+
+A personal-use Bun CLI for scaffolding projects from templates.
+
+## Usage
+
+```sh
+bunx @quadratz/qz-scaff
+```

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@quadratz/qz-scaff",
+  "type": "module",
+  "version": "1.0.3",
+  "description": "A personal-use Bun CLI for scaffolding projects from templates.",
+  "author": "Quadratz",
+  "license": "MIT",
+  "homepage": "https://github.com/Quadratz-Org/qz-scaff#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Quadratz-Org/qz-scaff.git"
+  },
+  "bugs": "https://github.com/Quadratz-Org/qz-scaff/issues",
+  "exports": {
+    ".": "./dist/mod.ts",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "template"
+  ],
+  "scripts": {
+    "dev": "bun src/mod.ts",
+    "fmt": "prettier . --write",
+    "check": "prettier . --check && eslint . && tsc --noEmit",
+    "release": "bumpp --commit --push --tag"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/bun": "latest",
+    "bumpp": "^10.4.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "3.8.1",
+    "typescript-eslint": "^8.55.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.1"
+  },
+  "module": "index.ts",
+  "private": false,
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "prettier": {}
+}

package/src/mod.ts

@@ -0,0 +1,65 @@
+/**
+ * A personal-use Bun CLI for scaffolding projects from templates.
+ *
+ * @example
+ * ```sh
+ * bunx @quadratz/qz-scaff
+ * ```
+ */
+
+import type { Response } from "./types.ts";
+import { scaffoldProject } from "./scaffold-project.ts";
+import { group, intro, outro, text } from "@clack/prompts";
+import { prepareDestination } from "./prepare-destination.ts";
+import pkg from "../package.json" with { type: "json" };
+import { handleCancel, validateString } from "./utils.ts";
+
+await main();
+
+/**
+ * Main entry point for the scaffolding CLI.
+ */
+async function main(): Promise<void> {
+  intro(`Qz Project Scaffold v${pkg.version}`);
+
+  const response = (await group(
+    {
+      name: () =>
+        text({
+          message: "Package name:",
+          validate: (value) => {
+            if (!value || value.length === 0) return "Name is required";
+            if (!/^[a-z0-9-]+$/.test(value)) {
+              return "Name can only contain lowercase letters, numbers, and hyphens";
+            }
+            if (value.length > 214) return "Name is too long";
+          },
+        }),
+      description: () =>
+        text({
+          message: "Package description:",
+          validate: validateString,
+        }),
+      keywords: () => text({ message: `Keywords:` }),
+      destination: ({ results: { name } }) => {
+        const path = `./${name ?? ""}`;
+        return text({
+          message: `Project location:`,
+          placeholder: path,
+          defaultValue: path,
+        });
+      },
+    },
+    {
+      onCancel: handleCancel,
+    },
+  )) as Response;
+
+  // Validate and prepare the destination directory.
+  response.destination = await prepareDestination(response.destination);
+
+  // Scaffold the project.
+  await scaffoldProject(response);
+
+  outro("Selesai!");
+}

package/src/prepare-destination.ts

@@ -0,0 +1,74 @@
+import { resolve } from "node:path";
+import { rm } from "node:fs/promises";
+import { select } from "@clack/prompts";
+import { checkCancel, isDirEmpty, promptNewPath } from "./utils.ts";
+import { stat } from "node:fs/promises";
+
+export { prepareDestination };
+
+/**
+ * Recursive function to validate and prepare the destination path.
+ *
+ * Handles existing directories, non-empty directories, and file conflicts.
+ *
+ * @param inputPath - The path provided by the user.
+ * @returns The resolved, valid destination path.
+ */
+async function prepareDestination(inputPath: string): Promise<string> {
+  // Use resolve instead of realPath to allow non-existent paths.
+  const dest = resolve(inputPath);
+
+  try {
+    const destStat = await stat(dest);
+
+    // Case 1: Path exists and is a file.
+    if (!destStat.isDirectory()) {
+      const answer = await select({
+        message: "The destination exists but is not a directory. Action?",
+        options: [
+          { value: "new-path", label: "Pick a new location" },
+          { value: "cancel", label: "Cancel" },
+        ],
+      });
+      checkCancel(answer);
+      return await promptNewPath();
+    }
+
+    // Case 2: Path exists and is a Directory -> Check if empty.
+    if (await isDirEmpty(dest)) return dest;
+
+    // Case 3: Directory is not empty.
+    const answer = await select({
+      message: "The destination directory is not empty. Action?",
+      options: [
+        {
+          value: "remove-dir",
+          label: "Remove the directory",
+        },
+        { value: "overwrite-dir", label: "Merge/Overwrite existing files" },
+        { value: "new-path", label: "Pick a new location" },
+        { value: "cancel", label: "Cancel" },
+      ],
+    });
+
+    checkCancel(answer);
+
+    switch (answer) {
+      case "remove-dir":
+        await rm(dest, { recursive: true, force: true });
+        return dest;
+
+      case "overwrite-dir":
+        return dest;
+
+      default:
+        return await promptNewPath();
+    }
+  } catch (error) {
+    // Case 4: Path does not exist (stat threw NotFound).
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return dest; // Directory will be created by ensureDir later.
+    }
+    throw error; // Unexpected error.
+  }
+}

package/src/scaffold-project.ts

@@ -0,0 +1,87 @@
+import type { Response } from "./types.ts";
+import { join, basename } from "node:path";
+import { mkdir, readdir, cp } from "node:fs/promises";
+import npmPkg from "../template/package.json" with { type: "json" };
+
+export { scaffoldProject };
+
+/** Base URL for the organization's GitHub. */
+const GITHUB_BASE_URL = "https://github.com/Quadratz-Org/";
+
+/**
+ * Writes the project files to the destination.
+ * @param resp - The collected user responses.
+ */
+async function scaffoldProject(resp: Response): Promise<void> {
+  const { destination, name, description, keywords } = resp;
+
+  // Ensure directory exists before writing specific files.
+  await mkdir(destination, { recursive: true });
+
+  const promises: Promise<number>[] = [];
+  const repoUrl = `${GITHUB_BASE_URL}${name}`;
+
+  // 1. Prepare and write package.json
+  const finalPkg = {
+    ...npmPkg,
+    name,
+    description,
+    keywords: keywords.split(" ").filter(Boolean),
+    homepage: repoUrl,
+    repository: { url: `git+${repoUrl}.git` },
+    bugs: `${repoUrl}/issues`,
+  };
+
+  promises.push(
+    Bun.write(
+      join(destination, "package.json"),
+      JSON.stringify(finalPkg, null, 2),
+    ),
+  );
+
+  const [contributingTxt, readmeTxt] = await Promise.all([
+    Bun.file(new URL("../template/CONTRIBUTING.md", import.meta.url)).text(),
+    Bun.file(new URL("../template/README.md", import.meta.url)).text(),
+  ]);
+
+  // 2. Write CONTRIBUTING.md
+  promises.push(
+    Bun.write(
+      join(destination, "CONTRIBUTING.md"),
+      contributingTxt.replaceAll("{{PACKAGE_NAME}}", name),
+    ),
+  );
+
+  // 3. Write README.md
+  promises.push(
+    Bun.write(
+      join(destination, "README.md"),
+      readmeTxt
+        .replaceAll("{{PACKAGE_NAME}}", name)
+        .replace("{{DESCRIPTION}}", description),
+    ),
+  );
+
+  await Promise.all(promises);
+
+  // 4. Copy remaining template files
+  const templatePath = new URL("../template", import.meta.url);
+  const copyPromises: Promise<void>[] = [];
+  const excludedFiles = new Set([
+    "CONTRIBUTING.md",
+    "package.json",
+    "README.md",
+  ]);
+
+  for (const source of await readdir(templatePath)) {
+    const fileName = basename(source);
+
+    if (excludedFiles.has(fileName)) continue;
+
+    copyPromises.push(
+      cp(source, join(destination, fileName), { force: true, recursive: true }),
+    );
+  }
+
+  await Promise.all(copyPromises);
+}

package/src/types.ts

@@ -0,0 +1,15 @@
+export type { Response };
+
+/**
+ * Interface representing the user's input responses.
+ */
+interface Response {
+  /** The name of the package. */
+  name: string;
+  /** A short description of the package. */
+  description: string;
+  /** Space-separated keywords for npm package.json. */
+  keywords: string;
+  /** The target directory path for the project. */
+  destination: string;
+}

package/src/utils.ts

@@ -0,0 +1,60 @@
+import { cancel, isCancel, text } from "@clack/prompts";
+import { prepareDestination } from "./prepare-destination.ts";
+import { readdir } from "node:fs/promises";
+
+export { checkCancel, handleCancel, isDirEmpty, promptNewPath, validateString };
+
+/**
+ * Validates that a string input is not empty.
+ *
+ * @param value - The user input.
+ * @returns Error message if invalid, undefined otherwise.
+ */
+function validateString(value?: string): string | undefined {
+  if (!value || value.trim().length === 0) return "This field is required!";
+}
+
+/**
+ * Handles the cancellation of the prompt sequence.
+ */
+function handleCancel(): never {
+  cancel("Installation cancelled!");
+  process.exit(1);
+}
+
+/**
+ * Checks a prompt answer for cancellation tokens.
+ *
+ * @param answer - The value returned from a prompt.
+ */
+function checkCancel(answer: string | symbol): asserts answer is string {
+  if (isCancel(answer) || answer === "cancel") {
+    handleCancel();
+  }
+}
+
+/**
+ * Checks if a directory contains any files.
+ *
+ * @param dest - The path to check.
+ * @returns True if empty, false otherwise.
+ */
+async function isDirEmpty(dest: string): Promise<boolean> {
+  return (await readdir(dest)).length === 0;
+}
+
+/**
+ * Helper to prompt the user for a new path and re-run validation.
+ *
+ * @returns The resolved valid path.
+ */
+async function promptNewPath(): Promise<string> {
+  const answer = await text({
+    message: "Set a new project location:",
+    validate: validateString,
+  });
+
+  checkCancel(answer);
+
+  return prepareDestination(answer);
+}

package/template/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/template/.github/FUNDING.yml

@@ -0,0 +1,16 @@
+# These are supported funding model platforms
+
+github: quadratz
+# patreon: # Replace with a single Patreon username
+# open_collective: # Replace with a single Open Collective username
+# ko_fi: # Replace with a single Ko-fi username
+# tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+# community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+# liberapay: # Replace with a single Liberapay username
+# issuehunt: # Replace with a single IssueHunt username
+# lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+# polar: # Replace with a single Polar username
+# buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+# thanks_dev: # Replace with a single thanks.dev username
+# custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1',
+# 'link2']

package/template/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,124 @@
+name: 🐛 Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report this issue! Please fill out the information below to help us understand and resolve the problem.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      description: Please confirm the following before submitting
+      options:
+        - label: I have searched existing issues to ensure this bug hasn't been reported
+          required: true
+        - label: I have checked the documentation
+          required: true
+        - label: I am using the latest version
+          required: false
+
+  - type: input
+    id: version
+    attributes:
+      label: Package Version
+      description: What version of the package are you using?
+      placeholder: e.g., 1.2.3
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is
+      placeholder: What went wrong?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Detailed steps to reproduce the behavior
+      placeholder: |
+        1. Import '...'
+        2. Call function with '...'
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+      placeholder: What should have happened instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened?
+      placeholder: Include error messages, screenshots, or logs
+    validations:
+      required: true
+
+  - type: textarea
+    id: code
+    attributes:
+      label: Code Sample
+      description: Minimal code to reproduce the issue
+      placeholder: |
+        ```typescript
+        // Your code here
+        ```
+      render: typescript
+    validations:
+      required: false
+
+  - type: input
+    id: reproduction-link
+    attributes:
+      label: Reproduction Link
+      description: Link to a minimal reproduction (CodeSandbox, StackBlitz, GitHub repo, etc.)
+      placeholder: https://codesandbox.io/s/...
+    validations:
+      required: false
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Please provide your environment details
+      placeholder: |
+        - OS: [e.g., macOS 14.0, Windows 11, Ubuntu 22.04]
+        - Node version: [e.g., 20.10.0]
+        - Package manager: [e.g., npm 10.2.3, yarn 4.0.2, pnpm 8.14.0]
+        - TypeScript version (if applicable): [e.g., 5.3.3]
+        - Browser (if applicable): [e.g., Chrome 120, Safari 17]
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or information about the problem
+      placeholder: Add any other relevant details here
+    validations:
+      required: false
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Possible Solution
+      description: If you have suggestions on how to fix this, please share
+      placeholder: Optional - your ideas for fixing this issue
+    validations:
+      required: false

package/template/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,100 @@
+name: ✨ Feature Request
+description: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your interest in improving this project! Please describe your feature request in detail.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      description: Please confirm the following before submitting
+      options:
+        - label: I have searched existing issues to ensure this hasn't been requested
+          required: true
+        - label: I have checked the documentation to ensure this feature doesn't exist
+          required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: Is your feature request related to a problem? Please describe.
+      placeholder: I'm frustrated when... / It would be helpful if...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like
+      placeholder: A clear and concise description of what you want to happen
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Describe alternatives you've considered
+      placeholder: What other approaches have you thought about?
+    validations:
+      required: false
+
+  - type: textarea
+    id: examples
+    attributes:
+      label: Code Examples
+      description: Show how you'd like to use this feature
+      placeholder: |
+        ```typescript
+        // Example usage
+        ```
+      render: typescript
+    validations:
+      required: false
+
+  - type: textarea
+    id: api
+    attributes:
+      label: API Design (if applicable)
+      description: If this involves new APIs, describe the proposed interface
+      placeholder: |
+        Proposed function signatures, types, or component props
+      render: typescript
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, mockups, or screenshots
+      placeholder: Links to similar features in other libraries, mockups, etc.
+    validations:
+      required: false
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - Low - Nice to have
+        - Medium - Would significantly improve my workflow
+        - High - Blocking my usage of this library
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Contribution
+      description: Would you be willing to contribute this feature?
+      options:
+        - label: I'm willing to submit a PR to implement this feature

package/template/.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,68 @@
+name: ❓ Question
+description: Ask a question about usage or clarification
+title: "[Question]: "
+labels: ["question"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your question! Please provide as much detail as possible so we can help you effectively.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      description: Please confirm the following before submitting
+      options:
+        - label: I have checked the documentation
+          required: true
+        - label: I have searched existing issues for similar questions
+          required: true
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Your Question
+      description: What would you like to know?
+      placeholder: Please be as specific as possible
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: What are you trying to accomplish?
+      placeholder: Describe your use case or what you're building
+    validations:
+      required: false
+
+  - type: textarea
+    id: code
+    attributes:
+      label: Code Sample
+      description: Share relevant code if applicable
+      placeholder: |
+        ```typescript
+        // Your code here
+        ```
+      render: typescript
+    validations:
+      required: false
+
+  - type: textarea
+    id: attempted
+    attributes:
+      label: What I've Tried
+      description: What have you already attempted?
+      placeholder: Describe any solutions you've already explored
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Information
+      description: Any other details that might be helpful
+    validations:
+      required: false

package/template/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,45 @@
+## Description
+
+<!-- Briefly describe what this PR does -->
+
+## Type of Change
+
+<!-- Check the relevant option -->
+
+- [ ] 🐛 Bug fix
+- [ ] ✨ New feature
+- [ ] 💥 Breaking change
+- [ ] 📝 Documentation
+- [ ] ♻️ Refactoring
+- [ ] ⚡ Performance
+- [ ] ✅ Tests
+- [ ] 🔧 Build/CI
+
+## Related Issues
+
+<!-- Link related issues: Fixes #123, Closes #456 -->
+
+## Changes
+
+<!-- List key changes -->
+
+-
+-
+
+## Testing
+
+<!-- How did you test this? -->
+
+- [ ] Tests added/updated
+- [ ] All tests passing
+
+## Checklist
+
+- [ ] Code follows project style
+- [ ] Self-reviewed
+- [ ] Documentation updated (if needed)
+- [ ] No breaking changes (or documented)
+
+## Screenshots/Notes
+
+<!-- Optional: Add screenshots or additional context -->

package/template/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on: [push, pull_request]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build
+        run: bun task build
+
+      - name: Check
+        run: bun task check

package/template/.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    name: Release Package
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build
+        run: bun run build
+
+      - name: Check
+        run: bun run check
+
+      - name: Generate changelog
+        run: bunx changelogithub
+        continue-on-error: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Update npm
+        run: npm install -g npm@latest
+
+      - name: Publish packages to npm
+        run: bunx clean-pkg-json && bun pm pack && npm publish ./*.tgz --access public

package/template/CODE_OF_CONDUCT.md

@@ -0,0 +1,162 @@
+# Contributor Covenant 3.0 Code of Conduct
+
+## Our Pledge
+
+We pledge to make our community welcoming, safe, and equitable for all.
+
+We are committed to fostering an environment that respects and promotes the
+dignity, rights, and contributions of all individuals, regardless of
+characteristics including race, ethnicity, caste, color, age, physical
+characteristics, neurodiversity, disability, language, philosophy or religion,
+national or social origin, socio-economic position, level of education, or other
+status. The same privileges of participation are extended to everyone who
+participates in good faith and in accordance with this Covenant.
+
+## Encouraged Behaviors
+
+While acknowledging differences in social norms, we all strive to meet our
+community's expectations for positive behavior. We also understand that our
+words and actions may be interpreted differently than we intend based on
+culture, background, or native language.
+
+With these considerations in mind, we agree to behave mindfully toward each
+other and act in ways that center our shared values, including:
+
+1. Respecting the **purpose of our community**, our activities, and our ways of
+   gathering.
+2. Engaging **kindly and honestly** with others.
+3. Respecting **different viewpoints** and experiences.
+4. **Taking responsibility** for our actions and contributions.
+5. Gracefully giving and accepting **constructive feedback**.
+6. Committing to **repairing harm** when it occurs.
+7. Behaving in other ways that promote and sustain the **well-being of our
+   community**.
+
+## Restricted Behaviors
+
+We agree to restrict the following behaviors in our community. Instances,
+threats, and promotion of these behaviors are violations of this Code of
+Conduct.
+
+1. **Harassment.** Violating explicitly expressed boundaries or engaging in
+   unnecessary personal attention after any clear request to stop.
+2. **Character attacks.** Making insulting, demeaning, or pejorative comments
+   directed at a community member or group of people.
+3. **Stereotyping or discrimination.** Characterizing anyone’s personality or
+   behavior on the basis of immutable identities or traits.
+4. **Sexualization.** Behaving in a way that would generally be considered
+   inappropriately intimate in the context or purpose of the community.
+5. **Violating confidentiality**. Sharing or acting on someone's personal or
+   private information without their permission.
+6. **Endangerment.** Causing, encouraging, or threatening violence or other harm
+   toward any person or group.
+7. Behaving in other ways that **threaten the well-being** of our community.
+
+### Other Restrictions
+
+1. **Misleading identity.** Impersonating someone else for any reason, or
+   pretending to be someone else to evade enforcement actions.
+2. **Failing to credit sources.** Not properly crediting the sources of content
+   you contribute.
+3. **Promotional materials**. Sharing marketing or other commercial content in a
+   way that is outside the norms of the community.
+4. **Irresponsible communication.** Failing to responsibly present content which
+   includes, links or describes any other restricted behaviors.
+
+## Reporting an Issue
+
+Tensions can occur between community members even when they are trying their
+best to collaborate. Not every conflict represents a code of conduct violation,
+and this Code of Conduct reinforces encouraged behaviors and norms that can help
+avoid conflicts and minimize harm.
+
+When an incident does occur, it is important to report it promptly. To report a
+possible violation, please email **quadratz@proton.me** or contact us via
+Telegram at **https://t.me/quadratz**.
+
+Community Moderators take reports of violations seriously and will make every
+effort to respond in a timely manner. They will investigate all reports of code
+of conduct violations, reviewing messages, logs, and recordings, or interviewing
+witnesses and other participants. Community Moderators will keep investigation
+and enforcement actions as transparent as possible while prioritizing safety and
+confidentiality. In order to honor these values, enforcement actions are carried
+out in private with the involved parties, but communicating to the whole
+community may be part of a mutually agreed upon resolution.
+
+## Addressing and Repairing Harm
+
+If an investigation by the Community Moderators finds that this Code of Conduct
+has been violated, the following enforcement ladder may be used to determine how
+best to repair harm, based on the incident's impact on the individuals involved
+and the community as a whole. Depending on the severity of a violation, lower
+rungs on the ladder may be skipped.
+
+1. Warning
+   1. Event: A violation involving a single incident or series of incidents.
+   2. Consequence: A private, written warning from the Community Moderators.
+   3. Repair: Examples of repair include a private written apology,
+      acknowledgement of responsibility, and seeking clarification on
+      expectations.
+2. Temporarily Limited Activities
+   1. Event: A repeated incidence of a violation that previously resulted in a
+      warning, or the first incidence of a more serious violation.
+   2. Consequence: A private, written warning with a time-limited cooldown
+      period designed to underscore the seriousness of the situation and give
+      the community members involved time to process the incident. The cooldown
+      period may be limited to particular communication channels or interactions
+      with particular community members.
+   3. Repair: Examples of repair may include making an apology, using the
+      cooldown period to reflect on actions and impact, and being thoughtful
+      about re-entering community spaces after the period is over.
+3. Temporary Suspension
+   1. Event: A pattern of repeated violation which the Community Moderators have
+      tried to address with warnings, or a single serious violation.
+   2. Consequence: A private written warning with conditions for return from
+      suspension. In general, temporary suspensions give the person being
+      suspended time to reflect upon their behavior and possible corrective
+      actions.
+   3. Repair: Examples of repair include respecting the spirit of the
+      suspension, meeting the specified conditions for return, and being
+      thoughtful about how to reintegrate with the community when the suspension
+      is lifted.
+4. Permanent Ban
+   1. Event: A pattern of repeated code of conduct violations that other steps
+      on the ladder have failed to resolve, or a violation so serious that the
+      Community Moderators determine there is no way to keep the community safe
+      with this person as a member.
+   2. Consequence: Access to all community spaces, tools, and communication
+      channels is removed. In general, permanent bans should be rarely used,
+      should have strong reasoning behind them, and should only be resorted to
+      if working through other remedies has failed to change the behavior.
+   3. Repair: There is no possible repair in cases of this severity.
+
+This enforcement ladder is intended as a guideline. It does not limit the
+ability of Community Managers to use their discretion and judgment, in keeping
+with the best interests of our community.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public or other
+spaces. Examples of representing our community include using an official email
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 3.0,
+permanently available at
+[https://www.contributor-covenant.org/version/3/0/](https://www.contributor-covenant.org/version/3/0/).
+
+Contributor Covenant is stewarded by the Organization for Ethical Source and
+licensed under CC BY-SA 4.0. To view a copy of this license, visit
+[https://creativecommons.org/licenses/by-sa/4.0/](https://creativecommons.org/licenses/by-sa/4.0/)
+
+For answers to common questions about Contributor Covenant, see the FAQ at
+[https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq).
+Translations are provided at
+[https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).
+Additional enforcement and community guideline resources can be found at
+[https://www.contributor-covenant.org/resources](https://www.contributor-covenant.org/resources).
+The enforcement ladder was inspired by the work of
+[Mozilla’s code of conduct team](https://github.com/mozilla/inclusion).

package/template/CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Contributing to {{PACKAGE_NAME}}
+
+Thank you for your interest in contributing to our project! This guide will help
+you get started with the development process.
+
+## Development Setup
+
+### Prerequisites
+
+Bun installed on your system. If you haven't installed it yet, please refer to
+the
+[installation guide](https://bun.com/docs/installation).
+
+### Getting Started
+
+1. Fork the repository
+2. Clone your fork:
+   `git clone https://github.com/Quadratz-Org/{{PACKAGE_NAME}}.git`
+3. Navigate to the project directory: `cd {{PACKAGE_NAME}}`
+4. Install dependencies: `bun install`
+5. Start development: `bun run dev`
+
+## Development Workflow
+
+1. Create a new branch: `git checkout -b feature/your-feature-name`
+2. Make your changes
+3. Fix formatting issues: `bun run fmt`
+4. Run check: `bun run check`
+5. Build the project: `bun run build`
+6. Commit your changes using the conventions below
+7. Push your branch to your fork
+8. Open a pull request
+
+## Commit Message Conventions
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/) for clear
+and structured commit messages:
+
+- `feat:` New features
+- `fix:` Bug fixes
+- `docs:` Documentation changes
+- `style:` Code style changes (formatting, etc.)
+- `refactor:` Code changes that neither fix bugs nor add features
+- `perf:` Performance improvements
+- `test:` Adding or updating tests
+- `chore:` Maintenance tasks, dependencies, etc.
+
+## Pull Request Guidelines
+
+1. Update documentation if needed
+2. Ensure all tests pass
+3. Address any feedback from code reviews
+4. Once approved, your PR will be merged
+
+## Code of Conduct
+
+In short, please be respectful and constructive in all interactions within our
+community. More details can be found in
+[CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
+
+## Questions?
+
+If you have any questions, please
+[open an issue](https://github.com/Quadratz-Org/{{PACKAGE_NAME}}/issues/new) for
+discussion or contact us via email at <quadratz@proton.me> or via Telegram at
+[@quadratz](https://t.me/quadratz).
+
+Thank you for contributing to {{PACKAGE_NAME}}!

package/template/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Quadratz
+
+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.

package/template/README.md

@@ -0,0 +1,55 @@
+# {{PACKAGE_NAME}}
+
+[![npm Badge](https://img.shields.io/npm/v/{{PACKAGE_NAME}}?label=&color=050619&style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyOCAyOCIgcm9sZT0iaW1nIiBhcmlhLWxhYmVsbGVkYnk9ImFsM2VyeHB6YnN5YXhjbjE3cnJmeWs1N2I2YTl5eW8iIGNsYXNzPSJjc3MtMW5pMmpzYSI+PHRpdGxlIGlkPSJhbDNlcnhwemJzeWF4Y24xN3JyZnlrNTdiNmE5eXlvIj5ucG08L3RpdGxlPjxwYXRoIGQ9Ik0yNS45NDMgMEgyLjA1N0MuOTIgMCAwIC45MiAwIDIuMDU3djIzLjg4NkMwIDI3LjA4LjkyIDI4IDIuMDU3IDI4aDIzLjg4NkMyNy4wOCAyOCAyOCAyNy4wOCAyOCAyNS45NDNWMi4wNTdDMjggLjkyIDI3LjA4IDAgMjUuOTQzIDB6IiBmaWxsPSIjQ0IwMDAwIj48L3BhdGg+PHBhdGggZD0iTTUuOTY0IDIyLjM2NWg4LjA4MmwuMDEtMTIuMTAzaDQuMDMxbC0uMDEgMTIuMTEzaDQuMDQxbC4wMS0xNi4xNDNMNS45ODUgNi4yMWwtLjAyMSAxNi4xNTR6IiBmaWxsPSIjZmZmIj48L3BhdGg+PC9zdmc+)](https://www.npmjs.com/package/{{PACKAGE_NAME}})
+[![GitHub Badge](https://img.shields.io/badge/Source-050619?style=for-the-badge&logo=github)](https://github.com/Quadratz-Org/{{PACKAGE_NAME}})
+
+{{DESCRIPTION}}
+
+## Installation
+
+```bash
+# Bun
+bun add {{PACKAGE_NAME}}
+
+# Deno
+deno add npm:{{PACKAGE_NAME}}
+
+# pnpm
+pnpm add {{PACKAGE_NAME}}
+
+# npm
+npm install {{PACKAGE_NAME}}
+```
+
+## Usage
+
+```ts
+console.log("Halo, dunia!");
+```
+
+## API
+
+This package exports the following:
+
+### `{{PACKAGE_NAME}}`
+
+```ts
+function {{PACKAGE_NAME}}(options?: Options): void;
+```
+
+The main plugin. It receives one optional parameter to configure behavior. See
+the [`Options` section](#options) below for configuration details.
+
+### `Options`
+
+```ts
+type Options = {};
+```
+
+## Contributing
+
+Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.
+
+## License
+
+[MIT](./LICENSE)

package/template/eslint.config.ts

@@ -0,0 +1,19 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+import prettierConfig from "eslint-config-prettier";
+
+export default defineConfig(
+  globalIgnores(["./template/**"]),
+  eslint.configs.recommended,
+  tseslint.configs.strictTypeChecked,
+  tseslint.configs.stylisticTypeChecked,
+  {
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+      },
+    },
+  },
+  prettierConfig,
+);

package/template/examples/example.ts

@@ -0,0 +1 @@
+console.log("Halo, dunia!");

package/template/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "my-package",
+  "type": "module",
+  "version": "1.0.0-alpha.1",
+  "description": "",
+  "author": "Quadratz",
+  "keywords": [
+    ""
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/Quadratz-Org/my-package#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Quadratz-Org/my-package.git"
+  },
+  "bugs": "https://github.com/Quadratz-Org/my-package/issues",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown",
+    "test": "bun test",
+    "fmt": "prettier . --write",
+    "check": "prettier . --check && eslint . && tsc --noEmit && bun test",
+    "release": "bumpp --commit --push --tag"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/bun": "latest",
+    "@types/node": "^25.2.3",
+    "bumpp": "^10.4.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "3.8.1",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.55.0"
+  },
+  "dependencies": {}
+}

package/template/renovate.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["config:recommended"]
+}

package/template/src/index.ts

@@ -0,0 +1 @@
+export {};

package/template/test/index.test.ts

@@ -0,0 +1,5 @@
+import { test, expect } from "bun:test";
+
+test("test", () => {
+  expect();
+});

package/template/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "lib": ["es2023"],
+    "moduleDetection": "force",
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "types": ["node"],
+    "noUnusedLocals": true,
+    "declaration": true,
+    "isolatedDeclarations": true,
+    "emitDeclarationOnly": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true
+  },
+  "include": ["src"]
+}

package/template/tsdown.config.ts

@@ -0,0 +1,6 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  exports: true,
+  failOnWarn: true,
+});