@stapel/vocabularies-react 0.1.0

package/dist/api/vocabulariesApi.d.ts

@@ -0,0 +1,14 @@
+import type { StapelClient } from "@stapel/core";
+/**
+ * The pair's typed operation surface. Today a thin holder over the injected
+ * {@link StapelClient}; the named, typed operations (`vocabularies.<op>()`) will
+ * be GENERATED from schema.json operationIds by gen-api v2 (task
+ * `core-typed-ops`). Until then add hand-authored operations here and put
+ * anything that can never be derived from the schema in `api/extensions.ts`,
+ * each flagged with WHY the codegen does not cover it.
+ */
+export interface VocabulariesApi {
+    readonly client: StapelClient;
+}
+export declare function createVocabulariesApi(client: StapelClient): VocabulariesApi;
+//# sourceMappingURL=vocabulariesApi.d.ts.map

package/dist/api/vocabulariesApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulariesApi.d.ts","sourceRoot":"","sources":["../../src/api/vocabulariesApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAE3E"}

package/dist/api/vocabulariesApi.js

@@ -0,0 +1,4 @@
+export function createVocabulariesApi(client) {
+    return { client };
+}
+//# sourceMappingURL=vocabulariesApi.js.map

package/dist/api/vocabulariesApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulariesApi.js","sourceRoot":"","sources":["../../src/api/vocabulariesApi.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,49 @@
+/** One term of a vocabulary level, as `GET …/terms/` returns it.
+ *
+ * A structural twin of `@stapel/attributes-react`'s `VocabularyTerm` — the same
+ * three fields, `has_children` spelled the wire's way. The declaration is not
+ * shared because the two packages must not import each other; the assignment
+ * is proven by `test/clientShape.test.ts`. */
+export interface VocabularyTerm {
+    readonly code: string;
+    readonly label: string;
+    readonly has_children?: boolean;
+}
+/**
+ * The seam `@stapel/attributes-react` declares and this package implements.
+ *
+ * ATTRIBUTES-REACT OWNS THIS SHAPE. The copy here exists so a host can name
+ * the type without depending on the attributes pair, and
+ * `test/clientShape.test.ts` holds a third, hand-transcribed copy of the
+ * upstream declaration that the value returned below is assigned to — so a
+ * drift in either package is a red build here rather than a runtime hole in a
+ * storefront that wired the two together.
+ */
+export interface VocabularyClient {
+    /** Terms of one level, narrowed by `query` and — when the caller has a
+     * parent term — by that term's code. An empty `query` means "the first page
+     * of this level", which is what a dropdown opens on. `signal` is honoured. */
+    search(vocabulary: string, level: string, query: string, parent?: string, signal?: AbortSignal): Promise<readonly VocabularyTerm[]>;
+    /** `{code: label}` for codes already stored somewhere. Unknown codes are
+     * omitted by the server, so a caller falls back to the code itself. */
+    resolve(vocabulary: string, level: string, codes: readonly string[]): Promise<Readonly<Record<string, string>>>;
+}
+export interface CreateVocabularyClientOptions {
+    /** Where stapel-vocabularies is mounted, e.g. `/vocabularies/api/v1/` or an
+     * absolute origin. A missing trailing slash is added. */
+    readonly baseUrl: string;
+    /** Transport override — a host's authenticated/instrumented `fetch`.
+     * Defaults to the global one. */
+    readonly fetch?: typeof globalThis.fetch;
+    /** Page size for {@link VocabularyClient.search}; the server caps it at 200
+     * and defaults to 50. */
+    readonly limit?: number;
+}
+/** The page a typeahead opens on. Matches the server's own default, so the
+ * parameter is sent for explicitness rather than to change behaviour. */
+export declare const DEFAULT_TERM_LIMIT = 50;
+/** The server refuses more than this many codes per resolve, and silently
+ * ignores the tail — so the client splits instead of losing labels. */
+export declare const RESOLVE_BATCH = 200;
+export declare function createVocabularyClient(options: CreateVocabularyClientOptions): VocabularyClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AA4BA;;;;;8CAK8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;kFAE8E;IAC9E,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IACtC;2EACuE;IACvE,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,6BAA6B;IAC5C;6DACyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;qCACiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC;6BACyB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;yEACyE;AACzE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;uEACuE;AACvE,eAAO,MAAM,aAAa,MAAM,CAAC;AAsBjC,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,gBAAgB,CA+DlB"}

