tsoft-cli 3.7.4 → 3.9.0

package/CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to T-Soft CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.9.0] - 2026-05-20
+
+### Added
+- Interactive `tsoft theme section` menu: running `theme section` with no sub-command now opens a four-way picker (add a ready-made section, create an empty section, fork from an existing section, list sections).
+- `tsoft theme section create` — scaffolds an empty section file inside an existing block folder (`section/{block}/{name}.twig`) in the active theme via the new `POST /theme/{uuid}/sections` endpoint, then refreshes local files.
+- `tsoft theme section fork` — forks an existing section into the active theme under a new name.
+- Searchable pickers: block and section selection prompts (`add`, `create`, `fork`) now filter as you type, matching both the display name and the folder slug.
+- `theme dev` now prints a distinct `section updated` line when a file under `section/` is saved, so section changes are visible during live development.
+- `theme dev` interactive `S` keypress opens the section menu without leaving the watch session; the watcher and keypress listener are paused while the menu is open and the local theme is re-synced afterwards.
+
+### Removed
+- Dead `ApiClient.syncTheme()` method — the server now resyncs the section registry automatically on file save, so the explicit sync call is no longer needed.
+
+### Backwards compatibility
+- `theme section add` and `theme section list` remain available as direct sub-commands for scripts and CI.
+
+## [3.8.0] - 2026-04-28
+
+### Added
+- Vitest unit tests for `ApiClient` 401 handling: successful refresh-and-retry path, relogin error after a second 401, relogin error when the refresh token is invalid, relogin error when the refresh call itself fails, and POST request retry parity (`tests/api-client.test.js`).
+- Integration tests for the OAuth callback HTTP server (`tests/server.test.js`): success path returns the expected `{ code, state, store }` payload, OAuth `error` query rejects, missing required params reject, unknown paths return 404 without resolving the promise, and an already-bound port surfaces a clear startup error.
+- Tests for `loginCommand` edge cases (`tests/login.test.js`): refusal in JSON mode, state mismatch (CSRF guard), browser open failure, and token exchange failure — all of which exit with code 1.
+- Tests for `themeInitCommand` early-return paths (`tests/theme-init.test.js`): unknown slug under JSON and human modes, empty themes list, and missing-slug + JSON combination.
+- Tests for `themePushCommand` JSON-mode contract (`tests/theme-push.test.js`): no active theme exits 1, success payload shape (`version`, `bump_type`, `action`, `changes`, `partner_panel_url`), partner URL fallback when `/organization/` segment is missing, `no_op` payload on `no_changes`, and error payload on push failure.
+- Tests for `logoutCommand` safety guarantee (`tests/logout.test.js`): quiet exit when no tokens are stored; **local config is cleared even if the revoke call fails**; happy-path revoke + clear ordering.
+- Tests for `orgSwitchCommand` early-return paths (`tests/org-switch.test.js`): JSON mode refusal (exit 1), no active store, no stored tokens, empty organisation list — none of which should call the select-org endpoint.
+- Tests for `whoamiCommand` (`tests/whoami.test.js`): exit 1 in JSON mode when no tokens, quiet return in human mode, and the structured success payload shape (`user`, `store`, `access_token_valid`, `refresh_token_valid`, `updated_at`).
+- Tests for `themeSectionListCommand` and `themeSectionAddCommand` (`tests/theme-section.test.js`): no active theme warning, empty blocks list, blocks with no available default sections, and graceful cancellation when the user declines the confirmation prompt (no `addSection` call).
+- Tests for `themeDevCommand` control-flow guards (`tests/theme-dev.test.js`): empty themes list during the interactive picker, an unresolvable explicit slug exits 1, missing local theme directory shows an error and returns, and a theme locked by another developer respects user's decline of the override prompt (no `acquire-lock` call).
+
+### Internal
+- `vitest` added as `devDependency` (was previously referenced by the `test` script but not installed by `npm install`).
+- Test suite grew from 64 specs (7 files) to **102 specs (16 files)**; coverage now spans `api-client`, `server`, and every command in `src/commands/` (`loginCommand`, `logoutCommand`, `whoamiCommand`, `orgSwitchCommand`, `themeInitCommand`, `themeDevCommand`, `themePushCommand`, `themeSection*`) in addition to the existing helper-module suites.
+
 ## [3.7.4] - 2026-04-20
 
 ### Fixed

