@bleedingdev/modern-js-create 3.2.0-ultramodern.102 → 3.2.0-ultramodern.104

package/dist/types/locale/index.d.ts

@@ -1,3 +1,118 @@
-declare const i18n: any;
-declare const localeKeys: any;
+import { I18n } from '@modern-js/i18n-utils';
+declare const i18n: I18n;
+declare const localeKeys: {
+    prompt: {
+        projectName: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        invalidRouter: string;
+        invalidBffRuntime: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionRouter: string;
+        optionBff: string;
+        optionBffRuntime: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionVertical: string;
+        optionSub: string;
+        examples: string;
+        example1: string;
+        example2: string;
+        example3: string;
+        example4: string;
+        example5: string;
+        example6: string;
+        example7: string;
+        example8: string;
+        example9: string;
+        example10: string;
+        example11: string;
+        example12: string;
+        moreInfo: string;
+    };
+    version: {
+        message: string;
+    };
+} | {
+    prompt: {
+        projectName: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        invalidRouter: string;
+        invalidBffRuntime: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionRouter: string;
+        optionBff: string;
+        optionBffRuntime: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionVertical: string;
+        optionSub: string;
+        examples: string;
+        example1: string;
+        example2: string;
+        example3: string;
+        example4: string;
+        example5: string;
+        example6: string;
+        example7: string;
+        example8: string;
+        example9: string;
+        example10: string;
+        example11: string;
+        example12: string;
+        moreInfo: string;
+    };
+    version: {
+        message: string;
+    };
+};
 export { i18n, localeKeys };

package/dist/types/ultramodern-package-source.d.ts

@@ -0,0 +1,28 @@
+export declare const WORKSPACE_PACKAGE_VERSION = "workspace:*";
+export declare const BLEEDINGDEV_CREATE_PACKAGE = "@bleedingdev/modern-js-create";
+export declare const BLEEDINGDEV_PACKAGE_SCOPE = "bleedingdev";
+export declare const BLEEDINGDEV_PACKAGE_NAME_PREFIX = "modern-js-";
+export declare const BLEEDINGDEV_FRAMEWORK_VERSION_ENV = "MODERN_CREATE_ULTRAMODERN_FRAMEWORK_VERSION";
+export declare const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES: readonly ['@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'];
+export declare const ULTRAMODERN_WORKSPACE_MODERN_PACKAGES: readonly ['@modern-js/app-tools', '@modern-js/plugin-bff', '@modern-js/plugin-i18n', '@modern-js/plugin-tanstack', '@modern-js/runtime'];
+export type UltramodernPackageSourceStrategy = 'workspace' | 'install';
+export type ResolvedUltramodernPackageSource = {
+    strategy: UltramodernPackageSourceStrategy;
+    modernPackageVersion: string;
+    registry?: string;
+    aliasScope?: string;
+    aliasPackageNamePrefix?: string;
+};
+export type UltramodernModernPackagesMetadata = {
+    packages: string[];
+    specifier: string;
+    registry?: string;
+    aliases?: Record<string, string>;
+};
+export declare function modernPackageVersion(packageSource: ResolvedUltramodernPackageSource): string;
+export declare function modernAliasPackageName(packageName: string, packageSource: ResolvedUltramodernPackageSource): string;
+export declare function modernPackageSpecifier(packageName: string, packageSource: ResolvedUltramodernPackageSource): string;
+export declare function modernPackageAliases(packageNames: readonly string[], packageSource: ResolvedUltramodernPackageSource): Record<string, string> | undefined;
+export declare function createModernPackagesMetadata(packageNames: readonly string[], packageSource: ResolvedUltramodernPackageSource, options?: {
+    includeAliases?: boolean;
+}): UltramodernModernPackagesMetadata;

package/dist/types/ultramodern-workspace.d.ts

@@ -1,4 +1,4 @@
-type UltramodernPackageSourceStrategy = 'workspace' | 'install';
+import { type UltramodernPackageSourceStrategy } from './ultramodern-package-source';
 export type UltramodernWorkspaceOptions = {
     targetDir: string;
     packageName: string;
@@ -28,4 +28,3 @@ export declare const ultramodernWorkspaceVersions: {
     tailwind: string;
     tailwindPostcss: string;
 };
-export {};

package/package.json

@@ -21,7 +21,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.2.0-ultramodern.102",
+  "version": "3.2.0-ultramodern.104",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/index.js",
   "bin": {
@@ -41,7 +41,7 @@
     "@types/node": "^25.9.1",
     "@typescript/native-preview": "7.0.0-dev.20260527.2",
     "tsx": "^4.22.3",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.102"
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.104"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -54,6 +54,6 @@
     "start": "node ./dist/index.js"
   },
   "ultramodern": {
-    "frameworkVersion": "3.2.0-ultramodern.102"
+    "frameworkVersion": "3.2.0-ultramodern.104"
   }
 }

