@stechquick/studio-cli 4.0.3-2

package/dist/studio-cli/src/.ai-kit/skills/figma-to-qjson/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: figma-to-qjson
+description: Reconstruct a Quick / Plateau Studio .qjson page from a Figma design (a Figma selection URL). If the design isn't fetched yet, run the `studio figmaPull` command to populate a local .figma/ folder (node.json, file.json, render.json, imagefills.json, assets/*.svg), then turn that raw Figma node tree into a real qjson page. Use whenever the task is to convert a Figma frame/selection into a qjson page. Covers fetching via the `studio figmaPull` command, the Figma→qjson mapping rules, the geometry/style extraction recipe, the rect+text control-clustering heuristic, and asset handling. Delegates all qjson-authoring detail to the quick-qjson skill + .ai-kit kit.
+---
+
+# Figma → QJSON reconstruction
+
+This skill turns a Figma design into a **Quick `.qjson` page**. The raw Figma responses live in a local **`.figma/`** folder; you produce that folder by **running the `studio figmaPull` command** (which wraps `figmaPull(url, token)`). This skill never calls the Figma API directly — it runs the command, then reads what the command wrote.
+
+It owns only the **translation knowledge** (Figma node tree → qjson components). For everything about *authoring* qjson (schema, props, styling, validation, project conventions) it defers to the **`quick-qjson`** skill and the **`.ai-kit/`** kit — read those; do not re-derive them here.
+
+## Get the design first (run `studio figmaPull`)
+Before the translation workflow below, you need the raw Figma responses in `.figma/`. Get them by running the **`studio figmaPull` command** (the CLI that wraps `figmaPull(url, token)` — it extracts `fileKey` + `node-id` from the URL itself):
+
+- If `.figma/` is already present and current for the design you want → just read `.figma/manifest.json` and continue.
+- Otherwise **run the command yourself** (don't wait for the user to pre-fetch). The URL and token are **positional arguments**, in that order; `-d, --dir <dir>` optionally picks the workspace whose `.figma/` receives the output (defaults to the current directory):
+  ```
+    studio figmaPull "<figma-url>" "<token>"
+  ```
+- **Parameters — resolve, don't block:**
+  - **URL**: take the Figma *selection* link from the user's message / context; if it isn't there, **ask the user** (AskUserQuestion: "paste the Figma 'Copy link to selection'"). Don't guess it.
+  - **Token**: a Figma personal access token, passed as the **second positional argument**. The command has no env/config fallback, so you must supply it explicitly; ask the user once if you don't have it, never hardcode.
+- The command writes `.figma/node.json`, `file.json`, `render.json`, `imagefills.json`, `manifest.json` (+ `assets/*.svg`). **Read `manifest.json` first** — if its `node` endpoint failed (403 token / 404 file·node), surface that error and stop; don't proceed on a bad fetch.
+
+Inputs you'll then use, as needed:
+- `.figma/node.json` — the target frame's full node tree (primary input).
+- `.figma/file.json` — whole-file tree (styles, components — fallback/context).
+- `.figma/render.json` — `{images:{<nodeId>: <svg-url>}}` for vector/icon render.
+- `.figma/imagefills.json` — `imageRef → URL` map for IMAGE fills.
+- `.figma/assets/*.svg` — downloaded SVGs (if the command saved them).
+
+## Workflow (the same process a human reviewer would follow)
+
+### 0. Load + triage
+Read `node.json`, grab the fetched frame, and get a shape-of-the-page read: node-type counts, max depth, **auto-layout usage**, and all TEXT content. This decides the page kind (login / form / list / landing…) and whether it maps cleanly.
+
+```python
+import json, collections
+doc = next(iter(json.load(open('.figma/node.json'))['nodes'].values()))['document']
+types, lm, texts = collections.Counter(), collections.Counter(), []
+def walk(n):
+    types[n['type']] += 1
+    if n['type'] == 'FRAME': lm[n.get('layoutMode','NONE')] += 1
+    if n['type'] == 'TEXT':  texts.append(n.get('characters','')[:40])
+    for c in n.get('children', []): walk(c)
+walk(doc)
+print('types', dict(types)); print('layoutMode', dict(lm)); print('texts', texts)
+```
+> Many frames with `layoutMode` HORIZONTAL/VERTICAL → the layout maps cleanly to `VRow`/`VCol`. Many `NONE` (absolute) → you must reconstruct structure from geometry (step 2–3).
+
+### 1. Extract per-node geometry + style
+For each visible node, pull **frame-relative** `x,y,w,h`, fill hex, font size/weight/color, and `cornerRadius`. This table is what tells you "what each thing is".
+
+```python
+root = doc['absoluteBoundingBox']; rx, ry = root['x'], root['y']
+def hexfill(n):
+    for f in (n.get('fills') or []):
+        if f.get('type') == 'SOLID':
+            c = f['color']; return '#%02x%02x%02x' % (int(c['r']*255), int(c['g']*255), int(c['b']*255))
+    return None
+def walk(n, d=0):
+    bb = n.get('absoluteBoundingBox') or {}
+    x = (bb.get('x',0)-rx) if 'x' in bb else None; y = (bb.get('y',0)-ry) if 'y' in bb else None
+    st = n.get('style', {})
+    print('  '*d, n['type'], n.get('name'),
+          f"({x},{y}) {bb.get('width')}x{bb.get('height')}" if x is not None else '',
+          '|', repr(n.get('characters','')[:30]) if n['type']=='TEXT' else '',
+          'fz', st.get('fontSize'), 'fw', st.get('fontWeight'),
+          'fill', hexfill(n), 'r', n.get('cornerRadius'))
+    for c in n.get('children', []): walk(c, d+1)
+walk(doc)
+```
+
+### 2. Detect the *real* visible background
+The frame's own `fills` may just be the **artboard** color, not what the user sees. Look for a **full-bleed shape** (a RECTANGLE/VECTOR roughly the frame's size, drawn first/behind) — its fill is the real page background. (Tell-tale: dark text only makes sense on a light background.) Use that for `Messaging.pageBackgroundColor` and container backgrounds.
+
+### 3. Cluster loose elements into controls
+Figma often keeps a button's **background rect** and its **label text** as *separate siblings*. Infer a single control when a TEXT's center lies **within a RECTANGLE's bounds** (and they're adjacent in z-order). One rect + one text inside it = one button or one input — not two components.
+
+### 4. Map each control → qjson (the rules)
+
+| Figma pattern | → qjson | Decisive signal |
+|---|---|---|
+| auto-layout FRAME, `VERTICAL` / `HORIZONTAL` | stacked `VRow`s / a `VRow` of `VCol`s | `layoutMode` |
+| plain TEXT | `QLabel` (`text` PType `prop`) | — |
+| TEXT whose chars are PUA glyphs (U+F0000+) | `VIcon` (icon name, PType `text`) | codepoint → `mdi-*` name |
+| large bold TEXT near top | title `QLabel` | fontSize/weight |
+| rounded rect (high `cornerRadius`) + **centered, light** text inside | **filled** `VBtn` → child `QLabel`; rect fill → `S.backgroundColor` | rect has a solid fill |
+| rounded rect, `fill=none` + stroke, text inside | `VBtn` `outlined` | no fill, has stroke |
+| white/light rounded rect + **gray** text inside | `VTextField` (the gray text → `placeholder`) | inner text is a muted color |
+| field whose name/label is "şifre"/"password"/"pin" | + `type='password'` | text content |
+| small, right-aligned text link | `VBtn` `text` (link) → `QLabel` | alignment + size |
+| custom VECTOR group (logo/illustration) | `VImg` from an asset (see step 5) | type VECTOR/GROUP, not a glyph |
+| IMAGE fill (`imageRef`) | `VImg`, URL from `imagefills.json` | fill type IMAGE |
+
+Pick real props/events/styles from **`.ai-kit/reference/component-contracts.json`** and **`component-styles.json`** — never invent. Convert px → the kit's responsive grid (`col`, `S` blocks); do **not** reproduce absolute pixel coordinates.
+
+### 5. Assets (vectors / logos)
+A deployed Quick app can't read local SVGs or Figma's expiring S3 URLs. So:
+- If there is an asset pipeline / CDN, upload `.figma/assets/<id>.svg` and reference it via `VImg`.
+- Otherwise insert a **`VIcon` placeholder** in the right spot and **flag in the report** that the real logo must be exported (`render.json` URL → `.figma/assets/`) and uploaded as a Studio asset. Don't silently drop it.
+
+### 6. Author the qjson
+Hand off to **`quick-qjson`**: build top-down `Messaging → VContainer > VRow > VCol > content`, mirror a sibling page in the workspace for ID style and `S`-block shape, author `pJson`/`lrids` only (omit `cJson`/`clrids` entirely — never write them, strip if present). Wire obvious behavior (e.g. a login button → a `Messaging` event that reads `components.<id>.qValue` and `quick.Quick.alert(...)`).
+
+### 7. Validate + report
+`npx tsx .ai-kit/tools/check_qjson.ts <file>` — fix every ERROR. Then report: the new file, the **mapping decisions** (what each Figma element became), any **assumptions** (background, clustering, responsive sizing), **assets needing manual upload**, and the validation result.
+
+## Gotchas (these trip up naive conversions)
+- **Artboard ≠ background.** Use the full-bleed shape's fill, not `frame.fills`.
+- **Separate rect + text = one control.** Cluster by spatial containment before mapping.
+- **PUA-glyph TEXT is an icon**, not a label → `VIcon` (map the codepoint to an `mdi-*` name).
+- **Gray inner text in a white field = placeholder**, not a value.
+- **Absolute (`NONE`) layout** still becomes semantic `VRow/VCol`; reconstruct order/grouping from `y` then `x`. Never emit pixel coordinates.
+- **Big visual pages**: don't convert in one shot — 1–3 sections per edit (per the quick-qjson rules).
+```

package/dist/studio-cli/src/.ai-kit/skills/quick-qjson/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: quick-qjson
+description: Create, edit, and validate Quick / Plateau Studio .qjson UI pages. Use whenever the task involves authoring, modifying, reviewing, or validating .qjson files exported from Studio — covers the qjson schema, the quick.* scripting API, the component registry, the styling/layout/events systems, and validating a page before it is synced back to Studio.
+---
+
+# Quick QJSON authoring
+
+This workspace holds **Quick / Plateau Studio `.qjson`** UI pages exported from Studio (the web IDE). You edit them locally and sync them back. The complete, source-of-truth knowledge lives in the **`.ai-kit/`** folder at the workspace root — treat it as authoritative over any prior assumptions about Quick.
+
+> Paths below are written relative to the workspace root (your working directory), so they resolve regardless of where this skill file is installed.
+
+## Start here
+Read **`.ai-kit/AGENT_GUIDE.md`** — the dispatcher. Its **Step 0** reads the page's root-level `opt.V` and routes you to the **`S`** track (new page / `opt.V >= 2.0`, guide `AGENT_GUIDE-s.md`) or the **legacy** track (`opt.V` missing / `< 2.0`, guide `AGENT_GUIDE-legacy.md`). Style/layout docs are split by era; open only your track's docs plus the shared ones. Don't load it all up front.
+
+- Shared how-to (both tracks) → `.ai-kit/knowledge/` `01`,`02`,`05`,`06`,`07`,`08`,`11`
+- Shared reference — the **generation inputs, read before you write** → `.ai-kit/reference/` (`quick-api.md`, `component-index.json`, `component-contracts.json`, `component-styles.json`, `events-system.md`)
+- Style-split docs (pick your track) → schema `qjson-schema[-legacy].md`; structure `00-qjson-structure[-legacy].md`; layout `03-layout-and-slots[-legacy].md`; styling `04-styling.md`/`04-styling-legacy.md`; styling ref `styling-system.md`/`layout-system.md`; catalog `component-catalog[-legacy].md`; skeletons `09-page-skeletons[-legacy].md`; validation `10-validation-and-sync[-legacy].md`
+- Copy-paste skeletons / examples → your track's `09-page-skeletons[-legacy].md`; `.ai-kit/examples/style/` (S) or `.ai-kit/examples/cssClass/` (legacy) — see `.ai-kit/examples/README.md`
+- Deep official docs (fallback) → `.ai-kit/docs/` (index: `.ai-kit/docs/README.md`)
+
+## Workflow
+1. Read the target `.qjson` + 1–2 sibling pages to copy project conventions (IDs, service URLs, CSS classes, `<<qjson:id>>` navigation).
+2. Author only `pJson` / `lrids` — **omit the compiled `cJson` / `clrids` entirely** (never write them into a new file; strip them from any downloaded file you edit — Studio regenerates them on import).
+3. Build top-down from a skeleton; for large pages edit 1–3 sections at a time.
+4. **Compile before finishing:** `studio buildQjson <file>` (compiles with the bundled Quick compiler and reports any errors). Fix every error.
+5. Report: changed file(s), what changed, the validation result, and any project assumption you made.
+
+## Golden rules (full list + rationale in `.ai-kit/AGENT_GUIDE.md`)
+- Valid `T` (check `component-index.json`); unique `P.ID.H` and `_Editor.eID` (need not match). Don't invent props/events — use `component-contracts.json`.
+- Prop strings single-quoted in `H`; QScript object literals use `=`; `QLabel.text` → PType `prop`; `VIcon` icon → `text` (PType `text`).
+- Events: `quick.return` (never native `return`); no browser globals; **event handlers are always `"HL":"TS"`** (property/binding expressions default to `QS`). Props use `LR('key')`, events use `quick.LR('key')`.
+- Layout mechanism is per-system (read `opt.V` first): **`S` page** → width/direction/spacing in `S` (`S.col`, `S.flexDirection`, …), never `O.layout`; **legacy page** → `O.layout.dOpt` ↔ `class` synced, size columns with `c:col-N`. Charts only `Bar`/`Line`/`Doughnut`; alerts include `actionButtons`; `VBtn` label is a child component.
+- Don't rename files — Studio syncs back by name/id.
+
+## Specialists
+You can delegate to the specialist subagents in `.ai-kit/agents/` — `quick-styling` (styling **and** layout on `S`-system pages), `quick-styling-legacy` (`O.layout` + CSS classes on legacy `V<2` pages), `quick-events` (shared) — under the `quick-qjson-author` orchestrator, which reads `opt.V` and routes to the right presentation specialist (routing decision: `.ai-kit/AGENT_GUIDE.md` Step 0).

package/dist/studio-cli/src/.ai-kit/tools/README.md

@@ -0,0 +1,42 @@
+# Tools
+
+The point here is to replace the manual *paste-into-Studio → copy-the-error → paste-to-AI → paste-back* loop with a **local compile the AI runs itself**: generate/edit qjson → compile → read errors → fix → repeat, until clean.
+
+## `studio buildQjson` — compile (use this in the fix-loop)
+
+studio-cli bundles the official Quick compiler and exposes it as a single command:
+
+```bash
+studio buildQjson <file.qjson | folder>
+```
+
+It compiles `pJson → cJson` exactly like the editor and reports **QScript/TypeScript syntax & type errors** in your handlers — the editor's real check, always in sync with the runtime. Exit code `0` = compiled clean, non-zero = errors.
+
+Its output has **three sections**, run in order on the same file(s): (1) the official compiler report above, (2) a **structural validation** pass (the editor-domain checks the compiler doesn't do — unknown component `T`, duplicate `ID`/`eID`, bad `PType`/`HL`, `dOpt`↔`class` drift, containment), and (3) a **style validation** pass (below). Read all three.
+
+### Running `studio buildQjson` from a workspace
+`studio pull` installs this kit into your workspace. Make sure `studio` is on your PATH (a global install — the normal case), then run `studio buildQjson <file>` from anywhere in the workspace.
+
+### The fix-loop (what the agent does)
+```
+generate/edit page.qjson
+  → studio buildQjson page.qjson
+  → if it reports errors: read them, fix the file, repeat
+  → else: deliver
+```
+
+### Built-in S-first style check (section 3 of `buildQjson`)
+
+The compiler checks *script/type* correctness but **silently ignores unknown styling** — a wrong `S` param (e.g. `fontColor` on a VIcon, which really wants `iconColor`) or a Vuetify prop that should be `S` (`color` on a VBtn) compiles "clean" yet renders nothing. `buildQjson` closes that gap automatically in its third section, deterministically, straight from `component-contracts.json` + `component-styles.json`. It activates **only on S-track pages** (`opt.V >= 2.0`, or a page that carries an `S` object); legacy pages don't render `S`, so they're reported as `skipped`.
+
+Per node it flags, with a suggested fix:
+- **`prop-to-S`** — a styling prop with an `S` equivalent (`color`→`backgroundColor`, `elevation`→`boxShadow`, VCol `cols/sm/md/lg`→`col`, `block`→`width:100%`).
+- **`class-token-to-S` / `class-token-misuse`** — a `class` token that has an `S` target the component supports (move it), or a grid class on the wrong component (`col-12` on a VBtn → `width:100%`).
+- **`unknown-S-param`** — an `S` param the component doesn't have (with a "did you mean" rename, e.g. `borderTopLeftRadius`→`innerBorderTopLeftRadius` on VTextField).
+- **`unknown-prop`**, **`style-conflict`** (same style in both `S` and `class`), **`legacy-layout`** (`O.layout`/`dOpt` still present).
+
+Rule order matches the S-first policy: **contract prop → S equivalent → Vuetify class only as last resort.** No separate command to run — every `buildQjson` includes it, so it's part of the same fix-loop.
+
+## Reference data (`reference/*.json`)
+
+The style + structural checks read two maintainer-owned files — `component-contracts.json` (per-component props/events/PType) and `component-styles.json` (per-component `S` params) — extracted from authoritative Quick runtime sources (`ComponentPims.ts`, `componentList.js`, `styleDefinitions.ts`). They're regenerated by the Quick team when the runtime changes; treat them as read-only ground truth in a workspace.

package/dist/studio-cli/src/control/controlClient.js

@@ -0,0 +1,119 @@
+"use strict";
+// Control komutu istemcisi — yalnızca TETİKLEYİCİ. workspace'in `.studio/server.json`'ından portu
+// okur, çalışan `studio connect` daemon'ına POST /control/<cmd> atar (boş), server'ın özetini basar.
+// ASIL İŞİ SERVER YAPAR (dosya tarama/yazma, relay, state) — büyük veri HTTP'den geçmez.
+// pid kontrolü YOK — server ayakta değilse fetch zaten bağlantı reddiyle patlar.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runControl = void 0;
+const serverInfo_1 = require("../server/serverInfo");
+const logger_1 = require("../util/logger");
+const BAR_WIDTH = 20;
+function createProgress(text) {
+    if (!process.stdout.isTTY)
+        return { update: () => { }, stop: () => { } };
+    let maxLen = 0;
+    const write = (line) => {
+        maxLen = Math.max(maxLen, line.length);
+        process.stdout.write(`\r${line}`);
+    };
+    write(`  ${text}`);
+    return {
+        update: (written, total) => {
+            const filled = total > 0 ? Math.round((written / total) * BAR_WIDTH) : 0;
+            const bar = "-".repeat(filled).padEnd(BAR_WIDTH, " ");
+            write(`  ${text} ${bar} ${written}/${total}`);
+        },
+        stop: () => {
+            process.stdout.write("\n");
+        },
+    };
+}
+async function readNdjsonStream(body, onLine) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            const t = line.trim();
+            if (t)
+                try {
+                    onLine(JSON.parse(t));
+                }
+                catch { /* skip */ }
+        }
+    }
+    if (buffer.trim())
+        try {
+            onLine(JSON.parse(buffer.trim()));
+        }
+        catch { /* skip */ }
+}
+/** @returns process çıkış kodu (0 ok, 1 hata) */
+async function runControl(rootDir, cmd) {
+    const info = (0, serverInfo_1.readServerInfo)(rootDir);
+    if (!info) {
+        logger_1.logger.error("no studio server in this workspace — run `studio connect` first");
+        return 1;
+    }
+    const progress = createProgress(`${cmd}…`);
+    let res;
+    try {
+        res = await fetch(`http://127.0.0.1:${info.port}/control/${cmd}`, { method: "POST" });
+    }
+    catch {
+        progress.stop();
+        logger_1.logger.error("studio server not reachable — is `studio connect` running?");
+        return 1;
+    }
+    const contentType = res.headers.get("content-type") ?? "";
+    if (contentType.includes("application/x-ndjson") && res.body) {
+        let lastMessage;
+        const skippedLines = [];
+        await readNdjsonStream(res.body, (data) => {
+            if (data["progress"] !== undefined && data["total"] !== undefined) {
+                progress.update(Number(data["progress"]), Number(data["total"]));
+            }
+            else if (data["skipped"] !== undefined) {
+                skippedLines.push(String(data["skipped"]));
+            }
+            else if (data["message"] !== undefined) {
+                lastMessage = String(data["message"]);
+            }
+            else if (data["error"] !== undefined) {
+                lastMessage = String(data["error"]);
+            }
+        });
+        progress.stop();
+        for (const line of skippedLines)
+            logger_1.logger.warn(`skipped: ${line}`);
+        if (!res.ok) {
+            logger_1.logger.error(`${cmd} failed: HTTP ${res.status}`);
+            return 1;
+        }
+        if (lastMessage)
+            logger_1.logger.info(lastMessage);
+        return 0;
+    }
+    // NDJSON olmayan yanıt (push, startWorking, hata vb.)
+    progress.stop();
+    const text = await res.text();
+    if (!res.ok) {
+        logger_1.logger.error(`${cmd} failed: ${text || `HTTP ${res.status}`}`);
+        return 1;
+    }
+    try {
+        logger_1.logger.info(JSON.parse(text).message ?? text);
+    }
+    catch {
+        logger_1.logger.info(text);
+    }
+    return 0;
+}
+exports.runControl = runControl;
+//# sourceMappingURL=controlClient.js.map

