@concordance-wiki/site 0.1.0

package/dist/search/highlight.js

@@ -0,0 +1,72 @@
+/**
+ * How a title marks the words of a query: the start of every token a word prefixes, compared
+ * on the same folded form as the index. Nothing here reaches Node either: the island marks
+ * the titles of the live results.
+ */
+import { normalizeQuery } from "./shared.js";
+const alphanumeric = /[\p{L}\p{N}]/u;
+function foldCharacters(text) {
+    return Array.from(text).map((character) => ({
+        text: character,
+        folded: normalizeQuery(character),
+    }));
+}
+/**
+ * The span of a token whose folded form the longest word of the query covers; none when no word
+ * prefixes the token. A word is matched against the token from its first letter or digit, as
+ * the index trims the punctuation at the edges of a token, and the mark carries the combining
+ * marks that follow its last letter, so that an accent is never cut from its letter.
+ */
+function matchedSpan(token, words) {
+    const start = token.findIndex((character) => alphanumeric.test(character.folded));
+    if (start < 0)
+        return undefined;
+    const folded = token
+        .slice(start)
+        .map((character) => character.folded)
+        .join("");
+    const longest = words
+        .filter((word) => folded.startsWith(word))
+        .reduce((best, word) => Math.max(best, word.length), 0);
+    if (longest === 0)
+        return undefined;
+    let covered = 0;
+    let end = start;
+    while (end < token.length && (covered < longest || token[end]?.folded === "")) {
+        // The loop stops before the end of the token: its folded form holds at least `longest` characters.
+        covered += token[end].folded.length;
+        end += 1;
+    }
+    return { start, end };
+}
+function textOf(characters) {
+    return characters.map((character) => character.text).join("");
+}
+/** The title cut into pieces, the start of every token a word of the query prefixes marked; one plain piece when nothing matches. */
+export function markTitle(title, words) {
+    const pieces = [];
+    const push = (text, marked) => {
+        if (text === "")
+            return;
+        const last = pieces[pieces.length - 1];
+        if (last?.marked === marked) {
+            last.text += text;
+        }
+        else {
+            pieces.push({ text, marked });
+        }
+    };
+    for (const part of title.split(/(\s+)/)) {
+        const token = foldCharacters(part);
+        const span = /^\s*$/.test(part) ? undefined : matchedSpan(token, words);
+        if (span === undefined) {
+            push(part, false);
+            continue;
+        }
+        push(textOf(token.slice(0, span.start)), false);
+        push(textOf(token.slice(span.start, span.end)), true);
+        push(textOf(token.slice(span.end)), false);
+    }
+    return pieces.length === 0 ? [{ text: "", marked: false }] : pieces;
+}
+//# sourceMappingURL=highlight.js.map

package/dist/search/highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.js","sourceRoot":"","sources":["../../src/search/highlight.ts"],"names":[],"mappings":"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"}

package/dist/search/shared.d.ts

