generaltranslation 7.0.0 → 7.1.0-alpha.0

package/dist/types.d.ts

@@ -22,9 +22,16 @@ type LocaleProperties = {
     emoji: string;
 };
 
-type CustomMapping = Record<string, string | Partial<LocaleProperties>>;
+type VariableType = 'v' | 'n' | 'd' | 'c';
+/**
+ * Variables are used to store the variable name and type.
+ */
+type Variable = {
+    k: string;
+    i?: number;
+    v?: VariableType;
+};
 
-type Content = string | Array<string | Variable>;
 /**
  * Map of data-_gt properties to their corresponding React props
  */
@@ -38,12 +45,6 @@ declare const HTML_CONTENT_PROPS: {
 };
 type HtmlContentPropKeysRecord = Partial<Record<keyof typeof HTML_CONTENT_PROPS, string>>;
 type HtmlContentPropValuesRecord = Partial<Record<(typeof HTML_CONTENT_PROPS)[keyof typeof HTML_CONTENT_PROPS], string>>;
-/**
- * Transformations are made from a prefix and a suffix.
- */
-type Transformation = 'translate-client' | 'translate-server' | 'variable-variable' | 'variable-currency' | 'variable-datetime' | 'variable-number' | 'plural' | 'branch';
-type TransformationPrefix = 'translate' | 'variable' | 'plural' | 'branch' | 'fragment';
-type VariableTransformationSuffix = 'variable' | 'number' | 'datetime' | 'currency';
 /**
  * GTProp is an internal property used to contain data for translating and rendering elements.
  * note, transformations are only read on the server side if they are 'plural' or 'branch'
@@ -59,7 +60,238 @@ type JsxElement = {
     c?: JsxChildren;
 };
 type JsxChild = string | JsxElement | Variable;
+/**
+ * The format of the content
+ */
+type DataFormat = 'JSX' | 'ICU' | 'I18NEXT';
+/**
+ * A content type representing JSX, ICU, and I18next messages
+ */
+type Content = JsxChildren | IcuMessage | I18nextMessage;
+/**
+ * A content type representing JSX elements
+ */
 type JsxChildren = JsxChild | JsxChild[];
