Make files that need to be copied visible to git

Author: mizmay

.github/workflows/deploy-preview.yml

@@ -28,13 +28,13 @@ jobs:
         run: |
           # Copy everything to deploy directory
           mkdir -p deploy-out
-
+          
           # Copy HTML files
           cp index.html deploy-out/
           cp viewer.html deploy-out/
-
-          # Copy staging directory with all branches
-          cp -r staging deploy-out/
+          
+          # Copy previews directory with all branches
+          cp -r previews deploy-out/
 
       - name: Deploy to GitHub Pages
         uses: JamesIves/github-pages-deploy-action@v4

BRANCH_PREVIEW_GUIDE.md

@@ -8,11 +8,11 @@ The preview system uses a clean two-file architecture:
 
 - **`index.html`**: Main container with side-by-side layout and controls (Align, Synchronize, Zoom)
 - **`viewer.html`**: Individual map viewer loaded in iframes, one per branch
-- **Asset structure**: Built assets stored in `staging/previews/{branch}/dist/`
+- **Asset structure**: Built assets stored in `previews/{branch}/dist/`
 
 ### How It Works
 
-1. Each branch's build artifacts are synced to `staging/previews/{branch}/dist/`
+1. Each branch's build artifacts are synced to `previews/{branch}/dist/`
 2. `index.html` loads two instances of `viewer.html` in iframes, passing branch names via URL parameters
 3. Each `viewer.html` loads its branch's MapLibre assets and renders a map
 4. The iframes communicate with the parent via `postMessage` for synchronization
@@ -60,8 +60,8 @@ Defined under `scripts` in `package.json`:
 
 The server serves from the project root, with:
 - HTML files at root: `index.html`, `viewer.html`
-- Branch assets in: `staging/previews/{branch}/dist/`
-- Branch registry: `staging/previews/branches.json`
+- Branch assets in: `previews/{branch}/dist/`
+- Branch registry: `previews/branches.json`
 
 ---
 
@@ -97,7 +97,7 @@ The deployment system uses GitHub Actions to deploy the `preview-infra` branch t
 **The workflow**:
 1. Checks out the `preview-infra` branch
 2. Copies `index.html` and `viewer.html` to the deployment folder
-3. Copies the entire `staging/` directory (which contains all synced branches)
+3. Copies the entire `previews/` directory (which contains all synced branches)
 4. Deploys everything to the `gh-pages` branch
 
 **Important**: The workflow does NOT build branches. You must build and sync branches locally using `npm run preview-sync` before pushing.
@@ -178,8 +178,8 @@ Run `git branch` to see branch status symbols:
 
 ### Asset Loading Issues
 - **Local**: Ensure `npm run preview-local` is serving from the project root
-- **Remote**: Check that the workflow deployed to `staging/previews/{branch}/dist/`
-- **Paths**: Both `index.html` and `viewer.html` use relative paths starting with `./staging/previews/`
+- **Remote**: Check that the workflow deployed to `previews/{branch}/dist/`
+- **Paths**: Both `index.html` and `viewer.html` use relative paths starting with `./previews/`
 
 ### Sync Not Working
 - **Refresh the page**: The iframes need to be fully loaded before sync works

index.html

@@ -43,7 +43,7 @@
         async function init() {
             let branches = ['main'];
             try {
-                const resp = await fetch('./staging/previews/branches.json');
+                const resp = await fetch('./previews/branches.json');
                 if (resp.ok) branches = await resp.json();
             } catch (e) {}
 

previews/align-button-keyboard-zoom/dist/LICENSE.txt

@@ -0,0 +1,116 @@
+Copyright (c) 2023, MapLibre contributors
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the name of MapLibre GL JS nor the names of its contributors
+      may be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+-------------------------------------------------------------------------------
+
+Contains code from mapbox-gl-js v1.13 and earlier
+
+Version v1.13 of mapbox-gl-js and earlier are licensed under a BSD-3-Clause license
+
+Copyright (c) 2020, Mapbox
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+* Neither the name of Mapbox GL JS nor the names of its contributors
+  may be used to endorse or promote products derived from this software
+  without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+-------------------------------------------------------------------------------
+
+Contains code from glfx.js
+
+Copyright (C) 2011 by Evan Wallace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+Contains a portion of d3-color https://github.com/d3/d3-color
+
+Copyright 2010-2016 Mike Bostock
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the author nor the names of contributors may be used to
+  endorse or promote products derived from this software without specific prior
+  written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.