create-freakpunch 0.1.0 → 0.2.0

package/template/tools/templates/module/index.ts.tpl

@@ -1,37 +1,44 @@
-import { Blocks, Plus } from 'lucide-react'
-
-import { lazyPage } from '@/core/modules/lazy-page'
-import type { AppModule } from '@/core/modules/types'
-
-export const __id__Module: AppModule = {
-  id: '__id__',
-  nav: [
-    {
-      label: '__id__:nav',
-      path: '/app/__id__',
-      icon: Blocks,
-      group: '__group__',
-      permission: '__id__.view',
-    },
-  ],
-  quickActions: [
-    {
-      label: '__id__:quickActions.new',
-      description: '__id__:quickActions.newDescription',
-      path: '/app/__id__/new',
-      icon: Plus,
-      permission: '__id__.create',
-    },
-  ],
-  routes: [
-    {
-      path: '__id__',
-      handle: { crumb: '__id__:crumbs.list', permission: '__id__.view' },
-      children: [
-        { index: true, lazy: lazyPage(() => import('./pages/__id__-list-page')) },
-        { path: 'new', handle: { crumb: '__id__:crumbs.new', permission: '__id__.create' }, lazy: lazyPage(() => import('./pages/__id__-form-page')) },
-        { path: ':id/edit', handle: { crumb: '__id__:crumbs.edit', permission: '__id__.edit' }, lazy: lazyPage(() => import('./pages/__id__-form-page')) },
-      ],
-    },
-  ],
-}
+import { Blocks, Plus } from 'lucide-react'
+
+import { lazyPage } from '@/core/modules/lazy-page'
+import type { AppModule } from '@/core/modules/types'
+
+export const __id__Module: AppModule = {
+  id: '__id__',
+  nav: [
+    {
+      label: '__id__:nav',
+      path: '/app/__id__',
+      icon: Blocks,
+      group: '__group__',
+      permission: '__id__.view',
+    },
+  ],
+  quickActions: [
+    {
+      label: '__id__:quickActions.new',
+      description: '__id__:quickActions.newDescription',
+      path: '/app/__id__/new',
+      icon: Plus,
+      permission: '__id__.create',
+    },
+  ],
+  routes: [
+    {
+      path: '__id__',
+      handle: { crumb: '__id__:crumbs.list', permission: '__id__.view' },
+      children: [
+        { index: true, lazy: lazyPage(() => import('./pages/__id__-list-page')) },
+        { path: 'new', handle: { crumb: '__id__:crumbs.new', permission: '__id__.create' }, lazy: lazyPage(() => import('./pages/__id__-form-page')) },
+        {
+          path: ':id',
+          handle: { crumb: '__id__:crumbs.details' },
+          children: [
+            { index: true, lazy: lazyPage(() => import('./pages/__id__-detail-page')) },
+            { path: 'edit', handle: { crumb: '__id__:crumbs.edit', permission: '__id__.edit' }, lazy: lazyPage(() => import('./pages/__id__-form-page')) },
+          ],
+        },
+      ],
+    },
+  ],
+}

package/template/tools/templates/module/locales/en.ts.tpl

