biucingcli 0.9.1__py3-none-any.whl

biucingcli/template_data/frontend/template/public/.gitkeep

@@ -0,0 +1 @@
+

biucingcli/template_data/frontend/template/scripts/browser-smoke-production

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+DOCKER_BIN="${DOCKER:-docker}"
+IMAGE_REF="${IMAGE_REF:?IMAGE_REF is required}"
+HOST_PORT="${HOST_PORT:-8080}"
+CONTAINER_PORT="${CONTAINER_PORT:-80}"
+RUNTIME_CONTAINER="${RUNTIME_CONTAINER:?RUNTIME_CONTAINER is required}"
+DEV_COMPOSE_FILE="${DEV_COMPOSE_FILE:-compose.dev.yaml}"
+DEV_SERVICE="${DEV_SERVICE:-frontend-dev}"
+DEV_DOCKERFILE="${DEV_DOCKERFILE:-Dockerfile.dev}"
+COMPOSE_PROJECT_NAME="${COMPOSE_PROJECT_NAME:?COMPOSE_PROJECT_NAME is required}"
+container_started=false
+
+cleanup() {
+  if [[ "$container_started" == "true" ]]; then
+    "$DOCKER_BIN" rm -f "$RUNTIME_CONTAINER" >/dev/null 2>&1 || true
+  fi
+}
+trap cleanup EXIT
+trap 'exit 129' HUP
+trap 'exit 130' INT
+trap 'exit 143' TERM
+
+"$DOCKER_BIN" run --detach \
+  --name "$RUNTIME_CONTAINER" \
+  --publish "127.0.0.1:${HOST_PORT}:${CONTAINER_PORT}" \
+  "$IMAGE_REF" >/dev/null
+container_started=true
+
+runtime_status=""
+for _ in $(seq 1 30); do
+  runtime_status="$("$DOCKER_BIN" inspect --format '{{.State.Health.Status}}' "$RUNTIME_CONTAINER")"
+  if [[ "$runtime_status" == "healthy" ]]; then
+    break
+  fi
+  if [[ "$runtime_status" == "unhealthy" ]]; then
+    break
+  fi
+  sleep 1
+done
+
+if [[ "$runtime_status" != "healthy" ]]; then
+  echo "Production container did not become healthy (status: ${runtime_status:-unknown})." >&2
+  "$DOCKER_BIN" logs "$RUNTIME_CONTAINER" >&2 || true
+  exit 1
+fi
+
+PLAYWRIGHT_BASE_URL="http://host.docker.internal:${HOST_PORT}" \
+DEV_DOCKERFILE="$DEV_DOCKERFILE" \
+COMPOSE_PROJECT_NAME="$COMPOSE_PROJECT_NAME" \
+  "$DOCKER_BIN" compose -f "$DEV_COMPOSE_FILE" run --rm \
+    --env PLAYWRIGHT_BASE_URL \
+    "$DEV_SERVICE" \
+    pnpm browser:smoke:production

biucingcli/template_data/frontend/template/scripts/doctor

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "Frontend environment doctor"
+
+failures=0
+fail() {
+  echo "[fail] $1" >&2
+  failures=$((failures + 1))
+}
+pass() {
+  echo "[pass] $1"
+}
+
+if command -v docker >/dev/null 2>&1; then
+  pass "docker is available"
+  if docker compose version >/dev/null 2>&1; then
+    pass "docker compose is available"
+  else
+    fail "docker compose is unavailable"
+  fi
+else
+  fail "docker is unavailable"
+fi
+
+for path in package.json pnpm-lock.yaml Dockerfile Dockerfile.dev compose.dev.yaml; do
+  if [[ -f "$path" ]]; then
+    pass "$path exists"
+  else
+    fail "$path is missing"
+  fi
+done
+
+if grep -q '"packageManager": "pnpm@9.9.0"' package.json && \
+   grep -q "lockfileVersion: '9.0'" pnpm-lock.yaml; then
+  pass "package manager and lockfile versions agree"
+else
+  fail "package.json and pnpm-lock.yaml must keep the pinned pnpm 9 contract"
+fi
+
+if (( failures > 0 )); then
+  echo "Doctor found ${failures} issue(s)." >&2
+  exit 1
+fi
+
+echo "Environment looks ready."

