@bleedingdev/modern-js-create 3.2.0-ultramodern.108 → 3.2.0-ultramodern.110

package/dist/esm/ultramodern-checks/oxlint-plugin.js

@@ -0,0 +1,316 @@
+const commonOptionsSchema = {
+    type: 'object',
+    properties: {
+        allowElements: {
+            type: 'array',
+            items: {
+                type: 'string'
+            }
+        },
+        ignoreCommentPattern: {
+            type: 'string'
+        }
+    },
+    additionalProperties: false
+};
+const attributeOptionsSchema = {
+    type: 'object',
+    properties: {
+        ...commonOptionsSchema.properties,
+        visibleAttributes: {
+            type: 'array',
+            items: {
+                type: 'string'
+            }
+        }
+    },
+    additionalProperties: false
+};
+const translationOptionsSchema = {
+    type: 'object',
+    properties: {
+        translationFunctions: {
+            type: 'array',
+            items: {
+                type: 'string'
+            }
+        }
+    },
+    additionalProperties: false
+};
+const DEFAULT_VISIBLE_ATTRIBUTES = [
+    'aria-label',
+    "aria-description",
+    "aria-roledescription",
+    'aria-valuetext',
+    'alt',
+    'placeholder',
+    'title'
+];
+const DEFAULT_ALLOWED_ELEMENTS = [
+    'code',
+    'kbd',
+    'samp'
+];
+const DEFAULT_TRANSLATION_FUNCTIONS = [
+    't'
+];
+const DEFAULT_IGNORE_COMMENT_PATTERN = 'i18n-ignore';
+const LETTER_PATTERN = /\p{L}/u;
+const SPLIT_TRANSLATION_KEY_PATTERN = /\.(?:prefix|suffix|before|after)$/u;
+const isRecord = (value)=>Boolean(value) && 'object' == typeof value && !Array.isArray(value);
+const asStringArray = (value, fallback)=>Array.isArray(value) && value.every((item)=>'string' == typeof item) ? value : fallback;
+const getCommonRuleOption = (context, defaults)=>{
+    const options = context.options?.[0];
+    if (!isRecord(options)) return defaults;
+    return {
+        allowElements: asStringArray(options.allowElements, defaults.allowElements),
+        ignoreCommentPattern: 'string' == typeof options.ignoreCommentPattern ? options.ignoreCommentPattern : defaults.ignoreCommentPattern
+    };
+};
+const getAttributeRuleOption = (context, defaults)=>{
+    const options = context.options?.[0];
+    const commonOptions = getCommonRuleOption(context, defaults);
+    return {
+        ...commonOptions,
+        visibleAttributes: isRecord(options) ? asStringArray(options.visibleAttributes, defaults.visibleAttributes) : defaults.visibleAttributes
+    };
+};
+const getSplitTranslationKeyRuleOption = (context, defaults)=>{
+    const options = context.options?.[0];
+    if (!isRecord(options)) return defaults;
+    return {
+        translationFunctions: asStringArray(options.translationFunctions, defaults.translationFunctions)
+    };
+};
+const normalizeVisibleText = (value)=>value.replaceAll(/\s+/gu, ' ').trim();
+const hasLetters = (value)=>LETTER_PATTERN.test(value);
+const getNodeName = (node)=>{
+    if (!node) return;
+    if ('string' == typeof node.name) return node.name;
+    if ('JSXIdentifier' === node.type && isRecord(node.name) && 'string' == typeof node.name.name) return node.name.name;
+    if ('JSXIdentifier' === node.type && 'string' == typeof node.name) return node.name;
+    if (('JSXMemberExpression' === node.type || 'MemberExpression' === node.type) && isRecord(node.property) && true !== node.computed) {
+        const objectName = getNodeName(node.object);
+        const propertyName = getNodeName(node.property);
+        return objectName && propertyName ? `${objectName}.${propertyName}` : propertyName;
+    }
+};
+const getJsxElementName = (node)=>{
+    if (node?.type !== 'JSXElement') return;
+    return getNodeName(node.openingElement?.name);
+};
+const hasAllowedElementAncestor = (node, allowedElements)=>{
+    let current = node;
+    while(current){
+        const elementName = getJsxElementName(current);
+        if (elementName && allowedElements.has(elementName)) return true;
+        current = current.parent;
+    }
+    return false;
+};
+const getTemplateLiteralValue = (node)=>{
+    if ('TemplateLiteral' !== node.type || (node.expressions?.length ?? 0) > 0) return;
+    const quasi = node.quasis?.[0];
+    if (!isRecord(quasi?.value)) return;
+    const cooked = quasi.value.cooked;
+    const raw = quasi.value.raw;
+    return 'string' == typeof cooked ? cooked : 'string' == typeof raw ? raw : void 0;
+};
+const getStringLiteralValue = (node)=>{
+    if (!node) return;
+    if (('Literal' === node.type || 'StringLiteral' === node.type) && 'string' == typeof node.value) return node.value;
+    return getTemplateLiteralValue(node);
+};
+const expressionStringValue = (node)=>getStringLiteralValue(node?.type === 'JSXExpressionContainer' ? node.expression : node);
+const getLine = (node)=>node.loc?.start?.line;
+const hasIgnoreComment = (node, context, pattern)=>{
+    const sourceCode = context.getSourceCode?.();
+    const nodeLine = getLine(node);
+    if (!sourceCode?.getAllComments || void 0 === nodeLine) return false;
+    return sourceCode.getAllComments().some((comment)=>{
+        const commentValue = String(comment.value ?? '');
+        if (!pattern.test(commentValue)) return false;
+        const startLine = comment.loc?.start?.line;
+        const endLine = comment.loc?.end?.line ?? startLine;
+        return void 0 !== startLine && void 0 !== endLine && startLine <= nodeLine + 1 && endLine >= nodeLine - 1;
+    });
+};
+const getIgnorePattern = (options)=>new RegExp(options.ignoreCommentPattern, 'u');
+const reportVisibleText = (context, node, text)=>{
+    context.report({
+        node,
+        message: `Move user-visible JSX text to locale resources: ${JSON.stringify(text)}`
+    });
+};
+const createNoHardcodedJsxTextRule = ()=>({
+        meta: {
+            type: 'problem',
+            docs: {
+                description: 'Disallow literal user-visible text in JSX children in UltraModern generated apps.'
+            },
+            schema: [
+                commonOptionsSchema
+            ]
+        },
+        create (context) {
+            const options = getCommonRuleOption(context, {
+                allowElements: DEFAULT_ALLOWED_ELEMENTS,
+                ignoreCommentPattern: DEFAULT_IGNORE_COMMENT_PATTERN
+            });
+            const allowedElements = new Set(options.allowElements);
+            const ignorePattern = getIgnorePattern(options);
+            const shouldSkipNode = (node)=>hasAllowedElementAncestor(node, allowedElements) || hasIgnoreComment(node, context, ignorePattern);
+            return {
+                JSXText (node) {
+                    const text = normalizeVisibleText(String(node.value ?? ''));
+                    if (!text || !hasLetters(text) || shouldSkipNode(node)) return;
+                    reportVisibleText(context, node, text);
+                },
+                JSXExpressionContainer (node) {
+                    if (node.parent?.type !== 'JSXElement' && node.parent?.type !== 'JSXFragment') return;
+                    const text = normalizeVisibleText(expressionStringValue(node.expression) ?? '');
+                    if (!text || !hasLetters(text) || shouldSkipNode(node)) return;
+                    reportVisibleText(context, node, text);
+                }
+            };
+        }
+    });
+const createNoLiteralVisibleJsxAttributesRule = ()=>({
+        meta: {
+            type: 'problem',
+            docs: {
+                description: 'Disallow literal user-visible JSX attribute text in UltraModern generated apps.'
+            },
+            schema: [
+                attributeOptionsSchema
+            ]
+        },
+        create (context) {
+            const options = getAttributeRuleOption(context, {
+                allowElements: DEFAULT_ALLOWED_ELEMENTS,
+                ignoreCommentPattern: DEFAULT_IGNORE_COMMENT_PATTERN,
+                visibleAttributes: DEFAULT_VISIBLE_ATTRIBUTES
+            });
+            const visibleAttributes = new Set(options.visibleAttributes);
+            const ignorePattern = getIgnorePattern(options);
+            return {
+                JSXAttribute (node) {
+                    const attributeName = getNodeName(node.name);
+                    if (!attributeName || !visibleAttributes.has(attributeName)) return;
+                    const text = normalizeVisibleText(expressionStringValue(node.value) ?? '');
+                    if (!text || !hasLetters(text) || hasIgnoreComment(node, context, ignorePattern)) return;
+                    context.report({
+                        node,
+                        message: `Move literal ${attributeName} copy to locale resources: ${JSON.stringify(text)}`
+                    });
+                }
+            };
+        }
+    });
+const getSourceText = (context, node)=>context.getSourceCode?.().getText?.(node) ?? '';
+const looksLikeLocaleTest = (context, node)=>{
+    const text = getSourceText(context, node);
+    return /\b(?:language|locale|lng|currentLanguage)\b/u.test(text) && /(?:={2,3}|!==?)/u.test(text) && /['"][a-z]{2}(?:-[A-Za-z0-9]+)?['"]/u.test(text);
+};
+const isAllowedBranchLiteral = (text)=>new Set([
+        'page',
+        'undefined',
+        'null',
+        'true',
+        'false'
+    ]).has(text);
+const createNoManualLocaleCopyBranchingRule = ()=>({
+        meta: {
+            type: 'problem',
+            docs: {
+                description: 'Disallow manual locale conditionals that choose user-visible copy.'
+            },
+            schema: []
+        },
+        create (context) {
+            const reportBranch = (node, text)=>{
+                context.report({
+                    node,
+                    message: `Move locale-specific copy branch to i18n resources: ${JSON.stringify(normalizeVisibleText(text))}`
+                });
+            };
+            return {
+                ConditionalExpression (node) {
+                    if (!node.test || !looksLikeLocaleTest(context, node.test)) return;
+                    for (const branch of [
+                        node.consequent,
+                        node.alternate
+                    ]){
+                        const text = expressionStringValue(branch);
+                        if (text && hasLetters(text) && !isAllowedBranchLiteral(text.trim())) reportBranch(branch, text);
+                    }
+                }
+            };
+        }
+    });
+const getCallExpressionName = (node)=>getNodeName(node);
+const createNoSplitTranslationKeysRule = ()=>({
+        meta: {
+            type: 'problem',
+            docs: {
+                description: 'Disallow split phrase translation key suffixes such as .prefix and .suffix.'
+            },
+            schema: [
+                translationOptionsSchema
+            ]
+        },
+        create (context) {
+            const options = getSplitTranslationKeyRuleOption(context, {
+                translationFunctions: DEFAULT_TRANSLATION_FUNCTIONS
+            });
+            const translationFunctions = new Set(options.translationFunctions);
+            return {
+                CallExpression (node) {
+                    const calleeName = getCallExpressionName(node.callee);
+                    if (!calleeName || !translationFunctions.has(calleeName)) return;
+                    const key = expressionStringValue(node.arguments?.[0]);
+                    if (!key || !SPLIT_TRANSLATION_KEY_PATTERN.test(key)) return;
+                    context.report({
+                        node,
+                        message: 'Keep translator-owned phrases whole instead of using split translation keys.'
+                    });
+                }
+            };
+        }
+    });
+const createNoLegacyMfBoundaryAttributesRule = ()=>({
+        meta: {
+            type: 'problem',
+            docs: {
+                description: 'Disallow legacy Module Federation boundary attributes in generated UltraModern workspaces.'
+            },
+            schema: []
+        },
+        create (context) {
+            return {
+                JSXAttribute (node) {
+                    const attributeName = getNodeName(node.name);
+                    if ('data-mf-boundary' !== attributeName && 'data-mf-remote' !== attributeName && 'data-mf-expose' !== attributeName) return;
+                    context.report({
+                        node,
+                        message: 'Use data-modern-boundary-id and data-modern-mf-expose instead of legacy data-mf-* boundary attributes.'
+                    });
+                }
+            };
+        }
+    });
+const oxlint_plugin_plugin = {
+    meta: {
+        name: 'ultramodern'
+    },
+    rules: {
+        'no-hardcoded-jsx-text': createNoHardcodedJsxTextRule(),
+        'no-legacy-mf-boundary-attributes': createNoLegacyMfBoundaryAttributesRule(),
+        'no-literal-visible-jsx-attributes': createNoLiteralVisibleJsxAttributesRule(),
+        'no-manual-locale-copy-branching': createNoManualLocaleCopyBranchingRule(),
+        'no-split-translation-keys': createNoSplitTranslationKeysRule()
+    }
+};
+const oxlint_plugin = oxlint_plugin_plugin;
+export default oxlint_plugin;

package/dist/esm/ultramodern-package-source.js

@@ -0,0 +1,61 @@
+const WORKSPACE_PACKAGE_VERSION = 'workspace:*';
+const BLEEDINGDEV_CREATE_PACKAGE = '@bleedingdev/modern-js-create';
+const BLEEDINGDEV_PACKAGE_SCOPE = 'bleedingdev';
+const BLEEDINGDEV_PACKAGE_NAME_PREFIX = 'modern-js-';
+const BLEEDINGDEV_FRAMEWORK_VERSION_ENV = 'MODERN_CREATE_ULTRAMODERN_FRAMEWORK_VERSION';
+const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES = [
+    '@modern-js/create',
+    '@modern-js/runtime',
+    '@modern-js/app-tools',
+    '@modern-js/tsconfig',
+    '@modern-js/plugin-i18n',
+    '@modern-js/plugin-tanstack',
+    '@modern-js/plugin-bff',
+    '@modern-js/adapter-rstest'
+];
+const ULTRAMODERN_WORKSPACE_MODERN_PACKAGES = [
+    '@modern-js/create',
+    '@modern-js/app-tools',
+    '@modern-js/plugin-bff',
+    '@modern-js/plugin-i18n',
+    '@modern-js/plugin-tanstack',
+    '@modern-js/runtime'
+];
+function modernPackageVersion(packageSource) {
+    return 'install' === packageSource.strategy ? packageSource.modernPackageVersion : WORKSPACE_PACKAGE_VERSION;
+}
+function modernAliasPackageName(packageName, packageSource) {
+    if (!packageSource.aliasScope) return packageName;
+    const scope = packageSource.aliasScope.replace(/^@/, '');
+    const unscopedName = packageName.split('/').at(-1);
+    return `@${scope}/${packageSource.aliasPackageNamePrefix ?? ''}${unscopedName}`;
+}
+function modernPackageSpecifier(packageName, packageSource) {
+    if ('install' !== packageSource.strategy) return WORKSPACE_PACKAGE_VERSION;
+    if (!packageSource.aliasScope) return packageSource.modernPackageVersion;
+    return `npm:${modernAliasPackageName(packageName, packageSource)}@${packageSource.modernPackageVersion}`;
+}
+function modernPackageAliases(packageNames, packageSource) {
+    if (!packageSource.aliasScope) return;
+    return Object.fromEntries(packageNames.map((packageName)=>[
+            packageName,
+            modernAliasPackageName(packageName, packageSource)
+        ]));
+}
+function createModernPackagesMetadata(packageNames, packageSource, options = {}) {
+    const includeAliases = options.includeAliases ?? Boolean(packageSource.aliasScope);
+    const aliases = includeAliases ? modernPackageAliases(packageNames, packageSource) : void 0;
+    return {
+        packages: [
+            ...packageNames
+        ],
+        specifier: modernPackageVersion(packageSource),
+        ...packageSource.registry ? {
+            registry: packageSource.registry
+        } : {},
+        ...aliases ? {
+            aliases
+        } : {}
+    };
+}
+export { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES, ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, WORKSPACE_PACKAGE_VERSION, createModernPackagesMetadata, modernAliasPackageName, modernPackageAliases, modernPackageSpecifier, modernPackageVersion };