@kedataindo/docflow-core 0.0.61 → 0.0.63

package/dist/ai/index.d.cts

@@ -1 +1 @@
-export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, a as AIDraftFn, h as AIProvider, A as AIStreamFn, j as Auth, k as CONTEXT_CHAR_CAP, l as CslDate, m as CslItemData, n as CslName, H as HttpKeyStorageUrls, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, p as buildAIPrompt, q as httpKeyStorage, r as localStorageKeyStorage, s as memoryKeyStorage, t as openaiCompatibleProvider, u as toAIStreamFn, v as trimContextAfter, w as trimContextBefore } from '../index-BsIFJXPk.cjs';
+export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIContextLocation, g as AIDraftCitation, h as AIDraftEvent, a as AIDraftFn, i as AIProvider, A as AIStreamFn, k as AiChatRequestContext, l as Auth, m as CONTEXT_CHAR_CAP, n as CslDate, o as CslItemData, p as CslName, H as HttpKeyStorageUrls, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, r as buildAIPrompt, s as httpKeyStorage, t as localStorageKeyStorage, u as memoryKeyStorage, v as openaiCompatibleProvider, w as toAIStreamFn, x as trimContextAfter, y as trimContextBefore } from '../index-CDULnDYX.cjs';

package/dist/ai/index.d.ts

@@ -1 +1 @@
-export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, a as AIDraftFn, h as AIProvider, A as AIStreamFn, j as Auth, k as CONTEXT_CHAR_CAP, l as CslDate, m as CslItemData, n as CslName, H as HttpKeyStorageUrls, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, p as buildAIPrompt, q as httpKeyStorage, r as localStorageKeyStorage, s as memoryKeyStorage, t as openaiCompatibleProvider, u as toAIStreamFn, v as trimContextAfter, w as trimContextBefore } from '../index-BsIFJXPk.js';
+export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIContextLocation, g as AIDraftCitation, h as AIDraftEvent, a as AIDraftFn, i as AIProvider, A as AIStreamFn, k as AiChatRequestContext, l as Auth, m as CONTEXT_CHAR_CAP, n as CslDate, o as CslItemData, p as CslName, H as HttpKeyStorageUrls, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, r as buildAIPrompt, s as httpKeyStorage, t as localStorageKeyStorage, u as memoryKeyStorage, v as openaiCompatibleProvider, w as toAIStreamFn, x as trimContextAfter, y as trimContextBefore } from '../index-CDULnDYX.js';

package/dist/{index-BsIFJXPk.d.cts → index-CDULnDYX.d.cts}

@@ -45,6 +45,36 @@ type AIProviderFactory = (config: {
     signal?: AbortSignal;
 }) => AIProvider;
 type AIAction = 'rewrite' | 'summarize' | 'grammar' | 'tone' | 'translate' | 'expand' | 'shorten' | 'generate' | 'chat' | 'draft';
+/**
+ * Location context of the selection/cursor sent alongside the request so the
+ * LLM can reason about *where* in the document the user is pointing. All fields
+ * optional — hosts that don't fill them keep working unchanged (issue #219).
+ */
+interface AIContextLocation {
+    /** 1-based page number containing the selection head (DOM pagination). */
+    page?: number;
+    /** Total pages in the document (DOM pagination). */
+    pageCount?: number;
+    /** 1-based paragraph/block index within the document. */
+    paragraphIndex?: number;
+    /** 1-based line number of the selection head within its block. */
+    line?: number;
+    /** Node type of the block under the selection, e.g. 'paragraph' | 'heading' | 'bulletList' | 'tableRow'. */
+    blockType?: string;
+    /** Nearest preceding heading text (BAB/section context), e.g. 'BAB II …'. */
+    section?: string;
+}
+/**
+ * Payload for the host's AI-chat hook (issue #219). Carries the selected text
+ * (if any) plus the cursor/selection location so a host with its OWN chat panel
+ * can pre-fill the prompt with context — without re-reading editor state.
+ */
+interface AiChatRequestContext {
+    /** Selected text, when the selection is not empty. */
+    selection?: string;
+    /** Location of the selection/cursor (page, paragraph, line, section…). */
+    context: AIContextLocation;
+}
 interface AIActionRequest {
     action: AIAction;
     /** Selected text (7B). */
@@ -53,7 +83,7 @@ interface AIActionRequest {
     context?: {
         before: string;
         after: string;
-    };
+    } & AIContextLocation;
     /** User instruction (/ai prompt, chat message, tone target, target language). */
     prompt?: string;
     /** For doc-aware chat / RAG scoping. */
@@ -99,7 +129,7 @@ type AIDraftFn = (req: {
     context?: {
         before: string;
         after: string;
-    };
+    } & AIContextLocation;
     k?: number;
 }, signal: AbortSignal) => AsyncIterable<AIDraftEvent>;
 
@@ -310,4 +340,4 @@ interface OpenAICompatibleConfig {
 }
 declare function openaiCompatibleProvider(config: OpenAICompatibleConfig): AIProvider;
 