package/template/README.md

@@ -49,6 +49,7 @@ The default app is intentionally monolith-friendly:
 | --- | --- |
 | App routes | Locale-prefixed pages under `src/routes/[lang]` |
 | Copy | English and Czech resources in `config/public/locales` |
+| Web defaults | Local favicon/logo assets, localized metadata, semantic starter markup |
 | Styling | App-local CSS, with Tailwind files only when selected |
 | Server logic | Optional BFF entrypoints under `api/` |
 | Tests | Rstest smoke coverage in `tests/` |
@@ -66,6 +67,11 @@ real routes, actions, and API calls. Put user-visible text in
 `config/public/locales/<lang>/translation.json`, then render it through
 `react-i18next` or `@modern-js/plugin-i18n/runtime`.
 
+The starter keeps favicon and logo assets local in `config/favicon.svg` and
+`config/public/assets/ultramodern-logo.svg`. Replace those files when your app
+has product branding. The localized page title and description live in the same
+translation resources as the visible UI copy.
+
 Tune the preset in `modern.config.ts`. Production builds require
 `MODERN_PUBLIC_SITE_URL` so canonical and `hreflang` URLs use your deployed
 origin. The local fallback is `http://localhost:8080`.

package/template/config/favicon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="UltraModern.js">
+  <rect width="64" height="64" rx="12" fill="#111827"/>
+  <path fill="#35d399" d="M14 17h9v21c0 5 3 8 9 8s9-3 9-8V17h9v22c0 11-8 18-18 18s-18-7-18-18V17Z"/>
+  <path fill="#ffffff" d="M28 17h8v25h-8z"/>
+</svg>

package/template/config/public/assets/ultramodern-logo.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 160 160" role="img" aria-label="UltraModern.js logo">
+  <rect width="160" height="160" rx="28" fill="#111827"/>
+  <path fill="#35d399" d="M42 36h22v56c0 22 14 34 36 34s36-12 36-34V36h22v57c0 35-24 57-58 57S42 128 42 93V36Z"/>
+  <path fill="#ffffff" d="M76 36h20v74H76z"/>
+  <path fill="#8be8ff" d="M112 36h18v74h-18z"/>
+</svg>

package/template/config/public/locales/cs/translation.json

@@ -33,7 +33,12 @@
       "switcher": "Jazyk"
     },
     "logoAlt": "Logo UltraModern.js",
+    "meta": {
+      "description": "Lokalizovany starter aplikace UltraModern.js se silnymi vychozimi hodnotami pro komplexni produkty.",
+      "title": "UltraModern.js Starter"
+    },
     "name": "Jednoduchy starter aplikace",
+    "skipLink": "Preskocit na obsah",
     "title": "UltraModern.js Starter"
   }
 }

package/template/config/public/locales/en/translation.json

@@ -33,7 +33,12 @@
       "switcher": "Language"
     },
     "logoAlt": "UltraModern.js Logo",
+    "meta": {
+      "description": "A localized UltraModern.js app starter with strong defaults for complex products.",
+      "title": "UltraModern.js Starter"
+    },
     "name": "Simple app starter",
+    "skipLink": "Skip to content",
     "title": "UltraModern.js Starter"
   }
 }

package/template/modern.config.ts.handlebars

@@ -39,7 +39,13 @@ export default defineConfig(
 {{/if}}        runtimeFramework: '{{bffRuntime}}',
       },
 
