shirokuma-docs 0.1.0-alpha.1

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/messages-split/errors.json.template

@@ -0,0 +1,29 @@
+{
+  "general": {
+    "unknown": "An unknown error occurred",
+    "network": "Network error. Please check your connection.",
+    "timeout": "Request timed out. Please try again.",
+    "serverError": "Server error. Please try again later."
+  },
+  "auth": {
+    "unauthorized": "You are not authorized to perform this action",
+    "sessionExpired": "Your session has expired. Please log in again.",
+    "invalidCredentials": "Invalid email or password",
+    "accountLocked": "Your account has been locked"
+  },
+  "validation": {
+    "required": "This field is required",
+    "invalid": "Invalid value",
+    "tooShort": "Value is too short",
+    "tooLong": "Value is too long"
+  },
+  "notFound": {
+    "page": "Page not found",
+    "resource": "Resource not found",
+    "{{name}}": "{{Name}} not found"
+  },
+  "permission": {
+    "denied": "Permission denied",
+    "adminRequired": "Admin access required"
+  }
+}

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/messages-split/feature.json.template

@@ -0,0 +1,46 @@
+{
+  "title": "{{Name}} Management",
+  "description": "Manage {{name}}s",
+  "list": {
+    "title": "{{Name}} List",
+    "description": "View and manage all {{name}}s",
+    "empty": "No {{name}}s yet",
+    "createFirst": "Create your first {{name}}"
+  },
+  "new": {
+    "title": "New {{Name}}",
+    "description": "Create a new {{name}}"
+  },
+  "edit": {
+    "title": "Edit {{Name}}",
+    "description": "Edit {{name}} details"
+  },
+  "delete": {
+    "title": "Delete {{Name}}",
+    "confirm": "Are you sure you want to delete this {{name}}?",
+    "warning": "This action cannot be undone."
+  },
+  "table": {
+    "name": "Name",
+    "description": "Description",
+    "createdAt": "Created",
+    "updatedAt": "Updated",
+    "status": "Status"
+  },
+  "form": {
+    "name": "Name",
+    "namePlaceholder": "Enter {{name}} name",
+    "nameHelp": "A unique name for this {{name}}",
+    "description": "Description",
+    "descriptionPlaceholder": "Enter description (optional)",
+    "descriptionHelp": "A brief description of this {{name}}"
+  },
+  "messages": {
+    "created": "{{Name}} created successfully",
+    "updated": "{{Name}} updated successfully",
+    "deleted": "{{Name}} deleted successfully",
+    "createError": "Failed to create {{name}}",
+    "updateError": "Failed to update {{name}}",
+    "deleteError": "Failed to delete {{name}}"
+  }
+}

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/messages-split/index.ts.template

@@ -0,0 +1,26 @@
+// messages/{{locale}}/index.ts
+/**
+ * {{Locale}} Messages - Aggregator
+ *
+ * Combines all namespace JSON files into a single messages object.
+ * Use this pattern when messages file exceeds 300 lines or 200+ keys.
+ */
+
+import common from './common.json'
+import auth from './auth.json'
+import content from './content.json'
+import errors from './errors.json'
+import validation from './validation.json'
+// Add more namespaces as needed
+// import {{name}}s from './{{name}}s.json'
+
+const messages = {
+  common,
+  auth,
+  content,
+  errors,
+  validation,
+  // {{name}}s,
+}
+
+export default messages

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/page-edit.tsx.template

@@ -0,0 +1,43 @@
+// app/[locale]/(dashboard)/{{name}}s/[id]/edit/page.tsx
+import { notFound } from "next/navigation"
+import { getTranslations, setRequestLocale } from "next-intl/server"
+import { get{{Name}} } from "@/lib/actions/{{name}}"
+import { {{Name}}Form } from "@/components/{{name}}-form"
+
+type Props = {
+  params: Promise<{ locale: string; id: string }>
+}
+
+export default async function Edit{{Name}}Page({ params }: Props) {
+  const { locale, id } = await params
+  setRequestLocale(locale)
+
+  const t = await getTranslations("{{name}}s")
+
+  const {{name}} = await get{{Name}}(id)
+
+  if (!{{name}}) {
+    notFound()
+  }
+
+  return (
+    <div className="space-y-6">
+      {/* Header */}
+      <div>
+        <h1 className="text-2xl font-bold">{t("edit{{Name}}")}</h1>
+        <p className="text-muted-foreground">
+          {t("edit{{Name}}Description", { name: {{name}}.name })}
+        </p>
+      </div>
+
+      {/* Form */}
+      <{{Name}}Form
+        initialData={{
+          id: {{name}}.id,
+          name: {{name}}.name,
+          description: {{name}}.description,
+        }}
+      />
+    </div>
+  )
+}

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/page-list.tsx.template