package/locales/en.json

@@ -266,6 +266,29 @@
   "section.add.download_error": "⚠️  Error while updating theme files:",
   "section.add.manual_tip": "💡 Try downloading the theme manually:",
   "section.add.manual_command": "tsoft theme pull",
+  "section.menu.title": "🧩 Section Operations",
+  "section.menu.prompt": "What would you like to do?",
+  "section.menu.add": "Add a ready-made section",
+  "section.menu.create": "Create an empty section",
+  "section.menu.fork": "Fork from a section",
+  "section.menu.list": "List sections",
+  "section.create.title": "✨ Create Empty Section",
+  "section.create.no_blocks": "No block available to add a section to.",
+  "section.create.block_prompt": "Which block should the section be added to?",
+  "section.create.name_prompt": "Section name (.twig is added automatically):",
+  "section.create.name_required": "Section name cannot be empty.",
+  "section.create.name_invalid": "Section name may only contain lowercase letters, digits and hyphens.",
+  "section.create.name_no_extension": "Do not type an extension — \".twig\" is added automatically.",
+  "section.create.confirm_prompt": "File \"{{file}}\" will be created in theme \"{{theme}}\".\n\nDo you want to continue?",
+  "section.create.created": "\"{{file}}\" created.",
+  "section.create.failed": "Failed to create section: {{error}}",
+  "section.fork.title": "🌱 Fork From Section",
+  "section.fork.no_sources": "No source section found to fork from.",
+  "section.fork.source_prompt": "Which section would you like to fork from?",
+  "section.fork.name_prompt": "New section name (.twig is added automatically):",
+  "section.fork.confirm_prompt": "\"{{file}}\" will be forked from \"{{source}}\" and added to theme \"{{theme}}\".\n\nDo you want to continue?",
+  "section.fork.created": "\"{{file}}\" created.",
+  "section.fork.next_step": "Open \"{{file}}\" to edit its content.",
   "org.switch.json_error.message": "This command requires interactive mode.",
   "org.switch.json_error.hint": "org switch is not supported in JSON mode.",
   "org.switch.no_store": "No active store found. Please run \"tsoft login\" first.",
@@ -307,5 +330,9 @@
   "dev.status_watching": "Watching",
   "dev.status_preview": "preview",
   "dev.status_exit": "exit",
-  "dev.preview_open_failed": "Couldn't open browser: {{error}}"
+  "dev.preview_open_failed": "Couldn't open browser: {{error}}",
+  "dev.section_synced": "🧩 section updated: {{folder}}",
+  "dev.status_section": "section",
+  "dev.section_menu_opening": "Opening section menu...",
+  "dev.section_menu_resumed": "Resuming watch."
 }

package/locales/tr.json

@@ -266,6 +266,29 @@
   "section.add.download_error": "⚠️  Tema dosyaları güncellenirken hata oluştu:",
   "section.add.manual_tip": "💡 Manuel olarak temayı tekrar indirmeyi deneyin:",
   "section.add.manual_command": "tsoft theme pull",
