@dorsk/tsumikit 0.51.0 → 0.52.0

package/README.md

@@ -267,7 +267,10 @@ hooks on head/row/cell; `responsive="stack"` turns rows into cards below
 prefix, the `<table>` stays a table for assistive tech), FilterSearchBar /
 FilterInput (`size="sm"` compact bar on `--control-height-compact`,
 `shape="pill"`, `surface`, `hotkey="/"` focuses the input from anywhere
-outside an editable element, `showHotkey` renders the `<kbd>` hint, `grow`).
+outside an editable element, `showHotkey` renders the `<kbd>` hint, `grow`;
+`key="cwd"` puts FilterInput in single-key mode — `value` is the bare value
+instead of a `key:"value"` query, no key prefix in the box, the `placeholder`
+shows while empty, and completion still runs through that field's provider).
 
 **Layouts:** AppShell (responsive header/sidebar/main/footer — persistent
 sidebar on desktop, overlay drawer on mobile, optionally resizable;

package/dist/components/layouts/NavBar.svelte

@@ -56,7 +56,7 @@
 	{...rest}
 >
 	<div class="navbar-inner">
-		{#each items as item (item.href)}
+		{#each items as item, i (`${i}:${item.href}`)}
 			<a
 				href={item.href}
 				class="navbar-link"

package/dist/components/molecules/FilterInput.svelte

@@ -43,13 +43,15 @@
 	import { autoQuoteEdit, backspaceEmptyQuotes, closingQuoteExit } from '../../query/edit';
 	import { parse } from '../../query/parser';
 	import { type Schema } from '../../query/schema';
+	import { singleQuery, suggestSingle } from '../../query/single';
 	import { suggest, type SuggestState } from '../../query/suggest';
 	import { getFieldContext, warnUnlabelled } from '../../field-context';
 
 	let {
 		schema,
+		key,
 		value = $bindable(''),
-		placeholder = 'artist:"Daft Punk" AND year>=2000',
+		placeholder,
 		autoQuote = true,
 		showClear = true,
 		icon = 'search',
@@ -70,13 +72,23 @@
 		style: styleProp = '',
 	}: {
 		schema: Schema;
-		/** The raw textual query (two-way bindable). */
+		/**
+		 * Single-key mode: the name (or alias) of the ONE schema field being
+		 * edited. `value` then holds the bare value instead of a `key:"value"`
+		 * query — no key prefix in the box, the placeholder shows while empty and
+		 * completion still runs through that field's provider. The equivalent query
+		 * is synthesised for `onchange` and the snippet context.
+		 */
+		key?: string;
+		/** The raw textual query, or the bare value in single-key mode (bindable). */
 		value?: string;
+		/** Defaults to a sample query, or to nothing in single-key mode. */
 		placeholder?: string;
 		/**
 		 * When a string field's value step opens (`title:`), auto-insert a `""`
 		 * pair with the caret inside so multi-word values stay together; Tab exits
 		 * the quotes. Set false for bare typing where spaces split the value.
+		 * Always off in single-key mode, which quotes nothing.
 		 */
 		autoQuote?: boolean;
 		/** Show the trailing clear (✕) button when the field is non-empty. */
@@ -147,8 +159,12 @@
 		return () => document.removeEventListener('keydown', onHotkey);
 	});
 
+	const single = $derived(!!key);
+	const quoting = $derived(autoQuote && !single);
+	const hint = $derived(placeholder ?? (single ? '' : 'artist:"Daft Punk" AND year>=2000'));
+
 	// Parsed view (drives the onchange AST + the snippet context).
-	const ast = $derived(parse(value, schema));
+	const ast = $derived(parse(key ? singleQuery(schema, key, value) : value, schema));
 	const chips = $derived(filters(ast));
 	const text = $derived(freeText(ast));
 
@@ -183,7 +199,7 @@
 	}
 
 	function oninput(e: Event) {
-		if (autoQuote && el && (e as InputEvent).inputType?.startsWith('insert')) {
+		if (quoting && el && (e as InputEvent).inputType?.startsWith('insert')) {
 			const pos = el.selectionStart ?? value.length;
 			const edit = autoQuoteEdit(schema, value, pos);
 			if (edit) {
@@ -200,7 +216,7 @@
 		if (!el) return;
 		const pos = el.selectionStart ?? value.length;
 		const id = ++reqId;
-		const next = await suggest(schema, value, pos);
+		const next = key ? await suggestSingle(schema, key, value) : await suggest(schema, value, pos);
 		if (id !== reqId) return; // a newer keystroke won
 		menu = next;
 		active = 0;
@@ -217,7 +233,7 @@
 		let caret = s.caret;
 		// A field/operator pick that opens a string field's value step gets the
 		// same auto-quotes as manual typing.
-		if (autoQuote && s.advance) {
+		if (quoting && s.advance) {
 			const edit = autoQuoteEdit(schema, value, caret);
 			if (edit) {
 				value = edit.value;
@@ -236,7 +252,7 @@
 	}
 
 	function onkeydown(e: KeyboardEvent) {
-		if (autoQuote && el) {
+		if (quoting && el) {
 			const pos = el.selectionStart ?? value.length;
 			if (e.key === 'Tab') {
 				// Inside auto-quotes Tab exits them (takes priority over accepting a
@@ -292,6 +308,14 @@
 	}
 
 	function removeChip(span: [number, number]) {
+		// Single-key spans index the synthesised query, not the box: the only
+		// clause there is the value itself, so removing it empties the field.
+		if (single) {
+			value = '';
+			onsubmit?.('');
+			queueMicrotask(() => el?.focus());
+			return;
+		}
 		// Splice the clause out, plus trailing spaces to avoid doubles.
 		const [a, b] = span;
 		let end = b;
@@ -332,7 +356,7 @@
 			aria-invalid={ariaInvalid ?? (field?.invalid ? 'true' : undefined)}
 			spellcheck="false"
 			autocomplete="off"
-			{placeholder}
+			placeholder={hint}
 			{oninput}
 			onclick={refresh}
 			onkeyup={(e) => {

package/dist/components/molecules/FilterInput.svelte.d.ts

@@ -24,13 +24,23 @@ import { type IconName } from '../atoms/Icon.svelte';
 import { type Schema } from '../../query/schema';
 type $$ComponentProps = {
     schema: Schema;
-    /** The raw textual query (two-way bindable). */
+    /**
+     * Single-key mode: the name (or alias) of the ONE schema field being
+     * edited. `value` then holds the bare value instead of a `key:"value"`
+     * query — no key prefix in the box, the placeholder shows while empty and
+     * completion still runs through that field's provider. The equivalent query
+     * is synthesised for `onchange` and the snippet context.
+     */
+    key?: string;
+    /** The raw textual query, or the bare value in single-key mode (bindable). */
     value?: string;
+    /** Defaults to a sample query, or to nothing in single-key mode. */
     placeholder?: string;
     /**
      * When a string field's value step opens (`title:`), auto-insert a `""`
      * pair with the caret inside so multi-word values stay together; Tab exits
      * the quotes. Set false for bare typing where spaces split the value.
+     * Always off in single-key mode, which quotes nothing.
      */
     autoQuote?: boolean;
     /** Show the trailing clear (✕) button when the field is non-empty. */

package/dist/index.d.ts

@@ -87,7 +87,7 @@ export { default as FilterSearchBar } from './components/organisms/FilterSearchB
 export { EMOJI_GROUPS, type EmojiEntry, type EmojiGroup, searchEmoji } from './emoji';
 export { FIELD_KEY, type FieldContext, getFieldContext, setFieldContext, warnUnlabelled, } from './field-context';
 export * as filterQuery 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 { 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, singleQuery, suggest, suggestSingle, type TextNode, toSql, type ValueContext, type ValueOption, type ValueProvider, walk, } from './query';
 export { type OptionSection, sectionOptions } from './select-options';
 export type { ControlSize } from './size';
 export { fontScale, SCALE_LEVELS, type ScaleLevel } from './stores/fontscale.svelte';

package/dist/index.js

@@ -98,7 +98,7 @@ export { EMOJI_GROUPS, searchEmoji } from './emoji';
 export { FIELD_KEY, getFieldContext, setFieldContext, warnUnlabelled, } from './field-context';
 // ---- query core (headless: schema / parser / AST / suggest / compilers) ----
 export * as filterQuery from './query';
-export { activeToken, compilePredicate, defaultOperator, filters, findField, freeText, OPERATORS, operatorByCode, operatorById, operatorsFor, parse, resolveValues, serialize, serializeFilter, suggest, toSql, walk, } from './query';
+export { activeToken, compilePredicate, defaultOperator, filters, findField, freeText, OPERATORS, operatorByCode, operatorById, operatorsFor, parse, resolveValues, serialize, serializeFilter, singleQuery, suggest, suggestSingle, toSql, walk, } from './query';
 export { sectionOptions } from './select-options';
 export { fontScale, SCALE_LEVELS } from './stores/fontscale.svelte';
 // ---- stores / actions ----

package/dist/query/index.d.ts

@@ -5,5 +5,6 @@ export { parse } from './parser';
 export { compilePredicate, serialize, serializeFilter, toSql } from './query';
 export type { FieldDef, FieldType, Operator, OperatorId, Schema, ValueContext, ValueOption, ValueProvider, } from './schema';
 export { defaultOperator, findField, OPERATORS, operatorByCode, operatorById, operatorsFor, resolveValues, } from './schema';
+export { singleQuery, suggestSingle } from './single';
 export type { Suggestion, SuggestKind, SuggestState } from './suggest';
 export { activeToken, suggest } from './suggest';

package/dist/query/index.js

@@ -7,4 +7,5 @@ export { autoQuoteEdit, backspaceEmptyQuotes, closingQuoteExit, insideQuoteAtCar
 export { parse } from './parser';
 export { compilePredicate, serialize, serializeFilter, toSql } from './query';
 export { defaultOperator, findField, OPERATORS, operatorByCode, operatorById, operatorsFor, resolveValues, } from './schema';
+export { singleQuery, suggestSingle } from './single';
 export { activeToken, suggest } from './suggest';

package/dist/query/single.d.ts

@@ -0,0 +1,15 @@
+import { type Schema } from './schema';
+import type { SuggestState } from './suggest';
+/**
+ * The textual query a bare `value` stands for, using `key`'s default operator —
+ * `"/srv/my app"` under key `cwd` becomes `cwd:"/srv/my app"`. Empty values (and
+ * unknown keys) yield an empty query so the AST stays empty rather than parsing
+ * a half-written clause.
+ */
+export declare function singleQuery(schema: Schema, key: string, value: string): string;
+/**
+ * Value suggestions for `key` given the whole box as the fragment. The span
+ * always covers the entire value, so accepting an item replaces it outright —
+ * there is no field or operator step to advance to.
+ */
+export declare function suggestSingle(schema: Schema, key: string, value: string): Promise<SuggestState | null>;

package/dist/query/single.js

@@ -0,0 +1,43 @@
+// ─────────────────────────────────────────────────────────────────────────
+// Single-key mode — the headless half of FilterInput's `key` prop: the box
+// holds the bare value (`/srv/app`, not `cwd:"/srv/app"`), completing through
+// the field's own provider, and the equivalent query is synthesised only for
+// the `inline` / `below` snippets and the `onchange` AST.
+// ─────────────────────────────────────────────────────────────────────────
+import { defaultOperator, findField, resolveValues } from './schema';
+function quoteIfNeeded(v) {
+    return /[\s,()]/.test(v) ? `"${v}"` : v;
+}
+/**
+ * The textual query a bare `value` stands for, using `key`'s default operator —
+ * `"/srv/my app"` under key `cwd` becomes `cwd:"/srv/my app"`. Empty values (and
+ * unknown keys) yield an empty query so the AST stays empty rather than parsing
+ * a half-written clause.
+ */
+export function singleQuery(schema, key, value) {
+    const field = findField(schema, key);
+    if (!field || !value)
+        return '';
+    return `${field.name}${defaultOperator(field).code}${quoteIfNeeded(value)}`;
+}
+/**
+ * Value suggestions for `key` given the whole box as the fragment. The span
+ * always covers the entire value, so accepting an item replaces it outright —
+ * there is no field or operator step to advance to.
+ */
+export async function suggestSingle(schema, key, value) {
+    const field = findField(schema, key);
+    if (!field)
+        return null;
+    const span = [0, value.length];
+    const options = await resolveValues(field, value, { rawQuery: value, span, caret: value.length });
+    if (options.length === 0)
+        return null;
+    const items = options.map((o) => ({
+        label: o.label,
+        hint: o.hint,
+        insert: o.value,
+        caret: o.value.length,
+    }));
+    return { kind: 'value', span, items };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dorsk/tsumikit",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "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",