arcane-os 0.42.1 → 0.43.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.43.0
+
+- Add reusable rendered printing through `createPrintView`, preserving the
+  complete rendered content, title, styles and prepared image/font resources.
+  Explicit print requests await preparation; native printing uses the active
+  view. Resources remain owned through `afterprint`.
+- Add Markdown editor `print()` and `insertMarkdown(text)` and file-manager
+  `printPreview()`. Insertion replaces the current selection through the
+  ordinary full-content change lifecycle; printing does not save the document.
+- Add reusable history/file-manager `close()` with child-first closure and
+  pending-open cancellation. Refused or failed closure preserves the settled
+  visible preview, media and printing until its dialog actually closes.
+  Preserve modal focus restoration and existing saved records without migration.
+
+## 0.42.2
+
+- Stop generating SDK cache suffixes in import maps, materialized runtime,
+  source serving, packaged resources, scaffold references and shared components.
+  Remove retired local `arcaneVersion` fields while preserving complete
+  functional queries, including caller-owned `v`, URL spelling and fragments.
+- Preserve external URLs and resources under an external document base,
+  public method signatures, semantic version metadata, conditional HTTP caching
+  and stable application caches. Regenerate managed references through the
+  public package workflow after updating the SDK.
+
 ## 0.42.1
 
 - Keep Enter as native newline input on phones and tablets using the shared

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles share the theme, packaging, event, cancellation,
 and browser run contracts while retaining their selected application layout.
 
-This checkout defines the `0.42.1` SDK contract. Applications pin one exact npm
+This checkout defines the `0.43.0` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 

package/docs/reference/runtime-components.md