@@ -0,0 +1,194 @@
+/**
+ * What the index builder and the island in the browser share: the layout of the index files,
+ * the normalisation of a query and the ranking. Nothing here reaches Node, so that the same
+ * module is bundled into the island.
+ */
+import type { SearchField, SearchResultsProps } from "../slots.js";
+/** Folder of the index under the output folder; also the folder of the results page. */
+export declare const SEARCH_DIRECTORY = "search";
+/** The island of the header field and of the results page; one bundle wires both. */
+export declare const SEARCH_ISLAND = "search";
+/** The suggestions under the header field are rendered into the element of this class by the island. */
+export declare const SUGGESTIONS_CLASS = "search-suggestions";
+/** The button clearing a search field, served hidden; the island shows it while the field holds a query. */
+export declare const CLEAR_CLASS = "search-clear";
+/** Name of the entity table file, `search/meta.js`; never a shard name, which is at most two characters. */
+export declare const SEARCH_META = "meta";
+/** The global the shard files call back: `window.__concordanceSearch.shard(name, data)`. */
+export declare const SEARCH_GLOBAL = "__concordanceSearch";
+/** A shard gathers every token sharing its first characters; a query word shorter than this is not looked up. */
+export declare const SHARD_PREFIX_LENGTH = 2;
+/** The type stored for a keyword page, which has no type of its own; the type facet lists it dotted. */
+export declare const KEYWORD_TYPE = "keyword";
+/**
+ * What the client entry reads from an island: the field of the header, with the root of the
+ * site where the index lives, or the results of the search page, which the entry fills from
+ * the query in the address and as the reader types.
+ */
+export interface SearchIslandProps {
+    /** Href of the root of the site from the page; absent when there is no index to load. */
+    root?: string;
+    search?: SearchField;
+    /** `true` for the field at the head of the home page, drawn large with its live results in the flow of the page. */
+    home?: boolean;
+    results?: SearchResultsProps;
+}
+/** One row of the entity table, in model order; the client turns `url` into an href from its page. */
+export interface SearchEntry {
+    id: string;
+    title: string;
+    /** The type of the entity, `keyword` for a keyword page. */
+    type: string;
+    /** Path of the page under the output folder. */
+    url: string;
+    application?: string;
+    domain?: string;
+    status: string;
+    source: string;
+    /** The summary of the note, what its row shows under the title. */
+    summary?: string;
+    /** The other names of the note, when it declares some. */
+    aliases?: string[];
+    /** The title of the broader term the note declares, or the value as written when it names no page. */
+    broader?: string;
+    /** How many pages cite the entity: the distinct sources of the links pointing at it. */
+    cited?: number;
+    /** `true` for a keyword page, the page of a recurring expression nobody defined. */
+    keyword?: true;
+    /** How many times the expression was read and in how many files, for a keyword page. */
+    occurrences?: number;
+    documents?: number;
+}
+/** The facets of the results page, in the order they are shown; each one filters on the field of the same name. */
+export declare const FACET_NAMES: readonly ["type", "source", "domain", "application"];
+export type FacetName = (typeof FACET_NAMES)[number];
+/** The fifth facet, on the keyword pages: its parameter in the address and its name in the view. */
+export declare const NOTELESS_FACET = "nonote";
+/** What the no-note facet does with the keyword pages: keeps them among the results, keeps them alone, or leaves them out. */
+export declare const NOTELESS_FILTERS: readonly ["any", "only", "exclude"];
+export type NotelessFilter = (typeof NOTELESS_FILTERS)[number];
+/**
+ * A plural message frozen at build for the browser: the text of every plural category of the
+ * locale, `#` standing for the number; `plural` picks the category with `Intl.PluralRules`.
+ */
+export type PluralForms = Record<string, string>;
+/** The strings of the results page, formatted at build in the site language and written in the table. */
+export interface SearchLabels {
+    /** Heading of the facets. */
+    facets: string;
+    /** Heading of every facet, by name. */
+    facet: Record<FacetName, string>;
+    activeFilters: string;
+    removeFilter: string;
+    clear: string;
+    noResult: string;
+    /** "No result for {query}", the placeholder filled in the browser. */
+    noResultFor: string;
+    /** "N results, most cited first", by plural category. */
+    results: PluralForms;
+    /** The note under the facets: that the counters are set at publication and the filtering runs in the browser. */
+    countersNote: string;
+    /** The no-note facet: its heading and its three values. */
+    noteless: Record<"label" | NotelessFilter, string>;
+    /** "cited in N pages", by plural category, for the row of a note. */
+    cited: PluralForms;
+    /** "Also called: {aliases}" and "Broader term: {term}", the placeholders filled in the browser. */
+    alsoCalled: string;
+    broader: string;
+    /** "Used in N documents, never defined in the glossary", by plural category, for the row of a keyword page. */
+    usedIn: PluralForms;
+    /** The note under the results: that the words without a note appear dotted among the others. */
+    notelessNote: string;
+    /** The lead of the closest form proposed when nothing matches. */
+    closestForm: string;
+    /** "N occurrences", by plural category, for the closest form when it is a keyword page. */
+    occurrences: PluralForms;
+    /** "Show the next N", by plural category, on the button under the rows drawn so far. */
+    showNext: PluralForms;
+    /** "No result for {query} with the filters {filters}", by plural category of the filters, the placeholders filled in the browser. */
+    noResultFiltered: PluralForms;
+    /** The sentence under that notice: the word exists, on none of the pages the filter keeps. */
+    existsElsewhere: string;
+    /** "Remove the filter {label}", the placeholder filled in the browser. */
+    liftFilter: string;
+    /** The sentence under the notice of a word no file uses. */
+    noFileUses: string;
+    /** The exit to the page of the word itself. */
+    seeWordPage: string;
+    /** The line explaining that the search matches the start of words. */
+    prefixNote: string;
+}
+/** The number of entities carrying every value of every facet, values in code-unit order; the keyword pages and the others under `nonote`. */
+export type FacetCounts = Record<FacetName, Record<string, number>> & {
+    nonote: Record<Exclude<NotelessFilter, "any">, number>;
+};
+export interface SearchMeta {
+    entities: SearchEntry[];
+    /** Every shard written, sorted, so that the client never asks for one that does not exist. */
+    shards: string[];
+    /** Labels of the types, titles of the applications and domains, by identifier, in the site language. */
+    types: Record<string, string>;
+    applications: Record<string, string>;
+    domains: Record<string, string>;
+    /** The declared sources, each labelled by its title, else its name, so that the facet lists them like the others. */
+    sources: Record<string, string>;
+    /** The names of the glossary sources, sorted: a note of one of them is a glossary term, whose row in the live results counts its citations rather than quoting its definition. */
+    glossary: string[];
+    /** The counts of every facet value over the whole table: what the results page shows before a query. */
+    counts: FacetCounts;
+    labels: SearchLabels;
+    /** BCP 47 tag of the site, for the plural rules of the counts. */
+    locale: string;
+    /** Bytes of every shard file together; the entity table is not counted in itself. */
+    bytes: number;
+}
+/** The text of a plural message for a count: the category's text, `other` when the locale has none for it, the number written in the locale. */
+export declare function plural(forms: PluralForms, count: number, locale: string): string;
+/** Token to its `[entity index, weight]` pairs, indices ascending. */
+export type ShardData = Record<string, [number, number][]>;
+/**
+ * The form a query is compared on, the same the language packs give to the indexed text: case
+ * and accents folded, typographic apostrophes unified, whitespace collapsed.
+ */
+export declare function normalizeQuery(text: string): string;
+/** Punctuation trimmed at both ends of a word; the inside stays so that a hyphenated word is one token. */
+export declare function trimEdges(word: string): string;
+/** The words of a query that are looked up, in order, without repetition; a word too short for a shard is dropped. */
+export declare function queryWords(query: string): string[];
+/** The shard a token belongs to: its first characters. */
+export declare function shardOf(token: string): string;
+/**
+ * File name of a shard or of the entity table under `search/`, without extension: letters and
+ * digits stay, any other character becomes `_` and its code point, so that the name is safe on
+ * every file system and in a URL.
+ */
+export declare function shardFile(name: string): string;
+/** The href of an index file from a page, given the href of the `search/` folder from that page. */
+export declare function shardHref(index: string, name: string): string;
+/** The text of a shard file: a classic script calling the global back, so that it loads over `file://` as behind a server. */
+export declare function shardScript(name: string, json: string): string;
+export interface Ranked {
+    /** Index in the entity table. */
+    entity: number;
+    score: number;
+}
+/** What the ranking reads of the table: whether an entity is a keyword page, and how many pages cite it. */
+export interface RankOrder {
+    keyword?: (entity: number) => boolean;
+    cited?: (entity: number) => number;
+}
+export declare function rank(words: readonly string[], shards: ReadonlyMap<string, ShardData>, order?: RankOrder): Ranked[];
+export interface ClosestForm {
+    /** Index in the entity table. */
+    entity: number;
+    /** The title or the alias matched, as written. */
+    form: string;
+}
+/**
+ * The form of the dictionary closest to a query that matched nothing: the title or alias sharing
+ * the longest prefix with the query, at least a shard's worth of it; the shortest form among
+ * equals, so that a word beats the expressions starting with it, then the earliest in the table;
+ * none when no form shares that much.
+ */
+export declare function closestForm(query: string, entries: readonly SearchEntry[]): ClosestForm | undefined;
+//# sourceMappingURL=shared.d.ts.map

