@18ways/mdx-translate 0.1.0-alpha.185b0ef4fee2

package/dist/code-samples.d.ts

@@ -0,0 +1,2 @@
+export declare const transformCodeSample: (_source: string, _language: string | null | undefined, _options: unknown) => string | null;
+//# sourceMappingURL=code-samples.d.ts.map

package/dist/code-samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-samples.d.ts","sourceRoot":"","sources":["../src/code-samples.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,EACf,WAAW,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,UAAU,OAAO,KAChB,MAAM,GAAG,IAEX,CAAC"}

package/dist/code-samples.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformCodeSample = void 0;
+const transformCodeSample = (_source, _language, _options) => {
+    return null;
+};
+exports.transformCodeSample = transformCodeSample;
+//# sourceMappingURL=code-samples.js.map

package/dist/code-samples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-samples.js","sourceRoot":"","sources":["../src/code-samples.ts"],"names":[],"mappings":";;;AAAO,MAAM,mBAAmB,GAAG,CACjC,OAAe,EACf,SAAoC,EACpC,QAAiB,EACF,EAAE;IACjB,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { Root } from 'mdast';
+type IncludedPath = RegExp | ((filePath: string) => boolean);
+export interface RemarkMdxTranslateOptions {
+    include?: IncludedPath;
+    exclude?: IncludedPath;
+    attributeNames?: string[];
+    translationComponentName?: string;
+    translatedNodeComponentName?: string;
+    translateHookName?: string;
+    reactImportSource?: string;
+    runtimeImportSource?: string;
+}
+export declare function remarkMdxTranslate(userOptions?: RemarkMdxTranslateOptions): (tree: Root, file?: {
+    path?: string;
+}) => void;
+export {};
+//# 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":"AAAA,OAAO,KAAK,EACV,IAAI,EAUL,MAAM,OAAO,CAAC;AAyDf,KAAK,YAAY,GAAG,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAubD,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,yBAA8B,IAcpE,MAAM,IAAI,EAAE,OAAO;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,UA8I7C"}

package/dist/index.js

