cedar-embeddable-editor 2.0.28 → 2.0.30

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.30] - 2026-10-27
+
+Aligns with `cedar-model-typescript-library@1.0.25`.
+
+- Adds a `required` setting to the field element's configuration. The aligned model library no longer lets a field written on its own state a requirement, so a host that places the field as required now says so in this setting.
+- Keeps a host page's Material theme from restyling the editor, by binding every Material token CEE reads on its own shadow host.
+- Registers the embedded fonts once in the document head rather than in every shadow root, and compiles the shadow-root stylesheet once rather than into both elements. The production bundle no longer carries the developer app, lodash or the whole `package.json`, and its manifest records the version the bundle reports as `reportedVersion`.
+
+## [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
@@ -213,6 +220,14 @@ CEF then states the type above the description, with the icon its header would h
 drawn (for example, `Paragraph`). A host whose header already shows the type, as CED's
 field cards do, leaves it unset.
 
+A field written on its own is not required, because only a template or an element
+requires the field it places. A host that places the field as required sets
+`required: true`. CEF then marks the field as CEE marks a required one, and reports an
+empty value as missing unless `suppressEmptyFieldErrors` is set. Like every key, it
+takes one assignment, so a change of requirement takes a new element. CEF refuses an
+artifact that states a requirement or a recommendation itself, as both CEDAR model
+libraries do.
+
 Read-only controls have no placeholder text, and fields without constraints draw empty
 boxes. Static fields show their content. A standalone page break is described without
 creating pagination.
@@ -317,7 +332,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 +416,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,7 @@
     "main.js",
     "polyfills.js"
   ],
-  "bytes": 2322399,
-  "sha256": "a4c97b0129740bdb8f8287828bdeab0b449c798f9cb0b5c60744b255414969a6"
+  "bytes": 2236112,
+  "sha256": "3595bcec8380948ece0f2b9d529f265e3be55363f629f9caf556fe63dfdb949e",
+  "reportedVersion": "2.0.30"
 }

package/bundle-manifest.json

@@ -4,6 +4,7 @@
     "main.js",
     "polyfills.js"
   ],
-  "bytes": 2444705,
-  "sha256": "1fdb867309bebd46ae4d7f34d0c741a5737db9f34c4290da1179dba7c83fd90d"
+  "bytes": 2358766,
+  "sha256": "87ec2da47f8efa70bd7d8b7fa8d05a8126ac807a21f878fd098607b0284ce3d6",
+  "reportedVersion": "2.0.30"
 }

package/cedar-embeddable-editor.d.ts

@@ -55,6 +55,15 @@ export interface CeeConfig {
     showFieldType?: boolean;
     /** Keep empty trial fields quiet without changing validity or nonempty-value errors. */
     suppressEmptyFieldErrors?: boolean;
+    /**
+     * For CEF: whether the field is required where the host places it.
+     *
+     * A field written on its own is not required, because only a template or an element requires the
+     * field it places. A host placing the field in a form of its own says so here. CEF then marks the
+     * field as CEE marks a required one, and reports an empty value as missing unless
+     * `suppressEmptyFieldErrors` is set. CEE reads its fields' requirements from the template.
+     */
+    required?: boolean;
     /**
      * Renders the form without editing controls.
      *
@@ -429,15 +438,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;
@@ -526,7 +549,7 @@ export interface CedarEmbeddableFieldChangeDetail {
  * description — settle what an editor draws around a whole form. Field labels and
  * descriptions belong to this element in read-only mode.
  */
-export type CedarEmbeddableFieldConfig = Pick<CeeConfig, 'readOnlyMode' | 'previewMode' | 'showFieldType' | 'suppressEmptyFieldErrors' | 'trustTemplateRichText' | 'terminologyBaseUrl' | 'bridgeBaseUrl' | 'defaultLanguage' | 'fallbackLanguage' | 'languageMapPathPrefix'>;
+export type CedarEmbeddableFieldConfig = Pick<CeeConfig, 'readOnlyMode' | 'previewMode' | 'showFieldType' | 'suppressEmptyFieldErrors' | 'required' | 'trustTemplateRichText' | 'terminologyBaseUrl' | 'bridgeBaseUrl' | 'defaultLanguage' | 'fallbackLanguage' | 'languageMapPathPrefix'>;
 /**
  * One field's control, as a host sees it.
  *
@@ -538,11 +561,12 @@ export type CedarEmbeddableFieldConfig = Pick<CeeConfig, 'readOnlyMode' | 'previ
  * value remains visible and cannot be edited. Static content is also described;
  * a standalone page break has a label and type but does not create pagination.
  *
- * Cardinality belongs to a field's deployment in a template, and this element deploys
- * nothing, so the value it acquires is single. Requiredness is the field's own: an
- * artifact that states `requiredValue: true` has an empty value reported as missing,
- * unless the host sets `suppressEmptyFieldErrors`. CED writes a field on its own with
- * `requiredValue: false`, which is what leaves a default value free to be empty.
+ * Cardinality and requirement belong to a field's placement in a template, and a field
+ * written on its own states neither, so the value this element acquires is single. A
+ * host that places the field as required says so with the `required` configuration
+ * key. Like the rest of the configuration it takes one assignment, so a change of
+ * requirement takes a new element. An artifact that states a requirement or a
+ * recommendation itself is refused, as both CEDAR model libraries refuse one.
  */
 export interface CedarEmbeddableFieldElement extends HTMLElement {
     /** Typed value event; the inherited overloads still handle every other DOM event. */