recipe-planner-ui 1.0.0

package/dist/types/components/rp-recipe-card/rp-recipe-card.d.ts

@@ -0,0 +1,36 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * A recipe summary tile.
+ *
+ * Takes only primitives, so it can be driven from plain HTML attributes with no
+ * framework present. It has no idea where a recipe comes from or what a route is —
+ * consumers inject navigation through the `actions` slot.
+ *
+ * @slot - Badges rendered over the image, such as a category or source marker.
+ * @slot actions - Controls rendered in the footer, typically links to view or edit.
+ */
+export declare class RecipeCard {
+    el: HTMLElement;
+    /** Identifier echoed back in the toggle event so consumers know which card fired. */
+    recipeId: string;
+    /**
+     * Recipe name, rendered as the card heading.
+     *
+     * Named `recipeTitle` rather than `title` because every HTMLElement already defines
+     * `title` on its prototype; shadowing it produces inconsistent behaviour across browsers.
+     */
+    recipeTitle: string;
+    /** Absolute URL of the recipe image. */
+    image?: string;
+    /** Category label shown under the heading. */
+    category?: string;
+    /** Whether this recipe is currently a favorite. Reflected for CSS hooks. */
+    favorite: boolean;
+    /** Fired when the favorite control is activated. */
+    rpFavoriteToggle: EventEmitter<{
+        recipeId: string;
+        favorite: boolean;
+    }>;
+    private toggleFavorite;
+    render(): any;
+}

package/dist/types/components/rp-search-bar/rp-search-bar.d.ts

@@ -0,0 +1,31 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * A search input that emits on submit rather than on every keystroke.
+ *
+ * Per-keystroke events would race the consumer's own navigation: each one triggers a
+ * server round trip, and a slow response can land after the user has typed more,
+ * overwriting the field. Submitting explicitly keeps the interaction deterministic.
+ */
+export declare class SearchBar {
+    /** Initial query text. Changing it externally resets the field. */
+    value: string;
+    /** Placeholder shown when the field is empty. */
+    placeholder: string;
+    /** Accessible label for the input. */
+    label: string;
+    /**
+     * Live field contents. Held internally so typing does not require a round trip
+     * through the consumer, while `value` remains the externally controlled seed.
+     */
+    private draft;
+    /** Fired on submit with the trimmed query. */
+    rpSearch: EventEmitter<string>;
+    /** Fired when the user clears a non-empty field. */
+    rpClear: EventEmitter<void>;
+    onValueChange(next: string): void;
+    componentWillLoad(): void;
+    private onSubmit;
+    private onInput;
+    private onClear;
+    render(): any;
+}

package/dist/types/components.d.ts