biucingcli/template_data/frontend/template/src/App.test.tsx

@@ -0,0 +1,18 @@
+import { render, screen } from "@testing-library/react";
+import { describe, expect, it } from "vitest";
+
+import App from "./App";
+import { getProjectOverview } from "./services/projectOverview";
+
+describe("App", () => {
+  it("renders the project overview content", async () => {
+    const overview = await getProjectOverview();
+
+    render(<App />);
+
+    expect(await screen.findByRole("heading", { name: overview.title })).toBeInTheDocument();
+    expect(screen.getByText(overview.description)).toBeInTheDocument();
+    expect(screen.getByText("Build Queue")).toBeInTheDocument();
+    expect(screen.getByText("Project Notes")).toBeInTheDocument();
+  });
+});

biucingcli/template_data/frontend/template/src/App.tsx

@@ -0,0 +1,5 @@
+import { AppRouter } from "./router/AppRouter";
+
+export default function App() {
+  return <AppRouter />;
+}

biucingcli/template_data/frontend/template/src/components/MetricCard.tsx

@@ -0,0 +1,14 @@
+type MetricCardProps = {
+  label: string;
+  value: string;
+  tone: "amber" | "slate";
+};
+
+export function MetricCard({ label, value, tone }: MetricCardProps) {
+  return (
+    <article className={`metric-card metric-card--${tone}`}>
+      <p className="metric-card__label">{label}</p>
+      <p className="metric-card__value">{value}</p>
+    </article>
+  );
+}

biucingcli/template_data/frontend/template/src/components/TaskPanel.tsx

@@ -0,0 +1,32 @@
+type Task = {
+  id: string;
+  title: string;
+  status: string;
+};
+
+type TaskPanelProps = {
+  title: string;
+  tasks: Task[];
+};
+
+export function TaskPanel({ title, tasks }: TaskPanelProps) {
+  return (
+    <section className="panel">
+      <div className="panel__header">
+        <h2>{title}</h2>
+        <span>{tasks.length} items</span>
+      </div>
+      <div className="task-list">
+        {tasks.map((task) => (
+          <article className="task-row" key={task.id}>
+            <div>
+              <strong>{task.title}</strong>
+              <p>{task.id}</p>
+            </div>
+            <span className="task-row__status">{task.status}</span>
+          </article>
+        ))}
+      </div>
+    </section>
+  );
+}

biucingcli/template_data/frontend/template/src/config/env.ts

@@ -0,0 +1,3 @@
+export const env = {
+  apiBaseUrl: import.meta.env.VITE_API_BASE_URL?.trim() ?? "",
+};

biucingcli/template_data/frontend/template/src/hooks/useProjectOverview.ts

@@ -0,0 +1,24 @@
+import { useEffect, useState } from "react";
+
+import { getProjectOverview } from "../services/projectOverview";
+import type { ProjectOverview } from "../types/projectOverview";
+
+export function useProjectOverview() {
+  const [overview, setOverview] = useState<ProjectOverview | null>(null);
+
+  useEffect(() => {
+    let isMounted = true;
+
+    void getProjectOverview().then((data) => {
+      if (isMounted) {
+        setOverview(data);
+      }
+    });
+
+    return () => {
+      isMounted = false;
+    };
+  }, []);
+
+  return overview;
+}

biucingcli/template_data/frontend/template/src/index.css

