@niro53/store-tools 0.1.0

package/bin/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const distEntry = join(__dirname, '..', 'dist', 'cli.js');
+const srcEntry  = join(__dirname, '..', 'src', 'cli.ts');
+
+if (existsSync(distEntry)) {
+  await import(distEntry);
+} else if (existsSync(srcEntry)) {
+  await import(srcEntry);
+} else {
+  console.error('✗ @niro/store-tools: no compiled dist/cli.js and no src/cli.ts. Run `pnpm build` first.');
+  process.exit(1);
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { resolve, join } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { readFileSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+// ── Resolve monorepo root + app dir from slug ─────────────────────────────────
+function findMonorepoRoot(start) {
+    let dir = start;
+    for (let i = 0; i < 10; i++) {
+        try {
+            const raw = readFileSync(join(dir, 'package.json'), 'utf-8');
+            const pkg = JSON.parse(raw);
+            if (pkg.workspaces)
+                return dir;
+        }
+        catch { /* keep walking up */ }
+        const parent = resolve(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return start;
+}
+async function loadConfig(appDir) {
+    const cfgPath = join(appDir, 'store.config.ts');
+    try {
+        const mod = await import(pathToFileURL(cfgPath).href);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+        return (mod.default ?? mod);
+    }
+    catch (err) {
+        console.error(`✗ Could not load ${cfgPath}: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function resolveAppDir(opts) {
+    // 1) Explicit --app-dir <path> wins (standalone consumers outside the monorepo).
+    if (opts.appDir) {
+        const dir = resolve(process.cwd(), opts.appDir);
+        try {
+            await readFile(join(dir, 'store.config.ts'), 'utf-8');
+            return dir;
+        }
+        catch {
+            console.error(`✗ No store.config.ts found at ${dir}`);
+            process.exit(1);
+        }
+    }
+    // 2) --app <slug>: monorepo lookup (apps/<slug>).
+    if (opts.app) {
+        const root = findMonorepoRoot(process.cwd());
+        const appDir = join(root, 'apps', opts.app);
+        try {
+            await readFile(join(appDir, 'store.config.ts'), 'utf-8');
+            return appDir;
+        }
+        catch {
+            console.error(`✗ No store.config.ts found at ${appDir}`);
+            console.error(`  Run "pnpm store validate --app ${opts.app}" to see errors.`);
+            process.exit(1);
+        }
+    }
+    // 3) Fallback: walk up from cwd looking for store.config.ts (standalone repos).
+    let dir = process.cwd();
+    for (let i = 0; i < 8; i++) {
+        try {
+            await readFile(join(dir, 'store.config.ts'), 'utf-8');
+            return dir;
+        }
+        catch { /* keep walking */ }
+        const parent = resolve(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    console.error('✗ No store.config.ts found. Pass --app <slug> (monorepo) or --app-dir <path> (standalone).');
+    process.exit(1);
+}
+// ── CLI ───────────────────────────────────────────────────────────────────────
+const program = new Command('niro-store').version('0.0.1');
+program
+    .command('render')
+    .description('Render PNG screenshots for App Store and/or Play Store')
+    .option('--app <slug>', 'App slug (maps to apps/<slug> in monorepo)')
+    .option('--app-dir <path>', 'App directory (standalone consumers; defaults to cwd)')
+    .option('--locale <locales>', 'Comma-separated locales (default: all in config)')
+    .option('--scene <scenes>', 'Comma-separated scene out-names (default: all)')
+    .option('--platform <platforms>', 'appstore,play (default: both)')
+    .action(async (opts) => {
+    const { renderScreenshots } = await import('./render.js');
+    const appDir = await resolveAppDir({ ...(opts.app ? { app: opts.app } : {}), ...(opts.appDir ? { appDir: opts.appDir } : {}) });
+    const config = await loadConfig(appDir);
+    await renderScreenshots({
+        appDir,
+        config,
+        ...(opts.locale ? { locales: opts.locale.split(',').map((s) => s.trim()) } : {}),
+        ...(opts.scene ? { scenes: opts.scene.split(',').map((s) => s.trim()) } : {}),
+        ...(opts.platform ? { platforms: opts.platform.split(',').map((s) => s.trim()) } : {}),
+    });
+});
+program
+    .command('metadata')
+    .description('Sync store.config.ts → fastlane/metadata/*/  (title, desc, keywords …)')
+    .option('--app <slug>', 'App slug (monorepo)')
+    .option('--app-dir <path>', 'App directory (standalone; defaults to cwd)')
+    .option('--platform <platforms>', 'appstore,play (default: both)')
+    .action(async (opts) => {
+    const { syncMetadata } = await import('./metadata.js');
+    const appDir = await resolveAppDir({ ...(opts.app ? { app: opts.app } : {}), ...(opts.appDir ? { appDir: opts.appDir } : {}) });
+    const config = await loadConfig(appDir);
+    await syncMetadata({
+        appDir,
+        config,
+        ...(opts.platform ? { platforms: opts.platform.split(',').map((s) => s.trim()) } : {}),
+    });
+});
+program
+    .command('validate')
+    .description('Validate store.config.ts (length limits, locale completeness, scene files)')
+    .option('--app <slug>', 'Validate a single app by slug (monorepo)')
+    .option('--app-dir <path>', 'Validate an app directory (standalone; defaults to cwd)')
+    .option('--all', 'Validate all apps in apps/ (monorepo only)')
+    .option('--strict', 'Exit 1 even for warnings (missing optional fields)')
+    .action(async (opts) => {
+    const { validateConfig, validateAll } = await import('./validate.js');
+    const root = findMonorepoRoot(process.cwd());
+    if (opts.all) {
+        const { readdir } = await import('node:fs/promises');
+        const appsDir = join(root, 'apps');
+        const { access: fsAccess } = await import('node:fs/promises');
+        const slugs = await readdir(appsDir).catch(() => []);
+        const entries = [];
+        for (const slug of slugs) {
+            const appDir = join(appsDir, slug);
+            const cfgPath = join(appDir, 'store.config.ts');
+            try {
+                await fsAccess(cfgPath);
+            }
+            catch {
+                continue;
+            }
+            try {
+                const config = await loadConfig(appDir);
+                entries.push({ appDir, config });
+            }
+            catch { /* malformed config — loadConfig already printed the error */ }
+        }
+        const ok = await validateAll(entries, { checkSceneFiles: true });
+        if (!ok)
+            process.exit(1);
+    }
+    else {
+        const appDir = await resolveAppDir({ ...(opts.app ? { app: opts.app } : {}), ...(opts.appDir ? { appDir: opts.appDir } : {}) });
+        const config = await loadConfig(appDir);
+        const result = await validateConfig(appDir, config, { checkSceneFiles: true });
+        for (const err of result.errors) {
+            const isHard = !['shortDescription', 'subtitle', 'releaseNotes', 'appleId', 'itcTeamId'].some((k) => err.field.includes(k));
+            console.log(`${isHard ? '  ✗' : '  ⚠'} ${err.field}: ${err.message}`);
+        }
+        if (!result.ok || (opts.strict && result.errors.length > 0))
+            process.exit(1);
+    }
+});
+program
+    .command('upload <platform>')
+    .description('Upload to App Store (ios) or Play Store (android)')
+    .option('--app <slug>', 'App slug (monorepo)')
+    .option('--app-dir <path>', 'App directory (standalone; defaults to cwd)')
+    .option('--track <track>', 'internal | alpha | beta | production (Play) or beta | production (iOS)', 'internal')
+    .action(async (platform, opts) => {
+    const { execSync } = await import('node:child_process');
+    const appDir = await resolveAppDir({ ...(opts.app ? { app: opts.app } : {}), ...(opts.appDir ? { appDir: opts.appDir } : {}) });
+    const config = await loadConfig(appDir);
+    const { syncMetadata } = await import('./metadata.js');
+    const { renderScreenshots } = await import('./render.js');
+    await syncMetadata({ appDir, config });
+    await renderScreenshots({ appDir, config });
+    const fastlaneDir = join(appDir, platform === 'ios' ? 'ios/App' : 'android');
+    const lane = opts.track === 'production' ? 'release' : 'beta';
+    const envString = `APP_SLUG=${config.slug} APP_IDENTIFIER=${config.bundleId}`;
+    console.log(`\n→ bundle exec fastlane ${platform === 'ios' ? 'ios' : 'android'} ${lane}\n`);
+    execSync(`${envString} bundle exec fastlane ${platform === 'ios' ? 'ios' : 'android'} ${lane}`, { cwd: fastlaneDir, stdio: 'inherit' });
+});
+program
+    .command('promote')
+    .description('Promote an existing Play Store track to a higher track')
+    .option('--app <slug>', 'App slug (monorepo)')
+    .option('--app-dir <path>', 'App directory (standalone; defaults to cwd)')
+    .option('--from <track>', 'Source track', 'internal')
+    .option('--to <track>', 'Target track', 'production')
+    .option('--rollout <pct>', 'Rollout fraction (0.0–1.0)', '0.1')
+    .action(async (opts) => {
+    const { execSync } = await import('node:child_process');
+    const appDir = await resolveAppDir({ ...(opts.app ? { app: opts.app } : {}), ...(opts.appDir ? { appDir: opts.appDir } : {}) });
+    const config = await loadConfig(appDir);
+    const fastlaneDir = join(appDir, 'android');
+    const envString = [
+        `APP_SLUG=${config.slug}`,
+        `APP_IDENTIFIER=${config.bundleId}`,
+        `PROMOTE_FROM=${opts.from}`,
+        `PROMOTE_TO=${opts.to}`,
+        `PROMOTE_ROLLOUT=${opts.rollout}`,
+    ].join(' ');
+    execSync(`${envString} bundle exec fastlane android promote`, { cwd: fastlaneDir, stdio: 'inherit' });
+});
+program.parse(process.argv);

package/dist/config.d.ts

@@ -0,0 +1,234 @@
+import * as z from 'zod';
+export declare const SceneSchema: z.ZodObject<{
+    html: z.ZodString;
+    out: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<["screen", "feature"]>>;
+}, "strip", z.ZodTypeAny, {
+    html: string;
+    out: string;
+    kind: "screen" | "feature";
+}, {
+    html: string;
+    out: string;
+    kind?: "screen" | "feature" | undefined;
+}>;
+export type Scene = z.infer<typeof SceneSchema>;
+export declare const LocaleMetaSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    releaseNotes: z.ZodOptional<z.ZodString>;
+    privacyUrl: z.ZodString;
+    supportUrl: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodString>;
+    promotionalText: z.ZodOptional<z.ZodString>;
+    shortDescription: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    privacyUrl: string;
+    supportUrl: string;
+    releaseNotes?: string | undefined;
+    subtitle?: string | undefined;
+    keywords?: string | undefined;
+    promotionalText?: string | undefined;
+    shortDescription?: string | undefined;
+}, {
+    name: string;
+    description: string;
+    privacyUrl: string;
+    supportUrl: string;
+    releaseNotes?: string | undefined;
+    subtitle?: string | undefined;
+    keywords?: string | undefined;
+    promotionalText?: string | undefined;
+    shortDescription?: string | undefined;
+}>;
+export type LocaleMeta = z.infer<typeof LocaleMetaSchema>;
+export declare const AppStoreConfigSchema: z.ZodOptional<z.ZodObject<{
+    primaryCategory: z.ZodOptional<z.ZodString>;
+    secondaryCategory: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    primaryCategory?: string | undefined;
+    secondaryCategory?: string | undefined;
+}, {
+    primaryCategory?: string | undefined;
+    secondaryCategory?: string | undefined;
+}>>;
+export declare const PlayConfigSchema: z.ZodOptional<z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    contentRating: z.ZodDefault<z.ZodEnum<["EVERYONE", "EVERYONE_10_PLUS", "TEEN", "MATURE_17_PLUS"]>>;
+}, "strip", z.ZodTypeAny, {
+    contentRating: "EVERYONE" | "EVERYONE_10_PLUS" | "TEEN" | "MATURE_17_PLUS";
+    category?: string | undefined;
+}, {
+    category?: string | undefined;
+    contentRating?: "EVERYONE" | "EVERYONE_10_PLUS" | "TEEN" | "MATURE_17_PLUS" | undefined;
+}>>;
+export declare const StoreConfigSchema: z.ZodObject<{
+    slug: z.ZodString;
+    bundleId: z.ZodString;
+    appleId: z.ZodOptional<z.ZodString>;
+    itcTeamId: z.ZodOptional<z.ZodString>;
+    locales: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        releaseNotes: z.ZodOptional<z.ZodString>;
+        privacyUrl: z.ZodString;
+        supportUrl: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+        keywords: z.ZodOptional<z.ZodString>;
+        promotionalText: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        privacyUrl: string;
+        supportUrl: string;
+        releaseNotes?: string | undefined;
+        subtitle?: string | undefined;
+        keywords?: string | undefined;
+        promotionalText?: string | undefined;
+        shortDescription?: string | undefined;
+    }, {
+        name: string;
+        description: string;
+        privacyUrl: string;
+        supportUrl: string;
+        releaseNotes?: string | undefined;
+        subtitle?: string | undefined;
+        keywords?: string | undefined;
+        promotionalText?: string | undefined;
+        shortDescription?: string | undefined;
+    }>>, Record<string, {
+        name: string;
+        description: string;
+        privacyUrl: string;
+        supportUrl: string;
+        releaseNotes?: string | undefined;
+        subtitle?: string | undefined;
+        keywords?: string | undefined;
+        promotionalText?: string | undefined;
+        shortDescription?: string | undefined;
+    }>, Record<string, {
+        name: string;
+        description: string;
+        privacyUrl: string;
+        supportUrl: string;
+        releaseNotes?: string | undefined;
+        subtitle?: string | undefined;
+        keywords?: string | undefined;
+        promotionalText?: string | undefined;
+        shortDescription?: string | undefined;
+    }>>;
+    scenes: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        html: z.ZodString;
+        out: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<["screen", "feature"]>>;
+    }, "strip", z.ZodTypeAny, {
+        html: string;
+        out: string;
+        kind: "screen" | "feature";
+    }, {
+        html: string;
+        out: string;
+        kind?: "screen" | "feature" | undefined;
+    }>, "many">, {
+        html: string;
+        out: string;
+        kind: "screen" | "feature";
+    }[], {
+        html: string;
+        out: string;
+        kind?: "screen" | "feature" | undefined;
+    }[]>;
+    appstore: z.ZodOptional<z.ZodObject<{
+        primaryCategory: z.ZodOptional<z.ZodString>;
+        secondaryCategory: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        primaryCategory?: string | undefined;
+        secondaryCategory?: string | undefined;
+    }, {
+        primaryCategory?: string | undefined;
+        secondaryCategory?: string | undefined;
+    }>>;
+    play: z.ZodOptional<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        contentRating: z.ZodDefault<z.ZodEnum<["EVERYONE", "EVERYONE_10_PLUS", "TEEN", "MATURE_17_PLUS"]>>;
+    }, "strip", z.ZodTypeAny, {
+        contentRating: "EVERYONE" | "EVERYONE_10_PLUS" | "TEEN" | "MATURE_17_PLUS";
+        category?: string | undefined;
+    }, {
+        category?: string | undefined;
+        contentRating?: "EVERYONE" | "EVERYONE_10_PLUS" | "TEEN" | "MATURE_17_PLUS" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    bundleId: string;
+    locales: Record<string, {
+        name: string;
+        description: string;
+        privacyUrl: string;
+        supportUrl: string;
+        releaseNotes?: string | undefined;
+        subtitle?: string | undefined;
+        keywords?: string | undefined;
+        promotionalText?: string | undefined;
+        shortDescription?: string | undefined;
+    }>;
+    scenes: {
+        html: string;
+        out: string;
+        kind: "screen" | "feature";
+    }[];
+    appleId?: string | undefined;
+    itcTeamId?: string | undefined;
+    appstore?: {
+        primaryCategory?: string | undefined;
+        secondaryCategory?: string | undefined;
+    } | undefined;
+    play?: {
+        contentRating: "EVERYONE" | "EVERYONE_10_PLUS" | "TEEN" | "MATURE_17_PLUS";
+        category?: string | undefined;
+    } | undefined;
+}, {
+    slug: string;
+    bundleId: string;
+    locales: Record<string, {
+        name: string;
+        description: string;
+        privacyUrl: string;
+        supportUrl: string;
+        releaseNotes?: string | undefined;
+        subtitle?: string | undefined;
+        keywords?: string | undefined;
+        promotionalText?: string | undefined;
+        shortDescription?: string | undefined;
+    }>;
+    scenes: {
+        html: string;
+        out: string;
+        kind?: "screen" | "feature" | undefined;
+    }[];
+    appleId?: string | undefined;
+    itcTeamId?: string | undefined;
+    appstore?: {
+        primaryCategory?: string | undefined;
+        secondaryCategory?: string | undefined;
+    } | undefined;
+    play?: {
+        category?: string | undefined;
+        contentRating?: "EVERYONE" | "EVERYONE_10_PLUS" | "TEEN" | "MATURE_17_PLUS" | undefined;
+    } | undefined;
+}>;
+export type StoreConfig = z.infer<typeof StoreConfigSchema>;
+/**
+ * Typed identity helper — validates at call-site (Zod parse) and infers the
+ * StoreConfig type so IDEs surface field completion and inline errors.
+ *
+ * Usage (apps/<slug>/store.config.ts):
+ *
+ *   import { defineStoreConfig } from '@niro/store-tools';
+ *   export default defineStoreConfig({ … });
+ */
+export declare function defineStoreConfig(raw: unknown): StoreConfig;

package/dist/config.js

@@ -0,0 +1,71 @@
+import * as z from 'zod';
+// ── Locale string limits (Apple / Google Play maximums) ──────────────────────
+const appStoreLimits = {
+    name: 30,
+    subtitle: 30,
+    keywords: 100,
+    promotionalText: 170,
+    description: 4000,
+    releaseNotes: 4000,
+};
+const playLimits = {
+    name: 50,
+    shortDescription: 80,
+    description: 4000,
+    releaseNotes: 500,
+};
+// ── Scene definition ──────────────────────────────────────────────────────────
+export const SceneSchema = z.object({
+    html: z.string().endsWith('.html'),
+    out: z.string().min(1),
+    kind: z.enum(['screen', 'feature']).default('screen'),
+});
+// ── Per-locale metadata ───────────────────────────────────────────────────────
+export const LocaleMetaSchema = z.object({
+    // Shared App Store + Play Store
+    name: z.string().max(appStoreLimits.name),
+    description: z.string().max(appStoreLimits.description),
+    releaseNotes: z.string().max(appStoreLimits.description).optional(),
+    privacyUrl: z.string().url(),
+    supportUrl: z.string().url(),
+    // App Store only
+    subtitle: z.string().max(appStoreLimits.subtitle).optional(),
+    keywords: z.string().max(appStoreLimits.keywords).optional(),
+    promotionalText: z.string().max(appStoreLimits.promotionalText).optional(),
+    // Play Store only
+    shortDescription: z.string().max(playLimits.shortDescription).optional(),
+});
+// ── Platform-specific overrides ───────────────────────────────────────────────
+export const AppStoreConfigSchema = z.object({
+    primaryCategory: z.string().optional(),
+    secondaryCategory: z.string().optional(),
+}).optional();
+export const PlayConfigSchema = z.object({
+    category: z.string().optional(),
+    contentRating: z.enum(['EVERYONE', 'EVERYONE_10_PLUS', 'TEEN', 'MATURE_17_PLUS']).default('EVERYONE'),
+}).optional();
+// ── Top-level StoreConfig ─────────────────────────────────────────────────────
+export const StoreConfigSchema = z.object({
+    slug: z.string().min(1).regex(/^[a-z0-9-]+$/, 'slug must be kebab-case'),
+    bundleId: z.string().min(1),
+    // Apple App Store Connect
+    appleId: z.string().optional(),
+    itcTeamId: z.string().optional(),
+    // Locales: at least one entry; each key is the internal locale code (en, cs, pl …)
+    locales: z.record(z.string().min(2).max(5), LocaleMetaSchema).refine((loc) => Object.keys(loc).length >= 1, 'at least one locale is required'),
+    scenes: z.array(SceneSchema).min(1).max(10).refine((scenes) => scenes.filter((s) => s.kind === 'feature').length <= 1, 'at most one feature-graphic scene allowed'),
+    appstore: AppStoreConfigSchema,
+    play: PlayConfigSchema,
+});
+/**
+ * Typed identity helper — validates at call-site (Zod parse) and infers the
+ * StoreConfig type so IDEs surface field completion and inline errors.
+ *
+ * Usage (apps/<slug>/store.config.ts):
+ *
+ *   import { defineStoreConfig } from '@niro/store-tools';
+ *   export default defineStoreConfig({ … });
+ */
+export function defineStoreConfig(raw) {
+    return StoreConfigSchema.parse(raw);
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { defineStoreConfig, StoreConfigSchema } from './config.js';
+export type { StoreConfig, LocaleMeta, Scene } from './config.js';
+export { renderScreenshots } from './render.js';
+export type { RenderOptions } from './render.js';
+export { syncMetadata } from './metadata.js';
+export type { MetadataOptions } from './metadata.js';
+export { validateConfig, validateAll } from './validate.js';
+export type { ValidationResult, ValidationError } from './validate.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { defineStoreConfig, StoreConfigSchema } from './config.js';
+export { renderScreenshots } from './render.js';
+export { syncMetadata } from './metadata.js';
+export { validateConfig, validateAll } from './validate.js';

package/dist/metadata.d.ts

@@ -0,0 +1,8 @@
+import type { StoreConfig } from './config.js';
+export interface MetadataOptions {
+    /** Absolute path to the app directory (e.g. /path/to/apps/autoskola-ai) */
+    appDir: string;
+    config: StoreConfig;
+    platforms?: ('appstore' | 'play')[];
+}
+export declare function syncMetadata({ appDir, config, platforms, }: MetadataOptions): Promise<void>;

package/dist/metadata.js

@@ -0,0 +1,85 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// ── Locale code maps ──────────────────────────────────────────────────────────
+// internal → { appstore, play }
+const LOCALE_MAP = {
+    en: { appstore: 'en-US', play: 'en-US' },
+    cs: { appstore: 'cs', play: 'cs-CZ' },
+    pl: { appstore: 'pl', play: 'pl-PL' },
+    de: { appstore: 'de-DE', play: 'de-DE' },
+    sk: { appstore: 'sk', play: 'sk' },
+    fr: { appstore: 'fr-FR', play: 'fr-FR' },
+    hu: { appstore: 'hu', play: 'hu' },
+};
+function toAppStoreLocale(internal) {
+    return LOCALE_MAP[internal]?.appstore ?? internal;
+}
+function toPlayLocale(internal) {
+    return LOCALE_MAP[internal]?.play ?? internal;
+}
+// ── Write helpers ─────────────────────────────────────────────────────────────
+async function write(dir, filename, content) {
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, filename), content.trim() + '\n', 'utf-8');
+}
+// ── App Store metadata writer ─────────────────────────────────────────────────
+async function writeAppStoreMeta(appDir, internalLocale, meta) {
+    const dir = join(appDir, 'fastlane', 'metadata', toAppStoreLocale(internalLocale));
+    const tasks = [
+        write(dir, 'name.txt', meta.name),
+        write(dir, 'description.txt', meta.description),
+        write(dir, 'privacy_url.txt', meta.privacyUrl),
+        write(dir, 'support_url.txt', meta.supportUrl),
+    ];
+    if (meta.subtitle)
+        tasks.push(write(dir, 'subtitle.txt', meta.subtitle));
+    if (meta.keywords)
+        tasks.push(write(dir, 'keywords.txt', meta.keywords));
+    if (meta.promotionalText)
+        tasks.push(write(dir, 'promotional_text.txt', meta.promotionalText));
+    if (meta.releaseNotes)
+        tasks.push(write(dir, 'release_notes.txt', meta.releaseNotes));
+    await Promise.all(tasks);
+}
+// ── Play Store metadata writer ────────────────────────────────────────────────
+async function writePlayMeta(appDir, internalLocale, meta) {
+    const dir = join(appDir, 'fastlane', 'metadata', 'android', toPlayLocale(internalLocale));
+    const tasks = [
+        write(dir, 'title.txt', meta.name),
+        write(dir, 'full_description.txt', meta.description),
+        write(dir, 'privacy_url.txt', meta.privacyUrl),
+    ];
+    if (meta.shortDescription)
+        tasks.push(write(dir, 'short_description.txt', meta.shortDescription));
+    if (meta.releaseNotes)
+        tasks.push(write(dir, 'changelogs/default.txt', meta.releaseNotes));
+    await Promise.all(tasks);
+}
+// ── Appfile writer ────────────────────────────────────────────────────────────
+async function writeAppfile(appDir, config) {
+    const appfile = join(appDir, 'fastlane', 'Appfile');
+    const lines = [
+        `app_identifier("${config.bundleId}")`,
+        config.appleId ? `apple_id("${config.appleId}")` : '',
+        config.itcTeamId ? `itc_team_id("${config.itcTeamId}")` : '',
+        config.itcTeamId ? `team_id("${config.itcTeamId}")` : '',
+    ].filter(Boolean);
+    await mkdir(join(appDir, 'fastlane'), { recursive: true });
+    await writeFile(appfile, lines.join('\n') + '\n', 'utf-8');
+}
+export async function syncMetadata({ appDir, config, platforms = ['appstore', 'play'], }) {
+    const writes = [];
+    for (const [locale, meta] of Object.entries(config.locales)) {
+        if (platforms.includes('appstore')) {
+            writes.push(writeAppStoreMeta(appDir, locale, meta));
+        }
+        if (platforms.includes('play')) {
+            writes.push(writePlayMeta(appDir, locale, meta));
+        }
+    }
+    if (platforms.includes('appstore')) {
+        writes.push(writeAppfile(appDir, config));
+    }
+    await Promise.all(writes);
+    console.log(`✓ metadata synced (${Object.keys(config.locales).join(', ')}) → ${appDir}/fastlane/`);
+}

package/dist/render.d.ts

@@ -0,0 +1,13 @@
+import type { StoreConfig } from './config.js';
+export interface RenderOptions {
+    /** Absolute path to the app directory (e.g. /repo/apps/autoskola-ai) */
+    appDir: string;
+    config: StoreConfig;
+    /** If provided, only render these locales. Default: all locales in config. */
+    locales?: string[];
+    /** If provided, only render these scene slugs (out field). Default: all. */
+    scenes?: string[];
+    platforms?: ('appstore' | 'play')[];
+    verbose?: boolean;
+}
+export declare function renderScreenshots({ appDir, config, locales, scenes: sceneFilter, platforms, verbose, }: RenderOptions): Promise<void>;