@i18n-micro/preact 1.2.0 → 1.2.1

package/dist/index.d.cts

@@ -0,0 +1,271 @@
+import { Attributes } from 'preact';
+import { BaseI18n } from '@i18n-micro/core';
+import { CleanTranslation } from '@i18n-micro/types';
+import { ComponentChildren } from 'preact';
+import { Context } from 'preact';
+import { default as default_2 } from 'react';
+import { defaultPlural } from '@i18n-micro/core';
+import { FormatService } from '@i18n-micro/core';
+import { Getter } from '@i18n-micro/types';
+import { interpolate } from '@i18n-micro/core';
+import { JSX as JSX_2 } from 'preact';
+import { Locale } from '@i18n-micro/types';
+import { LocaleCode } from '@i18n-micro/types';
+import { ModuleOptions } from '@i18n-micro/types';
+import { Params } from '@i18n-micro/types';
+import { PluralFunc } from '@i18n-micro/types';
+import { TranslationKey } from '@i18n-micro/types';
+import { Translations } from '@i18n-micro/types';
+import { TranslationStorage } from '@i18n-micro/core';
+import { VNode } from 'preact';
+
+export { CleanTranslation }
+
+/**
+ * Создает адаптер для работы с History API (универсальный для Pure Preact)
+ * Работает с любым роутером, который использует History API (wouter, preact-router, и т.д.)
+ */
+export declare function createBrowserHistoryAdapter(locales: Locale[], defaultLocale: string): I18nRoutingStrategy;
+
+export declare function createI18n(options: PreactI18nOptions): PreactI18n;
+
+export declare const createPreactRouterAdapter: typeof createBrowserHistoryAdapter;
+
+export { defaultPlural }
+
+export { FormatService }
+
+export { Getter }
+
+export declare const I18nContext: Context<PreactI18n | null>;
+
+export declare const I18nDefaultLocaleContext: Context<string | null>;
+
+export declare const I18nGroup: (props: I18nGroupProps) => JSX_2.Element;
+
+export declare interface I18nGroupProps extends Omit<JSX_2.HTMLAttributes<HTMLDivElement>, 'children'> {
+    prefix: string;
+    groupClass?: string;
+    children?: (props: {
+        prefix: string;
+        t: (key: string, params?: Record<string, string | number | boolean>) => string;
+    }) => ComponentChildren;
+}
+
+export declare const I18nLink: (props: I18nLinkProps) => JSX_2.Element;
+
+export declare interface I18nLinkProps extends JSX_2.AnchorHTMLAttributes<HTMLAnchorElement> {
+    to: string | {
+        path?: string;
+    };
+    activeStyle?: Record<string, string | number>;
+    localeRoute?: (to: string | {
+        path?: string;
+    }, locale?: string) => string | {
+        path?: string;
+    };
+}
+
+export declare const I18nLocalesContext: Context<Locale[] | null>;
+
+export declare function I18nProvider({ i18n, locales, defaultLocale, routingStrategy, children }: I18nProviderProps): VNode<Attributes & {
+value: PreactI18n | null;
+children?: ComponentChildren;
+}>;
+
+export declare interface I18nProviderProps {
+    i18n: PreactI18n;
+    locales?: Locale[];
+    defaultLocale?: string;
+    routingStrategy?: I18nRoutingStrategy;
+    children?: ComponentChildren;
+}
+
+export declare const I18nRouterContext: Context<I18nRoutingStrategy | null>;
+
+/**
+ * Routing strategy interface for i18n
+ * Implement this interface to integrate with any router library
+ * Matches Vue/Solid package interface for consistency
+ */
+export declare interface I18nRoutingStrategy {
+    /**
+     * Returns current path (without locale prefix if needed, or full path)
+     * Used for determining active classes in links
+     */
+    getCurrentPath: () => string;
+    /**
+     * Component to use for rendering links (e.g., RouterLink)
+     */
+    linkComponent?: string | default_2.ComponentType<{
+        href: string;
+        children?: default_2.ReactNode;
+        style?: default_2.CSSProperties;
+        className?: string;
+        [key: string]: unknown;
+    }>;
+    /**
+     * Function to navigate to another route/locale
+     */
+    push: (target: {
+        path: string;
+    }) => void;
+    /**
+     * Function to replace current route
+     */
+    replace: (target: {
+        path: string;
+    }) => void;
+    /**
+     * Generate path for specific locale
+     */
+    resolvePath?: (to: string | {
+        path?: string;
+    }, locale: string) => string | {
+        path?: string;
+    };
+    /**
+     * (Optional) Get current route object for SEO/Meta tags
+     */
+    getRoute?: () => {
+        fullPath: string;
+        query: Record<string, unknown>;
+    };
+}
+
+export declare const I18nSwitcher: (props: I18nSwitcherProps) => JSX_2.Element;
+
+export declare interface I18nSwitcherProps extends JSX_2.HTMLAttributes<HTMLDivElement> {
+    locales?: Locale[];
+    currentLocale?: string | (() => string);
+    getLocaleName?: () => string | null;
+    switchLocale?: (locale: string) => void;
+    localeRoute?: (to: string | {
+        path?: string;
+    }, locale?: string) => string | {
+        path?: string;
+    };
+    customLabels?: Record<string, string>;
+    customWrapperStyle?: Record<string, string | number>;
+    customButtonStyle?: Record<string, string | number>;
+    customDropdownStyle?: Record<string, string | number>;
+    customItemStyle?: Record<string, string | number>;
+    customLinkStyle?: Record<string, string | number>;
+    customActiveLinkStyle?: Record<string, string | number>;
+    customIconStyle?: Record<string, string | number>;
+}
+
+export declare const I18nT: (props: I18nTProps) => JSX_2.Element | null;
+
+export declare interface I18nTProps extends Omit<JSX_2.HTMLAttributes<HTMLElement>, 'children'> {
+    keypath: TranslationKey;
+    params?: Record<string, string | number | boolean>;
+    tag?: keyof JSX_2.IntrinsicElements;
+    plural?: number | string;
+    defaultValue?: string;
+    html?: boolean;
+    hideIfEmpty?: boolean;
+    customPluralRule?: PluralFunc;
+    number?: number | string;
+    date?: Date | string | number;
+    relativeDate?: Date | string | number;
+    children?: never;
+}
+
+export { interpolate }
+
+export { Locale }
+
+export { LocaleCode }
+
+export { ModuleOptions }
+
+export { Params }
+
+export { PluralFunc }
+
+export declare class PreactI18n extends BaseI18n {
+    private _locale;
+    private _fallbackLocale;
+    private _currentRoute;
+    private listeners;
+    private revision;
+    readonly storage: TranslationStorage;
+    constructor(options: PreactI18nOptions);
+    subscribe: (listener: () => void) => () => boolean;
+    getSnapshot: () => string;
+    private notify;
+    get locale(): string;
+    set locale(val: string);
+    get fallbackLocale(): string;
+    set fallbackLocale(val: string);
+    get currentRoute(): string;
+    setRoute(routeName: string): void;
+    getLocale(): string;
+    getFallbackLocale(): string;
+    getRoute(): string;
+    addTranslations(locale: string, translations: Translations, merge?: boolean): void;
+    addRouteTranslations(locale: string, routeName: string, translations: Translations, merge?: boolean): void;
+    clearCache(): void;
+}
+
+export declare interface PreactI18nOptions {
+    locale: string;
+    fallbackLocale?: string;
+    messages?: Record<string, Translations>;
+    plural?: PluralFunc;
+    missingWarn?: boolean;
+    missingHandler?: (locale: string, key: string, routeName: string) => void;
+}
+
+export { TranslationKey }
+
+export { Translations }
+
+export declare const useI18n: (options?: UseI18nOptions) => UseI18nReturn;
+
+export declare const useI18nContext: () => PreactI18n;
+
+export declare const useI18nDefaultLocale: () => string | null;
+
+export declare const useI18nLocales: () => Locale[] | null;
+
+export declare interface UseI18nOptions {
+    locales?: Locale[];
+    defaultLocale?: string;
+}
+
+export declare interface UseI18nReturn {
+    t: (key: TranslationKey, params?: Params, defaultValue?: string | null, routeName?: string) => CleanTranslation;
+    ts: (key: TranslationKey, params?: Params, defaultValue?: string, routeName?: string) => string;
+    tc: (key: TranslationKey, count: number | Params, defaultValue?: string) => string;
+    tn: (value: number, options?: Intl.NumberFormatOptions) => string;
+    td: (value: Date | number | string, options?: Intl.DateTimeFormatOptions) => string;
+    tdr: (value: Date | number | string, options?: Intl.RelativeTimeFormatOptions) => string;
+    has: (key: TranslationKey, routeName?: string) => boolean;
+    locale: string;
+    fallbackLocale: string;
+    currentRoute: string;
+    setLocale: (locale: string) => void;
+    setRoute: (routeName: string) => void;
+    getRoute: () => string;
+    getLocales: () => Locale[];
+    defaultLocale: () => string;
+    getLocaleName: () => string | null;
+    switchLocale?: (locale: string) => void;
+    localeRoute?: (to: string | {
+        path?: string;
+    }, locale?: string) => string | {
+        path?: string;
+    };
+    localePath?: (to: string | {
+        path?: string;
+    }, locale?: string) => string;
+    addTranslations: (locale: string, translations: Translations, merge?: boolean) => void;
+    addRouteTranslations: (locale: string, routeName: string, translations: Translations, merge?: boolean) => void;
+    clearCache: () => void;
+}
+
+export declare const useI18nRouter: () => I18nRoutingStrategy | null;
+
+export { }

