@comvi/next 0.1.0

package/dist/createNextI18n.cjs

@@ -0,0 +1,153 @@
+require("./_virtual/_rolldown/runtime.cjs");
+const require_defineRouting = require("./routing/defineRouting.cjs");
+let _comvi_core = require("@comvi/core");
+//#region src/createNextI18n.ts
+var resolveLazyPlugin = (moduleOrPlugin) => {
+	if (typeof moduleOrPlugin === "function") return moduleOrPlugin;
+	if (moduleOrPlugin && typeof moduleOrPlugin.default === "function") return moduleOrPlugin.default;
+	throw new Error("[comvi/next] Invalid lazy plugin module. Expected a plugin function or { default: pluginFunction }.");
+};
+var isClientRuntime = () => {
+	if (process.env.NEXT_RUNTIME) return false;
+	return typeof window !== "undefined";
+};
+var shouldRunForRuntime = (runtime) => {
+	const isClient = isClientRuntime();
+	return runtime === "client" ? isClient : !isClient;
+};
+var shouldRunForEnvironment = (environment) => {
+	if (environment === "all") return true;
+	return environment === (process.env.NODE_ENV === "production" ? "production" : "development");
+};
+var createScopedPlugin = (plugin, runtime, environment) => {
+	return (i18n) => {
+		if (!shouldRunForRuntime(runtime) || !shouldRunForEnvironment(environment)) return;
+		return plugin(i18n);
+	};
+};
+var createScopedLazyPlugin = (loadPlugin, runtime, environment) => {
+	let pluginPromise = null;
+	return (i18n) => {
+		if (!shouldRunForRuntime(runtime) || !shouldRunForEnvironment(environment)) return;
+		if (!pluginPromise) pluginPromise = loadPlugin().then(resolveLazyPlugin);
+		return pluginPromise.then((plugin) => plugin(i18n));
+	};
+};
+var normalizeScopedOptions = (options) => {
+	const { environment = "all", ...pluginOptions } = options ?? {};
+	return {
+		environment,
+		pluginOptions
+	};
+};
+/**
+* Create a fully configured Next.js i18n setup with a single function call.
+*
+* This factory creates:
+* - i18n instance
+* - Routing configuration for middleware and navigation
+*
+* @example
+* ```typescript
+* // i18n/config.ts
+* import { createNextI18n } from "@comvi/next";
+*
+* export const { i18n, routing } = createNextI18n({
+*   // Routing
+*   locales: ["en", "de", "uk"],
+*   defaultLocale: "en",
+*
+*   // Optional
+*   basicHtmlTags: ["strong", "em", "br", "a"],
+* });
+* ```
+*
+* @example
+* ```typescript
+* // Optional plugin registration (same DX as core/react)
+* import { FetchLoader } from "@comvi/plugin-fetch-loader";
+*
+* const nextI18n = createNextI18n({
+*   locales: ["en", "de"],
+*   defaultLocale: "en",
+* })
+*   .use(
+*     FetchLoader({
+*       cdnUrl: "https://cdn.comvi.io/your-distribution-id",
+*       loadOnInit: false,
+*     }),
+*   )
+*   .useServer(MyServerPlugin())
+*   .useClientLazy(
+*     () => import("@comvi/plugin-in-context-editor").then((m) => m.InContextEditorPlugin()),
+*     { environment: "development", required: false },
+*   )
+*   .use(MyPlugin())
+*   .use(AnotherPlugin(), { required: false });
+*
+* export const { i18n, routing } = nextI18n;
+* ```
+*
+* @example
+* ```typescript
+* // i18n/server.ts - Server entry point
+* import "server-only";
+* import { setI18n } from "@comvi/next/server";
+* import { i18n } from "./config";
+*
+* setI18n(i18n);
+*
+* export { i18n, routing } from "./config";
+* export { getI18n, loadTranslations } from "@comvi/next/server";
+* ```
+*/
+function createNextI18n(options) {
+	const { locales, defaultLocale, localePrefix = "as-needed", pathnames, apiKey, ns, translation, fallbackLocale = defaultLocale, defaultNs = "default", devMode: devModeOption, basicHtmlTags, onMissingKey } = options;
+	const i18n = (0, _comvi_core.createI18n)({
+		locale: defaultLocale,
+		fallbackLocale,
+		defaultNs,
+		ns,
+		translation,
+		apiKey,
+		devMode: devModeOption ?? process.env.NODE_ENV === "development",
+		onMissingKey,
+		tagInterpolation: basicHtmlTags ? { basicHtmlTags } : void 0
+	});
+	const result = {
+		i18n,
+		routing: require_defineRouting.defineRouting({
+			locales,
+			defaultLocale,
+			localePrefix,
+			pathnames
+		}),
+		use(plugin, pluginOptions) {
+			i18n.use(plugin, pluginOptions);
+			return result;
+		},
+		useClient(plugin, options) {
+			const { environment, pluginOptions } = normalizeScopedOptions(options);
+			i18n.use(createScopedPlugin(plugin, "client", environment), pluginOptions);
+			return result;
+		},
+		useServer(plugin, options) {
+			const { environment, pluginOptions } = normalizeScopedOptions(options);
+			i18n.use(createScopedPlugin(plugin, "server", environment), pluginOptions);
+			return result;
+		},
+		useClientLazy(loadPlugin, options) {
+			const { environment, pluginOptions } = normalizeScopedOptions(options);
+			i18n.use(createScopedLazyPlugin(loadPlugin, "client", environment), pluginOptions);
+			return result;
+		},
+		useServerLazy(loadPlugin, options) {
+			const { environment, pluginOptions } = normalizeScopedOptions(options);
+			i18n.use(createScopedLazyPlugin(loadPlugin, "server", environment), pluginOptions);
+			return result;
+		}
+	};
+	return result;
+}
+//#endregion
+exports.createNextI18n = createNextI18n;