package/dist/studio-cli/src/control/controlClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlClient.js","sourceRoot":"","sources":["../../../../src/control/controlClient.ts"],"names":[],"mappings":"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"}

package/dist/studio-cli/src/control/convertToBlock.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runConvertToBlock = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const serverInfo_1 = require("../server/serverInfo");
+const frontmatter_1 = require("../util/frontmatter");
+const logger_1 = require("../util/logger");
+/** studio convertToBlock <yol>: dosyadan modelId çözer, Studio'da qjson'ı block component'e çevirir. */
+async function runConvertToBlock(rootDir, filePath) {
+    const absPath = (0, node_path_1.resolve)(filePath);
+    let content;
+    try {
+        content = await (0, promises_1.readFile)(absPath, "utf8");
+    }
+    catch {
+        logger_1.logger.error(`cannot read file: ${absPath}`);
+        return 1;
+    }
+    const parsed = (0, frontmatter_1.parseFrontmatter)(content);
+    if (!parsed) {
+        logger_1.logger.error(`no studio frontmatter in ${absPath} — is this a studio-managed file?`);
+        return 1;
+    }
+    const { id: modelId } = parsed.meta;
+    const info = (0, serverInfo_1.readServerInfo)(rootDir);
+    if (!info) {
+        logger_1.logger.error("no studio server in this workspace — run `studio connect` first");
+        return 1;
+    }
+    let res;
+    try {
+        res = await fetch(`http://127.0.0.1:${info.port}/control/convertToBlock`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ modelId }),
+        });
+    }
+    catch {
+        logger_1.logger.error("studio server not reachable — is `studio connect` running?");
+        return 1;
+    }
+    if (!res.ok) {
+        const text = await res.text();
+        let errMsg = text;
+        try {
+            const j = JSON.parse(text);
+            if (j.error)
+                errMsg = j.error;
+        }
+        catch { /* keep raw */ }
+        logger_1.logger.error(`convertToBlock failed: ${errMsg || `HTTP ${res.status}`}`);
+        return 1;
+    }
+    const result = (await res.json());
+    if (!result.converted) {
+        logger_1.logger.error(`convert failed for model ${modelId}`);
+        return 1;
+    }
+    // Dönüşüm sonrası lokaldeki frontmatter'ı da güncelle (bayrak zaten varsa dokunma).
+    if (!parsed.meta.blockComponent) {
+        await (0, promises_1.writeFile)(absPath, (0, frontmatter_1.writeWithFrontmatter)({ ...parsed.meta, blockComponent: true }, parsed.body), "utf8");
+    }
+    logger_1.logger.info(result.alreadyBlock
+        ? `${filePath} is already a block component`
+        : `${filePath} converted to block component`);
+    return 0;
+}
+exports.runConvertToBlock = runConvertToBlock;
+//# sourceMappingURL=convertToBlock.js.map