-{{/if}}      plugins: [
+{{/if}}      html: {
+        meta: {
+          viewport: 'width=device-width, initial-scale=1.0, viewport-fit=cover',
+        },
+        title: 'UltraModern.js Starter',
+      },
+      plugins: [
         appTools(),
         i18nPlugin({
           localeDetection: {
@@ -64,8 +70,8 @@ export default defineConfig(
       enableBffRequestId,
       enableModuleFederationSSR,
       enableTelemetryExporters,
-      telemetryFailLoudStartup,
       ...(typeof otlpEndpoint === 'string' ? { otlpEndpoint } : {}),
+      telemetryFailLoudStartup,
       ...(typeof victoriaMetricsEndpoint === 'string' ? { victoriaMetricsEndpoint } : {}),
     },
   ),

package/template/scripts/check-i18n-strings.mjs

@@ -7,6 +7,97 @@ const ignoredDirectories = new Set(['.modern', '.modernjs', 'dist', 'node_module
 const visibleAttributePattern =
   /\s(?:aria-label|alt|placeholder|title)=["']([^"']*[A-Za-z][^"']*)["']/gu;
 const jsxTextPattern = />([^<>{}]*[A-Za-z][^<>{}]*)</gu;
+const jsxIntrinsicTags = new Set([
+  'a',
+  'abbr',
+  'address',
+  'area',
+  'article',
+  'aside',
+  'audio',
+  'b',
+  'blockquote',
+  'body',
+  'br',
+  'button',
+  'canvas',
+  'caption',
+  'cite',
+  'code',
+  'col',
+  'colgroup',
+  'data',
+  'datalist',
+  'dd',
+  'del',
+  'details',
+  'dfn',
+  'dialog',
+  'div',
+  'dl',
+  'dt',
+  'em',
+  'fieldset',
+  'figcaption',
+  'figure',
+  'footer',
+  'form',
+  'h1',
+  'h2',
+  'h3',
+  'h4',
+  'h5',
+  'h6',
+  'head',
+  'header',
+  'hr',
+  'html',
+  'i',
+  'iframe',
+  'img',
+  'input',
+  'label',
+  'legend',
+  'li',
+  'link',
+  'main',
+  'mark',
+  'menu',
+  'meta',
+  'meter',
+  'nav',
+  'ol',
+  'option',
+  'p',
+  'picture',
+  'pre',
+  'progress',
+  'q',
+  'script',
+  'section',
+  'select',
+  'small',
+  'source',
+  'span',
+  'strong',
+  'style',
+  'summary',
+  'svg',
+  'table',
+  'tbody',
+  'td',
+  'template',
+  'textarea',
+  'tfoot',
+  'th',
+  'thead',
+  'time',
+  'title',
+  'tr',
+  'u',
+  'ul',
+  'video',
+]);
 
 const collectFiles = (directory) => {
   if (!fs.existsSync(directory)) {
@@ -37,6 +128,24 @@ const isCodeElementText = (content, index) => {
   }
   return /^<code(?:\s|>)/u.test(content.slice(tagStart, index));
 };
+const isJsxTagEnd = (content, index) => {
+  const tagStart = content.lastIndexOf('<', index);
+  if (tagStart === -1 || content.slice(tagStart + 1, index).includes('<')) {
+    return false;
+  }
+  const match = content
+    .slice(tagStart, index + 1)
+    .match(/^<\/?\s*([A-Za-z][\w:.-]*)\b[^<>]*>$/u);
+  if (!match) {
+    return false;
+  }
+  const [, tagName] = match;
+  return (
+    /^[A-Z]/u.test(tagName) ||
+    tagName.includes('-') ||
+    jsxIntrinsicTags.has(tagName)
+  );
+};
 const isIgnoredLine = (content, index) => {
   const lineStart = content.lastIndexOf('\n', index) + 1;
   const lineEnd = content.indexOf('\n', index);
@@ -54,20 +163,23 @@ const violations = [];
 for (const filePath of scanRoots.flatMap(collectFiles)) {
   const content = fs.readFileSync(filePath, 'utf-8');
   for (const match of content.matchAll(visibleAttributePattern)) {
+    const [, visibleText] = match;
     if (!isIgnoredLine(content, match.index ?? 0)) {
       violations.push({
         filePath,
         line: lineNumberForIndex(content, match.index ?? 0),
-        text: match[1].trim(),
+        text: visibleText.trim(),
       });
     }
   }
 
   for (const match of content.matchAll(jsxTextPattern)) {
-    const text = match[1].replaceAll(/\s+/gu, ' ').trim();
+    const [, jsxText] = match;
+    const text = jsxText.replaceAll(/\s+/gu, ' ').trim();
     if (
       text &&
       !isIgnoredLine(content, match.index ?? 0) &&
+      isJsxTagEnd(content, match.index ?? 0) &&
       !isCodeElementText(content, match.index ?? 0)
     ) {
       violations.push({

package/template/scripts/validate-ultramodern.mjs.handlebars

@@ -8,6 +8,9 @@ const packageSourcePath = path.resolve(
   process.cwd(),
   '.modernjs/ultramodern-package-source.json',
 );
+const readText = (relativePath) =>
+  fs.readFileSync(path.resolve(process.cwd(), relativePath), 'utf-8');
+const readJson = (relativePath) => JSON.parse(readText(relativePath));
 const readPnpmConfig = (key) => {
   const env = Object.fromEntries(
     Object.entries(process.env).filter(
@@ -109,6 +112,8 @@ const requiredPaths = [
 {{/if}}
   'config/public/locales/en/translation.json',
   'config/public/locales/cs/translation.json',
+  'config/favicon.svg',
+  'config/public/assets/ultramodern-logo.svg',
   'src/modern-app-env.d.ts',
   'src/routes/index.css',
   'src/routes/layout.tsx',
@@ -241,6 +246,11 @@ const packageJson = JSON.parse(
   fs.readFileSync(path.resolve(process.cwd(), 'package.json'), 'utf-8'),
 );
 const packageSource = JSON.parse(fs.readFileSync(packageSourcePath, 'utf-8'));
+const routePage = readText('src/routes/[lang]/page.tsx');
+const routeCss = readText('src/routes/index.css');
+const modernConfig = readText('modern.config.ts');
+const enLocale = readJson('config/public/locales/en/translation.json');
+const csLocale = readJson('config/public/locales/cs/translation.json');
 const unresolvedTemplateMarker = String.fromCodePoint(123, 123);
 if (JSON.stringify(packageJson).includes(unresolvedTemplateMarker)) {
   console.error('package.json contains unresolved template markers');
@@ -250,6 +260,89 @@ if (JSON.stringify(packageSource).includes(unresolvedTemplateMarker)) {
   console.error('package source metadata contains unresolved template markers');
   process.exit(1);
 }
+
+for (const [fileName, text] of [
+  ['src/routes/[lang]/page.tsx', routePage],
+  ['src/routes/index.css', routeCss],
+  ['modern.config.ts', modernConfig],
+]) {
+  if (text.includes('lf3-static.bytednsdoc.com')) {
+    console.error(`${fileName} must not depend on remote starter assets`);
+    process.exit(1);
+  }
+}
+
+for (const requiredSnippet of [
+  '<Helmet',
+  'htmlAttributes={{',
+  'dir: languageDirections[currentLanguage]',
+  'lang: currentLanguage',
+  '<title>{pageTitle}</title>',
+  '<meta name="description" content={pageDescription} />',
+  '<main id="starter-main" className="starter-main">',
+  '<h1 id="starter-heading" className="title">',
+  'src="/assets/ultramodern-logo.svg"',
+  'height={96}',
+  'width={96}',
+  '<span aria-hidden="true" className="arrow-right" />',
+]) {
+  if (!routePage.includes(requiredSnippet)) {
+    console.error(`Generated route page must retain starter correctness snippet: ${requiredSnippet}`);
+    process.exit(1);
+  }
+}
+
+for (const forbiddenSnippet of ['src="https://', '<div className="title">']) {
+  if (routePage.includes(forbiddenSnippet)) {
+    console.error(`Generated route page must not contain ${forbiddenSnippet}`);
+    process.exit(1);
+  }
+}
+
+for (const requiredSnippet of [
+  'width=device-width, initial-scale=1.0, viewport-fit=cover',
+  "title: 'UltraModern.js Starter'",
+]) {
+  if (!modernConfig.includes(requiredSnippet)) {
+    console.error(`modern.config.ts must retain ${requiredSnippet}`);
+    process.exit(1);
+  }
+}
+if (modernConfig.includes('user-scalable=no') || modernConfig.includes('maximum-scale')) {
+  console.error('modern.config.ts must not disable user zoom');
+  process.exit(1);
+}
+
+for (const requiredSnippet of [
+  'min-block-size: 100dvh',
+  'grid-template-columns: repeat(auto-fit, minmax(min(100%, 17rem), 1fr))',
+  ':focus-visible',
+  '@media (prefers-reduced-motion: reduce)',
+  '.skip-link',
+]) {
+  if (!routeCss.includes(requiredSnippet)) {
+    console.error(`Starter CSS must retain ${requiredSnippet}`);
+    process.exit(1);
+  }
+}
+if (routeCss.includes('width: 1100px') || /\.card:focus(?!-visible)/u.test(routeCss)) {
+  console.error('Starter CSS must not reintroduce fixed grid width or focus transform styling');
+  process.exit(1);
+}
+
+for (const [localeName, locale] of [
+  ['en', enLocale],
+  ['cs', csLocale],
+]) {
+  if (
+    typeof locale.home?.meta?.title !== 'string' ||
+    typeof locale.home?.meta?.description !== 'string' ||
+    typeof locale.home?.skipLink !== 'string'
+  ) {
+    console.error(`${localeName} locale must include starter metadata and skip-link copy`);
+    process.exit(1);
+  }
+}
 {{#unless isSubproject}}
 const skillsLock = JSON.parse(
   fs.readFileSync(path.resolve(process.cwd(), '.agents/skills-lock.json'), 'utf-8'),
@@ -388,6 +481,11 @@ if (
   process.exit(1);
 }
 
+if (packageJson.modernjs?.packageSource?.strategy !== packageSource.strategy) {
+  console.error('package.json package source strategy must match package source metadata');
+  process.exit(1);
+}
+
 if (packageSource.schemaVersion !== 1) {
   console.error('Package source metadata must use schemaVersion 1');
   process.exit(1);
@@ -403,21 +501,33 @@ if (packageSource.strategy !== 'workspace' && packageSource.strategy !== 'instal
   process.exit(1);
 }
 
-const expectedModernPackages = [
-  '@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 declaredModernPackages = packageSource.modernPackages?.packages;
+if (!Array.isArray(declaredModernPackages) || declaredModernPackages.length === 0) {
+  console.error('Package source metadata must declare the generated Modern package cohort');
+  process.exit(1);
+}
 
-for (const packageName of expectedModernPackages) {
-  if (!packageSource.modernPackages?.packages?.includes(packageName)) {
-    console.error(`Package source metadata must include ${packageName}`);
-    process.exit(1);
-  }
+const invalidModernPackages = declaredModernPackages.filter(
+  (packageName) => typeof packageName !== 'string' || !packageName.startsWith('@modern-js/'),
+);
+if (invalidModernPackages.length > 0) {
+  console.error(`Package source metadata contains invalid Modern packages: ${invalidModernPackages.join(', ')}`);
+  process.exit(1);
+}
+
+const packageJsonModernDependencies = [
+  ...new Set(
+    ['dependencies', 'devDependencies']
+      .flatMap((section) => Object.keys(packageJson[section] ?? {}))
+      .filter((packageName) => packageName.startsWith('@modern-js/')),
+  ),
+];
+const missingMetadataPackages = packageJsonModernDependencies.filter(
+  (packageName) => !declaredModernPackages.includes(packageName),
+);
+if (missingMetadataPackages.length > 0) {
+  console.error(`Package source metadata must include package.json Modern dependencies: ${missingMetadataPackages.join(', ')}`);
+  process.exit(1);
 }
 
 const expectedModernSpecifier = packageSource.modernPackages?.specifier;
@@ -442,32 +552,15 @@ const expectedModernDependency = (packageName) => {
     : expectedModernSpecifier;
 };
 
-for (const packageName of [
-  '@modern-js/runtime',
-  '@modern-js/plugin-i18n',
-  '@modern-js/plugin-tanstack',
-]) {
-  if (
-    packageJson.dependencies?.[packageName] &&
-    packageJson.dependencies[packageName] !== expectedModernDependency(packageName)
-  ) {
-    console.error(`Dependency ${packageName} must match package source metadata`);
-    process.exit(1);
-  }
-}
-
-for (const packageName of [
-  '@modern-js/app-tools',
-  '@modern-js/adapter-rstest',
-  '@modern-js/tsconfig',
-  '@modern-js/plugin-bff',
-]) {
-  if (
-    packageJson.devDependencies?.[packageName] &&
-    packageJson.devDependencies[packageName] !== expectedModernDependency(packageName)
-  ) {
-    console.error(`Dev dependency ${packageName} must match package source metadata`);
-    process.exit(1);
+for (const section of ['dependencies', 'devDependencies']) {
+  for (const packageName of declaredModernPackages) {
+    if (
+      packageJson[section]?.[packageName] &&
+      packageJson[section][packageName] !== expectedModernDependency(packageName)
+    ) {
+      console.error(`${section}.${packageName} must match package source metadata`);
+      process.exit(1);
+    }
   }
 }