@delali/narsil 0.3.1-next.74 → 0.3.1-next.75

package/dist/{config-C6Iw5rCX.d.ts → config-B-GRonqw.d.ts}

@@ -1,4 +1,4 @@
-import { N as NarsilConfig } from './config-DJPH3IQB.js';
+import { N as NarsilConfig } from './config-C1kbq1X2.js';
 import { A as AllocationTable, N as NodeRole, a as NodeRegistration, C as ClusterCoordinator, b as NodeCapacity } from './types-ChrVy4lH.js';
 import { N as NodeTransport } from './types-Cb9kiY5P.js';
 

package/dist/{config-DJPH3IQB.d.ts → config-C1kbq1X2.d.ts}

@@ -1,5 +1,5 @@
 import { P as PersistenceAdapter, I as InvalidationAdapter, E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { Q as QueryParams, e as QueryResult, f as NarsilEventHandlers } from './memory-DJEwWoCi.js';
+import { Q as QueryParams, e as QueryResult, f as NarsilEventHandlers } from './memory-M9kPmYP8.js';
 import { I as IndexConfig, A as AnyDocument } from './schema-DgyDijhf.js';
 
 /**

package/dist/direct-executor-AVNWB73C.mjs

@@ -0,0 +1,16 @@
+export { createDirectExecutor } from './chunk-YOVS4EV5.mjs';
+import './chunk-NAMGDK45.mjs';
+import './chunk-4MQ5F4IL.mjs';
+import './chunk-V3B24XR7.mjs';
+import './chunk-TGP5M5R7.mjs';
+import './chunk-AMGDG4ZJ.mjs';
+import './chunk-ZJ4CSAB2.mjs';
+import './chunk-2E35UM3G.mjs';
+import './chunk-7ODNRREZ.mjs';
+import './chunk-AIUOAN7Y.mjs';
+import './chunk-UOJIV2NG.mjs';
+import './chunk-356UOTK2.mjs';
+import './chunk-KEHK2O6P.mjs';
+import './chunk-U2BKYEC7.mjs';
+import './chunk-IBR6634K.mjs';
+import './chunk-I64LXKO3.mjs';

package/dist/distribution/coordinator/etcd.mjs

@@ -1,5 +1,5 @@
 import { MAX_NODE_ID_LENGTH, MAX_WATCHERS } from '../../chunk-ORBLD3EL.mjs';
-import { compareCodePoints } from '../../chunk-LJYTW7GT.mjs';
+import { compareCodePoints } from '../../chunk-IBR6634K.mjs';
 import { NarsilError, ErrorCodes } from '../../chunk-I64LXKO3.mjs';
 import { decode, encode } from '@msgpack/msgpack';
 

package/dist/distribution/coordinator/in-memory.mjs

@@ -1,5 +1,5 @@
 import { NODE_HEARTBEAT_TTL_MS } from '../../chunk-ORBLD3EL.mjs';
-import { compareCodePoints } from '../../chunk-LJYTW7GT.mjs';
+import { compareCodePoints } from '../../chunk-IBR6634K.mjs';
 
 // src/distribution/coordinator/in-memory.ts
 var NODE_HEARTBEAT_PREFIX = "_narsil/node/";

package/dist/distribution.d.ts

@@ -1,12 +1,12 @@
-import { a as CreateIndexOptions, C as ClusterNamespace, b as ClusterNodeConfig } from './config-C6Iw5rCX.js';
-export { c as ClusterControllerConfig, d as ClusterNodeInfo, e as ClusterQueryConfig, N as NodeReadiness, R as ReplicationConfig } from './config-C6Iw5rCX.js';
-import { B as BatchResult, L as ListParams, h as ListResult, k as SuggestParams, l as SuggestResult, Q as QueryParams, j as PreflightResult, g as IndexStats, P as PartitionStatsResult, M as MemoryStats, m as NarsilEventMap, e as QueryResult } from './memory-DJEwWoCi.js';
+import { a as CreateIndexOptions, C as ClusterNamespace, b as ClusterNodeConfig } from './config-B-GRonqw.js';
+export { c as ClusterControllerConfig, d as ClusterNodeInfo, e as ClusterQueryConfig, N as NodeReadiness, R as ReplicationConfig } from './config-B-GRonqw.js';
+import { B as BatchResult, L as ListParams, h as ListResult, k as SuggestParams, l as SuggestResult, Q as QueryParams, j as PreflightResult, g as IndexStats, P as PartitionStatsResult, M as MemoryStats, m as NarsilEventMap, e as QueryResult } from './memory-M9kPmYP8.js';
 import { I as IndexConfig, A as AnyDocument, a as InsertOptions } from './schema-DgyDijhf.js';
 import { b as NodeCapacity, N as NodeRole } from './types-ChrVy4lH.js';
 export { c as AllocationConstraints, d as AllocationEvent, A as AllocationTable, C as ClusterCoordinator, e as NodeEvent, a as NodeRegistration, P as PartitionAssignment, f as PartitionState, S as SchemaEvent, U as UnassignedReason } from './types-ChrVy4lH.js';
-import { N as Narsil } from './engine-B8eRPO7m.js';
+import { N as Narsil } from './engine-DcGSd5vh.js';
 export { L as ListenHandler, N as NodeTransport, R as RespondFn, T as TransportConfig, a as TransportMessage } from './types-Cb9kiY5P.js';
-import './config-DJPH3IQB.js';
+import './config-C1kbq1X2.js';
 import './adapters-79OIa4xm.js';
 
 /**

package/dist/distribution.mjs

@@ -1,25 +1,24 @@
 import { MAX_MESSAGE_SIZE_BYTES } from './chunk-UNEEFTEU.mjs';
-import { validateIndexName, indexConfigKey, withPartitionCount, indexSettingsOf, putIndexMetadata, getIndexMetadata, getClusterIndexConfig } from './chunk-TVFLHM7M.mjs';
-import { requireKnownConfig, resolveRunnableConfig, createEngineCore, startEngineCore, createNarsilFromCore, runEngineQueryStats, runEngineListDocuments, runEngineSuggest, runEnginePreflight, runEngineQuery, createEngineIndex, buildArchiveFromMemory, indexMetadataOf, encodeIndexConfiguration, archiveStream, applyIndexEntry, applyDeleteEntry, requireConfigurationWithinSizeLimit, validateEntryBatchPayload, createAckMessage, validateEntryPayload, validateForwardBatchPayload, createForwardBatchResultMessage, memoryCheckpointStore, readSnapshotArchive, createByteReader, openChecksummedEnvelope, loadPartitionSegments, readListedFile, createForwardBatchMessage, validateForwardBatchResultPayload, createForwardMessage, validateReplicationEntry, crc32Init, crc32Final, crc32Update, computeEntryChecksum, createEntryMessage, createEntryBatchMessage, createInsyncConfirmMessage, validateAckPayload, createInsyncRemoveMessage, validateInsyncConfirmPayload, createInsyncAddMessage } from './chunk-CUZOX6CN.mjs';
-import { now, listBindingOf, requireSurfaceFormsForPartialFields, queryBindingOf, hitsKeptPerGroup, clampLimit, resolveHybridFusion, dedupePinnedEntries, foldGroupReducer } from './chunk-CTOSGRM7.mjs';
+import { validateIndexName, indexConfigKey, withPartitionCount, indexSettingsOf, putIndexMetadata, getIndexMetadata, getClusterIndexConfig } from './chunk-PXDY5VRT.mjs';
+import { requireKnownConfig, resolveRunnableConfig, createEngineCore, startEngineCore, createNarsilFromCore, runEngineQueryStats, runEngineListDocuments, runEngineSuggest, runEnginePreflight, runEngineQuery, createEngineIndex, buildArchiveFromMemory, indexMetadataOf, encodeIndexConfiguration, archiveStream, applyIndexEntry, applyDeleteEntry, requireConfigurationWithinSizeLimit, validateEntryBatchPayload, createAckMessage, validateEntryPayload, validateForwardBatchPayload, createForwardBatchResultMessage, memoryCheckpointStore, readSnapshotArchive, createByteReader, openChecksummedEnvelope, loadPartitionSegments, readListedFile, createForwardBatchMessage, validateForwardBatchResultPayload, createForwardMessage, validateReplicationEntry, crc32Init, crc32Final, crc32Update, computeEntryChecksum, createEntryMessage, createEntryBatchMessage, createInsyncConfirmMessage, validateAckPayload, createInsyncRemoveMessage, validateInsyncConfirmPayload, createInsyncAddMessage } from './chunk-LOARLB4F.mjs';
+import { now, listBindingOf, requireSurfaceFormsForPartialFields, queryBindingOf, hitsKeptPerGroup, clampLimit, resolveHybridFusion, dedupePinnedEntries, foldGroupReducer } from './chunk-WL2GDSCV.mjs';
 import { ReplicationMessageTypes, TransportErrorCodes, ClusterMessageTypes, QueryMessageTypes, TransportError } from './chunk-GCM3JFVA.mjs';
-import { providedDocId, MAX_PARTITION_COUNT, MAX_REPLICATION_FACTOR, WIRE_BATCH_BUDGET } from './chunk-LX4JERXI.mjs';
-import { generateId, decodeVectorFilePayload, bytesToVectors, isDead, FILTER_EXPRESSION_KEYS, FIELD_FILTER_OPERATORS } from './chunk-BVBIQQKG.mjs';
-import { oversampledShardSize, resolveProjection, clampRowCount, sortSignatureOf, requireMatchingCursor, decodePageCursor, normalizeSort, sortModesOf, encodePageCursor, applyProjection, readSortValues, requireWithinResultWindow, fnv1a, sortSignatureEntry, MAX_FILTER_DEPTH, filterTestCount, MAX_FILTER_TESTS, fnv1aUint32s, mergePartitionStats, MAX_FILTER_ARRAY_SIZE } from './chunk-VKX2BPXD.mjs';
+import { providedDocId, MAX_PARTITION_COUNT, MAX_REPLICATION_FACTOR, WIRE_BATCH_BUDGET } from './chunk-BT62MUM5.mjs';
+import { generateId, decodeVectorFilePayload, bytesToVectors, isDead, FILTER_EXPRESSION_KEYS, FIELD_FILTER_OPERATORS } from './chunk-YOVS4EV5.mjs';
+import { oversampledShardSize, resolveProjection, clampRowCount, sortSignatureOf, requireMatchingCursor, decodePageCursor, normalizeSort, sortModesOf, encodePageCursor, applyProjection, readSortValues, requireWithinResultWindow, fnv1a, sortSignatureEntry, filterTestCount, fnv1aUint32s, mergePartitionStats } from './chunk-NAMGDK45.mjs';
 import { getLanguage } from './chunk-4MQ5F4IL.mjs';
-import { DEFAULT_SUGGEST_LIMIT, MAX_SUGGEST_LIMIT, DEFAULT_PAGE_SIZE, MAX_SUGGEST_SCATTER_LIMIT, MAX_INDEX_NAME_LENGTH, MAX_SORT_FIELDS, MAX_DOC_ID_LENGTH, MAX_CURSOR_LENGTH, MAX_TOLERANCE, SUGGEST_OVERSAMPLE_FACTOR, SUGGEST_OVERSAMPLE_PADDING, INDEX_NAME_PATTERN, MAX_PREFIX_LENGTH, RESULT_WINDOW } from './chunk-3DDUNI6N.mjs';
+import { DEFAULT_SUGGEST_LIMIT, MAX_SUGGEST_LIMIT, DEFAULT_PAGE_SIZE, MAX_SUGGEST_SCATTER_LIMIT, MAX_INDEX_NAME_LENGTH, MAX_FILTER_DEPTH, MAX_FILTER_TESTS, MAX_SORT_FIELDS, MAX_DOC_ID_LENGTH, MAX_CURSOR_LENGTH, MAX_TOLERANCE, SUGGEST_OVERSAMPLE_FACTOR, SUGGEST_OVERSAMPLE_PADDING, INDEX_NAME_PATTERN, MAX_PREFIX_LENGTH, RESULT_WINDOW, MAX_FILTER_ARRAY_SIZE } from './chunk-V3B24XR7.mjs';
 import './chunk-TGP5M5R7.mjs';
-import './chunk-PO53FV4Q.mjs';
+import './chunk-AMGDG4ZJ.mjs';
 import { MIN_OVERSAMPLE } from './chunk-ZJ4CSAB2.mjs';
 import './chunk-2E35UM3G.mjs';
-import './chunk-XW25X6AU.mjs';
-import './chunk-ZKRV5M2P.mjs';
-import './chunk-T5ZWEWVD.mjs';
-import './chunk-I23G3IZC.mjs';
-import { validateSchema, requireCreatableSchema, encodeDocument, MAX_STORED_VECTOR_DIMENSION, MIN_POLYGON_POINTS, isLatitude, MAX_LATITUDE_DEGREES, isLongitude, MAX_LONGITUDE_DEGREES, MAX_NESTING_DEPTH } from './chunk-Z3DQPOJQ.mjs';
+import './chunk-7ODNRREZ.mjs';
+import './chunk-AIUOAN7Y.mjs';
+import './chunk-UOJIV2NG.mjs';
+import { validateSchema, requireCreatableSchema, encodeDocument, MAX_STORED_VECTOR_DIMENSION, MIN_POLYGON_POINTS, isLatitude, MAX_LATITUDE_DEGREES, isLongitude, MAX_LONGITUDE_DEGREES, MAX_NESTING_DEPTH } from './chunk-356UOTK2.mjs';
 import './chunk-KEHK2O6P.mjs';
 import './chunk-U2BKYEC7.mjs';
-import { compareCodePoints, toComparableSortValue, compareComparableKeys, isSortMode, SORT_MODES, exceedsCodePoints, compareSortValues } from './chunk-LJYTW7GT.mjs';
+import { compareCodePoints, toComparableSortValue, compareComparableKeys, isSortMode, SORT_MODES, exceedsCodePoints, compareSortValues } from './chunk-IBR6634K.mjs';
 import './chunk-POWOTUKJ.mjs';
 import { ErrorCodes, NarsilError, describeError } from './chunk-I64LXKO3.mjs';
 import { encode, decode } from '@msgpack/msgpack';
@@ -6601,6 +6600,7 @@ function validateFetchResultPayload(decoded) {
 
 // src/distribution/query/validators/filters.ts
 var GEO_UNITS = ["km", "mi", "m"];
+var TEXT_OPERATORS = /* @__PURE__ */ new Set(["startsWith", "endsWith", "contains", "wildcard", "regex"]);
 function throwTooLong(value, fieldLabel, errorCode) {
   throwInvalid(
     errorCode,
@@ -6773,7 +6773,7 @@ function validateLeafOperator(opKey, opValue, leafLabel, errorCode) {
     validateBetween(opValue, opLabel, errorCode);
     return;
   }
-  if (opKey === "startsWith" || opKey === "endsWith" || opKey === "contains") {
+  if (TEXT_OPERATORS.has(opKey)) {
     validateBoundedString(opValue, opLabel, errorCode);
     return;
   }

package/dist/{engine-B8eRPO7m.d.ts → engine-DcGSd5vh.d.ts}

@@ -1,5 +1,5 @@
 import { E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { B as BatchResult, I as IndexInfo, g as IndexStats, P as PartitionStatsResult, L as ListParams, h as ListResult, Q as QueryParams, e as QueryResult, j as PreflightResult, k as SuggestParams, l as SuggestResult, D as DocumentImportResult, M as MemoryStats, V as VectorMaintenanceResult, m as NarsilEventMap } from './memory-DJEwWoCi.js';
+import { B as BatchResult, I as IndexInfo, g as IndexStats, P as PartitionStatsResult, L as ListParams, h as ListResult, Q as QueryParams, e as QueryResult, j as PreflightResult, k as SuggestParams, l as SuggestResult, D as DocumentImportResult, M as MemoryStats, V as VectorMaintenanceResult, m as NarsilEventMap } from './memory-M9kPmYP8.js';
 import { A as AnyDocument, a as InsertOptions, W as WriteOptions, I as IndexConfig, P as PartitionConfig } from './schema-DgyDijhf.js';
 
 /**

package/dist/index.browser.mjs

@@ -852,7 +852,7 @@ function platformPatternSearch() {
 // src/core/pattern-index/registry.ts
 var registered2 = null;
 function isPatternSearchModule(value) {
-  return value !== null && typeof value === "object" && value.name === "pattern" && "createIndex" in value && typeof value.createIndex === "function" && "readArrays" in value && typeof value.readArrays === "function" && "mergeArrays" in value && typeof value.mergeArrays === "function" && "matchInto" in value && typeof value.matchInto === "function";
+  return value !== null && typeof value === "object" && value.name === "pattern" && "createIndex" in value && typeof value.createIndex === "function" && "readArrays" in value && typeof value.readArrays === "function" && "mergeArrays" in value && typeof value.mergeArrays === "function" && "matchInto" in value && typeof value.matchInto === "function" && "checkExpression" in value && typeof value.checkExpression === "function" && "expressionFootprint" in value && typeof value.expressionFootprint === "function";
 }
 function registerPatternSearch(module) {
   if (!isPatternSearchModule(module)) {
@@ -2632,6 +2632,7 @@ var MATCHER_STATE_OVERHEAD_BYTES = 96;
 var PATTERN_WORK_FLUSH_UNITS = 65536;
 var PATTERN_RUN_CODE_POINTS = 3;
 var PATTERN_TEST_OPERATORS = ["eq", "ne", "in", "nin", "startsWith", "endsWith", "contains"];
+var PATTERN_EXPRESSION_OPERATORS = ["wildcard", "regex"];
 
 // src/geo/constants.ts
 var DEG_TO_RAD = Math.PI / 180;
@@ -4406,7 +4407,24 @@ function computeFacets(state, matched, config, schema) {
 }
 
 // src/core/pattern-index/host.ts
-var PATTERN_HOST = { appendFoldedCodePoint };
+var NO_SOURCES = [];
+var foldSources = null;
+function sourcesByFold() {
+  if (foldSources !== null) return foldSources;
+  const sources = /* @__PURE__ */ new Map();
+  const add = (source, folded) => {
+    const known = sources.get(folded);
+    if (known === void 0) sources.set(folded, [source]);
+    else known.push(source);
+  };
+  for (const [source, folded] of singleFoldTable()) add(source, folded);
+  foldSources = sources;
+  return sources;
+}
+function singleFoldSources(folded) {
+  return sourcesByFold().get(folded) ?? NO_SOURCES;
+}
+var PATTERN_HOST = { appendFoldedCodePoint, singleFoldSources };
 function patternIndexOf(indexes, fieldPath) {
   let index = indexes.get(fieldPath);
   if (index === void 0) {
@@ -5739,6 +5757,8 @@ function evaluatePatternTests(fieldPath, filter, context, bitsets) {
   if (typeof filter.startsWith === "string") bitsets.push(matching("startsWith", [filter.startsWith]));
   if (typeof filter.endsWith === "string") bitsets.push(matching("endsWith", [filter.endsWith]));
   if (typeof filter.contains === "string") bitsets.push(matching("contains", [filter.contains]));
+  if (typeof filter.wildcard === "string") bitsets.push(matching("wildcard", [filter.wildcard]));
+  if (typeof filter.regex === "string") bitsets.push(matching("regex", [filter.regex]));
 }
 
 // src/filters/field-tests.ts
@@ -5943,6 +5963,8 @@ var FIELD_FILTER_OPERATORS = [
   "startsWith",
   "endsWith",
   "contains",
+  "wildcard",
+  "regex",
   "caseFold",
   "containsAll",
   "matchesAny",
@@ -6158,14 +6180,16 @@ function requirePatternField(fieldPath, operator, type) {
     operator
   );
 }
+function requireTextLength(fieldPath, operator, text) {
+  if (!exceedsCodePoints(text, MAX_PATTERN_TEXT_CODE_POINTS)) return;
+  invalid(
+    `The text of "${operator}" on pattern field "${fieldPath}" holds more than ${MAX_PATTERN_TEXT_CODE_POINTS} code points`,
+    fieldPath,
+    operator
+  );
+}
 function requirePatternText(fieldPath, operator, text, caseFold) {
-  if (exceedsCodePoints(text, MAX_PATTERN_TEXT_CODE_POINTS)) {
-    invalid(
-      `The text of "${operator}" on pattern field "${fieldPath}" holds more than ${MAX_PATTERN_TEXT_CODE_POINTS} code points`,
-      fieldPath,
-      operator
-    );
-  }
+  requireTextLength(fieldPath, operator, text);
   if (caseFold && foldedCodePointCount(text) > MAX_PATTERN_POSITIONS) {
     invalid(
       `The text of "${operator}" on pattern field "${fieldPath}" has a case fold of more than ${MAX_PATTERN_POSITIONS} code points, while a pattern holds at most ${MAX_PATTERN_POSITIONS} positions`,
@@ -6175,6 +6199,23 @@ function requirePatternText(fieldPath, operator, text, caseFold) {
   }
 }
 var ELEMENT_OPERATORS2 = ["matchesAny", "containsAll"];
+function requireExpressions(fieldPath, filter, type) {
+  for (const operator of PATTERN_EXPRESSION_OPERATORS) {
+    const pattern = filter[operator];
+    if (pattern === void 0) continue;
+    if (typeof pattern !== "string")
+      invalid(`"${operator}" on field "${fieldPath}" must be a string`, fieldPath, operator);
+    requirePatternField(fieldPath, operator, type);
+    requireTextLength(fieldPath, operator, pattern);
+    requirePatternSearch(fieldPath).checkExpression(
+      operator,
+      pattern,
+      filter.caseFold === true,
+      fieldPath,
+      PATTERN_HOST
+    );
+  }
+}
 function requirePatternOperands(fieldPath, filter, type) {
   if (filter.contains !== void 0) {
     if (typeof filter.contains !== "string") {
@@ -6188,6 +6229,7 @@ function requirePatternOperands(fieldPath, filter, type) {
     }
     requirePatternField(fieldPath, "caseFold", type);
   }
+  requireExpressions(fieldPath, filter, type);
   if (parsedTypeOf(type)?.pattern !== true) return;
   const caseFold = filter.caseFold === true;
   for (const operator of PATTERN_TEST_OPERATORS) {
@@ -30653,57 +30695,61 @@ var POSITIONS_PER_WORD = 32;
 function positionWords(positions) {
   return Math.max(1, Math.ceil(positions / POSITIONS_PER_WORD));
 }
-function automatonBytes(positions) {
-  return 2 * positionWords(positions) * Uint32Array.BYTES_PER_ELEMENT + positions * MATCHER_CODE_POINT_BYTES;
-}
 function smallestMatcherBytes(positions) {
-  return automatonBytes(positions) + positions * MATCHER_SIMULATION_BYTES_PER_POSITION + MATCHER_STATE_OVERHEAD_BYTES + positions * Uint32Array.BYTES_PER_ELEMENT;
+  return 2 * positionWords(positions) * Uint32Array.BYTES_PER_ELEMENT + positions * MATCHER_CODE_POINT_BYTES + positions * MATCHER_SIMULATION_BYTES_PER_POSITION + MATCHER_STATE_OVERHEAD_BYTES + positions * Uint32Array.BYTES_PER_ELEMENT;
 }
-function widestPatternSplit(positions) {
-  return Math.max(1, Math.floor(MATCHER_STATE_BUDGET_BYTES / smallestMatcherBytes(positions)));
+function widestPatternSplit(footprintBytes) {
+  return Math.max(1, Math.floor(MATCHER_STATE_BUDGET_BYTES / Math.max(1, footprintBytes)));
 }
 
 // src/core/pattern-index/query-positions.ts
 function isRecord6(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
-function textPositions(text, caseFold) {
-  if (typeof text !== "string") return 0;
-  return caseFold ? foldedCodePointCount(text) : codePointCount(text);
+function literalFootprint(text, caseFold) {
+  if (typeof text !== "string") return null;
+  return smallestMatcherBytes(caseFold ? foldedCodePointCount(text) : codePointCount(text));
 }
 function larger(left, right) {
   if (left === null) return right;
   if (right === null) return left;
   return Math.max(left, right);
 }
-function largestTestOf(filter) {
+function largestTestOf(filter, module) {
   const caseFold = filter.caseFold === true;
   let largest = null;
   for (const operator of PATTERN_TEST_OPERATORS) {
     const operand = filter[operator];
     if (operand === void 0) continue;
     const texts = Array.isArray(operand) ? operand : [operand];
-    for (const text of texts) largest = larger(largest, textPositions(text, caseFold));
+    for (const text of texts) largest = larger(largest, literalFootprint(text, caseFold));
+  }
+  for (const operator of PATTERN_EXPRESSION_OPERATORS) {
+    const pattern = filter[operator];
+    if (typeof pattern !== "string") continue;
+    largest = larger(largest, module.expressionFootprint(operator, pattern, caseFold, PATTERN_HOST));
   }
   return largest;
 }
-function largestIn(expression, patternFields) {
+function largestIn(expression, patternFields, module) {
   let largest = null;
   if (isRecord6(expression.fields)) {
     for (const [fieldPath, filter] of Object.entries(expression.fields)) {
-      if (patternFields.has(fieldPath) && isRecord6(filter)) largest = larger(largest, largestTestOf(filter));
+      if (patternFields.has(fieldPath) && isRecord6(filter)) largest = larger(largest, largestTestOf(filter, module));
     }
   }
   const nested = [...expression.and ?? [], ...expression.or ?? []];
   if (expression.not !== void 0) nested.push(expression.not);
-  for (const child of nested) largest = larger(largest, largestIn(child, patternFields));
+  for (const child of nested) largest = larger(largest, largestIn(child, patternFields, module));
   return largest;
 }
-function largestPatternTest(expression, schema) {
+function largestPatternFootprint(expression, schema) {
   if (expression === void 0) return null;
+  const module = availablePatternSearch();
+  if (module === null) return null;
   const patternFields = /* @__PURE__ */ new Set();
   for (const { path, pattern } of schemaFieldsOf(schema)) if (pattern) patternFields.add(path);
-  return patternFields.size === 0 ? null : largestIn(expression, patternFields);
+  return patternFields.size === 0 ? null : largestIn(expression, patternFields, module);
 }
 
 // src/engine/orchestration/search.ts
@@ -30770,7 +30816,7 @@ function isWorkCapError(err) {
 function patternSplitWidth(state, indexName, params) {
   const schema = state.indexRegistry.get(indexName)?.config.schema;
   if (schema === void 0) return Number.POSITIVE_INFINITY;
-  const largest = largestPatternTest(params.filters, schema);
+  const largest = largestPatternFootprint(params.filters, schema);
   if (largest === null) return Number.POSITIVE_INFINITY;
   if (typeof SharedArrayBuffer !== "function") return 1;
   return widestPatternSplit(largest);

package/dist/index.d.ts

@@ -4,11 +4,11 @@ import { P as PartialWordSearch } from './partial-words-DTIHO8G4.js';
 import { P as PatternSearch } from './pattern-Cledccbl.js';
 import { L as LanguageModule } from './language-DB8KG1z5.js';
 export { T as TokenizerConfig } from './language-DB8KG1z5.js';
-export { A as ArrayFilter, B as BatchResult, C as ClientErrorCode, a as ClientErrorCodes, n as ComparisonFilter, D as DocumentImportResult, o as DocumentProjection, E as ErrorCode, b as ErrorCodes, F as FacetConfig, p as FacetResult, q as FieldFilter, r as FilterExpression, G as GeoFilter, s as GeoPolygonFilter, t as GeoRadiusFilter, u as GroupConfig, v as GroupReducer, w as GroupResult, H as HighlightConfig, x as HighlightMatch, y as Hit, z as HybridConfig, I as IndexInfo, g as IndexStats, L as ListParams, h as ListResult, J as ListedDocument, M as MemoryStats, N as NarsilError, c as NarsilErrorCode, f as NarsilEventHandlers, m as NarsilEventMap, P as PartitionStatsResult, j as PreflightResult, K as PresenceFilter, O as ProcessMemoryReport, R as QueryCoverage, Q as QueryParams, e as QueryResult, T as ScoreComponents, U as SearchMode, S as ServerErrorCode, d as ServerErrorCodes, W as SortField, X as SortSpec, Y as StringFilter, k as SuggestParams, l as SuggestResult, Z as TermMatchPolicy, V as VectorMaintenanceResult, _ as VectorQueryConfig, $ as WorkerCopyReport, i as isNarsilError } from './memory-DJEwWoCi.js';
-import { N as NarsilConfig } from './config-DJPH3IQB.js';
-export { A as AnalysisConfig, D as DurabilityConfig, I as IndexContext, a as IndexLifecycleConfig, b as InsertContext, M as MainCopyQueries, c as NarsilPlugin, P as PartitionContext, R as RemoveContext, S as SearchContext, d as StaleAnalysis, U as UpdateContext, W as WorkerConfig, e as WorkerContext } from './config-DJPH3IQB.js';
-import { N as Narsil } from './engine-B8eRPO7m.js';
-export { B as ByteSource, D as DocumentWriteOperations, I as IndexLifecycleOperations } from './engine-B8eRPO7m.js';
+export { A as ArrayFilter, B as BatchResult, C as ClientErrorCode, a as ClientErrorCodes, n as ComparisonFilter, D as DocumentImportResult, o as DocumentProjection, E as ErrorCode, b as ErrorCodes, F as FacetConfig, p as FacetResult, q as FieldFilter, r as FilterExpression, G as GeoFilter, s as GeoPolygonFilter, t as GeoRadiusFilter, u as GroupConfig, v as GroupReducer, w as GroupResult, H as HighlightConfig, x as HighlightMatch, y as Hit, z as HybridConfig, I as IndexInfo, g as IndexStats, L as ListParams, h as ListResult, J as ListedDocument, M as MemoryStats, N as NarsilError, c as NarsilErrorCode, f as NarsilEventHandlers, m as NarsilEventMap, P as PartitionStatsResult, j as PreflightResult, K as PresenceFilter, O as ProcessMemoryReport, R as QueryCoverage, Q as QueryParams, e as QueryResult, T as ScoreComponents, U as SearchMode, S as ServerErrorCode, d as ServerErrorCodes, W as SortField, X as SortSpec, Y as StringFilter, k as SuggestParams, l as SuggestResult, Z as TermMatchPolicy, V as VectorMaintenanceResult, _ as VectorQueryConfig, $ as WorkerCopyReport, i as isNarsilError } from './memory-M9kPmYP8.js';
+import { N as NarsilConfig } from './config-C1kbq1X2.js';
+export { A as AnalysisConfig, D as DurabilityConfig, I as IndexContext, a as IndexLifecycleConfig, b as InsertContext, M as MainCopyQueries, c as NarsilPlugin, P as PartitionContext, R as RemoveContext, S as SearchContext, d as StaleAnalysis, U as UpdateContext, W as WorkerConfig, e as WorkerContext } from './config-C1kbq1X2.js';
+import { N as Narsil } from './engine-DcGSd5vh.js';
+export { B as ByteSource, D as DocumentWriteOperations, I as IndexLifecycleOperations } from './engine-DcGSd5vh.js';
 export { E as EmbeddingAdapter, I as InvalidationAdapter, a as InvalidationEvent, b as PartitionStatistics, P as PersistenceAdapter } from './adapters-79OIa4xm.js';
 export { i as isSimdAvailable } from './simd-DW5AtJ6B.js';
 

package/dist/index.mjs

@@ -1,22 +1,21 @@
-export { VERSION, createNarsil } from './chunk-CUZOX6CN.mjs';
-import './chunk-CTOSGRM7.mjs';
+export { VERSION, createNarsil } from './chunk-LOARLB4F.mjs';
+import './chunk-WL2GDSCV.mjs';
 import './chunk-GCM3JFVA.mjs';
-import './chunk-LX4JERXI.mjs';
-export { getStopWords, getTokenizer, hasStopWords, hasTokenizer, registerPartialWordSearch, registerPatternSearch, registerStopWords, registerTokenizer } from './chunk-BVBIQQKG.mjs';
-import './chunk-VKX2BPXD.mjs';
+import './chunk-BT62MUM5.mjs';
+export { getStopWords, getTokenizer, hasStopWords, hasTokenizer, registerPartialWordSearch, registerStopWords, registerTokenizer } from './chunk-YOVS4EV5.mjs';
+export { registerPatternSearch } from './chunk-NAMGDK45.mjs';
 export { getLanguage, registerLanguage } from './chunk-4MQ5F4IL.mjs';
-import './chunk-3DDUNI6N.mjs';
+import './chunk-V3B24XR7.mjs';
 import './chunk-TGP5M5R7.mjs';
-export { isSimdAvailable } from './chunk-PO53FV4Q.mjs';
+export { isSimdAvailable } from './chunk-AMGDG4ZJ.mjs';
 import './chunk-ZJ4CSAB2.mjs';
 import './chunk-2E35UM3G.mjs';
-import './chunk-XW25X6AU.mjs';
-import './chunk-ZKRV5M2P.mjs';
-import './chunk-T5ZWEWVD.mjs';
-export { clearNormalizationCache, configureNormalizationCache, getNormalizationCacheSize, resetNormalizationCache } from './chunk-I23G3IZC.mjs';
-import './chunk-Z3DQPOJQ.mjs';
+import './chunk-7ODNRREZ.mjs';
+import './chunk-AIUOAN7Y.mjs';
+export { clearNormalizationCache, configureNormalizationCache, getNormalizationCacheSize, resetNormalizationCache } from './chunk-UOJIV2NG.mjs';
+import './chunk-356UOTK2.mjs';
 import './chunk-KEHK2O6P.mjs';
 import './chunk-U2BKYEC7.mjs';
-import './chunk-LJYTW7GT.mjs';
+import './chunk-IBR6634K.mjs';
 import './chunk-POWOTUKJ.mjs';
 export { ClientErrorCodes, ErrorCodes, NarsilError, ServerErrorCodes, isNarsilError } from './chunk-I64LXKO3.mjs';

package/dist/invalidation/filesystem.mjs

@@ -1,4 +1,4 @@
-import { compareCodePoints } from '../chunk-LJYTW7GT.mjs';
+import { compareCodePoints } from '../chunk-IBR6634K.mjs';
 import { DEFAULT_POLL_INTERVAL_MS, MARKER_MAX_AGE_MS } from '../chunk-YEO6G2NG.mjs';
 
 // src/invalidation/filesystem.ts

package/dist/{memory-DJEwWoCi.d.ts → memory-M9kPmYP8.d.ts}

@@ -28,33 +28,43 @@ type ComparisonFilter = {
 };
 /**
  * The engine tests a text field against this filter for equality, for a text
- * range, or with the set and prefix tests.
+ * range, or with the set, prefix, and pattern tests.
  *
- * The engine compares each element of a `string[]`, `verbatim[]`, or `enum[]` field, so
- * it matches a document with `eq`, `in`, `startsWith`, `endsWith`, or
- * `contains` where one element passes the test, while it matches a document
- * with `ne` or `nin` where every element differs from the values.
+ * On a `string[]`, `verbatim[]`, or `enum[]` field, the engine tests each
+ * element of the list on its own. A document passes `eq`, `in`, `startsWith`,
+ * `endsWith`, `contains`, `wildcard`, or `regex` when one element passes the
+ * test. However, a document passes `ne` or `nin` only when every element
+ * differs from the values.
  *
  * The engine applies the range tests `gt`, `gte`, `lt`, `lte`, and `between`
- * to a single `string` or `verbatim` field whose type includes `sortable`,
- * while it throws `SEARCH_INVALID_FILTER` for a text range on any other field.
- * It orders the values as a sort on the field does, comparing their case folds
- * first and their raw code points only where the folds are equal.
+ * to a single `string` or `verbatim` field whose type includes `sortable`. It
+ * throws `SEARCH_INVALID_FILTER` for a text range on any other field. It
+ * orders the values as a sort on the field does, so it compares their case
+ * folds first and compares their raw code points only where the folds are
+ * equal.
  *
  * A pattern field is a `verbatim` or `verbatim[]` field, or a `string` or
- * `string[]` field whose type includes `pattern`. On such a field, the engine
- * answers `eq`, `ne`, `in`, `nin`, `startsWith`, `endsWith`, and `contains`
- * from the field's pattern index. `caseFold` applies to each of those tests.
+ * `string[]` field whose type includes `pattern`. On a pattern field, the
+ * engine answers `eq`, `ne`, `in`, `nin`, `startsWith`, `endsWith`,
+ * `contains`, `wildcard`, and `regex` from the field's pattern index, and
+ * `caseFold` applies to each of those tests. The engine compares the code
+ * points of each value as they are stored, with no Unicode normalisation.
+ *
  * On an `enum` or `enum[]` field, the engine answers `eq`, `ne`, `in`, `nin`,
- * `startsWith`, and `endsWith` from the field's index of values. It throws
- * `SEARCH_INVALID_FILTER` for `eq`, `ne`, `in`, `nin`, `startsWith`, or
- * `endsWith` on a `string` or `string[]` field whose type leaves out
- * `pattern`, because such a field keeps no index of whole values.
- * The engine compares the code points of each value as stored, with no
- * Unicode normalisation. It throws `SEARCH_INVALID_FILTER` for `contains` or
- * `caseFold` on any other field, for a test text longer than 1,024 code points
- * on a pattern field, and for a `caseFold` test whose text has a case fold
- * longer than 2,048 code points.
+ * `startsWith`, and `endsWith` from the field's index of values. A `string` or
+ * `string[]` field whose type leaves out `pattern` keeps no index of whole
+ * values, so the engine throws `SEARCH_INVALID_FILTER` for those six tests,
+ * and for `matchesAny` and `containsAll`, on such a field.
+ *
+ * The engine also throws `SEARCH_INVALID_FILTER` in these cases:
+ *
+ * - The filter sets `contains`, `wildcard`, `regex`, or `caseFold` on a field
+ *   that is not a pattern field.
+ * - The text or the pattern of a test on a pattern field holds more than 1,024
+ *   code points.
+ * - A literal test under `caseFold` has a text whose case fold holds more than
+ *   2,048 code points.
+ * - A `wildcard` or `regex` pattern breaks its syntax or one of its limits.
  *
  * @public
  */
@@ -79,11 +89,55 @@ type StringFilter = Pick<ComparisonFilter, 'eq' | 'ne'> & {
     endsWith?: string;
     /** This matches a pattern field whose value holds the text anywhere in it. */
     contains?: string;
+    /**
+     * This matches a pattern field when the whole value matches the wildcard
+     * pattern. For example, `INV-*-2024` matches `INV-0042-2024`.
+     *
+     * In the pattern, `*` matches any sequence of code points, including an
+     * empty one, and `?` matches exactly one code point. Write `\` before a code
+     * point to match that code point itself, so `\*` matches an asterisk.
+     *
+     * The engine throws `SEARCH_INVALID_FILTER` for a pattern that ends in a
+     * `\` with no code point after it. It throws the same error for a pattern
+     * with more than 2,048 positions. Each `*`, each `?`, and each other code
+     * point counts as one position, except that under `caseFold` a code point
+     * counts once for each code point of its case fold.
+     */
+    wildcard?: string;
+    /**
+     * This matches a pattern field when some part of the value matches the
+     * regular expression. `^` and `$` match only at the start and at the end of
+     * the whole value.
+     *
+     * The engine accepts literal code points, `.`, `\d`, `\w`, and `\s`, sets
+     * such as `[a-z]` and `[^0-9]`, groups, and `|`. It also accepts the repeats
+     * `*`, `+`, `?`, `{n}`, `{n,}`, and `{n,m}`, the anchors `^` and `$`, the
+     * word edge `\b`, and number ranges such as `<1-65535>`. A number range
+     * matches the digits of any whole number from its low end to its high end.
+     * Write `\` before an ASCII punctuation mark to match the mark itself. The
+     * `.` matches any code point, including a line break.
+     *
+     * The matcher never backtracks, so it checks a value in at most as many
+     * steps as the value's code points multiplied by the pattern's positions.
+     *
+     * The engine throws `SEARCH_INVALID_FILTER` for any construct outside that
+     * syntax, such as a back-reference, a lookaround, a lazy repeat, or an inline
+     * flag. It throws the same error when the groups of a pattern nest more than
+     * 32 deep, when a count is above 2,048, and when a pattern holds more than
+     * 2,048 positions. When the operator of an HTTP server sets its `allowRegex`
+     * option to false, the server refuses every `regex` test.
+     */
+    regex?: string;
     /**
      * When this is true, the engine compares the case fold of each value of a
-     * pattern field with the case fold of the text, so a test for `error` matches
-     * `ERROR`. It applies to `eq`, `ne`, `in`, `nin`, `startsWith`, `endsWith`,
-     * and `contains`.
+     * pattern field with the case fold of the text, so a test for `error`
+     * matches `ERROR`. It applies to `eq`, `ne`, `in`, `nin`, `startsWith`,
+     * `endsWith`, `contains`, `wildcard`, and `regex`.
+     *
+     * Under `caseFold`, a set that does not open with `^` can also match a
+     * sequence of code points. When a member that the set holds on its own folds
+     * to several code points, the set matches that whole fold, so `[ß]` matches
+     * `ss`.
      */
     caseFold?: boolean;
 };

package/dist/partial-words.mjs

@@ -1,8 +1,8 @@
-import { partialWordSearchModule } from './chunk-T5ZWEWVD.mjs';
-import './chunk-I23G3IZC.mjs';
-import './chunk-Z3DQPOJQ.mjs';
+import { partialWordSearchModule } from './chunk-AIUOAN7Y.mjs';
+import './chunk-UOJIV2NG.mjs';
+import './chunk-356UOTK2.mjs';
 import './chunk-KEHK2O6P.mjs';
-import './chunk-LJYTW7GT.mjs';
+import './chunk-IBR6634K.mjs';
 import './chunk-I64LXKO3.mjs';
 
 // src/partial-words/index.ts

package/dist/pattern.mjs

@@ -1,5 +1,5 @@
-import { patternSearchModule } from './chunk-XW25X6AU.mjs';
-import './chunk-ZKRV5M2P.mjs';
+import { patternSearchModule } from './chunk-7ODNRREZ.mjs';
+import './chunk-I64LXKO3.mjs';
 
 // src/pattern/index.ts
 var patternSearch = patternSearchModule;

package/dist/persistence/durability/checkpoint-worker.mjs

@@ -1,23 +1,22 @@
-import { CHECKPOINT_WORKER_HEARTBEAT_MS, createDurableDirectory, writeCheckpointSegments, directoryCheckpointStore } from '../../chunk-CUZOX6CN.mjs';
-import '../../chunk-CTOSGRM7.mjs';
+import { CHECKPOINT_WORKER_HEARTBEAT_MS, createDurableDirectory, writeCheckpointSegments, directoryCheckpointStore } from '../../chunk-LOARLB4F.mjs';
+import '../../chunk-WL2GDSCV.mjs';
 import '../../chunk-GCM3JFVA.mjs';
-import '../../chunk-LX4JERXI.mjs';
-import '../../chunk-BVBIQQKG.mjs';
-import '../../chunk-VKX2BPXD.mjs';
+import '../../chunk-BT62MUM5.mjs';
+import '../../chunk-YOVS4EV5.mjs';
+import '../../chunk-NAMGDK45.mjs';
 import '../../chunk-4MQ5F4IL.mjs';
-import '../../chunk-3DDUNI6N.mjs';
+import '../../chunk-V3B24XR7.mjs';
 import '../../chunk-TGP5M5R7.mjs';
-import '../../chunk-PO53FV4Q.mjs';
+import '../../chunk-AMGDG4ZJ.mjs';
 import '../../chunk-ZJ4CSAB2.mjs';
 import '../../chunk-2E35UM3G.mjs';
-import '../../chunk-XW25X6AU.mjs';
-import '../../chunk-ZKRV5M2P.mjs';
-import '../../chunk-T5ZWEWVD.mjs';
-import '../../chunk-I23G3IZC.mjs';
-import '../../chunk-Z3DQPOJQ.mjs';
+import '../../chunk-7ODNRREZ.mjs';
+import '../../chunk-AIUOAN7Y.mjs';
+import '../../chunk-UOJIV2NG.mjs';
+import '../../chunk-356UOTK2.mjs';
 import '../../chunk-KEHK2O6P.mjs';
 import '../../chunk-U2BKYEC7.mjs';
-import '../../chunk-LJYTW7GT.mjs';
+import '../../chunk-IBR6634K.mjs';
 import '../../chunk-POWOTUKJ.mjs';
 import '../../chunk-I64LXKO3.mjs';
 

package/dist/react.d.ts

@@ -1,10 +1,10 @@
-import { N as NarsilError, L as ListParams, h as ListResult, I as IndexInfo, g as IndexStats, Q as QueryParams, j as PreflightResult, e as QueryResult, k as SuggestParams, l as SuggestResult } from './memory-DJEwWoCi.js';
-export { C as ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes, i as isNarsilError } from './memory-DJEwWoCi.js';
-import { e as TaskRecord, d as TaskProgress, b as ImportResult, c as TaskListQuery, T as TaskListPage } from './tasks-BVmAKYBh.js';
-export { I as ImportError, f as TaskStatus, g as TaskType } from './tasks-BVmAKYBh.js';
+import { N as NarsilError, L as ListParams, h as ListResult, I as IndexInfo, g as IndexStats, Q as QueryParams, j as PreflightResult, e as QueryResult, k as SuggestParams, l as SuggestResult } from './memory-M9kPmYP8.js';
+export { C as ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes, i as isNarsilError } from './memory-M9kPmYP8.js';
+import { e as TaskRecord, d as TaskProgress, b as ImportResult, c as TaskListQuery, T as TaskListPage } from './tasks-A8se0J98.js';
+export { I as ImportError, f as TaskStatus, g as TaskType } from './tasks-A8se0J98.js';
 import { ReactNode, ReactElement } from 'react';
-import { N as Narsil } from './engine-B8eRPO7m.js';
-import { N as NarsilClient, I as ImportSource } from './client-C-I70ArH.js';
+import { N as Narsil } from './engine-DcGSd5vh.js';
+import { N as NarsilClient, I as ImportSource } from './client-D4sXFS9f.js';
 import { A as AnyDocument } from './schema-DgyDijhf.js';
 import './adapters-79OIa4xm.js';