@ggterm/core 0.3.5 → 0.3.8

package/dist/cli-plot.js

@@ -14641,6 +14641,8 @@ function handleServe(port) {
       }
     }
   }
+  let lastNewPlotTime = 0;
+  let lastBroadcastPlotId = null;
   const plotsDir = getPlotsDir();
   watch(plotsDir, (_event, filename) => {
     if (!filename || !filename.endsWith(".json"))
@@ -14648,12 +14650,16 @@ function handleServe(port) {
     if (debounceTimer)
       clearTimeout(debounceTimer);
     debounceTimer = setTimeout(() => {
+      const latestId = getLatestPlotId();
+      if (!latestId || latestId === lastBroadcastPlotId)
+        return;
+      lastBroadcastPlotId = latestId;
+      lastNewPlotTime = Date.now();
       const payload = getLatestPayload();
       if (payload)
         broadcast(payload);
     }, 150);
   });
-  const vegaLitePath = join3(getGGTermDir(), "last-plot-vegalite.json");
   let styleDebounce = null;
   watch(getGGTermDir(), (_event, filename) => {
     if (filename !== "last-plot-vegalite.json")
@@ -14661,15 +14667,23 @@ function handleServe(port) {
     if (styleDebounce)
       clearTimeout(styleDebounce);
     styleDebounce = setTimeout(() => {
+      if (Date.now() - lastNewPlotTime < 2000)
+        return;
+      const vegaLitePath = join3(getGGTermDir(), "last-plot-vegalite.json");
       if (!existsSync3(vegaLitePath))
         return;
       try {
         const spec = JSON.parse(readFileSync3(vegaLitePath, "utf-8"));
         const latestId = getLatestPlotId();
-        const provenance = latestId ? { id: latestId, description: "Styled plot", timestamp: new Date().toISOString(), geomTypes: [] } : { id: "styled", description: "Styled plot", timestamp: new Date().toISOString(), geomTypes: [] };
-        broadcast(JSON.stringify({ type: "plot", spec, provenance }));
+        const provenance = {
+          id: latestId || "styled",
+          description: "Styled plot",
+          timestamp: new Date().toISOString(),
+          geomTypes: []
+        };
+        broadcast(JSON.stringify({ type: "update", spec, provenance }));
       } catch {}
-    }, 200);
+    }, 300);
   });
   const server = createServer((req, res) => {
     const url = new URL(req.url || "/", `http://localhost:${p}`);
@@ -15080,6 +15094,14 @@ async function renderSpec(spec) {
   }
 }
 
+// Re-render on container resize so plot reflows correctly
+let resizeTimer = null;
+new ResizeObserver(() => {
+  if (!view) return;
+  if (resizeTimer) clearTimeout(resizeTimer);
+  resizeTimer = setTimeout(() => { view.resize(); }, 150);
+}).observe(vis);
+
 async function showPlot(data) {
   await renderSpec(data.spec);
   updateMeta(data.provenance);
@@ -15181,6 +15203,12 @@ function connect() {
       showPlot(data);
       updateNav();
       updateHistoryHighlight();
+    } else if (data.type === 'update') {
+      // Style/customize change — replace current plot, don't add to history
+      if (currentIdx >= 0 && currentIdx < history.length) {
+        history[currentIdx] = data;
+      }
+      showPlot(data);
     }
   };
 }
@@ -15212,7 +15240,7 @@ import { join as join4 } from "path";
 // src/init.ts
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, readFileSync as readFileSync2, existsSync as existsSync2, readdirSync as readdirSync2, statSync } from "fs";
 import { join as join2, extname } from "path";
