cncjs-conversational 0.1.0 → 0.2.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Pedro Paulo Vezza Campos
-
-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.
+MIT License
+
+Copyright (c) 2026 Pedro Paulo Vezza Campos
+
+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.

package/README.md

@@ -20,9 +20,13 @@ In CNCjs, turn on **Custom Widget** under **Manage Widgets** and set its URL to
 `/conversational/`. [cncjs-whb04b6-el400-integration](https://github.com/pedropaulovc/cncjs-whb04b6-el400-integration)
 mounts it for you.
 
-The widget does not send programs to CNCjs yet: use **Download .nc** and load
-the file with CNCjs's **Upload G-code**. The page also works on its own; open
-`web/index.html` in a browser.
+Open a port in CNCjs, then click **Load in CNCjs**: the program replaces the one
+loaded in CNCjs's workspace, ready for the Visualizer and **Run**. Loading is
+refused while a program is running or paused, since it would stop the job.
+Inside CNCjs the widget uses CNCjs's session token and `/api/gcode`, so it must
+be served by CNCjs (`--mount`) rather than from another address. CNCjs's widget
+sandbox blocks file downloads, so **Download .nc** only appears when the page is
+opened on its own (for example `web/index.html` in a browser).
 
 ## Checks
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cncjs-conversational",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Conversational programming CNCjs custom widget: face, side face, square up, pockets and bolt circles laid out as a dimensioned sketch.",
   "keywords": [
     "cncjs",

package/web/index.html

@@ -188,8 +188,10 @@ pre .arc { color: var(--path); }
         <h2>G-code</h2>
         <button class="btn" id="copy">Copy</button>
         <button class="btn primary" id="dl">Download .nc</button>
+        <button class="btn primary" id="load" hidden>Load in CNCjs</button>
       </div>
       <p class="stats" id="stats"></p>
+      <p class="stats" id="cnc-note" aria-live="polite" hidden></p>
       <pre id="gcode" aria-label="Generated G-code"></pre>
     </section>
   </aside>
@@ -1015,6 +1017,7 @@ function render() {
     current = [];
     pre.innerHTML = '<span class="c">(fix the errors on the left to generate code)</span>';
     stats.textContent = '';
+    updateLoad();
     return;
   }
   current = [];
@@ -1025,6 +1028,7 @@ function render() {
   const e = estimate(current);
   const m = Math.floor(e.min), s = Math.round((e.min - m) * 60);
   stats.innerHTML = `<b>${current.length}</b> lines, <b>${Math.round(e.cut)}</b> mm of feed moves, about <b>${m} min ${s} s</b> at the programmed feeds`;
+  updateLoad();
 }
 
 // ---------- wiring ----------
@@ -1058,10 +1062,92 @@ document.getElementById('copy').addEventListener('click', async e => {
 document.getElementById('dl').addEventListener('click', () => {
   const a = document.createElement('a');
   a.href = URL.createObjectURL(new Blob([current.join('\n') + '\n'], { type: 'text/plain' }));
-  a.download = `${st.op}.nc`;
+  a.download = programName();
   a.click();
   URL.revokeObjectURL(a.href);
 });
+
+// ---------- CNCjs custom widget ----------
+// CNCjs puts its session token on the iframe URL, answers a `connect` message with
+// { action: { type: 'change', payload: { port, controller } } }, and sizes the
+// iframe from its body itself. Its sandbox has no allow-downloads, so inside
+// CNCjs the program goes through /api/gcode instead of a file.
+const token = new URLSearchParams(location.search).get('token');
+const sameOriginParent = () => { try { return window.parent.location.origin === location.origin; } catch { return false; } };
+// standalone: own tab or file; cncjs: served and framed by CNCjs; foreign: framed by CNCjs from another origin
+const embedding = window.parent === window || !token ? 'standalone' : sameOriginParent() ? 'cncjs' : 'foreign';
+// load.state: idle | loading | loaded | refused | failed; `program` is the text the message is about
+const cnc = { token, port: null, load: { state: 'idle', message: '', program: '' } };
+const programName = () => `${st.op}${st.op === 'square' ? `-setup${st.sq.setup}` : st.op === 'side' ? `-${st.side.side}` : ''}.nc`;
+const programText = () => current.length ? current.join('\n') + '\n' : '';
+const setLoad = (state, message = '', program = '') => {
+  // An outcome that arrives after the operator edited the program is still shown once,
+  // marked as describing the earlier version; the next edit clears it.
+  const edited = state !== 'loading' && program !== programText();
+  cnc.load = edited
+    ? { state, message: `${message} (This was the program before your last edit.)`, program: programText() }
+    : { state, message, program };
+  updateLoad();
+};
+
+function updateLoad() {
+  const load = document.getElementById('load'), note = document.getElementById('cnc-note');
+  load.hidden = note.hidden = embedding === 'standalone';
+  document.getElementById('dl').hidden = embedding !== 'standalone';
+  if (embedding === 'standalone') return;
+  if (embedding === 'foreign') {
+    load.disabled = true;
+    note.textContent = 'Loading into CNCjs needs the widget served by CNCjs itself (same address and port).';
+    return;
+  }
+  const { load: L } = cnc;
+  // A result describes one program; editing it makes the result stale.
+  if (L.state !== 'idle' && L.state !== 'loading' && L.program !== programText()) cnc.load = { state: 'idle', message: '', program: '' };
+  load.disabled = !current.length || !cnc.port || cnc.load.state === 'loading';
+  note.textContent = cnc.load.state !== 'idle' ? cnc.load.message
+    : cnc.port ? `Port ${cnc.port}: loading replaces the program loaded in CNCjs.` : 'Open a port in CNCjs to load this program.';
+}
+
+async function cncjsApi(path, init = {}) {
+  const res = await fetch(path, { ...init, headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${cnc.token}` } });
+  const body = await res.json().catch(() => ({}));
+  if (!res.ok) throw new Error(body.msg || `HTTP ${res.status}`);
+  return body;
+}
+
+async function loadIntoCncjs() {
+  // Snapshot what is being sent; the port and the editor may change while waiting.
+  const port = cnc.port, name = programName(), program = programText();
+  setLoad('loading', `Loading ${name}…`, program);
+  try {
+    // gcode:load stops CNCjs's workflow, so only load when nothing is running or paused,
+    // the same rule CNCjs's own Upload button follows.
+    const controllers = await cncjsApi('/api/controllers');
+    if (!Array.isArray(controllers)) return setLoad('failed', 'Not loaded: CNCjs did not report its controllers.', program);
+    const workflow = controllers.find(c => c.port === port)?.workflow?.state;
+    if (!workflow) return setLoad('failed', `Not loaded: ${port} is not open in CNCjs.`, program);
+    if (workflow !== 'idle') return setLoad('refused', `Not loaded: a program is ${workflow} on ${port}. Stop it in CNCjs first.`, program);
+    await cncjsApi('/api/gcode', { method: 'POST', body: JSON.stringify({ port, name, gcode: program }) });
+    setLoad('loaded', `Loaded ${name} into CNCjs on ${port}.`, program);
+  } catch (error) {
+    setLoad('failed', `Not loaded: ${error.message}`, program);
+  }
+}
+
+if (embedding === 'cncjs') {
+  window.addEventListener('message', e => {
+    if (e.source !== window.parent || e.origin !== location.origin) return;
+    const msg = e.data || {};
+    if (typeof msg.token === 'string' && msg.token) cnc.token = msg.token;
+    const a = msg.action || {};
+    if (a.type !== 'change' || !a.payload || !Object.hasOwn(a.payload, 'port')) return;
+    cnc.port = a.payload.port || null;
+    if (cnc.load.state !== 'loading') cnc.load = { state: 'idle', message: '', program: '' };
+    updateLoad();
+  });
+  document.getElementById('load').addEventListener('click', loadIntoCncjs);
+  window.parent.postMessage({ token: cnc.token, action: { type: 'connect' } }, location.origin);
+}
 selectOp(st.op);
 </script>
 </body>