package/dist/studio-cli/src/control/convertToBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertToBlock.js","sourceRoot":"","sources":["../../../../src/control/convertToBlock.ts"],"names":[],"mappings":";;;AAAA,+CAAuD;AACvD,yCAAoC;AACpC,qDAAsD;AACtD,qDAA6E;AAC7E,2CAAwC;AAGxC,wGAAwG;AACjG,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,QAAgB;IACvE,MAAM,OAAO,GAAG,IAAA,mBAAO,EAAC,QAAQ,CAAC,CAAC;IAElC,IAAI,OAAe,CAAC;IACpB,IAAI;QACF,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;KAC3C;IAAC,MAAM;QACN,eAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,CAAC;KACV;IAED,MAAM,MAAM,GAAG,IAAA,8BAAgB,EAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE;QACX,eAAM,CAAC,KAAK,CAAC,4BAA4B,OAAO,mCAAmC,CAAC,CAAC;QACrF,OAAO,CAAC,CAAC;KACV;IAED,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAEpC,MAAM,IAAI,GAAG,IAAA,2BAAc,EAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE;QACT,eAAM,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QAChF,OAAO,CAAC,CAAC;KACV;IAED,IAAI,GAAa,CAAC;IAClB,IAAI;QACF,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,CAAC,IAAI,yBAAyB,EAAE;YACxE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAClC,CAAC,CAAC;KACJ;IAAC,MAAM;QACN,eAAM,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC3E,OAAO,CAAC,CAAC;KACV;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;QACX,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI;YAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;YAAC,IAAI,CAAC,CAAC,KAAK;gBAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;SAAE;QAAC,MAAM,EAAE,cAAc,EAAE;QACjH,eAAM,CAAC,KAAK,CAAC,0BAA0B,MAAM,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,CAAC;KACV;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgC,CAAC;IAEjE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;QACrB,eAAM,CAAC,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC;KACV;IAED,oFAAoF;IACpF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;QAC/B,MAAM,IAAA,oBAAS,EAAC,OAAO,EAAE,IAAA,kCAAoB,EAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;KAC/G;IAED,eAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY;QAC7B,CAAC,CAAC,GAAG,QAAQ,+BAA+B;QAC5C,CAAC,CAAC,GAAG,QAAQ,+BAA+B,CAAC,CAAC;IAChD,OAAO,CAAC,CAAC;AACX,CAAC;AA7DD,8CA6DC"}