+  "section.menu.title": "🧩 Section İşlemleri",
+  "section.menu.prompt": "Ne yapmak istiyorsunuz?",
+  "section.menu.add": "Hazır section ekle",
+  "section.menu.create": "Boş section oluştur",
+  "section.menu.fork": "Section'dan türet",
+  "section.menu.list": "Section'ları listele",
+  "section.create.title": "✨ Boş Section Oluştur",
+  "section.create.no_blocks": "Section eklenebilecek block bulunamadı.",
+  "section.create.block_prompt": "Hangi block içine eklemek istiyorsunuz?",
+  "section.create.name_prompt": "Section adı (.twig otomatik eklenir):",
+  "section.create.name_required": "Section adı boş olamaz.",
+  "section.create.name_invalid": "Section adı yalnızca küçük harf, rakam ve tire içerebilir.",
+  "section.create.name_no_extension": "Uzantı yazmayın — \".twig\" otomatik eklenir.",
+  "section.create.confirm_prompt": "\"{{file}}\" dosyası \"{{theme}}\" temasında oluşturulacak.\n\nDevam etmek istiyor musunuz?",
+  "section.create.created": "\"{{file}}\" oluşturuldu.",
+  "section.create.failed": "Section oluşturulamadı: {{error}}",
+  "section.fork.title": "🌱 Section'dan Türet",
+  "section.fork.no_sources": "Türetilecek kaynak section bulunamadı.",
+  "section.fork.source_prompt": "Hangi section'dan türetmek istiyorsunuz?",
+  "section.fork.name_prompt": "Yeni section adı (.twig otomatik eklenir):",
+  "section.fork.confirm_prompt": "\"{{source}}\" section'ından \"{{file}}\" türetilecek ve \"{{theme}}\" temasına eklenecek.\n\nDevam etmek istiyor musunuz?",
+  "section.fork.created": "\"{{file}}\" oluşturuldu.",
+  "section.fork.next_step": "İçeriği düzenlemek için \"{{file}}\" dosyasını açın.",
   "org.switch.json_error.message": "Bu komut interaktif mod gerektiriyor.",
   "org.switch.json_error.hint": "JSON modunda org switch desteklenmiyor.",
   "org.switch.no_store": "Aktif mağaza bulunamadı. Lütfen önce \"tsoft login\" komutunu çalıştırın.",
@@ -307,5 +330,9 @@
   "dev.status_watching": "İzleniyor",
   "dev.status_preview": "önizleme",
   "dev.status_exit": "çıkış",
-  "dev.preview_open_failed": "Tarayıcı açılamadı: {{error}}"
+  "dev.preview_open_failed": "Tarayıcı açılamadı: {{error}}",
+  "dev.section_synced": "🧩 section güncellendi: {{folder}}",
+  "dev.status_section": "section",
+  "dev.section_menu_opening": "Section menüsü açılıyor...",
+  "dev.section_menu_resumed": "İzlemeye devam ediliyor."
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsoft-cli",
-  "version": "3.7.4",
+  "version": "3.9.0",
   "description": "Command-line tool for tsoft360 theme development and management",
   "type": "module",
   "main": "src/index.js",
@@ -52,5 +52,8 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/tekrom/tsoft-cli.git"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.5"
   }
 }

package/src/api-client.js

@@ -131,6 +131,17 @@ export class ApiClient {
         return await this.post(`/theme/${themeUuid}/sections/${blockId}`, payload);
     }
 