package/package.json

@@ -1,26 +1,55 @@
 {
   "name": "@i18n-micro/preact",
-  "version": "1.2.0",
+  "version": "1.2.1",
+  "description": "Preact bindings for i18n-micro — hooks, context, and UI components.",
   "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/s00d/nuxt-i18n-micro.git",
+    "directory": "packages/preact"
+  },
+  "homepage": "https://github.com/s00d/nuxt-i18n-micro/tree/main/packages/preact#readme",
+  "bugs": {
+    "url": "https://github.com/s00d/nuxt-i18n-micro/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    }
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "keywords": [
+    "preact",
+    "i18n",
+    "internationalization",
+    "translations"
+  ],
   "dependencies": {
-    "@i18n-micro/core": "1.2.0",
-    "@i18n-micro/types": "1.1.5"
+    "@i18n-micro/types": "1.2.2",
+    "@i18n-micro/core": "1.3.1"
   },
   "peerDependencies": {
     "preact": "^10.0.0"
@@ -35,12 +64,14 @@
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "preact": "^10.0.0",
+    "publint": "^0.3.17",
     "ts-jest": "^29.4.6",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4"
   },
   "scripts": {
     "build": "vite build",
+    "check:package": "publint",
     "dev": "cd playground && vite",
     "test": "jest",
     "typecheck": "tsc --noEmit"