@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/tools/components/filter/filter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"filter.cjs","names":["useFilter","cn","FieldFactory","FilterInput","Button","require_ui_lib_utils","require_ui_components_ui_button_components","require_tools_components_ui_field","require_filter_apply","require_filter_reset","require_tools_components_filter_use_filter","require_tools_components_filter_filter_inputs","react_jsx_runtime","SchemaFilter","fieldSpecs","globalLabelPosition","globalLabelWidth","globalOverlappingLabel","globalShowPlaceholderOnAll","globalInputClassName","autoApply","onChange","displayApplyLabel","applyLabel","displayResetLabel","resetLabel","handleApply","filter","handleReset","reset","testId","className","fields","field","values","setField","value","debounceMs","isEmpty"],"sources":["../../../../src/tools/components/filter/filter.tsx"],"sourcesContent":["/**\n * @fileoverview フィルターUIコンポーネント\n *\n * スキーマベースのフィルターUIを提供します。\n * useFilterフックと各種フィルター入力を組み合わせて、\n * 完全なフィルタリングUIを構築します。\n *\n * @module filter/filter\n */\n\n'use client';\n\nimport * as m from '../../paraglide/messages.js';\nimport { cn } from \"../../lib/utils\";\nimport { Button } from '../ui/button';\nimport { FilterInput } from './filter-inputs';\nimport { useFilter } from './use-filter';\nimport { FilterProps, FilterResult } from './filter-types';\nimport { FieldFactory } from '../ui/field';\n\n// =============================================================================\n// Filter Component\n// =============================================================================\n\n/**\n * Filter Component\n * フィルターUIコンポーネント\n *\n * Schema-based filter UI with type inference.\n * スキーマからフィールド型を推論し、適切なフィルター入力を自動選択します。\n * MongoDBスタイルのフィルターオブジェクトを生成し、useFindと連携できます。\n *\n * ## AI/Automation Features\n * - `data-testid`: Container, apply/reset buttons\n * - Pattern: `{testId}`, `{testId}-apply`, `{testId}-reset`\n * - Filter inputs auto-generate testId from field name\n *\n * @example Basic usage with testId\n * ```tsx\n * <Filter\n *   testId=\"user-filter\"\n *   schema={userSchema}\n *   fields={['name', 'age', 'status']}\n *   showPlaceholderOnAll={true}\n *   onChange={(filter) => setQueryFilter(filter)}\n * />\n * // Container: data-testid=\"user-filter\"\n * // Apply button: data-testid=\"user-filter-apply\"\n * // Reset button: data-testid=\"user-filter-reset\"\n * // Filter inputs auto-generate testId from field name\n *\n * @example Customizing filter widths\n * ```tsx\n * <Filter\n *   schema={userSchema}\n *   fields={[\n *     { field: 'name', className: 'min-w-[300px]' }, // Specific field\n *     'status'\n *   ]}\n *   inputClassName=\"min-w-[200px]\" // Global default for this instance\n * />\n * ```\n */\nexport function SchemaFilter({\n  testId,\n  schema,\n  fields: fieldSpecs,\n  defaultValues,\n  onChange,\n  autoApply = true,\n  applyLabel = '適用',\n  resetLabel,\n  className,\n  labelPosition: globalLabelPosition,\n  labelWidth: globalLabelWidth,\n  overlappingLabel: globalOverlappingLabel,\n  showPlaceholderOnAll: globalShowPlaceholderOnAll,\n  inputClassName: globalInputClassName,\n  locale, // Add locale to destructured props\n  debounceMs,\n}: FilterProps) {\n  const { values, filter, fields, setField, reset, isEmpty } = useFilter({\n    schema,\n    fields: fieldSpecs,\n    defaultValues,\n    onChange: autoApply ? onChange : undefined,\n    debounceMs,\n  });\n\n  const displayApplyLabel = applyLabel || m.filter_apply();\n  const displayResetLabel = resetLabel || m.filter_reset();\n\n  /**\n   * 適用ボタンのハンドラー\n   */\n  const handleApply = () => {\n    onChange?.(filter);\n  };\n\n  /**\n   * リセットボタンのハンドラー\n   */\n  const handleReset = () => {\n    reset();\n    if (!autoApply) {\n      onChange?.({});\n    }\n  };\n\n  return (\n    <div\n      data-testid={testId}\n      className={cn(\n        'w-full',\n        'grid gap-x-4 gap-y-2',\n        // Responsive grid: 1 column on small screens, 2 columns on sm+\n        'grid-cols-1 sm:grid-cols-2',\n        className,\n      )}\n    >\n      {fields.map((field) => (\n        <FieldFactory\n          key={field.field}\n          data-testid={testId ? `${testId}-${field.field}` : undefined}\n          label={field.label}\n          labelPosition={field.labelPosition || globalLabelPosition || 'responsive'}\n          labelWidth={field.labelWidth || globalLabelWidth}\n          overlappingLabel={\n            field.overlappingLabel !== undefined ? field.overlappingLabel : globalOverlappingLabel\n          }\n          showPlaceholderOnAll={\n            field.showPlaceholderOnAll !== undefined\n              ? field.showPlaceholderOnAll\n              : globalShowPlaceholderOnAll\n          }\n        >\n          <FilterInput\n            field={field}\n            value={values[field.field]}\n            onChange={(value) => setField(field.field, value)}\n            showPlaceholderOnAll={\n              field.showPlaceholderOnAll !== undefined\n                ? field.showPlaceholderOnAll\n                : globalShowPlaceholderOnAll\n            }\n            className={field.className || globalInputClassName}\n            locale={locale} // Pass locale down\n            debounceMs={field.debounceMs !== undefined ? field.debounceMs : debounceMs}\n          />\n        </FieldFactory>\n      ))}\n\n      {/* ボタン（autoApply=falseの場合のみ表示） */}\n      {!autoApply && (\n        <div className='flex items-end gap-2'>\n          <Button\n            testId={testId ? `${testId}-apply` : undefined}\n            onClick={handleApply}\n            variant='default'\n          >\n            {displayApplyLabel}\n          </Button>\n          <Button\n            testId={testId ? `${testId}-reset` : undefined}\n            onClick={handleReset}\n            variant='outline'\n            disabled={isEmpty}\n          >\n            {displayResetLabel}\n          </Button>\n        </div>\n      )}\n\n      {/* autoApply時のリセットボタン */}\n      {autoApply && !isEmpty && (\n        <div className='flex items-end'>\n          <Button\n            testId={testId ? `${testId}-reset` : undefined}\n            onClick={handleReset}\n            variant='ghost'\n            size='sm'\n          >\n            {displayResetLabel}\n          </Button>\n        </div>\n      )}\n    </div>\n  );\n}\nSchemaFilter.displayName = 'SchemaFilter';\n\n// =============================================================================\n// Exports\n// =============================================================================\n\nexport type { FilterProps, FilterResult };\n"],"mappings":"A,obA+DA,SAAgBa,EAAa,CAC3B,SACA,SACA,OAAQC,EACR,gBACA,WACA,YAAY,GACZ,aAAa,KACb,aACA,YACA,cAAeC,EACf,WAAYC,EACZ,iBAAkBC,EAClB,qBAAsBC,EACtB,eAAgBC,EAChB,SACA,cACc,CACd,GAAM,CAAE,SAAQ,SAAQ,SAAQ,WAAU,QAAO,WAAYnB,EAAAA,UAAU,CACrE,SACA,OAAQc,EACR,gBACA,SAAUM,EAAYC,EAAW,IAAA,GACjC,YACF,CAAC,EAEKC,EAAoBC,GAAAf,EAAA,aAA6B,EACjDgB,EAAoBC,GAAAhB,EAAA,aAA6B,EAKjDiB,MAAoB,CACxBL,IAAWM,CAAM,CACnB,EAKMC,MAAoB,CACxBC,EAAM,EACDT,GACHC,IAAW,CAAC,CAAC,CAEjB,EAEA,OACE,EAAAT,EAAA,KAAA,CAAC,MAAD,CACE,cAAakB,EACb,UAAW7B,EAAAA,GACT,SACA,uBAEA,6BACA8B,CACF,EARF,SAAA,CAUGC,EAAO,IAAK,IACX,EAAApB,EAAA,IAAA,CAACV,EAAAA,aAAD,CAEE,cAAa4B,EAAS,GAAGA,EAAO,GAAGG,EAAM,QAAU,IAAA,GACnD,MAAOA,EAAM,MACb,cAAeA,EAAM,eAAiBlB,GAAuB,aAC7D,WAAYkB,EAAM,YAAcjB,EAChC,iBACEiB,EAAM,mBAAqB,IAAA,GAAqChB,EAAzBgB,EAAM,iBAE/C,qBACEA,EAAM,uBAAyB,IAAA,GAE3Bf,EADAe,EAAM,qBAIZ,UAAA,EAAArB,EAAA,IAAA,CAACT,EAAAA,YAAD,CACS,QACP,MAAO+B,EAAOD,EAAM,OACpB,SAAW,GAAUE,EAASF,EAAM,MAAOG,CAAK,EAChD,qBACEH,EAAM,uBAAyB,IAAA,GAE3Bf,EADAe,EAAM,qBAGZ,UAAWA,EAAM,WAAad,EACtB,SACR,WAAYc,EAAM,aAAe,IAAA,GAA+BI,EAAnBJ,EAAM,UACpD,CAAA,CACW,EA3BPA,EAAM,KA2BC,CACf,EAGA,CAACb,IACA,EAAAR,EAAA,KAAA,CAAC,MAAD,CAAK,UAAU,uBAAf,SAAA,EACE,EAAAA,EAAA,IAAA,CAACR,EAAAA,OAAD,CACE,OAAQ0B,EAAS,GAAGA,EAAO,QAAU,IAAA,GACrC,QAASJ,EACT,QAAQ,UAEP,SAAAJ,CACK,CAAA,GACR,EAAAV,EAAA,IAAA,CAACR,EAAAA,OAAD,CACE,OAAQ0B,EAAS,GAAGA,EAAO,QAAU,IAAA,GACrC,QAASF,EACT,QAAQ,UACR,SAAUU,EAET,SAAAd,CACK,CAAA,CACL,C,GAINJ,GAAa,CAACkB,IACb,EAAA1B,EAAA,IAAA,CAAC,MAAD,CAAK,UAAU,iBACb,UAAA,EAAAA,EAAA,IAAA,CAACR,EAAAA,OAAD,CACE,OAAQ0B,EAAS,GAAGA,EAAO,QAAU,IAAA,GACrC,QAASF,EACT,QAAQ,QACR,KAAK,KAEJ,SAAAJ,CACK,CAAA,CACL,CAAA,CAEJ,C,EAET,CACA,EAAa,YAAc,e"}
+{"version":3,"file":"filter.cjs","names":["useFilter","cn","FieldFactory","FilterInput","Button","require_ui_lib_utils","require_ui_components_ui_button_components","require_tools_components_ui_field","require_filter_apply","require_filter_reset","require_tools_components_filter_use_filter","require_tools_components_filter_filter_inputs","react_jsx_runtime","SchemaFilter","fieldSpecs","globalLabelPosition","globalLabelWidth","globalOverlappingLabel","globalShowPlaceholderOnAll","globalInputClassName","autoApply","onChange","displayApplyLabel","applyLabel","displayResetLabel","resetLabel","handleApply","filter","handleReset","reset","testId","className","fields","field","values","setField","value","debounceMs","isEmpty"],"sources":["../../../../src/tools/components/filter/filter.tsx"],"sourcesContent":["/**\n * @fileoverview フィルターUIコンポーネント\n *\n * スキーマベースのフィルターUIを提供します。\n * useFilterフックと各種フィルター入力を組み合わせて、\n * 完全なフィルタリングUIを構築します。\n *\n * @module filter/filter\n */\n\n'use client';\n\nimport * as m from '../../paraglide/messages.js';\nimport { cn } from \"../../lib/utils\";\nimport { Button } from '../ui/button';\nimport { FilterInput } from './filter-inputs';\nimport { useFilter } from './use-filter';\nimport { FilterProps, FilterResult } from './filter-types';\nimport { FieldFactory } from '../ui/field';\n\n// =============================================================================\n// Filter Component\n// =============================================================================\n\n/**\n * Renders schema-derived filter inputs and emits a MongoDB-style filter object.\n * @param props - Field specifications, optional collection schema, labels and change callback; see {@link FilterProps}.\n * @returns A responsive filter grid with apply/reset buttons when autoApply is false.\n * @remarks Import Appkit CSS. This component creates local filter state; the host must apply the\n * emitted filter to its own data query. autoApply defaults to true; false defers onChange\n * until Apply or Reset. Reset emits an empty filter in manual mode. layout is currently ignored.\n * With testId, the root uses data-testid=testId and field wrappers use `${testId}-${field}`.\n * Manual apply/reset buttons use `${testId}-apply` and `${testId}-reset`; they are absent in auto mode.\n * @example\n * ```tsx\n * import { useState } from 'react';\n * import { SchemaFilter, type CollectionSchema, type FilterResult } from '@alneas/appkit-react/tools/filter';\n * import '@alneas/appkit-react/styles';\n *\n * const schema: CollectionSchema = {\n *   name: { type: 'string', label: 'Name' },\n *   status: { type: 'enum', enum: ['active', 'inactive'], label: 'Status' },\n * };\n * export function UserFilter() {\n *   const [filter, setFilter] = useState<FilterResult>({});\n *   return <><SchemaFilter testId=\"user-filter\" schema={schema} autoApply={false}\n *     fields={[{ field: 'name', className: 'min-w-[300px]' }, 'status']}\n *     inputClassName=\"min-w-[200px]\" onChange={setFilter} />\n *     <pre>{JSON.stringify(filter)}</pre></>;\n * }\n * ```\n */\nexport function SchemaFilter({\n  testId,\n  schema,\n  fields: fieldSpecs,\n  defaultValues,\n  onChange,\n  autoApply = true,\n  applyLabel = '適用',\n  resetLabel,\n  className,\n  labelPosition: globalLabelPosition,\n  labelWidth: globalLabelWidth,\n  overlappingLabel: globalOverlappingLabel,\n  showPlaceholderOnAll: globalShowPlaceholderOnAll,\n  inputClassName: globalInputClassName,\n  locale, // Add locale to destructured props\n  debounceMs,\n}: FilterProps) {\n  const { values, filter, fields, setField, reset, isEmpty } = useFilter({\n    schema,\n    fields: fieldSpecs,\n    defaultValues,\n    onChange: autoApply ? onChange : undefined,\n    debounceMs,\n  });\n\n  const displayApplyLabel = applyLabel || m.filter_apply();\n  const displayResetLabel = resetLabel || m.filter_reset();\n\n  /**\n   * 適用ボタンのハンドラー\n   */\n  const handleApply = () => {\n    onChange?.(filter);\n  };\n\n  /**\n   * リセットボタンのハンドラー\n   */\n  const handleReset = () => {\n    reset();\n    if (!autoApply) {\n      onChange?.({});\n    }\n  };\n\n  return (\n    <div\n      data-testid={testId}\n      className={cn(\n        'w-full',\n        'grid gap-x-4 gap-y-2',\n        // Responsive grid: 1 column on small screens, 2 columns on sm+\n        'grid-cols-1 sm:grid-cols-2',\n        className,\n      )}\n    >\n      {fields.map((field) => (\n        <FieldFactory\n          key={field.field}\n          data-testid={testId ? `${testId}-${field.field}` : undefined}\n          label={field.label}\n          labelPosition={field.labelPosition || globalLabelPosition || 'responsive'}\n          labelWidth={field.labelWidth || globalLabelWidth}\n          overlappingLabel={\n            field.overlappingLabel !== undefined ? field.overlappingLabel : globalOverlappingLabel\n          }\n          showPlaceholderOnAll={\n            field.showPlaceholderOnAll !== undefined\n              ? field.showPlaceholderOnAll\n              : globalShowPlaceholderOnAll\n          }\n        >\n          <FilterInput\n            field={field}\n            value={values[field.field]}\n            onChange={(value) => setField(field.field, value)}\n            showPlaceholderOnAll={\n              field.showPlaceholderOnAll !== undefined\n                ? field.showPlaceholderOnAll\n                : globalShowPlaceholderOnAll\n            }\n            className={field.className || globalInputClassName}\n            locale={locale} // Pass locale down\n            debounceMs={field.debounceMs !== undefined ? field.debounceMs : debounceMs}\n          />\n        </FieldFactory>\n      ))}\n\n      {/* ボタン（autoApply=falseの場合のみ表示） */}\n      {!autoApply && (\n        <div className='flex items-end gap-2'>\n          <Button\n            testId={testId ? `${testId}-apply` : undefined}\n            onClick={handleApply}\n            variant='default'\n          >\n            {displayApplyLabel}\n          </Button>\n          <Button\n            testId={testId ? `${testId}-reset` : undefined}\n            onClick={handleReset}\n            variant='outline'\n            disabled={isEmpty}\n          >\n            {displayResetLabel}\n          </Button>\n        </div>\n      )}\n\n      {/* autoApply時のリセットボタン */}\n      {autoApply && !isEmpty && (\n        <div className='flex items-end'>\n          <Button\n            testId={testId ? `${testId}-reset` : undefined}\n            onClick={handleReset}\n            variant='ghost'\n            size='sm'\n          >\n            {displayResetLabel}\n          </Button>\n        </div>\n      )}\n    </div>\n  );\n}\nSchemaFilter.displayName = 'SchemaFilter';\n\n// =============================================================================\n// Exports\n// =============================================================================\n\nexport type { FilterProps, FilterResult };\n"],"mappings":"A,obAoDA,SAAgBa,EAAa,CAC3B,SACA,SACA,OAAQC,EACR,gBACA,WACA,YAAY,GACZ,aAAa,KACb,aACA,YACA,cAAeC,EACf,WAAYC,EACZ,iBAAkBC,EAClB,qBAAsBC,EACtB,eAAgBC,EAChB,SACA,cACc,CACd,GAAM,CAAE,SAAQ,SAAQ,SAAQ,WAAU,QAAO,WAAYnB,EAAAA,UAAU,CACrE,SACA,OAAQc,EACR,gBACA,SAAUM,EAAYC,EAAW,IAAA,GACjC,YACF,CAAC,EAEKC,EAAoBC,GAAAf,EAAA,aAA6B,EACjDgB,EAAoBC,GAAAhB,EAAA,aAA6B,EAKjDiB,MAAoB,CACxBL,IAAWM,CAAM,CACnB,EAKMC,MAAoB,CACxBC,EAAM,EACDT,GACHC,IAAW,CAAC,CAAC,CAEjB,EAEA,OACE,EAAAT,EAAA,KAAA,CAAC,MAAD,CACE,cAAakB,EACb,UAAW7B,EAAAA,GACT,SACA,uBAEA,6BACA8B,CACF,EARF,SAAA,CAUGC,EAAO,IAAK,IACX,EAAApB,EAAA,IAAA,CAACV,EAAAA,aAAD,CAEE,cAAa4B,EAAS,GAAGA,EAAO,GAAGG,EAAM,QAAU,IAAA,GACnD,MAAOA,EAAM,MACb,cAAeA,EAAM,eAAiBlB,GAAuB,aAC7D,WAAYkB,EAAM,YAAcjB,EAChC,iBACEiB,EAAM,mBAAqB,IAAA,GAAqChB,EAAzBgB,EAAM,iBAE/C,qBACEA,EAAM,uBAAyB,IAAA,GAE3Bf,EADAe,EAAM,qBAIZ,UAAA,EAAArB,EAAA,IAAA,CAACT,EAAAA,YAAD,CACS,QACP,MAAO+B,EAAOD,EAAM,OACpB,SAAW,GAAUE,EAASF,EAAM,MAAOG,CAAK,EAChD,qBACEH,EAAM,uBAAyB,IAAA,GAE3Bf,EADAe,EAAM,qBAGZ,UAAWA,EAAM,WAAad,EACtB,SACR,WAAYc,EAAM,aAAe,IAAA,GAA+BI,EAAnBJ,EAAM,UACpD,CAAA,CACW,EA3BPA,EAAM,KA2BC,CACf,EAGA,CAACb,IACA,EAAAR,EAAA,KAAA,CAAC,MAAD,CAAK,UAAU,uBAAf,SAAA,EACE,EAAAA,EAAA,IAAA,CAACR,EAAAA,OAAD,CACE,OAAQ0B,EAAS,GAAGA,EAAO,QAAU,IAAA,GACrC,QAASJ,EACT,QAAQ,UAEP,SAAAJ,CACK,CAAA,GACR,EAAAV,EAAA,IAAA,CAACR,EAAAA,OAAD,CACE,OAAQ0B,EAAS,GAAGA,EAAO,QAAU,IAAA,GACrC,QAASF,EACT,QAAQ,UACR,SAAUU,EAET,SAAAd,CACK,CAAA,CACL,C,GAINJ,GAAa,CAACkB,IACb,EAAA1B,EAAA,IAAA,CAAC,MAAD,CAAK,UAAU,iBACb,UAAA,EAAAA,EAAA,IAAA,CAACR,EAAAA,OAAD,CACE,OAAQ0B,EAAS,GAAGA,EAAO,QAAU,IAAA,GACrC,QAASF,EACT,QAAQ,QACR,KAAK,KAEJ,SAAAJ,CACK,CAAA,CACL,CAAA,CAEJ,C,EAET,CACA,EAAa,YAAc,e"}

