@bariskuran/base 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Baris Kuran / bariskuran@gmail.com / thepxa.co.uk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,115 @@
-# Temporary Holding Version
+# @bariskuran/base
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## create ve Base yayınlaması için
+
+`yarn publish:all` tek bir sürüm sorar, Base ve create paketlerinin sürümlerini eşitler, ardından önce Base'i sonra create paketini yayımlar.
+
+Advanced hooks, functions, components for React projects.
+
+```js
+npm install @bariskuran/base
+```
+
+or
+
+```js
+yarn add @bariskuran/base
+```
+
+**Required dependencies:**
+• react >=17.0.0
+• react-dom >=17.0.0
+• react-router-dom >=6.0.0
+• styled-components >=6.0.0
+
+## Create a project
+
+```sh
+npm create @bariskuran/base
+```
+
+The initializer asks for project details, creates the workspace, and installs dependencies with Yarn. Start the project with `yarn start`.
+
+## Publishing
+
+Use `yarn publish:all` to publish both `@bariskuran/base` and `@bariskuran/create-base` with one shared version. The command also sets the Base dependency and `BASE_SPEC` in the generated project template to that version.
+
+## <Base>
+
+Base uygulamanı tek bir yerde toplayan bir app shelldir. Error Boundary, App Suspense, Styled-components, global context api, global styling, loading yönetimlerini barındırır.
+
+```js
+import { Base } from "@bariskuran/base";
+
+export default function App() {
+    return (
+        <Base>
+            <YourApp />
+        </Base>
+    );
+}
+```
+
+Çalışan akordiyon örneği:
+
+<details><summary><strong>Error Boundary:</strong> Async error wrapper. ErrorFallback verilmezse wrapper devreye girmez.</summary>
+
+| Prop            | Type        | Description            |
+| --------------- | ----------- | ---------------------- |
+| `ErrorFallback` | `ReactNode` | Error boundary wrapper |
+| `OTHER_`        | `ReactNode` | Suspense wrapper       |
+
+</details>
+
+1- Error Boundary: Async error wrapper. ErrorFallback verilmezse wrapper devreye girmez.
+
+```js
+import { Base } from "base";
+
+function AppError() {
+    return <div>Something went wrong.</div>;
+}
+
+export default function App() {
+    return (
+        <Base ErrorFallback={<AppError />}>
+            <YourApp />
+        </Base>
+    );
+}
+
+ErrorFallback - ReactNode - Optional;
+OTHER_ERROR_BOUNDARY_PROPS - Object - Optional;
+```
+
+```js
+<Base
+    /** A React Suspense wrapper. Async. Optional */
+    SuspenseFallback={<SuspenceFallback />}
+    /** Error boundary wrapper. Async. Optional */
+    ErrorFallback={<ErrorFallback />}
+    /** Mandatory if you want to use styled-components.
+    {
+        background: "#17181c",
+        foreground: "#E0E0E0",
+        grey: "#3A3A3A",
+        ...
+    }
+    To access theme, 
+
+    const Styled = styled.div`
+        ${({ theme }) => css`
+            color: ${theme.background};
+            ...
+     * */
+    STYLED_COMPONENTS_THEME={THEME}
+    /* Styling için kullanılan maximum aspect ratio. Default value is 1/2 */
+    MAX_ASP_RATIO
+    /* Styling için kullanılan minimum aspect ratio. Default value is 3/1 */
+    MIN_ASP_RATIO
+    /* Styling sisteminin responsive sistemi için kullandığı viewport ayarları. Optional. */
+    SYSTEM_BREAKPOINTS
+>
+    {yourApp}
+</Base>
+```

package/package.json

@@ -1,6 +1,95 @@
 {
   "name": "@bariskuran/base",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "private": false,
+  "license": "MIT",
+  "description": "Advanced hooks, functions, components for React projects.",
+  "keywords": [
+    "react",
+    "hooks",
+    "components",
+    "functions",
+    "pxa",
+    "base",
+    "bariskuran",
+    "store",
+    "baseStore",
+    "date",
+    "time",
+    "baseDate",
+    "icons",
+    "baseIcons",
+    "form",
+    "baseForm",
+    "fetch",
+    "baseFetch",
+    "table",
+    "helpers"
+  ],
+  "author": "Baris Kuran <baris@thepxa.co.uk> (thepxa.co.uk)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bariskuran/base.git"
+  },
+  "main": "src/index.js",
+  "module": "src/index.js",
+  "files": [
+    "src",
+    "vite.aliases.mjs"
+  ],
+  "bin": {
+    "base-image-catalog-setup": "src/libs/createImageCatalog/tools/base-image-catalog-setup.cjs",
+    "base-image-index": "src/libs/createImageCatalog/tools/base-image-index.cjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "require": "./src/index.js"
+    },
+    "./vite": "./vite.aliases.mjs",
+    "./design-system": {
+      "import": "./src/design-system.js",
+      "require": "./src/design-system.js"
+    }
+  },
+  "scripts": {
+    "build": "node builder.cjs",
+    "publish-base": "node scripts/publish-base.cjs",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:ui": "vitest --ui"
+  },
+  "dependencies": {
+    "lottie-web": "5.13.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "2.0.1",
+    "@eslint/eslintrc": "3.3.0",
+    "@eslint/js": "9.39.2",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@vitejs/plugin-react": "5.1.2",
+    "eslint": "9.39.2",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-react": "7.37.5",
+    "eslint-plugin-react-hooks": "7.0.1",
+    "globals": "17.0.0",
+    "jsdom": "^27.4.0",
+    "prettier": "3.8.1",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-router-dom": "7.12.0",
+    "react-syntax-highlighter": "16.1.0",
+    "styled-components": "^6.3.8",
+    "vite": "7.3.1",
+    "vite-plugin-eslint": "1.8.1",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0",
+    "react-router-dom": ">=6.0.0",
+    "styled-components": ">=6.0.0"
+  }
+}