package/dist/search/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/search/shared.ts"],"names":[],"mappings":"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"}

package/dist/search/shared.js

@@ -0,0 +1,166 @@
+/**
+ * What the index builder and the island in the browser share: the layout of the index files,
+ * the normalisation of a query and the ranking. Nothing here reaches Node, so that the same
+ * module is bundled into the island.
+ */
+/** Folder of the index under the output folder; also the folder of the results page. */
+export const SEARCH_DIRECTORY = "search";
+/** The island of the header field and of the results page; one bundle wires both. */
+export const SEARCH_ISLAND = "search";
+/** The suggestions under the header field are rendered into the element of this class by the island. */
+export const SUGGESTIONS_CLASS = "search-suggestions";
+/** The button clearing a search field, served hidden; the island shows it while the field holds a query. */
+export const CLEAR_CLASS = "search-clear";
+/** Name of the entity table file, `search/meta.js`; never a shard name, which is at most two characters. */
+export const SEARCH_META = "meta";
+/** The global the shard files call back: `window.__concordanceSearch.shard(name, data)`. */
+export const SEARCH_GLOBAL = "__concordanceSearch";
+/** A shard gathers every token sharing its first characters; a query word shorter than this is not looked up. */
+export const SHARD_PREFIX_LENGTH = 2;
+/** The type stored for a keyword page, which has no type of its own; the type facet lists it dotted. */
+export const KEYWORD_TYPE = "keyword";
+/** The facets of the results page, in the order they are shown; each one filters on the field of the same name. */
+export const FACET_NAMES = ["type", "source", "domain", "application"];
+/** The fifth facet, on the keyword pages: its parameter in the address and its name in the view. */
+export const NOTELESS_FACET = "nonote";
+/** What the no-note facet does with the keyword pages: keeps them among the results, keeps them alone, or leaves them out. */
+export const NOTELESS_FILTERS = ["any", "only", "exclude"];
+/** The text of a plural message for a count: the category's text, `other` when the locale has none for it, the number written in the locale. */
+export function plural(forms, count, locale) {
+    const text = forms[new Intl.PluralRules(locale).select(count)] ?? forms["other"] ?? "";
+    return text.replaceAll("#", new Intl.NumberFormat(locale).format(count));
+}
+const combiningMarks = /\p{M}+/gu;
+const apostrophes = /[’ʼ]/g;
+// The trailing run starts right after a letter or digit: retrying inside the run would make the runtime quadratic.
+const edges = /^[^\p{L}\p{N}]+|(?<![^\p{L}\p{N}])[^\p{L}\p{N}]+$/gu;
+/**
+ * The form a query is compared on, the same the language packs give to the indexed text: case
+ * and accents folded, typographic apostrophes unified, whitespace collapsed.
+ */
+export function normalizeQuery(text) {
+    return text
+        .normalize("NFD")
+        .replace(combiningMarks, "")
+        .toLowerCase()
+        .replace(apostrophes, "'")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** Punctuation trimmed at both ends of a word; the inside stays so that a hyphenated word is one token. */
+export function trimEdges(word) {
+    return word.replace(edges, "");
+}
+/** The words of a query that are looked up, in order, without repetition; a word too short for a shard is dropped. */
+export function queryWords(query) {
+    const words = [];
+    for (const raw of normalizeQuery(query).split(" ")) {
+        const word = trimEdges(raw);
+        if (word.length >= SHARD_PREFIX_LENGTH && !words.includes(word)) {
+            words.push(word);
+        }
+    }
+    return words;
+}
+/** The shard a token belongs to: its first characters. */
+export function shardOf(token) {
+    return Array.from(token).slice(0, SHARD_PREFIX_LENGTH).join("");
+}
+/**
+ * File name of a shard or of the entity table under `search/`, without extension: letters and
+ * digits stay, any other character becomes `_` and its code point, so that the name is safe on
+ * every file system and in a URL.
+ */
+export function shardFile(name) {
+    return Array.from(name)
+        .map((character) => /[a-z0-9]/.test(character)
+        ? character
+        : // A character spread from a string always has a code point.
+            `_${character.codePointAt(0).toString(16).padStart(4, "0")}`)
+        .join("");
+}
+/** The href of an index file from a page, given the href of the `search/` folder from that page. */
+export function shardHref(index, name) {
+    return `${index}${shardFile(name)}.js`;
+}
+/** The text of a shard file: a classic script calling the global back, so that it loads over `file://` as behind a server. */
+export function shardScript(name, json) {
+    return `window.${SEARCH_GLOBAL}.shard(${JSON.stringify(name)},${json});\n`;
+}
+/**
+ * The entities matching every word of the query as a prefix of one of their tokens, best first:
+ * each word counts the heaviest token it prefixes, the score is their sum, and ties go to the
+ * most cited, then keep the table order, except that a keyword page, when `keyword` names it,
+ * never comes before an entity of the same score. The shards given are those of the words; a
+ * word without a shard matches nothing.
+ */
+/** The heaviest token of every entity that the word prefixes, from the shard of the word. */
+function bestWeights(word, shards) {
+    const best = new Map();
+    const shard = shards.get(shardOf(word)) ?? {};
+    for (const [token, pairs] of Object.entries(shard)) {
+        if (!token.startsWith(word))
+            continue;
+        for (const [entity, weight] of pairs) {
+            best.set(entity, Math.max(best.get(entity) ?? 0, weight));
+        }
+    }
+    return best;
+}
+export function rank(words, shards, order = {}) {
+    const keyword = order.keyword ?? (() => false);
+    const cited = order.cited ?? (() => 0);
+    let scores;
+    for (const word of words) {
+        const best = bestWeights(word, shards);
+        if (scores === undefined) {
+            scores = best;
+            continue;
+        }
+        const kept = new Map();
+        for (const [entity, score] of scores) {
+            const weight = best.get(entity);
+            if (weight !== undefined)
+                kept.set(entity, score + weight);
+        }
+        scores = kept;
+    }
+    return [...(scores ?? new Map())]
+        .map(([entity, score]) => ({ entity, score }))
+        .sort((a, b) => b.score - a.score ||
+        Number(keyword(a.entity)) - Number(keyword(b.entity)) ||
+        cited(b.entity) - cited(a.entity) ||
+        a.entity - b.entity);
+}
+/** The forms of an entry the dictionary knows: its title, then its aliases. */
+function formsOf(entry) {
+    return [entry.title, ...(entry.aliases ?? [])];
+}
+function commonPrefixLength(a, b) {
+    let length = 0;
+    while (length < a.length && length < b.length && a[length] === b[length])
+        length += 1;
+    return length;
+}
+/**
+ * The form of the dictionary closest to a query that matched nothing: the title or alias sharing
+ * the longest prefix with the query, at least a shard's worth of it; the shortest form among
+ * equals, so that a word beats the expressions starting with it, then the earliest in the table;
+ * none when no form shares that much.
+ */
+export function closestForm(query, entries) {
+    const wanted = normalizeQuery(query);
+    let best;
+    let longest = SHARD_PREFIX_LENGTH - 1;
+    for (const [entity, entry] of entries.entries()) {
+        for (const form of formsOf(entry)) {
+            const length = commonPrefixLength(wanted, normalizeQuery(form));
+            if (length > longest || (length === longest && form.length < (best?.form.length ?? 0))) {
+                longest = length;
+                best = { entity, form };
+            }
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=shared.js.map

package/dist/search/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/search/shared.ts"],"names":[],"mappings":"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"}

package/dist/search/state.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The state of a search as the address of the results page carries it: `?q=…` for the query,
+ * then one parameter per facet with its selected values separated by commas, `type=term,screen`.
+ * Nothing here reaches Node either: the island parses and writes the addresses.
+ */
+import { type FacetName, type NotelessFilter } from "./shared.js";
+export interface SearchState {
+    query: string;
+    /** The selected values of every facet, in code-unit order; an empty list leaves the facet open. */
+    filters: Record<FacetName, string[]>;
+    /** What is done with the keyword pages; `any` keeps them among the results and is the default. */
+    noteless: NotelessFilter;
+}
+/** The parameter of the query in the address. */
+export declare const QUERY_PARAMETER = "q";
+export declare function emptyState(): SearchState;
+/** The state an address carries; a parameter absent or empty leaves its part of the state empty. */
+export declare function parseSearchState(search: string): SearchState;
+/** The query string of a state, `?q=…&type=…`, parameters in a fixed order; empty for the empty state. */
+export declare function searchQueryString(state: SearchState): string;
+export declare function hasFilters(state: SearchState): boolean;
+export declare function isSelected(state: SearchState, name: FacetName, value: string): boolean;
+/** The state with a facet value selected when it is not, lifted when it is; the rest untouched. */
+export declare function toggleValue(state: SearchState, name: FacetName, value: string): SearchState;
+/** The state with the no-note facet on a value, or back to `any` when that value is the current one. */
+export declare function toggleNoteless(state: SearchState, value: NotelessFilter): SearchState;
+/** The state with every facet open again, the query kept. */
+export declare function clearFilters(state: SearchState): SearchState;
+export declare function withQuery(state: SearchState, query: string): SearchState;
+//# sourceMappingURL=state.d.ts.map

package/dist/search/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/search/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,kGAAkG;IAClG,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,iDAAiD;AACjD,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,wBAAgB,UAAU,IAAI,WAAW,CAMxC;AAaD,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAU5D;AAOD,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAS5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEtD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtF;AAED,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAK3F;AAED,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,GAAG,WAAW,CAErF;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAE5D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAExE"}

package/dist/search/state.js

@@ -0,0 +1,82 @@
+/**
+ * The state of a search as the address of the results page carries it: `?q=…` for the query,
+ * then one parameter per facet with its selected values separated by commas, `type=term,screen`.
+ * Nothing here reaches Node either: the island parses and writes the addresses.
+ */
+import { byCodeUnit } from "../order.js";
+import { FACET_NAMES, NOTELESS_FACET, NOTELESS_FILTERS, } from "./shared.js";
+/** The parameter of the query in the address. */
+export const QUERY_PARAMETER = "q";
+export function emptyState() {
+    return {
+        query: "",
+        filters: { type: [], source: [], domain: [], application: [] },
+        noteless: "any",
+    };
+}
+function isNotelessFilter(value) {
+    // Widened so that any string can be looked up; the guard narrows it back.
+    return NOTELESS_FILTERS.includes(value);
+}
+/** The values of a facet parameter: split on commas, blanks dropped, once each, in code-unit order. */
+function valuesOf(parameter) {
+    if (parameter === null)
+        return [];
+    return [...new Set(parameter.split(",").filter((value) => value !== ""))].sort(byCodeUnit);
+}
+/** The state an address carries; a parameter absent or empty leaves its part of the state empty. */
+export function parseSearchState(search) {
+    const parameters = new URLSearchParams(search);
+    const state = emptyState();
+    state.query = parameters.get(QUERY_PARAMETER) ?? "";
+    for (const name of FACET_NAMES) {
+        state.filters[name] = valuesOf(parameters.get(name));
+    }
+    const noteless = parameters.get(NOTELESS_FACET) ?? "any";
+    if (isNotelessFilter(noteless))
+        state.noteless = noteless;
+    return state;
+}
+/** A parameter value as the address shows it: readable, a space as `+`, a comma kept between the values of a facet. */
+function encode(value) {
+    return encodeURIComponent(value).replaceAll("%20", "+").replaceAll("%2C", ",");
+}
+/** The query string of a state, `?q=…&type=…`, parameters in a fixed order; empty for the empty state. */
+export function searchQueryString(state) {
+    const parts = [];
+    if (state.query !== "")
+        parts.push(`${QUERY_PARAMETER}=${encode(state.query)}`);
+    for (const name of FACET_NAMES) {
+        const values = state.filters[name];
+        if (values.length > 0)
+            parts.push(`${name}=${values.map(encode).join(",")}`);
+    }
+    if (state.noteless !== "any")
+        parts.push(`${NOTELESS_FACET}=${state.noteless}`);
+    return parts.length === 0 ? "" : `?${parts.join("&")}`;
+}
+export function hasFilters(state) {
+    return state.noteless !== "any" || FACET_NAMES.some((name) => state.filters[name].length > 0);
+}
+export function isSelected(state, name, value) {
+    return state.filters[name].includes(value);
+}
+/** The state with a facet value selected when it is not, lifted when it is; the rest untouched. */
+export function toggleValue(state, name, value) {
+    const values = isSelected(state, name, value)
+        ? state.filters[name].filter((selected) => selected !== value)
+        : [...state.filters[name], value].sort(byCodeUnit);
+    return { ...state, filters: { ...state.filters, [name]: values } };
+}
+/** The state with the no-note facet on a value, or back to `any` when that value is the current one. */
+export function toggleNoteless(state, value) {
+    return { ...state, noteless: state.noteless === value ? "any" : value };
+}
+/** The state with every facet open again, the query kept. */
+export function clearFilters(state) {
+    return { ...emptyState(), query: state.query };
+}
+export function withQuery(state, query) {
+    return { ...state, query };
+}
+//# sourceMappingURL=state.js.map

package/dist/search/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/search/state.ts"],"names":[],"mappings":"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"}