@beeblock/svelar 0.4.0

package/package.json

@@ -0,0 +1,338 @@
+{
+  "name": "@beeblock/svelar",
+  "version": "0.4.0",
+  "description": "Laravel-inspired framework on top of SvelteKit 2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "svelar": "./dist/cli/bin.js"
+  },
+  "files": [
+    "dist",
+    "src/ui",
+    "src/i18n",
+    "LICENSE",
+    "README.md"
+  ],
+  "svelte": "./src/ui/index.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./orm": {
+      "types": "./dist/orm/index.d.ts",
+      "import": "./dist/orm/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js"
+    },
+    "./container": {
+      "types": "./dist/container/index.d.ts",
+      "import": "./dist/container/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "import": "./dist/middleware/index.js"
+    },
+    "./routing": {
+      "types": "./dist/routing/index.d.ts",
+      "import": "./dist/routing/index.js"
+    },
+    "./database": {
+      "types": "./dist/database/index.d.ts",
+      "import": "./dist/database/index.js"
+    },
+    "./validation": {
+      "types": "./dist/validation/index.d.ts",
+      "import": "./dist/validation/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js"
+    },
+    "./hashing": {
+      "types": "./dist/hashing/index.d.ts",
+      "import": "./dist/hashing/index.js"
+    },
+    "./session": {
+      "types": "./dist/session/index.d.ts",
+      "import": "./dist/session/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js"
+    },
+    "./pagination": {
+      "types": "./dist/pagination/index.d.ts",
+      "import": "./dist/pagination/index.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "import": "./dist/events/index.js"
+    },
+    "./logging": {
+      "types": "./dist/logging/index.d.ts",
+      "import": "./dist/logging/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.js"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.ts",
+      "import": "./dist/cache/index.js"
+    },
+    "./queue": {
+      "types": "./dist/queue/index.d.ts",
+      "import": "./dist/queue/index.js"
+    },
+    "./mail": {
+      "types": "./dist/mail/index.d.ts",
+      "import": "./dist/mail/index.js"
+    },
+    "./notifications": {
+      "types": "./dist/notifications/index.d.ts",
+      "import": "./dist/notifications/index.js"
+    },
+    "./broadcasting": {
+      "types": "./dist/broadcasting/index.d.ts",
+      "import": "./dist/broadcasting/index.js"
+    },
+    "./broadcasting/client": {
+      "types": "./dist/broadcasting/client.d.ts",
+      "import": "./dist/broadcasting/client.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    },
+    "./services": {
+      "types": "./dist/services/index.d.ts",
+      "import": "./dist/services/index.js"
+    },
+    "./actions": {
+      "types": "./dist/actions/index.d.ts",
+      "import": "./dist/actions/index.js"
+    },
+    "./repositories": {
+      "types": "./dist/repositories/index.d.ts",
+      "import": "./dist/repositories/index.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "import": "./dist/plugins/index.js"
+    },
+    "./plugins/PluginRegistry": {
+      "types": "./dist/plugins/PluginRegistry.d.ts",
+      "import": "./dist/plugins/PluginRegistry.js"
+    },
+    "./plugins/PluginPublisher": {
+      "types": "./dist/plugins/PluginPublisher.d.ts",
+      "import": "./dist/plugins/PluginPublisher.js"
+    },
+    "./plugins/PluginInstaller": {
+      "types": "./dist/plugins/PluginInstaller.d.ts",
+      "import": "./dist/plugins/PluginInstaller.js"
+    },
+    "./scheduler": {
+      "types": "./dist/scheduler/index.d.ts",
+      "import": "./dist/scheduler/index.js"
+    },
+    "./permissions": {
+      "types": "./dist/permissions/index.d.ts",
+      "import": "./dist/permissions/index.js"
+    },
+    "./support": {
+      "types": "./dist/support/index.d.ts",
+      "import": "./dist/support/index.js"
+    },
+    "./dates": {
+      "types": "./dist/support/date.d.ts",
+      "import": "./dist/support/date.js"
+    },
+    "./ui": {
+      "types": "./src/ui/index.ts",
+      "svelte": "./src/ui/index.ts",
+      "import": "./src/ui/index.ts"
+    },
+    "./ui/*": {
+      "svelte": "./src/ui/*"
+    },
+    "./http": {
+      "types": "./dist/http/index.d.ts",
+      "import": "./dist/http/index.js"
+    },
+    "./i18n": {
+      "types": "./dist/i18n/index.d.ts",
+      "svelte": "./src/i18n/index.ts",
+      "import": "./dist/i18n/index.js"
+    },
+    "./i18n/LanguageSwitcher.svelte": {
+      "svelte": "./src/i18n/LanguageSwitcher.svelte"
+    },
+    "./forms": {
+      "types": "./dist/forms/index.d.ts",
+      "import": "./dist/forms/index.js"
+    },
+    "./pdf": {
+      "types": "./dist/pdf/index.d.ts",
+      "import": "./dist/pdf/index.js"
+    },
+    "./pdf/GeneratePdfJob": {
+      "types": "./dist/pdf/GeneratePdfJob.d.ts",
+      "import": "./dist/pdf/GeneratePdfJob.js"
+    },
+    "./dashboard": {
+      "types": "./dist/dashboard/index.d.ts",
+      "import": "./dist/dashboard/index.js"
+    },
+    "./queue/JobMonitor": {
+      "types": "./dist/queue/JobMonitor.d.ts",
+      "import": "./dist/queue/JobMonitor.js"
+    },
+    "./scheduler/ScheduleMonitor": {
+      "types": "./dist/scheduler/ScheduleMonitor.d.ts",
+      "import": "./dist/scheduler/ScheduleMonitor.js"
+    },
+    "./logging/LogViewer": {
+      "types": "./dist/logging/LogViewer.d.ts",
+      "import": "./dist/logging/LogViewer.js"
+    },
+    "./audit": {
+      "types": "./dist/audit/index.d.ts",
+      "import": "./dist/audit/index.js"
+    },
+    "./api-keys": {
+      "types": "./dist/api-keys/index.d.ts",
+      "import": "./dist/api-keys/index.js"
+    },
+    "./webhooks": {
+      "types": "./dist/webhooks/index.d.ts",
+      "import": "./dist/webhooks/index.js"
+    },
+    "./teams": {
+      "types": "./dist/teams/index.d.ts",
+      "import": "./dist/teams/index.js"
+    },
+    "./email-templates": {
+      "types": "./dist/email-templates/index.d.ts",
+      "import": "./dist/email-templates/index.js"
+    },
+    "./uploads": {
+      "types": "./dist/uploads/index.d.ts",
+      "import": "./dist/uploads/index.js"
+    },
+    "./feature-flags": {
+      "types": "./dist/feature-flags/index.d.ts",
+      "import": "./dist/feature-flags/index.js"
+    },
+    "./excel": {
+      "types": "./dist/excel/index.d.ts",
+      "import": "./dist/excel/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup && (tsc --emitDeclarationOnly || echo 'Warning: tsc declaration emit had errors') && npm run copy-cli-scripts",
+    "copy-cli-scripts": "node -e \"const fs=require('fs');['ts-resolver.mjs','ts-resolve-hook.mjs'].forEach(f=>fs.copyFileSync('src/cli/'+f,'dist/cli/'+f))\"",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@tabler/icons-svelte": "^3.0.0",
+    "date-fns": "^4.1.0",
+    "drizzle-orm": "^0.38.0",
+    "lucide-svelte": "^1.0.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/pdfkit": "^0.17.5",
+    "better-sqlite3": "^11.0.0",
+    "exceljs": "^4.4.0",
+    "sveltekit-superforms": "^2.30.1",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": ">=3.0.0",
+    "@aws-sdk/s3-request-presigner": ">=3.0.0",
+    "@sveltejs/kit": "^2.0.0",
+    "better-sqlite3": "*",
+    "bullmq": ">=5.0.0",
+    "exceljs": ">=4.4.0",
+    "ioredis": ">=5.0.0",
+    "mysql2": "*",
+    "pdfkit": ">=0.18.0",
+    "postgres": "*",
+    "pusher-js": ">=8.0.0",
+    "sveltekit-superforms": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    },
+    "bullmq": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "postgres": {
+      "optional": true
+    },
+    "pusher-js": {
+      "optional": true
+    },
+    "pdfkit": {
+      "optional": true
+    },
+    "exceljs": {
+      "optional": true
+    },
+    "sveltekit-superforms": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "svelte",
+    "sveltekit",
+    "laravel",
+    "orm",
+    "framework",
+    "drizzle",
+    "middleware",
+    "auth",
+    "session",
+    "cache",
+    "queue",
+    "mail"
+  ],
+  "license": "MIT",
+  "author": "Raoni <alephtus@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/beeblock/svelar.git"
+  },
+  "homepage": "https://github.com/beeblock/svelar#readme"
+}

