@astuteo/breakout-grid 5.1.0 → 5.1.2

package/breakout-grid-visualizer-lite.js

@@ -1,6 +1,6 @@
 (function() {
   "use strict";
-  const VERSION = `v${"5.1.0"} lite`;
+  const VERSION = `v${"5.1.2"} lite`;
   const LOREM_CONTENT = `Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium.
 
 Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet.`;

package/breakout-grid-visualizer.js

@@ -1,6 +1,6 @@
 (function() {
   "use strict";
-  const VERSION = `v${"5.1.0"}`;
+  const VERSION = `v${"5.1.2"}`;
   const LOREM_CONTENT = `Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium.
 
 Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet.`;
@@ -12,19 +12,16 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
     { name: "content", label: "Content", className: ".col-content", color: "rgba(168, 85, 247, 0.25)", borderColor: "rgb(168, 85, 247)" }
   ];
   const CONFIG_OPTIONS = {
-    // Base measurements
     baseGap: { value: "1rem", desc: "Minimum gap between columns. Use rem.", cssVar: "--config-base-gap", liveVar: "--base-gap" },
     maxGap: { value: "15rem", desc: "Maximum gap cap for ultra-wide. Use rem.", cssVar: "--config-max-gap", liveVar: "--max-gap" },
-    contentMin: { value: "53rem", desc: "Min width for content column (~848px). Use rem.", cssVar: "--config-content-min", liveVar: "--content-min" },
-    contentMax: { value: "61rem", desc: "Max width for content column (~976px). Use rem.", cssVar: "--config-content-max", liveVar: "--content-max" },
+    contentMin: { value: "50rem", desc: "Min width for content column (~848px). Use rem.", cssVar: "--config-content-min", liveVar: "--content-min" },
+    contentMax: { value: "55rem", desc: "Max width for content column (~976px). Use rem.", cssVar: "--config-content-max", liveVar: "--content-max" },
     contentBase: { value: "75vw", desc: "Preferred width for content (fluid). Use vw.", cssVar: "--config-content-base", liveVar: "--content-base" },
-    // Track widths
     popoutWidth: { value: "5rem", desc: "Popout extends beyond content. Use rem.", cssVar: "--config-popout", liveVar: null },
     featureMin: { value: "0rem", desc: "Minimum feature track width (floor)", cssVar: "--config-feature-min", liveVar: null },
     featureScale: { value: "12vw", desc: "Fluid feature track scaling", cssVar: "--config-feature-scale", liveVar: null },
     featureMax: { value: "12rem", desc: "Maximum feature track width (ceiling)", cssVar: "--config-feature-max", liveVar: null },
     fullLimit: { value: "115rem", desc: "Max width for col-full-limit. Use rem.", cssVar: "--config-full-limit", liveVar: "--full-limit" },
-    // Default column
     defaultCol: { value: "content", desc: "Default column when no col-* class", type: "select", options: ["content", "popout", "feature", "full"], cssVar: "--config-default-col" }
   };
   const GAP_SCALE_OPTIONS = {
@@ -43,7 +40,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
   };
   function createInitialState() {
     return {
-      // UI State
       isVisible: false,
       showLabels: true,
       showClassNames: true,
@@ -65,38 +61,28 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       editorPos: { x: 20, y: 100 },
       isDragging: false,
       dragOffset: { x: 0, y: 0 },
-      // Column resize drag state
       resizingColumn: null,
       resizeStartX: 0,
       resizeStartValue: 0,
-      // Panel collapse state
       controlPanelCollapsed: false,
       configEditorCollapsed: false,
-      // Computed column widths in pixels (pre-initialized for reactivity)
-      columnWidths: {
-        full: 0,
-        "full-limit": 0,
-        feature: 0,
-        popout: 0,
-        content: 0,
-        center: 0
-      },
-      // Current breakpoint for gap scale (mobile, lg, xl)
+      // Pre-initialized for Alpine reactivity
+      columnWidths: { full: 0, "full-limit": 0, feature: 0, popout: 0, content: 0, center: 0 },
       currentBreakpoint: "mobile",
-      // Spacing panel state
       spacingPanelCollapsed: false,
       spacingPanelPos: { x: 16, y: 16 },
       isDraggingSpacing: false,
       dragOffsetSpacing: { x: 0, y: 0 },
-      // Restore config modal
       showRestoreModal: false,
       restoreInput: "",
       restoreError: null,
-      // Section copy feedback
-      sectionCopied: null
+      sectionCopied: null,
+      showCloseWarningModal: false,
+      gridOpacity: 0.8,
+      backdropOpacity: 0.85
     };
   }
-  const BUILD_VERSION = "5.1.0";
+  const BUILD_VERSION = "5.1.2";
   function generateCSSExport(c, version = BUILD_VERSION) {
     var _a, _b, _c, _d, _e;
     const VERSION2 = version;
@@ -763,7 +749,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
 `;
   }
   const methods = {
-    // Initialize
     init() {
       const saved = localStorage.getItem("breakoutGridVisualizerVisible");
       if (saved !== null) {
@@ -775,6 +760,14 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         this.editMode = true;
         this.$nextTick(() => this.loadCurrentValues());
       }
+      const savedConfig = localStorage.getItem("breakoutGridConfig");
+      if (savedConfig) {
+        try {
+          const config = JSON.parse(savedConfig);
+          this.$nextTick(() => this.applyConfig(config));
+        } catch (e) {
+        }
+      }
       const editorPos = localStorage.getItem("breakoutGridEditorPos");
       if (editorPos) {
         try {
@@ -810,12 +803,10 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       this.updateCurrentBreakpoint();
       console.log("Breakout Grid Visualizer loaded. Press Ctrl/Cmd + G to toggle.");
     },
-    // Toggle visibility
     toggle() {
       this.isVisible = !this.isVisible;
       localStorage.setItem("breakoutGridVisualizerVisible", this.isVisible);
     },
-    // Update column widths by querying DOM elements
     updateColumnWidths() {
       this.$nextTick(() => {
         this.gridAreas.forEach((area) => {
@@ -826,7 +817,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         });
       });
     },
-    // Detect current breakpoint based on viewport width
     updateCurrentBreakpoint() {
       const width = window.innerWidth;
       if (width >= 1280) {
@@ -837,7 +827,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         this.currentBreakpoint = "mobile";
       }
     },
-    // Update --gap live based on current breakpoint and edit values
     updateGapLive() {
       const scaleKey = this.currentBreakpoint === "mobile" ? "default" : this.currentBreakpoint;
       const base = this.editValues.baseGap || this.configOptions.baseGap.value;
@@ -846,7 +835,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       document.documentElement.style.setProperty("--gap", `clamp(${base}, ${scale}, ${max})`);
       this.updateColumnWidths();
     },
-    // Check if content width exceeds comfortable reading width (55rem)
     getContentReadabilityWarning() {
       const contentMax = parseFloat(this.editValues.contentMax || this.configOptions.contentMax.value);
       if (contentMax > 55) {
@@ -854,7 +842,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       }
       return null;
     },
-    // Check if configured track widths would exceed viewport
     getTrackOverflowWarning() {
       const contentMax = parseFloat(this.editValues.contentMax || this.configOptions.contentMax.value) * 16;
       const featureMax = parseFloat(this.editValues.featureMax || this.configOptions.featureMax.value) * 16;
@@ -867,12 +854,10 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       }
       return null;
     },
-    // Get computed CSS variable value
     getCSSVariable(varName) {
       const value = getComputedStyle(document.documentElement).getPropertyValue(varName).trim();
       return value || "Not set";
     },
-    // Helper to load options from CSS variables
     loadOptionsFromCSS(options, prefix = "") {
       Object.keys(options).forEach((key) => {
         const opt = options[key];
@@ -885,13 +870,11 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         }
       });
     },
-    // Load current values from CSS variables where available
     loadCurrentValues() {
       this.loadOptionsFromCSS(this.configOptions);
       this.loadOptionsFromCSS(this.gapScaleOptions, "gapScale");
       this.loadOptionsFromCSS(this.breakoutOptions, "breakout");
     },
-    // Generate export config object
     generateConfigExport() {
       var _a, _b, _c, _d;
       const config = {};
@@ -910,7 +893,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       };
       return config;
     },
-    // Format config object with single quotes for values, no quotes for keys
     formatConfig(obj, indent = 2) {
       const pad = " ".repeat(indent);
       const lines = ["{"];
@@ -926,35 +908,14 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       lines.push("}");
       return lines.join("\n");
     },
-    // Section definitions for partial copying
     configSections: {
-      content: {
-        keys: ["contentMin", "contentBase", "contentMax"],
-        label: "Content"
-      },
-      defaultCol: {
-        keys: ["defaultCol"],
-        label: "Default Column"
-      },
-      tracks: {
-        keys: ["popoutWidth", "fullLimit"],
-        label: "Track Widths"
-      },
-      feature: {
-        keys: ["featureMin", "featureScale", "featureMax"],
-        label: "Feature"
-      },
-      gap: {
-        keys: ["baseGap", "maxGap"],
-        nested: { gapScale: ["default", "lg", "xl"] },
-        label: "Gap"
-      },
-      breakout: {
-        keys: ["breakoutMin", "breakoutScale"],
-        label: "Breakout"
-      }
+      content: { keys: ["contentMin", "contentBase", "contentMax"], label: "Content" },
+      defaultCol: { keys: ["defaultCol"], label: "Default Column" },
+      tracks: { keys: ["popoutWidth", "fullLimit"], label: "Track Widths" },
+      feature: { keys: ["featureMin", "featureScale", "featureMax"], label: "Feature" },
+      gap: { keys: ["baseGap", "maxGap"], nested: { gapScale: ["default", "lg", "xl"] }, label: "Gap" },
+      breakout: { keys: ["breakoutMin", "breakoutScale"], label: "Breakout" }
     },
-    // Copy a specific section to clipboard
     copySection(sectionName) {
       const section = this.configSections[sectionName];
       if (!section) return;
@@ -982,7 +943,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         setTimeout(() => this.sectionCopied = null, 1500);
       });
     },
-    // Format config as flat key-value pairs (no wrapping braces)
     formatConfigFlat(obj) {
       const lines = [];
       const entries = Object.entries(obj);
@@ -996,7 +956,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       });
       return lines.join("\n");
     },
-    // Copy config to clipboard as CSS variables
     copyConfig() {
       var _a, _b, _c, _d, _e;
       const config = this.generateConfigExport();
@@ -1037,7 +996,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         setTimeout(() => this.copySuccess = false, 2e3);
       });
     },
-    // Generate and download standalone CSS file
     downloadCSS() {
       const css = this.generateCSSExport(this.generateConfigExport());
       const blob = new Blob([css], { type: "text/css" });
@@ -1048,7 +1006,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       a.click();
       URL.revokeObjectURL(url);
     },
-    // Parse CSS value into number and unit (e.g., "4rem" -> { num: 4, unit: "rem" })
     parseValue(val) {
       const match = String(val).match(/^([\d.]+)(.*)$/);
       if (match) {
@@ -1056,29 +1013,23 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       }
       return { num: 0, unit: "rem" };
     },
-    // Get the numeric part of a config value
     getNumericValue(key) {
       const val = this.editValues[key] || this.configOptions[key].value;
       return this.parseValue(val).num;
     },
-    // Get the unit part of a config value
     getUnit(key) {
       const val = this.editValues[key] || this.configOptions[key].value;
       return this.parseValue(val).unit;
     },
-    // Check if a field should have unit selection (rem-based fields only)
     hasUnitSelector(key) {
       const unit = this.getUnit(key);
       return unit === "rem" || unit === "ch" || unit === "px";
     },
-    // Available units for selection
     unitOptions: ["rem", "ch", "px"],
-    // Update just the unit, keeping the numeric value
     updateUnit(key, newUnit) {
       const num = this.getNumericValue(key);
       this.updateConfigValue(key, num + newUnit);
     },
-    // Update just the numeric part, keeping the unit
     updateNumericValue(key, num) {
       if (key === "content" && num < 1) num = 1;
       if (key === "baseGap" && num < 0) num = 0;
@@ -1087,7 +1038,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       const unit = this.getUnit(key);
       this.updateConfigValue(key, num + unit);
     },
-    // Generic getter for prefixed options (gapScale, breakout)
     getPrefixedNumeric(prefix, options, key) {
       const val = this.editValues[`${prefix}_${key}`] || options[key].value;
       return this.parseValue(val).num;
@@ -1096,7 +1046,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       const val = this.editValues[`${prefix}_${key}`] || options[key].value;
       return this.parseValue(val).unit;
     },
-    // Gap scale helpers (use generic)
     getGapScaleNumeric(key) {
       return this.getPrefixedNumeric("gapScale", this.gapScaleOptions, key);
     },
@@ -1107,8 +1056,8 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       this.editValues[`gapScale_${key}`] = num + this.getGapScaleUnit(key);
       this.configCopied = false;
       this.updateGapLive();
+      this.saveConfigToStorage();
     },
-    // Breakout helpers (use generic)
     getBreakoutNumeric(key) {
       return this.getPrefixedNumeric("breakout", this.breakoutOptions, key);
     },
@@ -1119,18 +1068,74 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       this.editValues[`breakout_${key}`] = num + this.getBreakoutUnit(key);
       this.configCopied = false;
       this.updateBreakoutLive();
+      this.saveConfigToStorage();
     },
-    // Update --breakout-padding live
     updateBreakoutLive() {
       const min = this.editValues.breakout_min || this.breakoutOptions.min.value;
       const scale = this.editValues.breakout_scale || this.breakoutOptions.scale.value;
       const max = this.editValues.popoutWidth || this.configOptions.popoutWidth.value;
       document.documentElement.style.setProperty("--breakout-padding", `clamp(${min}, ${scale}, ${max})`);
     },
-    // Update a config value (and live CSS var if applicable)
+    saveConfigToStorage() {
+      const config = this.generateConfigExport();
+      localStorage.setItem("breakoutGridConfig", JSON.stringify(config));
+    },
+    applyConfig(config) {
+      this.editMode = true;
+      Object.keys(this.configOptions).forEach((key) => {
+        if (config[key] !== void 0) {
+          this.editValues[key] = config[key];
+          const opt = this.configOptions[key];
+          if (opt && opt.liveVar) {
+            document.documentElement.style.setProperty(opt.liveVar, config[key]);
+          }
+        }
+      });
+      if (config.popoutWidth) {
+        document.documentElement.style.setProperty("--popout", `minmax(0, ${config.popoutWidth})`);
+      }
+      if (config.featureMin || config.featureScale || config.featureMax) {
+        const featureMin = config.featureMin || this.configOptions.featureMin.value;
+        const featureScale = config.featureScale || this.configOptions.featureScale.value;
+        const featureMax = config.featureMax || this.configOptions.featureMax.value;
+        document.documentElement.style.setProperty("--feature", `minmax(0, clamp(${featureMin}, ${featureScale}, ${featureMax}))`);
+      }
+      if (config.gapScale) {
+        Object.keys(this.gapScaleOptions).forEach((key) => {
+          if (config.gapScale[key] !== void 0) {
+            this.editValues[`gapScale_${key}`] = config.gapScale[key];
+          }
+        });
+        this.updateGapLive();
+      }
+      if (config.breakoutMin !== void 0) {
+        this.editValues.breakout_min = config.breakoutMin;
+      }
+      if (config.breakoutScale !== void 0) {
+        this.editValues.breakout_scale = config.breakoutScale;
+      }
+      this.updateBreakoutLive();
+      if (config.breakpoints) {
+        if (config.breakpoints.lg !== void 0) {
+          this.editValues.breakpoint_lg = config.breakpoints.lg;
+        }
+        if (config.breakpoints.xl !== void 0) {
+          this.editValues.breakpoint_xl = config.breakpoints.xl;
+        }
+      }
+      this.updateColumnWidths();
+    },
+    resetConfigToDefaults() {
+      if (!confirm("Reset all config values to defaults?")) return;
+      localStorage.removeItem("breakoutGridConfig");
+      this.restoreCSSVariables();
+      this.loadCurrentValues();
+      this.configCopied = false;
+    },
     updateConfigValue(key, value) {
       this.editValues[key] = value;
       this.configCopied = false;
+      this.saveConfigToStorage();
       const opt = this.configOptions[key];
       if (opt && opt.liveVar) {
         document.documentElement.style.setProperty(opt.liveVar, value);
@@ -1152,15 +1157,12 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         this.updateGapLive();
       }
     },
-    // Select a grid area
     selectArea(areaName) {
       this.selectedArea = this.selectedArea === areaName ? null : areaName;
     },
-    // Check if area is selected
     isSelected(areaName) {
       return this.selectedArea === areaName;
     },
-    // Restore all CSS variable overrides to original values
     restoreCSSVariables() {
       Object.keys(this.configOptions).forEach((key) => {
         const opt = this.configOptions[key];
@@ -1176,7 +1178,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       this.editValues = {};
       this.configCopied = false;
     },
-    // Toggle edit mode
     toggleEditMode() {
       this.editMode = !this.editMode;
       if (this.editMode) {
@@ -1185,30 +1186,37 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         this.restoreCSSVariables();
       }
     },
-    // Check if any values have been edited and not yet copied
     hasUnsavedEdits() {
       return Object.keys(this.editValues).length > 0 && !this.configCopied;
     },
-    // Open floating editor
     openEditor() {
       this.showEditor = true;
       this.editMode = true;
       this.loadCurrentValues();
       localStorage.setItem("breakoutGridEditorOpen", "true");
     },
-    // Close floating editor
     closeEditor(force = false) {
       if (!force && this.hasUnsavedEdits()) {
-        if (!confirm("You have unsaved config changes. Close without copying?")) {
-          return;
-        }
+        this.showCloseWarningModal = true;
+        return;
       }
       this.showEditor = false;
       this.editMode = false;
       this.restoreCSSVariables();
       localStorage.setItem("breakoutGridEditorOpen", "false");
     },
-    // Generic drag handling for panels
+    closeWarningCopyAndClose() {
+      this.copyConfig();
+      this.showCloseWarningModal = false;
+      this.closeEditor(true);
+    },
+    closeWarningDiscard() {
+      this.showCloseWarningModal = false;
+      this.closeEditor(true);
+    },
+    closeWarningGoBack() {
+      this.showCloseWarningModal = false;
+    },
     _dragConfigs: {
       editor: { pos: "editorPos", dragging: "isDragging", offset: "dragOffset", storage: "breakoutGridEditorPos" },
       spacing: { pos: "spacingPanelPos", dragging: "isDraggingSpacing", offset: "dragOffsetSpacing", storage: "breakoutGridSpacingPos" }
@@ -1229,7 +1237,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       if (this[cfg.dragging]) localStorage.setItem(cfg.storage, JSON.stringify(this[cfg.pos]));
       this[cfg.dragging] = false;
     },
-    // Editor drag (shorthand)
     startDrag(e) {
       this.startPanelDrag(e, "editor");
     },
@@ -1239,7 +1246,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
     stopDrag() {
       this.stopPanelDrag("editor");
     },
-    // Spacing drag (shorthand)
     startDragSpacing(e) {
       this.startPanelDrag(e, "spacing");
     },
@@ -1249,7 +1255,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
     stopDragSpacing() {
       this.stopPanelDrag("spacing");
     },
-    // Column resize drag handling
     startColumnResize(e, columnType) {
       if (!this.editMode) return;
       e.preventDefault();
@@ -1283,18 +1288,14 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
     stopColumnResize() {
       this.resizingColumn = null;
     },
-    // Map column names to their config keys for resizing
     getResizeConfig(colName) {
       const map = {
         "full-limit": "fullLimit",
         "feature": "featureScale",
         "popout": "popoutWidth"
-        // content has its own integrated handles for min/max/base
-        // feature has its own integrated handles for min/scale/max
       };
       return map[colName] || null;
     },
-    // Parse a CSS variables string into a config object
     parseConfigString(input) {
       const str = input.trim();
       const config = { gapScale: {}, breakpoints: {} };
@@ -1342,19 +1343,16 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       }
       return config;
     },
-    // Open restore modal
     openRestoreModal() {
       this.showRestoreModal = true;
       this.restoreInput = "";
       this.restoreError = null;
     },
-    // Close restore modal
     closeRestoreModal() {
       this.showRestoreModal = false;
       this.restoreInput = "";
       this.restoreError = null;
     },
-    // Apply a parsed config to the editor
     restoreConfig() {
       this.restoreError = null;
       try {
@@ -1412,7 +1410,7 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
          x-transition:leave="transition ease-in duration-150"
          x-transition:leave-start="opacity-100"
          x-transition:leave-end="opacity-0"
-         style="position: absolute; inset: 0; background: rgba(255, 255, 255, 0.85); z-index: 1;"></div>
+         :style="{ position: 'absolute', inset: 0, background: 'rgba(255, 255, 255, ' + backdropOpacity + ')', zIndex: 1 }"></div>
 
     <!-- Advanced Span Examples Overlay -->
     <div x-show="showAdvanced"
@@ -1682,7 +1680,7 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
     </div>
 
     <!-- Grid Overlay (hidden in Advanced mode) -->
-    <div x-show="!showAdvanced" x-init="$watch('isVisible', v => v && setTimeout(() => updateColumnWidths(), 50)); setTimeout(() => updateColumnWidths(), 100)" class="grid-cols-breakout breakout-visualizer-grid" style="height: 100%; position: relative; z-index: 2;">
+    <div x-show="!showAdvanced" x-init="$watch('isVisible', v => v && setTimeout(() => updateColumnWidths(), 50)); setTimeout(() => updateColumnWidths(), 100)" class="grid-cols-breakout breakout-visualizer-grid" :style="{ height: '100%', position: 'relative', zIndex: 2, opacity: gridOpacity }">
       <template x-for="area in gridAreas" :key="area.name">
         <div :class="'col-' + area.name"
              @click="selectArea(area.name)"
@@ -2087,6 +2085,22 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         </div>
       </div>
 
+      <!-- Opacity Sliders -->
+      <div style="padding: 8px 12px; background: white; border-bottom: 1px solid #e5e5e5;">
+        <div style="display: flex; flex-direction: column; gap: 6px;">
+          <div style="display: flex; align-items: center; gap: 12px;">
+            <span style="font-size: 9px; font-weight: 600; color: #6b7280; text-transform: uppercase; letter-spacing: 0.5px; width: 28px; flex-shrink: 0;">Grid</span>
+            <input type="range" x-model="gridOpacity" min="0.1" max="1" step="0.1"
+                   style="flex: 1; height: 4px; cursor: pointer; accent-color: #1a1a2e;">
+          </div>
+          <div style="display: flex; align-items: center; gap: 12px;">
+            <span style="font-size: 9px; font-weight: 600; color: #6b7280; text-transform: uppercase; letter-spacing: 0.5px; width: 28px; flex-shrink: 0;">Page</span>
+            <input type="range" x-model="backdropOpacity" min="0" max="1" step="0.05"
+                   style="flex: 1; height: 4px; cursor: pointer; accent-color: #1a1a2e;">
+          </div>
+        </div>
+      </div>
+
       <!-- Padding Options -->
       <div style="padding: 8px 12px; background: white; border-bottom: 1px solid #e5e5e5;">
         <div style="font-size: 9px; font-weight: 600; color: #6b7280; text-transform: uppercase; letter-spacing: 0.5px; margin-bottom: 6px;">Padding</div>
@@ -2167,6 +2181,23 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
           <span style="font-weight: 600;">⚠️</span> <span x-text="getTrackOverflowWarning()"></span>
         </div>
 
+        <!-- Default Column Section -->
+        <div style="padding: 8px 12px; background: white; border-bottom: 1px solid #e5e5e5;">
+          <div style="display: flex; align-items: center; justify-content: space-between;">
+            <div @click="copySection('defaultCol')" style="cursor: pointer;">
+              <div style="font-size: 9px; font-weight: 600; text-transform: uppercase; letter-spacing: 0.5px;" :style="{ color: sectionCopied === 'defaultCol' ? '#10b981' : '#6b7280' }" x-text="sectionCopied === 'defaultCol' ? '✓ Copied' : 'Default Column'"></div>
+              <div style="font-size: 9px; color: #9ca3af; margin-top: 2px;">For children without col-* class</div>
+            </div>
+            <select @change="editValues.defaultCol = $event.target.value; configCopied = false"
+                    :value="editValues.defaultCol || configOptions.defaultCol.value"
+                    style="padding: 6px 8px; font-size: 11px; border: 1px solid #e5e5e5; border-radius: 4px; background: #f9fafb; cursor: pointer;">
+              <template x-for="opt in configOptions.defaultCol.options" :key="opt">
+                <option :value="opt" :selected="(editValues.defaultCol || configOptions.defaultCol.value) === opt" x-text="opt"></option>
+              </template>
+            </select>
+          </div>
+        </div>
+
         <!-- Content Section -->
         <div style="padding: 8px 12px; background: white; border-bottom: 1px solid #e5e5e5;">
           <div @click="copySection('content')" style="font-size: 9px; font-weight: 600; color: #6b7280; text-transform: uppercase; letter-spacing: 0.5px; margin-bottom: 6px; cursor: pointer; display: flex; align-items: center; gap: 6px;" :style="{ color: sectionCopied === 'content' ? '#10b981' : '#6b7280' }">
@@ -2212,23 +2243,6 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
           </div>
         </div>
 
-        <!-- Default Column Section -->
-        <div style="padding: 8px 12px; background: white; border-bottom: 1px solid #e5e5e5;">
-          <div style="display: flex; align-items: center; justify-content: space-between;">
-            <div @click="copySection('defaultCol')" style="cursor: pointer;">
-              <div style="font-size: 9px; font-weight: 600; text-transform: uppercase; letter-spacing: 0.5px;" :style="{ color: sectionCopied === 'defaultCol' ? '#10b981' : '#6b7280' }" x-text="sectionCopied === 'defaultCol' ? '✓ Copied' : 'Default Column'"></div>
-              <div style="font-size: 9px; color: #9ca3af; margin-top: 2px;">For children without col-* class</div>
-            </div>
-            <select @change="editValues.defaultCol = $event.target.value; configCopied = false"
-                    :value="editValues.defaultCol || configOptions.defaultCol.value"
-                    style="padding: 6px 8px; font-size: 11px; border: 1px solid #e5e5e5; border-radius: 4px; background: #f9fafb; cursor: pointer;">
-              <template x-for="opt in configOptions.defaultCol.options" :key="opt">
-                <option :value="opt" :selected="(editValues.defaultCol || configOptions.defaultCol.value) === opt" x-text="opt"></option>
-              </template>
-            </select>
-          </div>
-        </div>
-
         <!-- Track Widths Section -->
         <div style="padding: 8px 12px; background: white; border-bottom: 1px solid #e5e5e5;">
           <div @click="copySection('tracks')" style="font-size: 9px; font-weight: 600; text-transform: uppercase; letter-spacing: 0.5px; margin-bottom: 6px; cursor: pointer;" :style="{ color: sectionCopied === 'tracks' ? '#10b981' : '#6b7280' }" x-text="sectionCopied === 'tracks' ? '✓ Copied' : 'Track Widths'"></div>
@@ -2360,15 +2374,20 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
         </div>
 
         <!-- Action Buttons -->
-        <div style="padding: 10px 12px; background: #f7f7f7; display: flex; gap: 8px;">
-          <button @click="copyConfig()" :style="{ flex: 1, padding: '8px', fontSize: '11px', fontWeight: '600', border: 'none', borderRadius: '4px', cursor: 'pointer', background: copySuccess ? '#10b981' : '#1a1a2e', color: 'white', transition: 'background 0.2s' }">
-            <span x-text="copySuccess ? '✓ Copied' : 'Copy Variables'"></span>
-          </button>
-          <button @click="openRestoreModal()" style="padding: 8px 12px; font-size: 11px; font-weight: 600; border: 1px solid #e5e5e5; border-radius: 4px; cursor: pointer; background: white; color: #374151;" title="Restore from CSS variables">
-            Restore
-          </button>
-          <button @click="downloadCSS()" style="padding: 8px 12px; font-size: 11px; font-weight: 600; border: 1px solid #e5e5e5; border-radius: 4px; cursor: pointer; background: white; color: #374151;">
-            CSS
+        <div style="padding: 10px 12px; background: #f7f7f7; display: flex; flex-direction: column; gap: 8px;">
+          <div style="display: flex; gap: 8px;">
+            <button @click="copyConfig()" :style="{ flex: 1, padding: '8px', fontSize: '11px', fontWeight: '500', border: '1px solid #e5e5e5', borderRadius: '4px', cursor: 'pointer', background: copySuccess ? '#10b981' : 'white', color: copySuccess ? 'white' : '#374151', transition: 'background 0.2s' }">
+              <span x-text="copySuccess ? '✓ Copied' : 'Copy'"></span>
+            </button>
+            <button @click="openRestoreModal()" style="flex: 1; padding: 8px; font-size: 11px; font-weight: 500; border: 1px solid #e5e5e5; border-radius: 4px; cursor: pointer; background: white; color: #374151;" title="Restore from CSS variables">
+              Restore
+            </button>
+            <button @click="resetConfigToDefaults()" style="flex: 1; padding: 8px; font-size: 11px; font-weight: 500; border: 1px solid #fca5a5; border-radius: 4px; cursor: pointer; background: #fef2f2; color: #dc2626;" title="Reset to defaults">
+              Reset
+            </button>
+          </div>
+          <button @click="downloadCSS()" style="width: 100%; padding: 10px 12px; font-size: 12px; font-weight: 600; border: none; border-radius: 4px; cursor: pointer; background: #1a1a2e; color: white;">
+            Download CSS
           </button>
         </div>
       </div>
@@ -2415,6 +2434,53 @@ Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
       </div>
     </div>
 
+    <!-- Close Warning Modal -->
+    <div x-show="showCloseWarningModal"
+         x-transition:enter="transition ease-out duration-200"
+         x-transition:enter-start="opacity-0"
+         x-transition:enter-end="opacity-100"
+         x-transition:leave="transition ease-in duration-150"
+         x-transition:leave-start="opacity-100"
+         x-transition:leave-end="opacity-0"
+         style="position: fixed; inset: 0; background: rgba(0,0,0,0.5); display: flex; align-items: center; justify-content: center; z-index: 10003; pointer-events: auto;">
+      <div @click.stop style="background: white; border-radius: 8px; box-shadow: 0 25px 50px -12px rgba(0,0,0,0.25); width: 420px; max-width: 90vw; font-family: system-ui, -apple-system, sans-serif;">
+        <!-- Modal Header -->
+        <div style="padding: 12px 16px; background: #fef3c7; color: #92400e; border-radius: 8px 8px 0 0; display: flex; align-items: center; gap: 10px;">
+          <svg style="width: 20px; height: 20px; flex-shrink: 0;" fill="currentColor" viewBox="0 0 20 20">
+            <path fill-rule="evenodd" d="M8.257 3.099c.765-1.36 2.722-1.36 3.486 0l5.58 9.92c.75 1.334-.213 2.98-1.742 2.98H4.42c-1.53 0-2.493-1.646-1.743-2.98l5.58-9.92zM11 13a1 1 0 11-2 0 1 1 0 012 0zm-1-8a1 1 0 00-1 1v3a1 1 0 002 0V6a1 1 0 00-1-1z" clip-rule="evenodd"/>
+          </svg>
+          <span style="font-weight: 600; font-size: 14px;">Unsaved Configuration</span>
+        </div>
+        <!-- Modal Body -->
+        <div style="padding: 16px;">
+          <p style="font-size: 13px; color: #374151; margin: 0 0 12px 0; line-height: 1.5;">
+            Your grid configuration changes are stored in <strong>browser localStorage</strong> and will only apply while the visualizer is loaded.
+          </p>
+          <div style="background: #f3f4f6; border-radius: 6px; padding: 12px; margin-bottom: 12px;">
+            <p style="font-size: 12px; color: #4b5563; margin: 0 0 8px 0; line-height: 1.5;">
+              <strong>To make changes permanent:</strong>
+            </p>
+            <ol style="font-size: 11px; color: #6b7280; margin: 0; padding-left: 16px; line-height: 1.6;">
+              <li>Copy the config to your clipboard</li>
+              <li>Paste into your project's CSS file</li>
+              <li>Remove the visualizer script from production</li>
+            </ol>
+          </div>
+          <p style="font-size: 11px; color: #9ca3af; margin: 0; line-height: 1.4;">
+            Without copying, your changes will be lost when the visualizer is removed.
+          </p>
+        </div>
+        <!-- Modal Footer -->
+        <div style="padding: 12px 16px; background: #f7f7f7; border-radius: 0 0 8px 8px; display: flex; justify-content: space-between; gap: 8px;">
+          <button @click="closeWarningDiscard()" style="padding: 8px 16px; font-size: 11px; font-weight: 600; border: 1px solid #fca5a5; border-radius: 4px; cursor: pointer; background: #fef2f2; color: #dc2626;">Discard Changes</button>
+          <div style="display: flex; gap: 8px;">
+            <button @click="closeWarningGoBack()" style="padding: 8px 16px; font-size: 11px; font-weight: 600; border: 1px solid #e5e5e5; border-radius: 4px; cursor: pointer; background: white; color: #374151;">Go Back</button>
+            <button @click="closeWarningCopyAndClose()" style="padding: 8px 16px; font-size: 11px; font-weight: 600; border: none; border-radius: 4px; cursor: pointer; background: #1a1a2e; color: white;">Copy & Close</button>
+          </div>
+        </div>
+      </div>
+    </div>
+
     <!-- Grid Diagram -->
     <div x-show="showDiagram"
          style="position: fixed; top: 50%; left: 50%; transform: translate(-50%, -50%); background: white; border-radius: 0.5rem; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25); pointer-events: auto; z-index: 10001; padding: 1.5rem; max-width: 90vw;">

package/dist/_objects.breakout-grid.css

@@ -1,6 +1,6 @@
 /**
  * Breakout Grid - Objects Layer (ITCSS)
- * Version: 5.1.0
+ * Version: 5.1.2
  *
  * Documentation: https://github.com/astuteo-llc/breakout-grid
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astuteo/breakout-grid",
-  "version": "5.1.0",
+  "version": "5.1.2",
   "type": "module",
   "description": "CSS Grid breakout layout system with visual configurator",
   "main": "dist/_objects.breakout-grid.css",
@@ -57,9 +57,8 @@
     "check-version": "node scripts/check-version.js",
     "prepublishOnly": "npm run build && npm run check-files",
     "check-files": "npm pack --dry-run",
-    "release": "npm run build && npm run check-files",
-    "release:patch": "npm run release && npm version patch && git push && git push --tags",
-    "release:minor": "npm run release && npm version minor && git push && git push --tags",
-    "release:major": "npm run release && npm version major && git push && git push --tags"
+    "release:patch": "npm version patch --no-git-tag-version && npm run build && npm run check-version && git add -A && git commit -m \"$(node -p 'require(`./package.json`).version')\" && git tag \"v$(node -p 'require(`./package.json`).version')\" && git push && git push --tags",
+    "release:minor": "npm version minor --no-git-tag-version && npm run build && npm run check-version && git add -A && git commit -m \"$(node -p 'require(`./package.json`).version')\" && git tag \"v$(node -p 'require(`./package.json`).version')\" && git push && git push --tags",
+    "release:major": "npm version major --no-git-tag-version && npm run build && npm run check-version && git add -A && git commit -m \"$(node -p 'require(`./package.json`).version')\" && git tag \"v$(node -p 'require(`./package.json`).version')\" && git push && git push --tags"
   }
 }