@let-value/translate-extract 1.0.30 → 1.1.0

package/dist/core-DR3oxhSq.js

@@ -0,0 +1,59 @@
+import { cleanup, core, po } from "./static-DQHT7uqP.js";
+import { basename, dirname, extname, join } from "node:path";
+
+//#region src/configuration.ts
+const defaultPlugins = {
+	core,
+	po,
+	cleanup
+};
+const defaultDestination = ({ entrypoint, locale }) => join(dirname(entrypoint), "translations", `${basename(entrypoint, extname(entrypoint))}.${locale}.po`);
+const defaultExclude = [
+	/(?:^|[\\/])node_modules(?:[\\/]|$)/,
+	/(?:^|[\\/])dist(?:[\\/]|$)/,
+	/(?:^|[\\/])build(?:[\\/]|$)/
+];
+function normalizeExclude(exclude) {
+	if (!exclude) return [];
+	return Array.isArray(exclude) ? exclude : [exclude];
+}
+function resolveEntrypoint(ep) {
+	if (typeof ep === "string") return { entrypoint: ep };
+	const { entrypoint, destination, obsolete, walk, exclude } = ep;
+	return {
+		entrypoint,
+		destination,
+		obsolete,
+		walk,
+		exclude: exclude ? normalizeExclude(exclude) : void 0
+	};
+}
+function resolvePlugins(user) {
+	if (typeof user === "function") return user(defaultPlugins);
+	if (Array.isArray(user)) return [...Object.values(defaultPlugins).map((plugin) => plugin()), ...user];
+	return Object.values(defaultPlugins).map((plugin) => plugin());
+}
+/**
+* Type helper to make it easier to use translate.config.ts
+* @param config - {@link UserConfig}.
+*/
+function defineConfig(config) {
+	const defaultLocale = config.defaultLocale ?? "en";
+	const plugins = resolvePlugins(config.plugins);
+	const entrypoints = (Array.isArray(config.entrypoints) ? config.entrypoints : [config.entrypoints]).map(resolveEntrypoint);
+	return {
+		plugins,
+		entrypoints,
+		defaultLocale,
+		locales: config.locales ?? [defaultLocale],
+		destination: config.destination ?? defaultDestination,
+		obsolete: config.obsolete ?? "mark",
+		walk: config.walk ?? true,
+		logLevel: config.logLevel ?? "info",
+		exclude: config.exclude ? normalizeExclude(config.exclude) : defaultExclude
+	};
+}
+
+//#endregion
+export { defineConfig };
+//# sourceMappingURL=core-DR3oxhSq.js.map