@@ -67,17 +67,17 @@ appropriate.
 | [`conversation-view.html`](#conversation-viewhtml) | Provider-neutral conversation display, advisory actions, composer, busy state, and status. | `setConversation()`<br>`setBusy()`<br>`setStatus()`<br>`clearComposer()`<br>`destroy()` | `conversation-view-ready`<br>`communication-send`<br>`communication-advisory-action` | DOM-normalized |
 | [`dashboard-config.html`](#dashboard-confightml) | Selects which normalized chart definitions are visible on a dashboard. | `configure()`<br>`setDefinitions()`<br>`setVisibility()`<br>`getChartOptions()`<br>`getEffectiveVisibility()`<br>`open()`<br>`close()`<br>`destroy()` | `dashboard-config-ready`<br>`dashboard-config-opened`<br>`dashboard-config-closed`<br>`dashboard-config-change` | Fully normalized definitions and visibility |
 | [`data-maintenance.html`](#data-maintenancehtml) | Runs destructive cleanup of empty chats and memories inside the current app data scope. | `open()`<br>`destroy()` | `data-maintenance-ready`<br>`data-maintenance-complete` | Normalized counts; DBOPFS failures mixed |
-| [`data-view.html`](#data-viewhtml) | Opens a modal file view and forwards application-owned preview and directory-filter callbacks. | `beforeOpen()`<br>`open()`<br>`destroy()` | `data-view-ready` | DOM-native result; preview/filter configuration reaches the child before loading |
+| [`data-view.html`](#data-viewhtml) | Opens a modal file view and forwards application-owned preview and directory-filter callbacks. | `beforeOpen()`<br>`open()`<br>`close()`<br>`printPreview()`<br>`destroy()` | `data-view-ready` | DOM-native result; preview/filter configuration reaches the child before loading |
 | [`directory-picker.html`](#directory-pickerhtml) | Presents the provider-owned OS directory chooser with change/cancel/error states. | `configure()`<br>`focus()`<br>`select()`<br>`destroy()` | `directory-picker-ready`<br>`directory-picker-change`<br>`directory-picker-cancel`<br>`directory-picker-error` | Complete plain-text paths and native selection/error |
 | [`document-inspector.html`](#document-inspectorhtml) | Inspects PDF, text, or source documents and records review state. | `loadDocument()`<br>`selectView()`<br>`markSaved()`<br>`destroy()` | `document-inspector-ready`<br>`document-review-change` | Document state normalized; browser document APIs mixed |
 | [`file-drop.html`](#file-drophtml) | Acquires complete file selections by drag/drop or picker and presents busy, progress, error, and cleared state. | `configure()`<br>`openPicker()`<br>`clear()`<br>`setBusy()`<br>`setError()`<br>`setProgress()`<br>`destroy()` | `file-drop-ready`<br>`file-drop-selected`<br>`file-drop-progress`<br>`file-drop-state`<br>`file-drop-error` | Complete selections preserved; browser File/drop errors mixed |
 | [`file-inspector.html`](#file-inspectorhtml) | Displays file metadata, preview, busy/error state, and caller-defined actions. | `configure()`<br>`show()`<br>`clear()`<br>`setActions()`<br>`setBusy()`<br>`setError()`<br>`setPreview()`<br>`destroy()` | `file-inspector-ready`<br>`file-inspector-action`<br>`file-inspector-change`<br>`file-inspector-cleared`<br>`file-inspector-error` | State normalized; preview/provider behavior mixed |
-| [`file-manager.html`](#file-managerhtml) | Browses app-scoped files, filters directories before reads, and renders application-described previews. | `setProvider()`<br>`loadAll()`<br>`setFilter()`<br>`setDirectoryFilter()`<br>`select()`<br>`clearSelection()`<br>`destroy()` | `file-manager-ready`<br>`file-manager-select`<br>`file-manager-open`<br>`file-manager-action` | Selection/filter state, neutral preview descriptors, cancellation, and media cleanup normalized; storage/provider behavior mixed |
+| [`file-manager.html`](#file-managerhtml) | Browses app-scoped files, filters directories before reads, and renders application-described previews. | `setProvider()`<br>`loadAll()`<br>`setFilter()`<br>`setDirectoryFilter()`<br>`select()`<br>`clearSelection()`<br>`close()`<br>`printPreview()`<br>`destroy()` | `file-manager-ready`<br>`file-manager-select`<br>`file-manager-open`<br>`file-manager-action` | Selection/filter state, neutral preview descriptors, cancellation, and media cleanup normalized; storage/provider behavior mixed |
 | [`header.html`](#headerhtml) | Shared title bar with history, reload, online marker, presentation labels, and 988 link. | None | No component-specific event | Browser/platform-native behavior; no component-ready contract |
 | [`integration-settings.html`](#integration-settingshtml) | Edits non-secret communication service configuration and service actions. | `configure()`<br>`getValues()`<br>`setStatus()`<br>`destroy()` | `integration-settings-ready`<br>`integration-settings-save`<br>`integration-settings-close`<br>`integration-action` | Normalized non-secret values |
 | [`local-ai-status.html`](#local-ai-statushtml) | Presents local-AI standby, failure, recovery, guidance, retry, and dismissal states. | `configure()`<br>`begin()`<br>`present()`<br>`destroy()`<br>`hidden` | `local-ai-status-ready`<br>`local-ai-status-dismissed`<br>`local-ai-retry` | Fully normalized LocalAIReadiness report |
 | [`markdown-document.html`](#markdown-documenthtml) | Renders and navigates a complete Markdown document with focusable fragments. | `configure()`<br>`load()`<br>`render()`<br>`clear()`<br>`fail()`<br>`focus()`<br>`focusFragment()`<br>`destroy()` | `markdown-document-ready`<br>`markdown-document-state`<br>`markdown-document-loading`<br>`markdown-document-rendered`<br>`markdown-document-empty`<br>`markdown-document-error`<br>`markdown-document-navigate` | Complete Markdown/state normalized; malformed input and Marked/DOM failures remain visible |
-| [`markdown-editor.html`](#markdown-editorhtml) | Configurable Markdown authoring with optional bounded input/preview panes and edit-position following. | `configure()`<br>`focus()`<br>`clear()`<br>`saveEntry()`<br>`destroy()` | `markdown-editor-ready`<br>`markdown-editor-change`<br>`markdown-editor-saved` | Editor values, opt-in fit layout, and preview following normalized; injected save result mixed |
+| [`markdown-editor.html`](#markdown-editorhtml) | Configurable Markdown authoring with optional bounded input/preview panes, edit-position following, and rendered printing. | `configure()`<br>`focus()`<br>`clear()`<br>`insertMarkdown()`<br>`saveEntry()`<br>`print()`<br>`destroy()` | `markdown-editor-ready`<br>`markdown-editor-change`<br>`markdown-editor-saved` | Editor values, opt-in fit layout, and preview following normalized; injected save result mixed |
 | [`media-embed.html`](#media-embedhtml) | Loads a parsed YouTube video or playlist embed with ordinary hosting by default, optional privacy enhancement, and an external-platform action. | `configure()`<br>`load()`<br>`destroy()` | `media-embed-ready`<br>`media-load`<br>`media-error`<br>`media-open-platform` | URL/error normalized; iframe/platform behavior native |
 | [`modal.html`](#modalhtml) | Generic modal with population, configurable user dismissal, actions, and concurrent task execution. | `configure()`<br>`populate()`<br>`open()`<br>`close()`<br>`runTasks()`<br>`destroy()`<br>`running`<br>`opened` | `modal-ready`<br>`modal-opened`<br>`modal-closed`<br>`modal-action` | Modal state normalized; injected task results mixed |
 | [`output-panel.html`](#output-panelhtml) | Presents status, output, body, coverage, actions, pending, error, and cleared states. | `configure()`<br>`setOutput()`<br>`setBody()`<br>`setCoverage()`<br>`setActions()`<br>`setPending()`<br>`setStatus()`<br>`setError()`<br>`clear()`<br>`destroy()` | `output-panel-ready`<br>`output-panel-state`<br>`output-panel-change`<br>`output-panel-action`<br>`output-panel-error`<br>`output-panel-cleared` | DOM-normalized |
@@ -663,7 +663,7 @@ own record mappings through the same preview callbacks as the standalone
 
 ### Public surface
 
-Methods/properties: `beforeOpen()`, `open()`, `destroy()`.
+Methods/properties: `beforeOpen()`, `open()`, `close()`, `printPreview()`, `destroy()`.
 
 Assign `previewDescriptor`, `previewTransform`, and `directoryFilter` on the
 host before opening. The component forwards those callbacks, comma-separated
@@ -673,6 +673,20 @@ before the child's first load. Reopening refreshes those values before
 `beforeOpen()` is awaited before this configuration is consumed. `data-dirs`
 selects the initial directories; `data-layout` defaults to `files`.
 
+`await close()` invalidates pending opens, closes the child's dialogs before the
+parent, and returns `true` only after closure. It returns `false` when destroyed
+or a child/parent cannot close; complete errors reach shared diagnostics. It is
+reusable: a later `open()` reloads the existing child. Repeated closes share the
+pending closure. `destroy()` remains terminal.
+
+An application that loads a history selection into an editor must synchronously
+call `preventDefault()` on the existing cancelable `file-manager-open` event
+before awaiting its own save/load work. That application owns record selection,
+autosave, title, and editor focus; call `close()` after loading and restore focus
+after it resolves `true`. No record-loading policy is added to the SDK.
+`printPreview()` forwards to the currently open child preview and returns
+`false` when no such preview is available.
+
 Events: `data-view-ready`.
 
 Shared dependencies: [`WaitForComponent.js`](runtime-modules.md#waitforcomponentjs).
@@ -821,7 +835,7 @@ and `destroy()` cleanup, without delaying unrelated component startup.
 ### Public surface
 
 Methods/properties: `setProvider()`, `loadAll()`, `setFilter()`,
-`setDirectoryFilter()`, `select()`, `clearSelection()`, `destroy()`,
+`setDirectoryFilter()`, `select()`, `clearSelection()`, `close()`, `printPreview()`, `destroy()`,
 `previewDescriptor`, `previewTransform`, `directoryFilter`.
 
 Assign `directoryFilter(entry, context)` before the first load, or call
@@ -879,8 +893,9 @@ component does not automatically read every related media variant.
 
 Closing the preview, opening another file, or destroying the manager aborts
 the preview signal, ignores late descriptor/loader results, stops owned audio,
-removes iframe `srcdoc`, and revokes every owned object URL, including those
-in nested collections.
+removes iframe `srcdoc`, and releases owned object URLs, including those in
+nested collections. An active print snapshot retains its URLs until the
+browser's `afterprint` event, even when the preview closes meanwhile.
 Applications should observe the supplied signal in their asynchronous reads.
 Descriptor and file-open failures show `Unable to open this file.` in the
 current modal and send the original error to the shared logger.
@@ -900,6 +915,26 @@ of the original `File`.
 The larger file-preview dialog reuses `--modal-width`, `--modal-max-height`,
 and `--modal-padding`; applications can override those existing modal values.
 
+The preview's **Print** button and `await printPreview()` print its current
+rendered content with the file title. Native browser Print selects the open
+preview ahead of the editor. Printing uses the shared
+[`PrintView.js`](runtime-modules.md#printviewjs) owner; accessible HTML frames
+are copied from their current rendered document, never substituted with source
+text. Explicit printing waits for images/fonts and HTML frame readiness.
+Native PDF and inaccessible embedded viewers require their own print command.
+`true` means the browser print dialog was requested, not that paper or a PDF
+was produced. Closed, destroyed, or unavailable previews return `false`;
+preparation failures reject and the visible control reports a concise failure.
+
+`await close()` cancels pending presentation work and closes delete, file, and
+directory dialogs in that order. A settled preview keeps its rendered content,
+media, and printing available until the file dialog actually closes; refusing
+or failing to close leaves the still-visible preview usable. Actual file-dialog
+closure releases its preview resources. The method returns `false` on
+refused/failed closure or after destruction. The manager stays
+reusable; a later opening can use it again. Already accepted upload/deletion
+writes complete through the storage owner without reopening closed dialogs.
+
 Events: `file-manager-ready`, `file-manager-select`, `file-manager-open`, `file-manager-action`.
 
 Shared dependencies: [`DBOPFS.js`](runtime-modules.md#dbopfsjs), [`File.js`](runtime-entities.md#filejs), [`MD.js`](runtime-modules.md#mdjs), [`WaitForComponent.js`](runtime-modules.md#waitforcomponentjs).
@@ -1048,8 +1083,26 @@ inside an application-supplied bounded area.
 
 ### Public surface
 
-Methods/properties: `configure()`, `focus()`, `clear()`, `saveEntry()`,
-`destroy()`, `value`, `entryTitle`, `options`.
+Methods/properties: `configure()`, `focus()`, `clear()`, `insertMarkdown(text)`,
+`saveEntry()`, `print()`, `destroy()`, `value`, `entryTitle`, `options`.
+
+`insertMarkdown(text)` replaces the current source selection with the exact
+supplied string, places the caret after it, and emits the ordinary change
+event. It preserves the source viewport and normal preview/save lifecycle.
+It returns `false` when read-only or destroyed and throws `TypeError` for a
+non-string. The application owns the inserted Markdown and any related data.
+
+The visible **Print** control and `await print()` print the complete rendered
+Markdown with `entryTitle`, independently of saving. Native browser Print uses
+that same registered view unless an open file preview takes precedence.
+The SDK copies current rendered DOM/styles into a temporary print-only view,
+leaving the editor's source, controls, and screen layout in place. Explicit
+printing waits for resource readiness; native `beforeprint` is synchronous
+and uses the currently rendered content. `print()` returns `false` when the
+view is unavailable, rejects preparation failures, and returns `true` only
+when the browser dialog was requested. Completion of physical printing or PDF
+saving is not observable through this method. See
+[`PrintView.js`](runtime-modules.md#printviewjs).
 
 `configure({fit:true,followPreview:true})` opts into the two independent
 behaviors. Both options default to `false`; omitted options retain their
@@ -1087,7 +1140,7 @@ lists, quotes, and tables follow their block, while invisible source positions
 use a nearby available rendered block rather than exact glyph geometry.
 
 Public CSS parts are `editor`, `title`, `toolbar`, `input`, `preview`,
-`actions`, `status`, and `save-action`. Applications can make the title
+`actions`, `status`, `print-action`, and `save-action`. Applications can make the title
 borderless and compact through `::part(title)` while retaining its native
 editing behavior and visible keyboard focus. These parts are styling hooks,
 not slots or replacement controls.

package/docs/reference/runtime-modules.md

@@ -109,6 +109,7 @@ own asynchronous work, cancellation, and backpressure.
 | [`PersistentAIChatSession.js`](#persistentaichatsessionjs) | esm | Adds explicit retained-history/memory policy to complete configured chat without changing DBOPFS or ChatEntity semantics. | Browser / native WebView with DBOPFS and configured chat | Retained context commits atomically; `persist:false` turns are one-operation-only. |
 | [`PreferenceStore.js`](#preferencestorejs) | esm | Loads and updates schema-defined app preferences through native storage with a narrow browser fallback. | Browser/native hybrid | Complete ordinary values remain mutable; setAll uses one optional atomic adapter batch for every selected value when advertised, otherwise performs complete ordered serial writes, and only exact unsupported native capability changes future operations to the browser fallback. |
 | [`PreparedSpeech.js`](#preparedspeechjs) | esm | Owns detached ordered preparation, semantic audio reuse, and per-caller cancellation behind AI.prepareTTS. | Browser / native WebView with injected synthesis and optional DBOPFS | Complete original inputs, ordered audio metadata, durable reuse, and observable preparation results. |
+| [`PrintView.js`](#printviewjs) | esm | Prints current rendered content and title through one document-owned print lifecycle. | Browser / supported native WebView print implementation | Complete rendered snapshot, preparation cancellation, resource lifetime, and honest request result. |
 | [`QRCode.min.js`](#qrcodeminjs) | classic-script | Vendored QRCode generator for DOM, canvas, SVG, and image output. | Browser vendor script | Vendor-native. |
 | [`Questionnaire.js`](#questionnairejs) | esm | Evaluates whether a one-time questionnaire prompt is due without performing the prompt. | Cross-host | Normalized conservative boolean. |
 | [`RecordLinkIndex.js`](#recordlinkindexjs) | esm | Parses record links and builds their normalized index. | Cross-host | Fully normalized. |
@@ -2444,9 +2445,10 @@ module URLs reuse and export the registered constructor, including overlapping
 application startup and developer error-dialog imports. Existing component
 instances, loading, readiness events, and teardown keep that same constructor.
 
-Local component resources use the loader's `arcaneVersion` as their sole version
-field. Existing `v` fields are removed; unrelated query fields and fragments
-remain intact.
+Local component resources use stable URLs. The loader removes retired SDK-owned
+`arcaneVersion` fields and adds no cache suffix. Functional query fields,
+including caller-owned `v` fields, and fragments remain intact. External resource
+URLs retain their complete query. Ordinary HTTP conditional caching is unchanged.
 
 Exact exports: `default`.
 
@@ -3250,6 +3252,69 @@ import {prepareSpeech} from '/arcane/modules/PreparedSpeech.js';
 console.log(typeof prepareSpeech); // function
 ```
 
+## PrintView.js
+
+### Overview
+
+Shared rendered-print owner used by Markdown Editor and File Manager. It
+captures the current DOM and computed styles, including accessible rendered
+HTML frames, complete text, selected images, and the current title. A temporary
+print-only surface expands scrollable content without editing the live screen.
+
+### Public surface
+
+Named `createPrintView({host,content,title,active,priority=0,signal,onError,retain})`
+returns `{print,destroy}`. `host` is a connected element; synchronous callbacks
+return the rendered content node, string title, and whether the view is active.
+Optional `retain()` returns a resource-release callback. It keeps owned media
+available until preparation is cancelled or the browser emits `afterprint`.
+
+`await print()` selects that view, waits for accessible HTML frame, image, and
+font readiness, and requests the browser print dialog. It returns `false` when
+the view is unavailable or preparation is cancelled, returns `true` for a dialog
+request, and rejects preparation errors. It cannot confirm physical printing
+or PDF saving. Overlapping print sessions on the same document reject.
+
+One native `beforeprint`/`afterprint` registration serves each document. Native
+Print chooses the highest-priority visible active view, most recently registered
+on ties. File preview uses priority `1`; editor uses `0`. Native `beforeprint`
+is synchronous: it snapshots currently rendered content, cannot await a newly
+loading resource, and cannot cancel the browser's dialog. `onError(error)` or
+the developer console receives complete preparation failures.
+
+`destroy()` unregisters the view and cancels pending preparation. Once the
+dialog has been requested, its snapshot and retained media remain until
+`afterprint`. Import alone creates no listener, provider, storage, or print job.
+
+Exact exports: `createPrintView`.
+
+### Availability and normalization
+
+**Browser and native WebViews with a print implementation.** Requires DOM,
+CSSOM, FontFace/Image readiness, and browser print events. No Core capability.
+Cross-origin/inaccessible frames, native PDF frames, and object/embed viewers
+must use their owning viewer's print command; the helper does not replace their
+content with raw source or claim an unrendered document was printed. Font
+sources in embedded documents must be accessible for snapshot preparation.
+
+### Example
+
+```javascript
+import {createPrintView} from '/arcane/modules/PrintView.js';
+
+const ledger = document.querySelector('#moon-library-ledger');
+const printing = createPrintView({
+    host:ledger,
+    content:() => ledger,
+    title:() => 'Books overdue on the Moon',
+    active:() => true
+});
+document.querySelector('#print-ledger').onclick = async function printLedger(){
+    try { await printing.print(); }
+    catch(error) { console.error('Unable to print the ledger:', error); }
+};
+```
+
 ## QRCode.min.js
 
 ### Overview

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.42.1",
+  "version": "0.43.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",

package/runtime/arcane/components/browser-ai-setup.html

@@ -1,4 +1,4 @@
-<link rel="stylesheet" href="./arcane/css/primitives.css?v=1">
+<link rel="stylesheet" href="./arcane/css/primitives.css">
 <style>
     :host{display:block;min-width:0}
     .flag-choice {

package/runtime/arcane/components/calculator.html

@@ -1,4 +1,4 @@
-<link rel="stylesheet" href="./arcane/css/theme.css?v=1"><link rel="stylesheet" href="./arcane/css/primitives.css?v=1">
+<link rel="stylesheet" href="./arcane/css/theme.css"><link rel="stylesheet" href="./arcane/css/primitives.css">
 <style>:host{display:block;max-width:34rem}.calculator{display:grid;gap:var(--arcane-space-3);padding:var(--arcane-space-4)}.display{display:grid;gap:var(--arcane-space-2)}.display input{font:600 1.3rem/1.4 ui-monospace,monospace;text-align:right}.result{min-height:2.5rem;margin:0;text-align:right;font-size:1.8rem;font-weight:750;overflow-wrap:anywhere}.keys{display:grid;gap:var(--arcane-space-2);grid-template-columns:repeat(5,1fr)}.keys button{min-width:0;padding:.7rem .35rem}.status{min-height:1.4rem;margin:0;color:var(--arcane-muted)}@media(max-width:28rem){.keys{grid-template-columns:repeat(4,1fr)}}</style>
 <section class="calculator arcane-card"><div class="display arcane-field"><label for="expression">Expression</label><input id="expression" inputmode="decimal" autocomplete="off" spellcheck="false" value=""><p id="result" class="result" aria-live="polite">0</p></div><div id="keys" class="keys" aria-label="Calculator keypad"></div><p id="status" class="status" role="status"></p></section>
 <script type="module">const host=this,root=host.shadowRoot,input=root.querySelector('#expression'),result=root.querySelector('#result'),status=root.querySelector('#status'),keys=root.querySelector('#keys');const {default:CalculatorEngine}=await import('../modules/CalculatorEngine.js');const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');const events=createArcaneEventSource(host,{source:'arcane.component.calculator',eventTypes:['calculation-complete','calculation-error','calculator-ready']}),lifecycleController=new AbortController();const engine=new CalculatorEngine(),definitions=['7','8','9','/','sqrt(','4','5','6','*','^','1','2','3','-','%','0','.','(',')','+','pi','e','C','⌫','='];let destroyed=false,operationSequence=0;

package/runtime/arcane/components/chart.html

@@ -1,4 +1,4 @@
-<link rel="stylesheet" href="./arcane/css/layout.css?v=3">
+<link rel="stylesheet" href="./arcane/css/layout.css">
 <link rel="stylesheet" href="./arcane/modules/uPlot.min.css">
 <style>
     :host{

package/runtime/arcane/components/chat.html

@@ -1,4 +1,4 @@
-<link rel="stylesheet" href="./arcane/css/layout.css?v=3" />
+<link rel="stylesheet" href="./arcane/css/layout.css" />
 <style>
     :host {
         display: block;
@@ -842,7 +842,7 @@
     speechImport.id='speech';
     speechImport.setAttribute(
         'href',
-        new URL('./speech.html?v=3',componentURL).href
+        new URL('./speech.html',componentURL).href
     );
     speechMount.replaceWith(speechImport);
     const events=createArcaneEventSource(

package/runtime/arcane/components/conversation-view.html

@@ -1,4 +1,4 @@
-<link rel="stylesheet" href="./arcane/css/primitives.css?v=1">
+<link rel="stylesheet" href="./arcane/css/primitives.css">
 <style>
 :host{display:block;min-width:0;height:100%}.shell{display:grid;grid-template-rows:auto 1fr auto;height:100%;min-height:32rem}.heading{align-items:center;display:flex;gap:.75rem;justify-content:space-between;padding:1rem;border-bottom:1px solid var(--border-color,#ccd4df)}.heading h2,.heading p{margin:0}.heading p{color:var(--muted-text-color,#607080)}.badge{border:1px solid var(--border-color,#ccd4df);border-radius:999px;padding:.25rem .55rem;font-size:.72rem;text-transform:uppercase}.messages{display:flex;flex-direction:column;gap:.8rem;overflow:auto;padding:1rem}.message{align-self:flex-start;max-width:min(78%,42rem);padding:.75rem .9rem;border:1px solid var(--border-color,#ccd4df);border-radius:.9rem;background:var(--modal-background,#fff)}.message.outbound{align-self:flex-end;color:var(--button-text-color,#fff);background:var(--primary-color,#172238)}.message p{margin:0;white-space:pre-wrap;overflow-wrap:anywhere}.message footer{display:flex;gap:.5rem;justify-content:flex-end;margin-top:.4rem;font-size:.7rem;opacity:.72}.advisory{display:grid;gap:.45rem;margin-top:.7rem;padding:.7rem;border:2px solid var(--border-color,#ccd4df);border-radius:.65rem;background:var(--background-color,#f5f7fa);color:var(--text-color,#172238)}.advisory[data-level="critical"],.advisory[data-level="high"]{border-color:rgb(174,48,52)}.advisory[data-level="caution"]{border-color:rgb(190,120,34)}.advisory strong,.advisory p{margin:0}.advisory ul{margin:.1rem 0;padding-left:1.2rem}.advisory button{justify-self:start}.composer{display:grid;gap:.6rem;padding:1rem;border-top:1px solid var(--border-color,#ccd4df)}textarea{min-height:5rem;resize:vertical}.composer-row{align-items:center;display:flex;gap:.75rem;justify-content:space-between}.status{color:var(--muted-text-color,#607080);margin:0}.blank{display:grid;place-items:center;height:100%;padding:2rem;text-align:center}.blank p{color:var(--muted-text-color,#607080)}
 </style>

package/runtime/arcane/components/dashboard-config.html

@@ -1,5 +1,5 @@
-<link rel="stylesheet" href="./arcane/css/layout.css?v=3">
-<link rel="stylesheet" href="./arcane/css/dashboard-config.css?v=2">
+<link rel="stylesheet" href="./arcane/css/layout.css">
+<link rel="stylesheet" href="./arcane/css/dashboard-config.css">
 <style>
     :host{
         display:block;
@@ -7,7 +7,7 @@
 </style>
 
 <button id="openConfig" type="button" aria-haspopup="dialog" disabled></button>
-<html-import id="configModal" class="modal" href="./arcane/components/modal.html?v=13"></html-import>
+<html-import id="configModal" class="modal" href="./arcane/components/modal.html"></html-import>
 
 <script type="module">
     const {default:Is}=await import('strong-type');
@@ -233,7 +233,7 @@
         const items=document.createElement('section');
 
         styles.rel='stylesheet';
-        styles.href=new URL('../css/dashboard-config.css?v=2',componentHref).href;
+        styles.href=new URL('../css/dashboard-config.css',componentHref).href;
         heading.dataset.dashboardConfigHeading='';
         message.dataset.dashboardConfigDescription='';
         empty.className='dashboard-config-empty';

package/runtime/arcane/components/data-maintenance.html

@@ -1,4 +1,4 @@
-<link rel="stylesheet" href="./arcane/css/layout.css?v=3">
+<link rel="stylesheet" href="./arcane/css/layout.css">
 <style>
     :host{
         display:block;
@@ -10,7 +10,7 @@
 </style>
 
 <button id="openMaintenance" type="button" aria-haspopup="dialog">Maintenance</button>
-<html-import id="maintenanceModal" class="modal" href="./arcane/components/modal.html?v=13"></html-import>
+<html-import id="maintenanceModal" class="modal" href="./arcane/components/modal.html"></html-import>
 
 <script type="module">
     const {arcaneLogging}=await import('arcane-os/logging');
@@ -19,7 +19,7 @@
     const openButton=host.shadowRoot.querySelector('#openMaintenance');
     const maintenanceModal=host.shadowRoot.querySelector('#maintenanceModal');
     const {default:waitForComponent}=await import('../modules/WaitForComponent.js');
-    const {clearEmptyChatsAndMemories}=await import('../modules/DataMaintenance.js?v=3');
+    const {clearEmptyChatsAndMemories}=await import('../modules/DataMaintenance.js');
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
     const events=createArcaneEventSource(host,{source:'arcane.component.data-maintenance',eventTypes:['data-maintenance-complete','data-maintenance-ready']});
     const lifecycleController=new AbortController();

package/runtime/arcane/components/data-view.html

@@ -1,4 +1,4 @@
-<link rel="stylesheet" href="./arcane/css/layout.css?v=3">
+<link rel="stylesheet" href="./arcane/css/layout.css">
 <style>
     :host{
         display:flex;
@@ -11,7 +11,7 @@
 </style>
 
 <button id="openData" type="button" aria-haspopup="dialog"></button>
-<html-import id="dataModal" class="modal" href="./arcane/components/modal.html?v=13"></html-import>
+<html-import id="dataModal" class="modal" href="./arcane/components/modal.html"></html-import>
 
 <script type="module">
     const {default:Is}=await import('strong-type');
@@ -31,12 +31,16 @@
     let content=null;
     let fileManager=null;
     let operationGeneration=0;
+    let openController = null;
+    let closingTask = null;
     let destroyed=false;
 
     host.beforeOpen=is.function(host.beforeOpen)
         ?host.beforeOpen
         :async function beforeOpen(){};
     host.open=openData;
+    host.close = closeData;
+    host.printPreview=printPreview;
     host.destroy=destroy;
 
     openButton.innerText=host.dataset.button||'View Data';
@@ -52,80 +56,159 @@
         {signal:lifecycleController.signal}
     );
 
-    async function openData(){
-        if(destroyed){
+    dataModal.addEventListener(
+        'modal-closed',
+        function closeDataFromModal(event) {
+            if (event.target === dataModal && !closingTask) {
+                closeData();
+            }
+        },
+        {signal: lifecycleController.signal}
+    );
+
+    async function openData() {
+        if (destroyed) {
             return false;
         }
-        const generation=++operationGeneration;
-        await host.beforeOpen();
-        if(destroyed||generation!==operationGeneration){
+        const requestedGeneration=operationGeneration;
+        if (closingTask && !await closingTask) {
             return false;
         }
-
-        const reload=Boolean(content);
-
-        const modal=await waitForComponent(
-            dataModal,
-            {
-                methods:['populate','open'],
-                property:'ready',
-                event:'modal-ready',
-                signal:lifecycleController.signal
-            }
-        );
-        if(destroyed||generation!==operationGeneration){
+        if (destroyed||requestedGeneration!==operationGeneration) {
             return false;
         }
+        const generation = ++operationGeneration;
+        openController?.abort('data-view-open-replaced');
+        const controller = new AbortController();
+        openController = controller;
+
+        try {
+            await host.beforeOpen();
+            if (destroyed || generation !== operationGeneration) {
+                return false;
+            }
 
-        if(!content){
-            content=document.createElement('section');
-            fileManager=document.createElement('html-import');
+            const reload = Boolean(content);
+            const modal = await waitForComponent(
+                dataModal,
+                {
+                    methods: ['populate', 'open'],
+                    property: 'ready',
+                    event: 'modal-ready',
+                    signal: controller.signal
+                }
+            );
+            if (destroyed || generation !== operationGeneration) {
+                return false;
+            }
 
-            const heading=document.createElement('h1');
+            if (!content) {
+                content = document.createElement('section');
+                fileManager = document.createElement('html-import');
+
+                const heading = document.createElement('h1');
+
+                heading.innerText = host.dataset.title || 'Data';
+                fileManager.className = 'file-manager';
+                forwardPreviewOptions();
+                fileManager.dataset.dirs = host.dataset.dirs || '';
+                fileManager.dataset.layout = host.dataset.layout || 'files';
+                fileManager.setAttribute(
+                    'href',
+                    new URL('./file-manager.html', componentHref).href
+                );
+
+                content.append(heading, fileManager);
+                await modal.populate(content, false);
+                if (destroyed || generation !== operationGeneration) {
+                    return false;
+                }
+            }
 
-            heading.innerText=host.dataset.title||'Data';
-            fileManager.className='file-manager';
-            forwardPreviewOptions();
-            fileManager.dataset.dirs=host.dataset.dirs||'';
-            fileManager.dataset.layout=host.dataset.layout||'files';
-            fileManager.setAttribute(
-                'href',
-                new URL('./file-manager.html?v=19',componentHref).href
+            if (reload) {
+                forwardPreviewOptions();
+            }
+
+            const manager = await waitForComponent(
+                fileManager,
+                {
+                    methods: ['loadAll'],
+                    property: 'ready',
+                    event: 'file-manager-ready',
+                    signal: controller.signal
+                }
             );
+            if (destroyed || generation !== operationGeneration) {
+                return false;
+            }
 
-            content.append(heading,fileManager);
-            await modal.populate(content,false);
-            if(destroyed||generation!==operationGeneration){
+            if (reload) {
+                await manager.loadAll();
+                if (destroyed || generation !== operationGeneration) {
+                    return false;
+                }
+            }
+
+            return await modal.open();
+        } catch (error) {
+            if (controller.signal.aborted) {
                 return false;
             }
+            throw error;
+        } finally {
+            if (openController === controller) {
+                openController = null;
+            }
         }
+    }
 
-        if(reload){
-            forwardPreviewOptions();
+    async function closeData() {
+        if (destroyed) {
+            return false;
+        }
+        operationGeneration += 1;
+        openController?.abort('data-view-closed');
+        openController = null;
+        if (closingTask) {
+            return closingTask;
         }
 
-        const manager=await waitForComponent(
-            fileManager,
-            {
-                methods:['loadAll'],
-                property:'ready',
-                event:'file-manager-ready',
-                signal:lifecycleController.signal
-            }
-        );
-        if(destroyed||generation!==operationGeneration){
-            return false;
+        const childClosing = is.function(fileManager?.close)
+            ? fileManager.close()
+            : Promise.resolve(true);
+        closingTask = Promise.resolve(childClosing)
+            .then(closeDataAfterChildren)
+            .catch(
+                function reportDataCloseFailure(error) {
+                    arcaneLogging.error('Unable to close data view:', error);
+                    return false;
+                }
+            );
+        try {
+            return await closingTask;
+        } finally {
+            closingTask = null;
         }
+    }
 
-        if(reload){
-            await manager.loadAll();
-            if(destroyed||generation!==operationGeneration){
+    async function closeDataAfterChildren(childrenClosed) {
+        if (childrenClosed === false || destroyed) {
+            return false;
+        }
+        if (is.function(dataModal.close)) {
+            const closed = await dataModal.close();
+            if (closed === false) {
                 return false;
             }
         }
+        return !destroyed && dataModal.opened !== true;
+    }
 
-        modal.open();
-        return true;
+    async function printPreview(){
+        if(destroyed||dataModal.opened!==true||!is.function(fileManager?.printPreview)){
+            return false;
+        }
+        return fileManager.printPreview();
     }
 
     function forwardPreviewOptions(){
@@ -146,6 +229,8 @@
         }
         destroyed=true;
         operationGeneration+=1;
+        openController?.abort('data-view-destroyed');
+        openController = null;
         lifecycleController.abort('data-view-destroyed');
         fileManager?.destroy?.();
         dataModal.destroy?.();