@open-press/core 0.7.1 → 1.0.0

package/src/openpress/core/Frame.tsx

@@ -1,18 +1,15 @@
-import { useContext, type ReactNode } from "react";
+import { useContext } from "react";
+import { cn } from "./cn";
 import { FrameContext, type FrameContextValue } from "./FrameContext";
 import { PressContext } from "./Press";
 import type { FrameProps } from "./types";
+import { createFrameObjectEntityId, createPageObjectEntityId, createScopedObjectEntityId } from "../document-model/objectEntityModel";
 
 // Substring reserved for the overflow extension pipeline.
 const RESERVED_EXTENDED = ":extended:";
 
 export const FRAME_MARKER: unique symbol = Symbol.for("@open-press/core:Frame");
 
-function classNames(...values: Array<string | undefined>) {
-  const joined = values.filter(Boolean).join(" ");
-  return joined.length > 0 ? joined : undefined;
-}
-
 export function Frame({
   frameKey,
   role,
@@ -31,37 +28,51 @@ export function Frame({
     );
   }
 
+  const parentFrame = useContext(FrameContext);
   const press = useContext(PressContext);
   const allocation = press?.allocation ?? null;
   const frameAllocation = frameKey && allocation ? allocation[frameKey] : undefined;
+  const pageId = parentFrame?.pageId ?? createPageObjectEntityId(frameKey);
+  const objectId = parentFrame
+    ? createScopedObjectEntityId("frame", parentFrame.objectId, frameKey)
+    : createFrameObjectEntityId(frameKey);
 
   // Mutable per-render counter. SSR renders a Frame exactly once, so a plain
   // object is fine — no useRef needed.
   const areaCounts: Record<string, number> = {};
   const frameContextValue: FrameContextValue = {
     frameKey: frameKey ?? "",
-    consumeArea(chainId: string): ReactNode | null {
+    objectId,
+    pageId,
+    consumeArea(chainId: string) {
       const index = areaCounts[chainId] ?? 0;
       areaCounts[chainId] = index + 1;
-      if (!frameAllocation) return null;
+      if (!frameAllocation) return { indexInFrame: index, blocks: null };
       const chainSlots = frameAllocation[chainId];
-      if (!chainSlots) return null;
-      return chainSlots[index] ?? null;
+      if (!chainSlots) return { indexInFrame: index, blocks: null };
+      return { indexInFrame: index, blocks: chainSlots[index] ?? null };
     },
   };
 
   const pageKind = derivePageKind(role);
+  const isNestedFrame = Boolean(parentFrame);
 
   return (
     <FrameContext.Provider value={frameContextValue}>
       <section
         {...(rest as Record<string, unknown>)}
-        className={classNames("reader-page", className)}
-        data-openpress-frame-key={frameKey}
+        className={cn(isNestedFrame ? undefined : "reader-page", className)}
+        data-openpress-frame-key={isNestedFrame ? undefined : frameKey}
+        data-openpress-region-frame-key={isNestedFrame ? frameKey : undefined}
+        data-openpress-object-id={objectId}
+        data-openpress-object-kind="frame"
+        data-openpress-object-label={role ?? frameKey}
+        data-openpress-object-parent-id={parentFrame?.objectId ?? (isNestedFrame ? undefined : pageId)}
+        data-openpress-object-page-id={pageId}
         data-frame-role={role}
-        data-page-kind={pageKind}
-        data-frame-chrome={chrome ? "true" : "false"}
-        data-page-footer={chrome ? "true" : "false"}
+        data-page-kind={isNestedFrame ? undefined : pageKind}
+        data-frame-chrome={isNestedFrame ? undefined : chrome ? "true" : "false"}
+        data-page-footer={isNestedFrame ? undefined : chrome ? "true" : "false"}
       >
         {children}
       </section>

package/src/openpress/core/FrameContext.tsx

@@ -9,11 +9,18 @@ import { createContext, type ReactNode } from "react";
 // and so on. Empty Frames (no allocation) return null, which renders the
 // MdxArea as a measurement placeholder.
 
+export interface ConsumedMdxArea {
+  indexInFrame: number;
+  // Null when the frame has no allocation (measurement pass) or no blocks
+  // for this chain at the claimed index.
+  blocks: ReactNode | null;
+}
+
 export interface FrameContextValue {
   frameKey: string;
-  // Consume the next allocation slot for this chainId. Returns null if the
-  // frame has no allocation (measurement pass) or no blocks for this chain.
-  consumeArea(chainId: string): ReactNode | null;
+  objectId: string;
+  pageId: string;
+  consumeArea(chainId: string): ConsumedMdxArea;
 }
 
 export const FrameContext = createContext<FrameContextValue | null>(null);

package/src/openpress/core/MdxArea.tsx

@@ -1,11 +1,8 @@
 import { useContext, type ReactNode } from "react";
+import { cn } from "./cn";
 import { FrameContext } from "./FrameContext";
 import type { MdxAreaProps } from "./types";
-
-function classNames(...values: Array<string | undefined>) {
-  const joined = values.filter(Boolean).join(" ");
-  return joined.length > 0 ? joined : undefined;
-}
+import { createMdxAreaObjectEntityId } from "../document-model/objectEntityModel";
 
 export function MdxArea({
   chainId,
@@ -14,20 +11,22 @@ export function MdxArea({
   ...rest
 }: MdxAreaProps) {
   const frame = useContext(FrameContext);
-
-  let blocks: ReactNode | null = null;
-  if (frame) {
-    blocks = frame.consumeArea(chainId);
-  }
+  const consumed = frame?.consumeArea(chainId) ?? null;
+  const blocks: ReactNode | null = consumed?.blocks ?? null;
+  const objectId = frame && consumed
+    ? createMdxAreaObjectEntityId(frame.frameKey, chainId, consumed.indexInFrame)
+    : undefined;
 
   return (
     <div
       {...(rest as Record<string, unknown>)}
-      className={classNames("openpress-mdx-area", className)}
+      className={cn("openpress-mdx-area", className)}
       data-openpress-mdx-area="true"
       data-openpress-mdx-area-chain={chainId}
+      data-openpress-mdx-area-index={consumed?.indexInFrame}
+      data-openpress-object-id={objectId}
       data-openpress-mdx-area-overflow={overflow}
-      data-openpress-mdx-area-empty={blocks == null ? "true" : undefined}
+      data-openpress-mdx-area-empty={blocks == null ? "true" : "false"}
     >
       {blocks}
     </div>

package/src/openpress/core/Press.tsx

@@ -1,5 +1,5 @@
-import { createContext, Fragment, type ReactNode } from "react";
-import type { FrameAllocation, ResolvedSource, TocEntry } from "./types";
+import { createContext, Fragment } from "react";
+import type { FrameAllocation, PressProps, ResolvedSource, TocEntry } from "./types";
 
 // Marker the engine uses to distinguish a Press default export from any other
 // React component. Workspaces register a default export whose `type` is this
@@ -14,6 +14,18 @@ export interface AllocationHints {
   totalPagesPerChain: Record<string, number>;
 }
 
+// Metadata read from <Press> props by the engine pipeline. The 1.0 contract
+// declares these on the component; v0.x reads them from openpress.config.mjs
+// instead and leaves these as undefined. The engine merges both sources
+// (props override config) until v1.0 removes config support.
+export interface PressMetadata {
+  title?: string;
+  page?: PressProps["page"];
+  slug?: string;
+  theme?: string;
+  componentsDir?: string;
+}
+
 export interface PressContextValue {
   sources: Record<string, ResolvedSource>;
   // Allocation map keyed by frameKey -> chainId -> areaIndex -> blocks.
@@ -23,12 +35,21 @@ export interface PressContextValue {
   // the first measurement pass.
   hints: AllocationHints | null;
   toc: Record<string, TocEntry[]> | null;
+  // Metadata declared on <Press> props in v1.0. Engine providers may
+  // omit this on v0.x; consumers should treat undefined as "no metadata
+  // declared on Press — fall back to openpress.config.mjs values".
+  metadata?: PressMetadata;
 }
 
 export const PressContext = createContext<PressContextValue | null>(null);
 
-export function Press({ children }: { children: ReactNode }) {
-  return <Fragment>{children}</Fragment>;
+export function Press(props: PressProps) {
+  // Press is intentionally inert at render time — the engine reads its
+  // props and children through React.Children inspection during the
+  // export pipeline, then injects context above any nested helpers.
+  // For the v0.x shape (children-only usage), this still passes children
+  // through unchanged.
+  return <Fragment>{props.children}</Fragment>;
 }
 
 (Press as unknown as { openpressMarker: typeof PRESS_MARKER }).openpressMarker = PRESS_MARKER;

package/src/openpress/core/Workspace.tsx

@@ -0,0 +1,36 @@
+import { createContext, Fragment } from "react";
+import type { WorkspaceProps } from "./types";
+
+// Marker the engine uses to identify a Workspace default export, in the
+// same way PRESS_MARKER identifies Press. Multi-doc projects nest one
+// or more <Press> children inside <Workspace>; single-doc projects use
+// a Workspace with one Press child (uniform shape — no exceptions).
+export const WORKSPACE_MARKER: unique symbol = Symbol.for("@open-press/core:Workspace");
+
+export interface WorkspaceContextValue {
+  // Project-level label surfaced in the gallery header / tab bar / PDF
+  // metadata. Undefined if the Workspace did not declare a name.
+  name?: string;
+  // Workspace-level shared theme directory. Press children that don't
+  // set their own `theme` prop inherit from this.
+  theme?: string;
+  // Workspace-level shared media directory.
+  media?: string;
+  // Number of Press children registered in this Workspace. Set by the
+  // engine during expansion; useful to detect "gallery vs single-doc"
+  // routing without re-walking the tree.
+  pressCount: number;
+}
+
+export const WorkspaceContext = createContext<WorkspaceContextValue | null>(null);
+
+// Workspace is intentionally inert at render time. The engine inspects
+// its props (name / theme / media) and iterates Press children during
+// the export pipeline; rendering just passes children through so the
+// Press → Frame → MdxArea tree underneath behaves identically to v0.x
+// when there's only one Press child.
+export function Workspace(props: WorkspaceProps) {
+  return <Fragment>{props.children}</Fragment>;
+}
+
+(Workspace as unknown as { openpressMarker: typeof WORKSPACE_MARKER }).openpressMarker = WORKSPACE_MARKER;

package/src/openpress/core/cn.ts

@@ -0,0 +1,4 @@
+export function cn(...values: Array<string | false | null | undefined>) {
+  const joined = values.filter(Boolean).join(" ");
+  return joined.length > 0 ? joined : undefined;
+}

package/src/openpress/core/index.tsx

@@ -6,11 +6,12 @@
 // the engine is not allowed to know about higher-level conventions.
 
 export { Press, PressContext, PRESS_MARKER } from "./Press";
+export { Workspace, WorkspaceContext, WORKSPACE_MARKER } from "./Workspace";
 export { Frame, FRAME_MARKER } from "./Frame";
 export { FrameContext } from "./FrameContext";
 export { MdxArea } from "./MdxArea";
 export { useSource } from "./useSource";
-export { BaseFigure, BaseCallout } from "./primitives";
+export { ObjectEntity, Text, BaseFigure, BaseCallout, MediaFigure, ImageFigure } from "./primitives";
 
 export type {
   FrameProps,
@@ -18,10 +19,16 @@ export type {
   MdxAreaProps,
   MdxAreaOverflow,
   PressProps,
+  PageGeometry,
+  PressSource,
+  WorkspaceProps,
   BaseFigureProps,
+  MediaFigureProps,
   BaseCalloutKind,
   BaseCalloutProps,
-  Manifest,
+  ObjectEntityElement,
+  ObjectEntityProps,
+  TextProps,
   // Source-side types are re-exported here for convenience so authors can
   // import `ResolvedSource` from the same place they import primitives.
   ResolvedSource,
@@ -35,5 +42,6 @@ export type {
   FrameAllocation,
 } from "./types";
 
-export type { PressContextValue, AllocationHints } from "./Press";
+export type { PressContextValue, AllocationHints, PressMetadata } from "./Press";
+export type { WorkspaceContextValue } from "./Workspace";
 export type { FrameContextValue } from "./FrameContext";

package/src/openpress/core/primitives.tsx

@@ -1,13 +1,56 @@
-import type { BaseCalloutProps, BaseFigureProps } from "./types";
+import { cn } from "./cn";
+import { useContext } from "react";
+import { FrameContext } from "./FrameContext";
+import type { BaseCalloutProps, BaseFigureProps, MediaFigureProps, ObjectEntityProps, TextProps } from "./types";
+import { createScopedObjectEntityId } from "../document-model/objectEntityModel";
 
-function classNames(...values: Array<string | undefined>) {
-  const joined = values.filter(Boolean).join(" ");
-  return joined.length > 0 ? joined : undefined;
+export function ObjectEntity({
+  as: Element = "span",
+  objectId,
+  kind,
+  label,
+  parentId,
+  pageId,
+  blockId,
+  frameKey,
+  chainId,
+  source,
+  metadata,
+  children,
+  ...entityProps
+}: ObjectEntityProps) {
+  const frame = useContext(FrameContext);
+  const resolvedParentId = parentId ?? frame?.objectId;
+  const resolvedPageId = pageId ?? frame?.pageId;
+  const resolvedFrameKey = frameKey ?? frame?.frameKey;
+  const resolvedObjectId = createScopedObjectEntityId(kind, resolvedParentId, objectId);
+
+  return (
+    <Element
+      {...entityProps}
+      data-openpress-object-id={resolvedObjectId}
+      data-openpress-object-kind={kind}
+      data-openpress-object-label={label}
+      data-openpress-object-parent-id={resolvedParentId}
+      data-openpress-object-page-id={resolvedPageId}
+      data-openpress-block-id={blockId}
+      data-openpress-object-frame-key={resolvedFrameKey}
+      data-openpress-object-chain-id={chainId}
+      data-openpress-object-source={source ? JSON.stringify(source) : undefined}
+      data-openpress-object-metadata={metadata ? JSON.stringify(metadata) : undefined}
+    >
+      {children}
+    </Element>
+  );
+}
+
+export function Text(props: TextProps) {
+  return <ObjectEntity {...props} kind="text" />;
 }
 
 export function BaseFigure({ caption, className, children, ...figureProps }: BaseFigureProps) {
   return (
-    <figure {...figureProps} className={classNames("openpress-figure", className)}>
+    <figure {...figureProps} className={cn("openpress-figure", className)}>
       <div data-figure-body>{children}</div>
       {caption === undefined ? null : <figcaption>{caption}</figcaption>}
     </figure>
@@ -16,8 +59,33 @@ export function BaseFigure({ caption, className, children, ...figureProps }: Bas
 
 export function BaseCallout({ kind = "info", className, children, ...calloutProps }: BaseCalloutProps) {
   return (
-    <aside {...calloutProps} className={classNames("openpress-callout", className)} data-callout-kind={kind}>
+    <aside {...calloutProps} className={cn("openpress-callout", className)} data-callout-kind={kind}>
       {children}
     </aside>
   );
 }
+
+export function MediaFigure({
+  src,
+  alt,
+  caption,
+  className,
+  imgClassName,
+  loading = "eager",
+  ...figureProps
+}: MediaFigureProps) {
+  return (
+    <BaseFigure {...figureProps} className={cn("openpress-media-figure", className)} caption={caption}>
+      <img src={resolveMediaSrc(src)} alt={alt} loading={loading} className={imgClassName} />
+    </BaseFigure>
+  );
+}
+
+export const ImageFigure = MediaFigure;
+
+function resolveMediaSrc(src: string) {
+  const trimmed = String(src ?? "").trim();
+  if (!trimmed) return "";
+  if (/^(?:[a-z][a-z0-9+.-]*:|\/)/i.test(trimmed)) return trimmed;
+  return `/openpress/media/${trimmed.replace(/^\.?\/*/, "")}`;
+}

package/src/openpress/core/types.ts

@@ -1,4 +1,5 @@
 import type { HTMLAttributes, ReactNode } from "react";
+import type { EditableSourceRef, ObjectEntityKind } from "../document-model/documentTypes";
 
 // ---------------------------------------------------------------------------
 // Frame / MdxArea / Press primitives
@@ -25,8 +26,72 @@ export type MdxAreaProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
   className?: string;
 };
 
+// PageGeometry — a custom fixed-size geometry passed to <Press page>.
+// Same shape as the engine's normalized geometry (CSS lengths,
+// matching units between width / height).
+export interface PageGeometry {
+  id?: string;
+  label?: string;
+  preset?: string;
+  width: string;
+  height: string;
+}
+
+// Source descriptor passed inside <Press sources>. The actual type is
+// the return value of mdxSource() from @open-press/core/mdx; we accept
+// "unknown" at the core boundary to avoid a circular type dependency.
+// The engine validates the shape at render time.
+export type PressSource = unknown;
+
 export interface PressProps {
+  // Document tree — Frames, manuscript helpers, etc.
+  children: ReactNode;
+  // -------------------------------------------------------------------------
+  // 1.0 metadata props — optional during v0.x deprecation, required in v1.0.
+  // -------------------------------------------------------------------------
+  // Document title. Required in 1.0. Used for PDF metadata, HTML <title>,
+  // OG tags, and the Workspace gallery / tab-bar label.
+  title?: string;
+  // Page geometry preset name or a custom geometry object. Optional;
+  // workspace default applies if not set.
+  page?: "a4" | "social-square" | "slide-16-9" | PageGeometry;
+  // Array of source registrations from mdxSource(). Replaces the v0.x
+  // `export const sources` named export.
+  sources?: ReadonlyArray<PressSource>;
+  // URL / output slug for this Press inside a Workspace. Defaults to
+  // "/" when only one Press exists in the Workspace; required when the
+  // Workspace has multiple Press children.
+  slug?: string;
+  // Optional per-Press theme directory. Defaults to "./theme" relative
+  // to the document file; inherits from <Workspace theme> if not set.
+  theme?: string;
+  // Optional per-Press components directory. Default "./components".
+  componentsDir?: string;
+  // Optional caption numbering overrides. Engine defaults to
+  // { figure: "Figure", table: "Table", separator: " " }.
+  captionNumbering?: {
+    figure?: string;
+    table?: string;
+    separator?: string;
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Workspace — root component holding one or more Press children
+// ---------------------------------------------------------------------------
+
+export interface WorkspaceProps {
+  // One or more <Press> children. 1 child = single-doc workspace; N
+  // children = multi-doc workspace (proposal + pitch + social, etc).
   children: ReactNode;
+  // Project label surfaced in the gallery header, tab bar, and PDF
+  // metadata. Optional.
+  name?: string;
+  // Workspace-level shared theme directory. Press children that don't
+  // set their own `theme` prop inherit from this. Default "./theme".
+  theme?: string;
+  // Workspace-level shared media directory. Default "./media".
+  media?: string;
 }
 
 // ---------------------------------------------------------------------------
@@ -38,6 +103,14 @@ export type BaseFigureProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
   children: ReactNode;
 };
 
+export type MediaFigureProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+  src: string;
+  alt: string;
+  caption: ReactNode;
+  imgClassName?: string;
+  loading?: "eager" | "lazy";
+};
+
 export type BaseCalloutKind = "info" | "warn" | "success" | "error" | (string & {});
 
 export type BaseCalloutProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
@@ -45,6 +118,27 @@ export type BaseCalloutProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
   children: ReactNode;
 };
 
+export type ObjectEntityElement = "span" | "div" | "section" | "article" | "figure" | "p";
+
+export type ObjectEntityProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+  as?: ObjectEntityElement;
+  objectId: string;
+  kind: ObjectEntityKind;
+  label: string;
+  parentId?: string;
+  pageId?: string;
+  blockId?: string;
+  frameKey?: string;
+  chainId?: string;
+  source?: EditableSourceRef;
+  metadata?: Record<string, string | number | boolean | null>;
+  children?: ReactNode;
+};
+
+export type TextProps = Omit<ObjectEntityProps, "kind"> & {
+  as?: "span" | "div" | "p";
+};
+
 // ---------------------------------------------------------------------------
 // Source descriptors and resolved sources
 // ---------------------------------------------------------------------------
@@ -140,44 +234,3 @@ export interface ResolvedSource {
 // MdxArea by area index.
 export type FrameAllocation = Record<string, Record<string, ReactNode[]>>;
 
-// ---------------------------------------------------------------------------
-// Manifest
-// ---------------------------------------------------------------------------
-
-export interface Manifest {
-  title: string;
-  subtitle?: string;
-  organization?: string;
-  workspaceLabel?: string;
-  documentDir?: string;
-  sourceDir?: string;
-  componentsDir?: string;
-  mediaDir?: string;
-  themeDir?: string;
-  designDoc?: string;
-  publicDir?: string;
-  outputDir?: string;
-  captionNumbering?: {
-    figure?: string;
-    table?: string;
-    separator?: string;
-  };
-  pdf?: {
-    filename?: string;
-  };
-  deploy?: {
-    adapter?: string;
-    source?: string;
-    projectName?: string | null;
-    commitDirty?: boolean;
-    requiresConfirmation?: boolean;
-  };
-  paths?: {
-    chaptersDir?: string;
-    sourceDir?: string;
-    componentsDir?: string;
-    mediaDir?: string;
-    themeDir?: string;
-    designDoc?: string;
-  };
-}

package/src/openpress/core/useSource.ts

@@ -21,7 +21,7 @@ export function useSource<T extends ResolvedSource = ResolvedSource>(id: string)
     const knownText = known.length > 0 ? known.join(", ") : "(none)";
     throw new Error(
       `Unknown source "${id}". Available sources: ${knownText}. ` +
-        `Register it under \`export const sources\` in document/index.tsx.`,
+        `Register it as a <Press sources={[mdxSource({ id: "${id}", ... })]}> entry in press/index.tsx.`,
     );
   }
   return source as T;

package/src/openpress/{anchorMap.ts → document-model/anchorMapModel.ts}

@@ -3,7 +3,7 @@
 // `PublicPage` / `HtmlWorkbench` HMR-clean (Fast Refresh expects component
 // files to export only components).
 
-import type { DisplayPage } from "./workbenchTypes";
+import type { DisplayPage } from "../reader";
 
 export function createAnchorPageMap(pages: DisplayPage[]) {
   const map = new Map<string, number>();

package/src/openpress/{indexes.ts → document-model/documentIndexes.ts}

@@ -1,4 +1,4 @@
-import type { BlockSource } from "./types";
+import type { BlockSource } from "./documentTypes";
 
 export type MediaAssetKind = "image" | "svg";
 

package/src/openpress/{types.ts → document-model/documentTypes.ts}

@@ -25,6 +25,7 @@ export interface DocumentSource {
   editMode?: string;
   styles?: DocumentStyle[];
   blockMap?: Record<string, SourceBlock>;
+  objectEntities?: Record<string, ObjectEntity>;
 }
 
 export interface DocumentStyle {
@@ -49,6 +50,9 @@ export interface SourceBlock {
   pageIndex?: number;
   pageNumber?: number;
   source?: SourceLocation;
+  frameKey?: string;
+  chainId?: string;
+  sectionSlug?: string;
 }
 
 export interface DocumentMeta {
@@ -61,8 +65,12 @@ export interface DocumentMeta {
 }
 
 export interface Theme {
+  pagePreset?: string;
+  pageLabel?: string;
   pageWidth?: string;
   pageHeight?: string;
+  pageAspectRatio?: string;
+  pageHeightRatio?: string;
   pagePadding?: string;
   fontFamily?: string;
   accentColor?: string;
@@ -93,4 +101,47 @@ export interface HtmlPageBlock {
   anchors?: string[];
   className?: string;
   source?: BlockSource;
+  frameKey?: string;
+  role?: string | null;
+  chrome?: boolean;
+  blockIds?: string[];
+}
+
+export type ObjectEntityKind =
+  | "page"
+  | "frame"
+  | "mdx-area"
+  | "mdx-block"
+  | "text"
+  | "component"
+  | "media";
+
+export interface EditableSourceRef {
+  path: string;
+  file?: string;
+  kind?: string;
+  objectId?: string;
+  scope?: string;
+  component?: string;
+  source?: SourceLocation;
+  line?: number;
+  column?: number;
+}
+
+export interface ObjectEntityRef {
+  id: string;
+  kind: ObjectEntityKind;
+}
+
+export interface ObjectEntity {
+  id: string;
+  kind: ObjectEntityKind;
+  label: string;
+  parentId?: string;
+  pageId?: string;
+  blockId?: string;
+  frameKey?: string;
+  chainId?: string;
+  source?: EditableSourceRef;
+  metadata?: Record<string, string | number | boolean | null>;
 }

package/src/openpress/document-model/index.ts

@@ -0,0 +1,7 @@
+export * from "./anchorMapModel";
+export * from "./documentIndexes";
+export * from "./documentTypes";
+export * from "./objectEntityModel";
+export * from "./projectIdentityModel";
+export * from "./reactDocumentMetadataModel";
+export * from "./workspaceManifestModel";