package/dist/studio-cli/src/control/pickWorkspaceDir.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickWorkspaceDir = void 0;
+const os = __importStar(require("node:os"));
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const logger_1 = require("../util/logger");
+/**
+ * Open a native OS folder picker dialog and return the selected absolute path,
+ * or null if the user cancelled.
+ *
+ * macOS : osascript "choose folder"
+ * Windows: PowerShell + WinForms FolderBrowserDialog
+ */
+function pickWorkspaceDir() {
+    const platform = os.platform();
+    if (platform === "darwin") {
+        return pickMac();
+    }
+    else if (platform === "win32") {
+        return pickWindows();
+    }
+    else {
+        logger_1.logger.error(`Folder picker is not supported on platform: ${platform}`);
+        return null;
+    }
+}
+exports.pickWorkspaceDir = pickWorkspaceDir;
+function pickMac() {
+    // "with prompt" surfaces the dialog even when called from a background process.
+    // "default location" starts in the home directory.
+    const script = [
+        'tell application "Finder" to activate',
+        'set chosen to choose folder with prompt "Select workspace folder for Studio CLI:"',
+        "return POSIX path of chosen",
+    ].join("\n");
+    const result = (0, node_child_process_1.spawnSync)("osascript", ["-e", script], { encoding: "utf8" });
+    if (result.status !== 0) {
+        // User cancelled (exit 1) or other error.
+        const stderr = result.stderr?.trim();
+        if (stderr && !stderr.includes("User canceled")) {
+            logger_1.logger.error(`osascript error: ${stderr}`);
+        }
+        return null;
+    }
+    return result.stdout.trim().replace(/\/$/, "") || null;
+}
+function pickWindows() {
+    const outFile = (0, node_path_1.join)(os.tmpdir(), `studio-pick-${process.pid}-${Date.now()}.txt`);
+    const ps = [
+        "Add-Type -AssemblyName System.Windows.Forms",
+        "$d = New-Object System.Windows.Forms.FolderBrowserDialog",
+        '$d.Description = "Select workspace folder for Studio CLI:"',
+        "$d.ShowNewFolderButton = $false",
+        "$null = $d.ShowDialog()",
+        `[System.IO.File]::WriteAllText('${outFile}', $d.SelectedPath, [System.Text.Encoding]::UTF8)`,
+    ].join("; ");
+    // -WindowStyle Hidden + windowsHide: boş PowerShell konsol penceresini bastırır. Klasör
+    // diyaloğu ayrı GUI penceresi olduğu için yine görünür.
+    const result = (0, node_child_process_1.spawnSync)("powershell.exe", ["-NoProfile", "-WindowStyle", "Hidden", "-Command", ps], { encoding: "utf8", windowsHide: true });
+    if (result.status !== 0) {
+        const stderr = result.stderr?.trim();
+        if (stderr)
+            logger_1.logger.error(`PowerShell error: ${stderr}`);
+        return null;
+    }
+    // İptal edilirse SelectedPath "" → dosya boş → null.
+    try {
+        return (0, node_fs_1.readFileSync)(outFile, "utf8").replace(/^/, "").trim() || null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            (0, node_fs_1.unlinkSync)(outFile);
+        }
+        catch { /* yok say */ }
+    }
+}
+//# sourceMappingURL=pickWorkspaceDir.js.map

