@icebreakers/monorepo-templates 2.0.7 → 2.2.0

package/templates/nimbus/src/pages/[...slug].astro

@@ -0,0 +1,36 @@
+---
+import { getDocsPage, getDocsStaticPaths, getSidebar, getTOC, stripBase } from '@cloudflare/nimbus-docs/runtime'
+import { components } from '../components'
+import DocsLayout from '../layouts/docs.astro'
+import { alternatePath, isChinese, localizeSidebar } from '../lib/locale'
+
+export const prerender = true
+export const getStaticPaths = getDocsStaticPaths
+
+const page = await getDocsPage(Astro)
+if (page instanceof Response) {
+  return page
+}
+const { entry, Content, headings, markdownUrl } = page
+const pathname = stripBase(Astro.url.pathname, import.meta.env.BASE_URL)
+const chinese = isChinese(pathname)
+const sidebar = localizeSidebar(await getSidebar(pathname), chinese)
+const toc = entry.data.tableOfContents === false ? false : getTOC(headings, entry.data.tableOfContents)
+---
+
+<DocsLayout
+  title={entry.data.title}
+  description={entry.data.description}
+  sidebar={entry.data.sidebar === false ? false : sidebar}
+  headings={toc}
+  markdownUrl={markdownUrl}
+  collection={entry.collection}
+  entryId={entry.id}
+  noindex={entry.data.noindex}
+  draft={entry.data.draft}
+  searchable={entry.data.searchable}
+  chinese={chinese}
+  alternate={alternatePath(pathname)}
+>
+  <Content components={components} />
+</DocsLayout>

package/templates/nimbus/src/pages/[section]/llms.txt.ts

@@ -0,0 +1,4 @@
+import { llmsSectionRoute } from '@cloudflare/nimbus-docs/agent-endpoints'
+
+export const prerender = true
+export const { GET, getStaticPaths } = llmsSectionRoute()

package/templates/nimbus/src/pages/llms-full.txt.ts

@@ -0,0 +1,4 @@
+import { llmsFullRoute } from '@cloudflare/nimbus-docs/agent-endpoints'
+
+export const prerender = true
+export const { GET } = llmsFullRoute()

package/templates/nimbus/src/pages/llms.txt.ts

@@ -0,0 +1,4 @@
+import { llmsRoute } from '@cloudflare/nimbus-docs/agent-endpoints'
+
+export const prerender = true
+export const { GET } = llmsRoute()

package/templates/nimbus/src/pages/robots.txt.ts

@@ -0,0 +1,18 @@
+import { withBase } from '@cloudflare/nimbus-docs/runtime'
+import { config } from 'virtual:nimbus/config'
+
+export const prerender = true
+
+export function GET() {
+  const body = [
+    'User-agent: *',
+    'Allow: /',
+    '',
+    `Sitemap: ${new URL(withBase('/sitemap-index.xml', import.meta.env.BASE_URL), config.site).href}`,
+    '',
+  ].join('\n')
+
+  return new Response(body, {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  })
+}

package/templates/nimbus/src/styles/base.css

@@ -0,0 +1,121 @@
+@layer base {
+  :root {
+    font-family: system-ui, sans-serif;
+    line-height: 1.7;
+    color: var(--ink);
+    color-scheme: light dark;
+    background: var(--surface);
+
+    --surface: #fafbfc;
+    --ink: #263247;
+    --muted: #5d6b80;
+    --line: #dce2eb;
+    --accent: #1d4ed8;
+    --soft: #edf2fc;
+  }
+
+  * {
+  box-sizing: border-box;
+}
+
+  body {
+  margin: 0;
+}
+
+  a {
+  color: var(--accent);
+  text-underline-offset: 0.2em;
+}
+
+  a:hover {
+  text-decoration-thickness: 2px;
+}
+
+  :focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 4px;
+}
+
+  h1, h2, h3 {
+  line-height: 1.25;
+  text-wrap: balance;
+}
+
+  h1 {
+  margin: 0 0 1rem;
+  font-family: Charter, Georgia, serif;
+  font-size: clamp(2.4rem, 5vw, 3.6rem);
+  font-weight: 500;
+}
+
+  h2 {
+  margin-top: 2.5rem;
+  font-size: 1.5rem;
+}
+
+  h3 {
+  margin-top: 2rem;
+}
+
+  p, li {
+  overflow-wrap: anywhere;
+}
+
+  code {
+  font-family: ui-monospace, monospace;
+  font-size: 0.88em;
+}
+
+  pre {
+  padding: 1.2rem;
+  overflow: auto;
+  border: 1px solid var(--line);
+  border-radius: 0.4rem;
+}
+
+  :not(pre) > code {
+  padding: 0.15rem 0.35rem;
+  background: var(--soft);
+  border-radius: 0.2rem;
+}
+
+  img {
+  max-width: 100%;
+}
+
+  table {
+  display: block;
+  overflow-x: auto;
+  border-collapse: collapse;
+}
+
+  td, th {
+  padding: 0.6rem 1rem;
+  text-align: start;
+  border: 1px solid var(--line);
+}
+
+  button, input {
+  font: inherit;
+}
+
+  button, summary {
+  cursor: pointer;
+}
+
+  button {
+  padding: 0.4rem 0.7rem;
+  color: var(--surface);
+  background: var(--accent);
+  border: 0;
+  border-radius: 0.3rem;
+}
+
+  input {
+  width: 100%;
+  min-width: 0;
+  padding: 0.4rem;
+  border: 1px solid var(--line);
+  border-radius: 0.3rem;
+}
+}