-export { type AIStreamFn as A, type CitationPort as C, type HttpKeyStorageUrls as H, type ImageUploadHandler as I, type KeyStorage as K, LOCAL_STORAGE_KEY as L, type OpenAICompatibleConfig as O, type StreamEvent as S, type AIDraftFn as a, type AIAction as b, type AIActionRequest as c, type AICompleteRequest as d, type AIConfig as e, type AIDraftCitation as f, type AIDraftEvent as g, type AIProvider as h, type AIProviderFactory as i, type Auth as j, CONTEXT_CHAR_CAP as k, type CslDate as l, type CslItemData as m, type CslName as n, type ImageUploadResult as o, buildAIPrompt as p, httpKeyStorage as q, localStorageKeyStorage as r, memoryKeyStorage as s, openaiCompatibleProvider as t, toAIStreamFn as u, trimContextAfter as v, trimContextBefore as w };
+export { type AIStreamFn as A, type CitationPort as C, type HttpKeyStorageUrls as H, type ImageUploadHandler as I, type KeyStorage as K, LOCAL_STORAGE_KEY as L, type OpenAICompatibleConfig as O, type StreamEvent as S, type AIDraftFn as a, type AIAction as b, type AIActionRequest as c, type AICompleteRequest as d, type AIConfig as e, type AIContextLocation as f, type AIDraftCitation as g, type AIDraftEvent as h, type AIProvider as i, type AIProviderFactory as j, type AiChatRequestContext as k, type Auth as l, CONTEXT_CHAR_CAP as m, type CslDate as n, type CslItemData as o, type CslName as p, type ImageUploadResult as q, buildAIPrompt as r, httpKeyStorage as s, localStorageKeyStorage as t, memoryKeyStorage as u, openaiCompatibleProvider as v, toAIStreamFn as w, trimContextAfter as x, trimContextBefore as y };

package/dist/{index-BsIFJXPk.d.ts → index-CDULnDYX.d.ts}

@@ -45,6 +45,36 @@ type AIProviderFactory = (config: {
     signal?: AbortSignal;
 }) => AIProvider;
 type AIAction = 'rewrite' | 'summarize' | 'grammar' | 'tone' | 'translate' | 'expand' | 'shorten' | 'generate' | 'chat' | 'draft';
+/**
+ * Location context of the selection/cursor sent alongside the request so the
+ * LLM can reason about *where* in the document the user is pointing. All fields
+ * optional — hosts that don't fill them keep working unchanged (issue #219).
+ */
+interface AIContextLocation {
+    /** 1-based page number containing the selection head (DOM pagination). */
+    page?: number;
+    /** Total pages in the document (DOM pagination). */
+    pageCount?: number;
+    /** 1-based paragraph/block index within the document. */
+    paragraphIndex?: number;
+    /** 1-based line number of the selection head within its block. */
+    line?: number;
+    /** Node type of the block under the selection, e.g. 'paragraph' | 'heading' | 'bulletList' | 'tableRow'. */
+    blockType?: string;
+    /** Nearest preceding heading text (BAB/section context), e.g. 'BAB II …'. */
+    section?: string;
+}
+/**
+ * Payload for the host's AI-chat hook (issue #219). Carries the selected text
+ * (if any) plus the cursor/selection location so a host with its OWN chat panel
+ * can pre-fill the prompt with context — without re-reading editor state.
+ */
+interface AiChatRequestContext {
+    /** Selected text, when the selection is not empty. */
+    selection?: string;
+    /** Location of the selection/cursor (page, paragraph, line, section…). */
+    context: AIContextLocation;
+}
 interface AIActionRequest {
     action: AIAction;
     /** Selected text (7B). */
@@ -53,7 +83,7 @@ interface AIActionRequest {
     context?: {
         before: string;
         after: string;
-    };
+    } & AIContextLocation;
     /** User instruction (/ai prompt, chat message, tone target, target language). */
     prompt?: string;
     /** For doc-aware chat / RAG scoping. */
@@ -99,7 +129,7 @@ type AIDraftFn = (req: {
     context?: {
         before: string;
         after: string;
-    };
+    } & AIContextLocation;
     k?: number;
 }, signal: AbortSignal) => AsyncIterable<AIDraftEvent>;
 
@@ -310,4 +340,4 @@ interface OpenAICompatibleConfig {
 }
 declare function openaiCompatibleProvider(config: OpenAICompatibleConfig): AIProvider;
 