@@ -0,0 +1,133 @@
+// app/[locale]/(dashboard)/{{name}}s/page.tsx
+import { Suspense } from "react"
+import Link from "next/link"
+import { getTranslations, setRequestLocale } from "next-intl/server"
+import { get{{Name}}s } from "@/lib/actions/{{name}}"
+import { Button } from "@/components/ui/button"
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table"
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card"
+import { Pagination } from "@/components/pagination"
+import { {{Name}}DeleteButton } from "@/components/{{name}}-delete-button"
+import { Plus, Pencil } from "lucide-react"
+
+type Props = {
+  params: Promise<{ locale: string }>
+  searchParams: Promise<{ page?: string }>
+}
+
+export default async function {{Name}}sPage({ params, searchParams }: Props) {
+  const { locale } = await params
+  setRequestLocale(locale)
+
+  const { page: pageStr } = await searchParams
+  const page = Math.max(1, parseInt(pageStr || "1", 10))
+
+  const t = await getTranslations("{{name}}s")
+  const tCommon = await getTranslations("common")
+
+  const { {{name}}s, pagination } = await get{{Name}}s(page)
+
+  return (
+    <div className="space-y-6">
+      {/* Header */}
+      <div className="flex items-center justify-between">
+        <div>
+          <h1 className="text-2xl font-bold">{t("title")}</h1>
+          <p className="text-muted-foreground">
+            {t("description", { total: pagination.total })}
+          </p>
+        </div>
+        <Button asChild>
+          <Link href="/{{name}}s/new">
+            <Plus className="h-4 w-4 mr-2" />
+            {t("new{{Name}}")}
+          </Link>
+        </Button>
+      </div>
+
+      {/* Content */}
+      <Card>
+        <CardHeader>
+          <CardTitle>{t("listTitle")}</CardTitle>
+          <CardDescription>{t("listDescription")}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          {{{name}}s.length === 0 ? (
+            <div className="py-8 text-center">
+              <p className="text-muted-foreground">{t("no{{Name}}s")}</p>
+              <Button asChild className="mt-4">
+                <Link href="/{{name}}s/new">{t("createFirst")}</Link>
+              </Button>
+            </div>
+          ) : (
+            <>
+              <Table>
+                <TableHeader>
+                  <TableRow>
+                    <TableHead>{t("table.name")}</TableHead>
+                    <TableHead>{t("table.description")}</TableHead>
+                    <TableHead>{tCommon("createdAt")}</TableHead>
+                    <TableHead className="text-right">{tCommon("actions")}</TableHead>
+                  </TableRow>
+                </TableHeader>
+                <TableBody>
+                  {{{name}}s.map((item) => (
+                    <TableRow key={item.id}>
+                      <TableCell className="font-medium">{item.name}</TableCell>
+                      <TableCell className="max-w-xs truncate">
+                        {item.description || "-"}
+                      </TableCell>
+                      <TableCell>
+                        {item.createdAt.toLocaleDateString(
+                          locale === "ja" ? "ja-JP" : "en-US"
+                        )}
+                      </TableCell>
+                      <TableCell className="text-right">
+                        <div className="flex justify-end gap-2">
+                          <Button variant="ghost" size="icon" asChild>
+                            <Link href={`/{{name}}s/${item.id}/edit`}>
+                              <Pencil className="h-4 w-4" />
+                              <span className="sr-only">{tCommon("edit")}</span>
+                            </Link>
+                          </Button>
+                          <{{Name}}DeleteButton
+                            id={item.id}
+                            name={item.name}
+                          />
+                        </div>
+                      </TableCell>
+                    </TableRow>
+                  ))}
+                </TableBody>
+              </Table>
+
+              {/* Pagination */}
+              {pagination.totalPages > 1 && (
+                <div className="mt-4 flex justify-center">
+                  <Pagination
+                    currentPage={pagination.page}
+                    totalPages={pagination.totalPages}
+                    basePath="/{{name}}s"
+                  />
+                </div>
+              )}
+            </>
+          )}
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/page-new.tsx.template

@@ -0,0 +1,27 @@
+// app/[locale]/(dashboard)/{{name}}s/new/page.tsx
+import { getTranslations, setRequestLocale } from "next-intl/server"
+import { {{Name}}Form } from "@/components/{{name}}-form"
+
+type Props = {
+  params: Promise<{ locale: string }>
+}
+
+export default async function New{{Name}}Page({ params }: Props) {
+  const { locale } = await params
+  setRequestLocale(locale)
+
+  const t = await getTranslations("{{name}}s")
+
+  return (
+    <div className="space-y-6">
+      {/* Header */}
+      <div>
+        <h1 className="text-2xl font-bold">{t("new{{Name}}Title")}</h1>
+        <p className="text-muted-foreground">{t("new{{Name}}Description")}</p>
+      </div>
+
+      {/* Form */}
+      <{{Name}}Form />
+    </div>
+  )
+}

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/server-action-split/index.ts.template

@@ -0,0 +1,19 @@
+// lib/actions/{{name}}s/index.ts
+/**
+ * {{Name}} Actions - Barrel Export
+ *
+ * Re-exports all {{name}} related server actions.
+ * Use this pattern when actions file exceeds 300 lines or 8+ functions.
+ */
+
+// Query functions (read operations)
+export * from './queries'
+
+// Mutation functions (write operations)
+export * from './mutations'
+
+// Filter functions (if applicable)
+// export * from './filters'
+
+// Types
+export type { {{Name}}, {{Name}}WithRelations } from './types'

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/server-action-split/mutations.ts.template

@@ -0,0 +1,196 @@
+// lib/actions/{{name}}s/mutations.ts
+"use server"
+
+/**
+ * {{Name}} Mutation Functions
+ *
+ * Write operations (create, update, delete) for {{name}}s.
+ */
+
+import { revalidatePath } from "next/cache"
+import { headers } from "next/headers"
+import { db, {{name}}s } from "@repo/database"
+import { eq } from "drizzle-orm"
+import { verifyAdmin } from "@/lib/auth"
+import { {{Name}}Schema, type ActionResult } from "./types"
+
+// ============================================================================
+// Create
+// ============================================================================
+
+/**
+ * Create a new {{name}}
+ */
+export async function create{{Name}}(
+  formData: FormData
+): Promise<ActionResult<{ id: string }>> {
+  const session = await verifyAdmin(await headers())
+  if (!session) {
+    return { success: false, error: "Unauthorized" }
+  }
+
+  const validated = {{Name}}Schema.safeParse({
+    name: formData.get("name"),
+    description: formData.get("description") || null,
+  })
+
+  if (!validated.success) {
+    return { success: false, error: validated.error.errors[0].message }
+  }
+
+  try {
+    const [result] = await db
+      .insert({{name}}s)
+      .values({
+        name: validated.data.name,
+        description: validated.data.description,
+      })
+      .returning({ id: {{name}}s.id })
+
+    revalidatePath("/{{name}}s")
+    return { success: true, data: { id: result.id } }
+  } catch (error) {
+    console.error("Failed to create {{name}}:", error)
+    return { success: false, error: "Failed to create {{name}}" }
+  }
+}
+
+// ============================================================================
+// Update
+// ============================================================================
+
+/**
+ * Update an existing {{name}}
+ */
+export async function update{{Name}}(
+  id: string,
+  formData: FormData
+): Promise<ActionResult> {
+  const session = await verifyAdmin(await headers())
+  if (!session) {
+    return { success: false, error: "Unauthorized" }
+  }
+
+  const validated = {{Name}}Schema.safeParse({
+    name: formData.get("name"),
+    description: formData.get("description") || null,
+  })
+
+  if (!validated.success) {
+    return { success: false, error: validated.error.errors[0].message }
+  }
+
+  try {
+    const [result] = await db
+      .update({{name}}s)
+      .set({
+        name: validated.data.name,
+        description: validated.data.description,
+        updatedAt: new Date(),
+      })
+      .where(eq({{name}}s.id, id))
+      .returning({ id: {{name}}s.id })
+
+    if (!result) {
+      return { success: false, error: "{{Name}} not found" }
+    }
+
+    revalidatePath("/{{name}}s")
+    revalidatePath(`/{{name}}s/${id}/edit`)
+    return { success: true }
+  } catch (error) {
+    console.error("Failed to update {{name}}:", error)
+    return { success: false, error: "Failed to update {{name}}" }
+  }
+}
+
+// ============================================================================
+// Delete
+// ============================================================================
+
+/**
+ * Delete a {{name}}
+ */
+export async function delete{{Name}}(id: string): Promise<ActionResult> {
+  const session = await verifyAdmin(await headers())
+  if (!session) {
+    return { success: false, error: "Unauthorized" }
+  }
+
+  try {
+    const [result] = await db
+      .delete({{name}}s)
+      .where(eq({{name}}s.id, id))
+      .returning({ id: {{name}}s.id })
+
+    if (!result) {
+      return { success: false, error: "{{Name}} not found" }
+    }
+
+    revalidatePath("/{{name}}s")
+    return { success: true }
+  } catch (error) {
+    console.error("Failed to delete {{name}}:", error)
+    return { success: false, error: "Failed to delete {{name}}" }
+  }
+}
+
+// ============================================================================
+// Soft Delete (if applicable)
+// ============================================================================
+
+/**
+ * Soft delete a {{name}} (set deletedAt)
+ */
+export async function softDelete{{Name}}(id: string): Promise<ActionResult> {
+  const session = await verifyAdmin(await headers())
+  if (!session) {
+    return { success: false, error: "Unauthorized" }
+  }
+
+  try {
+    const [result] = await db
+      .update({{name}}s)
+      .set({ deletedAt: new Date() })
+      .where(eq({{name}}s.id, id))
+      .returning({ id: {{name}}s.id })
+
+    if (!result) {
+      return { success: false, error: "{{Name}} not found" }
+    }
+
+    revalidatePath("/{{name}}s")
+    return { success: true }
+  } catch (error) {
+    console.error("Failed to delete {{name}}:", error)
+    return { success: false, error: "Failed to delete {{name}}" }
+  }
+}
+
+/**
+ * Restore a soft-deleted {{name}}
+ */
+export async function restore{{Name}}(id: string): Promise<ActionResult> {
+  const session = await verifyAdmin(await headers())
+  if (!session) {
+    return { success: false, error: "Unauthorized" }
+  }
+
+  try {
+    const [result] = await db
+      .update({{name}}s)
+      .set({ deletedAt: null })
+      .where(eq({{name}}s.id, id))
+      .returning({ id: {{name}}s.id })
+
+    if (!result) {
+      return { success: false, error: "{{Name}} not found" }
+    }
+
+    revalidatePath("/{{name}}s")
+    return { success: true }
+  } catch (error) {
+    console.error("Failed to restore {{name}}:", error)
+    return { success: false, error: "Failed to restore {{name}}" }
+  }
+}

package/plugin/shirokuma-skills-ja/skills/nextjs-vibe-coding/templates/server-action-split/queries.ts.template

@@ -0,0 +1,134 @@
+// lib/actions/{{name}}s/queries.ts
+"use server"
+
+/**
+ * {{Name}} Query Functions
+ *
+ * Read-only operations for {{name}}s.
+ */
+
+import { headers } from "next/headers"
+import { db, {{name}}s } from "@repo/database"
+import { eq, desc, count, ilike, and, or } from "drizzle-orm"
+import { verifyAdmin } from "@/lib/auth"
+import type { {{Name}}, Paginated } from "./types"
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+const PAGE_SIZE = 20
+
+// ============================================================================
+// List Queries
+// ============================================================================
+
+/**
+ * Get paginated {{name}}s
+ */
+export async function get{{Name}}s(
+  page: number = 1,
+  options?: { search?: string }
+): Promise<Paginated<{{Name}}>> {
+  const session = await verifyAdmin(await headers())
+  if (!session) {
+    throw new Error("Unauthorized")
+  }
+
+  const offset = (page - 1) * PAGE_SIZE
+  const conditions = []
+
+  // Search filter
+  if (options?.search) {
+    const pattern = `%${options.search}%`
+    conditions.push(
+      or(
+        ilike({{name}}s.name, pattern),
+        ilike({{name}}s.description, pattern)
+      )
+    )
+  }
+
+  const whereClause = conditions.length > 0 ? and(...conditions) : undefined
+
+  const [items, countResult] = await Promise.all([
+    db
+      .select()
+      .from({{name}}s)
+      .where(whereClause)
+      .orderBy(desc({{name}}s.createdAt))
+      .limit(PAGE_SIZE)
+      .offset(offset),
+    db
+      .select({ count: count() })
+      .from({{name}}s)
+      .where(whereClause),
+  ])
+
+  const total = countResult[0]?.count ?? 0
+
+  return {
+    items,
+    pagination: {
+      page,
+      pageSize: PAGE_SIZE,
+      total,
+      totalPages: Math.ceil(total / PAGE_SIZE),
+    },
+  }
+}
+
+// ============================================================================
+// Single Item Queries
+// ============================================================================
+
+/**
+ * Get a single {{name}} by ID
+ */
+export async function get{{Name}}(id: string): Promise<{{Name}} | null> {
+  const session = await verifyAdmin(await headers())
+  if (!session) {
+    throw new Error("Unauthorized")
+  }
+
+  const [result] = await db
+    .select()
+    .from({{name}}s)
+    .where(eq({{name}}s.id, id))
+
+  return result ?? null
+}
+
+/**
+ * Get a single {{name}} by slug (if applicable)
+ */
+export async function get{{Name}}BySlug(slug: string): Promise<{{Name}} | null> {
+  const session = await verifyAdmin(await headers())
+  if (!session) {
+    throw new Error("Unauthorized")
+  }
+
+  const [result] = await db
+    .select()
+    .from({{name}}s)
+    .where(eq({{name}}s.slug, slug))
+
+  return result ?? null
+}
+
+// ============================================================================
+// Existence Checks
+// ============================================================================
+
+/**
+ * Check if {{name}} exists by ID
+ */
+export async function {{name}}Exists(id: string): Promise<boolean> {
+  const [result] = await db
+    .select({ id: {{name}}s.id })
+    .from({{name}}s)
+    .where(eq({{name}}s.id, id))
+    .limit(1)
+
+  return !!result
+}