@@ -0,0 +1,208 @@
+:root {
+  font-family: "Avenir Next", "Helvetica Neue", Helvetica, Arial, sans-serif;
+  line-height: 1.5;
+  font-weight: 400;
+  color: #1f2937;
+  background:
+    radial-gradient(circle at top left, rgba(242, 186, 97, 0.3), transparent 30%),
+    linear-gradient(180deg, #f4efe6 0%, #fffdf8 100%);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  min-width: 320px;
+  min-height: 100vh;
+}
+
+#root {
+  min-height: 100vh;
+}
+
+.app-shell {
+  min-height: 100vh;
+  padding: 32px;
+}
+
+.workspace {
+  width: min(1120px, 100%);
+  margin: 0 auto;
+  display: grid;
+  gap: 24px;
+}
+
+.hero {
+  display: grid;
+  gap: 16px;
+  padding: 28px;
+  border: 1px solid rgba(73, 55, 32, 0.12);
+  border-radius: 8px;
+  background: rgba(255, 251, 244, 0.8);
+  backdrop-filter: blur(8px);
+}
+
+.hero__eyebrow {
+  margin: 0;
+  text-transform: uppercase;
+  font-size: 12px;
+  color: #8c5a13;
+}
+
+.hero__headline {
+  margin: 0;
+  display: grid;
+  gap: 8px;
+}
+
+.hero__headline h1 {
+  margin: 0;
+  font-size: clamp(36px, 6vw, 64px);
+  line-height: 1;
+}
+
+.hero__headline p {
+  margin: 0;
+  max-width: 56ch;
+  font-size: 18px;
+}
+
+.hero__meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+
+.hero__tag {
+  padding: 10px 14px;
+  border-radius: 999px;
+  background: #fff5e4;
+  color: #6a4310;
+  font-size: 14px;
+}
+
+.metrics {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 16px;
+}
+
+.metric-card {
+  padding: 20px;
+  border-radius: 8px;
+  border: 1px solid rgba(31, 41, 55, 0.1);
+  background: rgba(255, 255, 255, 0.92);
+}
+
+.metric-card--amber {
+  background: #fff7ea;
+}
+
+.metric-card__label {
+  margin: 0 0 12px;
+  font-size: 13px;
+  color: #6b7280;
+}
+
+.metric-card__value {
+  margin: 0;
+  font-size: 28px;
+  font-weight: 600;
+}
+
+.panels {
+  display: grid;
+  grid-template-columns: 1.3fr 1fr;
+  gap: 16px;
+}
+
+.panel {
+  padding: 20px;
+  border-radius: 8px;
+  border: 1px solid rgba(31, 41, 55, 0.1);
+  background: rgba(255, 255, 255, 0.92);
+}
+
+.panel__header {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 16px;
+}
+
+.panel__header h2 {
+  margin: 0;
+  font-size: 20px;
+}
+
+.panel__header span {
+  font-size: 13px;
+  color: #6b7280;
+}
+
+.task-list {
+  display: grid;
+  gap: 12px;
+}
+
+.task-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  padding: 14px 0;
+  border-top: 1px solid rgba(31, 41, 55, 0.08);
+}
+
+.task-row:first-child {
+  border-top: 0;
+  padding-top: 0;
+}
+
+.task-row strong,
+.task-row p {
+  display: block;
+}
+
+.task-row strong {
+  margin-bottom: 4px;
+}
+
+.task-row p {
+  margin: 0;
+  color: #6b7280;
+  font-size: 13px;
+}
+
+.task-row__status {
+  white-space: nowrap;
+  color: #8c5a13;
+  background: #fff5e4;
+  border-radius: 999px;
+  padding: 8px 12px;
+  font-size: 13px;
+}
+
+@media (max-width: 900px) {
+  .metrics,
+  .panels {
+    grid-template-columns: 1fr;
+  }
+}
+
+@media (max-width: 640px) {
+  .app-shell {
+    padding: 20px;
+  }
+
+  .hero {
+    padding: 20px;
+  }
+
+  .hero__headline h1 {
+    font-size: 40px;
+  }
+}

biucingcli/template_data/frontend/template/src/main.tsx