-export { type AIStreamFn as A, type CitationPort as C, type HttpKeyStorageUrls as H, type ImageUploadHandler as I, type KeyStorage as K, LOCAL_STORAGE_KEY as L, type OpenAICompatibleConfig as O, type StreamEvent as S, type AIDraftFn as a, type AIAction as b, type AIActionRequest as c, type AICompleteRequest as d, type AIConfig as e, type AIDraftCitation as f, type AIDraftEvent as g, type AIProvider as h, type AIProviderFactory as i, type Auth as j, CONTEXT_CHAR_CAP as k, type CslDate as l, type CslItemData as m, type CslName as n, type ImageUploadResult as o, buildAIPrompt as p, httpKeyStorage as q, localStorageKeyStorage as r, memoryKeyStorage as s, openaiCompatibleProvider as t, toAIStreamFn as u, trimContextAfter as v, trimContextBefore as w };
+export { type AIStreamFn as A, type CitationPort as C, type HttpKeyStorageUrls as H, type ImageUploadHandler as I, type KeyStorage as K, LOCAL_STORAGE_KEY as L, type OpenAICompatibleConfig as O, type StreamEvent as S, type AIDraftFn as a, type AIAction as b, type AIActionRequest as c, type AICompleteRequest as d, type AIConfig as e, type AIContextLocation as f, type AIDraftCitation as g, type AIDraftEvent as h, type AIProvider as i, type AIProviderFactory as j, type AiChatRequestContext as k, type Auth as l, CONTEXT_CHAR_CAP as m, type CslDate as n, type CslItemData as o, type CslName as p, type ImageUploadResult as q, buildAIPrompt as r, httpKeyStorage as s, localStorageKeyStorage as t, memoryKeyStorage as u, openaiCompatibleProvider as v, toAIStreamFn as w, trimContextAfter as x, trimContextBefore as y };

package/dist/index.d.cts

@@ -4,8 +4,8 @@ import { IndexeddbPersistence } from 'y-indexeddb';
 import { WebrtcProvider } from 'y-webrtc';
 import { WebsocketProvider } from 'y-websocket';
 import * as Y from 'yjs';
-import { I as ImageUploadHandler, C as CitationPort, A as AIStreamFn, a as AIDraftFn } from './index-BsIFJXPk.cjs';
-export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, h as AIProvider, i as AIProviderFactory, j as Auth, k as CONTEXT_CHAR_CAP, l as CslDate, m as CslItemData, n as CslName, H as HttpKeyStorageUrls, o as ImageUploadResult, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, p as buildAIPrompt, q as httpKeyStorage, r as localStorageKeyStorage, s as memoryKeyStorage, t as openaiCompatibleProvider, u as toAIStreamFn, v as trimContextAfter, w as trimContextBefore } from './index-BsIFJXPk.cjs';
+import { I as ImageUploadHandler, C as CitationPort, A as AIStreamFn, a as AIDraftFn } from './index-CDULnDYX.cjs';
+export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIContextLocation, g as AIDraftCitation, h as AIDraftEvent, i as AIProvider, j as AIProviderFactory, k as AiChatRequestContext, l as Auth, m as CONTEXT_CHAR_CAP, n as CslDate, o as CslItemData, p as CslName, H as HttpKeyStorageUrls, q as ImageUploadResult, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, r as buildAIPrompt, s as httpKeyStorage, t as localStorageKeyStorage, u as memoryKeyStorage, v as openaiCompatibleProvider, w as toAIStreamFn, x as trimContextAfter, y as trimContextBefore } from './index-CDULnDYX.cjs';
 import { PaginationPlusOptions } from 'tiptap-pagination-plus';
 export { PAGE_SIZES, PageSize, PaginationPlus, PaginationPlusOptions } from 'tiptap-pagination-plus';
 import { PluginKey } from '@tiptap/pm/state';

package/dist/index.d.ts

@@ -4,8 +4,8 @@ import { IndexeddbPersistence } from 'y-indexeddb';
 import { WebrtcProvider } from 'y-webrtc';
 import { WebsocketProvider } from 'y-websocket';
 import * as Y from 'yjs';
-import { I as ImageUploadHandler, C as CitationPort, A as AIStreamFn, a as AIDraftFn } from './index-BsIFJXPk.js';
-export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, h as AIProvider, i as AIProviderFactory, j as Auth, k as CONTEXT_CHAR_CAP, l as CslDate, m as CslItemData, n as CslName, H as HttpKeyStorageUrls, o as ImageUploadResult, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, p as buildAIPrompt, q as httpKeyStorage, r as localStorageKeyStorage, s as memoryKeyStorage, t as openaiCompatibleProvider, u as toAIStreamFn, v as trimContextAfter, w as trimContextBefore } from './index-BsIFJXPk.js';
+import { I as ImageUploadHandler, C as CitationPort, A as AIStreamFn, a as AIDraftFn } from './index-CDULnDYX.js';
+export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIContextLocation, g as AIDraftCitation, h as AIDraftEvent, i as AIProvider, j as AIProviderFactory, k as AiChatRequestContext, l as Auth, m as CONTEXT_CHAR_CAP, n as CslDate, o as CslItemData, p as CslName, H as HttpKeyStorageUrls, q as ImageUploadResult, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, r as buildAIPrompt, s as httpKeyStorage, t as localStorageKeyStorage, u as memoryKeyStorage, v as openaiCompatibleProvider, w as toAIStreamFn, x as trimContextAfter, y as trimContextBefore } from './index-CDULnDYX.js';
 import { PaginationPlusOptions } from 'tiptap-pagination-plus';
 export { PAGE_SIZES, PageSize, PaginationPlus, PaginationPlusOptions } from 'tiptap-pagination-plus';
 import { PluginKey } from '@tiptap/pm/state';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-core",
   "license": "UNLICENSED",
-  "version": "0.0.61",
+  "version": "0.0.63",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",