package/src/i18n/LanguageSwitcher.svelte

@@ -0,0 +1,47 @@
+<script lang="ts">
+  // Svelar Language Switcher Component
+  // A generic locale switcher that works with paraglide-js 2.x.
+  // Pass in your paraglide runtime functions and it handles the rest.
+
+  interface Props {
+    /** Available locale codes (e.g. ['en', 'pt']) */
+    locales: readonly string[];
+    /** Function that returns the current locale */
+    getLocale: () => string;
+    /** Function to localize a path for a given locale */
+    localizeHref: (path: string, options?: { locale: string }) => string;
+    /** Current pathname (e.g. page.url.pathname) */
+    pathname?: string;
+    /** Optional display labels per locale (e.g. { en: 'EN', pt: 'PT' }) */
+    labels?: Record<string, string>;
+    /** Extra CSS class for the container */
+    class?: string;
+    [key: string]: any;
+  }
+
+  let {
+    locales,
+    getLocale,
+    localizeHref,
+    pathname = '/',
+    labels = {},
+    class: className = '',
+    ...rest
+  }: Props = $props();
+</script>
+
+<div class="flex items-center gap-1 border border-gray-200 rounded-md overflow-hidden {className}" {...rest}>
+  {#each locales as locale}
+    {@const current = getLocale() === locale}
+    <a
+      href={localizeHref(pathname, { locale })}
+      hreflang={locale}
+      data-sveltekit-reload
+      class="px-2 py-1 text-xs font-medium transition-colors {current
+        ? 'bg-brand text-white'
+        : 'text-gray-500 hover:text-gray-900 hover:bg-gray-100'}"
+    >
+      {labels[locale] ?? locale.toUpperCase()}
+    </a>
+  {/each}
+</div>