package/templates/nimbus/src/styles/site.css

@@ -0,0 +1,186 @@
+@import './base.css';
+
+.site-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  min-height: 4.5rem;
+  padding: 0.8rem max(1.5rem, calc((100vw - 90rem) / 2));
+  border-bottom: 1px solid var(--line);
+}
+
+.brand {
+  font-weight: 650;
+  color: var(--ink);
+  text-decoration: none;
+}
+
+.language-link {
+  font-size: 0.875rem;
+}
+
+.docs-grid {
+  display: grid;
+  grid-template-columns: 15rem minmax(0, 1fr) 12rem;
+  gap: 3rem;
+  max-width: 90rem;
+  padding: 3rem 1.5rem;
+  margin: auto;
+}
+
+.site-rail, .page-rail {
+  font-size: 0.875rem;
+}
+
+.rail-title {
+  font-size: 0.75rem;
+  font-weight: 650;
+  color: var(--muted);
+  letter-spacing: 0.04em;
+}
+
+.navigation-list {
+  padding: 0;
+  list-style: none;
+}
+
+.navigation-list ul {
+  padding-left: 1rem;
+}
+
+.navigation-list a {
+  display: block;
+  padding: 0.3rem 0;
+  color: var(--muted);
+  text-decoration: none;
+}
+
+.navigation-list a[aria-current="page"] {
+  font-weight: 650;
+  color: var(--accent);
+}
+
+.navigation-list a:hover {
+  color: var(--accent);
+}
+
+.index-link {
+  display: inline-block;
+  margin-top: 2rem;
+  font-family: ui-monospace, monospace;
+}
+
+main {
+  min-width: 0;
+  max-width: 48rem;
+}
+
+.description {
+  margin-bottom: 2.5rem;
+  font-size: 1.15rem;
+  color: var(--muted);
+}
+
+.callout {
+  padding: 1rem 1.25rem;
+  margin: 1.5rem 0;
+  background: var(--soft);
+  border-left: 3px solid var(--accent);
+}
+
+.callout p:last-child {
+  margin-bottom: 0;
+}
+
+footer {
+  padding-top: 1rem;
+  margin-top: 3rem;
+  font-size: 0.875rem;
+  border-top: 1px solid var(--line);
+}
+
+.search-panel {
+  margin-bottom: 2rem;
+}
+
+.search-panel form {
+  margin-top: 1rem;
+}
+
+.search-controls {
+  display: flex;
+  gap: 0.3rem;
+  margin-top: 0.5rem;
+}
+
+.search-results {
+  padding-left: 1.2rem;
+}
+
+.search-results li {
+  margin-bottom: 0.6rem;
+}
+
+.skip-link {
+  position: absolute;
+  top: -5rem;
+  left: 1rem;
+  padding: 0.5rem;
+  background: var(--surface);
+}
+
+.skip-link:focus {
+  top: 1rem;
+}
+
+@media (max-width: 72rem) {
+  .docs-grid {
+  grid-template-columns: 13rem minmax(0, 1fr);
+  gap: 2rem;
+}
+
+  .page-rail {
+  display: none;
+}
+}
+
+@media (max-width: 48rem) {
+  .docs-grid {
+  grid-template-columns: minmax(0, 1fr);
+  padding-top: 1.5rem;
+}
+
+  .site-rail {
+  padding-bottom: 1rem;
+  border-bottom: 1px solid var(--line);
+}
+
+  .site-rail .navigation-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem 1rem;
+}
+
+  .site-rail .navigation-list ul {
+  padding-left: 0;
+}
+
+  .index-link {
+  margin-top: 0.5rem;
+}
+
+  .search-panel {
+  margin-bottom: 1rem;
+}
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --surface: #141c2b;
+    --ink: #e3eaf5;
+    --muted: #a8b6cc;
+    --line: #33415a;
+    --accent: #97baff;
+    --soft: #222f46;
+  }
+}

