@markput/react 0.11.0 → 0.12.0

package/index.d.ts

@@ -1,6 +1,14 @@
+import * as _$react from "react";
 import { CSSProperties, ComponentType, ElementType, ReactNode, Ref, RefObject } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
+//#region src/augment.d.ts
+declare module '@markput/core' {
+  interface SlotRegistry {
+    default: ElementType;
+  }
+} //# sourceMappingURL=augment.d.ts.map
+//#endregion
 //#region ../../core/src/features/parsing/parser/constants.d.ts
 /**
  * Constants for ParserV2 - modern markup parser with nesting support
@@ -10946,10 +10954,10 @@ declare class TextSelectionFeature {
 //#endregion
 //#region ../../core/src/features/slots/types.d.ts
 interface MarkSlot {
-  (): (token: Token) => readonly [unknown, unknown];
+  (): (token: Token) => readonly [Slot, Record<string, unknown>];
 }
 interface OverlaySlot {
-  (): (option?: CoreOption, defaultComponent?: unknown) => readonly [unknown, unknown];
+  (): (option?: CoreOption, defaultComponent?: Slot) => readonly [Slot, Record<string, unknown>];
 }
 //#endregion
 //#region ../../core/src/store/Store.d.ts
@@ -10969,9 +10977,9 @@ declare class Store {
     layout: Signal<"inline" | "block">;
     draggable: Signal<boolean | DraggableConfig>;
     showOverlayOn: Signal<OverlayTrigger>;
-    Span: Signal<unknown>;
-    Mark: Signal<unknown>;
-    Overlay: Signal<unknown>;
+    Span: Signal<_$react.ElementType | undefined>;
+    Mark: Signal<_$react.ElementType | undefined>;
+    Overlay: Signal<_$react.ElementType | undefined>;
     className: Signal<string | undefined>;
     style: Signal<CSSProperties$1 | undefined>;
     slots: Signal<CoreSlots | undefined>;
@@ -10982,6 +10990,8 @@ declare class Store {
     previousValue: Signal<string | undefined>;
     innerValue: Signal<string | undefined>;
     recovery: Signal<Recovery | undefined>;
+    container: Signal<HTMLDivElement | null>;
+    overlay: Signal<HTMLElement | null>;
     selecting: Signal<"drag" | "all" | undefined>;
     overlayMatch: Signal<OverlayMatch | undefined>;
   };
@@ -10991,45 +11001,38 @@ declare class Store {
     isDraggable: Computed<boolean>;
     parser: Computed<Parser | undefined>;
     currentValue: Computed<string>;
-    containerComponent: Computed<unknown>;
+    containerComponent: Computed<Slot>;
     containerProps: Computed<{
       className: string | undefined;
       style?: CSSProperties$1;
       [key: string]: unknown;
     }>;
-    blockComponent: Computed<unknown>;
+    blockComponent: Computed<Slot>;
     blockProps: Computed<Record<string, unknown> | undefined>;
-    spanComponent: Computed<unknown>;
+    spanComponent: Computed<Slot>;
     spanProps: Computed<Record<string, unknown> | undefined>;
     overlay: OverlaySlot;
     mark: MarkSlot;
   };
-  readonly event: {
+  readonly emit: {
     /** Fires after user input or programmatic mark change — triggers serialization, `onChange`, and re-parse */change: Event<void>; /** Triggers a re-parse of tokens from the current content */
-    parse: Event<void>; /** Removes a mark token from editor content */
-    delete: Event<{
+    reparse: Event<void>; /** Removes a mark token from editor content */
+    markRemove: Event<{
       token: Token;
     }>; /** Fires when the user selects an overlay option — annotates markup into the current input span */
-    select: Event<{
+    overlaySelect: Event<{
       mark: Token;
       match: OverlayMatch;
     }>; /** Dismisses the overlay by clearing the current `overlayMatch` */
-    clearOverlay: Event<void>; /** Probes the caret/text position for overlay trigger patterns and shows overlay if matched */
-    checkOverlay: Event<void>; /** Syncs `contentEditable` attributes and `textContent` of child elements to match token state */
-    sync: Event<void>; /** Restores the caret position after a DOM re-render using the saved recovery state */
-    recoverFocus: Event<void>; /** Dispatches drag-mode row operations (reorder, add, delete, duplicate) */
-    dragAction: Event<DragAction>; /** Signals the framework component has received new props — triggers conditional re-parse if value/options changed */
-    updated: Event<void>; /** Fires after the framework has committed new token elements to the DOM — kicks off sync and focus recovery */
-    afterTokensRendered: Event<void>; /** Lifecycle: editor component added to the DOM — enables all features */
+    overlayClose: Event<void>; /** Post-render DOM alignment: aligns `contentEditable` attributes and `textContent` of child elements to token state. Emitted synchronously by `FocusFeature` inside the `rendered` handler (framework layout-effect phase). Load-bearing for post-commit DOM consistency — do not delete without reproducing this timing. */
+    sync: Event<void>; /** Dispatches drag-mode row operations (reorder, add, delete, duplicate) */
+    drag: Event<DragAction>; /** Fires after the framework has committed new token elements to the DOM — kicks off sync and focus recovery */
+    rendered: Event<void>; /** Lifecycle: editor component added to the DOM — enables all features */
     mounted: Event<void>; /** Lifecycle: editor component removed from the DOM — disables all features and cleans up subscriptions */
     unmounted: Event<void>;
   };
-  readonly refs: {
-    container: HTMLDivElement | null;
-    overlay: HTMLElement | null;
-  };
   readonly handler: MarkputHandler;
-  readonly features: {
+  readonly feature: {
     overlay: OverlayFeature;
     focus: FocusFeature;
     input: InputFeature;
@@ -11044,10 +11047,25 @@ declare class Store {
   };
   constructor();
   setProps(values: Partial<SignalValues<typeof this.props>>): void;
-  bumpTokens(): void;
 }
 //#endregion
 //#region ../../core/src/shared/types.d.ts
+/**
+ * Registry interface used as a module-augmentation target. Framework packages
+ * add a `default` property whose type is the framework's component type.
+ *
+ * @example React augmentation
+ * declare module '@markput/core' {
+ *   interface SlotRegistry {
+ *     default: import('react').ElementType
+ *   }
+ * }
+ *
+ * Without augmentation, `Slot` falls back to `unknown`.
+ */
+interface SlotRegistry {}
+/** Framework-provided component type. Resolves to `unknown` unless `SlotRegistry` is augmented. */
+type Slot = keyof SlotRegistry extends never ? unknown : SlotRegistry[keyof SlotRegistry];
 /**
  * Core option for markups - Framework-agnostic configuration.
  * Extended by framework-specific Option types (e.g., React Option).
@@ -11120,9 +11138,9 @@ type OverlayTrigger = Array<'change' | 'selectionChange'> | 'change' | 'selectio
 type CSSProperties$1 = Properties<string | number>;
 type DataAttributes = Record<`data${Capitalize<string>}`, string | number | boolean | undefined>;
 interface CoreSlots {
-  container?: unknown;
-  block?: unknown;
-  span?: unknown;
+  container?: Slot;
+  block?: Slot;
+  span?: Slot;
 }
 interface CoreSlotProps {
   container?: Record<string, unknown> & {
@@ -11156,7 +11174,7 @@ type DragAction = {
   index: number;
 };
 interface DragActions {
-  dragAction: {
+  drag: {
     (action: DragAction): void;
   };
 }