package/src/i18n/index.ts

@@ -0,0 +1,113 @@
+/**
+ * Svelar i18n Integration
+ *
+ * Helpers for integrating paraglide-js 2.x with SvelteKit.
+ * Provides middleware composers, reroute hook creators, and the LanguageSwitcher component.
+ *
+ * @module svelar/i18n
+ *
+ * @example
+ * ```ts
+ * // hooks.server.ts
+ * import { createI18nHandle } from 'svelar/i18n';
+ * import { paraglideMiddleware } from '$lib/paraglide/server';
+ * import { getTextDirection } from '$lib/paraglide/runtime';
+ *
+ * const i18nHandle = createI18nHandle({ paraglideMiddleware, getTextDirection });
+ * ```
+ */
+
+import type { Handle } from '@sveltejs/kit';
+
+// ── Types ──────────────────────────────────────────────────
+
+export interface I18nHandleConfig {
+  /**
+   * The paraglide middleware function from `$lib/paraglide/server`.
+   * Signature: (request, callback) => Response
+   */
+  paraglideMiddleware: (
+    request: Request,
+    callback: (args: { request: Request; locale: string }) => Response | Promise<Response>,
+  ) => Response | Promise<Response>;
+
+  /**
+   * The getTextDirection function from `$lib/paraglide/runtime`.
+   * Returns 'ltr' or 'rtl' for a given locale.
+   */
+  getTextDirection?: (locale: string) => string;
+
+  /**
+   * HTML lang attribute placeholder (default: '%lang%')
+   */
+  langPlaceholder?: string;
+
+  /**
+   * HTML dir attribute placeholder (default: '%dir%')
+   */
+  dirPlaceholder?: string;
+}
+
+export interface RerouteConfig {
+  /**
+   * The deLocalizeUrl function from `$lib/paraglide/runtime`.
+   * Strips the locale prefix from URLs for SvelteKit routing.
+   */
+  deLocalizeUrl: (url: URL) => { pathname: string };
+}
+
+// ── i18n Handle Creator ───────────────────────────────────
+
+/**
+ * Creates a SvelteKit `Handle` hook that wires paraglide-js middleware
+ * for server-side locale detection and HTML attribute injection.
+ *
+ * @example
+ * ```ts
+ * import { createI18nHandle } from 'svelar/i18n';
+ * import { paraglideMiddleware } from '$lib/paraglide/server';
+ * import { getTextDirection } from '$lib/paraglide/runtime';
+ *
+ * export const i18nHandle = createI18nHandle({ paraglideMiddleware, getTextDirection });
+ * ```
+ */
+export function createI18nHandle(config: I18nHandleConfig): Handle {
+  const {
+    paraglideMiddleware,
+    getTextDirection = () => 'ltr',
+    langPlaceholder = '%lang%',
+    dirPlaceholder = '%dir%',
+  } = config;
+
+  return ({ event, resolve }) =>
+    paraglideMiddleware(event.request, ({ request: localizedRequest, locale }) => {
+      event.request = localizedRequest;
+      return resolve(event, {
+        transformPageChunk: ({ html }) =>
+          html.replace(langPlaceholder, locale).replace(dirPlaceholder, getTextDirection(locale)),
+      });
+    });
+}
+
+/**
+ * Creates a SvelteKit `Reroute` function that strips locale prefixes
+ * from URLs so SvelteKit's file-based routing works correctly.
+ *
+ * @example
+ * ```ts
+ * // hooks.ts (client-side)
+ * import { createReroute } from 'svelar/i18n';
+ * import { deLocalizeUrl } from '$lib/paraglide/runtime';
+ *
+ * export const reroute = createReroute({ deLocalizeUrl });
+ * ```
+ */
+export function createReroute(config: RerouteConfig) {
+  return (request: { url: URL }) => {
+    return config.deLocalizeUrl(request.url).pathname;
+  };
+}
+
+// Note: LanguageSwitcher is a Svelte component, imported separately:
+// import LanguageSwitcher from 'svelar/i18n/LanguageSwitcher.svelte';
+// or via the Svelte-aware entry point (svelte condition in package.json)