package/src/.prettierrc.cjs

@@ -0,0 +1 @@
+module.exports = require("../.prettierrc.cjs");

package/src/.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "chrome",
+            "request": "launch",
+            "name": "Launch Chrome against localhost",
+            "url": "http://localhost:3000",
+            "webRoot": "${workspaceFolder}"
+        }
+    ]
+}

package/src/.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+
+    "[javascript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode",
+        "editor.formatOnSave": true
+    },
+    "[javascriptreact]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode",
+        "editor.formatOnSave": true
+    }
+}

package/src/constants/API_RESPONSE_CODES.js

@@ -0,0 +1,300 @@
+export const API_RESPONSE_CODES = {
+    0: {
+        tr: {
+            title: "İnternet bağlantısı yok.",
+            description: "Ağ bağlantınızı kontrol edin ve tekrar deneyin.",
+        },
+        en: {
+            title: "No internet connection.",
+            description: "Check your network connection and try again.",
+        },
+        fr: {
+            title: "Pas de connexion internet.",
+            description: "Vérifiez votre connexion réseau et réessayez.",
+        },
+        de: {
+            title: "Keine Internetverbindung.",
+            description: "Überprüfen Sie Ihre Netzwerkverbindung und versuchen Sie es erneut.",
+        },
+        es: {
+            title: "Sin conexión a Internet.",
+            description: "Comprueba tu conexión de red y vuelve a intentarlo.",
+        },
+    },
+
+    200: {
+        tr: {
+            title: "İşlem başarılı.",
+            description: "Talep edilen işlem sorunsuz şekilde tamamlandı.",
+        },
+        en: {
+            title: "Success.",
+            description: "The requested operation completed successfully.",
+        },
+        fr: {
+            title: "Succès.",
+            description: "L’opération demandée s’est terminée avec succès.",
+        },
+        de: {
+            title: "Erfolgreich.",
+            description: "Der angeforderte Vorgang wurde erfolgreich abgeschlossen.",
+        },
+        es: {
+            title: "Éxito.",
+            description: "La operación solicitada se completó correctamente.",
+        },
+    },
+
+    201: {
+        tr: {
+            title: "Kaynak oluşturuldu.",
+            description: "Yeni içerik başarıyla oluşturuldu.",
+        },
+        en: {
+            title: "Resource created.",
+            description: "The new resource was created successfully.",
+        },
+        fr: {
+            title: "Ressource créée.",
+            description: "La nouvelle ressource a été créée avec succès.",
+        },
+        de: {
+            title: "Ressource erstellt.",
+            description: "Die neue Ressource wurde erfolgreich erstellt.",
+        },
+        es: {
+            title: "Recurso creado.",
+            description: "El nuevo recurso se creó correctamente.",
+        },
+    },
+
+    204: {
+        tr: {
+            title: "İşlem tamamlandı.",
+            description: "İşlem başarılı ancak gösterilecek bir içerik yok.",
+        },
+        en: {
+            title: "No content.",
+            description: "The operation succeeded but there is no content to display.",
+        },
+        fr: {
+            title: "Aucun contenu.",
+            description: "L’opération a réussi mais aucun contenu n’est disponible.",
+        },
+        de: {
+            title: "Kein Inhalt.",
+            description: "Der Vorgang war erfolgreich, es gibt jedoch keinen Inhalt.",
+        },
+        es: {
+            title: "Sin contenido.",
+            description: "La operación fue exitosa pero no hay contenido para mostrar.",
+        },
+    },
+
+    301: {
+        tr: {
+            title: "Kaynak taşındı.",
+            description: "Bu içerik kalıcı olarak başka bir adrese taşındı.",
+        },
+        en: {
+            title: "Resource moved permanently.",
+            description: "This content has been permanently moved to another location.",
+        },
+        fr: {
+            title: "Ressource déplacée.",
+            description: "Ce contenu a été déplacé définitivement.",
+        },
+        de: {
+            title: "Ressource verschoben.",
+            description: "Diese Ressource wurde dauerhaft verschoben.",
+        },
+        es: {
+            title: "Recurso movido.",
+            description: "Este contenido se ha movido de forma permanente.",
+        },
+    },
+
+    302: {
+        tr: {
+            title: "Geçici yönlendirme.",
+            description: "Bu içerik geçici olarak başka bir adresten sunuluyor.",
+        },
+        en: {
+            title: "Temporary redirect.",
+            description: "This content is temporarily served from another location.",
+        },
+        fr: {
+            title: "Redirection temporaire.",
+            description: "Ce contenu est temporairement accessible ailleurs.",
+        },
+        de: {
+            title: "Temporäre Weiterleitung.",
+            description: "Dieser Inhalt wird vorübergehend von einem anderen Ort bereitgestellt.",
+        },
+        es: {
+            title: "Redirección temporal.",
+            description: "Este contenido se muestra temporalmente desde otra ubicación.",
+        },
+    },
+
+    400: {
+        tr: {
+            title: "Geçersiz istek.",
+            description: "Gönderilen veriler hatalı veya eksik olabilir.",
+        },
+        en: {
+            title: "Bad request.",
+            description: "The request data may be invalid or incomplete.",
+        },
+        fr: {
+            title: "Requête incorrecte.",
+            description: "Les données envoyées peuvent être invalides ou incomplètes.",
+        },
+        de: {
+            title: "Ungültige Anfrage.",
+            description: "Die gesendeten Daten sind möglicherweise ungültig oder unvollständig.",
+        },
+        es: {
+            title: "Solicitud incorrecta.",
+            description: "Los datos enviados pueden ser inválidos o incompletos.",
+        },
+    },
+
+    401: {
+        tr: {
+            title: "Giriş gerekli.",
+            description: "Bu işlemi yapmak için oturum açmanız gerekiyor.",
+        },
+        en: {
+            title: "Authentication required.",
+            description: "You need to be logged in to perform this action.",
+        },
+        fr: {
+            title: "Authentification requise.",
+            description: "Vous devez être connecté pour effectuer cette action.",
+        },
+        de: {
+            title: "Anmeldung erforderlich.",
+            description: "Sie müssen angemeldet sein, um diese Aktion auszuführen.",
+        },
+        es: {
+            title: "Autenticación requerida.",
+            description: "Debes iniciar sesión para realizar esta acción.",
+        },
+    },
+
+    403: {
+        tr: {
+            title: "Erişim reddedildi.",
+            description: "Bu içeriğe erişim yetkiniz bulunmuyor.",
+        },
+        en: {
+            title: "Access denied.",
+            description: "You do not have permission to access this content.",
+        },
+        fr: {
+            title: "Accès refusé.",
+            description: "Vous n’avez pas l’autorisation d’accéder à ce contenu.",
+        },
+        de: {
+            title: "Zugriff verweigert.",
+            description: "Sie haben keine Berechtigung für diesen Zugriff.",
+        },
+        es: {
+            title: "Acceso denegado.",
+            description: "No tienes permiso para acceder a este contenido.",
+        },
+    },
+
+    404: {
+        tr: {
+            title: "Sayfa bulunamadı.",
+            description: "Adres yanlış olabilir veya içerik kaldırılmış olabilir.",
+        },
+        en: {
+            title: "Page not found.",
+            description: "The page may have been removed or the URL is incorrect.",
+        },
+        fr: {
+            title: "Page introuvable.",
+            description: "La page a peut-être été supprimée ou l’URL est incorrecte.",
+        },
+        de: {
+            title: "Seite nicht gefunden.",
+            description: "Die Seite wurde möglicherweise entfernt oder die URL ist falsch.",
+        },
+        es: {
+            title: "Página no encontrada.",
+            description: "La página puede haber sido eliminada o la URL es incorrecta.",
+        },
+    },
+
+    429: {
+        tr: {
+            title: "Çok fazla istek.",
+            description: "Lütfen biraz bekleyip tekrar deneyin.",
+        },
+        en: {
+            title: "Too many requests.",
+            description: "Please wait a moment and try again.",
+        },
+        fr: {
+            title: "Trop de requêtes.",
+            description: "Veuillez patienter un moment avant de réessayer.",
+        },
+        de: {
+            title: "Zu viele Anfragen.",
+            description: "Bitte warten Sie kurz und versuchen Sie es erneut.",
+        },
+        es: {
+            title: "Demasiadas solicitudes.",
+            description: "Espera un momento y vuelve a intentarlo.",
+        },
+    },
+
+    500: {
+        tr: {
+            title: "Sunucu hatası.",
+            description: "Beklenmeyen bir hata oluştu, daha sonra tekrar deneyin.",
+        },
+        en: {
+            title: "Server error.",
+            description: "An unexpected error occurred, please try again later.",
+        },
+        fr: {
+            title: "Erreur serveur.",
+            description: "Une erreur inattendue s’est produite, veuillez réessayer plus tard.",
+        },
+        de: {
+            title: "Serverfehler.",
+            description: "Ein unerwarteter Fehler ist aufgetreten, bitte später erneut versuchen.",
+        },
+        es: {
+            title: "Error del servidor.",
+            description: "Ocurrió un error inesperado, inténtalo de nuevo más tarde.",
+        },
+    },
+
+    unknown: {
+        tr: {
+            title: "Bilinmeyen hata.",
+            description: "Beklenmeyen bir durum oluştu.",
+        },
+        en: {
+            title: "Unknown error.",
+            description: "An unexpected situation occurred.",
+        },
+        fr: {
+            title: "Erreur inconnue.",
+            description: "Une situation inattendue s’est produite.",
+        },
+        de: {
+            title: "Unbekannter Fehler.",
+            description: "Eine unerwartete Situation ist aufgetreten.",
+        },
+        es: {
+            title: "Error desconocido.",
+            description: "Ocurrió una situación inesperada.",
+        },
+    },
+};