package/dist/studio-cli/src/control/pickWorkspaceDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickWorkspaceDir.js","sourceRoot":"","sources":["../../../../src/control/pickWorkspaceDir.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA8B;AAC9B,2DAA+C;AAC/C,qCAAmD;AACnD,yCAAiC;AACjC,2CAAwC;AAExC;;;;;;GAMG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAE/B,IAAI,QAAQ,KAAK,QAAQ,EAAE;QACzB,OAAO,OAAO,EAAE,CAAC;KAClB;SAAM,IAAI,QAAQ,KAAK,OAAO,EAAE;QAC/B,OAAO,WAAW,EAAE,CAAC;KACtB;SAAM;QACL,eAAM,CAAC,KAAK,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;KACb;AACH,CAAC;AAXD,4CAWC;AAED,SAAS,OAAO;IACd,gFAAgF;IAChF,mDAAmD;IACnD,MAAM,MAAM,GAAG;QACb,uCAAuC;QACvC,mFAAmF;QACnF,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;QACvB,0CAA0C;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACrC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;YAC/C,eAAM,CAAC,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;SAC5C;QACD,OAAO,IAAI,CAAC;KACb;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;AACzD,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,EAAE,CAAC,MAAM,EAAE,EAAE,eAAe,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClF,MAAM,EAAE,GAAG;QACT,6CAA6C;QAC7C,0DAA0D;QAC1D,4DAA4D;QAC5D,iCAAiC;QACjC,yBAAyB;QACzB,mCAAmC,OAAO,mDAAmD;KAC9F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,wFAAwF;IACxF,wDAAwD;IACxD,MAAM,MAAM,GAAG,IAAA,8BAAS,EACtB,gBAAgB,EAChB,CAAC,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAC,EACxD,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CACxC,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACrC,IAAI,MAAM;YAAE,eAAM,CAAC,KAAK,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;KACb;IAED,qDAAqD;IACrD,IAAI;QACF,OAAO,IAAA,sBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;KACvE;IAAC,MAAM;QACN,OAAO,IAAI,CAAC;KACb;YAAS;QACR,IAAI;YAAE,IAAA,oBAAU,EAAC,OAAO,CAAC,CAAC;SAAE;QAAC,MAAM,EAAE,aAAa,EAAE;KACrD;AACH,CAAC"}