@@ -1,45 +1,51 @@
-/** __Name__ module strings (namespace `__id__`). */
-export default {
-  nav: '__labelEn__',
-  crumbs: { list: '__labelEn__', new: 'New', edit: 'Edit' },
-  quickActions: { new: 'New record', newDescription: 'Add to __labelEn__' },
-  noun: 'records',
-  status: { active: 'Active', draft: 'Draft', archived: 'Archived' },
-  list: {
-    title: '__labelEn__',
-    description: 'Manage your records.',
-    new: 'New record',
-    export: 'Export CSV',
-    search: 'Search…',
-    filterStatus: 'Status',
-    allStatuses: 'All statuses',
-    columns: { name: 'Name', status: 'Status', updated: 'Updated' },
-    noMatchesTitle: 'No matching records',
-    noMatchesDescription: 'Try a different search or clear the filters.',
-    emptyTitle: 'No records yet',
-    emptyDescription: 'Create your first record to get started.',
-  },
-  delete: {
-    title: 'Delete “{{name}}”?',
-    description: 'This cannot be undone.',
-    deleting: 'Deleting…',
-    deleted: '{{name}} deleted',
-    bulkTitle_one: 'Delete {{count}} record?',
-    bulkTitle_other: 'Delete {{count}} records?',
-    bulkDeleted_one: '{{count}} record deleted',
-    bulkDeleted_other: '{{count}} records deleted',
-  },
-  form: {
-    newTitle: 'New record',
-    editTitle: 'Edit {{name}}',
-    newDescription: 'Add a record.',
-    editDescription: 'Update this record.',
-    create: 'Create record',
-    created: 'Record created',
-    saved: 'Changes saved',
-    saveFailed: 'Could not save the record',
-    back: 'Back to the list',
-    sections: { details: 'Details', detailsDescription: 'The main information about this record.' },
-    fields: { name: 'Name', status: 'Status', notes: 'Notes', notesHint: 'Up to 500 characters.' },
-  },
-}
+/** __Name__ module strings (namespace `__id__`). */
+export default {
+  nav: '__labelEn__',
+  crumbs: { list: '__labelEn__', new: 'New', details: 'Details', edit: 'Edit' },
+  quickActions: { new: 'New record', newDescription: 'Add to __labelEn__' },
+  noun: 'records',
+  status: { active: 'Active', draft: 'Draft', archived: 'Archived' },
+  list: {
+    title: '__labelEn__',
+    description: 'Manage your records.',
+    new: 'New record',
+    export: 'Export CSV',
+    search: 'Search…',
+    filterStatus: 'Status',
+    allStatuses: 'All statuses',
+    columns: { name: 'Name', status: 'Status', updated: 'Updated' },
+    noMatchesTitle: 'No matching records',
+    noMatchesDescription: 'Try a different search or clear the filters.',
+    emptyTitle: 'No records yet',
+    emptyDescription: 'Create your first record to get started.',
+  },
+  delete: {
+    title: 'Delete “{{name}}”?',
+    description: 'This cannot be undone.',
+    deleting: 'Deleting…',
+    deleted: '{{name}} deleted',
+    bulkTitle_one: 'Delete {{count}} record?',
+    bulkTitle_other: 'Delete {{count}} records?',
+    bulkDeleted_one: '{{count}} record deleted',
+    bulkDeleted_other: '{{count}} records deleted',
+  },
+  detail: {
+    overview: 'Overview',
+    summary: 'Summary',
+    noNotes: 'No notes.',
+    fields: { status: 'Status', created: 'Created', updated: 'Updated' },
+  },
+  form: {
+    newTitle: 'New record',
+    editTitle: 'Edit {{name}}',
+    newDescription: 'Add a record.',
+    editDescription: 'Update this record.',
+    create: 'Create record',
+    created: 'Record created',
+    saved: 'Changes saved',
+    saveFailed: 'Could not save the record',
+    back: 'Back to the list',
+    sections: { details: 'Details', detailsDescription: 'The main information about this record.' },
+    fields: { name: 'Name', status: 'Status', notes: 'Notes', notesHint: 'Up to 500 characters.' },
+  },
+}

package/template/tools/templates/module/locales/tr.ts.tpl