package/dist/core-DR3oxhSq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-DR3oxhSq.js","names":["defaultDestination: DestinationFn","defaultExclude: Exclude[]"],"sources":["../src/configuration.ts"],"sourcesContent":["import { basename, dirname, extname, join } from \"node:path\";\nimport type { PluralFormsLocale } from \"@let-value/translate\";\nimport type { LogLevel } from \"./logger.ts\";\n\nimport type { UniversalPlugin } from \"./plugin.ts\";\nimport { cleanup, core, po } from \"./static.ts\";\n\nexport type DestinationFn = (args: { locale: string; entrypoint: string; path: string }) => string;\nexport type ExcludeFn = (args: { entrypoint: string; path: string }) => boolean;\nexport type Exclude = RegExp | ExcludeFn;\n\nconst defaultPlugins = { core, po, cleanup };\ntype DefaultPlugins = typeof defaultPlugins;\n\n/**\n * Strategy to handle obsolete translations in existing locale files:\n * - \"mark\": keep obsolete entries in the locale file but mark them as obsolete\n * - \"remove\": remove obsolete entries from the locale file\n */\nexport type ObsoleteStrategy = \"mark\" | \"remove\";\n\nexport interface EntrypointConfig {\n    entrypoint: string;\n    destination?: DestinationFn;\n    obsolete?: ObsoleteStrategy;\n    walk?: boolean;\n    exclude?: Exclude | Exclude[];\n}\n\nexport interface UserConfig {\n    /**\n     * Default locale to use as the base for extraction\n     * @default \"en\"\n     * @see {@link PluralFormsLocale} for available locales\n     */\n    defaultLocale?: PluralFormsLocale;\n    /**\n     * Array of locales to extract translations for\n     * @default [defaultLocale]\n     * @see {@link PluralFormsLocale} for available locales\n     */\n    locales?: PluralFormsLocale[];\n    /**\n     * Array of plugins to use or a function to override the default plugins\n     * @default DefaultPlugins\n     * @see {@link DefaultPlugins} for available plugins\n     */\n    plugins?: UniversalPlugin[] | ((defaultPlugins: DefaultPlugins) => UniversalPlugin[]);\n    /**\n     * One or more entrypoints to extract translations from, could be:\n     * - file path, will be treated as a single file entrypoint\n     * - glob pattern will be expanded to match files, each treated as a separate entrypoint\n     * - configuration object with options for the entrypoint\n     * @see {@link EntrypointConfig} for configuration options\n     */\n    entrypoints: string | EntrypointConfig | Array<string | EntrypointConfig>;\n    /**\n     * Function to determine the destination path for each extracted locale file\n     * @default `./translations/entrypoint.locale.po`\n     * @see {@link DestinationFn}\n     * @see Can be overridden per entrypoint via `destination` in {@link EntrypointConfig\n     */\n    destination?: DestinationFn;\n    /**\n     * Strategy to handle obsolete translations in existing locale files\n     * @default \"mark\"\n     * @see {@link ObsoleteStrategy} for available strategies\n     * @see Can be overridden per entrypoint via `obsolete` in {@link EntrypointConfig\n     */\n    obsolete?: ObsoleteStrategy;\n    /**\n     * Whether to recursively walk dependencies of the entrypoints\n     * @default true\n     * @see Can be overridden per entrypoint via `walk` in {@link EntrypointConfig}.\n     */\n    walk?: boolean;\n    /**\n     * Paths or patterns to exclude from extraction, applied to all entrypoints\n     * @default [/node_modules/, /dist/, /build/]\n     * @see Can be overridden per entrypoint via `exclude` in {@link EntrypointConfig}.\n     */\n    exclude?: Exclude | Exclude[];\n    /**\n     * Log level for the extraction process\n     * @default \"info\"\n     */\n    logLevel?: LogLevel;\n}\n\nexport interface ResolvedEntrypoint extends Omit<EntrypointConfig, \"exclude\"> {\n    exclude?: Exclude[];\n}\n\nexport interface ResolvedConfig {\n    plugins: UniversalPlugin[];\n    entrypoints: ResolvedEntrypoint[];\n    defaultLocale: string;\n    locales: string[];\n    destination: DestinationFn;\n    obsolete: ObsoleteStrategy;\n    walk: boolean;\n    logLevel: LogLevel;\n    exclude: Exclude[];\n}\n\nconst defaultDestination: DestinationFn = ({ entrypoint, locale }) =>\n    join(dirname(entrypoint), \"translations\", `${basename(entrypoint, extname(entrypoint))}.${locale}.po`);\n\nconst defaultExclude: Exclude[] = [\n    /(?:^|[\\\\/])node_modules(?:[\\\\/]|$)/,\n    /(?:^|[\\\\/])dist(?:[\\\\/]|$)/,\n    /(?:^|[\\\\/])build(?:[\\\\/]|$)/,\n];\n\nfunction normalizeExclude(exclude?: Exclude | Exclude[]): Exclude[] {\n    if (!exclude) return [];\n    return Array.isArray(exclude) ? exclude : [exclude];\n}\n\nfunction resolveEntrypoint(ep: string | EntrypointConfig): ResolvedEntrypoint {\n    if (typeof ep === \"string\") {\n        return { entrypoint: ep };\n    }\n    const { entrypoint, destination, obsolete, walk, exclude } = ep;\n    return { entrypoint, destination, obsolete, walk, exclude: exclude ? normalizeExclude(exclude) : undefined };\n}\n\nfunction resolvePlugins(user?: UserConfig[\"plugins\"]): UniversalPlugin[] {\n    if (typeof user === \"function\") {\n        return user(defaultPlugins);\n    }\n    if (Array.isArray(user)) {\n        return [...Object.values(defaultPlugins).map((plugin) => plugin()), ...user];\n    }\n    return Object.values(defaultPlugins).map((plugin) => plugin());\n}\n\n/**\n * Type helper to make it easier to use translate.config.ts\n * @param config - {@link UserConfig}.\n */\nexport function defineConfig(config: UserConfig): ResolvedConfig {\n    const defaultLocale = config.defaultLocale ?? \"en\";\n\n    const plugins = resolvePlugins(config.plugins);\n\n    const raw = Array.isArray(config.entrypoints) ? config.entrypoints : [config.entrypoints];\n    const entrypoints = raw.map(resolveEntrypoint);\n\n    return {\n        plugins,\n        entrypoints,\n        defaultLocale,\n        locales: config.locales ?? [defaultLocale],\n        destination: config.destination ?? defaultDestination,\n        obsolete: config.obsolete ?? \"mark\",\n        walk: config.walk ?? true,\n        logLevel: config.logLevel ?? \"info\",\n        exclude: config.exclude ? normalizeExclude(config.exclude) : defaultExclude,\n    };\n}\n"],"mappings":";;;;AAWA,MAAM,iBAAiB;CAAE;CAAM;CAAI;CAAS;AA8F5C,MAAMA,sBAAqC,EAAE,YAAY,aACrD,KAAK,QAAQ,WAAW,EAAE,gBAAgB,GAAG,SAAS,YAAY,QAAQ,WAAW,CAAC,CAAC,GAAG,OAAO,KAAK;AAE1G,MAAMC,iBAA4B;CAC9B;CACA;CACA;CACH;AAED,SAAS,iBAAiB,SAA0C;AAChE,KAAI,CAAC,QAAS,QAAO,EAAE;AACvB,QAAO,MAAM,QAAQ,QAAQ,GAAG,UAAU,CAAC,QAAQ;;AAGvD,SAAS,kBAAkB,IAAmD;AAC1E,KAAI,OAAO,OAAO,SACd,QAAO,EAAE,YAAY,IAAI;CAE7B,MAAM,EAAE,YAAY,aAAa,UAAU,MAAM,YAAY;AAC7D,QAAO;EAAE;EAAY;EAAa;EAAU;EAAM,SAAS,UAAU,iBAAiB,QAAQ,GAAG;EAAW;;AAGhH,SAAS,eAAe,MAAiD;AACrE,KAAI,OAAO,SAAS,WAChB,QAAO,KAAK,eAAe;AAE/B,KAAI,MAAM,QAAQ,KAAK,CACnB,QAAO,CAAC,GAAG,OAAO,OAAO,eAAe,CAAC,KAAK,WAAW,QAAQ,CAAC,EAAE,GAAG,KAAK;AAEhF,QAAO,OAAO,OAAO,eAAe,CAAC,KAAK,WAAW,QAAQ,CAAC;;;;;;AAOlE,SAAgB,aAAa,QAAoC;CAC7D,MAAM,gBAAgB,OAAO,iBAAiB;CAE9C,MAAM,UAAU,eAAe,OAAO,QAAQ;CAG9C,MAAM,eADM,MAAM,QAAQ,OAAO,YAAY,GAAG,OAAO,cAAc,CAAC,OAAO,YAAY,EACjE,IAAI,kBAAkB;AAE9C,QAAO;EACH;EACA;EACA;EACA,SAAS,OAAO,WAAW,CAAC,cAAc;EAC1C,aAAa,OAAO,eAAe;EACnC,UAAU,OAAO,YAAY;EAC7B,MAAM,OAAO,QAAQ;EACrB,UAAU,OAAO,YAAY;EAC7B,SAAS,OAAO,UAAU,iBAAiB,OAAO,QAAQ,GAAG;EAChE"}