@@ -0,0 +1,392 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remarkMdxTranslate = remarkMdxTranslate;
+const code_samples_1 = require("./code-samples");
+const DEFAULT_ATTRIBUTE_NAMES = ['alt', 'title', 'aria-label', 'placeholder'];
+const DEFAULT_REACT_IMPORT_SOURCE = '@18ways/react';
+const DEFAULT_RUNTIME_IMPORT_SOURCE = '@18ways/mdx-translate/runtime';
+const DEFAULT_TRANSLATION_COMPONENT_NAME = 'T';
+const DEFAULT_TRANSLATED_NODE_COMPONENT_NAME = 'TranslatedNode';
+const DEFAULT_TRANSLATE_HOOK_NAME = 'useT';
+const createLiteral = (value) => ({
+    type: 'Literal',
+    value,
+});
+const createIdentifier = (name) => ({
+    type: 'Identifier',
+    name,
+});
+const createExpressionStatement = (expression) => ({
+    type: 'ExpressionStatement',
+    expression,
+});
+const createArrayExpression = (items) => ({
+    type: 'ArrayExpression',
+    elements: items.map((item) => createLiteral(item)),
+});
+const createExpressionAttribute = (name, value, expression) => ({
+    type: 'mdxJsxAttribute',
+    name,
+    value: {
+        type: 'mdxJsxAttributeValueExpression',
+        value,
+        data: {
+            estree: {
+                type: 'Program',
+                sourceType: 'module',
+                body: [createExpressionStatement(expression)],
+            },
+        },
+    },
+});
+const createImportSpecifier = (name) => ({
+    type: 'ImportSpecifier',
+    imported: createIdentifier(name),
+    local: createIdentifier(name),
+});
+const createDefaultImportSpecifier = (name) => ({
+    type: 'ImportDefaultSpecifier',
+    local: createIdentifier(name),
+});
+const createImportDeclaration = (source, names) => ({
+    type: 'ImportDeclaration',
+    source: createLiteral(source),
+    specifiers: names.map(createImportSpecifier),
+    attributes: [],
+});
+const createImportNode = (source, names) => ({
+    type: 'mdxjsEsm',
+    data: {
+        estree: {
+            type: 'Program',
+            sourceType: 'module',
+            body: [createImportDeclaration(source, names)],
+        },
+    },
+});
+const createDefaultImportNode = (source, localName) => ({
+    type: 'mdxjsEsm',
+    data: {
+        estree: {
+            type: 'Program',
+            sourceType: 'module',
+            body: [
+                {
+                    type: 'ImportDeclaration',
+                    source: createLiteral(source),
+                    specifiers: [createDefaultImportSpecifier(localName)],
+                    attributes: [],
+                },
+            ],
+        },
+    },
+});
+const matchesPath = (matcher, filePath) => {
+    if (!matcher) {
+        return true;
+    }
+    if (matcher instanceof RegExp) {
+        return matcher.test(filePath);
+    }
+    return matcher(filePath);
+};
+const shouldProcessFile = (filePath, options) => {
+    if (!filePath) {
+        return true;
+    }
+    if (options.exclude && matchesPath(options.exclude, filePath)) {
+        return false;
+    }
+    return matchesPath(options.include, filePath);
+};
+const isParent = (node) => Boolean(node && typeof node === 'object' && 'children' in node);
+const visitTree = (node, visitor, parent = null, index = null) => {
+    visitor(node, parent, index);
+    if (!isParent(node) || !Array.isArray(node.children)) {
+        return;
+    }
+    for (let childIndex = 0; childIndex < node.children.length; childIndex += 1) {
+        const child = node.children[childIndex];
+        visitTree(child, visitor, node, childIndex);
+    }
+};
+const isWhitespaceOnlyText = (value) => value.trim().length === 0;
+const isLowercaseHtmlName = (name) => typeof name === 'string' && /^[a-z][a-z0-9-]*$/.test(name);
+const isExistingTranslationNode = (node, translationComponentName, translatedNodeComponentName) => (node.type === 'mdxJsxTextElement' || node.type === 'mdxJsxFlowElement') &&
+    (node.name === translationComponentName || node.name === translatedNodeComponentName);
+const childrenHaveTranslatableText = (nodes) => {
+    for (const node of nodes) {
+        switch (node.type) {
+            case 'text':
+            case 'inlineCode':
+                if (!isWhitespaceOnlyText(node.value)) {
+                    return true;
+                }
+                break;
+            default:
+                if (isParent(node) &&
+                    Array.isArray(node.children) &&
+                    childrenHaveTranslatableText(node.children)) {
+                    return true;
+                }
+                break;
+        }
+    }
+    return false;
+};
+const createTranslationWrapper = (children, translationComponentName) => ({
+    type: 'mdxJsxTextElement',
+    name: translationComponentName,
+    attributes: [],
+    children: children,
+});
+const unwrapDirectTranslationChildren = (children, translationComponentName) => children.flatMap((child) => {
+    if (child.type === 'mdxJsxTextElement' &&
+        child.name === translationComponentName &&
+        child.attributes.length === 0) {
+        return child.children;
+    }
+    return [child];
+});
+const wrapContainerChildren = (node, options) => {
+    const normalizedChildren = unwrapDirectTranslationChildren(node.children, options.translationComponentName);
+    if (normalizedChildren.length === 1 &&
+        isExistingTranslationNode(normalizedChildren[0], options.translationComponentName, options.translatedNodeComponentName)) {
+        return false;
+    }
+    if (normalizedChildren.some((child) => isExistingTranslationNode(child, options.translationComponentName, options.translatedNodeComponentName))) {
+        return false;
+    }
+    if (!childrenHaveTranslatableText(normalizedChildren)) {
+        return false;
+    }
+    node.children = [
+        createTranslationWrapper(normalizedChildren, options.translationComponentName),
+    ];
+    return true;
+};
+const getImportDeclaration = (root, source) => {
+    for (const child of root.children) {
+        if (child.type !== 'mdxjsEsm' || !child.data?.estree?.body?.length) {
+            continue;
+        }
+        const declaration = child.data.estree.body.find((statement) => statement.type === 'ImportDeclaration' &&
+            statement.source.type === 'Literal' &&
+            statement.source.value === source);
+        if (declaration) {
+            return declaration;
+        }
+    }
+    return null;
+};
+const ensureNamedImport = (root, source, importName) => {
+    const existingDeclaration = getImportDeclaration(root, source);
+    if (existingDeclaration) {
+        const alreadyImported = existingDeclaration.specifiers.some((specifier) => specifier.type === 'ImportSpecifier' &&
+            specifier.imported.type === 'Identifier' &&
+            specifier.imported.name === importName &&
+            specifier.local.type === 'Identifier' &&
+            specifier.local.name === importName);
+        if (!alreadyImported) {
+            existingDeclaration.specifiers.push(createImportSpecifier(importName));
+        }
+        return;
+    }
+    root.children.unshift(createImportNode(source, [importName]));
+};
+const resolveImageReferenceUrl = (node, definitions) => {
+    if (node.type === 'image') {
+        return node.url;
+    }
+    return definitions.get(node.identifier)?.url ?? '';
+};
+const normalizeStaticImportSpecifier = (value) => value.replace(/[^a-zA-Z0-9_$]/g, '_');
+const isExternalUrl = (value) => /^https?:\/\//i.test(value);
+const isRelativeAssetUrl = (value) => Boolean(value) && !isExternalUrl(value) && !value.startsWith('/');
+const createTranslatePropsAttribute = (attributeNames) => createExpressionAttribute('translateProps', `[${attributeNames.map((name) => JSON.stringify(name)).join(', ')}]`, createArrayExpression(attributeNames));
+const createTranslatedNode = ({ originalType, originalName, originalAttributes, originalChildren, translatedNodeComponentName, translateProps, }) => ({
+    type: originalType,
+    name: translatedNodeComponentName,
+    attributes: [
+        {
+            type: 'mdxJsxAttribute',
+            name: 'component',
+            value: originalName,
+        },
+        createTranslatePropsAttribute(translateProps),
+        ...originalAttributes,
+    ],
+    children: originalType === 'mdxJsxTextElement'
+        ? originalChildren
+        : originalChildren,
+});
+const getTranslatableAttributeNames = (attributes, attributeNames) => attributes
+    .filter((attribute) => attributeNames.has(attribute.name) && typeof attribute.value === 'string')
+    .map((attribute) => attribute.name);
+const buildImportedImageAttribute = (variableName) => createExpressionAttribute('src', variableName, createIdentifier(variableName));
+const createImageAttributes = ({ srcValue, alt, title, }) => {
+    const attributes = [
+        {
+            type: 'mdxJsxAttribute',
+            name: 'src',
+            value: srcValue,
+        },
+    ];
+    if (typeof alt === 'string') {
+        attributes.push({
+            type: 'mdxJsxAttribute',
+            name: 'alt',
+            value: alt,
+        });
+    }
+    if (typeof title === 'string') {
+        attributes.push({
+            type: 'mdxJsxAttribute',
+            name: 'title',
+            value: title,
+        });
+    }
+    return attributes;
+};
+const createTranslatedImageNode = ({ srcValue, alt, title, translatedNodeComponentName, asTextElement, }) => {
+    const translateProps = ['alt', 'title'].filter((name) => name === 'alt'
+        ? typeof alt === 'string' && alt.length > 0
+        : typeof title === 'string' && title.length > 0);
+    return {
+        type: asTextElement ? 'mdxJsxTextElement' : 'mdxJsxFlowElement',
+        name: translatedNodeComponentName,
+        attributes: [
+            {
+                type: 'mdxJsxAttribute',
+                name: 'component',
+                value: 'img',
+            },
+            createTranslatePropsAttribute(translateProps),
+            ...createImageAttributes({ srcValue, alt, title }),
+        ],
+        children: [],
+    };
+};
+function remarkMdxTranslate(userOptions = {}) {
+    const options = {
+        include: userOptions.include,
+        exclude: userOptions.exclude,
+        attributeNames: new Set(userOptions.attributeNames || DEFAULT_ATTRIBUTE_NAMES),
+        translationComponentName: userOptions.translationComponentName || DEFAULT_TRANSLATION_COMPONENT_NAME,
+        translatedNodeComponentName: userOptions.translatedNodeComponentName || DEFAULT_TRANSLATED_NODE_COMPONENT_NAME,
+        translateHookName: userOptions.translateHookName || DEFAULT_TRANSLATE_HOOK_NAME,
+        reactImportSource: userOptions.reactImportSource || DEFAULT_REACT_IMPORT_SOURCE,
+        runtimeImportSource: userOptions.runtimeImportSource || DEFAULT_RUNTIME_IMPORT_SOURCE,
+    };
+    return (tree, file) => {
+        const root = tree;
+        if (!shouldProcessFile(file?.path, { include: options.include, exclude: options.exclude })) {
+            return;
+        }
+        const definitions = new Map();
+        visitTree(root, (node) => {
+            if (node.type === 'definition') {
+                definitions.set(node.identifier, node);
+            }
+            if (node.type === 'code') {
+                const transformed = (0, code_samples_1.transformCodeSample)(node.value, node.lang, {
+                    translationComponentName: options.translationComponentName,
+                    translateHookName: options.translateHookName,
+                    reactImportSource: options.reactImportSource,
+                    attributeNames: Array.from(options.attributeNames),
+                });
+                if (typeof transformed === 'string' && transformed !== node.value) {
+                    node.value = transformed;
+                }
+            }
+        });
+        let needsTranslationComponentImport = false;
+        let needsTranslatedNodeImport = false;
+        const importedImages = new Map();
+        const ensureImportedImageExpression = (url) => {
+            if (!isRelativeAssetUrl(url)) {
+                return url;
+            }
+            let variableName = importedImages.get(url);
+            if (!variableName) {
+                variableName = `__mdxTranslateImg_${normalizeStaticImportSpecifier(String(importedImages.size))}`;
+                importedImages.set(url, variableName);
+            }
+            return buildImportedImageAttribute(variableName).value;
+        };
+        visitTree(root, (node, parent, index) => {
+            if (node.type === 'heading' || node.type === 'paragraph' || node.type === 'tableCell') {
+                const didWrap = wrapContainerChildren(node, {
+                    translationComponentName: options.translationComponentName,
+                    translatedNodeComponentName: options.translatedNodeComponentName,
+                });
+                if (didWrap) {
+                    needsTranslationComponentImport = true;
+                }
+            }
+            if ((node.type === 'mdxJsxTextElement' || node.type === 'mdxJsxFlowElement') &&
+                node.name !== options.translatedNodeComponentName &&
+                node.name !== options.translationComponentName &&
+                isLowercaseHtmlName(node.name)) {
+                const translateProps = getTranslatableAttributeNames(node.attributes, options.attributeNames);
+                if (!translateProps.length) {
+                    return;
+                }
+                const translatedNode = createTranslatedNode({
+                    originalType: node.type,
+                    originalName: node.name,
+                    originalAttributes: node.attributes.map((attribute) => {
+                        if (node.name === 'img' &&
+                            attribute.name === 'src' &&
+                            typeof attribute.value === 'string' &&
+                            isRelativeAssetUrl(attribute.value)) {
+                            return {
+                                ...attribute,
+                                value: ensureImportedImageExpression(attribute.value),
+                            };
+                        }
+                        return attribute;
+                    }),
+                    originalChildren: node.children,
+                    translatedNodeComponentName: options.translatedNodeComponentName,
+                    translateProps,
+                });
+                Object.assign(node, translatedNode);
+                needsTranslatedNodeImport = true;
+            }
+            if (!parent || index === null) {
+                return;
+            }
+            if (node.type !== 'image' && node.type !== 'imageReference') {
+                return;
+            }
+            const url = resolveImageReferenceUrl(node, definitions);
+            const alt = 'alt' in node ? (node.alt ?? null) : null;
+            const title = 'title' in node ? (node.title ?? null) : null;
+            const translateProps = ['alt', 'title'].filter((name) => name === 'alt'
+                ? typeof alt === 'string' && alt.length > 0
+                : typeof title === 'string' && title.length > 0);
+            if (!url || !translateProps.length) {
+                return;
+            }
+            parent.children[index] = createTranslatedImageNode({
+                srcValue: ensureImportedImageExpression(url),
+                alt,
+                title,
+                translatedNodeComponentName: options.translatedNodeComponentName,
+                asTextElement: parent.type === 'paragraph' || parent.type === 'heading',
+            });
+            needsTranslatedNodeImport = true;
+        });
+        if (needsTranslationComponentImport) {
+            ensureNamedImport(root, options.reactImportSource, options.translationComponentName);
+        }
+        if (needsTranslatedNodeImport) {
+            ensureNamedImport(root, options.runtimeImportSource, options.translatedNodeComponentName);
+        }
+        for (const [url, variableName] of Array.from(importedImages.entries()).reverse()) {
+            root.children.unshift(createDefaultImportNode(url, variableName));
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/runtime.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+type TranslatedNodeProps = {
+    component: keyof JSX.IntrinsicElements;
+    translateProps?: string[];
+    children?: ReactNode;
+} & Record<string, unknown>;
+export declare function TranslatedNode({ component, translateProps, children, ...props }: TranslatedNodeProps): import("react").DOMElement<Record<string, unknown>, Element>;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAStD,KAAK,mBAAmB,GAAG;IACzB,SAAS,EAAE,MAAM,GAAG,CAAC,iBAAiB,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAU5B,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,cAAmB,EACnB,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,mBAAmB,gEA8BrB"}

package/dist/runtime.js

@@ -0,0 +1,36 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranslatedNode = TranslatedNode;
+const react_1 = require("react");
+const react_2 = require("@18ways/react");
+const isStaticImageLike = (value) => Boolean(value &&
+    typeof value === 'object' &&
+    'src' in value &&
+    typeof value.src === 'string');
+function TranslatedNode({ component, translateProps = [], children, ...props }) {
+    const t = (0, react_2.useT)();
+    const translatedProps = { ...props };
+    for (const propName of translateProps) {
+        const value = translatedProps[propName];
+        if (typeof value === 'string' && value.trim()) {
+            translatedProps[propName] = t(value);
+        }
+    }
+    if (component === 'img') {
+        const src = translatedProps.src;
+        if (isStaticImageLike(src)) {
+            translatedProps.src = src.src;
+            if (translatedProps.width == null && typeof src.width === 'number') {
+                translatedProps.width = src.width;
+            }
+            if (translatedProps.height == null && typeof src.height === 'number') {
+                translatedProps.height = src.height;
+            }
+        }
+        delete translatedProps.placeholder;
+        delete translatedProps.blurDataURL;
+    }
+    return (0, react_1.createElement)(component, translatedProps, children);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AAyBb,wCAmCC;AA1DD,iCAAsD;AACtD,yCAAqC;AAcrC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA4B,EAAE,CACrE,OAAO,CACL,KAAK;IACL,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,IAAI,KAAK;IACd,OAAQ,KAAyB,CAAC,GAAG,KAAK,QAAQ,CACnD,CAAC;AAEJ,SAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,cAAc,GAAG,EAAE,EACnB,QAAQ,EACR,GAAG,KAAK,EACY;IACpB,MAAM,CAAC,GAAG,IAAA,YAAI,GAAE,CAAC;IACjB,MAAM,eAAe,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IAE9D,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,CAAW,CAAC;QACjD,CAAC;IACH,CAAC;IAED,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC;QAChC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,eAAe,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;YAE9B,IAAI,eAAe,CAAC,KAAK,IAAI,IAAI,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACnE,eAAe,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACpC,CAAC;YAED,IAAI,eAAe,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACrE,eAAe,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;YACtC,CAAC;QACH,CAAC;QAED,OAAO,eAAe,CAAC,WAAW,CAAC;QACnC,OAAO,eAAe,CAAC,WAAW,CAAC;IACrC,CAAC;IAED,OAAO,IAAA,qBAAa,EAAC,SAAS,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC"}

package/index.ts

@@ -0,0 +1 @@
+export * from './src/index';

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@18ways/mdx-translate",
+  "version": "0.1.0-alpha.185b0ef4fee2",
+  "description": "Remark-based MDX translation transforms for 18ways",
+  "main": "dist/index.js",
+  "module": "./index.ts",
+  "types": "./index.ts",
+  "exports": {
+    ".": {
+      "types": "./index.ts",
+      "import": "./index.ts",
+      "require": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./runtime.tsx",
+      "import": "./runtime.tsx",
+      "require": "./dist/runtime.js"
+    }
+  },
+  "files": [
+    "dist",
+    "index.ts",
+    "runtime.tsx",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "ts:check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@18ways/react": "1.0.0-alpha.185b0ef4fee2",
+    "@babel/generator": "^7.28.5",
+    "@babel/parser": "^7.28.5",
+    "@babel/traverse": "^7.28.5",
+    "@babel/types": "^7.28.5"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@mdx-js/mdx": "^3.1.1",
+    "@types/estree": "^1.0.8",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^22.10.0",
+    "@types/react": "^18.3.12",
+    "@types/unist": "^3.0.3",
+    "react": "^18.3.1",
+    "typescript": "^5.6.2",
+    "vitest": "^3.2.4"
+  },
+  "license": "MIT",
+  "packageManager": "bun@1.3.8"
+}

package/runtime.tsx

@@ -0,0 +1 @@
+export * from './src/runtime';

package/src/code-samples.ts

@@ -0,0 +1,7 @@
+export const transformCodeSample = (
+  _source: string,
+  _language: string | null | undefined,
+  _options: unknown
+): string | null => {
+  return null;
+};

package/src/index.ts

@@ -0,0 +1,675 @@
+import type {
+  Root,
+  Content,
+  Definition,
+  Heading,
+  Paragraph,
+  TableCell,
+  Code,
+  Image,
+  ImageReference,
+  PhrasingContent,
+} from 'mdast';
+import type { Parent } from 'unist';
+import type {
+  ImportDeclaration,
+  ImportDefaultSpecifier,
+  ImportSpecifier,
+  Program,
+  Expression,
+  Identifier,
+  ArrayExpression,
+  Literal,
+  ExpressionStatement,
+} from 'estree';
+import { transformCodeSample } from './code-samples';
+
+type MdxJsxAttributeValueExpression = {
+  type: 'mdxJsxAttributeValueExpression';
+  value: string;
+  data: {
+    estree: Program;
+  };
+};
+
+type MdxJsxAttribute = {
+  type: 'mdxJsxAttribute';
+  name: string;
+  value?: string | null | MdxJsxAttributeValueExpression;
+};
+
+type MdxJsxElement = {
+  type: 'mdxJsxTextElement' | 'mdxJsxFlowElement';
+  name: string | null;
+  attributes: MdxJsxAttribute[];
+  children: Array<Content | MdxJsxTextElement | MdxJsxFlowElement>;
+};
+
+type MdxJsxTextElement = MdxJsxElement & {
+  type: 'mdxJsxTextElement';
+  children: PhrasingContent[];
+};
+
+type MdxJsxFlowElement = MdxJsxElement & {
+  type: 'mdxJsxFlowElement';
+};
+
+type MdxjsEsm = {
+  type: 'mdxjsEsm';
+  data?: {
+    estree?: Program;
+  };
+};
+
+type TreeContent = Content | MdxJsxTextElement | MdxJsxFlowElement | MdxjsEsm;
+type TreeRoot = Omit<Root, 'children'> & { children: TreeContent[] };
+type TreeParent = Omit<Parent, 'children'> & { children: TreeContent[] };
+type TreePhrasingContent = PhrasingContent | MdxJsxTextElement;
+
+type IncludedPath = RegExp | ((filePath: string) => boolean);
+
+export interface RemarkMdxTranslateOptions {
+  include?: IncludedPath;
+  exclude?: IncludedPath;
+  attributeNames?: string[];
+  translationComponentName?: string;
+  translatedNodeComponentName?: string;
+  translateHookName?: string;
+  reactImportSource?: string;
+  runtimeImportSource?: string;
+}
+
+const DEFAULT_ATTRIBUTE_NAMES = ['alt', 'title', 'aria-label', 'placeholder'];
+const DEFAULT_REACT_IMPORT_SOURCE = '@18ways/react';
+const DEFAULT_RUNTIME_IMPORT_SOURCE = '@18ways/mdx-translate/runtime';
+const DEFAULT_TRANSLATION_COMPONENT_NAME = 'T';
+const DEFAULT_TRANSLATED_NODE_COMPONENT_NAME = 'TranslatedNode';
+const DEFAULT_TRANSLATE_HOOK_NAME = 'useT';
+
+const createLiteral = (value: string): Literal => ({
+  type: 'Literal',
+  value,
+});
+
+const createIdentifier = (name: string): Identifier => ({
+  type: 'Identifier',
+  name,
+});
+
+const createExpressionStatement = (expression: Expression): ExpressionStatement => ({
+  type: 'ExpressionStatement',
+  expression,
+});
+
+const createArrayExpression = (items: string[]): ArrayExpression => ({
+  type: 'ArrayExpression',
+  elements: items.map((item) => createLiteral(item)),
+});
+
+const createExpressionAttribute = (
+  name: string,
+  value: string,
+  expression: Expression
+): MdxJsxAttribute => ({
+  type: 'mdxJsxAttribute',
+  name,
+  value: {
+    type: 'mdxJsxAttributeValueExpression',
+    value,
+    data: {
+      estree: {
+        type: 'Program',
+        sourceType: 'module',
+        body: [createExpressionStatement(expression)],
+      },
+    },
+  },
+});
+
+const createImportSpecifier = (name: string): ImportSpecifier => ({
+  type: 'ImportSpecifier',
+  imported: createIdentifier(name),
+  local: createIdentifier(name),
+});
+
+const createDefaultImportSpecifier = (name: string): ImportDefaultSpecifier => ({
+  type: 'ImportDefaultSpecifier',
+  local: createIdentifier(name),
+});
+
+const createImportDeclaration = (source: string, names: string[]): ImportDeclaration => ({
+  type: 'ImportDeclaration',
+  source: createLiteral(source),
+  specifiers: names.map(createImportSpecifier),
+  attributes: [],
+});
+
+const createImportNode = (source: string, names: string[]): MdxjsEsm => ({
+  type: 'mdxjsEsm',
+  data: {
+    estree: {
+      type: 'Program',
+      sourceType: 'module',
+      body: [createImportDeclaration(source, names)],
+    },
+  },
+});
+
+const createDefaultImportNode = (source: string, localName: string): MdxjsEsm => ({
+  type: 'mdxjsEsm',
+  data: {
+    estree: {
+      type: 'Program',
+      sourceType: 'module',
+      body: [
+        {
+          type: 'ImportDeclaration',
+          source: createLiteral(source),
+          specifiers: [createDefaultImportSpecifier(localName)],
+          attributes: [],
+        },
+      ],
+    },
+  },
+});
+
+const matchesPath = (matcher: IncludedPath | undefined, filePath: string): boolean => {
+  if (!matcher) {
+    return true;
+  }
+
+  if (matcher instanceof RegExp) {
+    return matcher.test(filePath);
+  }
+
+  return matcher(filePath);
+};
+
+const shouldProcessFile = (
+  filePath: string | undefined,
+  options: Pick<RemarkMdxTranslateOptions, 'include' | 'exclude'>
+): boolean => {
+  if (!filePath) {
+    return true;
+  }
+
+  if (options.exclude && matchesPath(options.exclude, filePath)) {
+    return false;
+  }
+
+  return matchesPath(options.include, filePath);
+};
+
+const isParent = (node: unknown): node is TreeParent | TreeRoot =>
+  Boolean(node && typeof node === 'object' && 'children' in (node as Record<string, unknown>));
+
+const visitTree = (
+  node: TreeContent | TreeRoot,
+  visitor: (node: TreeContent | TreeRoot, parent: TreeParent | null, index: number | null) => void,
+  parent: TreeParent | null = null,
+  index: number | null = null
+): void => {
+  visitor(node, parent, index);
+
+  if (!isParent(node) || !Array.isArray(node.children)) {
+    return;
+  }
+
+  for (let childIndex = 0; childIndex < node.children.length; childIndex += 1) {
+    const child = node.children[childIndex];
+    visitTree(child, visitor, node, childIndex);
+  }
+};
+
+const isWhitespaceOnlyText = (value: string): boolean => value.trim().length === 0;
+
+const isLowercaseHtmlName = (name: string | null): name is string =>
+  typeof name === 'string' && /^[a-z][a-z0-9-]*$/.test(name);
+
+const isExistingTranslationNode = (
+  node: TreeContent | TreePhrasingContent,
+  translationComponentName: string,
+  translatedNodeComponentName: string
+): boolean =>
+  (node.type === 'mdxJsxTextElement' || node.type === 'mdxJsxFlowElement') &&
+  (node.name === translationComponentName || node.name === translatedNodeComponentName);
+
+const childrenHaveTranslatableText = (nodes: Array<TreeContent | TreePhrasingContent>): boolean => {
+  for (const node of nodes) {
+    switch (node.type) {
+      case 'text':
+      case 'inlineCode':
+        if (!isWhitespaceOnlyText(node.value)) {
+          return true;
+        }
+        break;
+      default:
+        if (
+          isParent(node) &&
+          Array.isArray(node.children) &&
+          childrenHaveTranslatableText(node.children)
+        ) {
+          return true;
+        }
+        break;
+    }
+  }
+
+  return false;
+};
+
+const createTranslationWrapper = (
+  children: TreePhrasingContent[],
+  translationComponentName: string
+): MdxJsxTextElement => ({
+  type: 'mdxJsxTextElement',
+  name: translationComponentName,
+  attributes: [],
+  children: children as PhrasingContent[],
+});
+
+const unwrapDirectTranslationChildren = (
+  children: TreePhrasingContent[],
+  translationComponentName: string
+): TreePhrasingContent[] =>
+  children.flatMap((child) => {
+    if (
+      child.type === 'mdxJsxTextElement' &&
+      child.name === translationComponentName &&
+      child.attributes.length === 0
+    ) {
+      return child.children as TreePhrasingContent[];
+    }
+
+    return [child];
+  });
+
+const wrapContainerChildren = (
+  node: Heading | Paragraph | TableCell,
+  options: {
+    translationComponentName: string;
+    translatedNodeComponentName: string;
+  }
+): boolean => {
+  const normalizedChildren = unwrapDirectTranslationChildren(
+    node.children as TreePhrasingContent[],
+    options.translationComponentName
+  );
+
+  if (
+    normalizedChildren.length === 1 &&
+    isExistingTranslationNode(
+      normalizedChildren[0],
+      options.translationComponentName,
+      options.translatedNodeComponentName
+    )
+  ) {
+    return false;
+  }
+
+  if (
+    normalizedChildren.some((child) =>
+      isExistingTranslationNode(
+        child,
+        options.translationComponentName,
+        options.translatedNodeComponentName
+      )
+    )
+  ) {
+    return false;
+  }
+
+  if (!childrenHaveTranslatableText(normalizedChildren)) {
+    return false;
+  }
+
+  node.children = [
+    createTranslationWrapper(normalizedChildren, options.translationComponentName),
+  ] as unknown as PhrasingContent[];
+
+  return true;
+};
+
+const getImportDeclaration = (root: TreeRoot, source: string): ImportDeclaration | null => {
+  for (const child of root.children) {
+    if (child.type !== 'mdxjsEsm' || !child.data?.estree?.body?.length) {
+      continue;
+    }
+
+    const declaration = child.data.estree.body.find(
+      (statement): statement is ImportDeclaration =>
+        statement.type === 'ImportDeclaration' &&
+        statement.source.type === 'Literal' &&
+        statement.source.value === source
+    );
+
+    if (declaration) {
+      return declaration;
+    }
+  }
+
+  return null;
+};
+
+const ensureNamedImport = (root: TreeRoot, source: string, importName: string): void => {
+  const existingDeclaration = getImportDeclaration(root, source);
+
+  if (existingDeclaration) {
+    const alreadyImported = existingDeclaration.specifiers.some(
+      (specifier) =>
+        specifier.type === 'ImportSpecifier' &&
+        specifier.imported.type === 'Identifier' &&
+        specifier.imported.name === importName &&
+        specifier.local.type === 'Identifier' &&
+        specifier.local.name === importName
+    );
+
+    if (!alreadyImported) {
+      existingDeclaration.specifiers.push(createImportSpecifier(importName));
+    }
+
+    return;
+  }
+
+  root.children.unshift(createImportNode(source, [importName]));
+};
+
+const resolveImageReferenceUrl = (
+  node: Image | ImageReference,
+  definitions: Map<string, Definition>
+): string => {
+  if (node.type === 'image') {
+    return node.url;
+  }
+
+  return definitions.get(node.identifier)?.url ?? '';
+};
+
+const normalizeStaticImportSpecifier = (value: string): string =>
+  value.replace(/[^a-zA-Z0-9_$]/g, '_');
+
+const isExternalUrl = (value: string): boolean => /^https?:\/\//i.test(value);
+
+const isRelativeAssetUrl = (value: string): boolean =>
+  Boolean(value) && !isExternalUrl(value) && !value.startsWith('/');
+
+const createTranslatePropsAttribute = (attributeNames: string[]): MdxJsxAttribute =>
+  createExpressionAttribute(
+    'translateProps',
+    `[${attributeNames.map((name) => JSON.stringify(name)).join(', ')}]`,
+    createArrayExpression(attributeNames)
+  );
+
+const createTranslatedNode = ({
+  originalType,
+  originalName,
+  originalAttributes,
+  originalChildren,
+  translatedNodeComponentName,
+  translateProps,
+}: {
+  originalType: 'mdxJsxTextElement' | 'mdxJsxFlowElement';
+  originalName: string;
+  originalAttributes: MdxJsxAttribute[];
+  originalChildren: Array<Content | MdxJsxTextElement | MdxJsxFlowElement>;
+  translatedNodeComponentName: string;
+  translateProps: string[];
+}): MdxJsxElement => ({
+  type: originalType,
+  name: translatedNodeComponentName,
+  attributes: [
+    {
+      type: 'mdxJsxAttribute',
+      name: 'component',
+      value: originalName,
+    },
+    createTranslatePropsAttribute(translateProps),
+    ...originalAttributes,
+  ],
+  children:
+    originalType === 'mdxJsxTextElement'
+      ? (originalChildren as PhrasingContent[])
+      : originalChildren,
+});
+
+const getTranslatableAttributeNames = (
+  attributes: MdxJsxAttribute[],
+  attributeNames: Set<string>
+): string[] =>
+  attributes
+    .filter(
+      (attribute) => attributeNames.has(attribute.name) && typeof attribute.value === 'string'
+    )
+    .map((attribute) => attribute.name);
+
+const buildImportedImageAttribute = (variableName: string): MdxJsxAttribute =>
+  createExpressionAttribute('src', variableName, createIdentifier(variableName));
+
+const createImageAttributes = ({
+  srcValue,
+  alt,
+  title,
+}: {
+  srcValue: MdxJsxAttribute['value'];
+  alt?: string | null;
+  title?: string | null;
+}): MdxJsxAttribute[] => {
+  const attributes: MdxJsxAttribute[] = [
+    {
+      type: 'mdxJsxAttribute',
+      name: 'src',
+      value: srcValue,
+    },
+  ];
+
+  if (typeof alt === 'string') {
+    attributes.push({
+      type: 'mdxJsxAttribute',
+      name: 'alt',
+      value: alt,
+    });
+  }
+
+  if (typeof title === 'string') {
+    attributes.push({
+      type: 'mdxJsxAttribute',
+      name: 'title',
+      value: title,
+    });
+  }
+
+  return attributes;
+};
+
+const createTranslatedImageNode = ({
+  srcValue,
+  alt,
+  title,
+  translatedNodeComponentName,
+  asTextElement,
+}: {
+  srcValue: MdxJsxAttribute['value'];
+  alt?: string | null;
+  title?: string | null;
+  translatedNodeComponentName: string;
+  asTextElement: boolean;
+}): MdxJsxElement => {
+  const translateProps = ['alt', 'title'].filter((name) =>
+    name === 'alt'
+      ? typeof alt === 'string' && alt.length > 0
+      : typeof title === 'string' && title.length > 0
+  );
+
+  return {
+    type: asTextElement ? 'mdxJsxTextElement' : 'mdxJsxFlowElement',
+    name: translatedNodeComponentName,
+    attributes: [
+      {
+        type: 'mdxJsxAttribute',
+        name: 'component',
+        value: 'img',
+      },
+      createTranslatePropsAttribute(translateProps),
+      ...createImageAttributes({ srcValue, alt, title }),
+    ],
+    children: [],
+  };
+};
+
+export function remarkMdxTranslate(userOptions: RemarkMdxTranslateOptions = {}) {
+  const options = {
+    include: userOptions.include,
+    exclude: userOptions.exclude,
+    attributeNames: new Set(userOptions.attributeNames || DEFAULT_ATTRIBUTE_NAMES),
+    translationComponentName:
+      userOptions.translationComponentName || DEFAULT_TRANSLATION_COMPONENT_NAME,
+    translatedNodeComponentName:
+      userOptions.translatedNodeComponentName || DEFAULT_TRANSLATED_NODE_COMPONENT_NAME,
+    translateHookName: userOptions.translateHookName || DEFAULT_TRANSLATE_HOOK_NAME,
+    reactImportSource: userOptions.reactImportSource || DEFAULT_REACT_IMPORT_SOURCE,
+    runtimeImportSource: userOptions.runtimeImportSource || DEFAULT_RUNTIME_IMPORT_SOURCE,
+  };
+
+  return (tree: Root, file?: { path?: string }) => {
+    const root = tree as TreeRoot;
+
+    if (!shouldProcessFile(file?.path, { include: options.include, exclude: options.exclude })) {
+      return;
+    }
+
+    const definitions = new Map<string, Definition>();
+    visitTree(root, (node) => {
+      if (node.type === 'definition') {
+        definitions.set(node.identifier, node);
+      }
+
+      if (node.type === 'code') {
+        const transformed = transformCodeSample(node.value, node.lang, {
+          translationComponentName: options.translationComponentName,
+          translateHookName: options.translateHookName,
+          reactImportSource: options.reactImportSource,
+          attributeNames: Array.from(options.attributeNames),
+        });
+
+        if (typeof transformed === 'string' && transformed !== node.value) {
+          (node as Code).value = transformed;
+        }
+      }
+    });
+
+    let needsTranslationComponentImport = false;
+    let needsTranslatedNodeImport = false;
+    const importedImages = new Map<string, string>();
+
+    const ensureImportedImageExpression = (url: string): MdxJsxAttribute['value'] => {
+      if (!isRelativeAssetUrl(url)) {
+        return url;
+      }
+
+      let variableName = importedImages.get(url);
+      if (!variableName) {
+        variableName = `__mdxTranslateImg_${normalizeStaticImportSpecifier(String(importedImages.size))}`;
+        importedImages.set(url, variableName);
+      }
+
+      return buildImportedImageAttribute(variableName).value;
+    };
+
+    visitTree(root, (node, parent, index) => {
+      if (node.type === 'heading' || node.type === 'paragraph' || node.type === 'tableCell') {
+        const didWrap = wrapContainerChildren(node, {
+          translationComponentName: options.translationComponentName,
+          translatedNodeComponentName: options.translatedNodeComponentName,
+        });
+
+        if (didWrap) {
+          needsTranslationComponentImport = true;
+        }
+      }
+
+      if (
+        (node.type === 'mdxJsxTextElement' || node.type === 'mdxJsxFlowElement') &&
+        node.name !== options.translatedNodeComponentName &&
+        node.name !== options.translationComponentName &&
+        isLowercaseHtmlName(node.name)
+      ) {
+        const translateProps = getTranslatableAttributeNames(
+          node.attributes,
+          options.attributeNames
+        );
+        if (!translateProps.length) {
+          return;
+        }
+
+        const translatedNode = createTranslatedNode({
+          originalType: node.type,
+          originalName: node.name,
+          originalAttributes: node.attributes.map((attribute) => {
+            if (
+              node.name === 'img' &&
+              attribute.name === 'src' &&
+              typeof attribute.value === 'string' &&
+              isRelativeAssetUrl(attribute.value)
+            ) {
+              return {
+                ...attribute,
+                value: ensureImportedImageExpression(attribute.value),
+              };
+            }
+
+            return attribute;
+          }),
+          originalChildren: node.children as Array<Content | MdxJsxTextElement | MdxJsxFlowElement>,
+          translatedNodeComponentName: options.translatedNodeComponentName,
+          translateProps,
+        });
+
+        Object.assign(node, translatedNode);
+        needsTranslatedNodeImport = true;
+      }
+
+      if (!parent || index === null) {
+        return;
+      }
+
+      if (node.type !== 'image' && node.type !== 'imageReference') {
+        return;
+      }
+
+      const url = resolveImageReferenceUrl(node, definitions);
+      const alt = 'alt' in node ? (node.alt ?? null) : null;
+      const title = 'title' in node ? (node.title ?? null) : null;
+      const translateProps = ['alt', 'title'].filter((name) =>
+        name === 'alt'
+          ? typeof alt === 'string' && alt.length > 0
+          : typeof title === 'string' && title.length > 0
+      );
+
+      if (!url || !translateProps.length) {
+        return;
+      }
+
+      parent.children[index] = createTranslatedImageNode({
+        srcValue: ensureImportedImageExpression(url),
+        alt,
+        title,
+        translatedNodeComponentName: options.translatedNodeComponentName,
+        asTextElement: parent.type === 'paragraph' || parent.type === 'heading',
+      }) as TreeContent;
+
+      needsTranslatedNodeImport = true;
+    });
+
+    if (needsTranslationComponentImport) {
+      ensureNamedImport(root, options.reactImportSource, options.translationComponentName);
+    }
+
+    if (needsTranslatedNodeImport) {
+      ensureNamedImport(root, options.runtimeImportSource, options.translatedNodeComponentName);
+    }
+
+    for (const [url, variableName] of Array.from(importedImages.entries()).reverse()) {
+      root.children.unshift(createDefaultImportNode(url, variableName));
+    }
+  };
+}

package/src/react-runtime-shim.d.ts

@@ -0,0 +1,9 @@
+declare module '@18ways/react' {
+  import type { ReactNode } from 'react';
+
+  export function useT(): (text: string) => string;
+  export const T: <X extends ReactNode | string>(props: {
+    children: X;
+    vars?: Record<string, unknown>;
+  }) => ReactNode;
+}

package/src/runtime.tsx

@@ -0,0 +1,61 @@
+'use client';
+
+import { createElement, type ReactNode } from 'react';
+import { useT } from '@18ways/react';
+
+type StaticImageLike = {
+  src?: string;
+  width?: number;
+  height?: number;
+};
+
+type TranslatedNodeProps = {
+  component: keyof JSX.IntrinsicElements;
+  translateProps?: string[];
+  children?: ReactNode;
+} & Record<string, unknown>;
+
+const isStaticImageLike = (value: unknown): value is StaticImageLike =>
+  Boolean(
+    value &&
+    typeof value === 'object' &&
+    'src' in value &&
+    typeof (value as StaticImageLike).src === 'string'
+  );
+
+export function TranslatedNode({
+  component,
+  translateProps = [],
+  children,
+  ...props
+}: TranslatedNodeProps) {
+  const t = useT();
+  const translatedProps: Record<string, unknown> = { ...props };
+
+  for (const propName of translateProps) {
+    const value = translatedProps[propName];
+    if (typeof value === 'string' && value.trim()) {
+      translatedProps[propName] = t(value) as string;
+    }
+  }
+
+  if (component === 'img') {
+    const src = translatedProps.src;
+    if (isStaticImageLike(src)) {
+      translatedProps.src = src.src;
+
+      if (translatedProps.width == null && typeof src.width === 'number') {
+        translatedProps.width = src.width;
+      }
+
+      if (translatedProps.height == null && typeof src.height === 'number') {
+        translatedProps.height = src.height;
+      }
+    }
+
+    delete translatedProps.placeholder;
+    delete translatedProps.blurDataURL;
+  }
+
+  return createElement(component, translatedProps, children);
+}