package/dist/tools/components/filter/filter.d.cts

@@ -1,41 +1,30 @@
 import { FilterProps, FilterResult } from './filter-types.cjs';
 /**
- * Filter Component
- * フィルターUIコンポーネント
- *
- * Schema-based filter UI with type inference.
- * スキーマからフィールド型を推論し、適切なフィルター入力を自動選択します。
- * MongoDBスタイルのフィルターオブジェクトを生成し、useFindと連携できます。
- *
- * ## AI/Automation Features
- * - `data-testid`: Container, apply/reset buttons
- * - Pattern: `{testId}`, `{testId}-apply`, `{testId}-reset`
- * - Filter inputs auto-generate testId from field name
- *
- * @example Basic usage with testId
+ * Renders schema-derived filter inputs and emits a MongoDB-style filter object.
+ * @param props - Field specifications, optional collection schema, labels and change callback; see {@link FilterProps}.
+ * @returns A responsive filter grid with apply/reset buttons when autoApply is false.
+ * @remarks Import Appkit CSS. This component creates local filter state; the host must apply the
+ * emitted filter to its own data query. autoApply defaults to true; false defers onChange
+ * until Apply or Reset. Reset emits an empty filter in manual mode. layout is currently ignored.
+ * With testId, the root uses data-testid=testId and field wrappers use `${testId}-${field}`.
+ * Manual apply/reset buttons use `${testId}-apply` and `${testId}-reset`; they are absent in auto mode.
+ * @example
  * ```tsx
- * <Filter
- *   testId="user-filter"
- *   schema={userSchema}
- *   fields={['name', 'age', 'status']}
- *   showPlaceholderOnAll={true}
- *   onChange={(filter) => setQueryFilter(filter)}
- * />
- * // Container: data-testid="user-filter"
- * // Apply button: data-testid="user-filter-apply"
- * // Reset button: data-testid="user-filter-reset"
- * // Filter inputs auto-generate testId from field name
+ * import { useState } from 'react';
+ * import { SchemaFilter, type CollectionSchema, type FilterResult } from '@alneas/appkit-react/tools/filter';
+ * import '@alneas/appkit-react/styles';
  *
- * @example Customizing filter widths
- * ```tsx
- * <Filter
- *   schema={userSchema}
- *   fields={[
- *     { field: 'name', className: 'min-w-[300px]' }, // Specific field
- *     'status'
- *   ]}
- *   inputClassName="min-w-[200px]" // Global default for this instance
- * />
+ * const schema: CollectionSchema = {
+ *   name: { type: 'string', label: 'Name' },
+ *   status: { type: 'enum', enum: ['active', 'inactive'], label: 'Status' },
+ * };
+ * export function UserFilter() {
+ *   const [filter, setFilter] = useState<FilterResult>({});
+ *   return <><SchemaFilter testId="user-filter" schema={schema} autoApply={false}
+ *     fields={[{ field: 'name', className: 'min-w-[300px]' }, 'status']}
+ *     inputClassName="min-w-[200px]" onChange={setFilter} />
+ *     <pre>{JSON.stringify(filter)}</pre></>;
+ * }
  * ```
  */
 export declare function SchemaFilter({ testId, schema, fields: fieldSpecs, defaultValues, onChange, autoApply, applyLabel, resetLabel, className, labelPosition: globalLabelPosition, labelWidth: globalLabelWidth, overlappingLabel: globalOverlappingLabel, showPlaceholderOnAll: globalShowPlaceholderOnAll, inputClassName: globalInputClassName, locale, // Add locale to destructured props

package/dist/tools/components/filter/filter.d.ts

@@ -1,41 +1,30 @@
 import { FilterProps, FilterResult } from './filter-types.js';
 /**
- * Filter Component
- * フィルターUIコンポーネント
- *
- * Schema-based filter UI with type inference.
- * スキーマからフィールド型を推論し、適切なフィルター入力を自動選択します。
- * MongoDBスタイルのフィルターオブジェクトを生成し、useFindと連携できます。
- *
- * ## AI/Automation Features
- * - `data-testid`: Container, apply/reset buttons
- * - Pattern: `{testId}`, `{testId}-apply`, `{testId}-reset`
- * - Filter inputs auto-generate testId from field name
- *
- * @example Basic usage with testId
+ * Renders schema-derived filter inputs and emits a MongoDB-style filter object.
+ * @param props - Field specifications, optional collection schema, labels and change callback; see {@link FilterProps}.
+ * @returns A responsive filter grid with apply/reset buttons when autoApply is false.
+ * @remarks Import Appkit CSS. This component creates local filter state; the host must apply the
+ * emitted filter to its own data query. autoApply defaults to true; false defers onChange
+ * until Apply or Reset. Reset emits an empty filter in manual mode. layout is currently ignored.
+ * With testId, the root uses data-testid=testId and field wrappers use `${testId}-${field}`.
+ * Manual apply/reset buttons use `${testId}-apply` and `${testId}-reset`; they are absent in auto mode.
+ * @example
  * ```tsx
- * <Filter
- *   testId="user-filter"
- *   schema={userSchema}
- *   fields={['name', 'age', 'status']}
- *   showPlaceholderOnAll={true}
- *   onChange={(filter) => setQueryFilter(filter)}
- * />
- * // Container: data-testid="user-filter"
- * // Apply button: data-testid="user-filter-apply"
- * // Reset button: data-testid="user-filter-reset"
- * // Filter inputs auto-generate testId from field name
+ * import { useState } from 'react';
+ * import { SchemaFilter, type CollectionSchema, type FilterResult } from '@alneas/appkit-react/tools/filter';
+ * import '@alneas/appkit-react/styles';
  *
- * @example Customizing filter widths
- * ```tsx
- * <Filter
- *   schema={userSchema}
- *   fields={[
- *     { field: 'name', className: 'min-w-[300px]' }, // Specific field
- *     'status'
- *   ]}
- *   inputClassName="min-w-[200px]" // Global default for this instance
- * />
+ * const schema: CollectionSchema = {
+ *   name: { type: 'string', label: 'Name' },
+ *   status: { type: 'enum', enum: ['active', 'inactive'], label: 'Status' },
+ * };
+ * export function UserFilter() {
+ *   const [filter, setFilter] = useState<FilterResult>({});
+ *   return <><SchemaFilter testId="user-filter" schema={schema} autoApply={false}
+ *     fields={[{ field: 'name', className: 'min-w-[300px]' }, 'status']}
+ *     inputClassName="min-w-[200px]" onChange={setFilter} />
+ *     <pre>{JSON.stringify(filter)}</pre></>;
+ * }
  * ```
  */
 export declare function SchemaFilter({ testId, schema, fields: fieldSpecs, defaultValues, onChange, autoApply, applyLabel, resetLabel, className, labelPosition: globalLabelPosition, labelWidth: globalLabelWidth, overlappingLabel: globalOverlappingLabel, showPlaceholderOnAll: globalShowPlaceholderOnAll, inputClassName: globalInputClassName, locale, // Add locale to destructured props

package/dist/tools/components/filter/filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","names":["m.filter_apply","m.filter_reset","SchemaFilter","fieldSpecs","globalLabelPosition","globalLabelWidth","globalOverlappingLabel","globalShowPlaceholderOnAll","globalInputClassName","useFilter","autoApply","onChange","displayApplyLabel","applyLabel","filter_apply","displayResetLabel","resetLabel","filter_reset","handleApply","filter","handleReset","reset","testId","cn","className","fields","FieldFactory","field","FilterInput","values","setField","value","debounceMs","Button","isEmpty"],"sources":["../../../../src/tools/components/filter/filter.tsx"],"sourcesContent":["/**\n * @fileoverview フィルターUIコンポーネント\n *\n * スキーマベースのフィルターUIを提供します。\n * useFilterフックと各種フィルター入力を組み合わせて、\n * 完全なフィルタリングUIを構築します。\n *\n * @module filter/filter\n */\n\n'use client';\n\nimport * as m from '../../paraglide/messages.js';\nimport { cn } from \"../../lib/utils\";\nimport { Button } from '../ui/button';\nimport { FilterInput } from './filter-inputs';\nimport { useFilter } from './use-filter';\nimport { FilterProps, FilterResult } from './filter-types';\nimport { FieldFactory } from '../ui/field';\n\n// =============================================================================\n// Filter Component\n// =============================================================================\n\n/**\n * Filter Component\n * フィルターUIコンポーネント\n *\n * Schema-based filter UI with type inference.\n * スキーマからフィールド型を推論し、適切なフィルター入力を自動選択します。\n * MongoDBスタイルのフィルターオブジェクトを生成し、useFindと連携できます。\n *\n * ## AI/Automation Features\n * - `data-testid`: Container, apply/reset buttons\n * - Pattern: `{testId}`, `{testId}-apply`, `{testId}-reset`\n * - Filter inputs auto-generate testId from field name\n *\n * @example Basic usage with testId\n * ```tsx\n * <Filter\n *   testId=\"user-filter\"\n *   schema={userSchema}\n *   fields={['name', 'age', 'status']}\n *   showPlaceholderOnAll={true}\n *   onChange={(filter) => setQueryFilter(filter)}\n * />\n * // Container: data-testid=\"user-filter\"\n * // Apply button: data-testid=\"user-filter-apply\"\n * // Reset button: data-testid=\"user-filter-reset\"\n * // Filter inputs auto-generate testId from field name\n *\n * @example Customizing filter widths\n * ```tsx\n * <Filter\n *   schema={userSchema}\n *   fields={[\n *     { field: 'name', className: 'min-w-[300px]' }, // Specific field\n *     'status'\n *   ]}\n *   inputClassName=\"min-w-[200px]\" // Global default for this instance\n * />\n * ```\n */\nexport function SchemaFilter({\n  testId,\n  schema,\n  fields: fieldSpecs,\n  defaultValues,\n  onChange,\n  autoApply = true,\n  applyLabel = '適用',\n  resetLabel,\n  className,\n  labelPosition: globalLabelPosition,\n  labelWidth: globalLabelWidth,\n  overlappingLabel: globalOverlappingLabel,\n  showPlaceholderOnAll: globalShowPlaceholderOnAll,\n  inputClassName: globalInputClassName,\n  locale, // Add locale to destructured props\n  debounceMs,\n}: FilterProps) {\n  const { values, filter, fields, setField, reset, isEmpty } = useFilter({\n    schema,\n    fields: fieldSpecs,\n    defaultValues,\n    onChange: autoApply ? onChange : undefined,\n    debounceMs,\n  });\n\n  const displayApplyLabel = applyLabel || m.filter_apply();\n  const displayResetLabel = resetLabel || m.filter_reset();\n\n  /**\n   * 適用ボタンのハンドラー\n   */\n  const handleApply = () => {\n    onChange?.(filter);\n  };\n\n  /**\n   * リセットボタンのハンドラー\n   */\n  const handleReset = () => {\n    reset();\n    if (!autoApply) {\n      onChange?.({});\n    }\n  };\n\n  return (\n    <div\n      data-testid={testId}\n      className={cn(\n        'w-full',\n        'grid gap-x-4 gap-y-2',\n        // Responsive grid: 1 column on small screens, 2 columns on sm+\n        'grid-cols-1 sm:grid-cols-2',\n        className,\n      )}\n    >\n      {fields.map((field) => (\n        <FieldFactory\n          key={field.field}\n          data-testid={testId ? `${testId}-${field.field}` : undefined}\n          label={field.label}\n          labelPosition={field.labelPosition || globalLabelPosition || 'responsive'}\n          labelWidth={field.labelWidth || globalLabelWidth}\n          overlappingLabel={\n            field.overlappingLabel !== undefined ? field.overlappingLabel : globalOverlappingLabel\n          }\n          showPlaceholderOnAll={\n            field.showPlaceholderOnAll !== undefined\n              ? field.showPlaceholderOnAll\n              : globalShowPlaceholderOnAll\n          }\n        >\n          <FilterInput\n            field={field}\n            value={values[field.field]}\n            onChange={(value) => setField(field.field, value)}\n            showPlaceholderOnAll={\n              field.showPlaceholderOnAll !== undefined\n                ? field.showPlaceholderOnAll\n                : globalShowPlaceholderOnAll\n            }\n            className={field.className || globalInputClassName}\n            locale={locale} // Pass locale down\n            debounceMs={field.debounceMs !== undefined ? field.debounceMs : debounceMs}\n          />\n        </FieldFactory>\n      ))}\n\n      {/* ボタン（autoApply=falseの場合のみ表示） */}\n      {!autoApply && (\n        <div className='flex items-end gap-2'>\n          <Button\n            testId={testId ? `${testId}-apply` : undefined}\n            onClick={handleApply}\n            variant='default'\n          >\n            {displayApplyLabel}\n          </Button>\n          <Button\n            testId={testId ? `${testId}-reset` : undefined}\n            onClick={handleReset}\n            variant='outline'\n            disabled={isEmpty}\n          >\n            {displayResetLabel}\n          </Button>\n        </div>\n      )}\n\n      {/* autoApply時のリセットボタン */}\n      {autoApply && !isEmpty && (\n        <div className='flex items-end'>\n          <Button\n            testId={testId ? `${testId}-reset` : undefined}\n            onClick={handleReset}\n            variant='ghost'\n            size='sm'\n          >\n            {displayResetLabel}\n          </Button>\n        </div>\n      )}\n    </div>\n  );\n}\nSchemaFilter.displayName = 'SchemaFilter';\n\n// =============================================================================\n// Exports\n// =============================================================================\n\nexport type { FilterProps, FilterResult };\n"],"mappings":";;;;;;;;;;;AA+DA,SAAgBE,EAAa,EAC3B,WACA,WACA,QAAQC,GACR,kBACA,aACA,eAAY,IACZ,gBAAa,MACb,eACA,cACA,eAAeC,GACf,YAAYC,GACZ,kBAAkBC,GAClB,sBAAsBC,GACtB,gBAAgBC,GAChB,WACA,iBACc;CACd,IAAM,EAAE,WAAQ,WAAQ,WAAQ,aAAU,UAAO,eAAYC,EAAU;EACrE;EACA,QAAQN;EACR;EACA,UAAUO,IAAYC,IAAW,KAAA;EACjC;CACF,CAAC,GAEKC,IAAoBC,KAAcb,EAAe,GACjDe,IAAoBC,KAAcf,EAAe,GAKjDiB,UAAoB;EACxB,IAAWC,CAAM;CACnB,GAKMC,UAAoB;EAExB,AADAC,EAAM,GACDX,KACHC,IAAW,CAAC,CAAC;CAEjB;CAEA,OACE,kBAAC,OAAD;EACE,eAAaW;EACb,WAAWC,EACT,UACA,wBAEA,8BACAC,CACF;EARF,UAAA;GAUGC,EAAO,KAAK,MACX,kBAACC,GAAD;IAEE,eAAaJ,IAAS,GAAGA,EAAO,GAAGK,EAAM,UAAU,KAAA;IACnD,OAAOA,EAAM;IACb,eAAeA,EAAM,iBAAiBvB,KAAuB;IAC7D,YAAYuB,EAAM,cAActB;IAChC,kBACEsB,EAAM,qBAAqB,KAAA,IAAqCrB,IAAzBqB,EAAM;IAE/C,sBACEA,EAAM,yBAAyB,KAAA,IAE3BpB,IADAoB,EAAM;IAIZ,UAAA,kBAACC,GAAD;KACS;KACP,OAAOC,EAAOF,EAAM;KACpB,WAAW,MAAUG,EAASH,EAAM,OAAOI,CAAK;KAChD,sBACEJ,EAAM,yBAAyB,KAAA,IAE3BpB,IADAoB,EAAM;KAGZ,WAAWA,EAAM,aAAanB;KACtB;KACR,YAAYmB,EAAM,eAAe,KAAA,IAA+BK,IAAnBL,EAAM;IACpD,CAAA;GACW,GA3BPA,EAAM,KA2BC,CACf;GAGA,CAACjB,KACA,kBAAC,OAAD;IAAK,WAAU;IAAf,UAAA,CACE,kBAACuB,GAAD;KACE,QAAQX,IAAS,GAAGA,EAAO,UAAU,KAAA;KACrC,SAASJ;KACT,SAAQ;KAEP,UAAAN;IACK,CAAA,GACR,kBAACqB,GAAD;KACE,QAAQX,IAAS,GAAGA,EAAO,UAAU,KAAA;KACrC,SAASF;KACT,SAAQ;KACR,UAAUc;KAET,UAAAnB;IACK,CAAA,CACL;;GAINL,KAAa,CAACwB,KACb,kBAAC,OAAD;IAAK,WAAU;IACb,UAAA,kBAACD,GAAD;KACE,QAAQX,IAAS,GAAGA,EAAO,UAAU,KAAA;KACrC,SAASF;KACT,SAAQ;KACR,MAAK;KAEJ,UAAAL;IACK,CAAA;GACL,CAAA;EAEJ;;AAET;AACA,EAAa,cAAc"}
+{"version":3,"file":"filter.js","names":["m.filter_apply","m.filter_reset","SchemaFilter","fieldSpecs","globalLabelPosition","globalLabelWidth","globalOverlappingLabel","globalShowPlaceholderOnAll","globalInputClassName","useFilter","autoApply","onChange","displayApplyLabel","applyLabel","filter_apply","displayResetLabel","resetLabel","filter_reset","handleApply","filter","handleReset","reset","testId","cn","className","fields","FieldFactory","field","FilterInput","values","setField","value","debounceMs","Button","isEmpty"],"sources":["../../../../src/tools/components/filter/filter.tsx"],"sourcesContent":["/**\n * @fileoverview フィルターUIコンポーネント\n *\n * スキーマベースのフィルターUIを提供します。\n * useFilterフックと各種フィルター入力を組み合わせて、\n * 完全なフィルタリングUIを構築します。\n *\n * @module filter/filter\n */\n\n'use client';\n\nimport * as m from '../../paraglide/messages.js';\nimport { cn } from \"../../lib/utils\";\nimport { Button } from '../ui/button';\nimport { FilterInput } from './filter-inputs';\nimport { useFilter } from './use-filter';\nimport { FilterProps, FilterResult } from './filter-types';\nimport { FieldFactory } from '../ui/field';\n\n// =============================================================================\n// Filter Component\n// =============================================================================\n\n/**\n * Renders schema-derived filter inputs and emits a MongoDB-style filter object.\n * @param props - Field specifications, optional collection schema, labels and change callback; see {@link FilterProps}.\n * @returns A responsive filter grid with apply/reset buttons when autoApply is false.\n * @remarks Import Appkit CSS. This component creates local filter state; the host must apply the\n * emitted filter to its own data query. autoApply defaults to true; false defers onChange\n * until Apply or Reset. Reset emits an empty filter in manual mode. layout is currently ignored.\n * With testId, the root uses data-testid=testId and field wrappers use `${testId}-${field}`.\n * Manual apply/reset buttons use `${testId}-apply` and `${testId}-reset`; they are absent in auto mode.\n * @example\n * ```tsx\n * import { useState } from 'react';\n * import { SchemaFilter, type CollectionSchema, type FilterResult } from '@alneas/appkit-react/tools/filter';\n * import '@alneas/appkit-react/styles';\n *\n * const schema: CollectionSchema = {\n *   name: { type: 'string', label: 'Name' },\n *   status: { type: 'enum', enum: ['active', 'inactive'], label: 'Status' },\n * };\n * export function UserFilter() {\n *   const [filter, setFilter] = useState<FilterResult>({});\n *   return <><SchemaFilter testId=\"user-filter\" schema={schema} autoApply={false}\n *     fields={[{ field: 'name', className: 'min-w-[300px]' }, 'status']}\n *     inputClassName=\"min-w-[200px]\" onChange={setFilter} />\n *     <pre>{JSON.stringify(filter)}</pre></>;\n * }\n * ```\n */\nexport function SchemaFilter({\n  testId,\n  schema,\n  fields: fieldSpecs,\n  defaultValues,\n  onChange,\n  autoApply = true,\n  applyLabel = '適用',\n  resetLabel,\n  className,\n  labelPosition: globalLabelPosition,\n  labelWidth: globalLabelWidth,\n  overlappingLabel: globalOverlappingLabel,\n  showPlaceholderOnAll: globalShowPlaceholderOnAll,\n  inputClassName: globalInputClassName,\n  locale, // Add locale to destructured props\n  debounceMs,\n}: FilterProps) {\n  const { values, filter, fields, setField, reset, isEmpty } = useFilter({\n    schema,\n    fields: fieldSpecs,\n    defaultValues,\n    onChange: autoApply ? onChange : undefined,\n    debounceMs,\n  });\n\n  const displayApplyLabel = applyLabel || m.filter_apply();\n  const displayResetLabel = resetLabel || m.filter_reset();\n\n  /**\n   * 適用ボタンのハンドラー\n   */\n  const handleApply = () => {\n    onChange?.(filter);\n  };\n\n  /**\n   * リセットボタンのハンドラー\n   */\n  const handleReset = () => {\n    reset();\n    if (!autoApply) {\n      onChange?.({});\n    }\n  };\n\n  return (\n    <div\n      data-testid={testId}\n      className={cn(\n        'w-full',\n        'grid gap-x-4 gap-y-2',\n        // Responsive grid: 1 column on small screens, 2 columns on sm+\n        'grid-cols-1 sm:grid-cols-2',\n        className,\n      )}\n    >\n      {fields.map((field) => (\n        <FieldFactory\n          key={field.field}\n          data-testid={testId ? `${testId}-${field.field}` : undefined}\n          label={field.label}\n          labelPosition={field.labelPosition || globalLabelPosition || 'responsive'}\n          labelWidth={field.labelWidth || globalLabelWidth}\n          overlappingLabel={\n            field.overlappingLabel !== undefined ? field.overlappingLabel : globalOverlappingLabel\n          }\n          showPlaceholderOnAll={\n            field.showPlaceholderOnAll !== undefined\n              ? field.showPlaceholderOnAll\n              : globalShowPlaceholderOnAll\n          }\n        >\n          <FilterInput\n            field={field}\n            value={values[field.field]}\n            onChange={(value) => setField(field.field, value)}\n            showPlaceholderOnAll={\n              field.showPlaceholderOnAll !== undefined\n                ? field.showPlaceholderOnAll\n                : globalShowPlaceholderOnAll\n            }\n            className={field.className || globalInputClassName}\n            locale={locale} // Pass locale down\n            debounceMs={field.debounceMs !== undefined ? field.debounceMs : debounceMs}\n          />\n        </FieldFactory>\n      ))}\n\n      {/* ボタン（autoApply=falseの場合のみ表示） */}\n      {!autoApply && (\n        <div className='flex items-end gap-2'>\n          <Button\n            testId={testId ? `${testId}-apply` : undefined}\n            onClick={handleApply}\n            variant='default'\n          >\n            {displayApplyLabel}\n          </Button>\n          <Button\n            testId={testId ? `${testId}-reset` : undefined}\n            onClick={handleReset}\n            variant='outline'\n            disabled={isEmpty}\n          >\n            {displayResetLabel}\n          </Button>\n        </div>\n      )}\n\n      {/* autoApply時のリセットボタン */}\n      {autoApply && !isEmpty && (\n        <div className='flex items-end'>\n          <Button\n            testId={testId ? `${testId}-reset` : undefined}\n            onClick={handleReset}\n            variant='ghost'\n            size='sm'\n          >\n            {displayResetLabel}\n          </Button>\n        </div>\n      )}\n    </div>\n  );\n}\nSchemaFilter.displayName = 'SchemaFilter';\n\n// =============================================================================\n// Exports\n// =============================================================================\n\nexport type { FilterProps, FilterResult };\n"],"mappings":";;;;;;;;;;;AAoDA,SAAgBE,EAAa,EAC3B,WACA,WACA,QAAQC,GACR,kBACA,aACA,eAAY,IACZ,gBAAa,MACb,eACA,cACA,eAAeC,GACf,YAAYC,GACZ,kBAAkBC,GAClB,sBAAsBC,GACtB,gBAAgBC,GAChB,WACA,iBACc;CACd,IAAM,EAAE,WAAQ,WAAQ,WAAQ,aAAU,UAAO,eAAYC,EAAU;EACrE;EACA,QAAQN;EACR;EACA,UAAUO,IAAYC,IAAW,KAAA;EACjC;CACF,CAAC,GAEKC,IAAoBC,KAAcb,EAAe,GACjDe,IAAoBC,KAAcf,EAAe,GAKjDiB,UAAoB;EACxB,IAAWC,CAAM;CACnB,GAKMC,UAAoB;EAExB,AADAC,EAAM,GACDX,KACHC,IAAW,CAAC,CAAC;CAEjB;CAEA,OACE,kBAAC,OAAD;EACE,eAAaW;EACb,WAAWC,EACT,UACA,wBAEA,8BACAC,CACF;EARF,UAAA;GAUGC,EAAO,KAAK,MACX,kBAACC,GAAD;IAEE,eAAaJ,IAAS,GAAGA,EAAO,GAAGK,EAAM,UAAU,KAAA;IACnD,OAAOA,EAAM;IACb,eAAeA,EAAM,iBAAiBvB,KAAuB;IAC7D,YAAYuB,EAAM,cAActB;IAChC,kBACEsB,EAAM,qBAAqB,KAAA,IAAqCrB,IAAzBqB,EAAM;IAE/C,sBACEA,EAAM,yBAAyB,KAAA,IAE3BpB,IADAoB,EAAM;IAIZ,UAAA,kBAACC,GAAD;KACS;KACP,OAAOC,EAAOF,EAAM;KACpB,WAAW,MAAUG,EAASH,EAAM,OAAOI,CAAK;KAChD,sBACEJ,EAAM,yBAAyB,KAAA,IAE3BpB,IADAoB,EAAM;KAGZ,WAAWA,EAAM,aAAanB;KACtB;KACR,YAAYmB,EAAM,eAAe,KAAA,IAA+BK,IAAnBL,EAAM;IACpD,CAAA;GACW,GA3BPA,EAAM,KA2BC,CACf;GAGA,CAACjB,KACA,kBAAC,OAAD;IAAK,WAAU;IAAf,UAAA,CACE,kBAACuB,GAAD;KACE,QAAQX,IAAS,GAAGA,EAAO,UAAU,KAAA;KACrC,SAASJ;KACT,SAAQ;KAEP,UAAAN;IACK,CAAA,GACR,kBAACqB,GAAD;KACE,QAAQX,IAAS,GAAGA,EAAO,UAAU,KAAA;KACrC,SAASF;KACT,SAAQ;KACR,UAAUc;KAET,UAAAnB;IACK,CAAA,CACL;;GAINL,KAAa,CAACwB,KACb,kBAAC,OAAD;IAAK,WAAU;IACb,UAAA,kBAACD,GAAD;KACE,QAAQX,IAAS,GAAGA,EAAO,UAAU,KAAA;KACrC,SAASF;KACT,SAAQ;KACR,MAAK;KAEJ,UAAAL;IACK,CAAA;GACL,CAAA;EAEJ;;AAET;AACA,EAAa,cAAc"}

package/dist/tools/components/filter/use-filter.cjs

@@ -1,2 +1,2 @@
-"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./filter-types.cjs");let t=require("react");function n(e,t){if(t==null||t===``)return;let{type:n,operator:r}=e;if(n===`boolean`)return t;if(n===`array`&&Array.isArray(t))return t.length===0?void 0:{$in:t};if(n===`string`&&typeof t==`string`){if(!t.trim())return;if(r===`contains`)return{$regex:t,$options:`i`};if(r===`startsWith`)return{$regex:`^${t}`,$options:`i`};if(r===`endsWith`)return{$regex:`${t}$`,$options:`i`}}if(r===`range`&&typeof t==`object`&&!Array.isArray(t)&&!(t instanceof Date)){let e=t,n={};return e.min!==void 0&&e.min!==null&&(n.$gte=e.min),e.max!==void 0&&e.max!==null&&(n.$lte=e.max),Object.keys(n).length>0?n:void 0}return t}function r(e){if(e==null||typeof e==`string`&&e.trim()===``||Array.isArray(e)&&e.length===0)return!0;if(typeof e==`object`&&!(e instanceof Date)){let t=e;return t.min===void 0&&t.max===void 0}return!1}function i(e,t){let n={};for(let r of e)n[r.field]=r.defaultValue??t?.[r.field]??void 0;return{...n,...t}}function a(a){let{schema:o,fields:s,defaultValues:c,onChange:l}=a,u=(0,t.useMemo)(()=>JSON.stringify(s),[s]),[d,f]=(0,t.useState)(s),[p,m]=(0,t.useState)(u);u!==p&&(f(s),m(u));let h=(0,t.useMemo)(()=>d.map(t=>e.resolveFilterField(t,o)),[d,o]),g=(0,t.useMemo)(()=>i(h,c),[h,c]),[_,v]=(0,t.useState)(g),y=(0,t.useRef)(c);(0,t.useEffect)(()=>{JSON.stringify(c)!==JSON.stringify(y.current)&&v(i(h,c)),y.current=c},[c,h]);let b=(0,t.useMemo)(()=>{let e={};for(let t of h){let r=_[t.field],i=n(t,r);i!==void 0&&(e[t.field]=i)}return e},[_,h]),x=JSON.stringify(b),S=(0,t.useMemo)(()=>JSON.parse(x),[x]),C=(0,t.useMemo)(()=>h.every(e=>r(_[e.field])),[_,h]),w=(0,t.useRef)(l);(0,t.useEffect)(()=>{w.current=l},[l]);let T=(0,t.useRef)({});return(0,t.useEffect)(()=>{JSON.stringify(S)!==JSON.stringify(T.current)&&(T.current=S,w.current?.(S))},[S]),{values:_,filter:S,fields:h,setField:(0,t.useCallback)((e,t)=>{v(n=>({...n,[e]:t}))},[]),setValues:(0,t.useCallback)(e=>{v(t=>({...t,...e}))},[]),reset:(0,t.useCallback)(()=>{v(g)},[g]),isEmpty:C}}function o(e,t,n){let r=t||Object.keys(e),i=new Set(n||[]);return r.filter(t=>!i.has(t)&&e[t]).map(e=>e)}exports.createFieldsFromSchema=o,exports.useFilter=a,exports.valueToQuery=n;
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./filter-types.cjs");let t=require("react");function n(e,t){if(t==null||t===``)return;let{type:n,operator:r}=e;if(n===`boolean`)return t;if(n===`array`&&Array.isArray(t))return t.length===0?void 0:{$in:t};if(n===`string`&&typeof t==`string`){if(!t.trim())return;if(r===`contains`)return{$regex:t,$options:`i`};if(r===`startsWith`)return{$regex:`^${t}`,$options:`i`};if(r===`endsWith`)return{$regex:`${t}$`,$options:`i`}}if(r===`range`&&typeof t==`object`&&!Array.isArray(t)&&!(t instanceof Date)){let e=t,n={};return e.min!==void 0&&e.min!==null&&(n.$gte=e.min),e.max!==void 0&&e.max!==null&&(n.$lte=e.max),Object.keys(n).length>0?n:void 0}return t}function r(e){if(e==null||typeof e==`string`&&e.trim()===``||Array.isArray(e)&&e.length===0)return!0;if(typeof e==`object`&&!(e instanceof Date)){let t=e;return t.min===void 0&&t.max===void 0}return!1}function i(e,t){let n={};for(let r of e)n[r.field]=r.defaultValue??t?.[r.field]??void 0;return{...n,...t}}function a(a){let{schema:o,fields:s,defaultValues:c,onChange:l}=a,u=(0,t.useMemo)(()=>JSON.stringify(s),[s]),[d,f]=(0,t.useState)(s),[p,m]=(0,t.useState)(u);u!==p&&(f(s),m(u));let h=(0,t.useMemo)(()=>d.map(t=>e.resolveFilterField(t,o)),[d,o]),g=(0,t.useMemo)(()=>i(h,c),[h,c]),[_,v]=(0,t.useState)(g),y=(0,t.useRef)(c);(0,t.useEffect)(()=>{JSON.stringify(c)!==JSON.stringify(y.current)&&v(i(h,c)),y.current=c},[c,h]);let b=(0,t.useMemo)(()=>{let e={};for(let t of h){let r=_[t.field],i=n(t,r);i!==void 0&&(e[t.field]=i)}return e},[_,h]),x=JSON.stringify(b),S=(0,t.useMemo)(()=>JSON.parse(x),[x]),C=(0,t.useMemo)(()=>h.every(e=>r(_[e.field])),[_,h]),w=(0,t.useEffectEvent)(e=>{l?.(e)}),T=(0,t.useRef)({});return(0,t.useEffect)(()=>{JSON.stringify(S)!==JSON.stringify(T.current)&&(T.current=S,w(S))},[S]),{values:_,filter:S,fields:h,setField:(0,t.useCallback)((e,t)=>{v(n=>({...n,[e]:t}))},[]),setValues:(0,t.useCallback)(e=>{v(t=>({...t,...e}))},[]),reset:(0,t.useCallback)(()=>{v(g)},[g]),isEmpty:C}}function o(e,t,n){let r=t||Object.keys(e),i=new Set(n||[]);return r.filter(t=>!i.has(t)&&e[t]).map(e=>e)}exports.createFieldsFromSchema=o,exports.useFilter=a,exports.valueToQuery=n;
 //# sourceMappingURL=use-filter.cjs.map

package/dist/tools/components/filter/use-filter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-filter.cjs","names":["useMemo","useState","resolveFilterField","useRef","useCallback","require_tools_components_filter_filter_types","react","valueToQuery","value","field","type","operator","range","query","isValueEmpty","buildDefaultValues","defaults","fields","userDefaults","useFilter","fieldSpecs","options","currentFieldSpecsStr","stabilizedFieldSpecs","setStabilizedFieldSpecs","prevFieldSpecsStr","setPrevFieldSpecsStr","resolvedFields","spec","schema","defaultValues","values","setValuesState","prevUserDefaultsRef","rawFilter","result","queryValue","filterJson","filter","isEmpty","onChangeRef","onChange","lastSentFilterRef","prev","newValues","createFieldsFromSchema","keys","include","excludeSet","exclude","key"],"sources":["../../../../src/tools/components/filter/use-filter.ts"],"sourcesContent":["/**\n * @fileoverview フィルター状態管理フック\n *\n * ヘッドレスなフィルター状態管理とMongoDBスタイルのクエリ生成を提供します。\n * UI無しでもクエリビルダーとして使用できます。\n *\n * @module filter/use-filter\n */\n\nimport { useState, useMemo, useCallback, useEffect, useRef } from 'react';\nimport {\n  CollectionSchema,\n  FilterResult,\n  FilterFieldSpec,\n  FilterValue,\n  FilterValues,\n  RangeValue,\n  ResolvedFilterField,\n  resolveFilterField,\n  UseFilterOptions,\n} from './filter-types';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * useFilterフックの戻り値\n * Return type for the useFilter hook\n */\nexport interface UseFilterReturn {\n  /** 現在のフィルター値 / Current filter values */\n  values: FilterValues;\n  /** MongoDBスタイルのフィルターオブジェクト / MongoDB-style filter object */\n  filter: FilterResult;\n  /** 解決済みフィールド定義 / Resolved field definitions */\n  fields: ResolvedFilterField[];\n  /** 単一フィールドの値を設定 / Set value for a single field */\n  setField: (field: string, value: FilterValue) => void;\n  /** 複数フィールドの値を設定 / Set multiple field values */\n  setValues: (values: Partial<FilterValues>) => void;\n  /** フィルターをリセット / Reset filter to defaults */\n  reset: () => void;\n  /** フィルターが空かどうか / Check if filter is empty */\n  isEmpty: boolean;\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * フィルター値をMongoDBスタイルのクエリに変換する\n * Converts a filter value to MongoDB-style query format\n *\n * @param {ResolvedFilterField} field - フィールド定義 / Field definition\n * @param {FilterValue} value - フィルター値 / Filter value\n * @returns {unknown} MongoDBクエリ値 / MongoDB query value\n */\nexport function valueToQuery(field: ResolvedFilterField, value: FilterValue): unknown {\n  if (value === null || value === undefined || value === '') {\n    return undefined;\n  }\n\n  const { type, operator } = field;\n\n  // Boolean: return as-is\n  if (type === 'boolean') {\n    return value;\n  }\n\n  // Array type (checkbox multi): use $in\n  if (type === 'array' && Array.isArray(value)) {\n    if (value.length === 0) return undefined;\n    return { $in: value };\n  }\n\n  // String operators: use $regex\n  if (type === 'string' && typeof value === 'string') {\n    if (!value.trim()) return undefined;\n\n    if (operator === 'contains') {\n      return { $regex: value, $options: 'i' };\n    }\n    if (operator === 'startsWith') {\n      return { $regex: `^${value}`, $options: 'i' };\n    }\n    if (operator === 'endsWith') {\n      return { $regex: `${value}$`, $options: 'i' };\n    }\n    // If 'eq', it falls through to the default exact match at the end\n  }\n\n  // Range operator for number/date\n  if (\n    operator === 'range' &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  ) {\n    const range = value as RangeValue<number | Date>;\n    const query: Record<string, unknown> = {};\n    if (range.min !== undefined && range.min !== null) {\n      query.$gte = range.min;\n    }\n    if (range.max !== undefined && range.max !== null) {\n      query.$lte = range.max;\n    }\n    return Object.keys(query).length > 0 ? query : undefined;\n  }\n\n  // Default: exact match\n  return value;\n}\n\n/**\n * フィルター値が空かどうかを判定する\n * Checks if a filter value is considered empty\n *\n * @param {FilterValue} value - フィルター値 / Filter value\n * @returns {boolean} 空の場合true / True if empty\n */\nfunction isValueEmpty(value: FilterValue): boolean {\n  if (value === null || value === undefined) return true;\n  if (typeof value === 'string' && value.trim() === '') return true;\n  if (Array.isArray(value) && value.length === 0) return true;\n  if (typeof value === 'object' && !(value instanceof Date)) {\n    const range = value as RangeValue<unknown>;\n    return range.min === undefined && range.max === undefined;\n  }\n  return false;\n}\n\n/**\n * デフォルト値マップを構築する\n * Builds the default values map from field definitions\n *\n * @param {ResolvedFilterField[]} fields - フィールド定義 / Field definitions\n * @param {FilterValues} [userDefaults] - ユーザー指定のデフォルト値 / User-provided defaults\n * @returns {FilterValues} デフォルト値マップ / Default values map\n */\nfunction buildDefaultValues(\n  fields: ResolvedFilterField[],\n  userDefaults?: FilterValues,\n): FilterValues {\n  const defaults: FilterValues = {};\n\n  for (const field of fields) {\n    defaults[field.field] = field.defaultValue ?? userDefaults?.[field.field] ?? undefined;\n  }\n\n  return { ...defaults, ...userDefaults };\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * フィルター状態管理フック\n * Headless hook for managing filter state and generating MongoDB queries\n *\n * スキーマから型を推論し、MongoDBスタイルのフィルターオブジェクトを生成します。\n * UI無しでクエリビルダーとして使用することもできます。\n *\n * @param {UseFilterOptions} options - フックオプション / Hook options\n * @returns {UseFilterReturn} フィルター状態とアクション / Filter state and actions\n *\n * @example\n * // Basic usage with schema\n * const { filter, values, setField, reset } = useFilter({\n *   schema: userSchema,\n *   fields: ['name', 'age', 'status'],\n * });\n *\n * // Use filter with useFind\n * const { data } = useFind('users', filter);\n *\n * @example\n * // With operator overrides\n * const { filter } = useFilter({\n *   schema: userSchema,\n *   fields: [\n *     'name',\n *     { field: 'age', operator: 'range' },\n *     { field: 'createdAt', operator: 'range' },\n *   ],\n * });\n *\n * @example\n * // Headless query builder (no UI)\n * const { filter, setField } = useFilter({\n *   fields: [\n *     { field: 'status', operator: 'eq' },\n *   ],\n * });\n * setField('status', 'active');\n * // filter = { status: 'active' }\n */\nexport function useFilter(options: UseFilterOptions): UseFilterReturn {\n  const { schema, fields: fieldSpecs, defaultValues: userDefaults, onChange } = options;\n\n  // Stabilize fieldSpecs to avoid unnecessary re-resolving\n  const currentFieldSpecsStr = useMemo(() => JSON.stringify(fieldSpecs), [fieldSpecs]);\n  const [stabilizedFieldSpecs, setStabilizedFieldSpecs] = useState(fieldSpecs);\n  const [prevFieldSpecsStr, setPrevFieldSpecsStr] = useState(currentFieldSpecsStr);\n\n  if (currentFieldSpecsStr !== prevFieldSpecsStr) {\n    setStabilizedFieldSpecs(fieldSpecs);\n    setPrevFieldSpecsStr(currentFieldSpecsStr);\n  }\n\n  // Resolve field specifications\n  const resolvedFields = useMemo(() => {\n    return stabilizedFieldSpecs.map((spec) => resolveFilterField(spec, schema));\n  }, [stabilizedFieldSpecs, schema]);\n\n  // Build default values\n  const defaultValues = useMemo(() => {\n    return buildDefaultValues(resolvedFields, userDefaults);\n  }, [resolvedFields, userDefaults]);\n\n  // Filter values state\n  const [values, setValuesState] = useState<FilterValues>(defaultValues);\n\n  // Sync state if userDefaults changes (from parent component)\n  const prevUserDefaultsRef = useRef(userDefaults);\n  useEffect(() => {\n    if (JSON.stringify(userDefaults) !== JSON.stringify(prevUserDefaultsRef.current)) {\n      setValuesState(buildDefaultValues(resolvedFields, userDefaults));\n    }\n    prevUserDefaultsRef.current = userDefaults;\n  }, [userDefaults, resolvedFields]);\n\n  // Generate MongoDB-style filter\n  const rawFilter = useMemo(() => {\n    const result: FilterResult = {};\n\n    for (const field of resolvedFields) {\n      const value = values[field.field];\n      const queryValue = valueToQuery(field, value);\n\n      if (queryValue !== undefined) {\n        result[field.field] = queryValue;\n      }\n    }\n\n    return result;\n  }, [values, resolvedFields]);\n\n  const filterJson = JSON.stringify(rawFilter);\n  const filter = useMemo(() => {\n    return JSON.parse(filterJson);\n  }, [filterJson]);\n\n  // Check if filter is empty\n  const isEmpty = useMemo(() => {\n    return resolvedFields.every((field) => isValueEmpty(values[field.field]));\n  }, [values, resolvedFields]);\n\n  // Keep a stable ref to onChange to avoid stale closures\n  const onChangeRef = useRef(onChange);\n  useEffect(() => {\n    onChangeRef.current = onChange;\n  }, [onChange]);\n\n  // Trigger onChange callback when filter changes, preventing loops with deep comparison ref\n  const lastSentFilterRef = useRef<FilterResult>({});\n  useEffect(() => {\n    if (JSON.stringify(filter) !== JSON.stringify(lastSentFilterRef.current)) {\n      lastSentFilterRef.current = filter;\n      onChangeRef.current?.(filter);\n    }\n  }, [filter]);\n\n  // Set single field value\n  const setField = useCallback((field: string, value: FilterValue) => {\n    setValuesState((prev) => ({\n      ...prev,\n      [field]: value,\n    }));\n  }, []);\n\n  // Set multiple field values\n  const setValues = useCallback((newValues: Partial<FilterValues>) => {\n    setValuesState((prev) => ({\n      ...prev,\n      ...newValues,\n    }));\n  }, []);\n\n  // Reset to default values\n  const reset = useCallback(() => {\n    setValuesState(defaultValues);\n  }, [defaultValues]);\n\n  return {\n    values,\n    filter,\n    fields: resolvedFields,\n    setField,\n    setValues,\n    reset,\n    isEmpty,\n  };\n}\n\n// =============================================================================\n// Utility Exports\n// =============================================================================\n\n/**\n * スキーマからフィルターフィールドを自動生成する\n * Auto-generates filter fields from a schema\n *\n * @param {CollectionSchema} schema - コレクションスキーマ / Collection schema\n * @param {string[]} [include] - 含めるフィールド / Fields to include (all if not specified)\n * @param {string[]} [exclude] - 除外するフィールド / Fields to exclude\n * @returns {FilterFieldSpec[]} フィルターフィールド配列 / Filter field specifications\n *\n * @example\n * const fields = createFieldsFromSchema(userSchema, ['name', 'age', 'status']);\n */\nexport function createFieldsFromSchema(\n  schema: CollectionSchema,\n  include?: string[],\n  exclude?: string[],\n): FilterFieldSpec[] {\n  const keys = include || Object.keys(schema);\n  const excludeSet = new Set(exclude || []);\n\n  return keys.filter((key) => !excludeSet.has(key) && schema[key]).map((key) => key);\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-filter.cjs","names":["useMemo","useState","resolveFilterField","useRef","useEffectEvent","useCallback","require_tools_components_filter_filter_types","react","valueToQuery","value","field","type","operator","range","query","isValueEmpty","buildDefaultValues","defaults","fields","userDefaults","useFilter","fieldSpecs","options","currentFieldSpecsStr","stabilizedFieldSpecs","setStabilizedFieldSpecs","prevFieldSpecsStr","setPrevFieldSpecsStr","resolvedFields","spec","schema","defaultValues","values","setValuesState","prevUserDefaultsRef","rawFilter","result","queryValue","filterJson","filter","isEmpty","onFilterChange","onChange","nextFilter","lastSentFilterRef","prev","newValues","createFieldsFromSchema","keys","include","excludeSet","exclude","key"],"sources":["../../../../src/tools/components/filter/use-filter.ts"],"sourcesContent":["/**\n * @fileoverview フィルター状態管理フック\n *\n * ヘッドレスなフィルター状態管理とMongoDBスタイルのクエリ生成を提供します。\n * UI無しでもクエリビルダーとして使用できます。\n *\n * @module filter/use-filter\n */\n\nimport { useState, useMemo, useCallback, useEffect, useEffectEvent, useRef } from 'react';\nimport {\n  CollectionSchema,\n  FilterResult,\n  FilterFieldSpec,\n  FilterValue,\n  FilterValues,\n  RangeValue,\n  ResolvedFilterField,\n  resolveFilterField,\n  UseFilterOptions,\n} from './filter-types';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * useFilterフックの戻り値\n * Return type for the useFilter hook\n */\nexport interface UseFilterReturn {\n  /** 現在のフィルター値 / Current filter values */\n  values: FilterValues;\n  /** MongoDBスタイルのフィルターオブジェクト / MongoDB-style filter object */\n  filter: FilterResult;\n  /** 解決済みフィールド定義 / Resolved field definitions */\n  fields: ResolvedFilterField[];\n  /** 単一フィールドの値を設定 / Set value for a single field */\n  setField: (field: string, value: FilterValue) => void;\n  /** 複数フィールドの値を設定 / Set multiple field values */\n  setValues: (values: Partial<FilterValues>) => void;\n  /** フィルターをリセット / Reset filter to defaults */\n  reset: () => void;\n  /** フィルターが空かどうか / Check if filter is empty */\n  isEmpty: boolean;\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * フィルター値をMongoDBスタイルのクエリに変換する\n * Converts a filter value to MongoDB-style query format\n *\n * @param {ResolvedFilterField} field - フィールド定義 / Field definition\n * @param {FilterValue} value - フィルター値 / Filter value\n * @returns {unknown} MongoDBクエリ値 / MongoDB query value\n */\nexport function valueToQuery(field: ResolvedFilterField, value: FilterValue): unknown {\n  if (value === null || value === undefined || value === '') {\n    return undefined;\n  }\n\n  const { type, operator } = field;\n\n  // Boolean: return as-is\n  if (type === 'boolean') {\n    return value;\n  }\n\n  // Array type (checkbox multi): use $in\n  if (type === 'array' && Array.isArray(value)) {\n    if (value.length === 0) return undefined;\n    return { $in: value };\n  }\n\n  // String operators: use $regex\n  if (type === 'string' && typeof value === 'string') {\n    if (!value.trim()) return undefined;\n\n    if (operator === 'contains') {\n      return { $regex: value, $options: 'i' };\n    }\n    if (operator === 'startsWith') {\n      return { $regex: `^${value}`, $options: 'i' };\n    }\n    if (operator === 'endsWith') {\n      return { $regex: `${value}$`, $options: 'i' };\n    }\n    // If 'eq', it falls through to the default exact match at the end\n  }\n\n  // Range operator for number/date\n  if (\n    operator === 'range' &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  ) {\n    const range = value as RangeValue<number | Date>;\n    const query: Record<string, unknown> = {};\n    if (range.min !== undefined && range.min !== null) {\n      query.$gte = range.min;\n    }\n    if (range.max !== undefined && range.max !== null) {\n      query.$lte = range.max;\n    }\n    return Object.keys(query).length > 0 ? query : undefined;\n  }\n\n  // Default: exact match\n  return value;\n}\n\n/**\n * フィルター値が空かどうかを判定する\n * Checks if a filter value is considered empty\n *\n * @param {FilterValue} value - フィルター値 / Filter value\n * @returns {boolean} 空の場合true / True if empty\n */\nfunction isValueEmpty(value: FilterValue): boolean {\n  if (value === null || value === undefined) return true;\n  if (typeof value === 'string' && value.trim() === '') return true;\n  if (Array.isArray(value) && value.length === 0) return true;\n  if (typeof value === 'object' && !(value instanceof Date)) {\n    const range = value as RangeValue<unknown>;\n    return range.min === undefined && range.max === undefined;\n  }\n  return false;\n}\n\n/**\n * デフォルト値マップを構築する\n * Builds the default values map from field definitions\n *\n * @param {ResolvedFilterField[]} fields - フィールド定義 / Field definitions\n * @param {FilterValues} [userDefaults] - ユーザー指定のデフォルト値 / User-provided defaults\n * @returns {FilterValues} デフォルト値マップ / Default values map\n */\nfunction buildDefaultValues(\n  fields: ResolvedFilterField[],\n  userDefaults?: FilterValues,\n): FilterValues {\n  const defaults: FilterValues = {};\n\n  for (const field of fields) {\n    defaults[field.field] = field.defaultValue ?? userDefaults?.[field.field] ?? undefined;\n  }\n\n  return { ...defaults, ...userDefaults };\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * フィルター状態管理フック\n * Headless hook for managing filter state and generating MongoDB queries\n *\n * スキーマから型を推論し、MongoDBスタイルのフィルターオブジェクトを生成します。\n * UI無しでクエリビルダーとして使用することもできます。\n *\n * @remarks Filter changes call the latest committed onChange callback. Replacing only\n * the callback does not replay an unchanged filter; deep-equal queries are deduplicated.\n *\n * @param {UseFilterOptions} options - フックオプション / Hook options\n * @returns {UseFilterReturn} フィルター状態とアクション / Filter state and actions\n *\n * @example\n * // Basic usage with schema\n * const { filter, values, setField, reset } = useFilter({\n *   schema: userSchema,\n *   fields: ['name', 'age', 'status'],\n * });\n *\n * // Use filter with useFind\n * const { data } = useFind('users', filter);\n *\n * @example\n * // With operator overrides\n * const { filter } = useFilter({\n *   schema: userSchema,\n *   fields: [\n *     'name',\n *     { field: 'age', operator: 'range' },\n *     { field: 'createdAt', operator: 'range' },\n *   ],\n * });\n *\n * @example\n * // Headless query builder (no UI)\n * const { filter, setField } = useFilter({\n *   fields: [\n *     { field: 'status', operator: 'eq' },\n *   ],\n * });\n * setField('status', 'active');\n * // filter = { status: 'active' }\n */\nexport function useFilter(options: UseFilterOptions): UseFilterReturn {\n  const { schema, fields: fieldSpecs, defaultValues: userDefaults, onChange } = options;\n\n  // Stabilize fieldSpecs to avoid unnecessary re-resolving\n  const currentFieldSpecsStr = useMemo(() => JSON.stringify(fieldSpecs), [fieldSpecs]);\n  const [stabilizedFieldSpecs, setStabilizedFieldSpecs] = useState(fieldSpecs);\n  const [prevFieldSpecsStr, setPrevFieldSpecsStr] = useState(currentFieldSpecsStr);\n\n  if (currentFieldSpecsStr !== prevFieldSpecsStr) {\n    setStabilizedFieldSpecs(fieldSpecs);\n    setPrevFieldSpecsStr(currentFieldSpecsStr);\n  }\n\n  // Resolve field specifications\n  const resolvedFields = useMemo(() => {\n    return stabilizedFieldSpecs.map((spec) => resolveFilterField(spec, schema));\n  }, [stabilizedFieldSpecs, schema]);\n\n  // Build default values\n  const defaultValues = useMemo(() => {\n    return buildDefaultValues(resolvedFields, userDefaults);\n  }, [resolvedFields, userDefaults]);\n\n  // Filter values state\n  const [values, setValuesState] = useState<FilterValues>(defaultValues);\n\n  // Sync state if userDefaults changes (from parent component)\n  const prevUserDefaultsRef = useRef(userDefaults);\n  useEffect(() => {\n    if (JSON.stringify(userDefaults) !== JSON.stringify(prevUserDefaultsRef.current)) {\n      setValuesState(buildDefaultValues(resolvedFields, userDefaults));\n    }\n    prevUserDefaultsRef.current = userDefaults;\n  }, [userDefaults, resolvedFields]);\n\n  // Generate MongoDB-style filter\n  const rawFilter = useMemo(() => {\n    const result: FilterResult = {};\n\n    for (const field of resolvedFields) {\n      const value = values[field.field];\n      const queryValue = valueToQuery(field, value);\n\n      if (queryValue !== undefined) {\n        result[field.field] = queryValue;\n      }\n    }\n\n    return result;\n  }, [values, resolvedFields]);\n\n  const filterJson = JSON.stringify(rawFilter);\n  const filter = useMemo(() => {\n    return JSON.parse(filterJson);\n  }, [filterJson]);\n\n  // Check if filter is empty\n  const isEmpty = useMemo(() => {\n    return resolvedFields.every((field) => isValueEmpty(values[field.field]));\n  }, [values, resolvedFields]);\n\n  const onFilterChange = useEffectEvent((nextFilter: FilterResult) => {\n    onChange?.(nextFilter);\n  });\n\n  // Trigger onChange callback when filter changes, preventing loops with deep comparison ref\n  const lastSentFilterRef = useRef<FilterResult>({});\n  useEffect(() => {\n    if (JSON.stringify(filter) !== JSON.stringify(lastSentFilterRef.current)) {\n      lastSentFilterRef.current = filter;\n      onFilterChange(filter);\n    }\n  }, [filter]);\n\n  // Set single field value\n  const setField = useCallback((field: string, value: FilterValue) => {\n    setValuesState((prev) => ({\n      ...prev,\n      [field]: value,\n    }));\n  }, []);\n\n  // Set multiple field values\n  const setValues = useCallback((newValues: Partial<FilterValues>) => {\n    setValuesState((prev) => ({\n      ...prev,\n      ...newValues,\n    }));\n  }, []);\n\n  // Reset to default values\n  const reset = useCallback(() => {\n    setValuesState(defaultValues);\n  }, [defaultValues]);\n\n  return {\n    values,\n    filter,\n    fields: resolvedFields,\n    setField,\n    setValues,\n    reset,\n    isEmpty,\n  };\n}\n\n// =============================================================================\n// Utility Exports\n// =============================================================================\n\n/**\n * スキーマからフィルターフィールドを自動生成する\n * Auto-generates filter fields from a schema\n *\n * @param {CollectionSchema} schema - コレクションスキーマ / Collection schema\n * @param {string[]} [include] - 含めるフィールド / Fields to include (all if not specified)\n * @param {string[]} [exclude] - 除外するフィールド / Fields to exclude\n * @returns {FilterFieldSpec[]} フィルターフィールド配列 / Filter field specifications\n *\n * @example\n * const fields = createFieldsFromSchema(userSchema, ['name', 'age', 'status']);\n */\nexport function createFieldsFromSchema(\n  schema: CollectionSchema,\n  include?: string[],\n  exclude?: string[],\n): FilterFieldSpec[] {\n  const keys = include || Object.keys(schema);\n  const excludeSet = new Set(exclude || []);\n\n  return keys.filter((key) => !excludeSet.has(key) && schema[key]).map((key) => key);\n}\n"],"mappings":"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"}

package/dist/tools/components/filter/use-filter.d.cts

@@ -35,6 +35,9 @@ export declare function valueToQuery(field: ResolvedFilterField, value: FilterVa
  * スキーマから型を推論し、MongoDBスタイルのフィルターオブジェクトを生成します。
  * UI無しでクエリビルダーとして使用することもできます。
  *
+ * @remarks Filter changes call the latest committed onChange callback. Replacing only
+ * the callback does not replay an unchanged filter; deep-equal queries are deduplicated.
+ *
  * @param {UseFilterOptions} options - フックオプション / Hook options
  * @returns {UseFilterReturn} フィルター状態とアクション / Filter state and actions
  *

package/dist/tools/components/filter/use-filter.d.ts

@@ -35,6 +35,9 @@ export declare function valueToQuery(field: ResolvedFilterField, value: FilterVa
  * スキーマから型を推論し、MongoDBスタイルのフィルターオブジェクトを生成します。
  * UI無しでクエリビルダーとして使用することもできます。
  *
+ * @remarks Filter changes call the latest committed onChange callback. Replacing only
+ * the callback does not replay an unchanged filter; deep-equal queries are deduplicated.
+ *
  * @param {UseFilterOptions} options - フックオプション / Hook options
  * @returns {UseFilterReturn} フィルター状態とアクション / Filter state and actions
  *

package/dist/tools/components/filter/use-filter.js

@@ -1,8 +1,8 @@
 "use client";
 import { resolveFilterField as e } from "./filter-types.js";
-import { useCallback as t, useEffect as n, useMemo as r, useRef as i, useState as a } from "react";
+import { useCallback as t, useEffect as n, useEffectEvent as r, useMemo as i, useRef as a, useState as o } from "react";
 //#region src/tools/components/filter/use-filter.ts
-function o(e, t) {
+function s(e, t) {
 	if (t == null || t === "") return;
 	let { type: n, operator: r } = e;
 	if (n === "boolean") return t;
@@ -28,7 +28,7 @@ function o(e, t) {
 	}
 	return t;
 }
-function s(e) {
+function c(e) {
 	if (e == null || typeof e == "string" && e.trim() === "" || Array.isArray(e) && e.length === 0) return !0;
 	if (typeof e == "object" && !(e instanceof Date)) {
 		let t = e;
@@ -36,7 +36,7 @@ function s(e) {
 	}
 	return !1;
 }
-function c(e, t) {
+function l(e, t) {
 	let n = {};
 	for (let r of e) n[r.field] = r.defaultValue ?? t?.[r.field] ?? void 0;
 	return {
@@ -44,54 +44,52 @@ function c(e, t) {
 		...t
 	};
 }
-function l(l) {
-	let { schema: u, fields: d, defaultValues: f, onChange: p } = l, m = r(() => JSON.stringify(d), [d]), [h, g] = a(d), [_, v] = a(m);
-	m !== _ && (g(d), v(m));
-	let y = r(() => h.map((t) => e(t, u)), [h, u]), b = r(() => c(y, f), [y, f]), [x, S] = a(b), C = i(f);
+function u(u) {
+	let { schema: d, fields: f, defaultValues: p, onChange: m } = u, h = i(() => JSON.stringify(f), [f]), [g, _] = o(f), [v, y] = o(h);
+	h !== v && (_(f), y(h));
+	let b = i(() => g.map((t) => e(t, d)), [g, d]), x = i(() => l(b, p), [b, p]), [S, C] = o(x), w = a(p);
 	n(() => {
-		JSON.stringify(f) !== JSON.stringify(C.current) && S(c(y, f)), C.current = f;
-	}, [f, y]);
-	let w = r(() => {
+		JSON.stringify(p) !== JSON.stringify(w.current) && C(l(b, p)), w.current = p;
+	}, [p, b]);
+	let T = i(() => {
 		let e = {};
-		for (let t of y) {
-			let n = x[t.field], r = o(t, n);
+		for (let t of b) {
+			let n = S[t.field], r = s(t, n);
 			r !== void 0 && (e[t.field] = r);
 		}
 		return e;
-	}, [x, y]), T = JSON.stringify(w), E = r(() => JSON.parse(T), [T]), D = r(() => y.every((e) => s(x[e.field])), [x, y]), O = i(p);
-	n(() => {
-		O.current = p;
-	}, [p]);
-	let k = i({});
+	}, [S, b]), E = JSON.stringify(T), D = i(() => JSON.parse(E), [E]), O = i(() => b.every((e) => c(S[e.field])), [S, b]), k = r((e) => {
+		m?.(e);
+	}), A = a({});
 	return n(() => {
-		JSON.stringify(E) !== JSON.stringify(k.current) && (k.current = E, O.current?.(E));
-	}, [E]), {
-		values: x,
-		filter: E,
-		fields: y,
+		JSON.stringify(D) !== JSON.stringify(A.current) && (A.current = D, k(D));
+	}, [D]), {
+		values: S,
+		filter: D,
+		fields: b,
 		setField: t((e, t) => {
-			S((n) => ({
+			C((n) => ({
 				...n,
 				[e]: t
 			}));
 		}, []),
 		setValues: t((e) => {
-			S((t) => ({
+			C((t) => ({
 				...t,
 				...e
 			}));
 		}, []),
 		reset: t(() => {
-			S(b);
-		}, [b]),
-		isEmpty: D
+			C(x);
+		}, [x]),
+		isEmpty: O
 	};
 }
-function u(e, t, n) {
+function d(e, t, n) {
 	let r = t || Object.keys(e), i = new Set(n || []);
 	return r.filter((t) => !i.has(t) && e[t]).map((e) => e);
 }
 //#endregion
-export { u as createFieldsFromSchema, l as useFilter, o as valueToQuery };
+export { d as createFieldsFromSchema, u as useFilter, s as valueToQuery };
 
 //# sourceMappingURL=use-filter.js.map

package/dist/tools/components/filter/use-filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-filter.js","names":["valueToQuery","value","field","type","operator","range","query","isValueEmpty","buildDefaultValues","defaults","fields","userDefaults","useFilter","fieldSpecs","options","currentFieldSpecsStr","useMemo","stabilizedFieldSpecs","setStabilizedFieldSpecs","useState","prevFieldSpecsStr","setPrevFieldSpecsStr","resolvedFields","resolveFilterField","spec","schema","defaultValues","values","setValuesState","prevUserDefaultsRef","useRef","rawFilter","result","queryValue","filterJson","filter","isEmpty","onChangeRef","onChange","lastSentFilterRef","useEffect","useCallback","prev","newValues","createFieldsFromSchema","keys","include","excludeSet","exclude","key"],"sources":["../../../../src/tools/components/filter/use-filter.ts"],"sourcesContent":["/**\n * @fileoverview フィルター状態管理フック\n *\n * ヘッドレスなフィルター状態管理とMongoDBスタイルのクエリ生成を提供します。\n * UI無しでもクエリビルダーとして使用できます。\n *\n * @module filter/use-filter\n */\n\nimport { useState, useMemo, useCallback, useEffect, useRef } from 'react';\nimport {\n  CollectionSchema,\n  FilterResult,\n  FilterFieldSpec,\n  FilterValue,\n  FilterValues,\n  RangeValue,\n  ResolvedFilterField,\n  resolveFilterField,\n  UseFilterOptions,\n} from './filter-types';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * useFilterフックの戻り値\n * Return type for the useFilter hook\n */\nexport interface UseFilterReturn {\n  /** 現在のフィルター値 / Current filter values */\n  values: FilterValues;\n  /** MongoDBスタイルのフィルターオブジェクト / MongoDB-style filter object */\n  filter: FilterResult;\n  /** 解決済みフィールド定義 / Resolved field definitions */\n  fields: ResolvedFilterField[];\n  /** 単一フィールドの値を設定 / Set value for a single field */\n  setField: (field: string, value: FilterValue) => void;\n  /** 複数フィールドの値を設定 / Set multiple field values */\n  setValues: (values: Partial<FilterValues>) => void;\n  /** フィルターをリセット / Reset filter to defaults */\n  reset: () => void;\n  /** フィルターが空かどうか / Check if filter is empty */\n  isEmpty: boolean;\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * フィルター値をMongoDBスタイルのクエリに変換する\n * Converts a filter value to MongoDB-style query format\n *\n * @param {ResolvedFilterField} field - フィールド定義 / Field definition\n * @param {FilterValue} value - フィルター値 / Filter value\n * @returns {unknown} MongoDBクエリ値 / MongoDB query value\n */\nexport function valueToQuery(field: ResolvedFilterField, value: FilterValue): unknown {\n  if (value === null || value === undefined || value === '') {\n    return undefined;\n  }\n\n  const { type, operator } = field;\n\n  // Boolean: return as-is\n  if (type === 'boolean') {\n    return value;\n  }\n\n  // Array type (checkbox multi): use $in\n  if (type === 'array' && Array.isArray(value)) {\n    if (value.length === 0) return undefined;\n    return { $in: value };\n  }\n\n  // String operators: use $regex\n  if (type === 'string' && typeof value === 'string') {\n    if (!value.trim()) return undefined;\n\n    if (operator === 'contains') {\n      return { $regex: value, $options: 'i' };\n    }\n    if (operator === 'startsWith') {\n      return { $regex: `^${value}`, $options: 'i' };\n    }\n    if (operator === 'endsWith') {\n      return { $regex: `${value}$`, $options: 'i' };\n    }\n    // If 'eq', it falls through to the default exact match at the end\n  }\n\n  // Range operator for number/date\n  if (\n    operator === 'range' &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  ) {\n    const range = value as RangeValue<number | Date>;\n    const query: Record<string, unknown> = {};\n    if (range.min !== undefined && range.min !== null) {\n      query.$gte = range.min;\n    }\n    if (range.max !== undefined && range.max !== null) {\n      query.$lte = range.max;\n    }\n    return Object.keys(query).length > 0 ? query : undefined;\n  }\n\n  // Default: exact match\n  return value;\n}\n\n/**\n * フィルター値が空かどうかを判定する\n * Checks if a filter value is considered empty\n *\n * @param {FilterValue} value - フィルター値 / Filter value\n * @returns {boolean} 空の場合true / True if empty\n */\nfunction isValueEmpty(value: FilterValue): boolean {\n  if (value === null || value === undefined) return true;\n  if (typeof value === 'string' && value.trim() === '') return true;\n  if (Array.isArray(value) && value.length === 0) return true;\n  if (typeof value === 'object' && !(value instanceof Date)) {\n    const range = value as RangeValue<unknown>;\n    return range.min === undefined && range.max === undefined;\n  }\n  return false;\n}\n\n/**\n * デフォルト値マップを構築する\n * Builds the default values map from field definitions\n *\n * @param {ResolvedFilterField[]} fields - フィールド定義 / Field definitions\n * @param {FilterValues} [userDefaults] - ユーザー指定のデフォルト値 / User-provided defaults\n * @returns {FilterValues} デフォルト値マップ / Default values map\n */\nfunction buildDefaultValues(\n  fields: ResolvedFilterField[],\n  userDefaults?: FilterValues,\n): FilterValues {\n  const defaults: FilterValues = {};\n\n  for (const field of fields) {\n    defaults[field.field] = field.defaultValue ?? userDefaults?.[field.field] ?? undefined;\n  }\n\n  return { ...defaults, ...userDefaults };\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * フィルター状態管理フック\n * Headless hook for managing filter state and generating MongoDB queries\n *\n * スキーマから型を推論し、MongoDBスタイルのフィルターオブジェクトを生成します。\n * UI無しでクエリビルダーとして使用することもできます。\n *\n * @param {UseFilterOptions} options - フックオプション / Hook options\n * @returns {UseFilterReturn} フィルター状態とアクション / Filter state and actions\n *\n * @example\n * // Basic usage with schema\n * const { filter, values, setField, reset } = useFilter({\n *   schema: userSchema,\n *   fields: ['name', 'age', 'status'],\n * });\n *\n * // Use filter with useFind\n * const { data } = useFind('users', filter);\n *\n * @example\n * // With operator overrides\n * const { filter } = useFilter({\n *   schema: userSchema,\n *   fields: [\n *     'name',\n *     { field: 'age', operator: 'range' },\n *     { field: 'createdAt', operator: 'range' },\n *   ],\n * });\n *\n * @example\n * // Headless query builder (no UI)\n * const { filter, setField } = useFilter({\n *   fields: [\n *     { field: 'status', operator: 'eq' },\n *   ],\n * });\n * setField('status', 'active');\n * // filter = { status: 'active' }\n */\nexport function useFilter(options: UseFilterOptions): UseFilterReturn {\n  const { schema, fields: fieldSpecs, defaultValues: userDefaults, onChange } = options;\n\n  // Stabilize fieldSpecs to avoid unnecessary re-resolving\n  const currentFieldSpecsStr = useMemo(() => JSON.stringify(fieldSpecs), [fieldSpecs]);\n  const [stabilizedFieldSpecs, setStabilizedFieldSpecs] = useState(fieldSpecs);\n  const [prevFieldSpecsStr, setPrevFieldSpecsStr] = useState(currentFieldSpecsStr);\n\n  if (currentFieldSpecsStr !== prevFieldSpecsStr) {\n    setStabilizedFieldSpecs(fieldSpecs);\n    setPrevFieldSpecsStr(currentFieldSpecsStr);\n  }\n\n  // Resolve field specifications\n  const resolvedFields = useMemo(() => {\n    return stabilizedFieldSpecs.map((spec) => resolveFilterField(spec, schema));\n  }, [stabilizedFieldSpecs, schema]);\n\n  // Build default values\n  const defaultValues = useMemo(() => {\n    return buildDefaultValues(resolvedFields, userDefaults);\n  }, [resolvedFields, userDefaults]);\n\n  // Filter values state\n  const [values, setValuesState] = useState<FilterValues>(defaultValues);\n\n  // Sync state if userDefaults changes (from parent component)\n  const prevUserDefaultsRef = useRef(userDefaults);\n  useEffect(() => {\n    if (JSON.stringify(userDefaults) !== JSON.stringify(prevUserDefaultsRef.current)) {\n      setValuesState(buildDefaultValues(resolvedFields, userDefaults));\n    }\n    prevUserDefaultsRef.current = userDefaults;\n  }, [userDefaults, resolvedFields]);\n\n  // Generate MongoDB-style filter\n  const rawFilter = useMemo(() => {\n    const result: FilterResult = {};\n\n    for (const field of resolvedFields) {\n      const value = values[field.field];\n      const queryValue = valueToQuery(field, value);\n\n      if (queryValue !== undefined) {\n        result[field.field] = queryValue;\n      }\n    }\n\n    return result;\n  }, [values, resolvedFields]);\n\n  const filterJson = JSON.stringify(rawFilter);\n  const filter = useMemo(() => {\n    return JSON.parse(filterJson);\n  }, [filterJson]);\n\n  // Check if filter is empty\n  const isEmpty = useMemo(() => {\n    return resolvedFields.every((field) => isValueEmpty(values[field.field]));\n  }, [values, resolvedFields]);\n\n  // Keep a stable ref to onChange to avoid stale closures\n  const onChangeRef = useRef(onChange);\n  useEffect(() => {\n    onChangeRef.current = onChange;\n  }, [onChange]);\n\n  // Trigger onChange callback when filter changes, preventing loops with deep comparison ref\n  const lastSentFilterRef = useRef<FilterResult>({});\n  useEffect(() => {\n    if (JSON.stringify(filter) !== JSON.stringify(lastSentFilterRef.current)) {\n      lastSentFilterRef.current = filter;\n      onChangeRef.current?.(filter);\n    }\n  }, [filter]);\n\n  // Set single field value\n  const setField = useCallback((field: string, value: FilterValue) => {\n    setValuesState((prev) => ({\n      ...prev,\n      [field]: value,\n    }));\n  }, []);\n\n  // Set multiple field values\n  const setValues = useCallback((newValues: Partial<FilterValues>) => {\n    setValuesState((prev) => ({\n      ...prev,\n      ...newValues,\n    }));\n  }, []);\n\n  // Reset to default values\n  const reset = useCallback(() => {\n    setValuesState(defaultValues);\n  }, [defaultValues]);\n\n  return {\n    values,\n    filter,\n    fields: resolvedFields,\n    setField,\n    setValues,\n    reset,\n    isEmpty,\n  };\n}\n\n// =============================================================================\n// Utility Exports\n// =============================================================================\n\n/**\n * スキーマからフィルターフィールドを自動生成する\n * Auto-generates filter fields from a schema\n *\n * @param {CollectionSchema} schema - コレクションスキーマ / Collection schema\n * @param {string[]} [include] - 含めるフィールド / Fields to include (all if not specified)\n * @param {string[]} [exclude] - 除外するフィールド / Fields to exclude\n * @returns {FilterFieldSpec[]} フィルターフィールド配列 / Filter field specifications\n *\n * @example\n * const fields = createFieldsFromSchema(userSchema, ['name', 'age', 'status']);\n */\nexport function createFieldsFromSchema(\n  schema: CollectionSchema,\n  include?: string[],\n  exclude?: string[],\n): FilterFieldSpec[] {\n  const keys = include || Object.keys(schema);\n  const excludeSet = new Set(exclude || []);\n\n  return keys.filter((key) => !excludeSet.has(key) && schema[key]).map((key) => key);\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-filter.js","names":["valueToQuery","value","field","type","operator","range","query","isValueEmpty","buildDefaultValues","defaults","fields","userDefaults","useFilter","fieldSpecs","options","currentFieldSpecsStr","useMemo","stabilizedFieldSpecs","setStabilizedFieldSpecs","useState","prevFieldSpecsStr","setPrevFieldSpecsStr","resolvedFields","resolveFilterField","spec","schema","defaultValues","values","setValuesState","prevUserDefaultsRef","useRef","rawFilter","result","queryValue","filterJson","filter","isEmpty","onFilterChange","useEffectEvent","nextFilter","lastSentFilterRef","useEffect","useCallback","prev","newValues","createFieldsFromSchema","keys","include","excludeSet","exclude","key"],"sources":["../../../../src/tools/components/filter/use-filter.ts"],"sourcesContent":["/**\n * @fileoverview フィルター状態管理フック\n *\n * ヘッドレスなフィルター状態管理とMongoDBスタイルのクエリ生成を提供します。\n * UI無しでもクエリビルダーとして使用できます。\n *\n * @module filter/use-filter\n */\n\nimport { useState, useMemo, useCallback, useEffect, useEffectEvent, useRef } from 'react';\nimport {\n  CollectionSchema,\n  FilterResult,\n  FilterFieldSpec,\n  FilterValue,\n  FilterValues,\n  RangeValue,\n  ResolvedFilterField,\n  resolveFilterField,\n  UseFilterOptions,\n} from './filter-types';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * useFilterフックの戻り値\n * Return type for the useFilter hook\n */\nexport interface UseFilterReturn {\n  /** 現在のフィルター値 / Current filter values */\n  values: FilterValues;\n  /** MongoDBスタイルのフィルターオブジェクト / MongoDB-style filter object */\n  filter: FilterResult;\n  /** 解決済みフィールド定義 / Resolved field definitions */\n  fields: ResolvedFilterField[];\n  /** 単一フィールドの値を設定 / Set value for a single field */\n  setField: (field: string, value: FilterValue) => void;\n  /** 複数フィールドの値を設定 / Set multiple field values */\n  setValues: (values: Partial<FilterValues>) => void;\n  /** フィルターをリセット / Reset filter to defaults */\n  reset: () => void;\n  /** フィルターが空かどうか / Check if filter is empty */\n  isEmpty: boolean;\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * フィルター値をMongoDBスタイルのクエリに変換する\n * Converts a filter value to MongoDB-style query format\n *\n * @param {ResolvedFilterField} field - フィールド定義 / Field definition\n * @param {FilterValue} value - フィルター値 / Filter value\n * @returns {unknown} MongoDBクエリ値 / MongoDB query value\n */\nexport function valueToQuery(field: ResolvedFilterField, value: FilterValue): unknown {\n  if (value === null || value === undefined || value === '') {\n    return undefined;\n  }\n\n  const { type, operator } = field;\n\n  // Boolean: return as-is\n  if (type === 'boolean') {\n    return value;\n  }\n\n  // Array type (checkbox multi): use $in\n  if (type === 'array' && Array.isArray(value)) {\n    if (value.length === 0) return undefined;\n    return { $in: value };\n  }\n\n  // String operators: use $regex\n  if (type === 'string' && typeof value === 'string') {\n    if (!value.trim()) return undefined;\n\n    if (operator === 'contains') {\n      return { $regex: value, $options: 'i' };\n    }\n    if (operator === 'startsWith') {\n      return { $regex: `^${value}`, $options: 'i' };\n    }\n    if (operator === 'endsWith') {\n      return { $regex: `${value}$`, $options: 'i' };\n    }\n    // If 'eq', it falls through to the default exact match at the end\n  }\n\n  // Range operator for number/date\n  if (\n    operator === 'range' &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  ) {\n    const range = value as RangeValue<number | Date>;\n    const query: Record<string, unknown> = {};\n    if (range.min !== undefined && range.min !== null) {\n      query.$gte = range.min;\n    }\n    if (range.max !== undefined && range.max !== null) {\n      query.$lte = range.max;\n    }\n    return Object.keys(query).length > 0 ? query : undefined;\n  }\n\n  // Default: exact match\n  return value;\n}\n\n/**\n * フィルター値が空かどうかを判定する\n * Checks if a filter value is considered empty\n *\n * @param {FilterValue} value - フィルター値 / Filter value\n * @returns {boolean} 空の場合true / True if empty\n */\nfunction isValueEmpty(value: FilterValue): boolean {\n  if (value === null || value === undefined) return true;\n  if (typeof value === 'string' && value.trim() === '') return true;\n  if (Array.isArray(value) && value.length === 0) return true;\n  if (typeof value === 'object' && !(value instanceof Date)) {\n    const range = value as RangeValue<unknown>;\n    return range.min === undefined && range.max === undefined;\n  }\n  return false;\n}\n\n/**\n * デフォルト値マップを構築する\n * Builds the default values map from field definitions\n *\n * @param {ResolvedFilterField[]} fields - フィールド定義 / Field definitions\n * @param {FilterValues} [userDefaults] - ユーザー指定のデフォルト値 / User-provided defaults\n * @returns {FilterValues} デフォルト値マップ / Default values map\n */\nfunction buildDefaultValues(\n  fields: ResolvedFilterField[],\n  userDefaults?: FilterValues,\n): FilterValues {\n  const defaults: FilterValues = {};\n\n  for (const field of fields) {\n    defaults[field.field] = field.defaultValue ?? userDefaults?.[field.field] ?? undefined;\n  }\n\n  return { ...defaults, ...userDefaults };\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * フィルター状態管理フック\n * Headless hook for managing filter state and generating MongoDB queries\n *\n * スキーマから型を推論し、MongoDBスタイルのフィルターオブジェクトを生成します。\n * UI無しでクエリビルダーとして使用することもできます。\n *\n * @remarks Filter changes call the latest committed onChange callback. Replacing only\n * the callback does not replay an unchanged filter; deep-equal queries are deduplicated.\n *\n * @param {UseFilterOptions} options - フックオプション / Hook options\n * @returns {UseFilterReturn} フィルター状態とアクション / Filter state and actions\n *\n * @example\n * // Basic usage with schema\n * const { filter, values, setField, reset } = useFilter({\n *   schema: userSchema,\n *   fields: ['name', 'age', 'status'],\n * });\n *\n * // Use filter with useFind\n * const { data } = useFind('users', filter);\n *\n * @example\n * // With operator overrides\n * const { filter } = useFilter({\n *   schema: userSchema,\n *   fields: [\n *     'name',\n *     { field: 'age', operator: 'range' },\n *     { field: 'createdAt', operator: 'range' },\n *   ],\n * });\n *\n * @example\n * // Headless query builder (no UI)\n * const { filter, setField } = useFilter({\n *   fields: [\n *     { field: 'status', operator: 'eq' },\n *   ],\n * });\n * setField('status', 'active');\n * // filter = { status: 'active' }\n */\nexport function useFilter(options: UseFilterOptions): UseFilterReturn {\n  const { schema, fields: fieldSpecs, defaultValues: userDefaults, onChange } = options;\n\n  // Stabilize fieldSpecs to avoid unnecessary re-resolving\n  const currentFieldSpecsStr = useMemo(() => JSON.stringify(fieldSpecs), [fieldSpecs]);\n  const [stabilizedFieldSpecs, setStabilizedFieldSpecs] = useState(fieldSpecs);\n  const [prevFieldSpecsStr, setPrevFieldSpecsStr] = useState(currentFieldSpecsStr);\n\n  if (currentFieldSpecsStr !== prevFieldSpecsStr) {\n    setStabilizedFieldSpecs(fieldSpecs);\n    setPrevFieldSpecsStr(currentFieldSpecsStr);\n  }\n\n  // Resolve field specifications\n  const resolvedFields = useMemo(() => {\n    return stabilizedFieldSpecs.map((spec) => resolveFilterField(spec, schema));\n  }, [stabilizedFieldSpecs, schema]);\n\n  // Build default values\n  const defaultValues = useMemo(() => {\n    return buildDefaultValues(resolvedFields, userDefaults);\n  }, [resolvedFields, userDefaults]);\n\n  // Filter values state\n  const [values, setValuesState] = useState<FilterValues>(defaultValues);\n\n  // Sync state if userDefaults changes (from parent component)\n  const prevUserDefaultsRef = useRef(userDefaults);\n  useEffect(() => {\n    if (JSON.stringify(userDefaults) !== JSON.stringify(prevUserDefaultsRef.current)) {\n      setValuesState(buildDefaultValues(resolvedFields, userDefaults));\n    }\n    prevUserDefaultsRef.current = userDefaults;\n  }, [userDefaults, resolvedFields]);\n\n  // Generate MongoDB-style filter\n  const rawFilter = useMemo(() => {\n    const result: FilterResult = {};\n\n    for (const field of resolvedFields) {\n      const value = values[field.field];\n      const queryValue = valueToQuery(field, value);\n\n      if (queryValue !== undefined) {\n        result[field.field] = queryValue;\n      }\n    }\n\n    return result;\n  }, [values, resolvedFields]);\n\n  const filterJson = JSON.stringify(rawFilter);\n  const filter = useMemo(() => {\n    return JSON.parse(filterJson);\n  }, [filterJson]);\n\n  // Check if filter is empty\n  const isEmpty = useMemo(() => {\n    return resolvedFields.every((field) => isValueEmpty(values[field.field]));\n  }, [values, resolvedFields]);\n\n  const onFilterChange = useEffectEvent((nextFilter: FilterResult) => {\n    onChange?.(nextFilter);\n  });\n\n  // Trigger onChange callback when filter changes, preventing loops with deep comparison ref\n  const lastSentFilterRef = useRef<FilterResult>({});\n  useEffect(() => {\n    if (JSON.stringify(filter) !== JSON.stringify(lastSentFilterRef.current)) {\n      lastSentFilterRef.current = filter;\n      onFilterChange(filter);\n    }\n  }, [filter]);\n\n  // Set single field value\n  const setField = useCallback((field: string, value: FilterValue) => {\n    setValuesState((prev) => ({\n      ...prev,\n      [field]: value,\n    }));\n  }, []);\n\n  // Set multiple field values\n  const setValues = useCallback((newValues: Partial<FilterValues>) => {\n    setValuesState((prev) => ({\n      ...prev,\n      ...newValues,\n    }));\n  }, []);\n\n  // Reset to default values\n  const reset = useCallback(() => {\n    setValuesState(defaultValues);\n  }, [defaultValues]);\n\n  return {\n    values,\n    filter,\n    fields: resolvedFields,\n    setField,\n    setValues,\n    reset,\n    isEmpty,\n  };\n}\n\n// =============================================================================\n// Utility Exports\n// =============================================================================\n\n/**\n * スキーマからフィルターフィールドを自動生成する\n * Auto-generates filter fields from a schema\n *\n * @param {CollectionSchema} schema - コレクションスキーマ / Collection schema\n * @param {string[]} [include] - 含めるフィールド / Fields to include (all if not specified)\n * @param {string[]} [exclude] - 除外するフィールド / Fields to exclude\n * @returns {FilterFieldSpec[]} フィルターフィールド配列 / Filter field specifications\n *\n * @example\n * const fields = createFieldsFromSchema(userSchema, ['name', 'age', 'status']);\n */\nexport function createFieldsFromSchema(\n  schema: CollectionSchema,\n  include?: string[],\n  exclude?: string[],\n): FilterFieldSpec[] {\n  const keys = include || Object.keys(schema);\n  const excludeSet = new Set(exclude || []);\n\n  return keys.filter((key) => !excludeSet.has(key) && schema[key]).map((key) => key);\n}\n"],"mappings":"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"}