package/dist/studio-cli/src/control/protocolHandler.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runProtocolOpen = void 0;
+const node_child_process_1 = require("node:child_process");
+const logger_1 = require("../util/logger");
+/**
+ * Handle an incoming studio:// URL dispatched by the OS protocol handler.
+ *
+ * URL structure:  studio://<command>[?<params>]
+ *   - hostname  = command  (e.g. "connect")
+ *   - pathname  = must be empty or "/"  (anything else is an error)
+ *   - search    = optional query params for the command
+ *
+ * Example:  studio://connect
+ */
+async function runProtocolOpen(url) {
+    logger_1.logger.info(`Received URL: ${url}`);
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        logger_1.logger.error(`Invalid URL: ${url}`);
+        return 1;
+    }
+    const command = parsed.hostname;
+    const pathname = parsed.pathname.replace(/^\//, "");
+    switch (command) {
+        case "connect":
+            return handleConnect(pathname, parsed.searchParams);
+        default:
+            logger_1.logger.error(`Unknown command: "${command}". No handler registered for studio://${command}.`);
+            return 1;
+    }
+}
+exports.runProtocolOpen = runProtocolOpen;
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+function handleConnect(pathname, params) {
+    if (pathname !== "") {
+        logger_1.logger.error(`Unexpected path in URL: "/${pathname}". studio://connect does not accept a path.`);
+        return 1;
+    }
+    const args = [process.argv[1], "connect"];
+    const dir = params.get("dir");
+    if (dir) {
+        args.push("--dir", dir);
+    }
+    // Spawn detached so the protocol handler exits immediately —
+    // the OS expects a quick return from URL scheme handlers.
+    const child = (0, node_child_process_1.spawn)(process.execPath, args, {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+    logger_1.logger.info(`Launched: studio connect${dir ? ` --dir ${dir}` : ""} (pid ${child.pid})`);
+    return 0;
+}
+//# sourceMappingURL=protocolHandler.js.map

package/dist/studio-cli/src/control/protocolHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolHandler.js","sourceRoot":"","sources":["../../../../src/control/protocolHandler.ts"],"names":[],"mappings":";;;AAAA,2DAA2C;AAC3C,2CAAwC;AAExC;;;;;;;;;GASG;AACI,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,eAAM,CAAC,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;IAEpC,IAAI,MAAW,CAAC;IAChB,IAAI;QAAE,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;KAAE;IAAC,MAAM;QAAE,eAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;KAAE;IAEvF,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEpD,QAAQ,OAAO,EAAE;QACf,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAEtD;YACE,eAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,yCAAyC,OAAO,GAAG,CAAC,CAAC;YAC9F,OAAO,CAAC,CAAC;KACZ;AACH,CAAC;AAjBD,0CAiBC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,SAAS,aAAa,CAAC,QAAgB,EAAE,MAAuB;IAC9D,IAAI,QAAQ,KAAK,EAAE,EAAE;QACnB,eAAM,CAAC,KAAK,CAAC,6BAA6B,QAAQ,6CAA6C,CAAC,CAAC;QACjG,OAAO,CAAC,CAAC;KACV;IAED,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,GAAG,EAAE;QACP,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;KACzB;IAED,6DAA6D;IAC7D,0DAA0D;IAC1D,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;QAC1C,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,eAAM,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;IACxF,OAAO,CAAC,CAAC;AACX,CAAC"}