markstream-angular 0.0.2-beta.10 → 0.0.2-beta.11

package/dist/types/markstream-angular/src/components/InlineCodeNode/InlineCodeNode.component.d.ts

@@ -5,11 +5,13 @@ export declare class InlineCodeNodeComponent implements OnChanges {
     context?: AngularRenderContext;
     indexKey?: string;
     typewriter?: boolean;
+    fade?: boolean;
     settledCode: string;
     streamedDelta: string;
     private streamFadeVersion;
     ngOnChanges(): void;
     get streamedDeltaClass(): "markstream-angular-text__stream-delta--a" | "markstream-angular-text__stream-delta--b";
+    get fadeEnabled(): boolean;
     get typewriterEnabled(): boolean;
     settleStreamedDelta(): void;
 }

package/dist/types/markstream-angular/src/components/NodeRenderer/NodeRenderer.component.d.ts

@@ -1,4 +1,5 @@
 import { AfterViewInit, OnChanges, OnDestroy, OnInit, SimpleChanges, EventEmitter } from '@angular/core';
+import { SmoothMarkdownStreamOptions } from '../../../../markstream-core/src/index.ts';
 import { AngularRenderableNode, AngularRenderContext, CodeBlockPreviewPayload, NodeRendererProps } from '../shared/node-helpers';
 interface VisibleNodeEntry {
     node: AngularRenderableNode;
@@ -10,7 +11,10 @@ interface VisibleNodeEntry {
 export declare class NodeRendererComponent implements NodeRendererProps, OnChanges, OnInit, AfterViewInit, OnDestroy {
     private readonly cdr;
     private readonly hostRef;
+    private readonly smoothStream;
+    private readonly parentSmoothStreamingScope;
     private rootRef?;
+    private typewriterCursorRef?;
     content: string;
     nodes?: readonly AngularRenderableNode[] | null;
     final?: boolean;
@@ -37,7 +41,10 @@ export declare class NodeRendererComponent implements NodeRendererProps, OnChang
     isDark: boolean;
     customId?: string;
     indexKey?: number | string;
+    /** Show a blinking typewriter cursor while streamed content grows. Default: false */
     typewriter: boolean;
+    /** Enable/disable non-code-node enter and streamed-text fade animations. Default: true */
+    fade: boolean;
     batchRendering: boolean;
     initialRenderBatchSize: number;
     renderBatchSize: number;
@@ -48,6 +55,8 @@ export declare class NodeRendererComponent implements NodeRendererProps, OnChang
     maxLiveNodes: number;
     liveNodeBuffer: number;
     allowHtml: boolean;
+    smoothStreaming: boolean | 'auto';
+    smoothStreamingOptions?: SmoothMarkdownStreamOptions;
     copy: EventEmitter<string>;
     handleArtifactClick: EventEmitter<CodeBlockPreviewPayload>;
     click: EventEmitter<MouseEvent>;
@@ -80,7 +89,26 @@ export declare class NodeRendererComponent implements NodeRendererProps, OnChang
     private enhancementHandle;
     private postRenderTimer;
     private unsubscribeCustomComponents?;
+    private isSyncingSmoothStream;
+    private hasMountedForSmoothStreaming;
+    private unsubscribeSmoothStream?;
+    private previousRenderContent;
+    private previousEffectiveFinal;
+    private previousRenderVersionSource;
+    showTypewriterCursor: boolean;
+    private typewriterCursorTimeout;
+    private lastTypewriterContentLength;
+    private static readonly TYPEWRITER_CURSOR_EXCLUDED_NODE_TYPES;
+    get hasNodes(): boolean;
+    get smoothStreamingEligible(): boolean;
+    get smoothStreamingEnabled(): boolean;
+    get renderContent(): string;
+    get rawContent(): string;
+    get smoothSourceSynced(): boolean;
+    get requestedFinal(): boolean | undefined;
+    get effectiveFinal(): boolean | undefined;
     get resolvedIndexPrefix(): string;
+    isSmoothStreamingEnabled(): boolean;
     get resolvedInitialBatchSize(): number;
     get resolvedRenderBatchSize(): number;
     get resolvedMaxLiveNodes(): number;
@@ -99,6 +127,8 @@ export declare class NodeRendererComponent implements NodeRendererProps, OnChang
     entryIndexKey(index: number): string;
     handleMouseOver(event: MouseEvent): void;
     handleMouseOut(event: MouseEvent): void;
+    private ensureSmoothStreamInitialized;
+    private syncSmoothStream;
     private rebuild;
     private cleanupTransientState;
     private trimMeasuredState;
@@ -119,5 +149,13 @@ export declare class NodeRendererComponent implements NodeRendererProps, OnChang
     private scheduleEnhancements;
     private applyEnhancements;
     private disposeEnhancements;
+    private shouldSkipTypewriterCursorForNode;
+    private shouldShowTypewriterCursorForCurrentNodes;
+    private getNodeTextLength;
+    private getTypewriterContentLength;
+    private clearTypewriterCursorTimeout;
+    private getLastTextNode;
+    private updateTypewriterCursorPosition;
+    private updateTypewriterCursorState;
 }
 export {};

package/dist/types/markstream-angular/src/components/TextNode/TextNode.component.d.ts

@@ -5,6 +5,7 @@ export declare class TextNodeComponent implements OnChanges {
     context?: AngularRenderContext;
     indexKey?: string;
     typewriter?: boolean;
+    fade?: boolean;
     settledText: string;
     streamedDelta: string;
     private streamFadeVersion;
@@ -12,6 +13,7 @@ export declare class TextNodeComponent implements OnChanges {
     ngOnChanges(): void;
     get centered(): boolean;
     get streamedDeltaClass(): "markstream-angular-text__stream-delta--a" | "markstream-angular-text__stream-delta--b";
+    get fadeEnabled(): boolean;
     get typewriterEnabled(): boolean;
     settleStreamedDelta(): void;
 }

package/dist/types/markstream-angular/src/components/TextNode/streamingTextState.d.ts

@@ -1,11 +1,2 @@
-export interface ResolveStreamingTextStateOptions {
-    nextContent: string;
-    previousContent: string;
-    typewriterEnabled: boolean;
-}
-export interface StreamingTextStateResult {
-    settledContent: string;
-    streamedDelta: string;
-    appended: boolean;
-}
-export declare function resolveStreamingTextState({ nextContent, previousContent, typewriterEnabled, }: ResolveStreamingTextStateOptions): StreamingTextStateResult;
+export { resolveStreamingTextState } from '../../../../markstream-core/src/index.ts';
+export type { ResolveStreamingTextStateOptions, StreamingTextStateResult } from '../../../../markstream-core/src/index.ts';

package/dist/types/markstream-angular/src/components/shared/node-helpers.d.ts

@@ -1,3 +1,4 @@
+import { SmoothMarkdownStreamOptions } from '../../../../markstream-core/src/index.ts';
 import { BaseNode, HtmlPolicy, MarkdownIt, ParsedNode, ParseOptions, getHtmlTagFromContent, hasCompleteHtmlTagContent, normalizeCustomHtmlTags, normalizeCustomHtmlTagName as normalizeTagName, stripCustomHtmlWrapper } from '../../../../markdown-parser/src/index.ts';
 import { CustomComponentMap } from '../../customComponents';
 import { CodeBlockMonacoOptions, CodeBlockMonacoTheme } from '../../types/monaco';
@@ -98,6 +99,8 @@ export interface NodeRendererProps {
     customId?: string;
     indexKey?: number | string;
     typewriter?: boolean;
+    /** Enable/disable non-code-node enter and streamed-text fade animations. Default: true */
+    fade?: boolean;
     batchRendering?: boolean;
     initialRenderBatchSize?: number;
     renderBatchSize?: number;
@@ -108,6 +111,8 @@ export interface NodeRendererProps {
     maxLiveNodes?: number;
     liveNodeBuffer?: number;
     allowHtml?: boolean;
+    smoothStreaming?: boolean | 'auto';
+    smoothStreamingOptions?: SmoothMarkdownStreamOptions;
 }
 export interface AngularRenderContext {
     customId?: string;
@@ -115,6 +120,7 @@ export interface AngularRenderContext {
     indexKey?: string;
     final?: boolean;
     typewriter?: boolean;
+    fade?: boolean;
     textStreamState?: Map<string, string>;
     streamRenderVersion?: number;
     showTooltips?: boolean;

package/dist/types/markstream-angular/src/components/shared/smooth-streaming-scope.d.ts

@@ -0,0 +1,5 @@
+import { InjectionToken } from '@angular/core';
+export interface SmoothStreamingScope {
+    isSmoothStreamingEnabled: () => boolean;
+}
+export declare const MARKSTREAM_SMOOTH_STREAMING_SCOPE: InjectionToken<SmoothStreamingScope>;

package/dist/types/markstream-angular/src/index.d.ts

@@ -36,6 +36,8 @@ export { ReferenceNodeComponent as ReferenceNode } from './components/ReferenceN
 export type { AngularRenderableNode, AngularRenderContext, CodeBlockPreviewPayload, NodeRendererCodeBlockProps, NodeRendererD2Props, NodeRendererEvents, NodeRendererInfographicProps, NodeRendererMermaidProps, NodeRendererProps, } from './components/shared/node-helpers';
 export { buildRenderContext, resolveParsedNodes, } from './components/shared/node-helpers';
 export { SafeAttrsDirective } from './components/shared/safe-attrs.directive';
+export { MARKSTREAM_SMOOTH_STREAMING_SCOPE } from './components/shared/smooth-streaming-scope';
+export type { SmoothStreamingScope } from './components/shared/smooth-streaming-scope';
 export { StrikethroughNodeComponent as StrikethroughNode } from './components/StrikethroughNode/StrikethroughNode.component';
 export { StrongNodeComponent as StrongNode } from './components/StrongNode/StrongNode.component';
 export { SubscriptNodeComponent as SubscriptNode } from './components/SubscriptNode/SubscriptNode.component';
@@ -64,6 +66,8 @@ export type { NestedMarkdownNodesInput, NestedMarkdownNodesOptions, } from './pa
 export { renderMarkdownNodesToHtml, renderMarkdownNodeToHtml, renderMarkdownToHtml, renderNestedMarkdownToHtml, } from './renderMarkdownHtml';
 export type { MarkstreamAngularRenderOptions, NestedMarkdownHtmlInput, NestedMarkdownHtmlOptions, RenderableMarkdownNode, } from './renderMarkdownHtml';
 export { sanitizeHtmlContent } from './sanitizeHtmlContent';
+export { SmoothMarkdownStreamService } from './services/smooth-markdown-stream.service';
+export type { SmoothMarkdownStreamOptions } from './services/smooth-markdown-stream.service';
 export type { CodeBlockDiffAppearance, CodeBlockDiffHideUnchangedRegions, CodeBlockDiffHideUnchangedRegionsOptions, CodeBlockDiffHunkActionContext, CodeBlockDiffHunkActionKind, CodeBlockDiffHunkSide, CodeBlockDiffLineStyle, CodeBlockDiffUnchangedRegionStyle, CodeBlockMonacoLanguage, CodeBlockMonacoOptions, CodeBlockMonacoTheme, CodeBlockMonacoThemeObject, } from './types/monaco';
 export { getLanguageIcon, languageMap, normalizeLanguageIdentifier, resolveMonacoLanguageId, setLanguageIconResolver, } from './utils/languageIcon';
 export type { LanguageIconResolver } from './utils/languageIcon';

package/dist/types/markstream-angular/src/services/smooth-markdown-stream.service.d.ts

@@ -0,0 +1,33 @@
+import { OnDestroy } from '@angular/core';
+import { SmoothMarkdownStreamOptions } from '../../../markstream-core/src/index.ts';
+export type { SmoothMarkdownStreamOptions };
+export declare class SmoothMarkdownStreamService implements OnDestroy {
+    private controller;
+    private snapshot;
+    private readonly listeners;
+    private unsubscribeFromController?;
+    init(options?: SmoothMarkdownStreamOptions): void;
+    ngOnDestroy(): void;
+    /**
+     * Subscribe to snapshot updates. Called when the controller's visible
+     * content advances during smooth streaming. The listener is invoked
+     * after each snapshot sync so that Angular components can trigger
+     * rebuild / markForCheck.
+     */
+    subscribe(listener: () => void): () => void;
+    get source(): string;
+    get visible(): string;
+    get done(): boolean;
+    get caughtUp(): boolean;
+    get final(): boolean;
+    get pendingChars(): number;
+    enqueue(chunk: string): void;
+    finish(options?: {
+        flush?: boolean;
+    }): void;
+    flush(): void;
+    reset(initialMarkdown?: string): void;
+    pause(): void;
+    resume(): void;
+    private syncSnapshot;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "markstream-angular",
   "type": "module",
-  "version": "0.0.2-beta.10",
+  "version": "0.0.2-beta.11",
   "description": "Experimental Angular Markdown renderer for Markstream, built on stream-markdown AST and a stable HTML baseline renderer.",
   "author": "Simon He",
   "license": "MIT",
@@ -68,7 +68,8 @@
   },
   "dependencies": {
     "@floating-ui/dom": "^1.7.6",
-    "stream-markdown-parser": "0.0.93"
+    "markstream-core": "0.0.1",
+    "stream-markdown-parser": "0.0.95"
   },
   "devDependencies": {
     "@types/node": "^18.19.130",
@@ -78,10 +79,11 @@
     "vite-plugin-dts": "^4.5.4"
   },
   "scripts": {
-    "build": "vite build --mode npm",
+    "build": "pnpm --dir ../markstream-core build && vite build --mode npm",
     "dev": "vite dev",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit",
-    "release": "bumpp --commit --no-tag --no-push && pnpm publish --access public && node ../../scripts/tag-package.mjs --package-json package.json --push"
+    "check:core-published": "node ../../scripts/check-core-published.mjs --package-json package.json --core-package-json ../markstream-core/package.json",
+    "release": "pnpm run check:core-published && bumpp --commit --no-tag --no-push && pnpm publish --access public && node ../../scripts/tag-package.mjs --package-json package.json --push"
   }
 }