@@ -1,49 +1,55 @@
-import type { Messages } from '@/core/i18n/types'
-import type en from './en'
-
-const tr: Messages<typeof en> = {
-  nav: '__labelTr__',
-  crumbs: { list: '__labelTr__', new: 'Yeni', edit: 'Düzenle' },
-  quickActions: { new: 'Yeni kayıt', newDescription: 'Kayıt ekleyin' },
-  noun: 'kayıt',
-  status: { active: 'Aktif', draft: 'Taslak', archived: 'Arşivlendi' },
-  list: {
-    title: '__labelTr__',
-    description: 'Kayıtlarınızı yönetin.',
-    new: 'Yeni kayıt',
-    export: 'CSV olarak dışa aktar',
-    search: 'Ara…',
-    filterStatus: 'Durum',
-    allStatuses: 'Tüm durumlar',
-    columns: { name: 'Ad', status: 'Durum', updated: 'Güncellenme' },
-    noMatchesTitle: 'Eşleşen kayıt yok',
-    noMatchesDescription: 'Farklı bir arama deneyin veya filtreleri temizleyin.',
-    emptyTitle: 'Henüz kayıt yok',
-    emptyDescription: 'Başlamak için ilk kaydınızı oluşturun.',
-  },
-  delete: {
-    title: '“{{name}}” silinsin mi?',
-    description: 'Bu işlem geri alınamaz.',
-    deleting: 'Siliniyor…',
-    deleted: '{{name}} silindi',
-    bulkTitle_one: '{{count}} kayıt silinsin mi?',
-    bulkTitle_other: '{{count}} kayıt silinsin mi?',
-    bulkDeleted_one: '{{count}} kayıt silindi',
-    bulkDeleted_other: '{{count}} kayıt silindi',
-  },
-  form: {
-    newTitle: 'Yeni kayıt',
-    editTitle: '{{name}} kaydını düzenle',
-    newDescription: 'Kayıt ekleyin.',
-    editDescription: 'Bu kaydı güncelleyin.',
-    create: 'Kayıt oluştur',
-    created: 'Kayıt oluşturuldu',
-    saved: 'Değişiklikler kaydedildi',
-    saveFailed: 'Kayıt kaydedilemedi',
-    back: 'Listeye dön',
-    sections: { details: 'Ayrıntılar', detailsDescription: 'Bu kaydın temel bilgileri.' },
-    fields: { name: 'Ad', status: 'Durum', notes: 'Notlar', notesHint: 'En fazla 500 karakter.' },
-  },
-}
-
-export default tr
+import type { Messages } from '@/core/i18n/types'
+import type en from './en'
+
+const tr: Messages<typeof en> = {
+  nav: '__labelTr__',
+  crumbs: { list: '__labelTr__', new: 'Yeni', details: 'Ayrıntılar', edit: 'Düzenle' },
+  quickActions: { new: 'Yeni kayıt', newDescription: 'Kayıt ekleyin' },
+  noun: 'kayıt',
+  status: { active: 'Aktif', draft: 'Taslak', archived: 'Arşivlendi' },
+  list: {
+    title: '__labelTr__',
+    description: 'Kayıtlarınızı yönetin.',
+    new: 'Yeni kayıt',
+    export: 'CSV olarak dışa aktar',
+    search: 'Ara…',
+    filterStatus: 'Durum',
+    allStatuses: 'Tüm durumlar',
+    columns: { name: 'Ad', status: 'Durum', updated: 'Güncellenme' },
+    noMatchesTitle: 'Eşleşen kayıt yok',
+    noMatchesDescription: 'Farklı bir arama deneyin veya filtreleri temizleyin.',
+    emptyTitle: 'Henüz kayıt yok',
+    emptyDescription: 'Başlamak için ilk kaydınızı oluşturun.',
+  },
+  delete: {
+    title: '“{{name}}” silinsin mi?',
+    description: 'Bu işlem geri alınamaz.',
+    deleting: 'Siliniyor…',
+    deleted: '{{name}} silindi',
+    bulkTitle_one: '{{count}} kayıt silinsin mi?',
+    bulkTitle_other: '{{count}} kayıt silinsin mi?',
+    bulkDeleted_one: '{{count}} kayıt silindi',
+    bulkDeleted_other: '{{count}} kayıt silindi',
+  },
+  detail: {
+    overview: 'Genel bakış',
+    summary: 'Özet',
+    noNotes: 'Not yok.',
+    fields: { status: 'Durum', created: 'Oluşturulma', updated: 'Güncellenme' },
+  },
+  form: {
+    newTitle: 'Yeni kayıt',
+    editTitle: '{{name}} kaydını düzenle',
+    newDescription: 'Kayıt ekleyin.',
+    editDescription: 'Bu kaydı güncelleyin.',
+    create: 'Kayıt oluştur',
+    created: 'Kayıt oluşturuldu',
+    saved: 'Değişiklikler kaydedildi',
+    saveFailed: 'Kayıt kaydedilemedi',
+    back: 'Listeye dön',
+    sections: { details: 'Ayrıntılar', detailsDescription: 'Bu kaydın temel bilgileri.' },
+    fields: { name: 'Ad', status: 'Durum', notes: 'Notlar', notesHint: 'En fazla 500 karakter.' },
+  },
+}
+
+export default tr

