@dorsk/tsumikit 0.18.0 → 0.18.2

package/dist/index.d.ts

@@ -53,7 +53,7 @@ export { default as Tooltip } from './components/molecules/Tooltip.svelte';
 export { default as Truncate } from './components/molecules/Truncate.svelte';
 export { type Column, default as DataTable } from './components/organisms/DataTable.svelte';
 export { default as FilterSearchBar } from './components/organisms/FilterSearchBar.svelte';
-export { type AndNode, activeToken, compilePredicate, defaultOperator, type ExprNode, type FieldDef, type FieldType, type FilterNode, filters, findField, freeText, type LeafNode, type NotNode, OPERATORS, type Operator, type OperatorId, type OrNode, operatorByCode, operatorById, operatorsFor, parse, type Query, type QueryNode, resolveValues, type Schema, type Suggestion, type SuggestKind, type SuggestState, serialize, serializeFilter, suggest, type TextNode, toSql, type ValueOption, type ValueProvider, walk, } from './query';
+export { type AndNode, activeToken, compilePredicate, defaultOperator, type ExprNode, type FieldDef, type FieldType, type FilterNode, filters, findField, freeText, type LeafNode, type NotNode, OPERATORS, type Operator, type OperatorId, type OrNode, operatorByCode, operatorById, operatorsFor, parse, type Query, type QueryNode, resolveValues, type Schema, type Suggestion, type SuggestKind, type SuggestState, serialize, serializeFilter, suggest, type TextNode, toSql, type ValueContext, type ValueOption, type ValueProvider, walk, } from './query';
 export { fontScale, SCALE_LEVELS, type ScaleLevel } from './stores/fontscale.svelte';
 export { type Mode, THEMES, theme } from './stores/theme.svelte';
 export { type Toast, type ToastTone, toasts } from './stores/toast.svelte';

package/dist/query/index.d.ts

@@ -3,7 +3,7 @@ export { filters, freeText, walk } from './ast';
 export { autoQuoteEdit, backspaceEmptyQuotes, closingQuoteExit, insideQuoteAtCaret, } from './edit';
 export { parse } from './parser';
 export { compilePredicate, serialize, serializeFilter, toSql } from './query';
-export type { FieldDef, FieldType, Operator, OperatorId, Schema, ValueOption, ValueProvider, } from './schema';
+export type { FieldDef, FieldType, Operator, OperatorId, Schema, ValueContext, ValueOption, ValueProvider, } from './schema';
 export { defaultOperator, findField, OPERATORS, operatorByCode, operatorById, operatorsFor, resolveValues, } from './schema';
 export type { Suggestion, SuggestKind, SuggestState } from './suggest';
 export { activeToken, suggest } from './suggest';

package/dist/query/schema.d.ts

@@ -19,8 +19,22 @@ export interface ValueOption {
     /** Optional secondary line (e.g. an email under a username). */
     hint?: string;
 }
+/**
+ * Extra context handed to a {@link ValueProvider} alongside the value fragment:
+ * the full raw query, the active replacement span (`[start, end)` offsets of the
+ * text a chosen suggestion would replace) and the caret position. Optional so
+ * existing providers that only read the fragment keep working unchanged.
+ */
+export interface ValueContext {
+    /** The full query string the fragment was extracted from. */
+    rawQuery: string;
+    /** `[start, end)` offsets of the token region a suggestion would replace. */
+    span: [number, number];
+    /** Absolute caret index within `rawQuery`. */
+    caret: number;
+}
 /** Resolves candidate values for a field given the user's partial input. */
-export type ValueProvider = (query: string) => ValueOption[] | Promise<ValueOption[]>;
+export type ValueProvider = (query: string, context?: ValueContext) => ValueOption[] | Promise<ValueOption[]>;
 export interface FieldDef {
     /** Canonical name, used in the serialised query (e.g. `artist`). */
     name: string;
@@ -57,4 +71,4 @@ export declare function findField(schema: Schema, token: string): FieldDef | und
 export declare function operatorByCode(code: string): Operator | undefined;
 export declare function operatorById(id: OperatorId): Operator | undefined;
 /** Resolve a field's value options (sync wrapper that always returns a promise). */
-export declare function resolveValues(field: FieldDef, query: string): Promise<ValueOption[]>;
+export declare function resolveValues(field: FieldDef, query: string, context?: ValueContext): Promise<ValueOption[]>;

package/dist/query/schema.js

@@ -45,9 +45,9 @@ export function operatorById(id) {
     return OPERATORS.find((op) => op.id === id);
 }
 /** Resolve a field's value options (sync wrapper that always returns a promise). */
-export async function resolveValues(field, query) {
+export async function resolveValues(field, query, context) {
     if (field.provider)
-        return field.provider(query);
+        return field.provider(query, context);
     const opts = field.options ?? [];
     const q = query.toLowerCase();
     return q ? opts.filter((o) => o.label.toLowerCase().includes(q)) : opts;

package/dist/query/suggest.js

@@ -164,7 +164,8 @@ export async function suggest(schema, s, pos) {
     if (!field)
         return null;
     // Operator present → suggest values (async; filtered by what's typed).
-    const opts = await resolveValues(field, unquote(value));
+    const context = { rawQuery: s, span, caret: pos };
+    const opts = await resolveValues(field, unquote(value), context);
     if (opts.length === 0)
         return null;
     return buildValueState(field, opCode, span, opts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dorsk/tsumikit",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "description": "Minimal, dependency-free Svelte 5 + pure-CSS UI kit. Token-driven atoms, molecules & layouts with theming out of the box.",
   "type": "module",
   "license": "MIT",