@seedprotocol/sdk 0.7.9-next.1177.ga3e08ed → 0.7.9-next.1189.g5e63267

package/dist/{Item-0oDoTPhi.js → Item-CG5IhPtL.js}

@@ -1,6 +1,6 @@
-import { u as timingNow, v as timingSince, x as timingLogger, y as TAB_ID, o as onTabMessage, c as whenLeaderTab, a as isLeaderTab, k as postTabMessage, f as createSessionObjectUrl, t as timingMarks, z as timed, r as notifyFileSaved, B as revokeSessionObjectUrl, b as watchEntityRows, C as queryEntityRows, D as isSessionObjectUrl, E as timedDb } from './changeFeed-DKdVlUmt.js';
+import { u as timingNow, v as timingSince, x as timingLogger, y as TAB_ID, o as onTabMessage, c as whenLeaderTab, a as isLeaderTab, k as postTabMessage, f as createSessionObjectUrl, t as timingMarks, z as timed, r as notifyFileSaved, B as revokeSessionObjectUrl, b as watchEntityRows, C as queryEntityRows, D as isSessionObjectUrl, E as timedDb } from './changeFeed-M8sGbOrW.js';
 import { waitFor, fromCallback, setup, assign, stateIn, createActor, isMachineSnapshot } from 'xstate';
-import { L as BaseDb, v as versions, m as metadata, s as seeds, N as resolveStorageNameToSchemaName, aY as toSchemaPropertyName, i as isDataType, ad as generateId, C as pendingWrites, ak as isSqliteBusyError, J as schemas, p as models, z as modelSchemas, aW as getOwnedAddressesFromDb, a0 as ZERO_BYTES32, aB as normalizeAddressList, ae as normalizeHexAddress, ax as getAddressesForItemsFilter, a2 as INTERNAL_PROPERTY_NAMES, aZ as easSchemaDefinitionForProperty, Q as BaseFileManager, a_ as getStorageTransactionIdForSeedUid, a$ as convertTxIdToImage, a8 as normalizePublisher, a6 as listRelationEasPropertyName, n as normalizeDataType, U as resolveItemModelFileId, b0 as getPropertyIdForSchemaFileId, S as getPropertyIdForModelAndName, aU as getMetadataPropertyNamesForQuery, aw as ensureImageLocal, ap as ImageSize, b1 as downloadTransactionIdWithDedupe, b2 as resolveMetadataRecord, M as ModelPropertyDataTypes, o as modelUids, af as toMetadataPropertyName, b3 as getDataTypeFromString, b4 as getMimeType, V as INTERNAL_STORAGE_MODEL_FILE_IDS, g as normalizePropertyRecordSchema, b5 as listRelationStoragePropertyName, b6 as PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP, k as getCorrectId, Z as getItemStorageSubdir, _ as getItemStorageLocalFileName, b7 as toItemPropertyKey, b8 as getAlternatePropertyNameForInstanceLookup, E as properties, a3 as isStorageSeedRef } from './index-Dx_GTdyQ.js';
+import { L as BaseDb, v as versions, m as metadata, s as seeds, N as resolveStorageNameToSchemaName, aY as toSchemaPropertyName, i as isDataType, a5 as generateId, C as pendingWrites, al as isSqliteBusyError, J as schemas, p as models, z as modelSchemas, aW as getOwnedAddressesFromDb, ad as ZERO_BYTES32, aC as normalizeAddressList, a6 as normalizeHexAddress, ay as getAddressesForItemsFilter, af as INTERNAL_PROPERTY_NAMES, aZ as easSchemaDefinitionForProperty, Q as BaseFileManager, a_ as getStorageTransactionIdForSeedUid, a$ as convertTxIdToImage, a0 as normalizePublisher, a7 as listRelationEasPropertyName, n as normalizeDataType, U as resolveItemModelFileId, b0 as getPropertyIdForSchemaFileId, S as getPropertyIdForModelAndName, ab as getMetadataPropertyNamesForQuery, ax as ensureImageLocal, aq as ImageSize, b1 as downloadTransactionIdWithDedupe, b2 as resolveMetadataRecord, M as ModelPropertyDataTypes, o as modelUids, a9 as toMetadataPropertyName, b3 as getDataTypeFromString, b4 as getMimeType, V as INTERNAL_STORAGE_MODEL_FILE_IDS, g as normalizePropertyRecordSchema, b5 as listRelationStoragePropertyName, b6 as PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP, k as getCorrectId, Z as getItemStorageSubdir, _ as getItemStorageLocalFileName, b7 as toItemPropertyKey, b8 as getAlternatePropertyNameForInstanceLookup, E as properties, ag as isStorageSeedRef } from './index-rOTW-2QZ.js';
 import { or, isNull, eq, sql, max, count, and, getTableColumns, asc, inArray, lt, isNotNull, desc, gt } from 'drizzle-orm';
 import pluralize from 'pluralize';
 import debug from 'debug';
