@famgia/omnify-typescript 0.0.66 → 0.0.68

package/stubs/JapaneseBankField.tsx.stub

@@ -0,0 +1,212 @@
+/**
+ * JapaneseBankField - Japanese bank account input component
+ */
+import { Form, Input, Select, Row, Col } from 'antd';
+import type { FormInstance } from 'antd';
+import type { RuleObject } from 'antd/es/form';
+import { zodRule } from '../lib/form-validation.js';
+import { getZodLocale } from '../lib/zod-i18n.js';
+import { BankAccountType, BankAccountTypeValues, getBankAccountTypeLabel } from '../enum/plugin/BankAccountType.js';
+
+interface I18nConfig {
+  fields: Record<string, { label?: Record<string, string>; placeholder?: Record<string, string> }>;
+}
+
+interface SelectOption {
+  value: string | number;
+  label: string;
+}
+
+interface JapaneseBankFieldProps {
+  form?: FormInstance;
+  schemas: Record<string, unknown>;
+  i18n: I18nConfig;
+  prefix?: string;
+  accountTypeOptions?: SelectOption[];
+}
+
+function getLabel(i18n: I18nConfig, field: string, locale: string): string {
+  return i18n.fields[field]?.label?.[locale] ?? i18n.fields[field]?.label?.['en'] ?? field;
+}
+
+function getPlaceholder(i18n: I18nConfig, field: string, locale: string): string {
+  return i18n.fields[field]?.placeholder?.[locale] ?? i18n.fields[field]?.placeholder?.['en'] ?? '';
+}
+
+// Build account type options from enum
+function buildAccountTypeOptions(locale: string): SelectOption[] {
+  return BankAccountTypeValues.map(value => ({
+    value,
+    label: getBankAccountTypeLabel(value, locale),
+  }));
+}
+
+export function JapaneseBankField({
+  schemas,
+  i18n,
+  prefix = 'bank',
+  accountTypeOptions,
+}: JapaneseBankFieldProps) {
+  const locale = getZodLocale();
+  const options = accountTypeOptions ?? buildAccountTypeOptions(locale);
+
+  const bankCodeField = `${prefix}_bank_code`;
+  const bankNameField = `${prefix}_bank_name`;
+  const branchCodeField = `${prefix}_branch_code`;
+  const branchNameField = `${prefix}_branch_name`;
+  const accountTypeField = `${prefix}_account_type`;
+  const accountNumberField = `${prefix}_account_number`;
+  const accountHolderField = `${prefix}_account_holder`;
+
+  const getRule = (field: string): RuleObject[] => {
+    const schema = schemas[field];
+    if (!schema) return [];
+    return [zodRule(schema as any, getLabel(i18n, field, locale))];
+  };
+
+  // Check if a field is required by examining its Zod schema
+  const isRequired = (field: string): boolean => {
+    const schema = schemas[field];
+    if (!schema) return false;
+    const schemaDesc = (schema as any)?._def?.typeName;
+    const inner = (schema as any)?._def?.innerType;
+    if (schemaDesc === 'ZodOptional' || schemaDesc === 'ZodNullable') return false;
+    if (inner?._def?.typeName === 'ZodOptional' || inner?._def?.typeName === 'ZodNullable') return false;
+    return true;
+  };
+
+  const bankRequired = isRequired(bankCodeField) || isRequired(bankNameField);
+  const branchRequired = isRequired(branchCodeField) || isRequired(branchNameField);
+
+  // Short labels
+  const codeShortLabel = locale === 'ja' ? 'コード' : 'Code';
+  const nameShortLabel = locale === 'ja' ? '名称' : 'Name';
+
+  // Compound label from i18n
+  const compoundLabel = i18n.fields[prefix]?.label?.[locale]
+    ?? i18n.fields[prefix]?.label?.['en']
+    ?? getLabel(i18n, bankCodeField, locale);
+
+  const bankLabel = locale === 'ja' ? '銀行' : 'Bank';
+  const branchLabel = locale === 'ja' ? '支店' : 'Branch';
+
+  const prefixStyle = {
+    color: 'rgba(0, 0, 0, 0.88)',
+    fontWeight: 500,
+    borderRight: '1px solid #d9d9d9',
+    paddingRight: 8,
+    marginRight: 4,
+  };
+
+  return (
+    <>
+      {/* 銀行コード・銀行名 */}
+      <Form.Item
+        label={bankLabel}
+        required={bankRequired}
+        style={{ marginBottom: 0 }}
+      >
+        <Row gutter={8}>
+          <Col span={8}>
+            <Form.Item
+              name={bankCodeField}
+              rules={getRule(bankCodeField)}
+              style={{ marginBottom: 16 }}
+            >
+              <Input
+                prefix={<span style={prefixStyle}>{codeShortLabel}</span>}
+                placeholder={getPlaceholder(i18n, bankCodeField, locale)}
+                maxLength={4}
+              />
+            </Form.Item>
+          </Col>
+          <Col span={16}>
+            <Form.Item
+              name={bankNameField}
+              rules={getRule(bankNameField)}
+              style={{ marginBottom: 16 }}
+            >
+              <Input
+                prefix={<span style={prefixStyle}>{nameShortLabel}</span>}
+                placeholder={getPlaceholder(i18n, bankNameField, locale)}
+              />
+            </Form.Item>
+          </Col>
+        </Row>
+      </Form.Item>
+
+      {/* 支店コード・支店名 */}
+      <Form.Item
+        label={branchLabel}
+        required={branchRequired}
+        style={{ marginBottom: 0 }}
+      >
+        <Row gutter={8}>
+          <Col span={8}>
+            <Form.Item
+              name={branchCodeField}
+              rules={getRule(branchCodeField)}
+              style={{ marginBottom: 16 }}
+            >
+              <Input
+                prefix={<span style={prefixStyle}>{codeShortLabel}</span>}
+                placeholder={getPlaceholder(i18n, branchCodeField, locale)}
+                maxLength={3}
+              />
+            </Form.Item>
+          </Col>
+          <Col span={16}>
+            <Form.Item
+              name={branchNameField}
+              rules={getRule(branchNameField)}
+              style={{ marginBottom: 16 }}
+            >
+              <Input
+                prefix={<span style={prefixStyle}>{nameShortLabel}</span>}
+                placeholder={getPlaceholder(i18n, branchNameField, locale)}
+              />
+            </Form.Item>
+          </Col>
+        </Row>
+      </Form.Item>
+
+      {/* 口座種別 */}
+      <Form.Item
+        name={accountTypeField}
+        label={getLabel(i18n, accountTypeField, locale)}
+        rules={getRule(accountTypeField)}
+        required={isRequired(accountTypeField)}
+      >
+        <Select
+          placeholder={getPlaceholder(i18n, accountTypeField, locale)}
+          options={options}
+          style={{ width: 150 }}
+        />
+      </Form.Item>
+
+      {/* 口座番号 */}
+      <Form.Item
+        name={accountNumberField}
+        label={getLabel(i18n, accountNumberField, locale)}
+        rules={getRule(accountNumberField)}
+        required={isRequired(accountNumberField)}
+      >
+        <Input
+          placeholder={getPlaceholder(i18n, accountNumberField, locale)}
+          maxLength={7}
+          style={{ width: 150 }}
+        />
+      </Form.Item>
+
+      {/* 口座名義 */}
+      <Form.Item
+        name={accountHolderField}
+        label={getLabel(i18n, accountHolderField, locale)}
+        rules={getRule(accountHolderField)}
+        required={isRequired(accountHolderField)}
+      >
+        <Input placeholder={getPlaceholder(i18n, accountHolderField, locale)} />
+      </Form.Item>
+    </>
+  );
+}