@@ -0,0 +1,11 @@
+import React from "react";
+import ReactDOM from "react-dom/client";
+
+import App from "./App";
+import "./index.css";
+
+ReactDOM.createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

biucingcli/template_data/frontend/template/src/pages/HomePage.tsx

@@ -0,0 +1,60 @@
+import { MetricCard } from "../components/MetricCard";
+import { TaskPanel } from "../components/TaskPanel";
+import { useProjectOverview } from "../hooks/useProjectOverview";
+
+export function HomePage() {
+  const overview = useProjectOverview();
+
+  if (!overview) {
+    return (
+      <main className="app-shell">
+        <div className="workspace">
+          <section className="hero">
+            <p className="hero__eyebrow">BiucingCLI</p>
+            <div className="hero__headline">
+              <h1>{{DISPLAY_NAME}}</h1>
+              <p>Loading your starter workspace...</p>
+            </div>
+          </section>
+        </div>
+      </main>
+    );
+  }
+
+  return (
+    <main className="app-shell">
+      <div className="workspace">
+        <section className="hero">
+          <p className="hero__eyebrow">BiucingCLI</p>
+          <div className="hero__headline">
+            <h1>{overview.title}</h1>
+            <p>{overview.description}</p>
+          </div>
+          <div className="hero__meta">
+            {overview.tags.map((tag) => (
+              <span className="hero__tag" key={tag}>
+                {tag}
+              </span>
+            ))}
+          </div>
+        </section>
+
+        <section className="metrics">
+          {overview.metrics.map((metric) => (
+            <MetricCard
+              key={metric.label}
+              label={metric.label}
+              value={metric.value}
+              tone={metric.tone}
+            />
+          ))}
+        </section>
+
+        <section className="panels">
+          <TaskPanel title="Build Queue" tasks={overview.buildQueue} />
+          <TaskPanel title="Project Notes" tasks={overview.notes} />
+        </section>
+      </div>
+    </main>
+  );
+}

biucingcli/template_data/frontend/template/src/router/AppRouter.tsx

@@ -0,0 +1,14 @@
+import { createBrowserRouter, RouterProvider } from "react-router-dom";
+
+import { HomePage } from "../pages/HomePage";
+
+const router = createBrowserRouter([
+  {
+    path: "/",
+    element: <HomePage />,
+  },
+]);
+
+export function AppRouter() {
+  return <RouterProvider router={router} future={{ v7_startTransition: true }} />;
+}

biucingcli/template_data/frontend/template/src/services/api/client.ts

@@ -0,0 +1,33 @@
+import { env } from "../../config/env";
+
+export class ApiError extends Error {
+  constructor(
+    message: string,
+    public readonly status: number,
+  ) {
+    super(message);
+    this.name = "ApiError";
+  }
+}
+
+function buildUrl(path: string): string {
+  if (!env.apiBaseUrl) {
+    throw new Error("VITE_API_BASE_URL is not configured");
+  }
+
+  return new URL(path, `${env.apiBaseUrl.replace(/\/+$/, "")}/`).toString();
+}
+
+export async function getJson<T>(path: string): Promise<T> {
+  const response = await fetch(buildUrl(path), {
+    headers: {
+      Accept: "application/json",
+    },
+  });
+
+  if (!response.ok) {
+    throw new ApiError(`Request failed for ${path}`, response.status);
+  }
+
+  return (await response.json()) as T;
+}

biucingcli/template_data/frontend/template/src/services/projectOverview.ts