package/dist/createNextI18n.d.ts

@@ -0,0 +1,183 @@
+import { I18nOptions, I18n, I18nPlugin, PluginOptions } from '@comvi/core';
+import { RoutingConfig, LocalePrefixMode } from './routing/types';
+type PluginEnvironment = "all" | "development" | "production";
+export interface ScopedPluginOptions extends PluginOptions {
+    /**
+     * Environment where plugin should run.
+     * @default "all"
+     */
+    environment?: PluginEnvironment;
+}
+export type LazyPluginModule = I18nPlugin | {
+    default: I18nPlugin;
+};
+export type LazyPluginLoader = () => Promise<LazyPluginModule>;
+/**
+ * Options for createNextI18n factory
+ */
+export interface CreateNextI18nOptions {
+    /**
+     * List of supported locales
+     * @example ['en', 'de', 'uk', 'fr']
+     */
+    locales: string[];
+    /**
+     * Default locale (used when no locale is detected)
+     * @example 'en'
+     */
+    defaultLocale: string;
+    /**
+     * Locale prefix mode for URLs
+     * - 'always': Always include locale in URL (/en/about, /de/about)
+     * - 'as-needed': Only include for non-default locales (/about, /de/about)
+     * - 'never': Never include locale in URL (use cookies/headers)
+     * @default 'as-needed'
+     */
+    localePrefix?: LocalePrefixMode;
+    /**
+     * Localized public pathnames for exact static routes.
+     * Keys are canonical internal routes, values are public localized slugs.
+     */
+    pathnames?: RoutingConfig["pathnames"];
+    /**
+     * API key available to plugins/loaders that need authenticated requests.
+     */
+    apiKey?: string;
+    /**
+     * Namespaces to load during init.
+     * If omitted, only default namespace is loaded.
+     */
+    ns?: I18nOptions["ns"];
+    /**
+     * Static translations to seed i18n cache (no loader required).
+     */
+    translation?: I18nOptions["translation"];
+    /**
+     * Fallback locale when translation is missing
+     * @default same as defaultLocale
+     */
+    fallbackLocale?: string | string[];
+    /**
+     * Default namespace for translations
+     * @default 'default'
+     */
+    defaultNs?: string;
+    /**
+     * Development mode (uses API instead of CDN)
+     * @default process.env.NODE_ENV === 'development'
+     */
+    devMode?: boolean;
+    /**
+     * HTML tags allowed in translations (for tag interpolation)
+     * @example ['strong', 'em', 'br', 'a']
+     */
+    basicHtmlTags?: string[];
+    /**
+     * Callback for missing translation keys
+     */
+    onMissingKey?: I18nOptions["onMissingKey"];
+}
+/**
+ * Result of createNextI18n factory
+ */
+export interface CreateNextI18nResult {
+    /**
+     * The i18n instance (use with I18nProvider and setI18n)
+     */
+    i18n: I18n;
+    /**
+     * Routing configuration (use with middleware and navigation)
+     */
+    routing: Required<RoutingConfig>;
+    /**
+     * Register an additional i18n plugin (chainable).
+     *
+     * @example
+     * ```typescript
+     * const nextI18n = createNextI18n({...})
+     *   .use(MyPlugin())
+     *   .use(AnotherPlugin(), { required: false });
+     * ```
+     */
+    use(plugin: I18nPlugin, options?: PluginOptions): CreateNextI18nResult;
+    /**
+     * Register a client-only plugin.
+     */
+    useClient(plugin: I18nPlugin, options?: ScopedPluginOptions): CreateNextI18nResult;
+    /**
+     * Register a server-only plugin.
+     */
+    useServer(plugin: I18nPlugin, options?: ScopedPluginOptions): CreateNextI18nResult;
+    /**
+     * Register a lazily imported client-only plugin.
+     */
+    useClientLazy(loadPlugin: LazyPluginLoader, options?: ScopedPluginOptions): CreateNextI18nResult;
+    /**
+     * Register a lazily imported server-only plugin.
+     */
+    useServerLazy(loadPlugin: LazyPluginLoader, options?: ScopedPluginOptions): CreateNextI18nResult;
+}
+/**
+ * Create a fully configured Next.js i18n setup with a single function call.
+ *
+ * This factory creates:
+ * - i18n instance
+ * - Routing configuration for middleware and navigation
+ *
+ * @example
+ * ```typescript
+ * // i18n/config.ts
+ * import { createNextI18n } from "@comvi/next";
+ *
+ * export const { i18n, routing } = createNextI18n({
+ *   // Routing
+ *   locales: ["en", "de", "uk"],
+ *   defaultLocale: "en",
+ *
+ *   // Optional
+ *   basicHtmlTags: ["strong", "em", "br", "a"],
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Optional plugin registration (same DX as core/react)
+ * import { FetchLoader } from "@comvi/plugin-fetch-loader";
+ *
+ * const nextI18n = createNextI18n({
+ *   locales: ["en", "de"],
+ *   defaultLocale: "en",
+ * })
+ *   .use(
+ *     FetchLoader({
+ *       cdnUrl: "https://cdn.comvi.io/your-distribution-id",
+ *       loadOnInit: false,
+ *     }),
+ *   )
+ *   .useServer(MyServerPlugin())
+ *   .useClientLazy(
+ *     () => import("@comvi/plugin-in-context-editor").then((m) => m.InContextEditorPlugin()),
+ *     { environment: "development", required: false },
+ *   )
+ *   .use(MyPlugin())
+ *   .use(AnotherPlugin(), { required: false });
+ *
+ * export const { i18n, routing } = nextI18n;
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // i18n/server.ts - Server entry point
+ * import "server-only";
+ * import { setI18n } from "@comvi/next/server";
+ * import { i18n } from "./config";
+ *
+ * setI18n(i18n);
+ *
+ * export { i18n, routing } from "./config";
+ * export { getI18n, loadTranslations } from "@comvi/next/server";
+ * ```
+ */
+export declare function createNextI18n(options: CreateNextI18nOptions): CreateNextI18nResult;
+export {};
+//# sourceMappingURL=createNextI18n.d.ts.map