+    /**
+     * Var olan bir block içinde boş section dosyası oluşturur
+     * @param {string} themeUuid - Tema UUID/folder
+     * @param {string} blockFolder - Hedef block klasörü (ör. slider, banner)
+     * @param {string} name - Section dosya adı (slug, .twig'siz)
+     * @returns {Promise<Object>} Oluşturulan section bilgisi
+     */
+    async createSection(themeUuid, blockFolder, name) {
+        return await this.post(`/theme/${themeUuid}/sections`, { block_folder: blockFolder, name });
+    }
+
     /**
      * Tema dev status'ünü getir
      * @param {string} themeUuid - Tema UUID/folder
@@ -161,15 +172,6 @@ export class ApiClient {
         return await this.post(`/theme/${themeUuid}/publish`, data);
     }
 
-    /**
-     * Temayı sync eder (build işlemi tetiklenir)
-     * @param {string} themeUuid - Tema UUID/folder
-     * @returns {Promise<Object>} Sync sonucu
-     */
-    async syncTheme(themeUuid) {
-        return await this.post(`/theme/${themeUuid}/sync`);
-    }
-
     /**
      * Temayı incelemeye gönder (admin onayı için)
      * @param {string} themeUuid - Tema UUID/folder

package/src/commands/theme-dev.js

@@ -8,8 +8,26 @@ import {createApiClient} from '../api-client.js';
 import open from 'open';
 import {normalizeStoreDomain, slugify, setActiveTheme, getActiveTheme, getActiveStore} from '../storage.js';
 import {brandedConfirm, brandedSelect, showWarning, showError, showInfo} from '../ui/prompt-wrapper.js';
+import {themeSectionMenuCommand} from './theme-section.js';
 import { t } from '../i18n.js';
 
+function resolveSectionFolder(relativePath) {
+    if (!relativePath) {
+        return null;
+    }
+
+    const segments = relativePath.split(/[\\/]+/).filter(Boolean);
+    const sectionIndex = segments.indexOf('section');
+
+    if (sectionIndex === -1 || !segments[sectionIndex + 1]) {
+        return null;
+    }
+
+    const folder = segments[sectionIndex + 1];
+
+    return folder.includes('.') ? null : folder;
+}
+
 async function fetchAllThemes() {
     const apiClient = await createApiClient();
     const all = [];
@@ -117,6 +135,11 @@ async function handleFileChange(themeUuid, themePath, filePath) {
         const duration = Date.now() - startTime;
         console.log(chalk.green(`[${new Date().toLocaleTimeString()}] ` + t('dev.file_saved', { path: relativePath, duration })));
 
+        const sectionFolder = resolveSectionFolder(relativePath);
+        if (sectionFolder) {
+            console.log(chalk.cyan('  ' + t('dev.section_synced', { folder: sectionFolder })));
+        }
+
         try {
             await apiClient.post(`/theme/${themeUuid}/mark-synced`, {});
         } catch (ackError) {
@@ -185,6 +208,15 @@ async function handleFileDelete(themeUuid, themePath, filePath) {
     }
 }
 
+function printWatchStatus(previewUrl) {
+    const sep = chalk.dim(' · ');
+    const parts = [chalk.cyan('👀 ' + t('dev.status_watching'))];
+    if (previewUrl) parts.push(chalk.bold.green('P') + chalk.gray(' ' + t('dev.status_preview')));
+    parts.push(chalk.bold.green('S') + chalk.gray(' ' + t('dev.status_section')));
+    parts.push(chalk.gray('Ctrl+C ' + t('dev.status_exit')));
+    console.log('\n' + parts.join(sep) + '\n');
+}
+
 async function startFileWatcher(themeUuid, themePath) {
     // Preview URL — sessizce cek, baglanamazsa status line'da P ipucunu gosterme
     let previewUrl = null;
@@ -196,15 +228,24 @@ async function startFileWatcher(themeUuid, themePath) {
         // sessiz — preview opsiyonel
     }
 
-    // Tek satirlik compact status — watching + P preview (varsa) + Ctrl+C exit
-    const sep = chalk.dim(' · ');
-    const parts = [chalk.cyan('👀 ' + t('dev.status_watching'))];
-    if (previewUrl) parts.push(chalk.bold.green('P') + chalk.gray(' ' + t('dev.status_preview')));
-    parts.push(chalk.gray('Ctrl+C ' + t('dev.status_exit')));
-    console.log('\n' + parts.join(sep) + '\n');
+    printWatchStatus(previewUrl);
+
+    // Menu acikken hem watcher event'leri hem keypress dinleyici askiya alinir
+    // (inquirer ile stdin cakismasini onler).
+    let paused = false;
 
-    // Klavye dinleyici — 'P' tarayıcida preview URL'ini sessizce acar, Ctrl+C cikis
-    if (previewUrl && process.stdin.isTTY) {
+    const setRawMode = (enabled) => {
+        if (process.stdin.isTTY) {
+            try {
+                process.stdin.setRawMode(enabled);
+            } catch {
+                // raw mode bazi terminallerde calismaz — sessizce gec
+            }
+        }
+    };
+
+    // Klavye dinleyici — 'P' tarayıcida preview URL'ini sessizce acar, 'S' section menusu, Ctrl+C cikis
+    if (process.stdin.isTTY) {
         try {
             process.stdin.setRawMode(true);
             process.stdin.resume();
@@ -213,37 +254,83 @@ async function startFileWatcher(themeUuid, themePath) {
                 if (key === '\u0003') { // Ctrl+C
                     process.exit(0);
                 }
-                if (key === 'p' || key === 'P') {
+                if (paused) {
+                    return;
+                }
+                if (previewUrl && (key === 'p' || key === 'P')) {
                     try {
                         await open(previewUrl);
                     } catch (e) {
                         console.log(chalk.red('  ' + t('dev.preview_open_failed', { error: e.message })));
                     }
                 }
+                if (key === 's' || key === 'S') {
+                    await openSectionMenu();
+                }
             });
         } catch {
             // raw mode bazi terminallerde calismaz — sessizce gec
         }
     }
 
-    const watcher = chokidar.watch(themePath, {
+    const watcherOptions = {
         ignored: /(^|[\/\\])\../, persistent: true, ignoreInitial: true, awaitWriteFinish: {
             stabilityThreshold: 300, pollInterval: 100
         }
-    });
+    };
 
-    watcher
-        .on('change', async (filePath) => {
-            await handleFileChange(themeUuid, themePath, filePath);
-        })
-        .on('add', async (filePath) => {
-            await handleFileChange(themeUuid, themePath, filePath);
-        })
-        .on('unlink', async (filePath) => {
-            await handleFileDelete(themeUuid, themePath, filePath);
-        });
+    const attachWatcherEvents = (instance) => {
+        instance
+            .on('change', async (filePath) => {
+                if (paused) return;
+                await handleFileChange(themeUuid, themePath, filePath);
+            })
+            .on('add', async (filePath) => {
+                if (paused) return;
+                await handleFileChange(themeUuid, themePath, filePath);
+            })
+            .on('unlink', async (filePath) => {
+                if (paused) return;
+                await handleFileDelete(themeUuid, themePath, filePath);
+            });
+    };
+
+    let watcher = chokidar.watch(themePath, watcherOptions);
+    attachWatcherEvents(watcher);
 
-    return watcher;
+    async function openSectionMenu() {
+        paused = true;
+        setRawMode(false);
+
+        // Menu dallari (create/fork/add) yeni section dosyalarini zip ile
+        // indirip extract eder; bu extract eski watcher'da gecikmeli 'change'
+        // olaylari uretir. Watcher'i tamamen kapatip menu+extract bittikten
+        // sonra yeniden kuruyoruz — ignoreInitial sayesinde yeni watcher
+        // extract edilmis dosyalari gormez, sadece sonraki gercek
+        // degisiklikleri yakalar.
+        await watcher.close();
+
+        console.log(chalk.cyan('\n' + t('dev.section_menu_opening') + '\n'));
+
+        try {
+            await themeSectionMenuCommand();
+        } catch (error) {
+            console.log(chalk.red('  ' + error.message));
+        }
+
+        watcher = chokidar.watch(themePath, watcherOptions);
+        attachWatcherEvents(watcher);
+
+        setRawMode(true);
+        process.stdin.resume();
+        console.log(chalk.green('\n' + t('dev.section_menu_resumed')));
+        printWatchStatus(previewUrl);
+        paused = false;
+    }
+
+    return {
+        close: () => watcher.close(),
+    };
 }
 
 function startKeepAlive(themeUuid) {

package/src/commands/theme-section.js

@@ -6,9 +6,25 @@ import path from 'path';
 import AdmZip from 'adm-zip';
 import {createApiClient} from '../api-client.js';
 import {getActiveTheme, getThemeUuidBySlug, normalizeStoreDomain, getActiveStore} from '../storage.js';
-import {brandedConfirm, brandedSelect, showWarning} from '../ui/prompt-wrapper.js';
+import {brandedConfirm, brandedSelect, brandedSearch, brandedInput, showWarning, showSuccess, showInfo} from '../ui/prompt-wrapper.js';
 import { t } from '../i18n.js';
 
+const SECTION_NAME_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+
+function validateSectionName(value) {
+    const trimmed = (value || '').trim();
+    if (!trimmed) {
+        return t('section.create.name_required');
+    }
+    if (/\.[a-z0-9]+$/i.test(trimmed)) {
+        return t('section.create.name_no_extension');
+    }
+    if (!SECTION_NAME_PATTERN.test(trimmed)) {
+        return t('section.create.name_invalid');
+    }
+    return true;
+}
+
 export async function themeSectionListCommand() {
     try {
         // Aktif temayı al
@@ -109,12 +125,12 @@ export async function themeSectionAddCommand() {
 
         // Block seçimi
         const blockChoices = availableBlocks.map(block => ({
-            name: `${block.name} ${chalk.gray(`(${block.default_sections.length} section)`)}`,
+            name: `${block.name} ${chalk.gray(`(${block.folder}, ${block.default_sections.length} section)`)}`,
             value: block,
-            description: `${t('section.list.folder_label')} ${block.folder}`
+            keywords: [block.name, block.folder],
         }));
 
-        const selectedBlock = await brandedSelect({
+        const selectedBlock = await brandedSearch({
             message: t('section.add.block_select_prompt'),
             choices: blockChoices,
         }, t('section.add.block_select_title'));
@@ -315,3 +331,214 @@ export async function themeSectionAddCommand() {
         process.exit(1);
     }
 }
+
+async function downloadThemeFiles(apiClient, themeUuid, themePath) {
+    const downloadResponse = await apiClient.download(`/theme/${themeUuid}/download`, {});
+
+    const zipPath = path.join(themePath, 'theme-update.zip');
+    const writer = createWriteStream(zipPath);
+
+    downloadResponse.data.pipe(writer);
+
+    await new Promise((resolve, reject) => {
+        writer.on('finish', resolve);
+        writer.on('error', reject);
+    });
+
+    const zip = new AdmZip(zipPath);
+    zip.extractAllTo(themePath, true);
+
+    await fs.unlink(zipPath);
+}
+
+export async function themeSectionCreateCommand() {
+    try {
+        const activeTheme = await getActiveTheme();
+        if (!activeTheme) {
+            showWarning(t('section.add.no_active_theme'));
+            return;
+        }
+
+        const themeInfo = await getThemeUuidBySlug(activeTheme);
+
+        const apiClient = await createApiClient();
+        const response = await apiClient.getSections(themeInfo.uuid);
+        const blocks = response.data || [];
+
+        if (blocks.length === 0) {
+            showWarning(t('section.create.no_blocks'));
+            return;
+        }
+
+        const selectedBlock = await brandedSearch({
+            message: t('section.create.block_prompt'),
+            choices: blocks.map((block) => ({
+                name: `${block.name} ${chalk.gray(`(${block.folder})`)}`,
+                value: block,
+                keywords: [block.name, block.folder],
+            })),
+        }, t('section.create.title'));
+
+        const name = await brandedInput({
+            message: t('section.create.name_prompt'),
+            validate: validateSectionName,
+        }, t('section.create.title'));
+
+        const sectionName = name.trim();
+        const sectionFile = `${sectionName}.twig`;
+        const targetPath = `section/${selectedBlock.folder}/${sectionFile}`;
+
+        const confirm = await brandedConfirm({
+            message: t('section.create.confirm_prompt', { file: targetPath, theme: themeInfo.name }),
+            default: true,
+        }, t('section.add.confirm_title'));
+
+        if (!confirm) {
+            showWarning(t('section.add.cancelled'));
+            return;
+        }
+
+        try {
+            await apiClient.createSection(themeInfo.uuid, selectedBlock.folder, sectionName);
+        } catch (error) {
+            if (error.message.startsWith('VALIDATION_ERROR:')) {
+                showWarning(t('section.create.failed', { error: error.message.replace('VALIDATION_ERROR:', '') }));
+                return;
+            }
+            throw error;
+        }
+
+        showSuccess(t('section.create.created', { file: targetPath }));
+
+        const store = await getActiveStore();
+        const storeSlug = normalizeStoreDomain(store);
+        const themePath = path.join(process.cwd(), storeSlug, activeTheme);
+
+        try {
+            await downloadThemeFiles(apiClient, themeInfo.uuid, themePath);
+            console.log(chalk.green(t('section.add.files_updated')));
+            console.log(chalk.gray('   ' + t('section.add.location', { path: `${storeSlug}/${activeTheme}/` }) + '\n'));
+        } catch (downloadError) {
+            console.error(chalk.red(t('section.add.download_error')), downloadError.message);
+            console.log(chalk.yellow('\n' + t('section.add.manual_tip')));
+            console.log(chalk.white(`   ${t('section.add.manual_command')}\n`));
+        }
+    } catch (error) {
+        console.error(chalk.red('\n❌ Hata: ') + error.message);
+        process.exit(1);
+    }
+}
+
+export async function themeSectionForkCommand() {
+    try {
+        const activeTheme = await getActiveTheme();
+        if (!activeTheme) {
+            showWarning(t('section.add.no_active_theme'));
+            return;
+        }
+
+        const themeInfo = await getThemeUuidBySlug(activeTheme);
+
+        const apiClient = await createApiClient();
+        const response = await apiClient.getSections(themeInfo.uuid);
+        const blocks = response.data || [];
+
+        const sourceSections = [];
+        blocks.forEach((block) => {
+            (block.default_sections || []).forEach((section) => {
+                sourceSections.push({ block, section });
+            });
+        });
+
+        if (sourceSections.length === 0) {
+            showWarning(t('section.fork.no_sources'));
+            return;
+        }
+
+        const selected = await brandedSearch({
+            message: t('section.fork.source_prompt'),
+            choices: sourceSections.map(({ block, section }) => ({
+                name: `${section.name} ${chalk.gray(`(${block.name}, v${section.version})`)}`,
+                value: { block, section },
+                keywords: [section.name, block.name, block.folder],
+            })),
+        }, t('section.fork.title'));
+
+        const newName = await brandedInput({
+            message: t('section.fork.name_prompt'),
+            validate: validateSectionName,
+        }, t('section.fork.title'));
+
+        const sectionName = newName.trim();
+        const sectionFile = `${sectionName}.twig`;
+        const blockFolder = selected.block.folder;
+        const targetPath = `section/${blockFolder}/${sectionFile}`;
+
+        const confirm = await brandedConfirm({
+            message: t('section.fork.confirm_prompt', {
+                source: selected.section.name,
+                file: targetPath,
+                theme: themeInfo.name,
+            }),
+            default: true,
+        }, t('section.add.confirm_title'));
+
+        if (!confirm) {
+            showWarning(t('section.add.cancelled'));
+            return;
+        }
+
+        try {
+            await apiClient.createSection(themeInfo.uuid, blockFolder, sectionName);
+        } catch (error) {
+            if (error.message.startsWith('VALIDATION_ERROR:')) {
+                showWarning(t('section.create.failed', { error: error.message.replace('VALIDATION_ERROR:', '') }));
+                return;
+            }
+            throw error;
+        }
+
+        showSuccess(t('section.fork.created', { file: targetPath }));
+        showInfo(t('section.fork.next_step', { file: targetPath }));
+
+        const store = await getActiveStore();
+        const storeSlug = normalizeStoreDomain(store);
+        const themePath = path.join(process.cwd(), storeSlug, activeTheme);
+
+        try {
+            await downloadThemeFiles(apiClient, themeInfo.uuid, themePath);
+            console.log(chalk.green(t('section.add.files_updated')));
+            console.log(chalk.gray('   ' + t('section.add.location', { path: `${storeSlug}/${activeTheme}/` }) + '\n'));
+        } catch (downloadError) {
+            console.error(chalk.red(t('section.add.download_error')), downloadError.message);
+            console.log(chalk.yellow('\n' + t('section.add.manual_tip')));
+            console.log(chalk.white(`   ${t('section.add.manual_command')}\n`));
+        }
+    } catch (error) {
+        console.error(chalk.red('\n❌ Hata: ') + error.message);
+        process.exit(1);
+    }
+}
+
+export async function themeSectionMenuCommand() {
+    const action = await brandedSelect({
+        message: t('section.menu.prompt'),
+        choices: [
+            { name: t('section.menu.add'), value: 'add' },
+            { name: t('section.menu.create'), value: 'create' },
+            { name: t('section.menu.fork'), value: 'fork' },
+            { name: t('section.menu.list'), value: 'list' },
+        ],
+    }, t('section.menu.title'));
+
+    switch (action) {
+        case 'add':
+            return themeSectionAddCommand();
+        case 'create':
+            return themeSectionCreateCommand();
+        case 'fork':
+            return themeSectionForkCommand();
+        case 'list':
+            return themeSectionListCommand();
+    }
+}

package/src/index.js

@@ -11,7 +11,7 @@ import { logoutCommand } from './commands/logout.js';
 import { whoamiCommand } from './commands/whoami.js';
 import { themeListCommand, themeCreateCommand, themePullCommand, themeUseCommand } from './commands/theme.js';
 import { themeDevCommand } from './commands/theme-dev.js';
-import { themeSectionListCommand, themeSectionAddCommand } from './commands/theme-section.js';
+import { themeSectionListCommand, themeSectionAddCommand, themeSectionCreateCommand, themeSectionForkCommand, themeSectionMenuCommand } from './commands/theme-section.js';
 import { themePublishCommand } from './commands/theme-publish.js';
 import { themePushCommand } from './commands/theme-push.js';
 import { themeSubmitCommand } from './commands/theme-submit.js';
@@ -167,7 +167,10 @@ org
 // section commands (under theme)
 const section = theme
   .command('section')
-  .description('Section management commands');
+  .description('Section management commands')
+  .action(async () => {
+    await themeSectionMenuCommand();
+  });
 
 section
   .command('list')
@@ -183,5 +186,19 @@ section
     await themeSectionAddCommand();
   });
 
+section
+  .command('create')
+  .description('Create an empty section in the active theme')
+  .action(async () => {
+    await themeSectionCreateCommand();
+  });
+
+section
+  .command('fork')
+  .description('Fork an existing section into the active theme')
+  .action(async () => {
+    await themeSectionForkCommand();
+  });
+
 // Parse arguments
 program.parse(process.argv);

package/src/ui/prompt-wrapper.js

@@ -1,7 +1,7 @@
 import boxen from 'boxen';
 import gradient from 'gradient-string';
 import chalk from 'chalk';
-import {input as inquirerInput, confirm as inquirerConfirm, select as inquirerSelect} from '@inquirer/prompts';
+import {input as inquirerInput, confirm as inquirerConfirm, select as inquirerSelect, search as inquirerSearch} from '@inquirer/prompts';
 import { t } from '../i18n.js';
 
 /**
@@ -108,6 +108,40 @@ export async function brandedSelect(options, boxTitle = t('ui.label.select')) {
     });
 }
 
+/**
+ * Aranabilir select prompt — kullanıcı yazdıkça choices filtrelenir.
+ * @param {object} options - { message, choices, filter? }
+ *   choices: [{ name, value, keywords? }] — keywords ek arama terimleri
+ *   filter: opsiyonel özel filtre fn(choice, term) => boolean
+ * @param {string} boxTitle - Box başlığı
+ */
+export async function brandedSearch(options, boxTitle = t('ui.label.select')) {
+    const {message, choices, filter} = options;
+
+    if (message) {
+        showBrandedBox(message, boxTitle);
+    }
+
+    const defaultFilter = (choice, term) => {
+        const haystack = [choice.name, choice.value, ...(choice.keywords || [])]
+            .filter(Boolean)
+            .join(' ')
+            .toLocaleLowerCase('tr');
+        return haystack.includes(term.toLocaleLowerCase('tr'));
+    };
+    const matches = filter || defaultFilter;
+
+    return await inquirerSearch({
+        message: '',
+        source: async (term) => {
+            if (!term) {
+                return choices;
+            }
+            return choices.filter((choice) => matches(choice, term));
+        },
+    });
+}
+
 /**
  * Özelleştirilmiş input prompt
  * @param {object} options - Prompt seçenekleri