package/dist/client.js

@@ -0,0 +1,118 @@
+/**
+ * `createVocabularyClient` — the two reads a ref feature needs, over the
+ * stapel-vocabularies wire.
+ *
+ * ── Why this is a bare `fetch` client and not the pair's StapelClient ───────
+ *
+ * A `ref_select` reaches its terms through a seam
+ * (`VocabularyClient`) that `@stapel/attributes-react` DECLARES and this
+ * package SATISFIES — structurally, without either importing the other, so two
+ * L2 pairs stay independently releasable. The seam is two async functions and
+ * nothing else: no query client, no auth runtime, no provider. Anything this
+ * function returned that needed React context could not be handed to
+ * `<VocabularyClientProvider value={…}>` at a container's composition root,
+ * which is the one call site the seam exists for.
+ *
+ * Both endpoints are public reads (`ReadOnlyOrStaff`, ETag'd on the
+ * vocabulary's revision, no session), so there is no token to carry and
+ * nothing for the auth interceptors to do. A host that DOES need headers
+ * passes its own `fetch`.
+ *
+ * The caching the seam deliberately leaves out lives in this package's hooks
+ * (`useTermLabels` is a TanStack query; `useTermSearch` supersedes in flight),
+ * not in the client — a raw client is what makes the seam testable and what
+ * lets a host wrap it.
+ */
+import { toStapelApiError } from "@stapel/core";
+/** The page a typeahead opens on. Matches the server's own default, so the
+ * parameter is sent for explicitness rather than to change behaviour. */
+export const DEFAULT_TERM_LIMIT = 50;
+/** The server refuses more than this many codes per resolve, and silently
+ * ignores the tail — so the client splits instead of losing labels. */
+export const RESOLVE_BATCH = 200;
+function withSlash(baseUrl) {
+    return baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+}
+/**
+ * `{code: label}` out of a body typed as `Record<string, unknown>` (the
+ * contract declares `additionalProperties: {}`). Non-string values are
+ * dropped rather than stringified: a label that is not a string is a server
+ * the caller should fall back from, and `"[object Object]"` in a dropdown is
+ * worse than the code.
+ */
+function labelsOf(body) {
+    const out = {};
+    if (typeof body !== "object" || body === null)
+        return out;
+    for (const [code, label] of Object.entries(body)) {
+        if (typeof label === "string")
+            out[code] = label;
+    }
+    return out;
+}
+export function createVocabularyClient(options) {
+    const base = withSlash(options.baseUrl);
+    const doFetch = options.fetch ?? globalThis.fetch;
+    const limit = options.limit ?? DEFAULT_TERM_LIMIT;
+    async function read(url, signal) {
+        let response;
+        try {
+            response = await doFetch(url, {
+                method: "GET",
+                headers: { accept: "application/json" },
+                ...(signal !== undefined ? { signal } : {}),
+            });
+        }
+        catch (cause) {
+            // An abort is the CALLER's decision, not a failure: rethrow it as-is so
+            // `signal.aborted` still discriminates it. Folding it into the error
+            // dialect would make a superseded keystroke look like a dead backend.
+            if (signal?.aborted === true)
+                throw cause;
+            throw toStapelApiError(cause);
+        }
+        if (!response.ok) {
+            // One dialect at the single rethrow point (core `errors.ts`): the body is
+            // the backend's envelope, the status is the response's.
+            const body = await response.json().catch(() => undefined);
+            throw toStapelApiError(body, response.status);
+        }
+        return await response.json();
+    }
+    return {
+        async search(vocabulary, level, query, parent, signal) {
+            const params = new URLSearchParams();
+            params.set("level", level);
+            // OMITTED, not empty: `parent=` would ask the server for the children of
+            // a term whose code is the empty string, which is a level with nothing in
+            // it — the opposite of "the whole level", which is what no parent means.
+            if (parent !== undefined && parent.length > 0)
+                params.set("parent", parent);
+            params.set("q", query);
+            params.set("limit", String(limit));
+            const url = `${base}vocabularies/${encodeURIComponent(vocabulary)}/terms/?${params.toString()}`;
+            const page = (await read(url, signal));
+            const results = page?.results ?? [];
+            return results.map((term) => ({
+                code: term.code,
+                label: term.label,
+                has_children: term.has_children,
+            }));
+        },
+        async resolve(vocabulary, level, codes) {
+            const wanted = codes.filter((code) => code.length > 0);
+            if (wanted.length === 0)
+                return {};
+            const out = {};
+            for (let at = 0; at < wanted.length; at += RESOLVE_BATCH) {
+                const params = new URLSearchParams();
+                params.set("level", level);
+                params.set("codes", wanted.slice(at, at + RESOLVE_BATCH).join(","));
+                const url = `${base}vocabularies/${encodeURIComponent(vocabulary)}/terms/resolve/?${params.toString()}`;
+                Object.assign(out, labelsOf(await read(url)));
+            }
+            return out;
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/default/VocabularyTermSelect.d.ts

@@ -0,0 +1,24 @@
+import type { ReactElement } from "react";
+import type { VocabularyClient } from "../client.js";
+import type { ThemeModeProp } from "./types.js";
+export interface VocabularyTermSelectProps extends ThemeModeProp {
+    /** The seam. `null` draws the unavailable notice — see the module header. */
+    readonly client: VocabularyClient | null;
+    readonly vocabulary: string;
+    readonly level: string;
+    /** Code of a term at the level above; narrows the list to its children. */
+    readonly parent?: string | undefined;
+    /** The codes currently chosen. Always a list, even single-select — a term
+     * value is a list on the wire. */
+    readonly value?: readonly string[] | undefined;
+    readonly onChange?: ((codes: readonly string[]) => void) | undefined;
+    /** Several terms at once (a facet filter); default is one. */
+    readonly multiple?: boolean | undefined;
+    /** Upper bound for a multiple select. */
+    readonly maxCount?: number | undefined;
+    readonly disabled?: boolean | undefined;
+    readonly id?: string | undefined;
+    readonly status?: "error" | "warning" | undefined;
+}
+export declare function VocabularyTermSelect(props: VocabularyTermSelectProps): ReactElement;
+//# sourceMappingURL=VocabularyTermSelect.d.ts.map

package/dist/default/VocabularyTermSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VocabularyTermSelect.d.ts","sourceRoot":"","sources":["../../src/default/VocabularyTermSelect.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,yBAA0B,SAAQ,aAAa;IAC9D,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;sCACkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrE,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;CACnD;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,yBAAyB,GAC/B,YAAY,CAuFd"}

package/dist/default/VocabularyTermSelect.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * `<VocabularyTermSelect/>` — one vocabulary level as a typeahead.
+ *
+ * The SAME control `@stapel/attributes-react`'s `ref_select` editor draws,
+ * shipped on its own so the places a composer is not — a facet filter, an
+ * admin form, a bulk-edit row — do not each grow their own. The two are
+ * deliberately separate components rather than one imported across the seam:
+ * the editor's props are the attributes value-editor contract (a `FeatureDef`,
+ * `siblings`, a rule-narrowed config) and this one's are a vocabulary pointer,
+ * and collapsing them would make the two L2 pairs depend on each other for a
+ * hundred lines of antd.
+ *
+ * What it owes a person, and where each part lives:
+ *
+ *  - the options ARE the answer to the current query, so `filterOption={false}`
+ *    — letting antd filter them again would hide rows the server deliberately
+ *    ranked (a prefix match first, a label matched in another language);
+ *  - typing is debounced and superseding (`useTermSearch`);
+ *  - a code the control already HOLDS is resolved to its label
+ *    (`useTermLabels`) and kept in the option list even when the current page
+ *    does not contain it — otherwise reopening a saved filter would silently
+ *    empty the control;
+ *  - no client is a LOUD state, not an empty dropdown: a control that cannot
+ *    reach its terms and looks like one that found none is how a person ends
+ *    up unable to answer a question nobody told them was broken.
+ */
+import { useMemo } from "react";
+import { Alert, Select } from "antd";
+import { useT } from "@stapel/core";
+import { SkinTheme } from "@stapel/tokens-antd/skin";
+import { useTermSearch } from "../model/useTermSearch.js";
+import { useTermLabels, termLabel } from "../model/useTermLabels.js";
+import { VOCABULARIES_I18N_KEYS } from "../i18n/keys.js";
+export function VocabularyTermSelect(props) {
+    const t = useT();
+    const { client, vocabulary, level, parent } = props;
+    const codes = useMemo(() => (props.value ?? []).filter((code) => code.length > 0), [props.value]);
+    const { terms, loading, search, open } = useTermSearch(client, {
+        vocabulary,
+        level,
+        parent,
+    });
+    const labels = useTermLabels(client, { vocabulary, level, codes });
+    // A held code the current page does not contain still has to be visible and
+    // pickable, so it is prepended rather than looked up in `terms`.
+    const options = useMemo(() => [
+        ...codes
+            .filter((code) => !terms.some((term) => term.code === code))
+            .map((code) => ({ value: code, label: termLabel(labels, code) })),
+        ...terms.map((term) => ({ value: term.code, label: term.label })),
+    ], [codes, terms, labels]);
+    if (client === null || vocabulary.length === 0 || level.length === 0) {
+        return (_jsx(SkinTheme, { surface: "bare", ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(Alert, { type: "warning", showIcon: true, "data-testid": "vocabulary-term-select-unavailable", title: t(VOCABULARIES_I18N_KEYS.termSelectUnavailableTitle), description: t(VOCABULARIES_I18N_KEYS.termSelectUnavailable) }) }));
+    }
+    const multiple = props.multiple === true;
+    const onChange = props.onChange;
+    return (_jsx(SkinTheme, { surface: "bare", ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(Select, { ...(props.id !== undefined ? { id: props.id } : {}), "data-testid": "vocabulary-term-select", style: { width: "100%" }, showSearch: true, filterOption: false, options: options, loading: loading, disabled: props.disabled === true, ...(props.status !== undefined ? { status: props.status } : {}), ...(multiple ? { mode: "multiple" } : {}), ...(multiple && props.maxCount !== undefined
+                ? { maxCount: props.maxCount }
+                : {}), placeholder: t(VOCABULARIES_I18N_KEYS.termSelectPlaceholder), 
+            // `null` while loading, so antd draws its own spinner instead of
+            // saying "no matches" about a question that has not been answered yet.
+            notFoundContent: loading ? null : t(VOCABULARIES_I18N_KEYS.termSelectNoMatches), value: multiple ? codes : (codes[0] ?? null), onDropdownVisibleChange: (visible) => {
+                if (visible)
+                    open();
+            }, onSearch: search, onChange: (next) => {
+                const picked = next === null || next === undefined
+                    ? []
+                    : Array.isArray(next)
+                        ? [...next]
+                        : [next];
+                onChange?.(picked.filter((code) => code.length > 0));
+            } }) }));
+}
+//# sourceMappingURL=VocabularyTermSelect.js.map

package/dist/default/VocabularyTermSelect.js.map

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

package/dist/default/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@stapel/vocabularies-react/default` — the pair's default AntD skin (§54: a pair ships a
+ * FEATURE, not only a bag). A separate entry point, so a host that brings its
+ * own visuals never pulls `antd` or the token bridge into its bundle;
+ * importing this subpath is the opt-in.
+ *
+ * ```tsx
+ * import { VocabularyTermSelect } from "@stapel/vocabularies-react/default";
+ * // under core's <I18nProvider>; the client is a prop, not a context read:
+ * <VocabularyTermSelect client={client} vocabulary="avito-phones" level="Vendor" … />
+ * ```
+ */
+export { VocabularyTermSelect } from "./VocabularyTermSelect.js";
+export type { VocabularyTermSelectProps } from "./VocabularyTermSelect.js";
+export type { ThemeModeProp } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/default/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/default/index.js

@@ -0,0 +1,14 @@
+/**
+ * `@stapel/vocabularies-react/default` — the pair's default AntD skin (§54: a pair ships a
+ * FEATURE, not only a bag). A separate entry point, so a host that brings its
+ * own visuals never pulls `antd` or the token bridge into its bundle;
+ * importing this subpath is the opt-in.
+ *
+ * ```tsx
+ * import { VocabularyTermSelect } from "@stapel/vocabularies-react/default";
+ * // under core's <I18nProvider>; the client is a prop, not a context read:
+ * <VocabularyTermSelect client={client} vocabulary="avito-phones" level="Vendor" … />
+ * ```
+ */
+export { VocabularyTermSelect } from "./VocabularyTermSelect.js";
+//# sourceMappingURL=index.js.map

package/dist/default/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/default/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The one prop every skin component in this package shares.
+ *
+ * `mode` is OPTIONAL and has no default here on purpose: the shared
+ * `SkinTheme` (`@stapel/tokens-antd/skin`) follows the host's theme when
+ * nobody overrides it, and a `mode = "light"` default in a pair is how a dark
+ * host ends up with one white rectangle in the middle of its app.
+ */
+export interface ThemeModeProp {
+    readonly mode?: "light" | "dark";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/default/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/default/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAClC"}

package/dist/default/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/default/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/default/types.ts"],"names":[],"mappings":""}

package/dist/flows/errors.d.ts

@@ -0,0 +1,12 @@
+import type { FlowError } from "@stapel/core";
+export type { FlowError } from "@stapel/core";
+export { isErrorCode } from "@stapel/core";
+/**
+ * Fold any thrown value into a {@link FlowError} using this pair's own
+ * module-scoped fallback key (`vocabularies.error.unknown`, an en string in
+ * {@link vocabulariesI18nBundleEn}) so a non-`StapelApiError` fault still renders
+ * real copy rather than a raw key. The primitive lives in `@stapel/core`
+ * (frontend-core-architecture §4b); this wrapper only pins the fallback.
+ */
+export declare function toFlowError(error: unknown): FlowError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/flows/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/flows/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAErD"}

package/dist/flows/errors.js

@@ -0,0 +1,13 @@
+import { toFlowError as coreToFlowError } from "@stapel/core";
+export { isErrorCode } from "@stapel/core";
+/**
+ * Fold any thrown value into a {@link FlowError} using this pair's own
+ * module-scoped fallback key (`vocabularies.error.unknown`, an en string in
+ * {@link vocabulariesI18nBundleEn}) so a non-`StapelApiError` fault still renders
+ * real copy rather than a raw key. The primitive lives in `@stapel/core`
+ * (frontend-core-architecture §4b); this wrapper only pins the fallback.
+ */
+export function toFlowError(error) {
+    return coreToFlowError(error, "vocabularies.error.unknown");
+}
+//# sourceMappingURL=errors.js.map

package/dist/flows/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/flows/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,cAAc,CAAC;AAI9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,eAAe,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;AAC9D,CAAC"}

package/dist/flows/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Zero-flow registry shim (slim wave §21/S3). stapel-vocabularies annotates no
+ * `@flow_step` yet — its backend `docs/flows.json` carries no `vocabularies.*`
+ * flows, so `gen:flows` skips emission for this pair (no `flows/generated/`
+ * scaffolding). This hand-written shim preserves the pair's public
+ * flow-registry surface at its zero-flow shape.
+ *
+ * When the backend annotates flows, `pnpm gen:flows` emits
+ * `./generated/flows.gen.ts` again — replace these exports with re-exports
+ * from it (the shapes match by construction) and delete this file.
+ */
+export declare const VOCABULARIES_FLOWS: {};
+/** Canonical flow ids present in flows.json (none yet — see above). */
+export type VocabulariesFlowId = keyof typeof VOCABULARIES_FLOWS;
+export type VocabulariesFlowSpec = (typeof VOCABULARIES_FLOWS)[VocabulariesFlowId];
+export interface FlowEndpoint {
+    readonly method: string;
+    readonly path: string;
+}
+/** All HTTP endpoints a flow touches, in step order (for the contract test / MSW). */
+export declare function flowEndpoints(id: VocabulariesFlowId): readonly FlowEndpoint[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/flows/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/flows/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,IAAc,CAAC;AAE9C,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAEnF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,EAAE,EAAE,kBAAkB,GAAG,SAAS,YAAY,EAAE,CAO7E"}

package/dist/flows/registry.js

@@ -0,0 +1,20 @@
+/**
+ * Zero-flow registry shim (slim wave §21/S3). stapel-vocabularies annotates no
+ * `@flow_step` yet — its backend `docs/flows.json` carries no `vocabularies.*`
+ * flows, so `gen:flows` skips emission for this pair (no `flows/generated/`
+ * scaffolding). This hand-written shim preserves the pair's public
+ * flow-registry surface at its zero-flow shape.
+ *
+ * When the backend annotates flows, `pnpm gen:flows` emits
+ * `./generated/flows.gen.ts` again — replace these exports with re-exports
+ * from it (the shapes match by construction) and delete this file.
+ */
+export const VOCABULARIES_FLOWS = {};
+/** All HTTP endpoints a flow touches, in step order (for the contract test / MSW). */
+export function flowEndpoints(id) {
+    // Same widened body as the generated registry's — valid for the zero-flow
+    // shape AND correct once flows exist.
+    const spec = VOCABULARIES_FLOWS[id];
+    return spec ? spec.steps.flatMap((s) => s.endpoints) : [];
+}
+//# sourceMappingURL=registry.js.map

package/dist/flows/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/flows/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAW,CAAC;AAY9C,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,EAAsB;IAClD,0EAA0E;IAC1E,sCAAsC;IACtC,MAAM,IAAI,GAAG,kBAAkB,CAAC,EAAE,CAErB,CAAC;IACd,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/dist/headless/VocabulariesProvider.d.ts

@@ -0,0 +1,19 @@
+import type { ReactElement, ReactNode } from "react";
+import type { VocabulariesRuntime } from "../model/runtime.js";
+/**
+ * Provides the wired {@link VocabulariesRuntime} to every vocabularies hook and
+ * headless component below it. Bring your own visual shell — this component
+ * renders nothing of its own. (Core's `createModuleContext` provider, bound
+ * to this pair — slim wave §21/S2.)
+ *
+ * ```tsx
+ * const runtime = createVocabulariesRuntime({ baseUrl: "/vocabularies/api/v1/" });
+ * // give runtime.client to core's <StapelConfigProvider config={{ client }}>
+ * <VocabulariesProvider runtime={runtime}>{app}</VocabulariesProvider>
+ * ```
+ */
+export declare const VocabulariesProvider: (props: {
+    runtime: VocabulariesRuntime;
+    children: ReactNode;
+}) => ReactElement;
+//# sourceMappingURL=VocabulariesProvider.d.ts.map

package/dist/headless/VocabulariesProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VocabulariesProvider.d.ts","sourceRoot":"","sources":["../../src/headless/VocabulariesProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACrB,KAAK,YAA6B,CAAC"}

package/dist/headless/VocabulariesProvider.js

@@ -0,0 +1,15 @@
+import { ModuleProvider } from "../model/context.js";
+/**
+ * Provides the wired {@link VocabulariesRuntime} to every vocabularies hook and
+ * headless component below it. Bring your own visual shell — this component
+ * renders nothing of its own. (Core's `createModuleContext` provider, bound
+ * to this pair — slim wave §21/S2.)
+ *
+ * ```tsx
+ * const runtime = createVocabulariesRuntime({ baseUrl: "/vocabularies/api/v1/" });
+ * // give runtime.client to core's <StapelConfigProvider config={{ client }}>
+ * <VocabulariesProvider runtime={runtime}>{app}</VocabulariesProvider>
+ * ```
+ */
+export const VocabulariesProvider = ModuleProvider;
+//# sourceMappingURL=VocabulariesProvider.js.map

package/dist/headless/VocabulariesProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VocabulariesProvider.js","sourceRoot":"","sources":["../../src/headless/VocabulariesProvider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAGZ,cAAc,CAAC"}

package/dist/i18n/errorsMap.d.ts

@@ -0,0 +1,10 @@
+import type { Remediation } from "./generated/errors.gen.js";
+export { VOCABULARIES_ERRORS, VOCABULARIES_ERROR_CODES, vocabulariesErrorBundleEn, } from "./generated/errors.gen.js";
+export type { VocabulariesErrorCode, VocabulariesErrorSpec, Remediation, } from "./generated/errors.gen.js";
+/**
+ * Resolve a backend error code to its remediation hint, or `undefined` for a
+ * code this module doesn't know (e.g. a cross-cutting `stapel.http.*` fallback).
+ * Zero guessing at runtime — a static lookup over the generated map.
+ */
+export declare function explainVocabulariesError(code: string): Remediation | undefined;
+//# sourceMappingURL=errorsMap.d.ts.map

package/dist/i18n/errorsMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorsMap.d.ts","sourceRoot":"","sources":["../../src/i18n/errorsMap.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAG9E"}

package/dist/i18n/errorsMap.js

@@ -0,0 +1,20 @@
+/**
+ * The pair's error map (frontend-standard §4 checklist #7, frontend-core §2.5):
+ * the generated `code → { status, params, remediation, en }` catalog plus a
+ * tiny `explain()` lookup. Backs the manifest `errors` block and gives hosts a
+ * mechanical UX branch beside `t(code, params)`. The map itself is generated
+ * from the backend registry (`pnpm gen:errors`); this file only adds the lookup
+ * helper and re-exports the public surface.
+ */
+import { VOCABULARIES_ERRORS } from "./generated/errors.gen.js";
+export { VOCABULARIES_ERRORS, VOCABULARIES_ERROR_CODES, vocabulariesErrorBundleEn, } from "./generated/errors.gen.js";
+/**
+ * Resolve a backend error code to its remediation hint, or `undefined` for a
+ * code this module doesn't know (e.g. a cross-cutting `stapel.http.*` fallback).
+ * Zero guessing at runtime — a static lookup over the generated map.
+ */
+export function explainVocabulariesError(code) {
+    return VOCABULARIES_ERRORS[code]
+        ?.remediation;
+}
+//# sourceMappingURL=errorsMap.js.map

package/dist/i18n/errorsMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorsMap.js","sourceRoot":"","sources":["../../src/i18n/errorsMap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAOnC;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAQ,mBAAoE,CAAC,IAAI,CAAC;QAChF,EAAE,WAAW,CAAC;AAClB,CAAC"}

package/dist/i18n/es.d.ts

@@ -0,0 +1,21 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+export { vocabulariesErrorBundleEs } from "./generated/errors.es.gen.js";
+/**
+ * Spanish bundle for vocabularies-react — shipped as the
+ * `@stapel/vocabularies-react/i18n/es` subpath (i18n-shipping.md §2) so the locale is
+ * opt-in: a host that never registers it never carries these strings (the main
+ * entry does not import this module).
+ *
+ * TWO SOURCES, ON PURPOSE — see the ru bundle's header: the generated
+ * `vocabulariesErrorBundleEs` covers the codes stapel-core owns, and the 3
+ * stapel-vocabularies owns are authored below until upstream ships a
+ * `translations/errors.es.json`.
+ */
+export declare const vocabulariesI18nBundleEs: I18nDictionary;
+/**
+ * Register the Spanish bundle. The en bundle goes UNDER it
+ * (merge-priority convention): a key this locale has not translated yet
+ * degrades to ENGLISH, never to a raw key.
+ */
+export declare function registerVocabulariesI18nEs(engine: I18nEngine, locale?: string): void;
+//# sourceMappingURL=es.d.ts.map

package/dist/i18n/es.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/i18n/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAkBtC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,UAAU,EAClB,MAAM,SAAO,GACZ,IAAI,CAGN"}