-var SKILLS_VERSION = "0.3.4";
+var SKILLS_VERSION = "0.3.7";
 var SKILLS = {
   "data-load": {
     files: {
@@ -15489,30 +15517,41 @@ allowed-tools: Read, Write, Bash(npx:*)
 
 Modify Vega-Lite specifications based on natural language requests.
 
-## Files
+## CRITICAL: Which File to Edit
+
+**ALWAYS read and write \`.ggterm/last-plot-vegalite.json\`** — this is the Vega-Lite spec that the viewer renders.
 
-After creating a plot, these files exist:
-- \`.ggterm/last-plot.json\` - Original PlotSpec
-- \`.ggterm/last-plot-vegalite.json\` - Vega-Lite spec to modify
+**NEVER modify \`.ggterm/last-plot.json\`** — that is the ggterm terminal format. Changes to it will NOT appear in the viewer.
 
 ## Common Customizations
 
+All examples below modify properties of the Vega-Lite spec read from \`.ggterm/last-plot-vegalite.json\`:
+
 ### Title and Labels
 
 \`\`\`javascript
 spec.title = "New Title"
+spec.title = { text: "Title", subtitle: "Subtitle" }
 spec.encoding.x.title = "X Axis Label"
 spec.encoding.y.title = "Y Axis Label"
+spec.encoding.color.title = "Legend Title"
 \`\`\`
 
 ### Colors
 
 \`\`\`javascript
-// Color scheme for categorical data
-spec.encoding.color.scale = { scheme: "category10" }
+spec.encoding.color.scale = { scheme: "category10" }  // categorical
+spec.encoding.color.scale = { scheme: "viridis" }     // continuous
+spec.mark.color = "#3366cc"                            // single color
+\`\`\`
 
-// Color scheme for continuous data
-spec.encoding.color.scale = { scheme: "viridis" }
+### Fonts and Config
+
+\`\`\`javascript
+spec.config = spec.config || {}
+spec.config.font = "Helvetica"
+spec.config.title = { fontSize: 18, fontWeight: "bold" }
+spec.config.axis = { labelFontSize: 12, titleFontSize: 14 }
 \`\`\`
 
 ### Dimensions
@@ -15524,9 +15563,9 @@ spec.height = 400
 
 ## Workflow
 
-1. Read \`.ggterm/last-plot-vegalite.json\`
-2. Apply the requested modifications
-3. Write the updated spec back to \`.ggterm/last-plot-vegalite.json\`
+1. Read \`.ggterm/last-plot-vegalite.json\` (NOT last-plot.json)
+2. Parse as JSON, apply the requested modifications
+3. Write the updated JSON back to \`.ggterm/last-plot-vegalite.json\`
 4. **DONE** — the live viewer auto-detects the change and displays the customized plot
 
 **IMPORTANT**: Do NOT re-create the plot with \`npx ggterm-plot\` after customizing. The viewer watches the spec file and auto-updates. Re-running the plot command would overwrite your customizations.
@@ -15547,26 +15586,107 @@ allowed-tools: Read, Write, Bash(npx:*)
 
 Apply expert-curated style presets to Vega-Lite specifications for publication-quality output.
 
-## Available Presets
+## CRITICAL: Which File to Edit
+
+**ALWAYS read and write \`.ggterm/last-plot-vegalite.json\`** — this is the Vega-Lite spec that the viewer renders.
 
-| Preset | Inspiration | Key Characteristics |
-|--------|-------------|---------------------|
-| \`wilke\` | Claus Wilke's *Fundamentals of Data Visualization* | Minimal, clean, no chartjunk, subtle gridlines |
-| \`tufte\` | Edward Tufte's data-ink ratio principles | Maximum data-ink, no grid, no borders |
-| \`nature\` | Nature journal style | Clean, serif fonts, specific dimensions |
-| \`economist\` | The Economist charts | Bold colors, distinctive style |
-| \`minimal\` | Generic minimal style | No grid, no borders, clean |
-| \`apa\` | APA publication guidelines | Academic papers, grayscale-friendly |
+**NEVER modify \`.ggterm/last-plot.json\`** — that is the ggterm terminal format. Changes to it will NOT appear in the viewer.
 
 ## Workflow
 
-1. Read \`.ggterm/last-plot-vegalite.json\`
-2. Apply the requested style preset (only modify \`config\` — do NOT change \`encoding\`, \`data\`, or \`mark\` structure)
-3. Write the updated spec back to \`.ggterm/last-plot-vegalite.json\`
-4. **DONE** — the live viewer auto-detects the change and displays the styled plot
-5. Inform user they can export with \`/ggterm-publish\`
+1. Read \`.ggterm/last-plot-vegalite.json\` (NOT last-plot.json)
+2. Parse as JSON
+3. Set \`spec.config\` to the style config below — do NOT change \`encoding\`, \`data\`, or \`mark\`
+4. Write the updated JSON back to \`.ggterm/last-plot-vegalite.json\`
+5. **DONE** — the live viewer auto-detects the change and displays the styled plot
+
+**IMPORTANT**: Do NOT re-create the plot with \`npx ggterm-plot\` after styling. Re-running would overwrite your style changes.
+
+## Style Configs (Vega-Lite \`config\` property)
+
+### Wilke (default for "publication ready")
+
+\`\`\`json
+{
+  "font": "Helvetica Neue, Helvetica, Arial, sans-serif",
+  "background": "white",
+  "view": { "stroke": null },
+  "title": { "fontSize": 14, "fontWeight": "normal", "anchor": "start", "offset": 12 },
+  "axis": { "domain": true, "domainColor": "#333333", "domainWidth": 1, "grid": false, "labelColor": "#333333", "labelFontSize": 11, "tickColor": "#333333", "tickSize": 5, "titleColor": "#333333", "titleFontSize": 12, "titleFontWeight": "normal", "titlePadding": 10 },
+  "axisY": { "grid": true, "gridColor": "#ebebeb", "gridWidth": 0.5 },
+  "legend": { "labelFontSize": 11, "titleFontSize": 11, "titleFontWeight": "normal", "symbolSize": 100 },
+  "range": { "category": ["#4C78A8", "#F58518", "#E45756", "#72B7B2", "#54A24B", "#EECA3B", "#B279A2", "#FF9DA6"] }
+}
+\`\`\`
+
+### Tufte
+
+\`\`\`json
+{
+  "font": "Georgia, serif",
+  "background": "white",
+  "view": { "stroke": null },
+  "title": { "fontSize": 13, "fontWeight": "normal", "anchor": "start" },
+  "axis": { "domain": false, "grid": false, "labelColor": "#333333", "labelFontSize": 10, "ticks": false, "titleColor": "#333333", "titleFontSize": 11, "titleFontWeight": "normal" },
+  "legend": { "labelFontSize": 10, "titleFontSize": 10, "titleFontWeight": "normal" },
+  "range": { "category": ["#333333", "#666666", "#999999", "#CCCCCC"] }
+}
+\`\`\`
+
+### Nature
 
-**IMPORTANT**: Do NOT re-create the plot with \`npx ggterm-plot\` after styling. The viewer watches the spec file and auto-updates. Re-running the plot command would overwrite your style changes.
+\`\`\`json
+{
+  "font": "Arial, Helvetica, sans-serif",
+  "background": "white",
+  "view": { "stroke": null },
+  "title": { "fontSize": 10, "fontWeight": "bold" },
+  "axis": { "domain": true, "domainColor": "#000000", "domainWidth": 0.5, "grid": false, "labelColor": "#000000", "labelFontSize": 8, "tickColor": "#000000", "tickSize": 4, "tickWidth": 0.5, "titleColor": "#000000", "titleFontSize": 9, "titleFontWeight": "normal" },
+  "legend": { "labelFontSize": 8, "titleFontSize": 8, "symbolSize": 50 }
+}
+\`\`\`
+
+### Economist
+
+\`\`\`json
+{
+  "font": "Officina Sans, Arial, sans-serif",
+  "background": "#d5e4eb",
+  "view": { "stroke": null },
+  "title": { "fontSize": 14, "fontWeight": "bold", "color": "#000000", "anchor": "start" },
+  "axis": { "domain": false, "grid": true, "gridColor": "#ffffff", "gridWidth": 1, "labelColor": "#000000", "labelFontSize": 11, "titleFontSize": 12, "titleFontWeight": "bold" },
+  "axisX": { "grid": false, "domain": true, "domainColor": "#000000" },
+  "legend": { "orient": "top", "labelFontSize": 11, "titleFontSize": 11 },
+  "range": { "category": ["#006BA2", "#3EBCD2", "#379A8B", "#EBB434", "#B4BA39", "#9A607F", "#D73F3F"] }
+}
+\`\`\`
+
+### Minimal
+
+\`\`\`json
+{
+  "font": "system-ui, -apple-system, sans-serif",
+  "background": "white",
+  "view": { "stroke": null },
+  "title": { "fontSize": 14, "fontWeight": "normal" },
+  "axis": { "domain": false, "grid": false, "ticks": false, "labelColor": "#666666", "labelFontSize": 11, "titleColor": "#333333", "titleFontSize": 12, "titleFontWeight": "normal" },
+  "legend": { "labelFontSize": 11, "titleFontSize": 11, "titleFontWeight": "normal" }
+}
+\`\`\`
+
+### APA
+
+\`\`\`json
+{
+  "font": "Times New Roman, serif",
+  "background": "white",
+  "view": { "stroke": null },
+  "title": { "fontSize": 12, "fontWeight": "bold", "anchor": "middle" },
+  "axis": { "domain": true, "domainColor": "#000000", "grid": false, "labelColor": "#000000", "labelFontSize": 10, "tickColor": "#000000", "titleColor": "#000000", "titleFontSize": 11, "titleFontWeight": "normal", "titleFontStyle": "italic" },
+  "legend": { "labelFontSize": 10, "titleFontSize": 10, "titleFontStyle": "italic" },
+  "range": { "category": ["#000000", "#666666", "#999999", "#CCCCCC"] }
+}
+\`\`\`
 
 ## Response Format
 

package/dist/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsgBH,wBAAgB,UAAU,IAAI,IAAI,CA2JjC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkmBH,wBAAgB,UAAU,IAAI,IAAI,CA2JjC"}

package/dist/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0eH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAkI/C"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwfH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAqJ/C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggterm/core",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "description": "Grammar of Graphics engine for terminals",
   "type": "module",
   "main": "./dist/index.js",