package/templates/nimbus/stylelint.config.js

@@ -0,0 +1,3 @@
+import { defineStylelintConfig } from 'repoctl/tooling'
+
+export default await defineStylelintConfig()

package/templates/nimbus/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "compilerOptions": {
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist"]
+}

package/templates/react-lib/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ice breaker
+
+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/templates/react-lib/README.md

@@ -0,0 +1,52 @@
+# React component library
+
+An ESM-only React 19.3+ component library. `Counter` and `CounterProps` are exported
+from the package root, and styles have an explicit `./style.css` export. React,
+React DOM and their subpaths (including JSX runtimes) remain external to the bundle.
+CommonJS is not a supported entry point.
+The built JavaScript retains `use client`, so Next App Router Server Components
+can import this stateful component directly. Callback props still belong in a
+consumer Client Component.
+
+```tsx
+import type { CounterProps } from 'your-package-name'
+import { Counter } from 'your-package-name'
+import 'your-package-name/style.css'
+
+const props: CounterProps = { initialCount: 2, step: 2 }
+export function Example() {
+  return <Counter {...props} onCountChange={console.log} />
+}
+```
+
+Install `react` and `react-dom` in the consuming application. Import the stylesheet
+once in its application entry. `sideEffects` preserves CSS during tree shaking;
+JavaScript does not automatically inject styles. `initialCount` initializes the
+local state and supplies the reset value; this component is uncontrolled.
+
+Run these commands from the workspace root, replacing the filter if you rename
+the package. Build before running the tests: they import the built package entry.
+
+```bash
+pnpm --filter @icebreakers/react-lib-template build
+pnpm --filter @icebreakers/react-lib-template lint
+pnpm --filter @icebreakers/react-lib-template typecheck
+pnpm --filter @icebreakers/react-lib-template tsd
+pnpm --filter @icebreakers/react-lib-template test
+```
+
+The generated package starts with `private: true`. Before publishing, set your own
+package name and version, remove `private` (or set it to `false`), review the MIT
+license and run `repo package check` from the workspace root. Only `dist`, this
+README, the license and the package manifest are packed. Validate a tarball in a
+separate application before publishing. Storybook can be added independently;
+it is not required to build or consume this library.
+
+## 中文说明
+
+此模板提供 React 19.3+ 的 ESM 组件库，默认目录为 `packages/react-lib`。
+组件和 props 类型从包根入口导入，样式从 `包名/style.css` 显式导入。
+React、React DOM 和 JSX runtime 不打进库；消费应用需要安装对应 peer 依赖。
+默认保留 `private: true`，发布前请修改包名、版本和 private，完成上述构建、
+ESLint/Stylelint、类型及行为验证，再执行 `repo package check` 和实际 tarball 消费验证。
+本模板不声明 CommonJS 支持，Storybook 是可选扩展。

package/templates/react-lib/eslint.config.js

@@ -0,0 +1,5 @@
+import { defineEslintConfig } from 'repoctl/tooling'
+
+export default await defineEslintConfig({
+  options: { react: true, typescript: true },
+})

package/templates/react-lib/gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+coverage
+*.tsbuildinfo

package/templates/react-lib/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@icebreakers/react-lib-template",
+  "type": "module",
+  "version": "0.0.0",
+  "private": true,
+  "description": "React component library with explicit JavaScript, types and CSS exports",
+  "license": "MIT",
+  "sideEffects": ["**/*.css"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["LICENSE", "README.md", "dist"],
+  "engines": { "node": ">=22.13.0" },
+  "scripts": {
+    "build": "vite build",
+    "lint": "eslint . && stylelint \"src/**/*.css\"",
+    "lint:fix": "eslint . --fix && stylelint \"src/**/*.css\" --fix",
+    "typecheck": "tsc -b",
+    "tsd": "tsd --files test-d/**/*.test-d.ts",
+    "test": "vitest run",
+    "test:dev": "vitest"
+  },
+  "peerDependencies": {
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^6.1.1",
+    "jsdom": "^30.1.1",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "tsd": "^0.33.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.3.2",
+    "vite-plugin-dts": "^5.1.1",
+    "vitest": "~5.0.3"
+  }
+}

package/templates/react-lib/src/counter.tsx

