cedar-embeddable-editor 2.0.3 → 2.0.5

package/CHANGELOG.md

@@ -7,6 +7,81 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.5] - 2026-09-03
+
+This release aligns CEE's build-time model dependency with the public
+`cedar-model-typescript-library@1.0.6` package. It also completes a pass over
+the editor's read/write interaction states and the presentation of supplied
+read-only instances.
+
+### Changed
+
+- Compact YAML downloads retain the artifact ID for templates, elements, fields, and instances.
+
+- Read-only instances present recorded values as values rather than editable controls. Multiple
+  selections read as a list, temporal values respect their declared granularity, authority and
+  controlled-term identifiers remain available as links, and multi-instance fields keep their
+  occurrence controls alongside the field heading.
+
+- Field specification text, numeric bounds, field and element identity markers, and the spacing of
+  editable forms are more compact and consistent.
+
+### Fixed
+
+- Loading, clearing, and rejecting an over-limit edit in a multi-select no longer leaves stale
+  selection or validation state, erases an existing answer, or writes while the form is read-only.
+
+- Required checkbox and multi-select fields now report an unanswered value correctly, and checkbox
+  view synchronization no longer mutates the instance.
+
+- Paging, copying, adding, deleting, and emptying repeated fields and attribute-value fields keep
+  the displayed occurrence, cursor, and serialized instance in agreement.
+
+- Temporal fields now preserve the selected year in month pickers, ignore an untouched AM/PM
+  control, restore invalid typed segments on blur, and display unreadable stored values explicitly.
+
+- Controlled-term searches honor value arrangements, distinguish empty and failed result states,
+  recover after an aborted suggestion click, and retain a labelless loaded term by its IRI.
+
+- Authority inputs no longer issue duplicate searches per keystroke and consistently reconcile
+  unselected free text on blur.
+
+## [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
@@ -207,12 +282,12 @@ null` for a literal and `{}` for an IRI — and the compact serialization, the o
   value to show.
 
 - `Compact YAML - Instance` in the download menu writes the model library's
-  compact instance form to `<name>-instance-compact.yaml`, omitting root identity
-  and provenance metadata while retaining the instance data.
+  compact instance form to `<name>-instance-compact.yaml`, retaining root identity
+  and instance data while omitting provenance metadata.
 
 - `Compact YAML - Template` in the download menu writes the model library's
-  compact template form to `<name>-template-compact.yaml`, alongside the full
-  YAML document rather than replacing it.
+  identified compact template form to `<name>-template-compact.yaml`, alongside
+  the full YAML document rather than replacing it.
 
 - `CeeValidationProblem` declares `field` and `inputType`. Every problem has carried both and the
   validation guide documents both, so the one kind of consumer the declarations exist for was the

package/bundle-manifest.json

@@ -4,6 +4,6 @@
     "main.js",
     "polyfills.js"
   ],
-  "bytes": 2183062,
-  "sha256": "b1e86f4a2b94331376a1d9d96af5a20e61dab401b393e116f0c6827b2a7e44a2"
+  "bytes": 2199243,
+  "sha256": "7bf20a4432bb189c3486ce69306c68a6886fa5c8f8ee4c497416b2d5fca1b4b0"
 }

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.