@@ -0,0 +1,39 @@
+import { env } from "../config/env";
+import { getJson } from "./api/client";
+import type { ProjectOverview } from "../types/projectOverview";
+
+export function getProjectOverviewFallback(): ProjectOverview {
+  return {
+    title: "{{DISPLAY_NAME}}",
+    description:
+      "A practical React + TypeScript starter with a small UI structure, a lightweight service layer, and room to grow without cleanup first.",
+    tags: ["React", "TypeScript", "Vite", "BiucingCLI"],
+    metrics: [
+      { label: "Screens ready", value: "1", tone: "amber" },
+      { label: "Shared services", value: "1", tone: "slate" },
+      { label: "UI building blocks", value: "2", tone: "slate" },
+    ],
+    buildQueue: [
+      { id: "task_01", title: "Replace starter copy with product copy", status: "Ready" },
+      { id: "task_02", title: "Connect API requests in services layer", status: "Planned" },
+      { id: "task_03", title: "Split HomePage into route-level screens", status: "Backlog" },
+    ],
+    notes: [
+      { id: "note_01", title: "Start with pages as feature entrypoints", status: "Pattern" },
+      { id: "note_02", title: "Keep API logic inside services", status: "Pattern" },
+      { id: "note_03", title: "Promote components only when reused", status: "Reminder" },
+    ],
+  };
+}
+
+export async function getProjectOverview(): Promise<ProjectOverview> {
+  if (!env.apiBaseUrl) {
+    return getProjectOverviewFallback();
+  }
+
+  try {
+    return await getJson<ProjectOverview>("/project-overview");
+  } catch {
+    return getProjectOverviewFallback();
+  }
+}

biucingcli/template_data/frontend/template/src/test/setup.ts

@@ -0,0 +1 @@
+import "@testing-library/jest-dom/vitest";

biucingcli/template_data/frontend/template/src/types/projectOverview.ts

@@ -0,0 +1,22 @@
+export type MetricTone = "amber" | "slate";
+
+export type ProjectTask = {
+  id: string;
+  title: string;
+  status: string;
+};
+
+export type ProjectMetric = {
+  label: string;
+  value: string;
+  tone: MetricTone;
+};
+
+export type ProjectOverview = {
+  title: string;
+  description: string;
+  tags: string[];
+  metrics: ProjectMetric[];
+  buildQueue: ProjectTask[];
+  notes: ProjectTask[];
+};

biucingcli/template_data/frontend/template/src/vite-env.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_API_BASE_URL?: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

biucingcli/template_data/frontend/template/tests/browser-smoke.spec.ts

@@ -0,0 +1,16 @@
+import { expect, test } from "playwright/test";
+
+test("starter homepage renders key sections", async ({ page }, testInfo) => {
+  await page.goto("/");
+
+  await expect(page).toHaveTitle(/{{DISPLAY_NAME}}/);
+  await expect(page.getByRole("heading", { name: "{{DISPLAY_NAME}}" })).toBeVisible();
+  await expect(page.getByText("Build Queue")).toBeVisible();
+  await expect(page.getByText("Project Notes")).toBeVisible();
+  await expect(page.locator(".metric-card")).toHaveCount(3);
+
+  await page.screenshot({
+    path: testInfo.outputPath("browser-smoke-homepage.png"),
+    fullPage: true,
+  });
+});

biucingcli/template_data/frontend/template/tests/production-browser-smoke.spec.ts

@@ -0,0 +1,22 @@
+import { expect, test } from "playwright/test";
+
+test("production image serves the starter through nginx", async ({
+  page,
+}, testInfo) => {
+  const response = await page.goto("/");
+
+  expect(response?.ok()).toBe(true);
+  expect(response?.headers()["server"]).toContain("nginx");
+  await expect(page).toHaveTitle(/{{DISPLAY_NAME}}/);
+  await expect(
+    page.getByRole("heading", { name: "{{DISPLAY_NAME}}" }),
+  ).toBeVisible();
+  await expect(page.getByText("Build Queue")).toBeVisible();
+  await expect(page.getByText("Project Notes")).toBeVisible();
+  await expect(page.locator(".metric-card")).toHaveCount(3);
+
+  await page.screenshot({
+    path: testInfo.outputPath("production-image-homepage.png"),
+    fullPage: true,
+  });
+});

biucingcli/template_data/frontend/template/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["DOM", "DOM.Iterable", "ES2020"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx"
+  },
+  "include": ["src"],
+  "references": []
+}