codz-cli 0.1.2 → 0.1.8

package/dist/skills/androidViews.js

@@ -21,6 +21,8 @@ import { ToolError } from "../core/types.js";
 import { kebab, snake } from "../input/naming.js";
 import { access, androidPrefill, apiRef, classOfFile, ktInitial, context, dataViewModel, ensureUiState, fileOf, finish, formViewModel, injection, names, routeOf } from "./androidUi.js";
 import { responseShape, titleField } from "./screen.js";
+import { androidPaging, pagedViewModel } from "./androidUi.js";
+import { pagingSummary, pagingWarnings } from "./paging.js";
 /** Libraries the generated Activities use, with versions known to work together. */
 const VIEW_LIBS = [
     { key: 'androidx-core-ktx', coord: 'androidx.core:core-ktx', version: '1.15.0', vkey: 'core-ktx' },
@@ -142,7 +144,6 @@ export function planViewsScreen(root, map, opts) {
         if (x.read(f) !== null)
             throw new ToolError('route_exists', `${f} already exists.`);
     const pkg = packageOf(x.srcDir, v.screensDir);
-    const uiState = ensureUiState(x, v.screensDir);
     const T = a.returnType;
     const shape = responseShape(T, map);
     const model = shape.model;
@@ -152,6 +153,9 @@ export function planViewsScreen(root, map, opts) {
         const name = p.name.replace(/`/g, '');
         return /^(Int|Long)$/.test(p.type) ? `${name}.to${p.type}()` : name;
     });
+    if (opts.paginate || opts.search)
+        return viewsPaged(v, opts, a, { n, params, required, args, file, vmFile, layout, pkg, shape, model, modelImports, inj, T });
+    const uiState = ensureUiState(x, v.screensDir);
     x.files.set(vmFile, dataViewModel(x, a, n.vm, pkg, params, args, inj, uiState, T, modelImports));
     x.summary.push(`Create ${vmFile}: ${n.vm} loads ${a.iface}.${a.ep.name}()${params.length ? ` with ${params.join(', ')} from the Intent extras` : ''}`);
     // Layout.
@@ -534,3 +538,179 @@ export function linkViewsList(text, pkg, t) {
         return null;
     return addKotlinImports(out, ['android.content.Intent'], pkg);
 }
+/** Views: a paged or searchable list (RecyclerView, search box, more as you scroll) with the shared paged ViewModel. */
+function viewsPaged(v, opts, a, o) {
+    const { x } = v;
+    const { n, pkg, model } = o;
+    const paging = androidPaging(a, o.shape, opts, o.T);
+    const item = /^List<(.+)>\??$/.exec(o.T)?.[1] ?? 'Any';
+    const routeNamed = o.required.map((p, i) => `${p.name} = ${o.args[i]}`);
+    x.files.set(o.vmFile, pagedViewModel(x, a, n.vm, pkg, o.params, routeNamed, o.inj, item, paging, o.modelImports));
+    const searchable = Boolean(paging.search || paging.clientSearch);
+    const pg = paging.paginate;
+    const stateName = `${n.vm.replace(/ViewModel$/, '')}ListState`;
+    x.summary.push(`Create ${o.vmFile}: ${n.vm} with items, loading, error${searchable ? ', query' : ''}${pg ? ', hasMore' : ''}, calling ${a.iface}.${a.ep.name}()`);
+    const tf = titleField(model);
+    const stringFields = paging.searchFields.map((f) => (model?.fields.find((m) => m.name === f)?.nullable ? `${access('item', f)}.orEmpty()` : access('item', f)));
+    const center = (id, extra = []) => [`            android:id="@+id/${id}"`, '            android:layout_width="wrap_content"', '            android:layout_height="wrap_content"', '            android:layout_gravity="center"', ...extra];
+    x.files.set(o.layout, [
+        XML_HEAD,
+        `<LinearLayout ${NS}`,
+        '    android:layout_width="match_parent"',
+        '    android:layout_height="match_parent"',
+        '    android:orientation="vertical">',
+        '',
+        '    <TextView',
+        '        android:layout_width="wrap_content"',
+        '        android:layout_height="wrap_content"',
+        '        android:padding="16dp"',
+        `        android:text="${n.title}"`,
+        '        android:textSize="22sp" />',
+        ...(searchable ? ['', '    <EditText', '        android:id="@+id/search"', '        android:layout_width="match_parent"', '        android:layout_height="wrap_content"', '        android:layout_marginHorizontal="12dp"', '        android:hint="Search"', '        android:importantForAutofill="no"', '        android:inputType="text"', '        android:singleLine="true" />'] : []),
+        '',
+        '    <FrameLayout',
+        '        android:layout_width="match_parent"',
+        '        android:layout_height="0dp"',
+        '        android:layout_weight="1">',
+        '',
+        '        <androidx.recyclerview.widget.RecyclerView',
+        '            android:id="@+id/list"',
+        '            android:layout_width="match_parent"',
+        '            android:layout_height="match_parent" />',
+        '',
+        '        <ProgressBar',
+        ...center('progress', ['            android:visibility="gone" />']),
+        '',
+        '        <TextView',
+        ...center('empty', ['            android:padding="16dp"', '            android:visibility="gone" />']),
+        '',
+        '        <LinearLayout',
+        ...center('error', ['            android:gravity="center"', '            android:orientation="vertical"', '            android:padding="16dp"', '            android:visibility="gone">']),
+        '',
+        '            <TextView',
+        '                android:id="@+id/error_text"',
+        '                android:layout_width="wrap_content"',
+        '                android:layout_height="wrap_content" />',
+        '',
+        '            <Button',
+        '                android:id="@+id/retry"',
+        '                android:layout_width="wrap_content"',
+        '                android:layout_height="wrap_content"',
+        '                android:text="Retry" />',
+        '        </LinearLayout>',
+        '    </FrameLayout>',
+        ...(pg
+            ? ['', '    <ProgressBar', '        android:id="@+id/more"', '        android:layout_width="wrap_content"', '        android:layout_height="wrap_content"', '        android:layout_gravity="center_horizontal"', '        android:visibility="gone" />', '', '    <Button', '        android:id="@+id/more_retry"', '        android:layout_width="wrap_content"', '        android:layout_height="wrap_content"', '        android:layout_gravity="center_horizontal"', '        android:text="Retry"', '        android:visibility="gone" />']
+            : []),
+        '</LinearLayout>',
+        '',
+    ].join('\n'));
+    const activity = [
+        `package ${pkg}`,
+        '',
+        ...o.inj.activity.annotations,
+        `class ${n.activity} : ComponentActivity() {`,
+        `    private val viewModel: ${n.vm} ${o.inj.activity.delegate}`,
+        '    private val adapter = ItemAdapter()',
+        '',
+        '    override fun onCreate(savedInstanceState: Bundle?) {',
+        '        super.onCreate(savedInstanceState)',
+        `        setContentView(R.layout.${n.layout})`,
+        '        val list = findViewById<RecyclerView>(R.id.list)',
+        '        val layoutManager = LinearLayoutManager(this)',
+        '        list.layoutManager = layoutManager',
+        '        list.addItemDecoration(DividerItemDecoration(this, DividerItemDecoration.VERTICAL))',
+        '        list.adapter = adapter',
+        ...(pg
+            ? [
+                '        // Near the end of the list: ask for the next page.',
+                '        list.addOnScrollListener(object : RecyclerView.OnScrollListener() {',
+                '            override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {',
+                '                if (layoutManager.findLastVisibleItemPosition() >= adapter.itemCount - 3) viewModel.load()',
+                '            }',
+                '        })',
+                '        findViewById<Button>(R.id.more_retry).setOnClickListener { viewModel.load() }',
+            ]
+            : []),
+        ...(searchable ? ['        findViewById<EditText>(R.id.search).doAfterTextChanged { viewModel.search(it?.toString().orEmpty()) }'] : []),
+        `        findViewById<Button>(R.id.retry).setOnClickListener { viewModel.load(${pg ? 'reset = true' : ''}) }`,
+        '        lifecycleScope.launch {',
+        '            repeatOnLifecycle(Lifecycle.State.STARTED) {',
+        '                viewModel.state.collect { render(it) }',
+        '            }',
+        '        }',
+        '    }',
+        '',
+        `    private fun render(s: ${stateName}) {`,
+        `        val shown = ${paging.clientSearch ? `if (s.query.isBlank()) s.items else s.items.filter { item -> listOf(${stringFields.join(', ')}).any { it.contains(s.query.trim(), ignoreCase = true) } }` : 's.items'}`,
+        '        adapter.submit(shown)',
+        '        findViewById<View>(R.id.progress).isVisible = s.loading && s.items.isEmpty()',
+        '        findViewById<View>(R.id.error).isVisible = s.error != null && s.items.isEmpty()',
+        '        findViewById<TextView>(R.id.error_text).text = s.error',
+        '        findViewById<TextView>(R.id.empty).apply {',
+        '            isVisible = shown.isEmpty() && !s.loading && s.error == null',
+        `            text = ${searchable ? 'if (s.query.isBlank()) "Nothing here yet." else "No matches."' : '"Nothing here yet."'}`,
+        '        }',
+        ...(pg
+            ? [
+                '        findViewById<View>(R.id.more).isVisible = s.loading && s.items.isNotEmpty()',
+                '        findViewById<View>(R.id.more_retry).isVisible = s.error != null && s.items.isNotEmpty()',
+                '        // The first pages may not fill the screen: keep loading until they do.',
+                '        val list = findViewById<RecyclerView>(R.id.list)',
+                '        list.post { if (s.hasMore && !s.loading && s.error == null && !list.canScrollVertically(1)) viewModel.load() }',
+            ]
+            : []),
+        '    }',
+        '',
+        '    private class ItemAdapter : RecyclerView.Adapter<ItemAdapter.Holder>() {',
+        `        private var items: List<${item}> = emptyList()`,
+        '',
+        '        class Holder(val text: TextView) : RecyclerView.ViewHolder(text)',
+        '',
+        '        @SuppressLint("NotifyDataSetChanged")',
+        `        fun submit(data: List<${item}>) {`,
+        '            items = data',
+        '            notifyDataSetChanged()',
+        '        }',
+        '',
+        '        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): Holder =',
+        '            Holder(LayoutInflater.from(parent.context).inflate(android.R.layout.simple_list_item_1, parent, false) as TextView)',
+        '',
+        '        override fun getItemCount(): Int = items.size',
+        '',
+        '        override fun onBindViewHolder(holder: Holder, position: Int) {',
+        `            holder.text.text = ${tf ? `${access('items[position]', tf)}.toString()` : 'items[position].toString()'}`,
+        '        }',
+        '    }',
+        '}',
+        '',
+    ].join('\n');
+    const imports = [
+        'android.annotation.SuppressLint',
+        'android.os.Bundle',
+        'android.view.LayoutInflater',
+        'android.view.View',
+        'android.view.ViewGroup',
+        'android.widget.Button',
+        'android.widget.TextView',
+        'androidx.activity.ComponentActivity',
+        'androidx.core.view.isVisible',
+        'androidx.lifecycle.Lifecycle',
+        'androidx.lifecycle.lifecycleScope',
+        'androidx.lifecycle.repeatOnLifecycle',
+        'androidx.recyclerview.widget.DividerItemDecoration',
+        'androidx.recyclerview.widget.LinearLayoutManager',
+        'androidx.recyclerview.widget.RecyclerView',
+        'kotlinx.coroutines.launch',
+        v.rClass,
+        ...o.modelImports,
+        ...o.inj.activity.imports,
+        ...(searchable ? ['android.widget.EditText', 'androidx.core.widget.doAfterTextChanged'] : []),
+    ];
+    x.files.set(o.file, addKotlinImports(activity, imports, pkg));
+    x.summary.push(`Create ${o.file} and ${o.layout}: ${n.activity} lists them and ${pagingSummary(paging)}`);
+    x.warnings.push(...pagingWarnings(paging));
+    ensureLibs(x, v.module, ['androidx.core:core-ktx', 'androidx.activity:activity-ktx', 'androidx.lifecycle:lifecycle-runtime-ktx', 'androidx.lifecycle:lifecycle-viewmodel-ktx', 'androidx.recyclerview:recyclerview']);
+    registerActivity(x, v.manifest, `${pkg}.${n.activity}`);
+    return finish(x, 'screen add', hint(n.activity, o.params));
+}

package/dist/skills/apiAdd.js

@@ -1,4 +1,5 @@
 // api add: cURL / URL / JSON samples → model, function and registration, as a change set.
+import { groupPlanned, modelLangOf } from "../core/modelGroup.js";
 import { join } from 'node:path';
 import { loadMap } from "../core/cache.js";
 import { buildChangeSet } from "../core/changeset.js";
@@ -94,6 +95,8 @@ export async function planApiAdd(root, adapter, opts) {
         const wire = adapter.planWire({ root, map: planned }, { endpoint: spec.name, module: opts.into, noLoad: opts.noLoad }, edits.files);
         edits = { files: wire.files, summary: [...edits.summary, ...wire.summary], warnings: [...edits.warnings, ...wire.warnings], generated: [...edits.generated, ...wire.generated] };
     }
+    const grouped = groupPlanned(root, edits.files, edits.generated, map, modelLangOf(adapter.id), opts.split);
+    edits = { ...edits, files: grouped.files, generated: grouped.generated };
     const changeSet = buildChangeSet(root, 'api add', edits);
     return { changeSet, spec };
 }

package/dist/skills/apiImport.js

@@ -6,6 +6,7 @@
 // Filters: --tag, --only, --path <glob>, --method, --max. --list shows what
 // would be imported and stops. Endpoints that cannot be planned (a model name
 // clash, say) stop the import unless --skip-conflicts applies the rest.
+import { groupPlanned, modelLangOf } from "../core/modelGroup.js";
 import { join } from 'node:path';
 import { loadMap } from "../core/cache.js";
 import { buildChangeSet } from "../core/changeset.js";
@@ -122,6 +123,7 @@ export async function planApiImport(root, adapter, opts) {
         warnings.add(`Skipped ${s.name}: ${s.reason}`);
     if (doc.format === 'har')
         warnings.add('Response bodies from the HAR file were used only to work out types; none of their values were written.');
-    const changeSet = buildChangeSet(root, 'api import', { files: overlay, summary, warnings: [...warnings], generated });
+    const grouped = groupPlanned(root, overlay, generated, map, modelLangOf(adapter.id), opts.split);
+    const changeSet = buildChangeSet(root, 'api import', { files: grouped.files, summary, warnings: [...warnings], generated: grouped.generated });
     return { changeSet, added, existing, skipped };
 }

package/dist/skills/apiSync.js

@@ -9,6 +9,7 @@
 // Breaking changes (a response field removed or changed type, a new required
 // parameter) are reported with the lines that use them. --check plans
 // everything and reports drift without writing (exit 1 when out of sync).
+import { groupPlanned, modelLangOf } from "../core/modelGroup.js";
 import { join } from 'node:path';
 import { loadMap } from "../core/cache.js";
 import { buildChangeSet } from "../core/changeset.js";
@@ -216,6 +217,7 @@ export async function planApiSync(root, adapter, opts) {
         summary.push(`Everything matches ${opts.file}: ${report.unchanged.length} endpoint${report.unchanged.length === 1 ? '' : 's'} checked.`);
     else
         summary.unshift(`Sync with ${doc.title || opts.file}: ${report.updated.length} updated, ${report.added.length} added, ${report.removed.length} removed, ${report.unchanged.length} unchanged`);
-    const changeSet = buildChangeSet(root, 'api sync', { files: overlay, summary, warnings: [...warnings], generated });
+    const grouped = groupPlanned(root, overlay, generated, map, modelLangOf(adapter.id), opts.split);
+    const changeSet = buildChangeSet(root, 'api sync', { files: grouped.files, summary, warnings: [...warnings], generated: grouped.generated });
     return { changeSet, ...report };
 }

package/dist/skills/assets.js

@@ -0,0 +1,289 @@
+// codz assets: typed names for the images, icons and fonts in the project,
+// kept in step with the files. Run it again after adding or removing files.
+//
+//   Flutter       lib/gen/assets.dart: AppImages.logo = 'assets/images/logo.png' (one class per folder),
+//                 and pubspec.yaml lists every asset folder and font family
+//   React Native  src/assets/index.ts: images.logo = require('./images/logo.png')
+//   Next.js       lib/assets.ts: paths under public/ ('/images/logo.png')
+//   React (Vite)  src/assets.ts: public/ paths, and imports for files in src/assets
+//   Android, iOS  already typed (R.drawable.logo, Image(.logo)); codz checks resource names
+//
+// Also lists assets no code uses.
+import { join, posix } from 'node:path';
+import { loadMap } from "../core/cache.js";
+import { buildChangeSet } from "../core/changeset.js";
+import { loadConfig } from "../core/config.js";
+import { exists, isDir, readText, walk } from "../core/fsutil.js";
+import { ToolError } from "../core/types.js";
+import { camel, DART_RESERVED, identifier, pascal, TS_RESERVED } from "../input/naming.js";
+const IMAGE = /\.(png|jpe?g|gif|webp|svg|bmp|ico|avif)$/i;
+const FONT = /\.(ttf|otf)$/i;
+const MEDIA = /\.(png|jpe?g|gif|webp|svg|bmp|ico|avif|json|lottie|riv|mp3|wav|ogg|mp4|webm|ttf|otf|txt|csv|pdf)$/i;
+const HEADER = 'Generated by codz assets. Do not edit: add or remove files, then run codz assets again.';
+/** Files under a folder, skipping hidden files and Flutter's resolution variants (2.0x/). */
+function assetFiles(root, dir) {
+    if (!isDir(join(root, dir)))
+        return [];
+    return walk(root, dir, { maxFiles: 5000 })
+        .filter((f) => MEDIA.test(f) && !/(^|\/)\./.test(f) && !/\/\d+(\.\d+)?x\//.test(f))
+        .sort();
+}
+/** Unique identifiers for files in one group: logo, logoSvg when two files share a name. */
+function names(files, rel, reserved) {
+    const base = (f) => identifier(posix.basename(f).replace(/\.[^.]+$/, ''), reserved) || 'asset';
+    const count = new Map();
+    for (const f of files)
+        count.set(base(f), (count.get(base(f)) ?? 0) + 1);
+    const out = new Map();
+    const used = new Set();
+    for (const f of files) {
+        let n = base(f);
+        if (count.get(n) > 1) {
+            const sub = posix.dirname(rel(f)).split('/').filter((x) => x && x !== '.').pop();
+            n = camel(`${posix.basename(f).replace(/\.[^.]+$/, '')} ${posix.extname(f).slice(1)}`) || n;
+            if (used.has(n) && sub)
+                n = camel(`${sub} ${n}`);
+        }
+        let k = 2;
+        const want = n;
+        while (used.has(n))
+            n = `${want}${k++}`;
+        used.add(n);
+        out.set(f, n);
+    }
+    return out;
+}
+/** Assets no source file mentions (by path, file name or generated name). */
+function unused(root, files, nameOf, sources, generatedFile) {
+    const texts = sources.filter((f) => f !== generatedFile).map((f) => readText(join(root, f)) ?? '').join('\n');
+    return files.filter((f) => {
+        const n = nameOf.get(f);
+        return !texts.includes(posix.basename(f)) && !(n && new RegExp(`\\.${n}\\b`).test(texts));
+    });
+}
+// ---------- Flutter ----------
+function flutterPubspec(text, dirs, fonts) {
+    const lines = text.split('\n');
+    let start = lines.findIndex((l) => /^flutter:\s*$/.test(l));
+    if (start < 0) {
+        lines.push('', 'flutter:');
+        start = lines.length - 1;
+    }
+    let end = start + 1;
+    while (end < lines.length && (lines[end].trim() === '' || /^\s/.test(lines[end])))
+        end++;
+    // Blank lines after the block stay after it.
+    while (end > start + 1 && lines[end - 1].trim() === '')
+        end--;
+    const block = lines.slice(start + 1, end);
+    const at = (key) => block.findIndex((l) => new RegExp(`^  ${key}:\\s*$`).test(l));
+    const listEnd = (i) => {
+        let j = i + 1;
+        while (j < block.length && (/^\s{4}/.test(block[j]) || block[j].trim() === ''))
+            j++;
+        while (j > i + 1 && block[j - 1].trim() === '')
+            j--;
+        return j;
+    };
+    if (dirs.length) {
+        const i = at('assets');
+        if (i < 0)
+            block.push('  assets:', ...dirs.map((d) => `    - ${d}/`));
+        else {
+            const j = listEnd(i);
+            const have = block.slice(i + 1, j).map((l) => l.replace(/^\s*-\s*/, '').trim()).filter(Boolean);
+            const missing = dirs.map((d) => `${d}/`).filter((d) => !have.includes(d));
+            block.splice(j, 0, ...missing.map((d) => `    - ${d}`));
+        }
+    }
+    if (fonts.length) {
+        let i = at('fonts');
+        if (i < 0) {
+            block.push('  fonts:');
+            i = block.length - 1;
+        }
+        const j = listEnd(i);
+        const existing = block.slice(i + 1, j).join('\n');
+        const add = [];
+        for (const f of fonts) {
+            if (new RegExp(`family:\\s*${f.family}\\s*$`, 'm').test(existing))
+                continue;
+            add.push(`    - family: ${f.family}`, '      fonts:', ...f.files.flatMap((x) => [`        - asset: ${x.asset}`, ...(x.weight && x.weight !== 400 ? [`          weight: ${x.weight}`] : []), ...(x.italic ? ['          style: italic'] : [])]));
+        }
+        block.splice(j, 0, ...add);
+    }
+    return [...lines.slice(0, start + 1), ...block, ...lines.slice(end)].join('\n');
+}
+const WEIGHTS = { thin: 100, extralight: 200, light: 300, regular: 400, medium: 500, semibold: 600, bold: 700, extrabold: 800, black: 900 };
+function planFlutter(root, map, p) {
+    const pub = readText(join(root, 'pubspec.yaml'));
+    if (pub === null)
+        throw new ToolError('not_found', 'No pubspec.yaml.');
+    const dir = 'assets';
+    const all = assetFiles(root, dir);
+    if (!all.length)
+        throw new ToolError('no_assets', 'There is no assets/ folder with files yet.', 'Put images in assets/images and fonts in assets/fonts, then run codz assets.');
+    const fontFiles = all.filter((f) => FONT.test(f));
+    const others = all.filter((f) => !FONT.test(f));
+    // Group by the first folder under assets/: assets/images/x.png → AppImages; files directly in assets → AppAssets.
+    const groups = new Map();
+    for (const f of others) {
+        const parts = f.split('/');
+        const g = parts.length > 2 ? parts[1] : '';
+        groups.set(g, [...(groups.get(g) ?? []), f]);
+    }
+    const out = ['// ' + HEADER, '// ignore_for_file: constant_identifier_names', ''];
+    const nameOf = new Map();
+    const usage = [];
+    for (const [g, files] of [...groups].sort()) {
+        const cls = g ? `App${pascal(g)}` : 'AppAssets';
+        const ns = names(files, (f) => f.split('/').slice(2).join('/'), DART_RESERVED);
+        out.push(`abstract final class ${cls} {`, ...files.map((f) => `  static const ${ns.get(f)} = '${f}';`), '}', '');
+        for (const [f, n] of ns)
+            nameOf.set(f, n);
+        if (!usage.length)
+            usage.push(`${cls}.${ns.get(files[0])}`);
+    }
+    const families = new Map();
+    for (const f of fontFiles) {
+        const base = posix.basename(f).replace(FONT, '');
+        const [fam, style = 'Regular'] = base.split('-');
+        const s = style.toLowerCase();
+        const italic = /italic/.test(s);
+        const weight = WEIGHTS[s.replace('italic', '') || 'regular'];
+        families.set(fam, [...(families.get(fam) ?? []), { asset: f, weight, italic }]);
+    }
+    if (families.size)
+        out.push('abstract final class AppFonts {', ...[...families.keys()].sort().map((fam) => `  static const ${identifier(fam, DART_RESERVED)} = '${fam}';`), '}', '');
+    const file = 'lib/gen/assets.dart';
+    const text = `${out.join('\n').replace(/\n+$/, '')}\n`;
+    if (text !== readText(join(root, file))) {
+        p.files.set(file, text);
+        p.summary.push(`${exists(join(root, file)) ? 'Update' : 'Create'} ${file}: ${[...groups.keys()].map((g) => (g ? `App${pascal(g)}` : 'AppAssets')).join(', ')}${families.size ? ', AppFonts' : ''} (${others.length} file${others.length === 1 ? '' : 's'}${families.size ? `, ${families.size} font famil${families.size === 1 ? 'y' : 'ies'}` : ''})`);
+    }
+    const dirs = [...new Set(others.map((f) => posix.dirname(f)))].sort();
+    const nextPub = flutterPubspec(pub, dirs, [...families].map(([family, files]) => ({ family, files })));
+    if (nextPub !== pub) {
+        p.files.set('pubspec.yaml', nextPub);
+        p.summary.push('Update pubspec.yaml: every asset folder' + (families.size ? ' and font family' : ''));
+    }
+    if (usage.length || families.size)
+        p.summary.push(`Use them: ${usage.length ? `Image.asset(${usage[0]})` : ''}${usage.length && families.size ? ', ' : ''}${families.size ? `TextStyle(fontFamily: AppFonts.${identifier([...families.keys()].sort()[0], DART_RESERVED)})` : ''}`);
+    const idle = unused(root, others, nameOf, walk(root, 'lib', { exts: ['.dart'] }), file);
+    if (idle.length)
+        p.warnings.push(`Not used anywhere in lib/ (${idle.length}): ${idle.slice(0, 10).join(', ')}${idle.length > 10 ? ', …' : ''}`);
+}
+// ---------- React Native ----------
+function planRn(root, map, p) {
+    const src = map.conventions.srcDir || (isDir(join(root, 'src')) ? 'src' : '.');
+    const dir = [`${src}/assets`, 'assets'].find((d) => assetFiles(root, d).length);
+    if (!dir)
+        throw new ToolError('no_assets', `There is no ${src}/assets or assets/ folder with files yet.`, 'Put images in src/assets/images, then run codz assets.');
+    const files = assetFiles(root, dir).filter((f) => !FONT.test(f));
+    const file = `${dir}/index.ts`;
+    const groups = new Map();
+    for (const f of files) {
+        const rel = f.slice(dir.length + 1).split('/');
+        const g = rel.length > 1 ? rel[0] : 'assets';
+        groups.set(g, [...(groups.get(g) ?? []), f]);
+    }
+    const q = "'";
+    const out = [`// ${HEADER}`, '// require() needs fixed paths, so every file is listed here.', ''];
+    const nameOf = new Map();
+    for (const [g, fs] of [...groups].sort()) {
+        const ns = names(fs, (f) => f.slice(dir.length + 1), TS_RESERVED);
+        out.push(`export const ${identifier(g, TS_RESERVED)} = {`, ...fs.map((f) => `  ${ns.get(f)}: require(${q}./${f.slice(dir.length + 1)}${q}),`), '} as const;', '');
+        for (const [f, n] of ns)
+            nameOf.set(f, n);
+    }
+    const text = `${out.join('\n').replace(/\n+$/, '')}\n`;
+    if (text !== readText(join(root, file))) {
+        p.files.set(file, text);
+        p.summary.push(`${exists(join(root, file)) ? 'Update' : 'Create'} ${file}: ${[...groups.keys()].join(', ')} (${files.length} file${files.length === 1 ? '' : 's'})`);
+    }
+    const first = [...groups].sort()[0];
+    p.summary.push(`Use them: <Image source={${identifier(first[0], TS_RESERVED)}.${nameOf.get(first[1][0])}} />`);
+    const sources = [src, 'app'].flatMap((d) => walk(root, d, { exts: ['.ts', '.tsx', '.js', '.jsx'] }));
+    const idle = unused(root, files, nameOf, sources, file);
+    if (idle.length)
+        p.warnings.push(`Not used anywhere (${idle.length}): ${idle.slice(0, 10).join(', ')}${idle.length > 10 ? ', …' : ''}`);
+}
+// ---------- Next.js and Vite ----------
+function planWeb(root, map, vite, p) {
+    const pub = assetFiles(root, 'public').filter((f) => !/\/(favicon\.ico|robots\.txt|sitemap\.xml|manifest\.json)$/.test(f));
+    const srcAssets = vite ? assetFiles(root, 'src/assets') : [];
+    if (!pub.length && !srcAssets.length)
+        throw new ToolError('no_assets', `There are no files in public/${vite ? ' or src/assets/' : ''} yet.`);
+    const file = vite ? 'src/assets.ts' : exists(join(root, 'src/app')) ? 'src/lib/assets.ts' : 'lib/assets.ts';
+    const out = [`// ${HEADER}`, ''];
+    const imports = [];
+    const nameOf = new Map();
+    if (srcAssets.length) {
+        const ns = names(srcAssets, (f) => f.slice('src/assets/'.length), TS_RESERVED);
+        for (const f of srcAssets) {
+            const n = ns.get(f);
+            imports.push(`import ${n}Url from './${f.slice('src/'.length)}';`);
+            nameOf.set(f, n);
+        }
+        out.splice(2, 0, ...imports, '');
+        out.push('/** Files in src/assets: bundled, with hashed names. */', 'export const bundled = {', ...srcAssets.map((f) => `  ${ns.get(f)}: ${ns.get(f)}Url,`), '} as const;', '');
+    }
+    if (pub.length) {
+        const ns = names(pub, (f) => f.slice('public/'.length), TS_RESERVED);
+        out.push('/** Files in public/: served at these paths as they are. */', 'export const publicFiles = {', ...pub.map((f) => `  ${ns.get(f)}: '/${f.slice('public/'.length)}',`), '} as const;', '');
+        for (const [f, n] of ns)
+            nameOf.set(f, n);
+    }
+    const text = `${out.join('\n').replace(/\n+$/, '')}\n`;
+    if (text !== readText(join(root, file))) {
+        p.files.set(file, text);
+        p.summary.push(`${exists(join(root, file)) ? 'Update' : 'Create'} ${file}: ${[srcAssets.length ? `bundled (${srcAssets.length})` : '', pub.length ? `publicFiles (${pub.length})` : ''].filter(Boolean).join(', ')}`);
+    }
+    if (pub.length)
+        p.summary.push(`Use them: <img src={publicFiles.${nameOf.get(pub[0])}} alt="" />`);
+    const sources = ['app', 'src', 'components', 'pages', 'lib'].flatMap((d) => walk(root, d, { exts: ['.ts', '.tsx', '.js', '.jsx', '.css', '.scss'] }));
+    const idle = unused(root, [...pub, ...srcAssets], nameOf, sources, file);
+    if (idle.length)
+        p.warnings.push(`Not used anywhere (${idle.length}): ${idle.slice(0, 10).join(', ')}${idle.length > 10 ? ', …' : ''}`);
+}
+// ---------- Android and iOS: already typed ----------
+function checkAndroid(root, map, p) {
+    const res = `${map.conventions.appModule || 'app'}/src/main/res`;
+    const files = walk(root, res, { maxFiles: 5000 }).filter((f) => /\/(drawable|mipmap|raw|font)[^/]*\//.test(f));
+    const bad = files.filter((f) => !/^[a-z][a-z0-9_]*$/.test(posix.basename(f).replace(/\.9\.png$|\.[^.]+$/, '')));
+    p.summary.push(`Android already gives every resource a typed name (R.drawable.logo, R.font.inter); ${files.length} resource file${files.length === 1 ? '' : 's'} checked.`);
+    if (bad.length)
+        p.warnings.push(`These resource names will break the build (only a-z, 0-9 and _, starting with a letter): ${bad.slice(0, 10).join(', ')}`);
+    const kt = walk(root, map.conventions.srcDir || 'app/src/main/java', { exts: ['.kt'] }).map((f) => readText(join(root, f)) ?? '').join('\n');
+    const xml = walk(root, res, { exts: ['.xml'] }).map((f) => readText(join(root, f)) ?? '').join('\n') + (readText(join(root, `${map.conventions.appModule || 'app'}/src/main/AndroidManifest.xml`)) ?? '');
+    const idle = files.filter((f) => /\/drawable[^/]*\//.test(f)).filter((f) => {
+        const n = posix.basename(f).replace(/\.9\.png$|\.[^.]+$/, '');
+        return !new RegExp(`R\\.drawable\\.${n}\\b`).test(kt) && !xml.includes(`@drawable/${n}`);
+    });
+    if (idle.length)
+        p.warnings.push(`Drawables not used anywhere (${idle.length}): ${idle.slice(0, 10).join(', ')}`);
+}
+function checkIos(p) {
+    p.summary.push('Xcode already generates typed names for asset catalog images and colors (Image(.logo), Color(.brand)) when "Generate Asset Symbols" is on (the default in new projects). Nothing to do.');
+}
+export async function planAssets(root, adapter) {
+    const { map } = await loadMap(root, adapter, loadConfig(root).conventions);
+    const p = { files: new Map(), summary: [], warnings: [] };
+    if (adapter.id === 'flutter')
+        planFlutter(root, map, p);
+    else if (adapter.id === 'react-native')
+        planRn(root, map, p);
+    else if (adapter.id === 'nextjs')
+        planWeb(root, map, false, p);
+    else if (adapter.id === 'react')
+        planWeb(root, map, true, p);
+    else if (adapter.id === 'android')
+        checkAndroid(root, map, p);
+    else if (adapter.id === 'ios')
+        checkIos(p);
+    else
+        throw new ToolError('not_supported', `codz assets needs a framework adapter; this project uses the ${adapter.id} adapter.`);
+    if (!p.files.size && (adapter.id === 'flutter' || adapter.id === 'react-native' || adapter.id === 'nextjs' || adapter.id === 'react'))
+        p.summary.unshift('Asset names are up to date.');
+    return buildChangeSet(root, 'assets', { files: p.files, summary: p.summary, warnings: p.warnings, generated: [] });
+}