package/stubs/JapaneseNameField.tsx.stub

@@ -0,0 +1,194 @@
+/**
+ * JapaneseNameField - Japanese name input component
+ * Handles lastname + firstname with optional kana fields
+ */
+import { Form, Input, Row, Col } from 'antd';
+import type { FormInstance } from 'antd';
+import type { RuleObject } from 'antd/es/form';
+import { zodRule } from '../lib/form-validation';
+import { getZodLocale } from '../lib/zod-i18n';
+
+interface I18nConfig {
+    fields: Record<string, { label?: Record<string, string>; placeholder?: Record<string, string> }>;
+}
+
+interface JapaneseNameFieldProps {
+    form?: FormInstance;
+    schemas: Record<string, unknown>;
+    i18n: I18nConfig;
+    prefix?: string;
+    required?: boolean;
+    showKana?: boolean;
+    label?: string;
+    kanaLabel?: string;
+}
+
+function getLabel(i18n: I18nConfig, field: string, locale: string): string {
+    return i18n.fields[field]?.label?.[locale] ?? i18n.fields[field]?.label?.['en'] ?? field;
+}
+
+function getCompoundLabel(i18n: I18nConfig, prefix: string, locale: string): string | undefined {
+    // Try to get compound-level label (e.g., 'name' -> '氏名')
+    return i18n.fields[prefix]?.label?.[locale] ?? i18n.fields[prefix]?.label?.['en'];
+}
+
+function getPlaceholder(i18n: I18nConfig, field: string, locale: string): string {
+    return i18n.fields[field]?.placeholder?.[locale] ?? i18n.fields[field]?.placeholder?.['en'] ?? '';
+}
+
+export function JapaneseNameField({
+    schemas,
+    i18n,
+    prefix = 'name',
+    required = false,
+    showKana = true,
+    label,
+    kanaLabel,
+}: JapaneseNameFieldProps) {
+    const locale = getZodLocale();
+
+    const lastnameField = `${prefix}_lastname`;
+    const firstnameField = `${prefix}_firstname`;
+    const kanaLastnameField = `${prefix}_kana_lastname`;
+    const kanaFirstnameField = `${prefix}_kana_firstname`;
+
+    const getRule = (field: string): RuleObject[] => {
+        const schema = schemas[field];
+        if (!schema) return [];
+        return [zodRule(schema as any, getLabel(i18n, field, locale))];
+    };
+
+    // Check if a field is required by examining its Zod schema
+    const isFieldRequired = (field: string): boolean => {
+        const schema = schemas[field];
+        if (!schema) return false;
+        const schemaDesc = (schema as any)?._def?.typeName;
+        const inner = (schema as any)?._def?.innerType;
+        if (schemaDesc === 'ZodOptional' || schemaDesc === 'ZodNullable') return false;
+        if (inner?._def?.typeName === 'ZodOptional' || inner?._def?.typeName === 'ZodNullable') return false;
+        return true;
+    };
+
+    const nameRequired = isFieldRequired(lastnameField) || isFieldRequired(firstnameField) || required;
+    const kanaRequired = isFieldRequired(kanaLastnameField) || isFieldRequired(kanaFirstnameField);
+
+    // Try compound label first, then fallback to first field's label
+    const nameLabel = label ?? getCompoundLabel(i18n, prefix, locale) ?? getLabel(i18n, lastnameField, locale);
+    const nameKanaLabel = kanaLabel ?? `${getCompoundLabel(i18n, prefix, locale) ?? getLabel(i18n, kanaLastnameField, locale)}（カナ）`;
+
+    // Get short field labels (姓, 名, etc.)
+    const lastnameShortLabel = locale === 'ja' ? '姓' : 'Last';
+    const firstnameShortLabel = locale === 'ja' ? '名' : 'First';
+
+    return (
+        <>
+            <Form.Item
+                label={nameLabel}
+                required={nameRequired}
+                style={{ marginBottom: 0 }}
+            >
+                <Row gutter={8}>
+                    <Col span={12}>
+                        <Form.Item
+                            name={lastnameField}
+                            rules={getRule(lastnameField)}
+                            style={{ marginBottom: 16 }}
+                        >
+                            <Input
+                                prefix={
+                                    <span style={{
+                                        color: 'rgba(0, 0, 0, 0.88)',
+                                        fontWeight: 500,
+                                        borderRight: '1px solid #d9d9d9',
+                                        paddingRight: 8,
+                                        marginRight: 4,
+                                    }}>
+                                        {lastnameShortLabel}
+                                    </span>
+                                }
+                                placeholder={getPlaceholder(i18n, lastnameField, locale)}
+                            />
+                        </Form.Item>
+                    </Col>
+                    <Col span={12}>
+                        <Form.Item
+                            name={firstnameField}
+                            rules={getRule(firstnameField)}
+                            style={{ marginBottom: 16 }}
+                        >
+                            <Input
+                                prefix={
+                                    <span style={{
+                                        color: 'rgba(0, 0, 0, 0.88)',
+                                        fontWeight: 500,
+                                        borderRight: '1px solid #d9d9d9',
+                                        paddingRight: 8,
+                                        marginRight: 4,
+                                    }}>
+                                        {firstnameShortLabel}
+                                    </span>
+                                }
+                                placeholder={getPlaceholder(i18n, firstnameField, locale)}
+                            />
+                        </Form.Item>
+                    </Col>
+                </Row>
+            </Form.Item>
+
+            {showKana && (
+                <Form.Item
+                    label={nameKanaLabel}
+                    required={kanaRequired}
+                    style={{ marginBottom: 0 }}
+                >
+                    <Row gutter={8}>
+                        <Col span={12}>
+                            <Form.Item
+                                name={kanaLastnameField}
+                                rules={getRule(kanaLastnameField)}
+                                style={{ marginBottom: 16 }}
+                            >
+                                <Input
+                                    prefix={
+                                        <span style={{
+                                            color: 'rgba(0, 0, 0, 0.88)',
+                                            fontWeight: 500,
+                                            borderRight: '1px solid #d9d9d9',
+                                            paddingRight: 8,
+                                            marginRight: 4,
+                                        }}>
+                                            {lastnameShortLabel}
+                                        </span>
+                                    }
+                                    placeholder={getPlaceholder(i18n, kanaLastnameField, locale)}
+                                />
+                            </Form.Item>
+                        </Col>
+                        <Col span={12}>
+                            <Form.Item
+                                name={kanaFirstnameField}
+                                rules={getRule(kanaFirstnameField)}
+                                style={{ marginBottom: 16 }}
+                            >
+                                <Input
+                                    prefix={
+                                        <span style={{
+                                            color: 'rgba(0, 0, 0, 0.88)',
+                                            fontWeight: 500,
+                                            borderRight: '1px solid #d9d9d9',
+                                            paddingRight: 8,
+                                            marginRight: 4,
+                                        }}>
+                                            {firstnameShortLabel}
+                                        </span>
+                                    }
+                                    placeholder={getPlaceholder(i18n, kanaFirstnameField, locale)}
+                                />
+                            </Form.Item>
+                        </Col>
+                    </Row>
+                </Form.Item>
+            )}
+        </>
+    );
+}

