@generaltranslation/react-core 0.0.0 → 0.0.1-alpha.0

package/dist/types.d.ts

@@ -0,0 +1,214 @@
+import { GTProp, Variable, VariableType, JsxChildren, CustomMapping } from 'generaltranslation/types';
+export { GTProp } from 'generaltranslation/types';
+import React, { ReactNode } from 'react';
+import { GT } from 'generaltranslation';
+
+/**
+ * For dictionaries, we have Entry and MetaEntry
+ */
+type Entry = string;
+type MetaEntry = {
+    $context?: string;
+    $_hash?: string;
+    [key: string]: unknown;
+};
+type DictionaryEntry = Entry | [Entry] | [Entry, MetaEntry];
+type Dictionary = {
+    [key: string]: Dictionary | DictionaryEntry;
+} | (Dictionary | DictionaryEntry)[];
+type FlattenedDictionary = {
+    [key: string]: DictionaryEntry;
+};
+/**
+ * Translated content types
+ */
+type TranslatedElement = {
+    i?: number;
+    d?: GTProp;
+    c?: TranslatedChildren;
+};
+type TranslatedChild = TranslatedElement | string | Variable;
+type TranslatedChildren = TranslatedChild | TranslatedChild[];
+type Translations = {
+    [hash: string]: TranslatedChildren | null;
+};
+/**
+ * @deprecated use {@link Dictionary}
+ */
+type DictionaryContent = string;
+/**
+ * @deprecated use {@link Dictionary}
+ */
+type DictionaryObject = {
+    [id: string]: DictionaryContent;
+};
+type LocalesDictionary = {
+    [locale: string]: DictionaryObject;
+};
+type CustomLoader = (locale: string) => Promise<any>;
+type RenderMethod = 'skeleton' | 'replace' | 'default';
+type DictionaryTranslationOptions = Record<string, any>;
+type InlineTranslationOptions = DictionaryTranslationOptions & {
+    $context?: string;
+    $id?: string;
+    $_hash?: string;
+    $_source?: string;
+};
+type RuntimeTranslationOptions = {
+    locale?: string;
+} & Omit<InlineTranslationOptions, 'id'>;
+type VariableProps = {
+    variableType: VariableType;
+    variableValue: any;
+    variableOptions: Intl.NumberFormatOptions | Intl.DateTimeFormatOptions;
+    variableName: string;
+};
+type RenderVariable = ({ variableType, variableValue, variableOptions, locales, }: Omit<VariableProps, 'variableName'> & {
+    locales: string[];
+}) => React.JSX.Element;
+type _Message = {
+    message: string;
+    $id?: string;
+    $context?: string;
+    $_hash?: string;
+};
+type _Messages = _Message[];
+type MFunctionType = <T extends string | null | undefined>(encodedMsg: T, options?: Record<string, any>) => T extends string ? string : T;
+type TFunctionType = (message: string, options?: InlineTranslationOptions) => string;
+
+type TranslateIcuCallback = (params: {
+    source: string;
+    targetLocale: string;
+    metadata: {
+        hash: string;
+        context?: string;
+    } & Record<string, any>;
+}) => Promise<TranslatedChildren>;
+type TranslateChildrenCallback = (params: {
+    source: JsxChildren | undefined;
+    targetLocale: string;
+    metadata: {
+        hash: string;
+        context?: string;
+    } & Record<string, any>;
+}) => Promise<TranslatedChildren>;
+
+type GTContextType = {
+    gt: GT;
+    registerIcuForTranslation: TranslateIcuCallback;
+    registerJsxForTranslation: TranslateChildrenCallback;
+    _tFunction: (message: string, options?: InlineTranslationOptions, preloadedTranslations?: Translations) => string;
+    _mFunction: <T extends string | null | undefined>(encodedMsg: T, options?: Record<string, any>, preloadedTranslations?: Translations) => T extends string ? string : T;
+    _filterMessagesForPreload: (_messages: _Messages) => _Messages;
+    _preloadMessages: (_messages: _Messages) => Promise<Translations>;
+    _dictionaryFunction: (id: string, options?: DictionaryTranslationOptions) => string;
+    _dictionaryObjFunction: (id: string, idWithParent: string, options?: DictionaryTranslationOptions) => Dictionary | DictionaryEntry | string | undefined;
+    developmentApiEnabled: boolean;
+    locale: string;
+    locales: string[];
+    setLocale: (locale: string) => void;
+    defaultLocale: string;
+    region: string | undefined;
+    setRegion: (region: string | undefined) => void;
+    translations: Translations | null;
+    translationRequired: boolean;
+    dialectTranslationRequired: boolean;
+    renderSettings: {
+        method: RenderMethod;
+        timeout?: number;
+    };
+    projectId?: string;
+};
+
+type AuthFromEnvParams = {
+    projectId?: string;
+    devApiKey?: string;
+};
+type AuthFromEnvReturn = {
+    projectId: string;
+    devApiKey?: string;
+};
+
+type UseDetermineLocaleParams = {
+    defaultLocale: string;
+    locales: string[];
+    locale?: string;
+    localeCookieName?: string;
+    ssr?: boolean;
+    customMapping?: CustomMapping;
+};
+type UseDetermineLocaleReturn = [string, (locale: string) => void];
+
+type UseRegionStateParams = {
+    _region: string | undefined;
+    ssr: boolean;
+    regionCookieName: string;
+};
+type UseRegionStateReturn = {
+    region: string | undefined;
+    setRegion: (region: string | undefined) => void;
+};
+
+type LocaleSelectorProps = {
+    locales?: string[];
+    customNames?: {
+        [key: string]: string;
+    };
+    customMapping?: CustomMapping;
+    [key: string]: any;
+};
+type RegionSelectorProps<Regions extends string[]> = {
+    regions?: Regions;
+    placeholder?: ReactNode;
+    customMapping?: CustomMapping;
+    prioritizeCurrentLocaleRegion?: boolean;
+    sortRegionsAlphabetically?: boolean;
+};
+
+type GTConfig = {
+    projectId?: string;
+    devApiKey?: string;
+    locales?: string[];
+    defaultLocale?: string;
+    dictionary?: string;
+    runtimeUrl?: string;
+    cacheUrl?: string;
+    renderSettings?: {
+        method: RenderMethod;
+        timeout?: number;
+    };
+    _versionId?: string;
+    ssr?: boolean;
+    localeCookieName?: string;
+    customMapping?: CustomMapping;
+    modelProvider?: string;
+};
+type GTProviderProps = {
+    children?: React.ReactNode;
+    projectId?: string;
+    devApiKey?: string;
+    dictionary?: any;
+    locales?: string[];
+    defaultLocale?: string;
+    locale?: string;
+    region?: string;
+    cacheUrl?: string;
+    runtimeUrl?: string;
+    renderSettings?: {
+        method: RenderMethod;
+        timeout?: number;
+    };
+    _versionId?: string;
+    ssr?: boolean;
+    localeCookieName?: string;
+    translations?: Translations | null;
+    loadDictionary?: CustomLoader;
+    loadTranslations?: CustomLoader;
+    config?: GTConfig;
+    fallback?: React.ReactNode;
+    customMapping?: CustomMapping;
+    modelProvider?: string;
+    [key: string]: any;
+};
+
+export type { AuthFromEnvParams, AuthFromEnvReturn, CustomLoader, Dictionary, DictionaryContent, DictionaryEntry, DictionaryObject, DictionaryTranslationOptions, Entry, FlattenedDictionary, GTContextType, GTProviderProps, InlineTranslationOptions, LocaleSelectorProps, LocalesDictionary, MFunctionType, MetaEntry as Metadata, RegionSelectorProps, RenderMethod, RenderVariable, RuntimeTranslationOptions, TFunctionType, TranslatedChildren, Translations, UseDetermineLocaleParams, UseDetermineLocaleReturn, UseRegionStateParams, UseRegionStateReturn, VariableProps, _Message, _Messages };

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,KAAK,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,SAAS,EACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EACL,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,MAAM,EACN,KAAK,EACL,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,SAAS,IAAI,QAAQ,EACrB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,GACrB,CAAC"}