package/dist/createNextI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNextI18n.d.ts","sourceRoot":"","sources":["../src/createNextI18n.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGvE,KAAK,iBAAiB,GAAG,KAAK,GAAG,aAAa,GAAG,YAAY,CAAC;AAI9D,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAwE/D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAKpC;;;OAGG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAMvC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IAEzC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEnC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAEjC;;;;;;;;;OASG;IACH,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,oBAAoB,CAAC;IAEvE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;IAEnF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;IAEnF;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;IAEjG;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;CAClG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CA0EnF"}

package/dist/createNextI18n.js

@@ -0,0 +1,152 @@
+import { defineRouting } from "./routing/defineRouting.js";
+import { createI18n } from "@comvi/core";
+//#region src/createNextI18n.ts
+var resolveLazyPlugin = (moduleOrPlugin) => {
+	if (typeof moduleOrPlugin === "function") return moduleOrPlugin;
+	if (moduleOrPlugin && typeof moduleOrPlugin.default === "function") return moduleOrPlugin.default;
+	throw new Error("[comvi/next] Invalid lazy plugin module. Expected a plugin function or { default: pluginFunction }.");
+};
+var isClientRuntime = () => {
+	if (process.env.NEXT_RUNTIME) return false;
+	return typeof window !== "undefined";
+};
+var shouldRunForRuntime = (runtime) => {
+	const isClient = isClientRuntime();
+	return runtime === "client" ? isClient : !isClient;
+};
+var shouldRunForEnvironment = (environment) => {
+	if (environment === "all") return true;
+	return environment === (process.env.NODE_ENV === "production" ? "production" : "development");
+};
+var createScopedPlugin = (plugin, runtime, environment) => {
+	return (i18n) => {
+		if (!shouldRunForRuntime(runtime) || !shouldRunForEnvironment(environment)) return;
+		return plugin(i18n);
+	};
+};
+var createScopedLazyPlugin = (loadPlugin, runtime, environment) => {
+	let pluginPromise = null;
+	return (i18n) => {
+		if (!shouldRunForRuntime(runtime) || !shouldRunForEnvironment(environment)) return;
+		if (!pluginPromise) pluginPromise = loadPlugin().then(resolveLazyPlugin);
+		return pluginPromise.then((plugin) => plugin(i18n));
+	};
+};
+var normalizeScopedOptions = (options) => {
+	const { environment = "all", ...pluginOptions } = options ?? {};
+	return {
+		environment,
+		pluginOptions
+	};
+};
+/**
+* Create a fully configured Next.js i18n setup with a single function call.
+*
+* This factory creates:
+* - i18n instance
+* - Routing configuration for middleware and navigation
+*
+* @example
+* ```typescript
+* // i18n/config.ts
+* import { createNextI18n } from "@comvi/next";
+*
+* export const { i18n, routing } = createNextI18n({
+*   // Routing
+*   locales: ["en", "de", "uk"],
+*   defaultLocale: "en",
+*
+*   // Optional
+*   basicHtmlTags: ["strong", "em", "br", "a"],
+* });
+* ```
+*
+* @example
+* ```typescript
+* // Optional plugin registration (same DX as core/react)
+* import { FetchLoader } from "@comvi/plugin-fetch-loader";
+*
+* const nextI18n = createNextI18n({
+*   locales: ["en", "de"],
+*   defaultLocale: "en",
+* })
+*   .use(
+*     FetchLoader({
+*       cdnUrl: "https://cdn.comvi.io/your-distribution-id",
+*       loadOnInit: false,
+*     }),
+*   )
+*   .useServer(MyServerPlugin())
+*   .useClientLazy(
+*     () => import("@comvi/plugin-in-context-editor").then((m) => m.InContextEditorPlugin()),
+*     { environment: "development", required: false },
+*   )
+*   .use(MyPlugin())
+*   .use(AnotherPlugin(), { required: false });
+*
+* export const { i18n, routing } = nextI18n;
+* ```
+*
+* @example
+* ```typescript
+* // i18n/server.ts - Server entry point
+* import "server-only";
+* import { setI18n } from "@comvi/next/server";
+* import { i18n } from "./config";
+*
+* setI18n(i18n);
+*
+* export { i18n, routing } from "./config";
+* export { getI18n, loadTranslations } from "@comvi/next/server";
+* ```
+*/
+function createNextI18n(options) {
+	const { locales, defaultLocale, localePrefix = "as-needed", pathnames, apiKey, ns, translation, fallbackLocale = defaultLocale, defaultNs = "default", devMode: devModeOption, basicHtmlTags, onMissingKey } = options;
+	const i18n = createI18n({
+		locale: defaultLocale,
+		fallbackLocale,
+		defaultNs,
+		ns,
+		translation,
+		apiKey,
+		devMode: devModeOption ?? process.env.NODE_ENV === "development",
+		onMissingKey,
+		tagInterpolation: basicHtmlTags ? { basicHtmlTags } : void 0
+	});
+	const result = {
+		i18n,
+		routing: defineRouting({
+			locales,
+			defaultLocale,
+			localePrefix,
+			pathnames
+		}),
+		use(plugin, pluginOptions) {
+			i18n.use(plugin, pluginOptions);
+			return result;
+		},
+		useClient(plugin, options) {
+			const { environment, pluginOptions } = normalizeScopedOptions(options);
+			i18n.use(createScopedPlugin(plugin, "client", environment), pluginOptions);
+			return result;
+		},
+		useServer(plugin, options) {
+			const { environment, pluginOptions } = normalizeScopedOptions(options);
+			i18n.use(createScopedPlugin(plugin, "server", environment), pluginOptions);
+			return result;
+		},
+		useClientLazy(loadPlugin, options) {
+			const { environment, pluginOptions } = normalizeScopedOptions(options);
+			i18n.use(createScopedLazyPlugin(loadPlugin, "client", environment), pluginOptions);
+			return result;
+		},
+		useServerLazy(loadPlugin, options) {
+			const { environment, pluginOptions } = normalizeScopedOptions(options);
+			i18n.use(createScopedLazyPlugin(loadPlugin, "server", environment), pluginOptions);
+			return result;
+		}
+	};
+	return result;
+}
+//#endregion
+export { createNextI18n };

package/dist/index.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./_virtual/_rolldown/runtime.cjs");
+const require_createNextI18n = require("./createNextI18n.cjs");
+let _comvi_core = require("@comvi/core");
+Object.defineProperty(exports, "I18n", {
+	enumerable: true,
+	get: function() {
+		return _comvi_core.I18n;
+	}
+});
+Object.defineProperty(exports, "createI18n", {
+	enumerable: true,
+	get: function() {
+		return _comvi_core.createI18n;
+	}
+});
+exports.createNextI18n = require_createNextI18n.createNextI18n;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createI18n, I18n } from '@comvi/core';
+export type * from '@comvi/core';
+export { createNextI18n } from './createNextI18n';
+export type { CreateNextI18nOptions, CreateNextI18nResult } from './createNextI18n';
+export type { RoutingConfig, LocalePrefixMode } from './routing/types';
+export type { MiddlewareConfig } from './middleware/types';
+export type { GetI18nOptions } from './server/types';
+export type { I18nProviderProps } from './client/I18nProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC/C,mBAAmB,aAAa,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGpF,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+import { createNextI18n } from "./createNextI18n.js";
+import { I18n, createI18n } from "@comvi/core";
+export { I18n, createI18n, createNextI18n };