package/stubs/ai-guides/checklists/react.md.stub

@@ -0,0 +1,108 @@
+# Checklists
+
+> **Related:** [README](./README.md)
+
+## After Writing Code
+
+> **IMPORTANT**: Always run these commands after writing/modifying code:
+
+```bash
+# 1. Type check
+npm run typecheck
+
+# 2. Lint check
+npm run lint
+
+# Or combined
+npm run typecheck && npm run lint
+```
+
+---
+
+## Adding New Resource
+
+When adding a new resource (e.g., `posts`), follow these steps:
+
+### 1. Service Layer (Always in `services/`)
+
+```bash
+# Create: services/posts.ts
+```
+
+- [ ] Import types: `import type { Post, PostCreate, PostUpdate } from "@/types/model"`
+- [ ] Define only `PostListParams` (Create/Update come from Omnify)
+- [ ] Create `postService` object with CRUD methods
+- [ ] Add JSDoc comments for each method
+
+### 2. Query Keys
+
+```bash
+# Update: lib/queryKeys.ts
+```
+
+- [ ] Add `posts` object to `queryKeys`
+
+```typescript
+posts: {
+  all: ["posts"] as const,
+  lists: () => [...queryKeys.posts.all, "list"] as const,
+  list: (params?: PostListParams) => [...queryKeys.posts.lists(), params] as const,
+  details: () => [...queryKeys.posts.all, "detail"] as const,
+  detail: (id: number) => [...queryKeys.posts.details(), id] as const,
+},
+```
+
+### 3. Feature Components (in `features/posts/`)
+
+```bash
+# Create: features/posts/
+```
+
+- [ ] `PostTable.tsx` - Table component
+- [ ] `PostForm.tsx` - Form component
+- [ ] `usePostFilters.ts` - Feature-specific hooks (if needed)
+
+### 4. Pages
+
+```bash
+# Create pages in app/(dashboard)/posts/
+```
+
+- [ ] `page.tsx` - List page (imports from `features/posts/`)
+- [ ] `new/page.tsx` - Create form
+- [ ] `[id]/page.tsx` - Detail view
+- [ ] `[id]/edit/page.tsx` - Edit form
+
+### 5. Shared Components (only if reused)
+
+- [ ] If component used in 2+ features → move to `components/common/`
+
+### 6. Translations
+
+- [ ] Add labels to `src/i18n/messages/*.json` if needed
+
+### 7. Final Check
+
+- [ ] Run `npm run typecheck && npm run lint`
+- [ ] Test create, read, update, delete operations
+
+---
+
+## Adding New Language
+
+- [ ] Create message file: `src/i18n/messages/{locale}.json`
+- [ ] Add locale to `src/i18n/config.ts`
+- [ ] Import Ant Design locale in `src/components/AntdThemeProvider.tsx`
+- [ ] Test with `LocaleSwitcher` component
+
+---
+
+## Before Commit
+
+- [ ] `npm run typecheck` passes
+- [ ] `npm run lint` passes
+- [ ] No console warnings about deprecated props
+- [ ] No hardcoded strings (use i18n)
+- [ ] Forms handle loading state (`isPending`)
+- [ ] Forms handle validation errors (`getFormErrors`)
+- [ ] Mutations invalidate related queries