cedar-embeddable-editor 2.0.28 → 2.0.29

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.29] - 2026-10-26
+
+Aligns with `cedar-model-typescript-library@1.0.24`.
+
+- Allows Save exactly when the CEDAR server would store the instance, judging it against the stored template as the export writes it, and keeps an instance's `@type` through a save.
+
 ## [2.0.28] - 2026-10-21
 
 Aligns with `cedar-model-typescript-library@1.0.23`.

package/README.md

@@ -117,7 +117,14 @@ service URLs are needed only for controlled-term and external-authority lookups.
 
 Read the record back from `currentMetadata` as CEDAR JSON-LD, or from
 `currentMetadataYaml` as YAML. The CEE neither submits nor stores it. The host
-decides when and where a record is saved.
+decides when and where a record is saved. `currentMetadataYaml` is the empty
+string when no YAML can be written: while the instance input is rejected, or
+while the instance names no template or has no name, as one from an unsaved
+template does. `currentMetadata` is likewise the empty object while the instance
+input is rejected or the instance names no template. The form from an unsaved
+template is shown all the same, so a host that reads an empty `currentMetadata`
+as a refusal assigns only a template that has an identifier. For an instance
+that names no template, `captureDraft()` and `captureSave()` return `null`.
 
 For recovery across reloads, `captureDraft()` returns a JSON-serializable recovery document
 containing the template, accepted metadata and unfinished field input. This is **not** a
@@ -317,7 +324,7 @@ npm run build:production
 npm run test:visual:prebuilt
 ```
 
-Use Node 24.22.0, which `.nvmrc`, `package.json` and CI all specify. The build and
+Use Node 24.22.1, which `.nvmrc`, `package.json` and CI all specify. The build and
 tests use that same version, so the distribution is produced by the toolchain
 that exercises it.
 
@@ -401,7 +408,7 @@ The visual suite installs nothing here. It runs inside Playwright's own containe
 which carries the browsers it drives, and installs its dependencies there against a
 named volume — so it needs Docker running and no `playwright install` of its own.
 
-The CEE uses Angular 22.2 and Node 24.22.0. `.nvmrc`, the package `engines` field and
+The CEE uses Angular 22.2 and Node 24.22.1. `.nvmrc`, the package `engines` field and
 CI specify the Node version.
 
 The application bundle and the visual fixture generator each install the model

package/bundle-manifest.host-fonts.json

@@ -4,6 +4,6 @@
     "main.js",
     "polyfills.js"
   ],
-  "bytes": 2322399,
-  "sha256": "a4c97b0129740bdb8f8287828bdeab0b449c798f9cb0b5c60744b255414969a6"
+  "bytes": 2355685,
+  "sha256": "7fc9a98446692f4ed154ba514ccf5d76a91fbd0ac2d1620300df216ea1dbde84"
 }

package/bundle-manifest.json

@@ -4,6 +4,6 @@
     "main.js",
     "polyfills.js"
   ],
-  "bytes": 2444705,
-  "sha256": "1fdb867309bebd46ae4d7f34d0c741a5737db9f34c4290da1179dba7c83fd90d"
+  "bytes": 2477991,
+  "sha256": "ff95b623a32bb05593f6297063a4ea3f0957bdd1450db3a4f091b5ff90cff0f8"
 }

package/cedar-embeddable-editor.d.ts

@@ -429,15 +429,29 @@ export interface CedarEmbeddableEditorElement extends HTMLElement {
      * after the assignment as a refusal. An instance assigned on its own is held while it waits for a
      * template, so a template refused after it leaves this holding the instance. The refusal's reason
      * goes to the event handler's `error`.
+     *
+     * It is also an empty object while the instance names no template, as one from an unsaved template
+     * does, since no JSON can be written for it. The form is shown all the same, so a host that reads an
+     * empty object as a refusal assigns only a template that has an identifier.
      */
     readonly currentMetadata: CeeJsonObject;
-    /** Capture immediately before saving. Null while no readable form is loaded. */
+    /**
+     * Capture immediately before saving. Null while no readable form is loaded, and while the instance
+     * names no template, as one from an unsaved template does, since no repository stores it.
+     */
     readonly captureSave: () => CeeSaveSnapshot | null;
-    /** Captures accepted values and unfinished input, independently of validity. */
+    /**
+     * Captures accepted values and unfinished input, independently of validity. Null while no readable
+     * form is loaded, and while the instance names no template, since no metadata can be written for it.
+     */
     readonly captureDraft: () => CeeRecoveryDraft | null;
     /** Restore into a fresh element; rejects incompatible or malformed data atomically. */
     readonly restoreDraft: (draft: CeeRecoveryDraft) => boolean;
-    /** The instance as CEDAR YAML. Read-only. */
+    /**
+     * The instance as CEDAR YAML. Read-only. The empty string when no YAML can be written: while the
+     * instance input is rejected, or while the instance names no template or has no name, as one from
+     * an unsaved template does.
+     */
     readonly currentMetadataYaml: string;
     /** What CEE thinks of the instance. Read-only. */
     readonly dataQualityReport: CeeDataQualityReport;