@@ -0,0 +1,28 @@
+import { useState } from 'react'
+import './style.css'
+
+export interface CounterProps {
+  /** Accessible name for this counter's current value. */
+  label?: string
+  /** Initial value, also used by the reset action. */
+  initialCount?: number
+  step?: number
+  disabled?: boolean
+  onCountChange?: (count: number) => void
+}
+
+export function Counter({ label = 'Count', initialCount = 0, step = 1, disabled = false, onCountChange }: CounterProps) {
+  const [count, setCount] = useState(initialCount)
+  function update(next: number) {
+    setCount(next)
+    onCountChange?.(next)
+  }
+
+  return (
+    <div className="repoctl-counter">
+      <output aria-label={label} aria-live="polite">{count}</output>
+      <button type="button" disabled={disabled} onClick={() => update(count + step)}>Increase</button>
+      <button type="button" disabled={disabled || count === initialCount} onClick={() => update(initialCount)}>Reset</button>
+    </div>
+  )
+}

package/templates/react-lib/src/index.ts

@@ -0,0 +1,2 @@
+export { Counter } from './counter.js'
+export type { CounterProps } from './counter.js'

package/templates/react-lib/src/style.css

@@ -0,0 +1,36 @@
+.repoctl-counter {
+  display: inline-flex;
+  gap: 0.75rem;
+  align-items: center;
+  padding: 1rem;
+  font: inherit;
+  color: #14283a;
+  border: 1px solid #ccd4dc;
+  border-radius: 0.75rem;
+}
+
+.repoctl-counter output {
+  min-width: 2ch;
+  font-variant-numeric: tabular-nums;
+  text-align: center;
+}
+
+.repoctl-counter button {
+  padding: 0.5rem 0.75rem;
+  font: inherit;
+  color: #fff;
+  cursor: pointer;
+  background: #14283a;
+  border: 0;
+  border-radius: 0.375rem;
+}
+
+.repoctl-counter button:focus-visible {
+  outline: 2px solid #176bb4;
+  outline-offset: 3px;
+}
+
+.repoctl-counter button:disabled {
+  cursor: default;
+  opacity: 0.5;
+}

package/templates/react-lib/stylelint.config.js

@@ -0,0 +1,3 @@
+import { defineStylelintConfig } from 'repoctl/tooling'
+
+export default await defineStylelintConfig()

package/templates/react-lib/test/counter.test.tsx

@@ -0,0 +1,28 @@
+import { cleanup, fireEvent, render, screen } from '@testing-library/react'
+import { afterEach, expect, it, vi } from 'vitest'
+import { Counter } from '..'
+
+afterEach(cleanup)
+
+it('uses the built public entry to update, notify and reset the initial value', () => {
+  const onCountChange = vi.fn()
+  render(<Counter label="Items" initialCount={3} step={2} onCountChange={onCountChange} />)
+  const count = screen.getByLabelText('Items')
+  const reset = screen.getByRole('button', { name: 'Reset' })
+  expect(count.textContent).toBe('3')
+  expect(reset.hasAttribute('disabled')).toBe(true)
+  fireEvent.click(screen.getByRole('button', { name: 'Increase' }))
+  expect(count.textContent).toBe('5')
+  expect(onCountChange).toHaveBeenLastCalledWith(5)
+  fireEvent.click(reset)
+  expect(count.textContent).toBe('3')
+  expect(onCountChange).toHaveBeenLastCalledWith(3)
+})
+
+it('prevents changes when disabled', () => {
+  const onCountChange = vi.fn()
+  render(<Counter disabled onCountChange={onCountChange} />)
+  fireEvent.click(screen.getByRole('button', { name: 'Increase' }))
+  expect(screen.getByLabelText('Count').textContent).toBe('0')
+  expect(onCountChange).not.toHaveBeenCalled()
+})

package/templates/react-lib/test-d/index.test-d.ts

@@ -0,0 +1,11 @@
+import type { ComponentProps, ReactElement } from 'react'
+import type { CounterProps } from '..'
+import { createElement } from 'react'
+import { expectAssignable, expectError, expectType } from 'tsd'
+import { Counter } from '..'
+
+expectAssignable<CounterProps>({ initialCount: 2, step: 3, onCountChange: count => expectType<number>(count) })
+expectAssignable<ComponentProps<typeof Counter>>({ label: 'Items', disabled: true })
+expectAssignable<ReactElement<CounterProps>>(createElement(Counter, { initialCount: 2 }))
+expectError(createElement(Counter, { initialCount: '2' }))
+expectError(createElement(Counter, { onCountChange: (value: string) => value }))

package/templates/react-lib/tsconfig.app.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+    "target": "ES2022",
+    "jsx": "react-jsx",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["vite/client"],
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "verbatimModuleSyntax": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src", "test"]
+}

package/templates/react-lib/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.app.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "declaration": true,
+    "declarationMap": false,
+    "emitDeclarationOnly": true,
+    "noEmit": false,
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/templates/react-lib/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }],
+  "files": []
+}