Release 0.3.0 — theme system

.cursor/rules/gitflow.md

@@ -72,16 +72,47 @@ git checkout -b issue/38-querya-workbench-theme-models
 
 ## GitHub labels & milestones
 
-На **issues** и **PRs** через `gh`:
+### Milestone: **Theme system**
+
+Epic [#37](https://github.com/QueryaHub/Querya-Desktop/issues/37) и дочерние issues **#38–#60** (кроме закрытого #56) — milestone [Theme system](https://github.com/QueryaHub/Querya-Desktop/milestone/1).
+
+Новые theme-issues: label `theme` → workflow [issue-theme-milestone.yml](.github/workflows/issue-theme-milestone.yml) проставит milestone автоматически. Шаблон: [.github/ISSUE_TEMPLATE/theme_task.yml](.github/ISSUE_TEMPLATE/theme_task.yml).
+
+### PR: labels + milestone (автоматика)
+
+1. Ветка **`issue/<number>-<slug>`** (рекомендуется), например `issue/38-workbench-theme-models`.
+2. В PR body: **`Closes #38`** (или Fixes/Resolves).
+3. В title опционально: `feat(theme): … (#38)`.
+
+Workflow [pr-linked-issue-metadata.yml](.github/workflows/pr-linked-issue-metadata.yml) копирует **все labels** и **milestone** с linked issue на PR при open/edit/sync.
+
+Шаблон PR: [.github/pull_request_template.md](.github/pull_request_template.md).
+
+### Ручное создание PR (если автоматика не сработала)
+
+```bash
+gh pr create --base dev \
+  --milestone "Theme system" \
+  --label "theme,enhancement" \
+  --title "feat(theme): QueryaWorkbenchTheme models (#38)" \
+  --body "$(cat <<'EOF'
+## Summary
+…
+
+Closes #38
+EOF
+)"
+```
+
+Для editor-задач добавь label `editor`: `--label "theme,editor,enhancement"`.
+
+### Issues
 
 ```bash
-gh issue edit 38 --add-label "theme,enhancement"
-gh pr create --base dev --label "theme,enhancement" \
-  --body "Closes #38" --title "feat(theme): QueryaWorkbenchTheme models (#38)"
+gh issue edit 38 --milestone "Theme system" --add-label "theme,enhancement"
 ```
 
-Актуальные labels в репо: `bug`, `enhancement`, `documentation`, `theme`, `editor`, `epic`, …  
-Для темизации: `theme`, `editor`, `epic` (см. epic [#37](https://github.com/QueryaHub/Querya-Desktop/issues/37)).
+Labels: `bug`, `enhancement`, `documentation`, `theme`, `editor`, `epic`.
 
 После merge: issue `CLOSED`; `git fetch` + `git pull --ff-only` на `dev`.
 

.github/ISSUE_TEMPLATE/theme_task.yml

@@ -0,0 +1,47 @@
+name: Theme system task
+description: Task under epic #37 (theming / editor)
+title: "Theme: "
+labels:
+  - theme
+  - enhancement
+projects: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Epic: [#37 — Theme system](https://github.com/QueryaHub/Querya-Desktop/issues/37)  
+        Milestone: **Theme system**
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: One paragraph — what and why
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: Checkbox list
+      value: |
+        - [ ] 
+    validations:
+      required: true
+  - type: dropdown
+    id: phase
+    attributes:
+      label: Phase
+      options:
+        - "0 — Foundation"
+        - "1 — App & UI"
+        - "2 — Editor MVP"
+        - "3 — Advanced"
+    validations:
+      required: true
+  - type: checkboxes
+    id: labels_extra
+    attributes:
+      label: Extra labels
+      options:
+        - label: editor
+        - label: documentation

.github/pull_request_template.md

@@ -0,0 +1,37 @@
+## Summary
+
+<!-- What changed and why (1–3 sentences). -->
+
+## Linked issue
+
+<!-- Use branch `issue/<number>-<slug>` and/or: -->
+
+Closes #
+
+## Checklist
+
+- [ ] `flutter analyze` and `flutter test` pass locally
+- [ ] Scope matches the linked issue only (no drive-by refactors)
+- [ ] PR targets **`dev`** (not `main`, unless hotfix)
+
+## Metadata (automation)
+
+If the branch is `issue/<n>-…` or the body contains `Closes #n`, workflow **[PR linked issue metadata](.github/workflows/pr-linked-issue-metadata.yml)** copies **labels** and **milestone** from the linked issue onto this PR.
+
+For **Theme system** work, ensure the issue has milestone **Theme system** and labels such as `theme`, `editor`, `enhancement`.
+
+Manual override when creating the PR:
+
+```bash
+gh pr create --base dev \
+  --milestone "Theme system" \
+  --label "theme,enhancement" \
+  --title "feat(theme): short description (#NN)" \
+  --body "$(cat <<'EOF'
+## Summary
+...
+
+Closes #NN
+EOF
+)"
+```

.github/workflows/issue-theme-milestone.yml

@@ -0,0 +1,50 @@
+# New issues with label `theme` → milestone Theme system
+name: Issue theme milestone
+
+on:
+  issues:
+    types: [opened, labeled]
+
+permissions:
+  issues: write
+
+jobs:
+  assign-milestone:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set Theme system milestone on theme issues
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const issue = context.payload.issue;
+            if (!issue?.labels) return;
+
+            const hasTheme = issue.labels.some(
+              (l) => (typeof l === 'string' ? l : l.name) === 'theme'
+            );
+            if (!hasTheme) return;
+
+            if (issue.milestone?.title === 'Theme system') {
+              core.info('Milestone already set.');
+              return;
+            }
+
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const milestones = await github.paginate(
+              github.rest.issues.listMilestones,
+              { owner, repo, state: 'open', per_page: 100 }
+            );
+            const milestone = milestones.find((m) => m.title === 'Theme system');
+            if (!milestone) {
+              core.setFailed('Milestone "Theme system" not found');
+              return;
+            }
+
+            await github.rest.issues.update({
+              owner,
+              repo,
+              issue_number: issue.number,
+              milestone: milestone.number,
+            });
+            core.info(`Milestone Theme system set on #${issue.number}`);

.github/workflows/pr-linked-issue-metadata.yml

@@ -0,0 +1,103 @@
+# Copy milestone + labels from linked issues onto the PR.
+# Triggers: branch issue/<n>-*, PR title/body "Closes #n", etc.
+name: PR linked issue metadata
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+
+permissions:
+  pull-requests: write
+  issues: read
+
+jobs:
+  apply-from-linked-issues:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Apply milestone and labels from linked issues
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            const issueIds = new Set();
+
+            // issue/38-short-slug
+            const branchMatch = pr.head.ref.match(/^issue\/(\d+)(?:-|$)/i);
+            if (branchMatch) issueIds.add(Number(branchMatch[1]));
+
+            const body = pr.body || '';
+            const title = pr.title || '';
+
+            for (const m of body.matchAll(
+              /(?:close|closes|closed|fix|fixes|fixed|resolve|resolves|resolved)\s+#(\d+)/gi
+            )) {
+              issueIds.add(Number(m[1]));
+            }
+
+            // feat(theme): short description (#38)
+            const titleTail = title.match(/\(#(\d+)\)\s*$/);
+            if (titleTail) issueIds.add(Number(titleTail[1]));
+
+            if (issueIds.size === 0) {
+              core.info('No linked issue numbers found; skipping.');
+              return;
+            }
+
+            const labelNames = new Set();
+            let milestoneTitle = null;
+
+            for (const num of issueIds) {
+              let issue;
+              try {
+                const res = await github.rest.issues.get({
+                  owner,
+                  repo,
+                  issue_number: num,
+                });
+                issue = res.data;
+              } catch (e) {
+                core.warning(`Issue #${num} not found: ${e.message}`);
+                continue;
+              }
+
+              for (const l of issue.labels) {
+                if (typeof l === 'string') labelNames.add(l);
+                else if (l.name) labelNames.add(l.name);
+              }
+
+              if (issue.milestone?.title) {
+                milestoneTitle = issue.milestone.title;
+              }
+            }
+
+            if (labelNames.size > 0) {
+              await github.rest.issues.setLabels({
+                owner,
+                repo,
+                issue_number: pr.number,
+                labels: [...labelNames],
+              });
+              core.info(`Labels set: ${[...labelNames].join(', ')}`);
+            }
+
+            if (milestoneTitle) {
+              const milestones = await github.paginate(
+                github.rest.issues.listMilestones,
+                { owner, repo, state: 'open', per_page: 100 }
+              );
+              const milestone = milestones.find((m) => m.title === milestoneTitle);
+              if (milestone) {
+                await github.rest.issues.update({
+                  owner,
+                  repo,
+                  issue_number: pr.number,
+                  milestone: milestone.number,
+                });
+                core.info(`Milestone set: ${milestoneTitle}`);
+              } else {
+                core.warning(`Milestone not found: ${milestoneTitle}`);
+              }
+            }

CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-05-28
+
+### Added
+
+- **Theme system** — runtime dark/light/system modes, **Querya Light** preset, optional **Animate theme changes** in Preferences.
+- **VS Code themes** — import `.json` / `.jsonc` (`colors` + `tokenColors`); user color overrides; persisted imported theme.
+- **Syntax highlighting** — SQL and JSON in `QueryaCodeEditor` via `syntax_highlight`; `tokenColors` mapped to TextMate scopes; isolate highlight for large buffers.
+- **Editor** — `QueryaCodeEditor` abstraction, `SqlEditorChrome` from theme tokens, `QueryaThemeScope` for workbench/editor tokens.
+- **Samples** — `themes/samples/cyberpunk-neon.json` (+ JSONC) for manual import testing.
+- **Docs** — [docs/theme.md](docs/theme.md), [docs/theme-import.md](docs/theme-import.md), [docs/editor-spike-report.md](docs/editor-spike-report.md), [docs/code-forge-evaluation.md](docs/code-forge-evaluation.md).
+
+### Changed
+
+- **Workbench UI** — P0 surfaces (sidebar, SQL chrome, empty hero, main shell) use design tokens instead of hardcoded `QueryaColors`.
+- **Preferences** — Appearance section (theme mode, preset, import, animation); Material `DropdownMenu` for stable menus in scrollable dialogs.
+- **Imported themes** — `mutedForeground` clamped for readable helper text when VS Code sidebar colors are low-contrast.
+
+### Fixed
+
+- **Preferences (dark / imported themes)** — readable labels and dropdown text via `materialTheme` + `popoverForeground` hints.
+- **Preferences dropdown** — Color preset menu no longer stretches full screen (`expandedInsets` instead of `width: infinity`).
+- **Dialogs / SQL editor** — `QueryaThemeScope` on `ShadcnApp.builder` so overlays (Preferences, SQL editor) resolve theme tokens.
+
 ## [0.2.0] - 2026-04-24
 
 ### Added

README.md

@@ -95,6 +95,7 @@ flutter build macos
 ## More documentation
 
 - [Security / local data](docs/security.md)
+- [Theme system](docs/theme.md)
 - [User guide](docs/user-guide.md)
 - [Releases](docs/tags-and-releases.md)
 - [Release checklist](docs/release-checklist.md)