package/dist/ui/LocaleSelector.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { LocaleSelectorProps } from './types';
+/**
+ * @deprecated - this function is to always be overridden by a wrapper react package
+ */
+export default function LocaleSelector({}: LocaleSelectorProps): React.JSX.Element | null;
+//# sourceMappingURL=LocaleSelector.d.ts.map

package/dist/ui/LocaleSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleSelector.d.ts","sourceRoot":"","sources":["../../src/ui/LocaleSelector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG9C;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAExF"}

package/dist/ui/RegionSelector.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { RegionSelectorProps } from './types';
+/**
+ * @deprecated - this function is to always be overridden by a wrapper react package
+ */
+export default function RegionSelector<Regions extends string[]>({}: RegionSelectorProps<Regions>): React.JSX.Element | null;
+//# sourceMappingURL=RegionSelector.d.ts.map

package/dist/ui/RegionSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegionSelector.d.ts","sourceRoot":"","sources":["../../src/ui/RegionSelector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG9C;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,OAAO,SAAS,MAAM,EAAE,EACxB,EAAE,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAE5D"}

package/dist/ui/types.d.ts

@@ -0,0 +1,18 @@
+import { CustomMapping } from 'generaltranslation/types';
+import { ReactNode } from 'react';
+export type LocaleSelectorProps = {
+    locales?: string[];
+    customNames?: {
+        [key: string]: string;
+    };
+    customMapping?: CustomMapping;
+    [key: string]: any;
+};
+export type RegionSelectorProps<Regions extends string[]> = {
+    regions?: Regions;
+    placeholder?: ReactNode;
+    customMapping?: CustomMapping;
+    prioritizeCurrentLocaleRegion?: boolean;
+    sortRegionsAlphabetically?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/ui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ui/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACxC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,OAAO,SAAS,MAAM,EAAE,IAAI;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC"}

package/dist/utils/cookies.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cookie name for tracking the referrer locale
+ */
+export declare const defaultLocaleCookieName = "generaltranslation.locale";
+/**
+ * Cookie name for tracking the user's selected region
+ */
+export declare const defaultRegionCookieName = "generaltranslation.region";
+//# sourceMappingURL=cookies.d.ts.map

package/dist/utils/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/utils/cookies.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AACnE;;GAEG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC"}

package/dist/utils/fetchTranslations.d.ts

@@ -0,0 +1,9 @@
+import { GT } from 'generaltranslation';
+export default function fetchTranslations({ cacheUrl, projectId, locale, versionId, gt, }: {
+    cacheUrl: string;
+    projectId: string;
+    locale: string;
+    versionId?: string;
+    gt: GT;
+}): Promise<any>;
+//# sourceMappingURL=fetchTranslations.d.ts.map

package/dist/utils/fetchTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchTranslations.d.ts","sourceRoot":"","sources":["../../src/utils/fetchTranslations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAExC,wBAA8B,iBAAiB,CAAC,EAC9C,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,EAAE,GACH,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,EAAE,CAAC;CACR,gBAUA"}

package/dist/utils/types.d.ts

@@ -0,0 +1,9 @@
+export type AuthFromEnvParams = {
+    projectId?: string;
+    devApiKey?: string;
+};
+export type AuthFromEnvReturn = {
+    projectId: string;
+    devApiKey?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/utils/utils.d.ts

@@ -0,0 +1,8 @@
+import { TaggedElement } from '../types-dir/types';
+import { AuthFromEnvParams, AuthFromEnvReturn } from './types';
+export declare function isValidTaggedElement(target: unknown): target is TaggedElement;
+/**
+ * @deprecated - this function is to always be overridden by a wrapper react package
+ */
+export declare function readAuthFromEnv({}: AuthFromEnvParams): AuthFromEnvReturn;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG/D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAE7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,iBAAiB,GAAG,iBAAiB,CAExE"}

package/dist/variables/Currency.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+/**
+ * The `<Currency>` component renders a formatted currency string, allowing customization of name, default value, currency type, and formatting options.
+ * Must be used inside a `<GTProvider>`.
+ *
+ * @example
+ * ```jsx
+ * <Currency currency="USD">
+ *    1000
+ * </Currency>
+ * ```
+ *
+ * @param {number | string | null | undefined} children - Content to render inside the currency component.
+ * @param {string} [currency="USD"] - The currency type (e.g., USD, EUR, etc.).
+ * @param {string[]} [locales] - Optional locales to use for currency formatting. If wrapped in a `<GTProvider>`, the user's locale is used.
+ * @param {Intl.NumberFormatOptions} [options={}] - Optional formatting options to customize how the currency is displayed.
+ * @returns {JSX.Element} The formatted currency component.
+ */
+declare function Currency({ children, currency, locales, options, }: {
+    children: number | string | null | undefined;
+    currency?: string;
+    name?: string;
+    locales?: string[];
+    options?: Intl.NumberFormatOptions;
+}): React.JSX.Element | null;
+declare namespace Currency {
+    var _gtt: string;
+}
+export default Currency;
+//# sourceMappingURL=Currency.d.ts.map

package/dist/variables/Currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Currency.d.ts","sourceRoot":"","sources":["../../src/variables/Currency.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAI1C;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,QAAQ,CAAC,EAChB,QAAQ,EACR,QAAgB,EAChB,OAAO,EACP,OAAY,GACb,EAAE;IACD,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;CACpC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAoB3B;kBA/BQ,QAAQ;;;AAoCjB,eAAe,QAAQ,CAAC"}

package/dist/variables/DateTime.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+/**
+ * The `<DateTime>` component renders a formatted date or time string, allowing customization of the name, default value, and formatting options.
+ * It utilizes the current locale and optional format settings to display the date.
+ * Must be used inside a `<GTProvider>`.
+ *
+ * @example
+ * ```jsx
+ * <DateTime>
+ *    {new Date()}
+ * </DateTime>
+ * ```
+ *
+ * @param {Date} children - Content to render inside the date component.
+ * @param {string[]} [locales] - Optional locales to use for date formatting. If wrapped in a `<GTProvider>`, the user's locale is used.
+ * @param {Intl.DateTimeFormatOptions} [options={}] - Optional formatting options for the date, following `Intl.DateTimeFormatOptions` specifications.
+ * @returns {JSX.Element} The formatted date or time component.
+ */
+declare function DateTime({ children, locales, options, }: {
+    children: Date | null | undefined;
+    name?: string;
+    locales?: string[];
+    options?: Intl.DateTimeFormatOptions;
+}): React.JSX.Element | null;
+declare namespace DateTime {
+    var _gtt: string;
+}
+export default DateTime;
+//# sourceMappingURL=DateTime.d.ts.map

package/dist/variables/DateTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateTime.d.ts","sourceRoot":"","sources":["../../src/variables/DateTime.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAI1C;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,QAAQ,CAAC,EAChB,QAAQ,EACR,OAAO,EACP,OAAY,GACb,EAAE;IACD,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC;CACtC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAe3B;kBAxBQ,QAAQ;;;AA6BjB,eAAe,QAAQ,CAAC"}

package/dist/variables/Num.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+/**
+ * The `<Num>` component renders a formatted number string, allowing customization of the name, default value, and formatting options.
+ * It formats the number according to the current locale and optionally passed formatting options.
+ * Must be used inside a `<GTProvider>`.
+ *
+ * @example
+ * ```jsx
+ * <Num
+ *    options={{ style: "decimal", maximumFractionDigits: 2 }}
+ * >
+ *    1000
+ * </Num>
+ * ```
+ *
+ * @param {number | string | null | undefined} children - Content to render inside the number component.
+ * @param {string[]} [locales] - Optional locales to use for number formatting. If wrapped in a `<GTProvider>`, the user's locale is used.
+ * @param {Intl.NumberFormatOptions} [options={}] - Optional formatting options for the number, following `Intl.NumberFormatOptions` specifications.
+ * @returns {React.JSX.Element} The formatted number component.
+ */
+declare function Num({ children, locales, options, }: {
+    children: number | string | null | undefined;
+    name?: string;
+    locales?: string[];
+    options?: Intl.NumberFormatOptions;
+}): React.JSX.Element | null;
+declare namespace Num {
+    var _gtt: string;
+}
+export default Num;
+//# sourceMappingURL=Num.d.ts.map

package/dist/variables/Num.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Num.d.ts","sourceRoot":"","sources":["../../src/variables/Num.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAI1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,GAAG,CAAC,EACX,QAAQ,EACR,OAAO,EACP,OAAY,GACb,EAAE;IACD,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;CACpC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAiB3B;kBA1BQ,GAAG;;;AA8BZ,eAAe,GAAG,CAAC"}

package/dist/variables/Var.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+/**
+ * The `<Var>` component renders a variable value, which can either be passed as `children` or a `value`.
+ * If `children` is provided, it will be used; otherwise, the `value` is rendered.
+ *
+ * @example Inline usage:
+ * ```jsx
+ *  function MyComponent() {
+ *     const name = 'Archie';
+ *     return (
+ *          <T>
+ *              <p>
+ *                  Hello, <Var> {name} </Var>!
+ *              </p>
+ *          </T>
+ *      );
+ *  }
+ * ```
+ *
+ *
+ * @param {any} [children] - The content to render inside the component. If provided, it will take precedence over `value`.
+ * @returns {JSX.Element} The rendered variable component with either `children` or `value`.
+ */
+declare function Var({ children, }: {
+    children?: any;
+    name?: string;
+}): React.JSX.Element | null;
+declare namespace Var {
+    var _gtt: string;
+}
+export default Var;
+//# sourceMappingURL=Var.d.ts.map

package/dist/variables/Var.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Var.d.ts","sourceRoot":"","sources":["../../src/variables/Var.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,GAAG,CAAC,EACX,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAE3B;kBAPQ,GAAG;;;AAYZ,eAAe,GAAG,CAAC"}

package/dist/variables/_getVariableProps.d.ts

@@ -0,0 +1,11 @@
+import { GTTag, VariableProps } from '../types-dir/types';
+type VariableElementProps = {
+    'data-_gt': GTTag & {
+        transformation: 'variable';
+    };
+    [key: string]: unknown;
+};
+export declare function isVariableElementProps(props: unknown): props is VariableElementProps;
+export default function getVariableProps(props: VariableElementProps): VariableProps;
+export {};
+//# sourceMappingURL=_getVariableProps.d.ts.map

package/dist/variables/_getVariableProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_getVariableProps.d.ts","sourceRoot":"","sources":["../../src/variables/_getVariableProps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAI1D,KAAK,oBAAoB,GAAG;IAC1B,UAAU,EAAE,KAAK,GAAG;QAClB,cAAc,EAAE,UAAU,CAAC;KAC5B,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,oBAAoB,CAU/B;AAED,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAK,EAAE,oBAAoB,GAC1B,aAAa,CA6Bf"}

package/dist/variables/getVariableName.d.ts

@@ -0,0 +1,10 @@
+declare const defaultVariableNames: {
+    readonly variable: "value";
+    readonly number: "n";
+    readonly datetime: "date";
+    readonly currency: "cost";
+};
+export declare const baseVariablePrefix = "_gt_";
+export default function getVariableName(props: Record<string, any> | undefined, variableType: keyof typeof defaultVariableNames): string;
+export {};
+//# sourceMappingURL=getVariableName.d.ts.map

package/dist/variables/getVariableName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getVariableName.d.ts","sourceRoot":"","sources":["../../src/variables/getVariableName.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,oBAAoB;;;;;CAKhB,CAAC;AAEX,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAK,EAC/B,YAAY,EAAE,MAAM,OAAO,oBAAoB,GAC9C,MAAM,CAIR"}

package/package.json

@@ -1,24 +1,119 @@
 {
   "name": "@generaltranslation/react-core",
-  "version": "0.0.0",
-  "description": "A pure React library for i18n",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "private": false,
+  "version": "0.0.1-alpha.0",
+  "description": "A pure React library for internationalization",
+  "main": "./dist/index.cjs.min.cjs",
+  "module": "./dist/index.esm.min.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "dependencies": {
+    "generaltranslation": "7.6.5",
+    "@generaltranslation/supported-locales": "2.0.15"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/generaltranslation/gt.git"
+  },
   "author": "General Translation, Inc.",
   "license": "FSL-1.1-ALv2",
+  "bugs": {
+    "url": "https://github.com/generaltranslation/gt/issues"
+  },
+  "homepage": "https://generaltranslation.com/",
+  "devDependencies": {
+    "@babel/preset-react": "^7.26.3",
+    "@babel/preset-typescript": "^7.26.0",
+    "@rollup/plugin-babel": "^6.0.4",
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/node": "^24.8.0",
+    "@types/react": ">=18.0.0 <20.0.0",
+    "rollup": "^4.32.1",
+    "rollup-plugin-dts": "^6.2.3",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rollup-plugin-postcss": "^4.0.2",
+    "rollup-preserve-directives": "^1.1.3",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs.min.cjs",
+      "import": "./dist/index.esm.min.mjs"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "require": "./dist/internal.cjs.min.cjs",
+      "import": "./dist/internal.esm.min.mjs"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "require": "./dist/errors.cjs.min.cjs",
+      "import": "./dist/errors.esm.min.mjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "types": [
+        "./dist/types.d.ts"
+      ],
+      "internal": [
+        "./dist/internal.d.ts"
+      ],
+      "errors": [
+        "./dist/errors.d.ts"
+      ]
+    }
+  },
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@generaltranslation/react-core/client": [
+        "./dist/client"
+      ],
+      "@generaltranslation/react-core/internal": [
+        "./dist/internal"
+      ],
+      "@generaltranslation/react-core/types": [
+        "./dist/types.d.ts"
+      ],
+      "@generaltranslation/react-core/errors": [
+        "./dist/errors.d.ts"
+      ]
+    }
+  },
   "keywords": [
     "react",
     "translation",
-    "i18n",
+    "internationalization",
     "localization",
-    "general-translation"
+    "i18n"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/generaltranslation/gt"
-  },
-  "peerDependencies": {
-    "react": ">=16.8.0"
+  "scripts": {
+    "patch": "pnpm version patch",
+    "transpile": "tsc",
+    "build": "rollup -c",
+    "build:clean": "sh ../../scripts/clean.sh && pnpm run build",
+    "build:release": "pnpm run build:clean",
+    "release": "pnpm run build:clean && pnpm publish",
+    "release:alpha": "pnpm run build:clean && pnpm publish --tag alpha",
+    "release:beta": "pnpm run build:clean && pnpm publish --tag beta",
+    "release:latest": "pnpm run build:clean && pnpm publish --tag latest",
+    "lint": "eslint \"src/**/*.{js,ts,tsx}\" \"__tests__/**/*.{js,ts,tsx}\"",
+    "lint:fix": "eslint \"src/**/*.{js,ts,tsx}\" \"__tests__/**/*.{js,ts,tsx}\" --fix",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}

package/index.d.ts

@@ -1,4 +0,0 @@
-// Type definitions for @generaltranslation/react-core
-// Coming soon
-
-export {};

package/index.js

@@ -1,7 +0,0 @@
-// @generaltranslation/react-core
-// React core components for General Translation
-// Package reserved - full implementation coming soon
-
-module.exports = {
-  // Placeholder exports
-};