@mertcankocak/core-project 1.0.0 → 1.3.0

package/README.md

@@ -5,21 +5,102 @@ React TypeScript component library built with Vite.
 ## Installation
 
 ```bash
-npm install core-project
+npm install @mertcankocak/core-project
+```
+
+## Peer Dependencies
+
+Bu paket aşağıdaki paketleri peer dependency olarak gerektirir:
+
+```bash
+npm install react react-dom yup
 ```
 
 ## Usage
 
-```tsx
-import { YourComponent } from 'core-project'
+### Yup Validators
+
+#### T.C. Kimlik Numarası
+
+Zorunluluk dışarıdan belirlenir. `required` belirtilmezse optional olur (varsayılan).
+
+```typescript
+import * as yup from 'yup'
+import { tcKimlikNoSchema } from '@mertcankocak/core-project'
+
+// Optional (varsayılan)
+const optionalSchema = yup.object({
+  tcKimlikNo: tcKimlikNoSchema()
+})
+
+// Required
+const requiredSchema = yup.object({
+  tcKimlikNo: tcKimlikNoSchema({ required: true })
+})
+
+// Özel mesajlarla
+const customSchema = yup.object({
+  tcKimlikNo: tcKimlikNoSchema({
+    required: true,
+    message: 'Geçersiz T.C. kimlik numarası',
+    requiredMessage: 'T.C. kimlik numarası boş bırakılamaz'
+  })
+})
+```
+
+#### Regex ve Manuel Validasyon
 
-function App() {
-  return (
-    <YourComponent />
-  )
+```typescript
+import { 
+  TC_KIMLIK_NO_REGEX, 
+  validateTCKimlikNo 
+} from '@mertcankocak/core-project'
+
+// Regex kontrolü
+const isValid = TC_KIMLIK_NO_REGEX.test('12345678901')
+
+// Algoritma kontrolü
+const isValid = validateTCKimlikNo('12345678901')
+```
+
+## Kullanım Örnekleri
+
+Detaylı kullanım örnekleri için [USAGE_EXAMPLES.md](./USAGE_EXAMPLES.md) dosyasına bakın.
+
+### React Hook Form ile
+
+```typescript
+import { useForm } from 'react-hook-form'
+import { yupResolver } from '@hookform/resolvers/yup'
+import * as yup from 'yup'
+import { tcKimlikNoSchema } from '@mertcankocak/core-project'
+
+const schema = yup.object({
+  name: yup.string().required(),
+  tcKimlikNo: tcKimlikNoSchema(), // Optional (varsayılan)
+})
+
+function MyForm() {
+  const { register, handleSubmit } = useForm({
+    resolver: yupResolver(schema),
+  })
+  
+  // ...
 }
 ```
 
+### Formik ile
+
+```typescript
+import { Formik } from 'formik'
+import * as yup from 'yup'
+import { tcKimlikNoSchema } from '@mertcankocak/core-project'
+
+const schema = yup.object({
+  tcKimlikNo: tcKimlikNoSchema({ required: true }), // Required
+})
+```
+
 ## Development
 
 ```bash

package/dist/components/FormikTextField/FormikTextField.d.ts

@@ -0,0 +1,46 @@
+import { default as React } from 'react';
+import { TextFieldProps as MuiTextFieldProps, SxProps, Theme } from '@mui/material';
+
+export interface FormikTextFieldProps extends Omit<MuiTextFieldProps, "name" | "value" | "onChange" | "onBlur" | "sx"> {
+    name: string;
+    label?: string;
+    type?: string;
+    placeholder?: string;
+    className?: string;
+    fieldToSearch?: string;
+    onSuggestionSearch?: (fieldName: string, searchTerm: string) => Promise<string[]>;
+    disabled?: boolean;
+    step?: string | number;
+    min?: string | number;
+    max?: string | number;
+    startAdornment?: React.ReactNode;
+    endAdornment?: React.ReactNode;
+    disableUppercase?: boolean;
+    required?: boolean;
+    fullWidth?: boolean;
+    debounceDelay?: number;
+    minSearchLength?: number;
+    helperText?: string;
+    autoFocus?: boolean;
+    multiline?: boolean;
+    rows?: number;
+    maxLength?: number;
+    errorMessageFormatter?: (error: string) => string;
+    "aria-label"?: string;
+    "aria-describedby"?: string;
+    /**
+     * MUI sx prop - TextField için özelleştirme
+     * @example sx={{ backgroundColor: 'red', '& .MuiInputBase-root': { borderRadius: 2 } }}
+     */
+    sx?: SxProps<Theme>;
+    /**
+     * InputProps içindeki sx - Input root elementi için özelleştirme
+     */
+    inputSx?: SxProps<Theme>;
+    /**
+     * InputProps içindeki input sx - Input elementi için özelleştirme
+     */
+    inputElementSx?: SxProps<Theme>;
+}
+export declare const FormikTextField: React.FC<FormikTextFieldProps>;
+//# sourceMappingURL=FormikTextField.d.ts.map

package/dist/components/FormikTextField/FormikTextField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormikTextField.d.ts","sourceRoot":"","sources":["../../../src/components/FormikTextField/FormikTextField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAC;AAEf,OAAO,EAKL,cAAc,IAAI,iBAAiB,EACnC,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAKvB,MAAM,WAAW,oBACf,SAAQ,IAAI,CACV,iBAAiB,EACjB,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,CAChD;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,CACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA4O1D,CAAC"}

package/dist/components/FormikTextField/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * FormikTextField constants
+ */
+export declare const DEFAULT_DEBOUNCE_DELAY = 300;
+export declare const DEFAULT_MIN_SEARCH_LENGTH = 1;
+/**
+ * Input types that should not be converted to uppercase
+ */
+export declare const NON_UPPERCASE_TYPES: readonly ["password", "email", "number", "tel", "url"];
+/**
+ * Allowed keyboard keys for number input
+ */
+export declare const ALLOWED_NUMBER_KEYS: readonly ["Backspace", "Delete", "ArrowLeft", "ArrowRight", "Tab", "Enter", "Escape"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/components/FormikTextField/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/components/FormikTextField/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,mBAAmB,wDAMtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB,uFAQtB,CAAC"}

package/dist/components/FormikTextField/helpers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Değeri büyük harfe çevirir (gerekirse)
+ */
+export declare function transformValue(value: string, type: string, disableUppercase: boolean): string;
+/**
+ * Number input için geçerli tuş kontrolü
+ */
+export declare function isValidNumberKey(key: string): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/components/FormikTextField/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/components/FormikTextField/helpers.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,OAAO,GACxB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/components/FormikTextField/index.d.ts

@@ -0,0 +1,5 @@
+export { FormikTextField } from './FormikTextField';
+export type { FormikTextFieldProps } from './FormikTextField';
+export { transformValue, isValidNumberKey } from './helpers';
+export { DEFAULT_DEBOUNCE_DELAY, DEFAULT_MIN_SEARCH_LENGTH, NON_UPPERCASE_TYPES, ALLOWED_NUMBER_KEYS, } from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/FormikTextField/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/FormikTextField/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/components/index.d.ts

@@ -0,0 +1,3 @@
+export { FormikTextField } from './FormikTextField';
+export type { FormikTextFieldProps } from './FormikTextField';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}