+/**
+ * A content type representing ICU messages
+ */
+type IcuMessage = string;
+/**
+ * A content type representing I18next messages
+ */
+type I18nextMessage = string;
+
+/**
+ * ActionType is the type of action to perform on the request.
+ *
+ * @param standard - The standard action type (standard model).
+ * @param fast - The fast action type (mini model).
+ * @param string - Other model
+ */
+type ActionType = 'standard' | 'fast' | string;
+/**
+ * EntryMetadata is the metadata for a GTRequest.
+ *
+ * @param context - The context of the request.
+ * @param id - The id of the request.
+ * @param hash - The hash of the request.
+ */
+type EntryMetadata = {
+    context?: string;
+    id?: string;
+    hash?: string;
+    dataFormat?: DataFormat;
+    sourceLocale?: string;
+    actionType?: ActionType;
+    timeout?: number;
+};
+/**
+ * GTRequest is a translation request object for {@link JsxChildren} | {@link IcuMessage} | {@link I18nextMessage}
+ *
+ * @param source - The source content to translate.
+ * @param targetLocale - The target locale to translate to.
+ * @param requestMetadata - The metadata for the request.
+ */
+type Entry = {
+    source: Content;
+    targetLocale?: string;
+    requestMetadata?: EntryMetadata;
+};
+
+type TranslationStatusResult = {
+    count: number;
+    availableLocales: string[];
+    locales: string[];
+    localesWaitingForApproval: any[];
+};
+
+type FileFormat = 'JSON' | 'YAML' | 'MDX' | 'MD' | 'TS' | 'JS';
+type CompletedFileTranslationData = {
+    locale: string;
+    metadata: any;
+    fileId: string;
+    fileName: string;
+    versionId: string;
+    id: string;
+    isReady: boolean;
+    downloadUrl: string;
+};
+
+type FileTranslationQuery = {
+    versionId: string;
+    fileName: string;
+    locale: string;
+};
+type CheckFileTranslationsOptions = {
+    timeout?: number;
+};
+type CheckFileTranslationsResult = {
+    translations: CompletedFileTranslationData[];
+};
+
+type DownloadFileBatchOptions = {
+    timeout?: number;
+};
+type File = {
+    id: string;
+    fileName: string;
+    data: string;
+    metadata: any;
+};
+type DownloadFileBatchResult = {
+    files: File[];
+    count: number;
+};
+
+type FetchTranslationsOptions = {
+    timeout?: number;
+};
+type RetrievedTranslation = {
+    locale: string;
+    translation: any;
+};
+type RetrievedTranslations = RetrievedTranslation[];
+type FetchTranslationsResult = {
+    translations: RetrievedTranslations;
+};
+
+type Updates = ({
+    metadata: Record<string, any>;
+} & ({
+    dataFormat: 'JSX';
+    source: JsxChildren;
+} | {
+    dataFormat: 'ICU';
+    source: string;
+} | {
+    dataFormat: 'I18NEXT';
+    source: string;
+}))[];
+/**
+ * File object structure for enqueueing files
+ * @param content - The content of the file
+ * @param fileName - The name of the file
+ * @param fileFormat - The format of the file (JSON, MDX, MD, etc.)
+ * @param dataFormat - The format of the data within the file
+ */
+interface FileToTranslate {
+    content: string;
+    fileName: string;
+    fileFormat: FileFormat;
+    dataFormat?: DataFormat;
+}
+type EnqueueFilesOptions = {
+    publish: boolean;
+    description?: string;
+    sourceLocale?: string;
+    targetLocales: string[];
+    _versionId?: string;
+    timeout?: number;
+};
+type EnqueueFilesResult = {
+    translations: CompletedFileTranslationData[];
+    data: Record<string, {
+        fileName: string;
+        versionId: string;
+    }>;
+    locales: string[];
+    message: string;
+};
+
+type EnqueueEntriesOptions = {
+    timeout?: number;
+    sourceLocale?: string;
+    targetLocales?: string[];
+    dataFormat?: DataFormat;
+    version?: string;
+    description?: string;
+    requireApproval?: boolean;
+};
+type EnqueueEntriesResult = {
+    versionId: string;
+    locales: string[];
+    message: string;
+    projectSettings: {
+        cdnEnabled: boolean;
+        requireApproval: boolean;
+    };
+};
+
+type DownloadFileOptions = {
+    timeout?: number;
+};
+
+/**
+ * TranslationResultReference is used to store the reference for a translation result.
+ */
+type TranslationResultReference = {
+    id?: string;
+    hash: string;
+};
+/**
+ * TypedResult is a union type that represents the different types of translations that can be returned.
+ */
+type TypedResult = {
+    translation: JsxChildren;
+    dataFormat: 'JSX';
+} | {
+    translation: I18nextMessage | IcuMessage;
+    dataFormat: 'ICU' | 'I18NEXT';
+};
+/**
+ * RequestError is a type that represents an error that occurred during a translation request.
+ */
+type TranslationError = {
+    error: string;
+    code: number;
+    reference?: TranslationResultReference;
+};
+/**
+ * RequestSuccess is a type that represents a successful translation request.
+ */
+type RequestSuccess = TypedResult & {
+    locale: string;
+    reference: TranslationResultReference;
+};
+type TranslationResult = RequestSuccess | TranslationError;
+
+/**
+ * BatchTranslationResult is the result of a batch translation request.
+ */
+type TranslateManyResult = Array<TranslationResult>;
+
+type CustomMapping = Record<string, string | Partial<LocaleProperties>>;
+
+/**
+ * @deprecated Use {@link Content} instead.
+ */
+type _Content = string | Array<string | Variable>;
+/**
+ * Transformations are made from a prefix and a suffix.
+ */
+type Transformation = 'translate-client' | 'translate-server' | 'translate-runtime' | 'variable-variable' | 'variable-currency' | 'variable-datetime' | 'variable-number' | 'plural' | 'branch';
+type TransformationPrefix = 'translate' | 'variable' | 'plural' | 'branch' | 'fragment';
+type VariableTransformationSuffix = 'variable' | 'number' | 'datetime' | 'currency';
 type Metadata = {
     context?: string;
     id?: string;
@@ -67,12 +299,11 @@ type Metadata = {
     actionType?: 'standard' | 'fast' | string;
     [key: string]: any;
 };
-type DataFormat = 'JSX' | 'ICU' | 'I18NEXT';
 type FormatVariables = Record<string, string | number | boolean | null | undefined | Date>;
 type Update = {
     type: 'content';
     data: {
-        source: Content;
+        source: _Content;
         metadata: Metadata;
     };
 } | {
@@ -85,7 +316,7 @@ type Update = {
 type Request = {
     type: 'content';
     data: {
-        source: Content;
+        source: _Content;
         targetLocale: string;
         metadata: Metadata;
     };
@@ -97,14 +328,20 @@ type Request = {
         metadata: Metadata;
     };
 };
+/**
+ * @deprecated Use {@link TranslationResult} instead.
+ */
 type ContentTranslationResult = {
-    translation: Content;
+    translation: _Content;
     locale: string;
     reference?: {
         id: string;
         key: string;
     };
 };
+/**
+ * @deprecated Use {@link TranslationResult} instead.
+ */
 type IcuTranslationResult = {
     translation: string;
     locale: string;
@@ -113,6 +350,9 @@ type IcuTranslationResult = {
         key: string;
     };
 };
+/**
+ * @deprecated Use {@link TranslationResult} instead.
+ */
 type JsxTranslationResult = {
     translation: JsxChildren;
     locale: string;
@@ -121,24 +361,19 @@ type JsxTranslationResult = {
         key: string;
     };
 };
-type TranslationError = {
-    error: string;
-    code: number;
-    reference?: {
-        id: string;
-        key: string;
-    };
-};
 
-type VariableType = 'v' | 'n' | 'd' | 'c';
 /**
- * Variables are used to store the variable name and type.
+ * TranslationRequestConfig is used to configure the translation request.
+ *
+ * @param projectId - The project id of the translation request.
+ * @param baseUrl - The base url of the translation request.
+ * @param apiKey - The api key of the translation request.
  */
-type Variable = {
-    k: string;
-    i?: number;
-    v?: VariableType;
+type TranslationRequestConfig = {
+    projectId: string;
+    baseUrl?: string;
+    apiKey?: string;
 };
 
 export { HTML_CONTENT_PROPS };
-export type { Content, ContentTranslationResult, CustomMapping, DataFormat, FormatVariables, GTProp, HtmlContentPropKeysRecord, HtmlContentPropValuesRecord, IcuTranslationResult, JsxChild, JsxChildren, JsxElement, JsxTranslationResult, LocaleProperties, Metadata, Request, Transformation, TransformationPrefix, TranslationError, Update, Variable, VariableTransformationSuffix, VariableType };
+export type { CheckFileTranslationsOptions, CheckFileTranslationsResult, CompletedFileTranslationData, Content, ContentTranslationResult, CustomMapping, DataFormat, DownloadFileBatchOptions, DownloadFileBatchResult, DownloadFileOptions, EnqueueEntriesOptions, EnqueueEntriesResult, EnqueueFilesOptions, EnqueueFilesResult, Entry, ActionType as EntryActionType, EntryMetadata, FetchTranslationsOptions, FetchTranslationsResult, FileFormat, FileToTranslate, FileTranslationQuery, FormatVariables, GTProp, HtmlContentPropKeysRecord, HtmlContentPropValuesRecord, I18nextMessage, IcuMessage, IcuTranslationResult, JsxChild, JsxChildren, JsxElement, JsxTranslationResult, LocaleProperties, Metadata, Request, RetrievedTranslations, Transformation, TransformationPrefix, TranslateManyResult, TranslationError, TranslationRequestConfig, TranslationResult, TranslationResultReference, TranslationStatusResult, Update, Updates, Variable, VariableTransformationSuffix, VariableType, _Content };

package/dist/types.esm.min.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.esm.min.mjs","sources":["../src/types.ts"],"sourcesContent":["import { LocaleProperties } from './locales/getLocaleProperties';\n\nexport { LocaleProperties };\n\nexport type Content = string | Array<string | Variable>;\n\n/**\n * Map of data-_gt properties to their corresponding React props\n */\nexport const HTML_CONTENT_PROPS = {\n  pl: 'placeholder',\n  ti: 'title',\n  alt: 'alt',\n  arl: 'aria-label',\n  arb: 'aria-labelledby',\n  ard: 'aria-describedby',\n} as const;\n\nexport type HtmlContentPropKeysRecord = Partial<\n  Record<keyof typeof HTML_CONTENT_PROPS, string>\n>;\nexport type HtmlContentPropValuesRecord = Partial<\n  Record<(typeof HTML_CONTENT_PROPS)[keyof typeof HTML_CONTENT_PROPS], string>\n>;\n\n/**\n * Transformations are made from a prefix and a suffix.\n */\nexport type Transformation =\n  | 'translate-client'\n  | 'translate-server'\n  | 'variable-variable'\n  | 'variable-currency'\n  | 'variable-datetime'\n  | 'variable-number'\n  | 'plural'\n  | 'branch';\nexport type TransformationPrefix =\n  | 'translate'\n  | 'variable'\n  | 'plural'\n  | 'branch'\n  | 'fragment';\nexport type VariableTransformationSuffix =\n  | 'variable'\n  | 'number'\n  | 'datetime'\n  | 'currency';\n\n/**\n * GTProp is an internal property used to contain data for translating and rendering elements.\n * note, transformations are only read on the server side if they are 'plural' or 'branch'\n */\nexport type GTProp = {\n  b?: Record<string, JsxChildren>; // Branches\n  t?: 'p' | 'b'; // Branch Transformation\n} & HtmlContentPropKeysRecord;\n\nexport type JsxElement = {\n  t?: string; // tag name\n  i?: number; // id\n  d?: GTProp; // GT data\n  c?: JsxChildren; // children\n};\n\nexport type JsxChild = string | JsxElement | Variable;\nexport type JsxChildren = JsxChild | JsxChild[];\n\nexport type Metadata = {\n  context?: string;\n  id?: string;\n  sourceLocale?: string;\n  actionType?: 'standard' | 'fast' | string;\n  [key: string]: any;\n};\n\nexport type DataFormat = 'JSX' | 'ICU' | 'I18NEXT';\n\nexport type FormatVariables = Record<\n  string,\n  string | number | boolean | null | undefined | Date\n>;\n\nexport type Update =\n  | {\n      type: 'content';\n      data: {\n        source: Content;\n        metadata: Metadata;\n      };\n    }\n  | {\n      type: 'jsx';\n      data: {\n        source: JsxChildren;\n        metadata: Metadata;\n      };\n    };\n\nexport type Request =\n  | {\n      type: 'content';\n      data: {\n        source: Content;\n        targetLocale: string;\n        metadata: Metadata;\n      };\n    }\n  | {\n      type: 'jsx';\n      data: {\n        source: JsxChildren;\n        targetLocale: string;\n        metadata: Metadata;\n      };\n    };\n\nexport type ContentTranslationResult = {\n  translation: Content;\n  locale: string;\n  reference?: {\n    id: string;\n    key: string;\n  };\n};\n\nexport type IcuTranslationResult = {\n  translation: string;\n  locale: string;\n  reference?: {\n    id: string;\n    key: string;\n  };\n};\n\nexport type JsxTranslationResult = {\n  translation: JsxChildren;\n  locale: string;\n  reference?: {\n    id: string;\n    key: string;\n  };\n};\n\nexport type TranslationError = {\n  error: string;\n  code: number;\n  reference?: {\n    id: string;\n    key: string;\n  };\n};\n\nexport type { CustomMapping } from './locales/customLocaleMapping';\n\n// ----- VARIABLES ----- //\n\nexport type VariableType =\n  | 'v' // Variable\n  | 'n' // Number\n  | 'd' // Date\n  | 'c'; // Currency\n\n/**\n * Variables are used to store the variable name and type.\n */\nexport type Variable = {\n  k: string;\n  i?: number;\n  v?: VariableType;\n};\n"],"names":["HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard"],"mappings":"AASa,IAAAA,EAAqB,CAChCC,GAAI,cACJC,GAAI,QACJC,IAAK,MACLC,IAAK,aACLC,IAAK,kBACLC,IAAK"}
+{"version":3,"file":"types.esm.min.mjs","sources":["../src/types-dir/content.ts"],"sourcesContent":["import { Variable } from './variables';\n\n/**\n * Map of data-_gt properties to their corresponding React props\n */\nexport const HTML_CONTENT_PROPS = {\n  pl: 'placeholder',\n  ti: 'title',\n  alt: 'alt',\n  arl: 'aria-label',\n  arb: 'aria-labelledby',\n  ard: 'aria-describedby',\n} as const;\n\nexport type HtmlContentPropKeysRecord = Partial<\n  Record<keyof typeof HTML_CONTENT_PROPS, string>\n>;\nexport type HtmlContentPropValuesRecord = Partial<\n  Record<(typeof HTML_CONTENT_PROPS)[keyof typeof HTML_CONTENT_PROPS], string>\n>;\n\n/**\n * GTProp is an internal property used to contain data for translating and rendering elements.\n * note, transformations are only read on the server side if they are 'plural' or 'branch'\n */\nexport type GTProp = {\n  b?: Record<string, JsxChildren>; // Branches\n  t?: 'p' | 'b'; // Branch Transformation\n} & HtmlContentPropKeysRecord;\n\nexport type JsxElement = {\n  t?: string; // tag name\n  i?: number; // id\n  d?: GTProp; // GT data\n  c?: JsxChildren; // children\n};\n\nexport type JsxChild = string | JsxElement | Variable;\n\n/**\n * The format of the content\n */\nexport type DataFormat = 'JSX' | 'ICU' | 'I18NEXT';\n\n/**\n * A content type representing JSX, ICU, and I18next messages\n */\nexport type Content = JsxChildren | IcuMessage | I18nextMessage;\n\n/**\n * A content type representing JSX elements\n */\nexport type JsxChildren = JsxChild | JsxChild[];\n\n/**\n * A content type representing ICU messages\n */\nexport type IcuMessage = string;\n\n/**\n * A content type representing I18next messages\n */\nexport type I18nextMessage = string;\n"],"names":["HTML_CONTENT_PROPS","pl","ti","alt","arl","arb","ard"],"mappings":"AAKa,IAAAA,EAAqB,CAChCC,GAAI,cACJC,GAAI,QACJC,IAAK,MACLC,IAAK,aACLC,IAAK,kBACLC,IAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generaltranslation",
-  "version": "7.0.0",
+  "version": "7.1.0-alpha.0",
   "description": "A language toolkit for AI developers",
   "main": "dist/index.cjs.min.cjs",
   "module": "dist/index.esm.min.mjs",
@@ -13,10 +13,10 @@
     "build:release": "npm run build:clean",
     "build:clean": "rm -rf dist; npm run build",
     "build": "rollup -c",
-    "lint": "eslint \"src/**/*.{js,ts}\" \"__tests__/**/*.{js,ts}\"",
-    "lint:fix": "eslint \"src/**/*.{js,ts}\" \"__tests__/**/*.{js,ts}\" --fix",
-    "test": "vitest run",
-    "test:watch": "vitest",
+    "lint": "eslint \"src/**/*.{js,ts}\" \"./__e2e__/**/*.{js,ts}\" \"./**/__tests__/**/*.{js,ts}\"",
+    "lint:fix": "eslint \"src/**/*.{js,ts}\" \"./__e2e__/**/*.{js,ts}\" \"./**/__tests__/**/*.{js,ts}\" --fix",
+    "test": "vitest run --config=./vitest.config.ts",
+    "test:watch": "vitest --config=./vitest.config.ts",
     "release": "npm run build:clean && npm publish",
     "release:alpha": "npm run build:clean && npm publish --tag alpha",
     "release:beta": "npm run build:clean && npm publish --tag beta",

package/dist/settings/errors.d.ts

@@ -1,4 +0,0 @@
-export declare const noTargetLocaleProvidedError: (functionName: string) => string;
-export declare const noSourceLocaleProvidedError: (functionName: string) => string;
-export declare const invalidLocaleError: (locale: string) => string;
-export declare const invalidLocalesError: (locales: string[]) => string;