@@ -437,31 +437,29 @@ var versionData = /*#__PURE__*/Object.freeze({
  * Canonical "latest metadata row first" ordering, the one readers use to pick a property's value
  * from its rows across versions:
  *
- * 1. Live rows (`revoked_at IS NULL`) before revoked ones. A synced row with `revoked_at` set is
- *    kept only because every attestation of that property on its version is revoked (ADR 0006);
- *    it must not hide a live value from another version, but is still the value to show when no
- *    live row is left (an unpublished item keeps its last values). Local drafts (no uid) are live.
- * 2. Newest first: `COALESCE(attestation_created_at, created_at)`.
- * 3. Tie-break on `local_id`, descending.
+ * 1. Newest first: `COALESCE(attestation_created_at, created_at)`. A revoked row counts like any
+ *    other. Sync keeps one attestation per version and property schema (the newest live one, else
+ *    the newest revoked one, ADR 0006), so a revoked row is the newest only when its whole version
+ *    has none live: on a live seed that is a retraction, stored with no value, and an earlier
+ *    version's value must not show through it (ADR 0021); on an unpublished seed every row is
+ *    revoked and keeps its last value.
+ * 2. Tie-break on `local_id`, descending.
  *
  * {@link METADATA_LATEST_FIRST_ORDER_SQL} is the same ordering in SQL. SQL that can't take a
  * fragment (e.g. liveQuery tagged templates, where every interpolation is a bound value) spells it
  * out; keep those in sync.
  */
-const METADATA_LATEST_FIRST_ORDER_SQL = '(revoked_at IS NOT NULL), COALESCE(attestation_created_at, created_at) DESC, local_id DESC';
+const METADATA_LATEST_FIRST_ORDER_SQL = 'COALESCE(attestation_created_at, created_at) DESC, local_id DESC';
 function metadataLatestFirstSortKey(row) {
     return {
-        revoked: row.revokedAt != null,
         t: row.attestationCreatedAt ?? row.createdAt ?? 0,
         localId: String(row.localId ?? ''),
     };
 }
-/** Sort comparator: live before revoked; then larger time first; on tie, larger localId (lexicographic) first. */
+/** Sort comparator: larger time first; on tie, larger localId (lexicographic) first. */
 function compareMetadataRowsLatestFirst(a, b) {
     const ka = metadataLatestFirstSortKey(a);
     const kb = metadataLatestFirstSortKey(b);
-    if (ka.revoked !== kb.revoked)
-        return ka.revoked ? 1 : -1;
     if (kb.t !== ka.t)
         return kb.t - ka.t;
     return kb.localId.localeCompare(ka.localId);
@@ -549,8 +547,16 @@ function metadataValueStrength(row) {
         return 0;
     return String(v).trim().length;
 }
-/** When storage + schema names map to the same key, prefer non-empty, then richer payload, then newer row. */
+/** A `<name>Id` row with no value and no file: a cleared Image, File, Html or Relation (ADR 0021). */
+const isClearedIdRow = (row) => !!row?.propertyName?.endsWith('Id') && row.propertyValue === null && !row.refResolvedValue;
+/**
+ * When storage + schema names map to the same key, prefer non-empty, then richer payload, then newer
+ * row. A cleared Id row newer than the other wins: the other is the value it cleared, or older.
+ */
 function pickBetterMetadataRowForSameInstance(a, b) {
+    const newer = compareMetadataRowsLatestFirst(a, b) < 0 ? a : b;
+    if (isClearedIdRow(newer))
+        return newer;
     const sa = metadataValueStrength(a);
     const sb = metadataValueStrength(b);
     if (sa > 0 && sb === 0)
@@ -594,7 +600,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
         const itemPropertyMod = await Promise.resolve().then(function () { return ItemProperty$1; });
         const { ItemProperty } = itemPropertyMod;
         const { modelPropertiesToObject } = await import('./model-oHA3YhOd.js');
-        const _mod_0 = await import('./errors-D1zHAqjr.js');
+        const _mod_0 = await import('./errors-CS3nDpUU.js');
         const _ns_0 = _mod_0.i;
         const { Model } = _ns_0;
         // Resolve Model and build property schemas (use getByNameAsync for models not yet in cache)
@@ -612,7 +618,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
             const schemaNameToTry = schemaName ?? model?.schemaName;
             if (schemaNameToTry) {
                 try {
-                    const _mod_1 = await import('./Schema-PFZwG9Nl.js');
+                    const _mod_1 = await import('./Schema-BS8oR7QV.js');
                     const _ns_1 = _mod_1.a;
                     const { Schema } = _ns_1;
                     const schemaInstance = Schema.create(schemaNameToTry, { waitForReady: false, hold: false });
@@ -628,7 +634,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
             }
             if (Object.keys(propertySchemas).length === 0) {
                 try {
-                    const _mod_2 = await import('./ClientManager-GZfXErDX.js');
+                    const _mod_2 = await import('./ClientManager-DqL0q_eu.js');
                     const _ns_2 = _mod_2.S;
                     const { loadAllSchemasFromDb } = _ns_2;
                     const allSchemas = await loadAllSchemasFromDb();
@@ -649,10 +655,10 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
             }
             if (Object.keys(propertySchemas).length === 0) {
                 try {
-                    const _mod_3 = await import('./ClientManager-GZfXErDX.js');
+                    const _mod_3 = await import('./ClientManager-DqL0q_eu.js');
                     const _ns_3 = _mod_3.S;
                     const { listCompleteSchemaFiles } = _ns_3;
-                    const _mod_4 = await import('./index-Dx_GTdyQ.js');
+                    const _mod_4 = await import('./index-rOTW-2QZ.js');
                     const _ns_4 = _mod_4.bb;
                     const { BaseFileManager } = _ns_4;
                     const schemaFiles = await listCompleteSchemaFiles();
@@ -673,7 +679,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
                 }
             }
             if (Object.keys(propertySchemas).length === 0) {
-                const schemaMod = await import('./index-DJmWkVIK.js');
+                const schemaMod = await import('./index-DQoyhp2c.js');
                 const { ModelPropertyDataTypes } = schemaMod;
                 const KNOWN_MODEL_FALLBACKS = {
                     Post: {
@@ -690,7 +696,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
             }
         }
         // Fallbacks above may return schema-file shape ({ type, model, items }); normalize to dataType/ref/refValueType.
-        const { normalizePropertyRecordSchema } = await import('./property-BwYtg5Q_.js');
+        const { normalizePropertyRecordSchema } = await import('./property-C85DCD7K.js');
         propertySchemas = Object.fromEntries(Object.entries(propertySchemas).map(([name, def]) => [name, normalizePropertyRecordSchema(def)]));
         // Collapse rows that map to the same instance key (e.g. authorIdentityIds + authors -> authors).
         // ItemProperty.create cache does not sync propertyValue on hit; processing order would otherwise
@@ -723,7 +729,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
                 // Infer propertyRecordSchema from metadata when schema is missing (enables persistence)
                 let propSchema = propertySchemas[propertyName];
                 if (!propSchema && isRefTypeFromMeta) {
-                    const schemaMod = await import('./index-DJmWkVIK.js');
+                    const schemaMod = await import('./index-DQoyhp2c.js');
                     const { ModelPropertyDataTypes } = schemaMod;
                     propSchema = {
                         dataType: refSeedType === 'html' ? ModelPropertyDataTypes.Html
@@ -1727,7 +1733,12 @@ const isItemStorageOp = (value) => typeof value === 'object' && value !== null &
 function overlayOf(op) {
     if (op.kind === 'set') {
         const value = outboxOpValue(op);
-        return value ? { propertyValue: value.newValue ?? null } : undefined;
+        if (!value)
+            return undefined;
+        // A clear drops the file reference too, so the old image doesn't show while the op waits
+        return value.clear
+            ? { propertyValue: null, refSeedType: null, refResolvedValue: null, refResolvedDisplayValue: null, localStorageDir: null }
+            : { propertyValue: value.newValue ?? null };
     }
     const value = outboxOpValue(op);
     if (!value)
@@ -2386,7 +2397,7 @@ const getItemsData = async ({ modelName, modelFileId, schemaName, deleted, inclu
         conditions.push(eq(seeds.type, easName(modelName)));
     }
     if (!modelFileId && schemaName && modelName) {
-        const _mod_5 = await import('./index-Dx_GTdyQ.js');
+        const _mod_5 = await import('./index-rOTW-2QZ.js');
         const _ns_5 = _mod_5.be;
         const { resolveModelRecord } = _ns_5;
         modelFileId = (await resolveModelRecord(modelName, { schemaName }))?.schemaFileId ?? undefined;
@@ -2614,7 +2625,7 @@ const resolveRelatedValue = fromCallback(({ sendBack, input: { context } }) => {
     const { isRelation, propertyValue, propertyName, propertyRecordSchema, populatedFromDb, } = context;
     const _resolveRelatedValue = async () => {
         // Use dynamic import to break circular dependency
-        const schemaMod = await import('./index-DJmWkVIK.js');
+        const schemaMod = await import('./index-DQoyhp2c.js');
         const { ModelPropertyDataTypes } = schemaMod;
         if (!propertyValue || !isRelation || populatedFromDb) {
             return;
@@ -3028,7 +3039,7 @@ const createMetadata = async (metadataValues, propertyRecordSchema, options) =>
         propertyRecordSchema?.validation &&
         metadataValues.propertyValue != null &&
         metadataValues.propertyValue !== '') {
-        const { SchemaValidationService } = await import('./SchemaValidationService-DnGKel4V.js');
+        const { SchemaValidationService } = await import('./SchemaValidationService-CZzKNL04.js');
         const validationService = new SchemaValidationService();
         const validationResult = validationService.validatePropertyValue(metadataValues.propertyValue, normalizeDataType(propertyRecordSchema.dataType), propertyRecordSchema.validation, propertyRecordSchema.refValueType
             ? normalizeDataType(String(propertyRecordSchema.refValueType))
@@ -3236,7 +3247,7 @@ async function readHtmlBodyFromChildStorageArweave(seedLocalId) {
         /* offline / bad tx id */
     }
     try {
-        const _mod_6 = await import('./index-Dx_GTdyQ.js');
+        const _mod_6 = await import('./index-rOTW-2QZ.js');
         const _ns_6 = _mod_6.bg;
         const { downloadTransactionIdWithDedupe } = _ns_6;
         await downloadTransactionIdWithDedupe(txId);
@@ -3297,7 +3308,7 @@ const hydrateFromDb = fromCallback(({ sendBack, input: { context } }) => {
     // to use dynamically imported ModelPropertyDataTypes
     const _hydrateFromDb = async () => {
         // Use dynamic import to break circular dependency
-        const schemaMod = await import('./index-DJmWkVIK.js');
+        const schemaMod = await import('./index-DQoyhp2c.js');
         const { ModelPropertyDataTypes } = schemaMod;
         const appDb = BaseDb.getAppDb();
         const whereClauses = [];
@@ -3345,7 +3356,7 @@ const hydrateFromDb = fromCallback(({ sendBack, input: { context } }) => {
         }
         const stored = rows?.[0] ?? { seedLocalId, seedUid, propertyName };
         const firstRow = pending ? applyPendingRow({ ...stored }, pending) : { ...stored };
-        const _mod_7 = await import('./ClientManager-GZfXErDX.js');
+        const _mod_7 = await import('./ClientManager-DqL0q_eu.js');
         const _ns_7 = _mod_7.U;
         const { getPropertyConflict } = _ns_7;
         const conflict = await getPropertyConflict(firstRow.seedLocalId ?? seedLocalId, propertyName);
@@ -3604,11 +3615,11 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
             const modelNameForNew = context.modelName;
             if (modelNameForNew) {
                 try {
-                    const _mod_8 = await import('./errors-D1zHAqjr.js');
+                    const _mod_8 = await import('./errors-CS3nDpUU.js');
                     const _ns_8 = _mod_8.i;
                     const { Model } = _ns_8;
                     const { modelPropertiesToObject } = await import('./model-oHA3YhOd.js');
-                    const _mod_9 = await import('./index-Dx_GTdyQ.js');
+                    const _mod_9 = await import('./index-rOTW-2QZ.js');
                     const _ns_9 = _mod_9.be;
                     const { resolveItemModelFileId } = _ns_9;
                     const normalizedModelName = upperFirst(camelCase(modelNameForNew));
@@ -3670,7 +3681,7 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
         // It ends up in the context below, and later lookups by name (Model.getByName) can't match it.
         const modelName = context.modelName || (metadataRecord.modelType ? upperFirst(camelCase(metadataRecord.modelType)) : undefined);
         // Model names are only unique per schema: pin lookups to the item's own model row.
-        const _mod_10 = await import('./index-Dx_GTdyQ.js');
+        const _mod_10 = await import('./index-rOTW-2QZ.js');
         const _ns_10 = _mod_10.be;
         const { resolveItemModelFileId } = _ns_10;
         const modelFileId = await resolveItemModelFileId({
@@ -3685,7 +3696,7 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
                 // Normalize snake_case to PascalCase: "test_post" -> "TestPost" (startCase gives "Test Post" which fails)
                 const normalizedModelName = upperFirst(camelCase(modelName));
                 // One read for the whole model, shared by the item's other properties loading now
-                const { loadModelPropertyRecordSchemas } = await import('./modelPropertyRecordSchemas-C5lW9aA-.js');
+                const { loadModelPropertyRecordSchemas } = await import('./modelPropertyRecordSchemas-onFOG2x6.js');
                 const schemas = await loadModelPropertyRecordSchemas(normalizedModelName, modelFileId, db);
                 propertyRecordSchema = schemas.get(propertyName);
                 timing.mark('model schema');
@@ -3698,7 +3709,7 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
         // Fix 1: Fallback to in-memory Model when DB doesn't have model/properties yet (e.g. runtime-created model)
         if (!propertyRecordSchema && modelName) {
             try {
-                const _mod_11 = await import('./errors-D1zHAqjr.js');
+                const _mod_11 = await import('./errors-CS3nDpUU.js');
                 const _ns_11 = _mod_11.i;
                 const { Model } = _ns_11;
                 const { modelPropertiesToObject } = await import('./model-oHA3YhOd.js');
@@ -3869,6 +3880,9 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
             propertyValueOut = parseListPropertyValueFromStorage(propertyValueOut);
             renderValue = propertyValueOut;
         }
+        // A stored row with no value is a cleared property (ADR 0021): send null so the machine drops
+        // what context held (undefined keeps it).
+        const cleared = metadataRecord.propertyValue === null && !metadataRecord.refResolvedValue;
         timing.mark('value');
         timing.log(timingLabel);
         // Return loaded property data (use propertyName from context to match schema key, e.g. "html" not "htmlId")
@@ -3876,8 +3890,8 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
             type: 'loadOrCreatePropertySuccess',
             property: {
                 propertyName,
-                propertyValue: propertyValueOut,
-                renderValue,
+                propertyValue: propertyValueOut ?? (cleared ? null : undefined),
+                renderValue: renderValue ?? (cleared ? null : undefined),
                 seedLocalId: metadataRecord.seedLocalId || seedLocalId,
                 seedUid: metadataRecord.seedUid || seedUid,
                 versionLocalId: metadataRecord.versionLocalId || versionLocalId,
@@ -3889,7 +3903,7 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
                 modelFileId: modelFileId ?? context.modelFileId,
                 propertyRecordSchema,
                 refSeedType: refSeedType ?? context.refSeedType,
-                refResolvedValue: metadataRecord.refResolvedValue ?? context.refResolvedValue,
+                refResolvedValue: metadataRecord.refResolvedValue ?? (cleared ? null : context.refResolvedValue),
                 refResolvedDisplayValue,
                 localStorageDir: metadataRecord.localStorageDir ?? context.localStorageDir ?? (normalizedDataType === 'Image' ? '/images' : undefined),
             },
@@ -3927,13 +3941,14 @@ const getVersionData = async ({ localId, seedLocalId, uid, }, db = BaseDb.getApp
 };
 
 const logger$2 = debug('seedSdk:write:updateItemPropertyValue');
-const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, newValue, seedUid, seedLocalId, modelName, refSeedType, refResolvedValue, refResolvedDisplayValue, versionLocalId, versionUid, schemaUid, localStorageDir, dataType, refValueType, }, options = {}) => {
+const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, newValue, seedUid, seedLocalId, modelName, refSeedType, refResolvedValue, refResolvedDisplayValue, versionLocalId, versionUid, schemaUid, localStorageDir, dataType, refValueType, retract, }, options = {}) => {
     if (!localIdParam && !seedLocalId) {
         logger$2(`[db/write] [updateItemPropertyValue] no propertyLocalId or seedLocalId for property: ${propertyName}`);
         return;
     }
     // Every write below binds parameters: store the value as given (no SQL escaping).
     const safeNewValue = newValue;
+    const retractValue = retract && newValue == null ? true : null;
     const appDb = options.db ?? BaseDb.getAppDb();
     // Path 1: When localId is provided, query by local_id first (avoids property name mismatch)
     let rows;
@@ -3990,14 +4005,15 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
             rows = newestRows;
     }
     if (rows && rows.length > 0) {
-        const { localId, uid, propertyName: propertyNameFromDb, propertyValue: propertyValueFromDb, modelType, seedLocalId: seedLocalIdFromDb, versionLocalId, schemaUid, easDataType, refSeedType: refSeedTypeFromDb, refResolvedValue: refResolvedValueFromDb, } = rows[0];
+        const { localId, uid, propertyName: propertyNameFromDb, propertyValue: propertyValueFromDb, modelType, seedLocalId: seedLocalIdFromDb, versionLocalId, schemaUid, easDataType, refSeedType: refSeedTypeFromDb, refResolvedValue: refResolvedValueFromDb, retract: retractFromDb, } = rows[0];
         // Stored model types are the model's EAS name (ADR 0008): `blog_post` for BlogPost.
         const modelTypeForName = modelName ? easName(modelName) : undefined;
         if (propertyValueFromDb === newValue &&
             modelType === modelTypeForName &&
             // The DB holds null where callers leave a field out (plain values pass no ref fields).
             (refSeedTypeFromDb ?? null) === (refSeedType ?? null) &&
-            (refResolvedValueFromDb ?? null) === (refResolvedValue ?? null)) {
+            (refResolvedValueFromDb ?? null) === (refResolvedValue ?? null) &&
+            !!retractFromDb === !!retractValue) {
             logger$2(`[db/write] [updateItemPropertyValue] value is the same as most recent record for property: ${propertyNameFromDb}`);
             return localId == null ? undefined : { localId, uid: uid ?? null, schemaUid: schemaUid ?? '' };
         }
@@ -4012,6 +4028,7 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
                 refSeedType: refSeedType ?? null,
                 refResolvedValue: refResolvedValue ?? null,
                 refResolvedDisplayValue: refResolvedDisplayValue ?? null,
+                retract: retractValue,
                 // Readers take the newest row by COALESCE(attestation_created_at, created_at), so a draft's
                 // time is when its value was last set: a synced value older than this edit mustn't win.
                 createdAt: now,
@@ -4047,6 +4064,7 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
             refResolvedValue: refResolvedValue || null,
             refResolvedDisplayValue: refResolvedDisplayValue || null,
             localStorageDir: localStorageDir || null,
+            retract: retractValue,
         });
         return {
             localId: newLocalId,
@@ -4084,6 +4102,7 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
         refResolvedValue: refResolvedValue || null,
         refResolvedDisplayValue: refResolvedDisplayValue || null,
         localStorageDir: localStorageDir || null,
+        retract: retractValue,
     });
     return {
         localId: newLocalId,
@@ -4158,7 +4177,7 @@ const analyzeInput = fromCallback(({ sendBack, input: { context, event } }) => {
             const result = await updateItemPropertyValue({ ...props, seedLocalId, propertyName: propertyNameRaw });
             return { skipped: false, result, conflict: null };
         }
-        const { appendOutboxOp, getOutboxOps, outboxOpResult, startItemOutbox, throwItemWriteError, waitForOutboxOp } = await import('./index-CkYb3wcU.js');
+        const { appendOutboxOp, getOutboxOps, outboxOpResult, startItemOutbox, throwItemWriteError, waitForOutboxOp } = await import('./index-njjjo74v.js');
         startItemOutbox();
         // Checked right before appending (no await in between): ops apply in append order
         if (writeTicket && !writeTicket.isLatest())
@@ -4189,13 +4208,43 @@ const analyzeInput = fromCallback(({ sendBack, input: { context, event } }) => {
             return false;
         }
         // Use dynamic import to break circular dependency
-        const schemaMod = await import('./index-DJmWkVIK.js');
+        const schemaMod = await import('./index-DQoyhp2c.js');
         const { ModelPropertyDataTypes } = schemaMod;
-        const { SchemaValidationService } = await import('./SchemaValidationService-DnGKel4V.js');
+        const { SchemaValidationService } = await import('./SchemaValidationService-CZzKNL04.js');
         const propertyName = propertyNameRaw;
         if (!propertyName) {
             throw new Error('propertyName is required');
         }
+        // A clear (ADR 0021): a null value with no file reference, written like a plain value. The old
+        // storage seed and its file stay, as when a value is replaced.
+        if (event?.clear) {
+            const written = await timed(`${label} write`, () => writePlainValue({
+                localId,
+                newValue: null,
+                versionLocalId,
+                versionUid,
+                modelName,
+                schemaUid,
+                dataType: propertyRecordSchema.dataType,
+                refValueType: propertyRecordSchema.refValueType,
+                clear: event.clear,
+            }));
+            if (written.skipped)
+                return true;
+            sendBack({
+                type: 'updateContext',
+                propertyValue: null,
+                renderValue: null,
+                refResolvedValue: undefined,
+                refResolvedDisplayValue: undefined,
+                localStorageDir: undefined,
+                storageTransactionId: undefined,
+                retract: event.clear.retract || undefined,
+                conflict: written.conflict ?? null,
+                ...rowContext(written.result),
+            });
+            return true;
+        }
         if (normalizeDataType(propertyRecordSchema.dataType) === ModelPropertyDataTypes.List &&
             typeof newValue === 'string' &&
             newValue.trim() !== '') {
@@ -4210,6 +4259,26 @@ const analyzeInput = fromCallback(({ sendBack, input: { context, event } }) => {
         }
         const normalizedDataType = normalizeDataType(propertyRecordSchema.dataType);
         const normalizedRefValueType = normalizeDataType(propertyRecordSchema.refValueType);
+        // An empty Image, File or Html value is a clear (ItemProperty.setValue sends one). Refused when
+        // it arrives as a value: saveImage would take '' for the images folder itself.
+        const isStorageSeedValue = normalizedRefValueType === ModelPropertyDataTypes.Image ||
+            normalizedDataType === ModelPropertyDataTypes.Image ||
+            normalizedDataType === ModelPropertyDataTypes.File ||
+            normalizedDataType === ModelPropertyDataTypes.Html;
+        if (isStorageSeedValue && (newValue == null || (typeof newValue === 'string' && newValue.trim() === ''))) {
+            sendBack({
+                type: 'saveValueValidationError',
+                errors: [
+                    {
+                        field: 'value',
+                        message: `${propertyName} can't be saved empty: use clear() to remove a ${propertyRecordSchema.dataType} value`,
+                        code: 'empty_storage_value',
+                        severity: 'error',
+                    },
+                ],
+            });
+            return false;
+        }
         // A Relation with a non-Image refValueType stores the related seed id like any other value,
         // through the write below.
         if (normalizedRefValueType === ModelPropertyDataTypes.Image ||
@@ -4450,7 +4519,7 @@ async function writeStorageValue(item, value, ticket) {
     if (!seedLocalId) {
         throw new Error(`No local seed for the item to save ${item.propertyName} to`);
     }
-    const { appendOutboxOp, getOutboxOps, outboxOpResult, startItemOutbox, throwItemWriteError, waitForOutboxOp } = await import('./index-CkYb3wcU.js');
+    const { appendOutboxOp, getOutboxOps, outboxOpResult, startItemOutbox, throwItemWriteError, waitForOutboxOp } = await import('./index-njjjo74v.js');
     startItemOutbox();
     // Checked right before appending (no await in between): ops apply in append order
     if (ticket && !ticket.isLatest()) {
@@ -4517,7 +4586,11 @@ const saveImage = fromCallback(({ sendBack, input: { context, event } }) => {
         // Check before classifying the string: a filename like "photo.png" also matches the URL regex
         // and would otherwise be fetched relative to the page.
         let isExistingFileReference = false;
-        if (typeof newValue === 'string' && !newValue.includes('/') && !newValue.startsWith('data:')) {
+        // An empty name would check the images folder itself
+        if (typeof newValue === 'string' &&
+            newValue.trim() !== '' &&
+            !newValue.includes('/') &&
+            !newValue.startsWith('data:')) {
             const existingFilePath = BaseFileManager.getFilesPath('images', newValue);
             if (await BaseFileManager.pathExists(existingFilePath)) {
                 isExistingFileReference = true;
@@ -4703,7 +4776,8 @@ async function classifyFileString(value) {
     if (/^(https?:\/\/|blob:)/i.test(value)) {
         return { kind: 'url' };
     }
-    if (!/[\\/]/.test(value) && value.length < 256) {
+    // An empty name would check the files folder itself
+    if (value.trim() !== '' && !/[\\/]/.test(value) && value.length < 256) {
         const existingFilePath = BaseFileManager.getFilesPath('files', value);
         if (await BaseFileManager.pathExists(existingFilePath)) {
             return { kind: 'existing' };
@@ -5137,6 +5211,17 @@ const propertyMachine = setup({
         // stateIn return type does not satisfy setup() inference; runtime guard is correct for root state `idle`.
         propertyMachineIsIdle: stateIn('idle'),
     },
+    actions: {
+        /**
+         * A storage save (Image, File, Html, ItemStorage) failed. Each throws before or during its
+         * write, so nothing was stored: restore the shown value, as saveFailed does.
+         */
+        restoreValueAfterSaveError: assign(({ context, event }) => ({
+            _saveError: toError(event.error),
+            ...(context._valueBeforeSave ?? {}),
+            _valueBeforeSave: undefined,
+        })),
+    },
     actors: {
         waitForDb,
         loadOrCreateProperty,
@@ -5342,9 +5427,7 @@ const propertyMachine = setup({
                         saveImageSuccess: 'doneSaving',
                         saveImageError: {
                             target: 'doneSaving',
-                            actions: assign({
-                                _saveError: ({ event }) => toError(event.error),
-                            }),
+                            actions: 'restoreValueAfterSaveError',
                         },
                     },
                     invoke: {
@@ -5360,9 +5443,7 @@ const propertyMachine = setup({
                         saveFileSuccess: 'doneSaving',
                         saveFileError: {
                             target: 'doneSaving',
-                            actions: assign({
-                                _saveError: ({ event }) => toError(event.error),
-                            }),
+                            actions: 'restoreValueAfterSaveError',
                         },
                     },
                     invoke: {
@@ -5377,9 +5458,7 @@ const propertyMachine = setup({
                         saveHtmlSuccess: 'doneSaving',
                         saveHtmlError: {
                             target: 'doneSaving',
-                            actions: assign({
-                                _saveError: ({ event }) => toError(event.error),
-                            }),
+                            actions: 'restoreValueAfterSaveError',
                         },
                     },
                     invoke: {
@@ -5394,9 +5473,7 @@ const propertyMachine = setup({
                         saveItemStorageSuccess: 'doneSaving',
                         saveItemStorageError: {
                             target: 'doneSaving',
-                            actions: assign({
-                                _saveError: ({ event }) => toError(event.error),
-                            }),
+                            actions: 'restoreValueAfterSaveError',
                         },
                     },
                     invoke: {
@@ -5439,10 +5516,10 @@ const getPropertyData = async ({ propertyName, seedLocalId, seedUid, modelName,
     let names = [...getMetadataPropertyNamesForQuery(propertyName)];
     if (modelName) {
         try {
-            const _mod_12 = await import('./errors-D1zHAqjr.js');
+            const _mod_12 = await import('./errors-CS3nDpUU.js');
             const _ns_12 = _mod_12.i;
             const { Model } = _ns_12;
-            const _mod_13 = await import('./index-Dx_GTdyQ.js');
+            const _mod_13 = await import('./index-rOTW-2QZ.js');
             const _ns_13 = _mod_13.be;
             const { resolveItemModelFileId } = _ns_13;
             // Model names are only unique per schema: use the seed's own model when it is recorded.
@@ -5679,7 +5756,7 @@ const HTML_PROP_SEED_UID_RE = /^0x[a-fA-F0-9]{64}$/;
  */
 const resolvePropertyRecordSchemaFromSchemaData = async (modelName, propertyName, modelType, schemaName) => {
     try {
-        const _mod_14 = await import('./ClientManager-GZfXErDX.js');
+        const _mod_14 = await import('./ClientManager-DqL0q_eu.js');
         const _ns_14 = _mod_14.S;
         const { loadAllSchemasFromDb } = _ns_14;
         const allSchemas = await loadAllSchemasFromDb();
@@ -5733,11 +5810,11 @@ hints = {}) => {
         return undefined;
     }
     try {
-        const _mod_15 = await import('./errors-D1zHAqjr.js');
+        const _mod_15 = await import('./errors-CS3nDpUU.js');
         const _ns_15 = _mod_15.i;
         const { Model } = _ns_15;
         const { modelPropertiesToObject } = await import('./model-oHA3YhOd.js');
-        const _mod_16 = await import('./index-Dx_GTdyQ.js');
+        const _mod_16 = await import('./index-rOTW-2QZ.js');
         const _ns_16 = _mod_16.be;
         const { resolveItemModelFileId } = _ns_16;
         const modelFileId = await resolveItemModelFileId(hints);
@@ -5845,6 +5922,37 @@ class ItemPropertySaveValidationError extends Error {
         this.name = 'ItemPropertySaveValidationError';
     }
 }
+/**
+ * Thrown by ItemProperty.clear() for a Boolean or Date property: their EAS types have no empty value
+ * to attest, so only a retraction can clear one (ADR 0021).
+ */
+class ClearNotSupportedError extends Error {
+    constructor(propertyName, dataType) {
+        super(`${propertyName} can't be cleared: ${dataType} properties have no empty value. Use clear({ retract: true }).`);
+        this.propertyName = propertyName;
+        this.dataType = dataType;
+        this.name = 'ClearNotSupportedError';
+    }
+}
+/** Types whose value is a storage seed: an empty value is a clear, not a value to store. */
+const STORAGE_SEED_TYPES = new Set(['Image', 'File', 'Html']);
+/** What a clear shows at once: no value and no file. */
+const CLEARED_CONTEXT = {
+    propertyValue: null,
+    renderValue: null,
+    refResolvedValue: undefined,
+    refResolvedDisplayValue: undefined,
+    localStorageDir: undefined,
+    storageTransactionId: undefined,
+};
+const snapshotOf = (context) => ({
+    propertyValue: context.propertyValue,
+    renderValue: context.renderValue,
+    refResolvedValue: context.refResolvedValue,
+    refResolvedDisplayValue: context.refResolvedDisplayValue,
+    localStorageDir: context.localStorageDir,
+    storageTransactionId: context.storageTransactionId,
+});
 class ItemProperty {
     constructor(initialValues) {
         this._isRelation = false;
@@ -5935,7 +6043,7 @@ class ItemProperty {
                 return;
             }
             // Use dynamic import to break circular dependency
-            const schemaMod = await import('./index-DJmWkVIK.js');
+            const schemaMod = await import('./index-DQoyhp2c.js');
             const { ModelPropertyDataTypes } = schemaMod;
             const { context } = snapshot;
             const { propertyRecordSchema } = context;
@@ -6152,6 +6260,9 @@ class ItemProperty {
                     }
                     return { refResolvedDisplayValue: undefined };
                 };
+                // A row with no value and no file is a cleared property (ADR 0021), here or synced from
+                // another device: drop the storage transaction id too, or the old file's gateway URL shows.
+                const clearedFromRow = (row) => row.propertyValue == null && !row.refResolvedValue ? { storageTransactionId: undefined } : {};
                 const drizzleMod = await import('drizzle-orm');
                 const { eq, and, or } = drizzleMod;
                 const metadataLatestMod = await Promise.resolve().then(function () { return metadataLatest; });
@@ -6194,6 +6305,7 @@ class ItemProperty {
                         schemaUid: metaRow.schemaUid || undefined,
                         refResolvedValue: metaRow.refResolvedValue || undefined,
                         ...displayValueFromRow(metaRow),
+                        ...clearedFromRow(metaRow),
                         localStorageDir: metaRow.localStorageDir || undefined,
                     });
                 }
@@ -6215,7 +6327,7 @@ class ItemProperty {
                          ref_resolved_value as refResolvedValue, ref_resolved_display_value as refResolvedDisplayValue, local_storage_dir as localStorageDir
                   FROM metadata
                   WHERE seed_uid = ${resolvedSeedUid} AND property_name = ${p0} AND property_name IS NOT NULL
-                  ORDER BY (revoked_at IS NOT NULL), COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
+                  ORDER BY COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
                 `;
                             }
                             if (propertyNames.length === 2) {
@@ -6225,7 +6337,7 @@ class ItemProperty {
                          ref_resolved_value as refResolvedValue, ref_resolved_display_value as refResolvedDisplayValue, local_storage_dir as localStorageDir
                   FROM metadata
                   WHERE seed_uid = ${resolvedSeedUid} AND (property_name = ${p0} OR property_name = ${p1}) AND property_name IS NOT NULL
-                  ORDER BY (revoked_at IS NOT NULL), COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
+                  ORDER BY COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
                 `;
                             }
                             if (propertyNames.length >= 3) {
@@ -6235,7 +6347,7 @@ class ItemProperty {
                          ref_resolved_value as refResolvedValue, ref_resolved_display_value as refResolvedDisplayValue, local_storage_dir as localStorageDir
                   FROM metadata
                   WHERE seed_uid = ${resolvedSeedUid} AND (property_name = ${p0} OR property_name = ${p1} OR property_name = ${p2}) AND property_name IS NOT NULL
-                  ORDER BY (revoked_at IS NOT NULL), COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
+                  ORDER BY COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
                 `;
                             }
                         }
@@ -6247,7 +6359,7 @@ class ItemProperty {
                          ref_resolved_value as refResolvedValue, ref_resolved_display_value as refResolvedDisplayValue, local_storage_dir as localStorageDir
                   FROM metadata
                   WHERE seed_local_id = ${resolvedSeedLocalId} AND property_name = ${p0} AND property_name IS NOT NULL
-                  ORDER BY (revoked_at IS NOT NULL), COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
+                  ORDER BY COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
                 `;
                             }
                             if (propertyNames.length === 2) {
@@ -6257,7 +6369,7 @@ class ItemProperty {
                          ref_resolved_value as refResolvedValue, ref_resolved_display_value as refResolvedDisplayValue, local_storage_dir as localStorageDir
                   FROM metadata
                   WHERE seed_local_id = ${resolvedSeedLocalId} AND (property_name = ${p0} OR property_name = ${p1}) AND property_name IS NOT NULL
-                  ORDER BY (revoked_at IS NOT NULL), COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
+                  ORDER BY COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
                 `;
                             }
                             if (propertyNames.length >= 3) {
@@ -6267,7 +6379,7 @@ class ItemProperty {
                          ref_resolved_value as refResolvedValue, ref_resolved_display_value as refResolvedDisplayValue, local_storage_dir as localStorageDir
                   FROM metadata
                   WHERE seed_local_id = ${resolvedSeedLocalId} AND (property_name = ${p0} OR property_name = ${p1} OR property_name = ${p2}) AND property_name IS NOT NULL
-                  ORDER BY (revoked_at IS NOT NULL), COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
+                  ORDER BY COALESCE(attestation_created_at, created_at) DESC, local_id DESC LIMIT 1
                 `;
                             }
                         }
@@ -6318,6 +6430,7 @@ class ItemProperty {
                             schemaUid: metaRow.schemaUid || undefined,
                             refResolvedValue: metaRow.refResolvedValue || undefined,
                             ...displayValueFromRow(metaRow),
+                            ...clearedFromRow(metaRow),
                             localStorageDir: metaRow.localStorageDir || undefined,
                         });
                     }, {
@@ -6387,7 +6500,7 @@ class ItemProperty {
             const ctx = this._service.getSnapshot().context;
             let modelFileId;
             try {
-                const _mod_17 = await import('./index-Dx_GTdyQ.js');
+                const _mod_17 = await import('./index-rOTW-2QZ.js');
                 const _ns_17 = _mod_17.be;
                 const { resolveItemModelFileId } = _ns_17;
                 modelFileId = await resolveItemModelFileId({
@@ -6738,7 +6851,7 @@ class ItemProperty {
         const propertiesData = await getItemProperties({ seedLocalId, seedUid });
         const instances = [];
         const seenNormalized = new Set();
-        const _mod_18 = await import('./index-Dx_GTdyQ.js');
+        const _mod_18 = await import('./index-rOTW-2QZ.js');
         const _ns_18 = _mod_18.be;
         const { resolveItemModelFileId } = _ns_18;
         const itemModelFileId = await resolveItemModelFileId({ seedLocalId, seedUid });
@@ -6756,7 +6869,7 @@ class ItemProperty {
             }
             else if (baseName) {
                 try {
-                    const _mod_19 = await import('./errors-D1zHAqjr.js');
+                    const _mod_19 = await import('./errors-CS3nDpUU.js');
                     const _ns_19 = _mod_19.i;
                     const { Model } = _ns_19;
                     const { modelPropertiesToObject } = await import('./model-oHA3YhOd.js');
@@ -6773,7 +6886,7 @@ class ItemProperty {
             }
             if (modelName && propertyName) {
                 try {
-                    const _mod_20 = await import('./errors-D1zHAqjr.js');
+                    const _mod_20 = await import('./errors-CS3nDpUU.js');
                     const _ns_20 = _mod_20.i;
                     const { Model } = _ns_20;
                     const { modelPropertiesToObject } = await import('./model-oHA3YhOd.js');
@@ -6976,7 +7089,7 @@ class ItemProperty {
         const { seedLocalId, propertyName } = this._getSnapshotContext();
         if (!seedLocalId || !propertyName)
             return;
-        const { appendOutboxOpAndWait, markPropertyConflictsResolved, startItemOutbox, throwItemWriteError } = await import('./index-CkYb3wcU.js');
+        const { appendOutboxOpAndWait, markPropertyConflictsResolved, startItemOutbox, throwItemWriteError } = await import('./index-njjjo74v.js');
         if (choice === 'remote') {
             startItemOutbox();
             await appendOutboxOpAndWait({
@@ -7025,17 +7138,54 @@ class ItemProperty {
     setValue(value, options = {}) {
         const context = this._getSnapshotContext();
         // Restored if the save is refused (item not owned), breaks a validation rule, or fails.
-        const before = options.before ??
-            this._unsavedBefore ?? { propertyValue: context.propertyValue, renderValue: context.renderValue };
+        const before = options.before ?? this._unsavedBefore ?? snapshotOf(context);
         this._unsavedBefore = undefined;
+        // An empty Image, File or Html value has nothing to store: it clears the property
+        if ((value == null || (typeof value === 'string' && value.trim() === '')) && this._holdsStorageSeed(context)) {
+            this._sendSave(null, before, { retract: false });
+            return;
+        }
+        this._sendSave(value, before);
+    }
+    /**
+     * Clears the value and resolves once it is stored, like `save()` (ADR 0021). A refused or failed
+     * clear restores the value. Publish then attests the property's empty value, so its history shows
+     * the removal and reads of earlier Versions keep the old value.
+     *
+     * @param options.retract - Publish revokes the property's attestations instead, so reads of earlier
+     *   Versions stop showing the value too. Revocation is permanent.
+     * @throws ClearNotSupportedError for a Boolean or Date property without `retract`: their EAS types
+     *   have no empty value.
+     */
+    async clear(options = {}) {
+        const retract = options.retract === true;
+        const context = this._getSnapshotContext();
+        const dataType = normalizeDataType(this._dataType ?? context.propertyRecordSchema?.dataType);
+        if (!retract && (dataType === 'Boolean' || dataType === 'Date')) {
+            throw new ClearNotSupportedError(this.propertyName, dataType);
+        }
+        const before = this._unsavedBefore ?? snapshotOf(context);
+        this._unsavedBefore = undefined;
+        this._sendSave(null, before, { retract });
+        await this.save();
+    }
+    /** An Image, File or Html property, or a Relation to Image: its value is a storage seed. */
+    _holdsStorageSeed(context) {
+        const schema = context.propertyRecordSchema;
+        const dataType = normalizeDataType(this._dataType ?? schema?.dataType);
+        return STORAGE_SEED_TYPES.has(dataType ?? '') || normalizeDataType(schema?.refValueType) === 'Image';
+    }
+    /** Shows `value` at once and sends the save; `clear` shows and saves a cleared value instead. */
+    _sendSave(value, before, clear) {
+        const context = this._getSnapshotContext();
         // Update context immediately so UI shows the value before save completes. A new edit settles
         // the property's conflict (ADR 0019).
         this._service.send({
             type: 'updateContext',
-            propertyValue: value,
-            renderValue: value,
+            ...(clear ? CLEARED_CONTEXT : { propertyValue: value, renderValue: value }),
             conflict: null,
         });
+        const saveEvent = { type: 'save', newValue: value, before, ...(clear && { clear }) };
         // If no propertyRecordSchema, try to resolve from Model before persisting (fixes external app persistence)
         if (!context.propertyRecordSchema) {
             const { modelName, propertyName, modelType, modelFileId, seedLocalId, seedUid, propertyId } = context;
@@ -7048,7 +7198,7 @@ class ItemProperty {
                 if (!schema)
                     return false;
                 this._service.send({ type: 'updateContext', propertyRecordSchema: schema });
-                this._service.send({ type: 'save', newValue: value, before });
+                this._service.send(saveEvent);
                 return true;
             }, () => false);
             this._pendingSchemaSave = pending;
@@ -7058,11 +7208,7 @@ class ItemProperty {
             });
         }
         else {
-            this._service.send({
-                type: 'save',
-                newValue: value,
-                before,
-            });
+            this._service.send(saveEvent);
         }
     }
     /**
@@ -7073,7 +7219,7 @@ class ItemProperty {
     showValue(value) {
         if (!this._unsavedBefore) {
             const context = this._getSnapshotContext();
-            this._unsavedBefore = { propertyValue: context.propertyValue, renderValue: context.renderValue };
+            this._unsavedBefore = snapshotOf(context);
         }
         this._service.send({ type: 'updateContext', propertyValue: value, renderValue: value });
     }
@@ -7223,7 +7369,7 @@ class ItemProperty {
                 if (db && seedLocalId) {
                     // Through the outbox (ADR 0019): after the property's pending edits, which would
                     // otherwise write its rows back
-                    const { appendOutboxOpAndWait, startItemOutbox, throwItemWriteError } = await import('./index-CkYb3wcU.js');
+                    const { appendOutboxOpAndWait, startItemOutbox, throwItemWriteError } = await import('./index-njjjo74v.js');
                     startItemOutbox();
                     await appendOutboxOpAndWait({
                         seedLocalId,
@@ -7233,7 +7379,7 @@ class ItemProperty {
                     }).catch(throwItemWriteError);
                 }
                 else if (db) {
-                    const _mod_21 = await import('./index-PbnKw2es.js');
+                    const _mod_21 = await import('./index-DxHpPNfn.js');
                     const _ns_21 = _mod_21.s;
                     const seedSchemaMod = _ns_21;
                     const { metadata } = seedSchemaMod;
@@ -7266,6 +7412,7 @@ ItemProperty.instanceCache = new Map();
 
 var ItemProperty$1 = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    ClearNotSupportedError: ClearNotSupportedError,
     ItemProperty: ItemProperty,
     ItemPropertySaveValidationError: ItemPropertySaveValidationError
 });
@@ -7283,7 +7430,7 @@ const createNewItem = async ({ modelName, modelFileId, ...propertyData }) => {
     }
     const seedType = easName(modelName);
     // Dynamic import to break circular dependency
-    const _mod_22 = await import('./errors-D1zHAqjr.js');
+    const _mod_22 = await import('./errors-CS3nDpUU.js');
     const _ns_22 = _mod_22.i;
     const modelMod = _ns_22;
     const { Model } = modelMod;
@@ -7339,7 +7486,7 @@ const createNewItem = async ({ modelName, modelFileId, ...propertyData }) => {
             }
             rows.push({ propertyName, propertyValue, propertyRecordSchema, schemaUid: schemaUids.get(propertyName) });
         }
-        const { appendOutboxOpAndWait, startItemOutbox } = await import('./index-CkYb3wcU.js');
+        const { appendOutboxOpAndWait, startItemOutbox } = await import('./index-njjjo74v.js');
         startItemOutbox();
         const fields = await timed(`${label} seed fields`, () => resolveNewSeedFields(seedType));
         const applied = await timed(`${label} outbox apply`, () => appendOutboxOpAndWait({
@@ -7358,7 +7505,7 @@ const createNewItem = async ({ modelName, modelFileId, ...propertyData }) => {
     }
     catch (error) {
         // Staged values of a create that never got appended (once appended, the op's discard does it)
-        const _mod_23 = await import('./ClientManager-GZfXErDX.js');
+        const _mod_23 = await import('./ClientManager-DqL0q_eu.js');
         const _ns_23 = _mod_23.V;
         const { deleteFiles } = _ns_23;
         await deleteFiles(stagedPaths);
@@ -7488,7 +7635,7 @@ const getModel = () => {
         // the fragile `import(...).then(n => n.X)` chunk-namespace pattern.
         if (!modelImportPromise) {
             modelImportPromise = (async () => {
-                const _mod_24 = await import('./errors-D1zHAqjr.js');
+                const _mod_24 = await import('./errors-CS3nDpUU.js');
                 const _ns_24 = _mod_24.i;
                 const mod = _ns_24;
                 ModelClass = mod.Model;
@@ -7627,7 +7774,7 @@ class Item {
          * sync wrote while they were pending (ADR 0019). Each property's is also on `property.conflict`.
          */
         this.conflicts = async () => {
-            const _mod_25 = await import('./ClientManager-GZfXErDX.js');
+            const _mod_25 = await import('./ClientManager-DqL0q_eu.js');
             const _ns_25 = _mod_25.U;
             const { getItemConflicts } = _ns_25;
             return getItemConflicts(this.seedLocalId);
@@ -7722,15 +7869,15 @@ class Item {
         };
         this.getPublishUploads = async (options) => {
             // Use dynamic import to break circular dependency
-            const _mod_26 = await import('./getPublishUploads-BzUIDA2G.js');
+            const _mod_26 = await import('./getPublishUploads-BBqiowVc.js');
             const _ns_26 = _mod_26.o;
             const getPublishUploadsMod = _ns_26;
             const { getPublishUploads } = getPublishUploadsMod;
             return await getPublishUploads(this, [], undefined, options);
         };
         this.getPublishPayload = async (uploadedTransactions, options) => {
-            const _mod_27 = await import('./getPublishPayload-DH4rMqXG.js');
-            const _ns_27 = _mod_27.g;
+            const _mod_27 = await import('./getPublishPayload-pbin4lk8.js');
+            const _ns_27 = _mod_27.c;
             const getPublishPayloadMod = _ns_27;
             const { getPublishPayload } = getPublishPayloadMod;
             return await getPublishPayload(this, uploadedTransactions, options);
@@ -8273,7 +8420,7 @@ class Item {
         const db = BaseDb.getAppDb();
         if (db && props.modelName) {
             // Model names are only unique per schema: resolve the exact models row from the most specific scope.
-            const _mod_28 = await import('./index-Dx_GTdyQ.js');
+            const _mod_28 = await import('./index-rOTW-2QZ.js');
             const _ns_28 = _mod_28.be;
             const { resolveModelRecord } = _ns_28;
             const modelRecord = await resolveModelRecord(props.modelName, {
@@ -8282,7 +8429,7 @@ class Item {
             });
             const modelRecords = modelRecord ? [modelRecord] : [];
             if (!modelRecord) {
-                const _mod_29 = await import('./errors-D1zHAqjr.js');
+                const _mod_29 = await import('./errors-CS3nDpUU.js');
                 const _ns_29 = _mod_29.j;
                 const { UnknownModelError } = _ns_29;
                 throw new UnknownModelError(props.modelName, schemaName ?? modelInstance?.schemaName);
@@ -8293,10 +8440,10 @@ class Item {
             // Scope the constructor's Model lookup to this model's schema (as getItemData does on reload),
             // so a same-named model cached from another schema can't supply the property set.
             if (modelRecord && !props.schemaName) {
-                const _mod_30 = await import('./index-Dx_GTdyQ.js');
+                const _mod_30 = await import('./index-rOTW-2QZ.js');
                 const _ns_30 = _mod_30.bd;
                 const { modelSchemas } = _ns_30;
-                const _mod_31 = await import('./index-Dx_GTdyQ.js');
+                const _mod_31 = await import('./index-rOTW-2QZ.js');
                 const _ns_31 = _mod_31.bc;
                 const { schemas: schemasTable } = _ns_31;
                 const schemaRows = await db
@@ -8400,7 +8547,7 @@ class Item {
             /* best-effort cache cleanup */
         }
         try {
-            const { appendOutboxOpAndWait, deleteFiles, startItemOutbox } = await import('./index-CkYb3wcU.js');
+            const { appendOutboxOpAndWait, deleteFiles, startItemOutbox } = await import('./index-njjjo74v.js');
             startItemOutbox();
             const applied = await appendOutboxOpAndWait({
                 seedLocalId,
@@ -8423,7 +8570,7 @@ class Item {
         for (const [propertyName, value] of pipelineValues) {
             const property = await this.waitForPropertyInstance(item, propertyName, timeout);
             if (!property) {
-                const _mod_32 = await import('./errors-D1zHAqjr.js');
+                const _mod_32 = await import('./errors-CS3nDpUU.js');
                 const _ns_32 = _mod_32.j;
                 const { ItemCreateError } = _ns_32;
                 throw new ItemCreateError(`Item.create: property ${item.modelName}.${propertyName} did not load for item ${item.seedLocalId}; value was not saved`, { code: 'property_not_loaded', modelName: item.modelName, property: propertyName, seedLocalId: item.seedLocalId });
@@ -8435,14 +8582,14 @@ class Item {
             }
             catch (error) {
                 if (error instanceof ItemPropertySaveValidationError) {
-                    const _mod_33 = await import('./errors-D1zHAqjr.js');
+                    const _mod_33 = await import('./errors-CS3nDpUU.js');
                     const _ns_33 = _mod_33.j;
                     const { ItemCreateValidationError } = _ns_33;
                     const created = new ItemCreateValidationError(item.modelName, error.validationErrors.map((e) => ({ property: propertyName, code: e.code, message: e.message })));
                     created.cause = error;
                     throw created;
                 }
-                const _mod_34 = await import('./errors-D1zHAqjr.js');
+                const _mod_34 = await import('./errors-CS3nDpUU.js');
                 const _ns_34 = _mod_34.j;
                 const { ItemCreateError } = _ns_34;
                 throw new ItemCreateError(`Item.create: failed to save ${item.modelName}.${propertyName} for item ${item.seedLocalId}: ` +
@@ -8610,7 +8757,7 @@ class Item {
         if (!appDb || Item.instanceCache.size === 0) {
             return;
         }
-        const _mod_35 = await import('./index-PbnKw2es.js');
+        const _mod_35 = await import('./index-DxHpPNfn.js');
         const _ns_35 = _mod_35.s;
         const { metadata } = _ns_35;
         const { eq, and } = await import('drizzle-orm');
@@ -8744,11 +8891,11 @@ class Item {
     }
     /** Throws ItemCreateValidationError for unknown keys and values that break their property's rules. */
     static async assertValidCreateValues(props, propertyNames, dataTypeByPropertyName, skipKeys) {
-        const _mod_36 = await import('./errors-D1zHAqjr.js');
+        const _mod_36 = await import('./errors-CS3nDpUU.js');
         const _ns_36 = _mod_36.j;
         const { ItemCreateValidationError } = _ns_36;
-        const { getPropertySchema } = await import('./property-BwYtg5Q_.js');
-        const { SchemaValidationService } = await import('./SchemaValidationService-DnGKel4V.js');
+        const { getPropertySchema } = await import('./property-C85DCD7K.js');
+        const { SchemaValidationService } = await import('./SchemaValidationService-CZzKNL04.js');
         const validationService = new SchemaValidationService();
         const modelName = props.modelName;
         const known = new Set(propertyNames);
@@ -8785,7 +8932,7 @@ class Item {
                     // Not JSON: validated as given, and rejected as a non-array
                 }
             }
-            const { resolvePropertyValidationRules } = await import('./propertyValidationRules-CyHdpcPP.js');
+            const { resolvePropertyValidationRules } = await import('./propertyValidationRules-CjUPOFeu.js');
             const rules = propertySchema?.validation ??
                 (await resolvePropertyValidationRules(modelName, key, {
                     modelFileId: props.modelFileId,
@@ -9097,7 +9244,7 @@ class Item {
                 itemActor.send(event);
             };
             try {
-                const _mod_37 = await import('./index-PbnKw2es.js');
+                const _mod_37 = await import('./index-DxHpPNfn.js');
                 const _ns_37 = _mod_37.s;
                 const seedSchemaMod = _ns_37;
                 const { seeds, metadata } = seedSchemaMod;
@@ -9480,7 +9627,7 @@ class Item {
                     return;
                 }
                 // Through the outbox (ADR 0019): after the item's pending edits, not before them
-                const { appendOutboxOpAndWait, startItemOutbox, throwItemWriteError } = await import('./index-CkYb3wcU.js');
+                const { appendOutboxOpAndWait, startItemOutbox, throwItemWriteError } = await import('./index-njjjo74v.js');
                 startItemOutbox();
                 await appendOutboxOpAndWait({
                     seedLocalId: context.seedLocalId,
@@ -9507,5 +9654,5 @@ var Item$1 = /*#__PURE__*/Object.freeze({
     Item: Item
 });
 
-export { getMetadataLatest as $, getItemData as A, waitForEntityIdle as B, compareMetadataRowsLatestFirst as C, getEasSchemaUidForModel as D, getLatestPublishedVersionRow as E, parseListPropertyValueFromStorage as F, chunkValues as G, rowsPerInsert as H, Item as I, getGetAdditionalSyncAddresses as J, isVersionRevoked as K, isActorStopped as L, METADATA_LATEST_FIRST_ORDER_SQL as M, DEFAULT_READY_TIMEOUT_MS as N, OUTBOX_DEFER_MS as O, createReactiveProxy as P, sameEntity as Q, findEntity as R, forceRemoveFromCaches as S, runDestroyLifecycle as T, latestVersionOrder as U, isPublishedMetadataRow as V, ClientManagerState as W, MachineIds as X, PUBLISH_NOT_CONFIGURED_MESSAGE as Y, createNewItem as Z, getGetPublisherForNewSeeds as _, appendOutboxOpAndWait as a, getPublishExecutor as a0, getRevokeExecutor as a1, getUploadExecutor as a2, getVersionData$1 as a3, isLocalUnsealedDraft as a4, isSeedRowOwned as a5, localUnsealedDraftSql as a6, ownedPublisherSql as a7, ownedSeedsSql as a8, pickLatestMetadataRowPerProperty as a9, placeholderUidSql as aa, propertyMachine as ab, publisherInAddressListSql as ac, publisherIsInOwnedSet as ad, setAdditionalSyncAddresses as ae, setGetPublisherForNewSeeds as af, setPublishExecutor as ag, setRevokeExecutor as ah, setUploadExecutor as ai, ActorKeyedState as aj, clearDestroySubscriptions as ak, unloadEntity as al, ClientManagerEvents as am, getSeedPublisher as an, propertyNameVariants as ao, createSeed as ap, createMetadata as aq, updateItemPropertyValue as ar, resolvePublisherFromSeedRow as as, getPropertyData$1 as at, Item$1 as au, waitForOutboxOp as b, appendOutboxOp as c, OUTBOX_MAX_ATTEMPTS as d, OUTBOX_PRUNE_AFTER_MS as e, OUTBOX_PRUNE_FAILED_AFTER_MS as f, getOutboxOps as g, OUTBOX_RETRY_DELAYS_MS as h, OutboxOpDeferredError as i, OutboxOpFailedError as j, OutboxOpRejectedError as k, drainOutbox as l, getPendingSetValue as m, outboxOpValue as n, outboxOpResult as o, pruneOutbox as p, ItemProperty as q, registerOutboxApplier as r, startOutbox as s, ItemPropertySaveValidationError as t, OwnershipError as u, assertItemOwned as v, waitForPendingOutboxOps as w, isItemOwned as x, writeInBatches as y, selectInBatches as z };
-//# sourceMappingURL=Item-0oDoTPhi.js.map
+export { getGetPublisherForNewSeeds as $, getLatestPublishedVersionRow as A, writeInBatches as B, ClearNotSupportedError as C, selectInBatches as D, getItemData as E, waitForEntityIdle as F, chunkValues as G, rowsPerInsert as H, Item as I, getGetAdditionalSyncAddresses as J, getEasSchemaUidForModel as K, parseListPropertyValueFromStorage as L, METADATA_LATEST_FIRST_ORDER_SQL as M, isVersionRevoked as N, OUTBOX_DEFER_MS as O, isActorStopped as P, DEFAULT_READY_TIMEOUT_MS as Q, createReactiveProxy as R, sameEntity as S, findEntity as T, forceRemoveFromCaches as U, runDestroyLifecycle as V, latestVersionOrder as W, ClientManagerState as X, MachineIds as Y, PUBLISH_NOT_CONFIGURED_MESSAGE as Z, createNewItem as _, appendOutboxOpAndWait as a, getMetadataLatest as a0, getPublishExecutor as a1, getRevokeExecutor as a2, getUploadExecutor as a3, getVersionData$1 as a4, isLocalUnsealedDraft as a5, isSeedRowOwned as a6, localUnsealedDraftSql as a7, ownedPublisherSql as a8, ownedSeedsSql as a9, pickLatestMetadataRowPerProperty as aa, placeholderUidSql as ab, propertyMachine as ac, publisherInAddressListSql as ad, publisherIsInOwnedSet as ae, setAdditionalSyncAddresses as af, setGetPublisherForNewSeeds as ag, setPublishExecutor as ah, setRevokeExecutor as ai, setUploadExecutor as aj, ActorKeyedState as ak, clearDestroySubscriptions as al, unloadEntity as am, ClientManagerEvents as an, getSeedPublisher as ao, propertyNameVariants as ap, createSeed as aq, createMetadata as ar, updateItemPropertyValue as as, resolvePublisherFromSeedRow as at, getPropertyData$1 as au, Item$1 as av, waitForOutboxOp as b, appendOutboxOp as c, OUTBOX_MAX_ATTEMPTS as d, OUTBOX_PRUNE_AFTER_MS as e, OUTBOX_PRUNE_FAILED_AFTER_MS as f, getOutboxOps as g, OUTBOX_RETRY_DELAYS_MS as h, OutboxOpDeferredError as i, OutboxOpFailedError as j, OutboxOpRejectedError as k, drainOutbox as l, getPendingSetValue as m, outboxOpValue as n, outboxOpResult as o, pruneOutbox as p, ItemProperty as q, registerOutboxApplier as r, startOutbox as s, ItemPropertySaveValidationError as t, OwnershipError as u, assertItemOwned as v, waitForPendingOutboxOps as w, isItemOwned as x, compareMetadataRowsLatestFirst as y, isPublishedMetadataRow as z };
+//# sourceMappingURL=Item-CG5IhPtL.js.map