package/src/ui/Alert.svelte

@@ -0,0 +1,22 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    variant?: 'default' | 'destructive' | 'success';
+    class?: string;
+    children?: Snippet;
+    [key: string]: any;
+  }
+
+  let { variant = 'default', class: className = '', children, ...rest }: Props = $props();
+
+  const variants: Record<string, string> = {
+    default: 'bg-blue-50 text-blue-900 border border-blue-200',
+    destructive: 'bg-red-50 text-red-900 border border-red-200',
+    success: 'bg-green-50 text-green-900 border border-green-200',
+  };
+</script>
+
+<div class="rounded-lg p-4 {variants[variant]} {className}" role="alert" {...rest}>
+  {#if children}{@render children()}{/if}
+</div>

package/src/ui/Avatar.svelte

@@ -0,0 +1,18 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    class?: string;
+    children?: Snippet;
+    [key: string]: any;
+  }
+
+  let { class: className = '', children, ...rest }: Props = $props();
+</script>
+
+<div
+  class="relative inline-flex h-10 w-10 shrink-0 overflow-hidden rounded-full bg-gray-200 {className}"
+  {...rest}
+>
+  {#if children}{@render children()}{/if}
+</div>

package/src/ui/AvatarFallback.svelte

@@ -0,0 +1,18 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    class?: string;
+    children?: Snippet;
+    [key: string]: any;
+  }
+
+  let { class: className = '', children, ...rest }: Props = $props();
+</script>
+
+<div
+  class="flex items-center justify-center w-full h-full bg-gray-300 text-gray-700 font-semibold text-sm {className}"
+  {...rest}
+>
+  {#if children}{@render children()}{/if}
+</div>

package/src/ui/AvatarImage.svelte

@@ -0,0 +1,12 @@
+<script lang="ts">
+  interface Props {
+    src?: string;
+    alt?: string;
+    class?: string;
+    [key: string]: any;
+  }
+
+  let { src = '', alt = '', class: className = '', ...rest }: Props = $props();
+</script>
+
+<img {src} {alt} class="aspect-square h-full w-full object-cover {className}" {...rest} />

package/src/ui/Badge.svelte

@@ -0,0 +1,27 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'success';
+    class?: string;
+    children?: Snippet;
+    [key: string]: any;
+  }
+
+  let { variant = 'default', class: className = '', children, ...rest }: Props = $props();
+
+  const variants: Record<string, string> = {
+    default: 'bg-brand text-white',
+    secondary: 'bg-gray-100 text-gray-900',
+    destructive: 'bg-red-100 text-red-900',
+    outline: 'border border-gray-300 bg-white text-gray-900',
+    success: 'bg-green-100 text-green-900',
+  };
+</script>
+
+<span
+  class="inline-flex items-center rounded-full px-2.5 py-0.5 text-xs font-semibold transition-colors {variants[variant]} {className}"
+  {...rest}
+>
+  {#if children}{@render children()}{/if}
+</span>

package/src/ui/Button.svelte

@@ -0,0 +1,51 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
+    size?: 'default' | 'sm' | 'lg' | 'icon';
+    class?: string;
+    disabled?: boolean;
+    type?: 'button' | 'submit' | 'reset';
+    children?: Snippet;
+    onclick?: (e: MouseEvent) => void;
+    [key: string]: any;
+  }
+
+  let {
+    variant = 'default',
+    size = 'default',
+    class: className = '',
+    disabled = false,
+    type = 'button',
+    children,
+    onclick,
+    ...rest
+  }: Props = $props();
+
+  const variants: Record<string, string> = {
+    default: 'bg-brand text-white hover:bg-brand-dark shadow-sm',
+    destructive: 'bg-red-500 text-white hover:bg-red-600 shadow-sm',
+    outline: 'border border-gray-300 bg-white hover:bg-gray-50 text-gray-700',
+    secondary: 'bg-gray-100 text-gray-900 hover:bg-gray-200',
+    ghost: 'hover:bg-gray-100 text-gray-700',
+    link: 'text-brand underline-offset-4 hover:underline',
+  };
+
+  const sizes: Record<string, string> = {
+    default: 'h-10 px-4 py-2',
+    sm: 'h-9 rounded-md px-3 text-sm',
+    lg: 'h-11 rounded-md px-8 text-base',
+    icon: 'h-10 w-10',
+  };
+</script>
+
+<button
+  {type}
+  {disabled}
+  class="inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 {variants[variant]} {sizes[size]} {className}"
+  {onclick}
+  {...rest}
+>
+  {#if children}{@render children()}{/if}
+</button>

package/src/ui/Card.svelte

@@ -0,0 +1,15 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    class?: string;
+    children?: Snippet;
+    [key: string]: any;
+  }
+
+  let { class: className = '', children, ...rest }: Props = $props();
+</script>
+
+<div class="rounded-lg border border-gray-200 bg-white shadow-sm {className}" {...rest}>
+  {#if children}{@render children()}{/if}
+</div>

package/src/ui/CardContent.svelte

@@ -0,0 +1,15 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    class?: string;
+    children?: Snippet;
+    [key: string]: any;
+  }
+
+  let { class: className = '', children, ...rest }: Props = $props();
+</script>
+
+<div class="p-6 pt-0 {className}" {...rest}>
+  {#if children}{@render children()}{/if}
+</div>