@@ -0,0 +1,536 @@
+/* eslint-disable */
+/* tslint:disable */
+/**
+ * This is an autogenerated file created by the Stencil compiler.
+ * It contains typing information for all components that exist in this project.
+ */
+import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
+import { PlannedMeal } from "./components/rp-day-slot/rp-day-slot";
+export { PlannedMeal } from "./components/rp-day-slot/rp-day-slot";
+export namespace Components {
+    /**
+     * One day column of a weekly meal plan.
+     * Moving a meal is a select rather than drag-and-drop: it works with a keyboard and on
+     * touch without a fallback path, and the plan is small enough that dragging adds nothing.
+     */
+    interface RpDaySlot {
+        /**
+          * Machine-readable day key, echoed in every event.
+         */
+        "day": string;
+        /**
+          * Human-readable day name shown as the column heading.
+          * @default ''
+         */
+        "dayLabel": string;
+        /**
+          * All day keys, used to populate each meal's move target list.
+          * @default []
+         */
+        "days": string[];
+        /**
+          * Meals planned for this day. Must be assigned as a DOM property.
+          * @default []
+         */
+        "meals": PlannedMeal[];
+    }
+    /**
+     * A single-select row of filter chips.
+     * Selecting the active chip clears the filter, so the event detail is nullable —
+     * consumers translate null into "remove this search param".
+     */
+    interface RpFilterChips {
+        /**
+          * Accessible label for the group.
+          * @default 'Filter'
+         */
+        "label": string;
+        /**
+          * Available filter values.  An array has no attribute representation, so this must be assigned as a DOM property. Frameworks that set properties on custom elements do this automatically.
+          * @default []
+         */
+        "options": string[];
+        /**
+          * Currently active value, or null when no filter is applied.
+          * @default null
+         */
+        "selected": string | null;
+    }
+    /**
+     * A measure-and-name ingredient table.
+     */
+    interface RpIngredientList {
+        /**
+          * Ingredients to display. Must be assigned as a DOM property, not an attribute.
+          * @default []
+         */
+        "items": Array<{ name: string; measure: string }>;
+    }
+    /**
+     * A modal dialog with a focus trap.
+     * Escape and focus containment are handled here rather than left to consumers, because
+     * getting them wrong is the usual reason a hand-rolled modal is inaccessible.
+     */
+    interface RpModal {
+        /**
+          * Moves focus to the first focusable control inside the dialog.  Exposed as a method because "move focus now" is a one-shot action with no state to represent; a prop would have to be toggled and reset to fire it twice.
+         */
+        "focusFirstField": () => Promise<void>;
+        /**
+          * Dialog heading, also used as its accessible name.
+          * @default ''
+         */
+        "heading": string;
+        /**
+          * Whether the dialog is visible.
+          * @default false
+         */
+        "open": boolean;
+    }
+    /**
+     * A recipe summary tile.
+     * Takes only primitives, so it can be driven from plain HTML attributes with no
+     * framework present. It has no idea where a recipe comes from or what a route is —
+     * consumers inject navigation through the `actions` slot.
+     */
+    interface RpRecipeCard {
+        /**
+          * Category label shown under the heading.
+         */
+        "category"?: string;
+        /**
+          * Whether this recipe is currently a favorite. Reflected for CSS hooks.
+          * @default false
+         */
+        "favorite": boolean;
+        /**
+          * Absolute URL of the recipe image.
+         */
+        "image"?: string;
+        /**
+          * Identifier echoed back in the toggle event so consumers know which card fired.
+         */
+        "recipeId": string;
+        /**
+          * Recipe name, rendered as the card heading.  Named `recipeTitle` rather than `title` because every HTMLElement already defines `title` on its prototype; shadowing it produces inconsistent behaviour across browsers.
+         */
+        "recipeTitle": string;
+    }
+    /**
+     * A search input that emits on submit rather than on every keystroke.
+     * Per-keystroke events would race the consumer's own navigation: each one triggers a
+     * server round trip, and a slow response can land after the user has typed more,
+     * overwriting the field. Submitting explicitly keeps the interaction deterministic.
+     */
+    interface RpSearchBar {
+        /**
+          * Accessible label for the input.
+          * @default 'Search recipes'
+         */
+        "label": string;
+        /**
+          * Placeholder shown when the field is empty.
+          * @default 'Search recipes'
+         */
+        "placeholder": string;
+        /**
+          * Initial query text. Changing it externally resets the field.
+          * @default ''
+         */
+        "value": string;
+    }
+}
+export interface RpDaySlotCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLRpDaySlotElement;
+}
+export interface RpFilterChipsCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLRpFilterChipsElement;
+}
+export interface RpModalCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLRpModalElement;
+}
+export interface RpRecipeCardCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLRpRecipeCardElement;
+}
+export interface RpSearchBarCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLRpSearchBarElement;
+}
+declare global {
+    interface HTMLRpDaySlotElementEventMap {
+        "rpAddMeal": string;
+        "rpRemoveMeal": { id: string; day: string };
+        "rpMoveMeal": { id: string; from: string; to: string };
+    }
+    /**
+     * One day column of a weekly meal plan.
+     * Moving a meal is a select rather than drag-and-drop: it works with a keyboard and on
+     * touch without a fallback path, and the plan is small enough that dragging adds nothing.
+     */
+    interface HTMLRpDaySlotElement extends Components.RpDaySlot, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLRpDaySlotElementEventMap>(type: K, listener: (this: HTMLRpDaySlotElement, ev: RpDaySlotCustomEvent<HTMLRpDaySlotElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLRpDaySlotElementEventMap>(type: K, listener: (this: HTMLRpDaySlotElement, ev: RpDaySlotCustomEvent<HTMLRpDaySlotElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLRpDaySlotElement: {
+        prototype: HTMLRpDaySlotElement;
+        new (): HTMLRpDaySlotElement;
+    };
+    interface HTMLRpFilterChipsElementEventMap {
+        "rpFilterChange": string | null;
+    }
+    /**
+     * A single-select row of filter chips.
+     * Selecting the active chip clears the filter, so the event detail is nullable —
+     * consumers translate null into "remove this search param".
+     */
+    interface HTMLRpFilterChipsElement extends Components.RpFilterChips, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLRpFilterChipsElementEventMap>(type: K, listener: (this: HTMLRpFilterChipsElement, ev: RpFilterChipsCustomEvent<HTMLRpFilterChipsElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLRpFilterChipsElementEventMap>(type: K, listener: (this: HTMLRpFilterChipsElement, ev: RpFilterChipsCustomEvent<HTMLRpFilterChipsElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLRpFilterChipsElement: {
+        prototype: HTMLRpFilterChipsElement;
+        new (): HTMLRpFilterChipsElement;
+    };
+    /**
+     * A measure-and-name ingredient table.
+     */
+    interface HTMLRpIngredientListElement extends Components.RpIngredientList, HTMLStencilElement {
+    }
+    var HTMLRpIngredientListElement: {
+        prototype: HTMLRpIngredientListElement;
+        new (): HTMLRpIngredientListElement;
+    };
+    interface HTMLRpModalElementEventMap {
+        "rpClose": void;
+    }
+    /**
+     * A modal dialog with a focus trap.
+     * Escape and focus containment are handled here rather than left to consumers, because
+     * getting them wrong is the usual reason a hand-rolled modal is inaccessible.
+     */
+    interface HTMLRpModalElement extends Components.RpModal, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLRpModalElementEventMap>(type: K, listener: (this: HTMLRpModalElement, ev: RpModalCustomEvent<HTMLRpModalElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLRpModalElementEventMap>(type: K, listener: (this: HTMLRpModalElement, ev: RpModalCustomEvent<HTMLRpModalElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLRpModalElement: {
+        prototype: HTMLRpModalElement;
+        new (): HTMLRpModalElement;
+    };
+    interface HTMLRpRecipeCardElementEventMap {
+        "rpFavoriteToggle": { recipeId: string; favorite: boolean };
+    }
+    /**
+     * A recipe summary tile.
+     * Takes only primitives, so it can be driven from plain HTML attributes with no
+     * framework present. It has no idea where a recipe comes from or what a route is —
+     * consumers inject navigation through the `actions` slot.
+     */
+    interface HTMLRpRecipeCardElement extends Components.RpRecipeCard, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLRpRecipeCardElementEventMap>(type: K, listener: (this: HTMLRpRecipeCardElement, ev: RpRecipeCardCustomEvent<HTMLRpRecipeCardElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLRpRecipeCardElementEventMap>(type: K, listener: (this: HTMLRpRecipeCardElement, ev: RpRecipeCardCustomEvent<HTMLRpRecipeCardElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLRpRecipeCardElement: {
+        prototype: HTMLRpRecipeCardElement;
+        new (): HTMLRpRecipeCardElement;
+    };
+    interface HTMLRpSearchBarElementEventMap {
+        "rpSearch": string;
+        "rpClear": void;
+    }
+    /**
+     * A search input that emits on submit rather than on every keystroke.
+     * Per-keystroke events would race the consumer's own navigation: each one triggers a
+     * server round trip, and a slow response can land after the user has typed more,
+     * overwriting the field. Submitting explicitly keeps the interaction deterministic.
+     */
+    interface HTMLRpSearchBarElement extends Components.RpSearchBar, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLRpSearchBarElementEventMap>(type: K, listener: (this: HTMLRpSearchBarElement, ev: RpSearchBarCustomEvent<HTMLRpSearchBarElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLRpSearchBarElementEventMap>(type: K, listener: (this: HTMLRpSearchBarElement, ev: RpSearchBarCustomEvent<HTMLRpSearchBarElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLRpSearchBarElement: {
+        prototype: HTMLRpSearchBarElement;
+        new (): HTMLRpSearchBarElement;
+    };
+    interface HTMLElementTagNameMap {
+        "rp-day-slot": HTMLRpDaySlotElement;
+        "rp-filter-chips": HTMLRpFilterChipsElement;
+        "rp-ingredient-list": HTMLRpIngredientListElement;
+        "rp-modal": HTMLRpModalElement;
+        "rp-recipe-card": HTMLRpRecipeCardElement;
+        "rp-search-bar": HTMLRpSearchBarElement;
+    }
+}
+declare namespace LocalJSX {
+    type OneOf<K extends string, PropT, AttrT = PropT> = { [P in K]: PropT } & { [P in `attr:${K}`]?: never } | { [P in `attr:${K}`]: AttrT } & { [P in K]?: never };
+
+    /**
+     * One day column of a weekly meal plan.
+     * Moving a meal is a select rather than drag-and-drop: it works with a keyboard and on
+     * touch without a fallback path, and the plan is small enough that dragging adds nothing.
+     */
+    interface RpDaySlot {
+        /**
+          * Machine-readable day key, echoed in every event.
+         */
+        "day": string;
+        /**
+          * Human-readable day name shown as the column heading.
+          * @default ''
+         */
+        "dayLabel"?: string;
+        /**
+          * All day keys, used to populate each meal's move target list.
+          * @default []
+         */
+        "days"?: string[];
+        /**
+          * Meals planned for this day. Must be assigned as a DOM property.
+          * @default []
+         */
+        "meals"?: PlannedMeal[];
+        /**
+          * Fired when the user asks to add a meal to this day.
+         */
+        "onRpAddMeal"?: (event: RpDaySlotCustomEvent<string>) => void;
+        /**
+          * Fired when a meal is reassigned to a different day.
+         */
+        "onRpMoveMeal"?: (event: RpDaySlotCustomEvent<{ id: string; from: string; to: string }>) => void;
+        /**
+          * Fired when a meal is removed from this day.
+         */
+        "onRpRemoveMeal"?: (event: RpDaySlotCustomEvent<{ id: string; day: string }>) => void;
+    }
+    /**
+     * A single-select row of filter chips.
+     * Selecting the active chip clears the filter, so the event detail is nullable —
+     * consumers translate null into "remove this search param".
+     */
+    interface RpFilterChips {
+        /**
+          * Accessible label for the group.
+          * @default 'Filter'
+         */
+        "label"?: string;
+        /**
+          * Fired with the new selection, or null when the filter is cleared.
+         */
+        "onRpFilterChange"?: (event: RpFilterChipsCustomEvent<string | null>) => void;
+        /**
+          * Available filter values.  An array has no attribute representation, so this must be assigned as a DOM property. Frameworks that set properties on custom elements do this automatically.
+          * @default []
+         */
+        "options"?: string[];
+        /**
+          * Currently active value, or null when no filter is applied.
+          * @default null
+         */
+        "selected"?: string | null;
+    }
+    /**
+     * A measure-and-name ingredient table.
+     */
+    interface RpIngredientList {
+        /**
+          * Ingredients to display. Must be assigned as a DOM property, not an attribute.
+          * @default []
+         */
+        "items"?: Array<{ name: string; measure: string }>;
+    }
+    /**
+     * A modal dialog with a focus trap.
+     * Escape and focus containment are handled here rather than left to consumers, because
+     * getting them wrong is the usual reason a hand-rolled modal is inaccessible.
+     */
+    interface RpModal {
+        /**
+          * Dialog heading, also used as its accessible name.
+          * @default ''
+         */
+        "heading"?: string;
+        /**
+          * Fired when the user dismisses the dialog via Escape, the backdrop, or the close button.
+         */
+        "onRpClose"?: (event: RpModalCustomEvent<void>) => void;
+        /**
+          * Whether the dialog is visible.
+          * @default false
+         */
+        "open"?: boolean;
+    }
+    /**
+     * A recipe summary tile.
+     * Takes only primitives, so it can be driven from plain HTML attributes with no
+     * framework present. It has no idea where a recipe comes from or what a route is —
+     * consumers inject navigation through the `actions` slot.
+     */
+    interface RpRecipeCard {
+        /**
+          * Category label shown under the heading.
+         */
+        "category"?: string;
+        /**
+          * Whether this recipe is currently a favorite. Reflected for CSS hooks.
+          * @default false
+         */
+        "favorite"?: boolean;
+        /**
+          * Absolute URL of the recipe image.
+         */
+        "image"?: string;
+        /**
+          * Fired when the favorite control is activated.
+         */
+        "onRpFavoriteToggle"?: (event: RpRecipeCardCustomEvent<{ recipeId: string; favorite: boolean }>) => void;
+        /**
+          * Identifier echoed back in the toggle event so consumers know which card fired.
+         */
+        "recipeId": string;
+        /**
+          * Recipe name, rendered as the card heading.  Named `recipeTitle` rather than `title` because every HTMLElement already defines `title` on its prototype; shadowing it produces inconsistent behaviour across browsers.
+         */
+        "recipeTitle": string;
+    }
+    /**
+     * A search input that emits on submit rather than on every keystroke.
+     * Per-keystroke events would race the consumer's own navigation: each one triggers a
+     * server round trip, and a slow response can land after the user has typed more,
+     * overwriting the field. Submitting explicitly keeps the interaction deterministic.
+     */
+    interface RpSearchBar {
+        /**
+          * Accessible label for the input.
+          * @default 'Search recipes'
+         */
+        "label"?: string;
+        /**
+          * Fired when the user clears a non-empty field.
+         */
+        "onRpClear"?: (event: RpSearchBarCustomEvent<void>) => void;
+        /**
+          * Fired on submit with the trimmed query.
+         */
+        "onRpSearch"?: (event: RpSearchBarCustomEvent<string>) => void;
+        /**
+          * Placeholder shown when the field is empty.
+          * @default 'Search recipes'
+         */
+        "placeholder"?: string;
+        /**
+          * Initial query text. Changing it externally resets the field.
+          * @default ''
+         */
+        "value"?: string;
+    }
+
+    interface RpDaySlotAttributes {
+        "day": string;
+        "dayLabel": string;
+    }
+    interface RpFilterChipsAttributes {
+        "selected": string | null;
+        "label": string;
+    }
+    interface RpModalAttributes {
+        "open": boolean;
+        "heading": string;
+    }
+    interface RpRecipeCardAttributes {
+        "recipeId": string;
+        "recipeTitle": string;
+        "image": string;
+        "category": string;
+        "favorite": boolean;
+    }
+    interface RpSearchBarAttributes {
+        "value": string;
+        "placeholder": string;
+        "label": string;
+    }
+
+    interface IntrinsicElements {
+        "rp-day-slot": Omit<RpDaySlot, keyof RpDaySlotAttributes> & { [K in keyof RpDaySlot & keyof RpDaySlotAttributes]?: RpDaySlot[K] } & { [K in keyof RpDaySlot & keyof RpDaySlotAttributes as `attr:${K}`]?: RpDaySlotAttributes[K] } & { [K in keyof RpDaySlot & keyof RpDaySlotAttributes as `prop:${K}`]?: RpDaySlot[K] } & OneOf<"day", RpDaySlot["day"], RpDaySlotAttributes["day"]>;
+        "rp-filter-chips": Omit<RpFilterChips, keyof RpFilterChipsAttributes> & { [K in keyof RpFilterChips & keyof RpFilterChipsAttributes]?: RpFilterChips[K] } & { [K in keyof RpFilterChips & keyof RpFilterChipsAttributes as `attr:${K}`]?: RpFilterChipsAttributes[K] } & { [K in keyof RpFilterChips & keyof RpFilterChipsAttributes as `prop:${K}`]?: RpFilterChips[K] };
+        "rp-ingredient-list": RpIngredientList;
+        "rp-modal": Omit<RpModal, keyof RpModalAttributes> & { [K in keyof RpModal & keyof RpModalAttributes]?: RpModal[K] } & { [K in keyof RpModal & keyof RpModalAttributes as `attr:${K}`]?: RpModalAttributes[K] } & { [K in keyof RpModal & keyof RpModalAttributes as `prop:${K}`]?: RpModal[K] };
+        "rp-recipe-card": Omit<RpRecipeCard, keyof RpRecipeCardAttributes> & { [K in keyof RpRecipeCard & keyof RpRecipeCardAttributes]?: RpRecipeCard[K] } & { [K in keyof RpRecipeCard & keyof RpRecipeCardAttributes as `attr:${K}`]?: RpRecipeCardAttributes[K] } & { [K in keyof RpRecipeCard & keyof RpRecipeCardAttributes as `prop:${K}`]?: RpRecipeCard[K] } & OneOf<"recipeId", RpRecipeCard["recipeId"], RpRecipeCardAttributes["recipeId"]> & OneOf<"recipeTitle", RpRecipeCard["recipeTitle"], RpRecipeCardAttributes["recipeTitle"]>;
+        "rp-search-bar": Omit<RpSearchBar, keyof RpSearchBarAttributes> & { [K in keyof RpSearchBar & keyof RpSearchBarAttributes]?: RpSearchBar[K] } & { [K in keyof RpSearchBar & keyof RpSearchBarAttributes as `attr:${K}`]?: RpSearchBarAttributes[K] } & { [K in keyof RpSearchBar & keyof RpSearchBarAttributes as `prop:${K}`]?: RpSearchBar[K] };
+    }
+}
+export { LocalJSX as JSX };
+declare module "@stencil/core" {
+    export namespace JSX {
+        interface IntrinsicElements {
+            /**
+             * One day column of a weekly meal plan.
+             * Moving a meal is a select rather than drag-and-drop: it works with a keyboard and on
+             * touch without a fallback path, and the plan is small enough that dragging adds nothing.
+             */
+            "rp-day-slot": LocalJSX.IntrinsicElements["rp-day-slot"] & JSXBase.HTMLAttributes<HTMLRpDaySlotElement>;
+            /**
+             * A single-select row of filter chips.
+             * Selecting the active chip clears the filter, so the event detail is nullable —
+             * consumers translate null into "remove this search param".
+             */
+            "rp-filter-chips": LocalJSX.IntrinsicElements["rp-filter-chips"] & JSXBase.HTMLAttributes<HTMLRpFilterChipsElement>;
+            /**
+             * A measure-and-name ingredient table.
+             */
+            "rp-ingredient-list": LocalJSX.IntrinsicElements["rp-ingredient-list"] & JSXBase.HTMLAttributes<HTMLRpIngredientListElement>;
+            /**
+             * A modal dialog with a focus trap.
+             * Escape and focus containment are handled here rather than left to consumers, because
+             * getting them wrong is the usual reason a hand-rolled modal is inaccessible.
+             */
+            "rp-modal": LocalJSX.IntrinsicElements["rp-modal"] & JSXBase.HTMLAttributes<HTMLRpModalElement>;
+            /**
+             * A recipe summary tile.
+             * Takes only primitives, so it can be driven from plain HTML attributes with no
+             * framework present. It has no idea where a recipe comes from or what a route is —
+             * consumers inject navigation through the `actions` slot.
+             */
+            "rp-recipe-card": LocalJSX.IntrinsicElements["rp-recipe-card"] & JSXBase.HTMLAttributes<HTMLRpRecipeCardElement>;
+            /**
+             * A search input that emits on submit rather than on every keystroke.
+             * Per-keystroke events would race the consumer's own navigation: each one triggers a
+             * server round trip, and a slow response can land after the user has typed more,
+             * overwriting the field. Submitting explicitly keeps the interaction deterministic.
+             */
+            "rp-search-bar": LocalJSX.IntrinsicElements["rp-search-bar"] & JSXBase.HTMLAttributes<HTMLRpSearchBarElement>;
+        }
+    }
+}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Public entry point for the type surface of this library.
+ *
+ * Components are not exported here. Consumers register the custom elements through
+ * `recipe-planner-ui/loader` (see README) and reference the tags directly in markup.
+ */
+export type * from './components.d.ts';