package/template/{src/modules/products/pages/product-detail-page.tsx → tools/templates/module/pages/__id__-detail-page.tsx.tpl}

@@ -1,108 +1,103 @@
-import type { ReactNode } from 'react'
-import { useTranslation } from 'react-i18next'
-import { useNavigate, useParams } from 'react-router'
-import { Package, Pencil, Trash2 } from 'lucide-react'
-import { toast } from 'sonner'
-
-import { Button } from '@/components/ui/button'
-import { Can } from '@/core/auth/can'
-import { ButtonLink } from '@/core/components/button-link'
-import { useConfirm } from '@/core/components/confirm-dialog'
-import { Page, Panel } from '@/core/components/page'
-import { ErrorState, LoadingState } from '@/core/components/states'
-import { useFormat } from '@/core/i18n/use-format'
-import { ProductStatusBadge, StockLevel } from '../components/product-status'
-import { useDeleteProduct, useProduct } from '../hooks'
-
-function BackToList() {
-  const { t } = useTranslation(['products', 'common'])
-  return (
-    <ButtonLink to="/app/products" variant="outline">
-      {t('detail.back')}
-    </ButtonLink>
-  )
-}
-
-export default function ProductDetailPage() {
-  const { id } = useParams()
-  const query = useProduct(id)
-  const remove = useDeleteProduct()
-  const confirm = useConfirm()
-  const navigate = useNavigate()
-  const { t } = useTranslation(['products', 'common'])
-  const fmt = useFormat()
-
-  if (query.isPending) return <LoadingState />
-  if (query.error) return <ErrorState error={query.error} onRetry={() => query.refetch()} notFoundAction={<BackToList />} />
-  const product = query.data
-
-  async function onDelete() {
-    const ok = await confirm({
-      title: t('delete.title', { name: product.name }),
-      description: t('delete.description'),
-      confirmLabel: t('common:actions.delete'),
-      destructive: true,
-    })
-    if (!ok) return
-    await remove.mutateAsync(product.id)
-    toast.success(t('delete.deleted', { name: product.name }))
-    navigate('/app/products', { replace: true })
-  }
-
-  return (
-    <Page
-      title={product.name}
-      description={<span className="tabular-nums text-xs">{product.sku}</span>}
-      leading={
-        <div className="flex size-12 shrink-0 items-center justify-center rounded-xl border bg-fill-1 text-muted-foreground">
-          <Package className="size-5" />
-        </div>
-      }
-      actions={
-        <>
-          <Can permission="products.delete">
-            <Button variant="destructive" onClick={onDelete} disabled={remove.isPending}>
-              <Trash2 data-icon="inline-start" />
-              {t('common:actions.delete')}
-            </Button>
-          </Can>
-          <Can permission="products.edit">
-            <ButtonLink to="edit">
-              <Pencil data-icon="inline-start" />
-              {t('common:actions.edit')}
-            </ButtonLink>
-          </Can>
-        </>
-      }
-    >
-      <div className="grid gap-4 lg:grid-cols-3">
-        <Panel label={t('detail.overview')} className="lg:col-span-2" bodyClassName="p-5">
-          <p className="text-sm leading-relaxed text-pretty">{product.description || t('detail.noDescription')}</p>
-        </Panel>
-        <Panel label={t('detail.summary')}>
-          <dl className="divide-y text-sm">
-            <Row label={t('detail.fields.status')}>
-              <ProductStatusBadge status={product.status} />
-            </Row>
-            <Row label={t('detail.fields.price')}>{fmt.currency(product.price)}</Row>
-            <Row label={t('detail.fields.stock')}>
-              <StockLevel stock={product.stock} />
-            </Row>
-            <Row label={t('detail.fields.category')}>{t(`categories.${product.category}`)}</Row>
-            <Row label={t('detail.fields.created')}>{fmt.date(product.createdAt)}</Row>
-            <Row label={t('detail.fields.updated')}>{fmt.relative(product.updatedAt)}</Row>
-          </dl>
-        </Panel>
-      </div>
-    </Page>
-  )
-}
-
-function Row({ label, children }: { label: string; children: ReactNode }) {
-  return (
-    <div className="flex items-center justify-between gap-4 px-4 py-2.5">
-      <dt className="text-muted-foreground">{label}</dt>
-      <dd className="text-right font-medium tabular-nums">{children}</dd>
-    </div>
-  )
-}
+import type { ReactNode } from 'react'
+import { useTranslation } from 'react-i18next'
+import { useNavigate, useParams } from 'react-router'
+import { Pencil, Trash2 } from 'lucide-react'
+import { toast } from 'sonner'
+
+import { Button } from '@/components/ui/button'
+import { Can } from '@/core/auth/can'
+import { ButtonLink } from '@/core/components/button-link'
+import { useConfirm } from '@/core/components/confirm-dialog'
+import { Page, Panel } from '@/core/components/page'
+import { ErrorState, LoadingState } from '@/core/components/states'
+import { StatusBadge, type StatusTone } from '@/core/components/status-badge'
+import { useFormat } from '@/core/i18n/use-format'
+import { useDelete__Name__, use__Name__Record } from '../hooks'
+import type { __Name__Status } from '../types'
+
+const tones: Record<__Name__Status, StatusTone> = { active: 'success', draft: 'neutral', archived: 'warning' }
+
+export default function __Name__DetailPage() {
+  const { id } = useParams()
+  const query = use__Name__Record(id)
+  const remove = useDelete__Name__()
+  const confirm = useConfirm()
+  const navigate = useNavigate()
+  const { t } = useTranslation(['__id__', 'common'])
+  const fmt = useFormat()
+
+  if (query.isPending) return <LoadingState />
+  if (query.error) {
+    return (
+      <ErrorState
+        error={query.error}
+        onRetry={() => query.refetch()}
+        notFoundAction={
+          <ButtonLink to="/app/__id__" variant="outline">
+            {t('form.back')}
+          </ButtonLink>
+        }
+      />
+    )
+  }
+  const record = query.data
+
+  async function onDelete() {
+    const ok = await confirm({
+      title: t('delete.title', { name: record.name }),
+      description: t('delete.description'),
+      confirmLabel: t('common:actions.delete'),
+      destructive: true,
+    })
+    if (!ok) return
+    await remove.mutateAsync(record.id)
+    toast.success(t('delete.deleted', { name: record.name }))
+    navigate('/app/__id__', { replace: true })
+  }
+
+  return (
+    <Page
+      title={record.name}
+      actions={
+        <>
+          <Can permission="__id__.delete">
+            <Button variant="destructive" onClick={onDelete} disabled={remove.isPending}>
+              <Trash2 data-icon="inline-start" />
+              {t('common:actions.delete')}
+            </Button>
+          </Can>
+          <Can permission="__id__.edit">
+            <ButtonLink to="edit">
+              <Pencil data-icon="inline-start" />
+              {t('common:actions.edit')}
+            </ButtonLink>
+          </Can>
+        </>
+      }
+    >
+      <div className="grid gap-4 lg:grid-cols-3">
+        <Panel label={t('detail.overview')} className="lg:col-span-2" bodyClassName="p-5">
+          <p className="text-sm leading-relaxed text-pretty">{record.notes || t('detail.noNotes')}</p>
+        </Panel>
+        <Panel label={t('detail.summary')}>
+          <dl className="divide-y text-sm">
+            <Row label={t('detail.fields.status')}>
+              <StatusBadge tone={tones[record.status]}>{t(`status.${record.status}`)}</StatusBadge>
+            </Row>
+            <Row label={t('detail.fields.created')}>{fmt.date(record.createdAt)}</Row>
+            <Row label={t('detail.fields.updated')}>{fmt.relative(record.updatedAt)}</Row>
+          </dl>
+        </Panel>
+      </div>
+    </Page>
+  )
+}
+
+function Row({ label, children }: { label: string; children: ReactNode }) {
+  return (
+    <div className="flex items-center justify-between gap-4 px-4 py-2.5">
+      <dt className="text-muted-foreground">{label}</dt>
+      <dd className="text-right font-medium tabular-nums">{children}</dd>
+    </div>
+  )
+}