图片与持久媒体

import { createQuireMemoryMediaRepository, type QuireMediaAssetInput, type QuireAssetMediaReference } from "@quirekit/media";
import type { ClassicEditorMediaServices } from "@quirekit/classic-editor";

/**
 * Builds the synchronous working set from bytes restored by the host before mounting.
 * @param restored - Assets fetched with the document's asset manifest.
 * @param allocateId - Host allocator of globally unique persistent IDs, such as server-issued IDs.
 * @returns Classic services and an accepted-asset snapshot for durable storage.
 */
export function createDocumentMedia(restored: readonly QuireMediaAssetInput[], allocateId: () => string) {
  const repository = createQuireMemoryMediaRepository();
  const references = new Map<string, QuireAssetMediaReference>();
  for (const asset of restored) { const reference = repository.put(asset); references.set(reference.assetId, reference); }
  const media: ClassicEditorMediaServices = {
    resolver: repository,
    createAssetId: allocateId,
    sink: {
      /** @param asset - Complete in-memory bytes. @returns Registered reference. */
      put(asset) { const reference = repository.put(asset); references.set(reference.assetId, reference); return reference; },
    },
    registrar: {
      /** @param asset - Provisional authoring bytes. @returns Lease accepting only committed assets into the save manifest. */
      register(asset) {
        const lease = repository.register(asset);
        return {
          reference: lease.reference,
          /** @returns Whether this operation accepted the asset. */
          accept() {
            const accepted = lease.accept();
            if (accepted) references.set(lease.reference.assetId, lease.reference);
            return accepted;
          },
          /** @returns Whether unaccepted new bytes were removed. */
          rollback: () => lease.rollback(),
        };
      },
    },
  };
  return {
    media,
    /** @returns Owned byte copies, including assets retained for undo; not JSON strings or object URLs. */
    snapshotAssets(): readonly QuireMediaAssetInput[] {
      return [...references.values()].map(reference => {
        const asset = repository.resolve(reference)!;
        return { assetId: reference.assetId, kind: asset.kind, bytes: asset.bytes,
          mimeType: asset.mimeType, fileName: asset.fileName, intrinsicSize: asset.intrinsicSize };
      });
    },
  };
}