cedar-embeddable-editor 2.0.2 → 2.0.4

package/CHANGELOG.md

@@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.4] - 2026-09-01
+
+This release aligns CEE's build-time model dependency with the public
+`cedar-model-typescript-library@1.0.5` package. The model library remains compiled into CEE's
+browser bundle and is not a runtime dependency for embedding applications.
+
+### Changed
+
+- The application and visual-test dependency graphs now pin the same public
+  `cedar-model-typescript-library@1.0.5` tarball from npmjs.
+
+- A template may be replaced while no instance has been supplied. Set-once exists
+  to refuse one question — what becomes of the answers someone has been typing when
+  the template under them is swapped — and where there are no answers, there is
+  nothing to lose. Each replacement builds a fresh context, so nothing of the
+  previous template survives into the new form; once an instance is loaded the
+  template is fixed again and a second assignment is reported and ignored, as
+  before. A host showing a live view of a template that is itself being edited no
+  longer has to discard the element and start a whole editor per change, which cost
+  about a second of bootstrapping regardless of the size of the template.
+
+### Added
+
+- The editor says it is the editor. `CEE` is stamped under the mark in the form's
+  header, above the version, which on its own read `2.0.4-dev.20260827.…` and named
+  a build without naming what was built. It matters where CEE is one of several
+  CEDAR components on a page: the embeddable designer's preview panel puts CEE's
+  header a few inches from the designer's own.
+
+- `showExpandCollapseAll`, a config key hiding the Expand All and Collapse All
+  buttons above the form. On by default, so nothing changes for a host that does
+  not set it. A host rendering its own view of the same artifact beside the form
+  — the CEDAR Embeddable Designer previewing the template it is editing — can turn
+  them off rather than offering two contradictory sets of controls over one thing.
+  Each section still opens and closes on its own header.
+
+## [2.0.3] - 2026-08-27
+
+This release aligns CEE's build-time model dependency with the public
+`cedar-model-typescript-library@1.0.4` package. The model library remains compiled into CEE's
+browser bundle and is not a runtime dependency for embedding applications.
+
+### Changed
+
+- The application and visual-test dependency graphs now pin the same public
+  `cedar-model-typescript-library@1.0.4` tarball from npmjs.
+
 ## [2.0.2] - 2026-08-27
 
 The second stable release on the 2.x line adds field identities to required-value validation and

package/bundle-manifest.json

@@ -4,6 +4,6 @@
     "main.js",
     "polyfills.js"
   ],
-  "bytes": 2183062,
-  "sha256": "bbcd976e2baed672c9a68851ebbadbed55544247daeb59adcd4422b79f219269"
+  "bytes": 2184171,
+  "sha256": "10d8880fab0b2c83831a4bc64b31c7efd228d1ed6442609d7f91a0859700b06c"
 }

package/cedar-embeddable-editor.d.ts

@@ -6,12 +6,15 @@
  * `tsc --emitDeclarationOnly` turn this one file into the `.d.ts` the npm package
  * ships, without dragging in paths that exist only inside this repository.
  *
- * Configuration and the artifact inputs are set-once: the first assignment stands,
- * and a later one is reported and ignored. A host wanting different configuration or
- * a different artifact creates a new element. That replaces three behaviours which
- * had no answer — a second `config` that patched some keys and replaced others, a
- * read-only mode that could be turned on and not off, and three artifact inputs with
- * no stated precedence. `eventHandler` is deliberately outside it and may be
+ * Configuration is set-once: the first assignment stands, and a later one is reported
+ * and ignored. So is the instance, and so is the template once an instance is loaded
+ * against it. That replaces three behaviours which had no answer — a second `config`
+ * that patched some keys and replaced others, a read-only mode that could be turned on
+ * and not off, and three artifact inputs with no stated precedence.
+ *
+ * A template with no instance behind it may be replaced, because the question set-once
+ * exists to refuse is what becomes of the answers someone has been typing. Where there
+ * are none, a host may drive a live view of a template that is itself changing. `eventHandler` is deliberately outside it and may be
  * replaced, for the reasons given where it is declared.
  *
  * Types only, with no runtime values, and that is a constraint rather than a
@@ -67,6 +70,19 @@ export interface CeeConfig {
      * asks. Nothing is rendered under the form either way.
      */
     showDownloadMenu?: boolean;
+    /**
+     * Offers the Expand All and Collapse All buttons above the form.
+     *
+     * On by default, which is how CEE has always rendered. A host with its own view
+     * of the same artifact beside the form — a designer previewing the template it
+     * is editing, say — can turn them off so the two are not offered contradictory
+     * controls over one thing.
+     *
+     * The buttons act on the form's own sections and nothing else, so turning them
+     * off removes a control rather than fixing the sections open or shut: each
+     * still opens and closes on its own header.
+     */
+    showExpandCollapseAll?: boolean;
     /**
      * Base for controlled-term search. Must end in a slash.
      *
@@ -234,9 +250,10 @@ export interface CeeEventHandler {
 /**
  * The custom element, as a host sees it.
  *
- * Registered as `cedar-embeddable-editor`. Configuration and the artifact inputs
- * each take one assignment; a second is reported through the event handler and
- * ignored, and the first accepted value stands. An unreadable instance is reported
+ * Registered as `cedar-embeddable-editor`. Configuration takes one assignment, as does
+ * the instance, and so does the template once an instance is loaded against it; a second
+ * is reported through the event handler and ignored, and the first accepted value stands.
+ * A template with no instance behind it may be replaced. An unreadable instance is reported
  * and does not spend its assignment, so the host may correct it. An artifact is a
  * template and optionally an instance, so `templateAndInstanceObject` supplies
  * between them what the two separate inputs do and cannot be combined with either.
@@ -256,7 +273,15 @@ export interface CedarEmbeddableEditorElement extends HTMLElement {
     removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
     /** Configuration. Assign once, before or after the artifact. */
     config: CeeConfig;
-    /** The template to render, as a parsed CEDAR artifact. */
+    /**
+     * The template to render, as a parsed CEDAR artifact.
+     *
+     * Assignable more than once while no instance has been supplied: each one replaces the
+     * form, building a fresh context, so nothing of the previous template survives. Once an
+     * instance is loaded the template is fixed, and a further assignment is reported and
+     * ignored — the answers in front of a person were recorded against the template that
+     * would be taken away.
+     */
     templateObject: CeeJsonObject;
     /**
      * An existing instance to load into the form.